前言¶
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。