支持的引擎 · Kirikiri / KAG
Kirikiri 翻译器 —— 翻译 KAG 视觉小说和 XP3 归档
Kirikiri(及其脚本层 KAG)是占主导地位的日语视觉小说引擎 —— 过去 15 年相当一部分商业 VN 发布都建立在它上面。RuneTranslate 提供一个完整的 XP3 读取器和写入器,自动打开打包的归档(包括它认得的作品所用的、部分近期发行版采用的较新格式),支持打乱过的剧本文件和编译过的 PSB(.scn)剧本,以及对注音标注、角色名、按钮标签、glink 文本和编辑框占位符的智能提取。译好的构建会发出松散文件,加上一个 AfterInit2.tjs 路径优先钩子,告诉引擎优先加载它们而非原始 XP3 内容;对于跳过该钩子的游戏,还有一个引擎在自己的归档之后挂载的补丁归档,于是你从不需要重新打包原始归档。一个 Kirikiri VN 通常发布数十个剧本,如何在其间保持角色名一致?那正是 Supporter 档位的术语表功能所做的 —— 把女主角的名字加一次,每一个剧本文件都以同样方式翻译它。
Kirikiri VN 通常把对话分散在数十个独立的剧本文件里,每个在自己的批次里翻译。没有术语表,那就是同一个角色名在各章之间漂移的配方。加上每一个具名说话者(尤其是名字用了机器翻译常常摇摆的汉字的那些)、地名,以及招牌招式/法术术语。附加好处:KAG 内联注音标注是标记屏蔽的,所以即使在有 [ruby] / [name] 内联标记的行上,术语表替换也正确落位。
如何翻译 Kirikiri / KAG
- 步骤 1
打开 Kirikiri 游戏文件夹
把 RuneTranslate 指向含引擎 .exe(krkr.eXe、krkrZ.exe 等)的目录。引擎检测会扫描 XP3 归档 + .ks 剧本格式。打包的 XP3 归档会自动打开,无需任何配置。
- 步骤 2
提取对话、注音、名字和按钮标签
RuneTranslate 用一个 KAG 感知的分词器解析 .ks 剧本。可翻译字符串从对话行、[ruby]、[ch]、[name]、[title]、[button]、[checkbox] 和 [edit text="..."] 标记中提取。内联 KAG 标记([r]、[p]、[改ページ]、[font])被屏蔽为不透明占位符,让 LLM 保留它们。
- 步骤 3
用你选择的翻译服务翻译
选一个翻译服务 —— DeepL 是长 Kirikiri 剧本的主力,因为它的价格和 JA→EN 质量。OpenAI 和 Anthropic 对角色声线强的对话最强。免费的 Google Translate 在 Supporter / Pro 档位上通过翻译服务分流廉价地处理菜单字符串。
- 步骤 4
导出松散文件 + AfterInit2.tjs 钩子
导出时,RuneTranslate 会把译好的脚本作为松散文件写出,加上一个 AfterInit2.tjs 钩子进游戏根目录,以及一个引擎在自己的归档之后挂载的 patch.xp3。钩子把松散文件放到搜索顺序的最前面,补丁则覆盖跳过该钩子的游戏,于是译好的脚本胜过打包的 XP3 内容。原始归档保持不动。
支持内容
- XP3 归档读取和写入,打包的归档自动打开
- 读取打乱过的剧本文件
- 注音标注、角色名、按钮标签
- [name]、[title]、[button]、[checkbox]、[edit text=...] 标记
- 内联 KAG 标记([r]、[p]、[改ページ]、[font color=...])得以保留
- AfterInit2.tjs 路径优先钩子加一个 patch.xp3(无需重打包)
局限
- 一种罕见的、应用暂时还不认识的打包归档格式不会被读取
- 编译过的 KAG 字节码(无法按文本读取、带 `jk` 魔数的 .ks)不支持
- 原始引擎 Kirikiri 1.x(非 Z)未测试,但通常能用

