前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构，命令、Skill 和插件列表会随生态增长而变长。对中文用户来说，常见情况是：看得懂英文，但每次在「看英文 → 脑内翻译 → 理解」之间切换，都会占用注意力；插件装多了，也不容易从名称上快速对应功能。
dsh-zh-layer 不修改 DSH 源码，而是在运行时包装元数据并调整前端展示，把命令、Skill 和插件列表渲染成「中文名称 + 英文原名 + 中文功能说明」等形式，并支持一键切回英文原版。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-zh-layer 由 Lin-AxiomSight 维护，在 SkillHub 等社区目录中归类为客户端插件。项目以 MIT License 发布，当前 package 版本为 0.6.0。
它是一层可开关的双语覆盖层：通过 Cordis 补丁与客户端注入（cordis.patch.yml、client.js），在不硬编码、不改 DSH 核心代码的前提下，为插件、斜杠命令与 Skill 叠加中文名与说明；卸载或关闭显示模式后，界面可恢复原版英文。
核心功能¶
双语排版与三种显示模式¶
命令菜单、Skill 与插件列表均支持中文主显，并保留英文原名作为索引。在 设置 → 翻译设置 中可选择：
- 只显示中文（
zh）：界面仅保留中文。 - 中英都显示（
both）：中文辅助理解，英文原名便于分辨（README 推荐此模式）。 - 不翻译（
off）：关闭覆盖层，刷新页面即恢复英文原版，适合录屏或演示。
AI 翻译：手动触发、增量提交¶
未内置译文的条目需要补全时，由用户在设置页手动点击翻译按钮发起请求，不会后台静默调用模型。插件会先对照已有翻译缓存，仅提交尚未翻译的条目；不点击按钮时不消耗 Token。
AI 翻译默认使用 DeepSeek 官方通道的 deepseek-flash 模型（README 说明暂不支持自定义模型）。上传内容限于待翻译的插件名称与描述、命令名与 Skill 名称；不会上传聊天记录、本地文件或配置密钥。README 给出的成本参考是：约 50 项插件 / 命令 / Skill 全量翻译约 2–3 分钱，实际随条目数量、文本长度与官方定价浮动。
实现方式与依赖¶
README 标明实现为原生 Node.js 与浏览器 API，不引入第三方 npm 依赖。配置与词典保存在全局目录：
~/.dsh/zh-layer-config/
可在设置页修改 AI 翻译提示词；需要微调译文时，可通过设置页打开配置文件夹手动编辑词典（README 注明「打开配置文件夹」快捷按钮目前仅支持 Windows）。
安装与启用¶
安装前建议自行查看 GitHub 仓库 源码与许可证。插件在 DSH 进程权限下运行，与任何第三方插件一样，安装前应确认信任来源。
命令行¶
桌面端：
dsh plugin --profile desktop add dsh-zh-layer
Web 端：
dsh plugin --profile web add dsh-zh-layer
客户端图形界面¶
- 打开 DSH 客户端，进入 插件 页面，点击 添加插件。
- 输入包名
dsh-zh-layer，或指定版本例如dsh-zh-layer@0.6.0，然后安装。
插件市场¶
在 DSH 的「发现」或「插件市场」中搜索 dsh-zh-layer 并安装。
安装完成后重启 DSH，再在 设置 → 翻译设置 中选择显示模式。
典型用法¶
- 安装插件并重启 DSH。
- 进入 设置 → 翻译设置，选择
zh、both或off。 - 设置页会统计未翻译条目；需要时点击一键翻译补全内容。
- 在聊天框输入
/呼出命令菜单，或打开插件列表，查看双语展示效果。
进阶方面：插件的 AI 输入来自插件元数据中的名称与描述；命令与 Skill 则来自呼出菜单时抓取的名称。关闭翻译（off）后刷新页面即可对比原版界面。
卸载与已知局限¶
卸载（桌面端示例）：
dsh plugin --profile desktop remove dsh-zh-layer
Web 端将 desktop 换为 web。也可在 设置 → 插件 中找到 dsh-zh-layer 卸载并重启。若需删除已生成的翻译文件，可手动删除 ~/.dsh/zh-layer-config/。
README 列出的局限包括：排版依赖 DSH 现有 DOM 结构，DSH 大版本底层变动或特殊 UI 插件可能导致排版失效；AI 模型暂不可自定义。
适用场景¶
适合长期在 DSH 中使用大量插件与斜杠命令、希望减少英文菜单认知负担的开发者。若你更习惯纯英文界面，或演示时需要原版 UI，使用 off 模式即可。
社区目录（如 SkillHub 插件页）与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；安装与翻译行为以你本地 DSH 配置与官方 API 策略为准。
