前言¶
DeepSeek Harness（DSH）的 Web GUI 默认为英文界面。对于习惯使用巴西葡萄牙语的开发者，阅读英文界面会增加认知负担。DSH 采用插件化架构，允许通过第三方插件扩展功能。grstein/dsh-locale-ptbr 就是这样一个插件，它为 DSH 的 Web GUI 提供巴西葡萄牙语语言包，在不修改 Harness 源码的情况下实现界面本地化。
插件定位¶
这是一个由用户 grstein 维护的开源插件（MIT 许可证），旨在覆盖 DSH Web 界面中的特定文本。
核心功能¶
- 添加巴西葡萄牙语语言包。
- 实时翻译 Web GUI 界面。
- 覆盖 33 个命名空间和 1,029 个键，包括对话、轨迹、工具卡片、工作区、配置、审批、任务、子代理和命令。
- 支持配置文件（通过
--profile web或dsh web命令使用）。 - 自动回退到英语（如果未翻译的键）。
- 包含通过
npm test进行的一致性检查。
安装与启用¶
使用 dsh plugin 命令安装。该命令会将操作转发给 profile 目录下的 pnpm，因此支持 github:、本地路径或内部 registry。
dsh plugin --profile web add github:grstein/dsh-locale-ptbr
安装后，进入 GUI 的「配置」→「常规」→「语言」选项即可选择「Português (Brasil)」。
典型用法¶
安装后，可以通过以下方式启用或管理：
# 启用插件后，检查配置层是否包含该插件
dsh --profile web --dump-config
# 启动 Web 服务
dsh web
如需移除：
dsh plugin --profile web remove @grstein/dsh-locale-ptbr
适用场景与限制¶
适用场景：主要面向习惯使用巴西葡萄牙语的 DSH 用户。
限制：
1. 不修改 Harness 代码：插件仅通过运行时注入实现翻译，不修改 DSH 源码。
2. 翻译范围：仅翻译 GUI 产品副本。不翻译模型输出、终端输出、文档、引导画面或注册表中的原始文本。
3. 环境依赖：构建和测试依赖 Node.js 环境。
4. 回退机制：未翻译的键会自动显示为英文，不会显示原始键名。
维护与同步¶
该插件维护了 dicts/<ns>.json 作为翻译源。开发者可以使用 npm run build 重新生成客户端代码，并使用 npm test 验证键值一致性。
随着官方 Harness 版本更新，可能引入新的键或修改现有键。该插件提供 tools/sync.mjs 脚本，用于比对官方 Harness 代码并生成更新报告。若需跟进版本，可使用 --apply 参数应用更新。
生态背景¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。本插件并非官方维护，而是社区生态的一部分。相关插件信息可参考 SkillHub。
