视觉小说汉化迁移 julescules/dsh-galgame-localization-reverse

DeepSeek Harness Galgame Doctor

v0.9.1 更新：审核导入错误显示 CSV 记录起始行，支持多行字段和空行；编码错误不回显译文。另已验证 DSH 0.2.1-rc.3 下的技能注册与正文加载。

本版更新：审核表支持 --dry-run 预检，先核对控制符、编码和哈希，再决定导入；严格拒绝损坏的 CSV 引号。

游戏更新后复用旧译文，把人工审核结果可靠地带回汉化流程。

| 你手上的材料 | 插件能给你的结果 |
| 不熟悉的游戏目录 | 引擎候选、文件证据和下一步计划 |
| 旧译文与新版脚本 | 精确复用、冲突报告和审核表 |
| 人工改好的审核表 | 校验后生成新的译文 JSONL |
| 待发布补丁 | 控制符、编码、资源与回滚检查 |

本版补齐审核闭环：迁移时用 --review-csv review.csv 导出表格，在 Excel/WPS 中填写确认过的 reviewed_target，再导回：

python -B -X utf8 skill/scripts/vn_review.py --current current.jsonl --review-csv review.csv --output reviewed.jsonl --encoding gbk

current.jsonl 必须是迁移时原始 current 文件，不能换成 migrated 输出。导入器核对哈希、重复/未知段落、控制符和目标编码；所有行通过后才生成新文件，空白审核项保留待办。支持默认字段 segment_id/source/target。接着以 reviewed.jsonl 为 current 再做一次历史迁移，合并精确复用结果，最后运行严格 QA。

安装本版：dsh plugin --profile web add github:julescules/dsh-galgame-localization-reverse#v0.9.1，然后重启 DSH。

导入前预检

python -B -X utf8 skill/scripts/vn_review.py --current current.jsonl --review-csv review.csv --dry-run --encoding gbk

预检不接受 --output，不写文件。JSON 中 ready 表示已填写且校验通过的审核行，pending 表示审核表中的空白行，applied 始终为 0；它们不代表整个游戏的翻译完成率。任何一行失败，预检返回非零状态。通过后去掉 --dry-run 并指定新的 --output reviewed.jsonl 正式导入。

[!IMPORTANT]
非官方社区插件，由社区独立开发与维护，未经 DeepSeek 审核或背书。

先体检，安全复用，再汉化。把视觉小说目录交给 DeepSeek Harness，得到带证据的引擎候选、安全翻译迁移、编码线索、严格 QA 和可回滚的下一步。体检完全离线且只读；只允许把报告写到被审计目录之外。

合成终端示例：只读引擎体检与严格翻译 QA

30 秒开始

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

重启 DSH，然后直接说：

请使用 galgame-localization-reverse 对 D:\Games\Example 做只读体检，列出引擎证据、汉化风险和最安全的下一步。

不需要 API Key。插件不包含游戏资源、解密封包、凭据或作品专用密钥。

能得到什么

一条命令生成汉化计划

vn_project_audit.py plan 在受限范围内盘点文件，并报告：

- 带置信度、信号组和实际相对路径证据的引擎候选；
- 剧本、封包、图片、字体和可执行文件候选；
- 有上限的编码抽样，以及安全显示的中文／日文路径；
- 谨慎的 candidate、weak-candidate 或 unknown 分类；
- 证据状态、推荐路线、准确的下一条命令、风险和发布门禁。

分类只用于选择路线，不代表静态检查已经证明运行时行为。

python -X utf8 skill\scripts\vn_project_audit.py plan D:\Games\Example
--json D:\project\logs\project-audit.json
--markdown D:\project\logs\project-audit.md

可往返的源脚本适配器

vn_script_adapter.py 将普通 KiriKiri .ks、Ren'Py .rpy 和 NScripter 0.txt 文本提取为 UTF-8 JSONL，同时保存源文本哈希、整行哈希、路径、行号、编码、BOM、换行、前缀和后缀。回注始终写入独立输出目录；原文发生变化时 fail closed。

python -X utf8 skill\scripts\vn_script_adapter.py extract D:\Games\Example
--engine kirikiri --output D:\project\translations.jsonl

python -X utf8 skill\scripts\vn_script_adapter.py apply D:\Games\Example
D:\project\translations.jsonl --output-root D:\project\rebuilt

它不会打开 XP3/NSA 封包，也不宣称支持编译剧本。

游戏更新后的安全翻译迁移

vn_translation_memory.py 可把一个或多个旧版本中的已审校译文迁移到新提取文本表，但不会暗中猜测。重复使用 --previous 即可合并多个历史版本；跨版本精确译文冲突时保持空白并返回非零状态，模糊匹配只进入人工复核队列。报告记录每份输入的 SHA-256。可选的 UTF-8 BOM CSV 能直接交给 Excel/WPS，并预留人工译文与备注列。

python -X utf8 skill\scripts\vn_translation_memory.py migrate
--current D:\project\v2\translations.jsonl
--previous D:\project\v1\translations.jsonl
--previous D:\project\v1-hotfix\translations.jsonl
--output D:\project\v2\migrated.jsonl
--report D:\project\logs\translation-memory.json
--markdown D:\project\logs\translation-memory.md
--review-csv D:\project\review\translation-memory.csv

严格翻译门禁

vn_qa.py 默认阻断控制标记缺失、新增或重排。v3 新增术语表、禁用词、重复原文译法一致性、字符/行数预算、标点配对、空译、残留日文和目标编码检查。无需第三方包即可读取通用 JSON/JSONL、脚本适配器 JSONL 和 GalTransl 缓存字段。

python -X utf8 skill\scripts\vn_qa.py check-jsonl D:\project\translations.jsonl
--encoding gbk --require-complete --require-consistent
--glossary D:\project\glossary.json --max-chars 80 --max-lines 3 --check-punctuation
--report D:\project\logs\translation-qa.json
--markdown D:\project\logs\translation-qa.md

仓库内故意损坏的合成样例会产生直观报告：

FAIL 2 blockers · 3 segments E control-token-added scene01:2 added [wait] E empty-translation scene01:3 translation required

发布证据，而不是再造一个翻译器

插件还自带：

- vn_patch.py：哈希绑定的文件替换、验证、备份与回滚；
- vn_image_qa.py：比较 PNG/APNG、JPEG、GIF、BMP 的尺寸、alpha 和帧数；
- vn_slot_qa.py：检查固定槽终止符、填充、控制标记和槽区外改动；
- 面向 AI6WIN、BGI/Ethornell、Director、RealLive、Delphi/DirectDraw、PSP/Vita、Ren'Py、KiriKiri 和自定义引擎的专门路线。

GalTransl、VNTextPatch、GARbro、LunaTranslator 和引擎专用工具负责翻译或提取；Galgame Doctor 负责判断项目像什么、检查它们的文本输出，并保存可审计的发布证据。

运行合成样例

python -X utf8 skill\scripts\vn_project_audit.py plan examples\synthetic-project\game
--json test_outputs\synthetic-audit.json
--markdown test_outputs\synthetic-audit.md

python -X utf8 skill\scripts\vn_qa.py check-jsonl examples\translations.jsonl
--encoding gbk --require-complete --glossary examples\glossary.json
--report test_outputs\translation-qa.json
--markdown test_outputs\translation-qa.md

所有示例文本均为原创合成数据，可公开再分发。

DSH 集成方式

插件使用官方打包 Skill Provider 结构：

- inject = ['skills']；
- ctx.skills.registerProvider(...)；
- 通过目录 resourceBase 按需读取参考和脚本；
- 使用官方 dsh.bundle.patch 安装入口。

注册名仍是 galgame-localization-reverse，已有提示词无需修改。

验证包

npm run check
npm pack --dry-run
node scripts/build-release-metadata.mjs .\dsh-galgame-localization-reverse-0.9.1.tgz .\builds\v0.9.1
.\scripts\verify-release.ps1 -PackagePath .\dsh-galgame-localization-reverse-0.9.1.tgz -ChecksumsPath .\builds\v0.9.1\SHA256SUMS

检查包含 Provider 测试，以及计划生成、脚本适配、翻译记忆迁移、翻译 QA 和全部补丁／资源工具的确定性自测。每个 Release 还会发布 SHA-256 与 CycloneDX SBOM 证据。

边界

- 引擎格式和二进制常量在绑定具体版本哈希前都只是候选。
- 脚本适配器只支持普通源文件，不代表封包或编译剧本已经兼容。
- 静态体检与 QA 不能代替零变更回注和实际 UI、存读档、音频、回滚测试。
- 残留日文可能是有意保留项；应逐条审阅或维护明确排除表，不能静默放宽门禁。
- DeepSeek Harness 尚处于开发预览阶段，请固定到已审阅的插件版本。

贡献与安全报告方式见 CONTRIBUTING.md 和 SECURITY.md。

许可

MIT

兼容性：此前完整宿主验证基线为 DSH 0.1.2-rc.1。2026-10-18 已使用真实 DSH 0.2.1-rc.2 技能注册表和 Cordis 包验证 Provider 注册及技能正文加载；该结果不代表完整 Web 界面或模型会话测试。