前言¶

DSH 的理念是「一切皆插件」：具体工具可以通过插件进入智能体工作流。视觉小说本地化通常先要处理一个本地游戏目录：引擎是什么、脚本在哪里、哪些文本可以安全翻译、游戏更新后已审译如何复用、翻译是否满足门禁、替换后能否回滚。

下面介绍 dsh-galgame-localization-reverse。它是 julescules 维护的社区插件，许可证为 MIT，目标是在不直接做翻译的情况下，给 DeepSeek Harness 提供审计证据、安全迁移、严格 QA 和可回滚操作。DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；该插件也不是 DeepSeek 官方审核或背书的应用商店组件。

这是什么¶

dsh-galgame-localization-reverse 的一句话定位是：

Galgame Doctor for DeepSeek Harness: safe translation-memory migration, evidence plans, strict QA, and rollback.

它主要面向本地 Galgame 文件夹，处理本地化前后的工程问题：

• 离线读取本地游戏目录，给出引擎候选和路径证据。
• 对 KiriKiri .ks、Ren’Py .rpy、NScripter 0.txt 等纯源脚本做提取与应用。
• 在游戏更新后迁移已审译，并记录 SHA-256。
• 对翻译 JSONL 做术语表、禁用词、残留日文、编码等严格检查。
• 提供 hash-bound 补丁、备份、回滚，以及 PNG/APNG、JPEG、GIF、BMP 图像 QA 和 fixed-slot QA。

该插件不需要 API key。资料中说明它不包含游戏资产、解密包、凭据或标题特定密钥。

核心功能¶

1、离线只读审计

对本地游戏目录做 offline read-only audit，输出引擎候选和路径证据。vn_project_audit.py 提供 one-command localization plan。

2、纯源脚本适配

支持 KiriKiri .ks、Ren’Py .rpy、NScripter 0.txt 的 lossless source-script adapters。脚本适配器只支持 plain source files，不暗示 archive 或 compiled-script 兼容。

3、翻译记忆迁移

游戏更新后，把 reviewed translations 迁移到新目录。迁移结果会记录 SHA-256 hashes，用于避免静默猜测。

4、严格翻译 QA

检查 glossary、forbidden terms、residual Japanese、encoding 等项目，并可输出报告。

5、补丁与回滚

通过 vn_patch.py 做 hash-bound patching，并包含 backup 与 rollback。

6、图像与槽位 QA

支持 PNG/APNG、JPEG、GIF、BMP 图像 QA，以及 fixed-slot QA。

安装与启用¶

安装前先确认你愿意以当前 dsh 进程权限运行该插件，并检查源码、许可证和发布版本。该插件许可证为 MIT。

安装命令：

dsh plugin --profile web add github:julescules/dsh-galgame-localization-reverse#v0.6.0

安装后重启 DSH，再让 DSH 使用 galgame-localization-reverse 对本地游戏目录做只读审计。

典型用法¶

下面使用占位路径说明常见步骤。实际使用时，请把占位符替换为真实目录，并确认输出目录与游戏目录分离。

1. 审计本地游戏目录¶

先运行审计计划，生成 JSON 和 Markdown 输出：

vn_project_audit.py plan <GAME_FOLDER> --json <AUDIT_JSON> --markdown <AUDIT_MD>

这一步用于查看引擎候选、路径证据和本地化风险，而不是直接修改文件。

2. 提取纯源脚本¶

从 KiriKiri、Ren’Py 或 NScripter 纯源脚本提取 UTF-8 JSONL：

vn_script_adapter.py extract <GAME_FOLDER>

提取后的 JSONL 适合后续翻译或 QA。脚本适配器只处理 plain source files，不处理 archive 或 compiled-script。

3. 应用翻译¶

将翻译结果应用到 separate output root：

vn_script_adapter.py apply <GAME_FOLDER> <translations.jsonl>

不要把输出写回原游戏目录。若源文件发生变化，应用过程应失败。

4. 迁移已审译¶

游戏更新后，使用翻译记忆迁移已审译：

vn_translation_memory.py migrate

运行时需要提供当前目录、上一版目录、输出与报告位置。报告中会记录 SHA-256 hashes。

5. 严格 QA¶

对翻译 JSONL 做 encoding、glossary、max chars/lines、punctuation 等检查：

vn_qa.py <translations.jsonl> --encoding <ENCODING> --glossary <GLOSSARY_JSON>

可再结合 max chars/lines、punctuation 和 report 输出，形成可复查的 QA 结果。

6. 验证插件包¶

发布前或安装前可以验证包内容：

npm run check
npm pack --dry-run

同时核对 release metadata、SHA-256 与 SBOM 证据。

适用场景与注意¶

适合：

• 已经有一个本地 Galgame 文件夹，需要先判断引擎与文件证据。
• 有已审译 JSONL，需要在游戏更新后安全迁移。
• 需要对译文字符、术语、残留日文、编码做可重复检查。
• 希望补丁、图像 QA、fixed-slot QA 有明确证据和回滚路径。

注意：

• 引擎格式与二进制常量可能依赖具体标题和版本；在未用 exact hashes 验证前，不要把它当作通用结论。
• static audit 和 QA 不能替代 in-game round-trip 测试、UI、save/load、audio 和 rollback 测试。
• residual Japanese 可能是有意保留；遇到报告时逐条判断或显式排除，不要默默降低门禁。
• DeepSeek Harness 处于 developer preview；应 pin 已审核的插件发布版本。本文使用的安装命令 pin 到 v0.6.0。
• 该插件是 community plugin，未经 DeepSeek 审核或背书。DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

链接¶

• GitHub：https://github.com/julescules/dsh-galgame-localization-reverse
• 目录页线索（未在本次已核实资料中确认，仅供搜索参考）：https://www.skillhub.cn/plugins/julescules/dsh-galgame-localization-reverse