前言¶
DeepSeek Harness 的核心是「一切皆插件」。對於遊戲開發者或本地化團隊來說,構建一套從偵察、術語、翻譯到打包驗證的流水線往往需要編寫腳本、維護配置。dsh-plugin-tav2 將這套流水線接入了對話界面。翻譯由模型完成,用戶只需通過對話下達指令,從初始化、翻譯到打包驗證,全程由標準工作流推進。
這是什麼¶
這是一個裝進 DeepSeek Harness 的插件,開源地址在 GitHub(Drhushi/dsh-plugin-tav2)。它的核心價值是將 AI 翻譯流水線接進對話:翻譯由模型完成,你只需要跟助手說話,從初始化、翻譯到打包部署,全程由標準工作流推進。該插件採用 MIT 許可證。
核心功能¶
- 對話式全流程:說一句「初始化遊戲翻譯」,助手探測遊戲、生成配置、給出翻譯計劃,確認後才動手。
- 補丁式非侵入:不碰原遊戲任何文件,交付物是可合併的補丁包(含 manifest 清單與版本指紋),刪除清單所列文件即可完全還原。
- 增量遷移:按版本指紋與穩定 ID 做增量遷移,已有譯文自動保留,只補譯變化的部分。
- 翻譯質量基建:術語掃描與推敲鎖定、世界書提名制(按三問判據推薦值得出卡的設定級實體)、審校隊列、完整性校驗、運行時三層驗證。
- 多引擎適配器架構:一套工作流對接不同遊戲引擎,當前已落地 Ren’Py 適配器。
安裝與啓用¶
在安裝前,請確認環境滿足以下要求:
* DeepSeek Harness ≥ 0.1.5-rc.1(Web 版,Node.js ≥ 22.19)。
* 遊戲目錄內含 game/(當前需爲 Ren’Py 遊戲,其他引擎支持見下文)。
* 配置了可用的 LLM 翻譯通道(如 DeepSeek API Key 或本地 OpenAI 兼容端點)。
安裝方式 A(推薦):
從 GitHub Release 下載預構建的 .tgz 資產,無需自行構建。在 PowerShell 中執行:
$ver = '0.2.1' # 換成你要裝的版本
$tgz = "https://github.com/Drhushi/dsh-plugin-tav2/releases/download/v$ver/dsh-plugin-tav2-$ver.tgz"
pnpm -C "$env:USERPROFILE\.dsh\profiles\web" add $tgz
安裝完成後,重啓 GUI(客戶端 bundle 是啓動時的快照,重開聊天不生效)。進入「設置 → 插件」,確認卡片出現。
典型用法¶
- 初始化:在工作區文件夾設爲遊戲根目錄後,對助手說「初始化遊戲翻譯」,助手會生成最小配置。
- 偵察:運行
tav2_detect或tav2_status,列出翻譯計劃供確認。 - 翻譯:運行
tav2_translate_batch,助手按場景分批翻譯,完成後自動校驗。 - 打包部署:運行
tav2_pack生成補丁包,將遊戲目錄合併進根目錄。 - 驗證:遊戲內語言菜單選中文,啓動覈對,或運行
tav2_verify複查。 - 卸載補丁:運行
tav2_uninstall按清單精確刪除。
常用工具還包括:
* tav2_prepare:生成翻譯模板。
* tav2_terms / tav2_deliberate:術語掃描與鎖定。
* tav2_worldbook:世界書提名制。
* tav2_check:完整性校驗。
* tav2_migrate:遊戲更新後的增量遷移。
適用場景與注意¶
該插件首發支持 Ren’Py 遊戲。普通 .rpy 源碼遊戲開箱即用;遇到 .rpyc 已編譯遊戲需要配置 Ren’Py SDK。Unity 等其他引擎目前佈局可識別,適配器待落地,誤報會被提示。
需要注意:
* 前置條件:CJK 字體等運行時組件屬於前置條件,需用戶自行安裝,不進補丁包。
* 版本依賴:DSH 需要大於等於 0.1.5-rc.1 才能正常加載。
* 卸載機制:卸載需從 profile 移除掛載並重啓 harness。設置卡里的「翻譯模式」開關不是加載門控,關閉它不會停止插件在新會話裏的生效。
短結尾¶
dsh-plugin-tav2 通過對話式交互,將原本繁瑣的本地化流程標準化。如果你正在使用 DeepSeek Harness 處理遊戲本地化,特別是 Ren’Py 項目,這個插件提供了一個從偵察到交付的一站式方案。項目詳情請查看 GitHub。