前言¶
用 DSH 做游戏汉化时，常见做法是主对话里反复让 Agent 解包、翻句、写回，进度散落在聊天里，审校也难对照原文。手工改一句往往还要再走一遍模型，成本和上下文都偏高。下面介绍社区插件 DSH-game-translate（维护者 S0ra233，GitHub S0ra233/DSH-game-translate）：在 Harness 上挂独立翻译窗口，底层对接便携的 game-translation Core 与配套 Skill，把「选目录、分组阅读、双栏审校、多模型派发、独立副本写回」拆成可操作的步骤。
这是什么¶
DSH-game-translate 是基于 DeepSeek Harness（dsh） 的可视化本地游戏汉化插件。插件代码与资源独立维护，无需改上游 game-translation 核心或 Harness 源码。在工作目录根对话输入 /翻译 可唤出独立原生翻译窗口；资产解包、任务派发、质量审校与独立副本写回由主对话 Agent 协同内置 game-translation Skill 与 Core 完成。
在 SkillHub 目录中分类为「工作流」；仓库当前版本为 0.9.3（见 package.json）。
三层协同机制¶
README 将能力归纳为三层：
- 原生可视化窗口：游戏目录选择、阅读分组、原文/译文双栏对照、检索、任务进度、悬停手改；Windows 下为独立非置顶窗口，不阻塞主聊天。
- DSH 主/子 Agent 调度：主 Agent 负责工程初始化、审校与封装；批量翻译可由主 Agent 完成，或通过 DSH 原生子 Agent 委托其他模型并发处理。
- 确定性汉化核心（Python Core & Skill）：驱动
game-translationCore，保留Entry / Task / Scene状态机、占位符与术语校验、译文草稿修订；原游戏只读，生成独立汉化副本并逐字段读回核验。
核心功能（已文档化部分）¶
智能阅读分组与脚本定位¶
相邻 Scene 按文件来源、事件及章节/路线边界聚合为阅读组，默认软容量约 140 段 / 6000 原文字符，并尝试收敛至 60 组以内（保留边界优先，不保证所有游戏都能压到该数量）。组内可展开原始脚本标签与分支片段；勾选阅读组发起翻译后，Host 解析真实成员并分批交给 Agent。底层 Scene / Task ID 与写回索引不变。
双栏对照与零 Token 手改¶
原文只读、译文可编辑，同一 Task 双栏等高对齐。悬停可进入编辑，Ctrl+Enter 保存、Esc 取消；保存经宿主通道调用 Core 做占位符与规则校验，不调用大模型。可改译文或说话人译名。
检索与进度¶
支持 Ctrl+F 或放大镜打开检索栏：人名、原文、译文分字段组合，并可按未翻译、待复核、已处理、异常等状态筛选。进度以圆弧与详情卡展示（以底层 Task 为单位，数量可能与屏幕段落合并显示不同）。
多模型与子 Agent¶
设置面板可配置专用翻译模型，兼容 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini generateContent。API Key 由 DSH credentials 服务托管，不写入浏览器 localStorage 或插件命令参数日志。
Windows 原生窗口¶
面向 x64，需 .NET Framework 4.8 与 WebView2 Runtime；支持 WPF / DWM 玻璃与纯白材质切换。非 Windows 环境沿用浏览器弹窗 / 浮窗入口。
支持的引擎¶
内置 Core 覆盖 6 大引擎家族的提取、审查、翻译与写回路线（可选工具需按游戏另行配置；文档标明为实现范围，非所有版本均已验收）：
| 引擎 | 要点 |
|---|---|
| RPG Maker (XP / VX / VX Ace / MV / MZ) | MV/MZ 读写 JSON 与事件脚本；旧作支持加密归档解密脱壳 |
| WOLF RPG Editor | 集成 UberWolfCli / WolfTL，解包 .wolf 并结构化导出对白 |
| Unity | 表格与 TextAsset、UnityPy 序列化资产、IL2CPP / Mono 代码字符串等 |
| Ren’Py | .rpy / .rpa / .rpyc，输出标准 game/tl/<language>/ |
| TyranoScript | 松散工程或 Electron app.asar 中的 .ks |
| Godot (3.x / 4.x) | GDRETools 读写 .pck、场景属性、PO 与 OptimizedTranslation 等 |
安装与启用¶
官方 README 的安装方式为安装发布包，而非从仓库名拼接 CLI 命令：
- 安装发布包
dsh-game-translate-<version>.tgz（当前仓库版本号为 0.9.3，发行包文件名中的<version>以你下载的包为准）。 - 若有未保存输入请先备份，完全退出并重启目标 DSH profile（付费账户与主模型沿用原有 DSH 设置）。
运行环境（文档已验收组合）：DSH 0.2.1-rc.3、Cordis ~4.0.5、Node.js 24.9+、Python 3.10+。发行包已预编译前端 UI，安装后无需再 npm run build。
插件以当前 DSH 进程权限运行；安装前应自行查看仓库源码与 LICENSE、THIRD_PARTY_NOTICES.md。DeepSeek Harness 社区插件目录（如 SkillHub 条目）为独立站点，与 DeepSeek / 幻方无官方从属关系。
典型用法（五步）¶
- 完成上述安装并重启 profile 后，在工作目录根对话输入：
/翻译
- 在翻译窗口右上角
••• → 选择游戏目录…，用原生文件夹对话框选定游戏根目录。 - 点击 「初始化」 并确认额度提醒；进度与报错可在原聊天窗口查看。成功绑定根会话后初始化按钮会禁用以防重复；失败可保留现场产物后重试。
- 点击 「翻译…」 勾选阅读组，选择主 Agent 翻译或调度子 Agent 使用其他模型。完成后用检索、进度卡与双栏审阅；铅笔图标可手改并 Core 校验保存。
- 核对后点击 「封装写回…」 选择输出路径，主 Agent 调用 Skill / Core 创建独立游戏副本并完成读回核验。
更完整的安装、模型配置与排查见仓库 docs/使用说明.md。
适用场景与注意¶
适合：已在 Windows 上使用 DSH 做本地 Agent 工作流、需要对 Unity / RPG Maker / Ren’Py / Godot / WOLF / TyranoScript 类游戏做汉化，并希望用可视化窗口做对照审校与进度管理，而不是纯聊天驱动。
注意：
- 文档声明的自动验证未使用真实 API Key、未自动启动游戏；真实模型连通性、窗口表现与实机运行需自行实测。
- 各引擎边界情况（加密变体、动态拼接文本、ASAR 完整性校验、IL2CPP Stripped TypeTree 等）可能需要 Agent 个案辅助；写回产物为独立副本，原游戏保持只读流程。
- 升级插件前请保存未提交输入并备份配置；保持原有
dataDirectory可延续绑定与译文。
结尾¶
DSH-game-translate 把游戏汉化从「长对话脚本」收成 /翻译 窗口 + Core 确定性写回，并在 Harness 内接好多协议模型与子 Agent 并发。若你要在本地工作流里汉化上述六类引擎游戏，可从目录页与 README 对照环境版本后安装 .tgz 发行包试用。
- 目录页：https://www.skillhub.cn/plugins/S0ra233/DSH-game-translate
- GitHub：https://github.com/S0ra233/DSH-game-translate
