前言¶

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