neavo/linguagacha/rpgmaker

本技能只提供 RPGMAKER 引擎知识，翻译、审校和提交流程按 translation 执行。

原稿与条目

每个游戏是一个工程资产，条目的 file_path 指向整个游戏，原稿成员位于 sources/<file_path>/：

sources/<file_path>/game_files.reference.txt 每行列出一个游戏目录中的文件路径。路径相对游戏根目录，包含图片、音频等素材。导入时读取失败的文件仍列在清单中。较早导入的工程没有该文件。

附加原稿的扫描范围：MV、MZ 为数据根目录，路径保留 www/ 前缀。XP、VX、VX Ace 为游戏根目录。

插件参数、note 和脚本字符串中的嵌套 JSON 按叶子拆成多个条目。默认翻译字段即使形似 JSON，也整段保存为一个条目。

默认状态

条目的默认状态由来源位置决定，数据库字段与事件文本分别判断：

• 文件身份决定数据库字段规则：只有数据目录下的直接成员套用标准数据库字段白名单，子目录中的同名文件只按事件结构识别事件文本。
• 事件结构决定事件文本规则：任何数据文件中的事件指令都按指令代码判断。

NONE 条目也可能被程序比较或查找，RULE_SKIPPED 条目中也可能有玩家可见文本。放行后的条目不会再因 EV001、0= 这类外观被过滤，但仍受源语言设置约束，混合语言或不含源语言文字的条目可能是 LANGUAGE_SKIPPED。

依赖协调

同一原文既用于显示、又被程序比较或查找时，只译其中一处会改变游戏行为：

1. 用原文搜索 sources/<file_path>/ 中的全部出现位置，包括插件和脚本源码。
2. 按实际读取该值的代码，判断每个位置是显示、比较、查找键还是资源名。
3. 比较值和查找键使用与显示位置一致的译名，通过各自的条目提交。证据不足时报告位置和原因，不回退已有译文。

原文相同不能单独证明存在依赖，只有语境和程序约束一致时才一起协调。不同原文作为查找键或比较值时，不能译成同一个值。

常见依赖位置：

默认跳过位置的可见文本

插件参数、note、注释和脚本默认跳过，但插件和脚本常用它们存放菜单、提示、帮助和资料。可见文本的来源如下：

RGSS 的事件指令编号与上表相同。122 的脚本操作数只存在于 VX Ace，数据库 note 只存在于 VX 和 VX Ace，插件指令和插件参数不适用。

可见文本也可以经间接路径显示，以下路径的输入字符串都属于正文：

• 先存入变量、数组或对象，之后由 \V[n]、界面或履历显示。
• 由插件用 replace 代入模板，例如 {city}、[word] 的替换值。
• 由文字图片插件绘制成图片，例如 DTextPicture。

发现路径的一端时，追踪到另一端。System.json 中的变量名只能辅助定位，字符串也可能是资源名、状态值或比较键。

字符串去掉扩展名后，与 game_files.reference.txt 中某个路径去掉扩展名后的最后一段或几段相同时，通常是资源名。例如 Actor1 对应 img/faces/Actor1.png。再结合读取代码确认。

一个插件的读取结论，只在确认另一处由相同代码读取后才能复用。

同一条目同时包含程序结构和显示文字时，称为混合条目，只翻译显示部分：

• 108 与后续 408 是同一个条目。插件可能用首行精确识别注释块，例如 選択肢ヘルプ、EVM:，首行保持原样。
• 标签键、参数键、分隔符和资源值保持原样，每个标签按读取代码分别判断。
• 单行 <键:值> 整体受默认文本保护，批量翻译不会改动其中的值。值为显示文字时，由 Agent 翻译。

控制符与占位符

• 默认控制符不区分大小写，\n 后面跟着 [ 时是 \N[n]，不是换行。
• MV、MZ 的 %1、%2 可以随语序移动。RGSS 中按位置代入的 %s、%d 不能交换顺序，需要换序时只能调整措辞。
• 默认保护只覆盖常用格式占位符。空格标志等特殊格式脱离调用语境无法与普通百分号正文区分，核查消费方式后按 text-preserve 添加自定义保护。

可见文本补漏

候选为含源语言文字的 RULE_SKIPPED 条目，排除以下位置：

• js/plugins.js 中 status 不为 true 的插件参数，这些插件不会加载。
• MZ 657 条目，对应文本通过 357 参数条目翻译。

候选按「默认跳过位置的可见文本」的来源归类，找到读取该位置的插件、脚本或事件代码后，按读取结果判定：

显示 条目的原文在其他位置用作比较值或查找键时，由「翻译后检查」的「名称依赖」协调。

翻译后检查

翻译流程写入译文后，对本次写入的条目及其依赖位置执行以下检查，用脚本批量完成：

审校检查点

执行「翻译后检查」的全部检查，并按「可见文本补漏」的候选和判定核对 RULE_SKIPPED 中的可见文本有无漏译。

覆盖缺口

交付时说明以下未覆盖范围：

• source_issues.jsonl 记录的成员，以及有语法错误、未产生条目的脚本。
• MV、MZ 核心 JS 与 Game.ini 的标题等不产生条目的文件，数据、插件和脚本以外的文件，以及图片中的文字。
• 证据不足、保持未决的依赖，以及需要协调但没有条目可写、也未制作补丁的位置。
• 可见文本补漏依据静态代码调查，无法证明没有遗漏。建议用户在游戏中抽查，并用截图定位遗漏。