前言¶

dsh-zh 面向 DSH Web 界面。它要解决的是显示层问题：把界面中残留的英文 UI 文本换成中文，同时不改值、属性、事件和会话内容；此外，它还会检测官方是否已经自己适配，避免插件和官方文案重复。

这是什么¶

dsh-zh 是一个 DSH client 插件，仓库地址为 https://github.com/HarryLi-7/dsh-zh。它只做显示层汉化和官方适配检测，不改动 DSH 的功能逻辑。

核心功能¶

界面汉化（显示层）¶

插件只替换整文本节点的显示内容。已核实范围包括：

• 命令面板命令描述汉化。
• 权限预设显示汉化：Read Only、Workspace Write、Full access。
• 推理等级菜单内短通用词汉化：Off、High、Max、Default。
• Full access 的文字与图标使用橙红强调色 #ff5722。

以下内容和取值保持原样：

• 命令名不翻译。
• 权限预设机器值、推理等级 id、命令名保持原样。
• 会话内容、用户消息、助手回复、工具结果、代码块、输入框不被替换。

短通用词只在菜单类表面内替换，涉及 role="menu"、role="listbox"、aria-haspopup="menu"。这样可以避免误伤正文输入和会话内容。

官方适配检测¶

插件会静默探测官方宿主数据，使用 3 条只读 RPC。发现官方已适配时，会显示一次性提示条。探测失败不记录，下次加载重试。

存储与开关¶

存储上，插件仅使用 localStorage 两个固定键，不使用 ctx.logger。

功能开关为：

设置 → 通用设置 → 「界面汉化（中文）」

开启后开始汉化；关闭后立即停止汉化，并还原原文。

安装与启用¶

先安装插件：

dsh plugin --profile web add ~/.dsh/profiles/packages/dsh-zh

新增插件需要重启 harness 才载入；client 端改动刷新页面即可。安装并重启后，进入 DSH Web 的设置面板，通过「设置 → 通用设置 → 「界面汉化（中文）」」开启或关闭汉化。

典型用法¶

1、安装：

dsh plugin --profile web add ~/.dsh/profiles/packages/dsh-zh

2、重启 harness，打开 DSH Web。

3、进入「设置 → 通用设置 → 「界面汉化（中文）」」，开启开关。

4、如需还原，关闭同一开关；关闭后立即停止汉化并还原原文。

5、卸载：

dsh plugin --profile web remove dsh-zh

适用场景与注意¶

适合希望 DSH Web 界面显示中文，但不希望改变命令、权限、推理等级原始取值与会话内容的场景。它也适合需要判断官方是否已经自行汉化的维护者。

需要注意：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。dsh-zh 只处理显示层，不修改值、属性、事件和会话内容；功能行为仍以 DSH 自身权限和命令语义为准。

相关资源¶

• GitHub：https://github.com/HarryLi-7/dsh-zh
• 社区目录页：当前资料未提供链接