Manga Translator UI提示词管理完全指南：系统提示词、术语提取与AI智能断句一步配好

【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理，集成OpenAl、Gemini等多翻译引擎；实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路，自带可视化编辑器，支持自定义文本样式，一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui

Manga Translator UI 是一款基于 manga-image-translator 的开源漫画AI翻译桌面工具，支持日文、韩文、英文漫画自动处理，集成 OpenAI、Gemini 等多个翻译引擎，并自带可视化编辑器。本文带你快速掌握它的提示词管理功能：如何配置系统提示词、启用自动术语提取、打开AI智能断句，让漫画翻译质量与排版更专业。

提示词在哪里？先认识 dict/ 目录

漫画AI翻译的完整链路是：OCR文字检测 → 原文擦除 → AI翻译 → 图像修复 → 译文排版。其中“AI翻译”这一步的质量，主要由提示词（Prompt）文件驱动。

所有提示词文件集中存放在运行目录的dict/下，支持.yaml/.yml/.json三种格式（同名时优先.yaml），加载逻辑见 prompt_loader.py。

提示词文件分为两类：

💡 自定义翻译提示词可以从模板dict/prompt_example.yaml复制改名开始，文件根节点必须是对象，结构如下（精简版）：

system_prompt: "" # 自定义系统提示词正文，可留空 glossary: Person: [] # 人物 Location: [] # 地点 Org: [] # 组织 Item: [] # 物品 Skill: [] # 技能 Creature: [] # 生物

一键应用自定义翻译提示词

打开主界面的「提示词管理」页签，即可对提示词文件做增删改查：

1. 点击「新建」或「复制」创建一个提示词文件，右侧预览面板可在线编辑；
2. 在左侧「提示词列表」选中目标文件；
3. 点击「应用所选提示词」（或双击文件），程序会把路径写入配置项translator.high_quality_prompt_path并持久化，状态栏显示“当前提示词：{文件名}”。

按钮与事件绑定逻辑见 prompt_page.py。

⚠️ 注意：列表只展示用户提示词文件，上面表格里的 4 个系统提示词文件会被自动排除，防止误改核心配置。此外，「设置 → 翻译」分组中的“自定义提示词”下拉框（dynamic_settings.py）打开时会重新扫描dict/目录，两种方式效果等价。

术语提取：让人物名、地点译名全书一致

长篇小说式的漫画最怕“同一角色三章三个译名”。Manga Translator UI 的术语表（glossary）机制分两步：

1️⃣ 在提示词文件中登记术语

每个术语按“原文 → 别名 → 译文”组织，支持附加condition（生效条件）与overwrite（是否强制覆盖AI译文）：

glossary: Person: - original: "示例角色名" aliases: - original: "示例角色名" translations: - text: "示例角色译名" overwrite: true

2️⃣ 开启“自动提取新术语”开关

进入「设置 → 翻译」分组，打开自动提取新术语。开启后，翻译请求会自动追加术语提取规则（来自glossary_extraction_prompt.yaml），并要求AI在返回翻译的同时输出new_terms字段。

✅ 关键机制：AI 提取到的新术语会自动合并写回你的自定义提示词文件的glossary字段（按扩展名写 YAML 或 JSON），下次翻译直接命中，无需手工维护。加载与写回的完整流程说明见 system-and-translation-prompts.md。

⚠️ 两个常见误区：

• “自动提取新术语”单独开启无效，必须同时存在一个可正常解析的自定义提示词；
• 写回功能会修改dict/下的文件，如果不想被运行时改动，请关闭该开关或给文件做只读备份。

AI智能断句：让模型决定在哪里换行

漫画气泡里的文字往往需要按原文行数控制换行。传统做法由渲染引擎自动换行，而 Manga Translator UI 提供了更智能的方案——让翻译模型自己断句：

1. 打开「设置 → 排版」分组，启用AI断句（对应配置键render.disable_auto_wrap）；
2. 翻译请求会自动加载dict/system_prompt_line_break.yaml中的断句规则；
3. 每个文本区域会附带original_region_count（原文行数），AI 按行数输出带[BR]换行标记的译文；
4. 最终渲染时校验[BR]数量与原文行数一致，保证译文与气泡形状贴合。

💡 “AI断句”不是纯渲染开关——它同时影响翻译请求的构造和排版换行，配置前请了解这一特性。

占位符与提示词组合顺序（进阶了解）

提示词文件中的{{{target_lang}}}（三层花括号）是字面量占位符，不是 Python 语法。每次构造请求时，运行时才把它替换为目标语言全称（如CHS→ Chinese (Simplified)），替换只发生在内存中，不会改写dict/里的文件。

每次翻译请求时，系统会把多份提示词按固定顺序拼成一段完整文本：重试提示（仅重试时）→ AI断句提示（可选）→ 自定义提示词（可选）→ 基础系统提示词 → 输出格式，然后整体注入 OpenAI 的system消息或 Gemini 的system_instruction，实现细节见 prompt_loader.py。

在编辑器中验证翻译效果

配置完成后，回到编辑器逐条验证：选中文本区域，在左侧「文本内容」面板选择翻译器与目标语言，点击「翻译」，对比译文是否符合你的风格设定与术语表。

常见问题速查

参考资料

• 官方提示词文档（中文）：系统提示词与翻译提示词、提示词列表、应用与预览、提示词结构化编辑器
• AI 类提示词：AI OCR 提示词、AI 上色提示词、AI 渲染提示词
• 核心源码：提示词管理页、统一提示词加载器、翻译设置页

⚠️ 安全提醒：提示词正文会原样进入API请求与日志，分享日志或调试记录前，请务必移除提示词内容、历史文本与API凭据。

【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理，集成OpenAl、Gemini等多翻译引擎；实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路，自带可视化编辑器，支持自定义文本样式，一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui