前言¶
DeepSeek Harness(DSH)的插件页、设置项和各类面板里,不少文案仍是中文。若你更习惯英文界面,逐个插件翻文档或凭记忆对应菜单,成本不低;浏览器自带翻译又容易误伤聊天内容与用户输入。下面介绍社区插件 dsh-all-over-chinese-to-english(维护者 abdelrhmanwaelbishr,分类:客户端),它在 DSH Web 端监听界面文案,经宿主侧批量接口译成英文并原位替换,同时刻意跳过会话区与用户可编辑字段。
这是什么¶
该插件将 DSH 界面中的中文文本译为英文,覆盖插件页与详情、插件设置(含下拉与自定义浮层)、侧栏插件面板、插件 View 与顶栏标签,以及同源 iframe(例如 MCP Connector 的 /mcp-connector/ui/)。安装后以一个可安装 bundle 交付,分为 Host(index.js)与 Client(client.js)两半协同工作。
核心功能¶
Host:批量翻译与缓存¶
Host 注册 POST /api/all-over-chinese-to-english,对短中文串做批量翻译并在内存中缓存结果。翻译优先使用随包挂载的匿名 translator 服务(默认 Bing,Google 作后备),无需账号或 API key;若该服务不可用,则回退到通过 llm 服务配置的默认模型。bundle 会挂载 @deepseek-ai/dsh-experimental-translator,一般不必自行启用 @deepseek-ai/dsh-experimental-cot-translation-bundle。
Client:监听 DOM 并原位替换¶
Client 观察页面中的中文文本节点与可译属性,对变更做防抖后原位替换为英文。MutationObserver 会在 React 重渲染后再次检查,导航与重渲染后已译字符串仍保持英文。
会翻译的表面¶
| 表面 | 示例 |
|---|---|
| 插件页与详情面板 | 插件 README、能力列表 |
| 插件设置 | 标签、提示、下拉(原生 <select> 与自定义 popover) |
| 侧栏插件页 | 回收站、插件列表等面板 |
| 插件 View 与顶栏标签 | 如 dsh-session-superagent 视图及其标签 |
| 同源 iframe 面板 | 整个 MCP Connector 页面 |
| 只读展示属性 | placeholder、title、aria-label、alt、label |
故意不翻译的范围¶
聊天及其他会话内容视图不会被扫描或发送后端翻译,包括聊天流(conversation.chat.flow / conversation.chat.node)、Trajectory 表、Context/Fleet 仪表盘、输入框与草稿等。插件 View 的判定依据是同槽位内不存在上述会话标记。
此外会跳过:script、style、code、pre、svg、canvas、math、video、audio;用户输入区(input、textarea、contenteditable);translate="no" 或 data-atz-ignore 标记节点;超过 400 字符的字符串。选项的 value 与表单字段值保持原样,便于配置仍以中文值保存。
配置¶
在插件行的配置项中调整:
| 键 | 默认值 | 含义 |
|---|---|---|
enabled |
true |
开关自动翻译 |
targetLanguage |
en |
传给翻译服务的目标语言 |
插件总开关在 Plugins 页面;关闭后,下次渲染会恢复原始中文。
运行状态写入 ~/.dsh/all-over-chinese-to-english-status.json(含 translator、llm、connection、enabled 及实时 translatorTest)。客户端活动日志在 ~/.dsh/all-over-chinese-to-english-client.log,仅记录请求次数,不记录译文内容。
安装与启用¶
在已安装 DSH CLI 的环境中执行官方安装命令:
dsh plugin add abdelrhmanwaelbishr/dsh-all-over-chinese-to-english
也可从本地 checkout 将包目录作为 profile bundle 加入;行为与上述方式一致。安装并启用后,Client 会按 dsh.client 配置在 Web 平台立即加载(immediately: true),一般无需额外步骤即可在浏览 DSH 时看到界面英文替换。
典型用法¶
- 安装插件并保持
enabled为true(默认)。 - 打开 DSH Web 端,进入 Plugins、各插件设置页或 MCP Connector 等同源面板,观察中文 UI 文案是否被替换为英文。
- 若需改目标语言,在插件行将
targetLanguage从默认en改为 translator 支持的语言代码(以你环境中的 translator 能力为准)。 - 临时恢复中文:在 Plugins 页关闭本插件开关,或设置
enabled: false。 - 排查翻译链路时,查看
~/.dsh/all-over-chinese-to-english-status.json中的translatorTest与connection字段。
适用场景与注意¶
适合在 DSH 上做插件开发、运维或日常使用时希望统一英文界面、又不愿把聊天内容与用户配置发给翻译后端的用户。它不替代专业本地化方案,而是面向界面短串的即时替换。
插件以当前 dsh 进程权限 运行,会调用翻译与可能的 LLM 回退路径。安装前建议在 GitHub 仓库阅读源码与 MIT 许可证,确认网络出站与日志策略符合你的环境要求。社区目录站点 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系,仅作索引与介绍。
结尾¶
dsh-all-over-chinese-to-english 用 Host 批量译短串、Client 监听 DOM,在尽量不误伤会话与用户输入的前提下,把 DSH 插件相关界面翻成英文。需要进一步了解实现细节或提交 issue,可访问 GitHub 仓库。