前言¶
做 DSH 智能体时，Web UI 里会直接看到模型的可见 reasoning 和 final answer。如果希望把阅读显示切换为另一种语言，但不想改动原始 session logs，就需要一个只作用在显示层的翻译插件。dsh-reasoning-translator 是 pinkllo 提供的 DeepSeek Harness 插件，定位为“仅在 Web UI 中将可见推理和最终答案做显示层翻译”，支持 Chrome Translator 或 OpenAI-compatible API。
这是什么¶
一句话：它不改写 session logs，只翻译 Web UI 中可见的 reasoning 和 final answer。维护者为 pinkllo，许可证是 MIT。
它解决的是 Web UI 显示语言问题：原文日志仍按原样保留，只在页面上提供翻译显示。DSH 的插件生态强调“一切皆插件”，社区目录页可用来查找插件，但它不是官方应用商店，也不代表 DeepSeek 或幻方的官方背书。
核心功能¶
下面介绍它已核实的能力。
- 仅翻译 Web UI 中可见的
reasoning和final answer，不重写 session logs。 - 支持 Chrome Translator / LanguageDetector 后端。要求桌面 Chrome 138+ 或较新 Edge；免费、本地设备运行、无需 API key。首次使用某个语言对时，可能下载 pack 并需要点击。
- 支持 OpenAI-compatible API 后端。由 Host 进程调用 Settings 中配置的 endpoint；API key 可来自
TRANSLATION_OPENAI_API_KEY或OPENAI_API_KEY。 - 翻译前检测源语言，并跳过已经是目标语言的文本。
- 可翻译
reasoning、final answer或两者；可自动运行，也可按块点击Translate按钮触发。 - 偏好从
localStorage恢复，并同步到 Hostsettings.yaml的translation部分；两份副本不一致时，最近编辑的一份优先。API key 不缓存在localStorage。 - Web settings RPC 不暴露 out-of-tree namespaces，插件使用自己的 same-origin route。
安装与启用¶
先安装插件。若从 GitHub 源码安装，运行：
dsh plugin --profile web add github:pinkllo/dsh-reasoning-translator
如果本地已有仓库目录，也可以使用：
dsh plugin --profile web add /absolute/path/to/dsh-reasoning-translator
然后启动 Web UI：
dsh web
如果你是从 deepseek-harness 的 checkout 里启动，也可以用：
pnpm dsh web
启动后打开 Settings → Translation，进入翻译设置。
典型用法¶
一个可直接复现的流程是先安装，再启动，再进入设置：
- 执行 GitHub 安装命令：
dsh plugin --profile web add github:pinkllo/dsh-reasoning-translator
- 启动 Web UI：
dsh web
- 打开
Settings → Translation。 - 如果使用 Chrome 内置后端，确认使用桌面 Chrome 138+ 或较新 Edge；首次使用某个语言对时，可能需要下载 pack 并完成一次点击。
- 如果使用 OpenAI-compatible API 后端，在 Settings 中配置 endpoint、model、API key；API key 也可以通过
TRANSLATION_OPENAI_API_KEY或OPENAI_API_KEY提供。
关于 npm 安装命令，README 中写的是 once published，当前已核实资料没有确认 npm 包已发布，因此不建议把它当作默认安装路径。
适用场景与注意¶
适合需要在 Web UI 中查看目标语言翻译、但又想保留原始 session logs 的使用者。它也比较适合不想直接在浏览器端处理翻译请求的情况：Chrome 内置后端在本地设备运行；OpenAI-compatible API 后端则由 Host 进程调用 Settings 中配置的 endpoint。
使用前注意：
- 它只作用于 Web UI，不会重写 session logs。
- Chrome built-in 后端需要桌面 Chrome 138+ 或 recent Edge。Cursor 的内嵌浏览器可能缺少 Chrome on-device Translator；如果在该环境里检测不到相关能力，需要到桌面 Chrome 中复测。
- 插件会由当前
dsh进程加载并运行。安装前应检查源码、依赖和许可证；本插件许可证为 MIT。 - 如果要运行 README 中的纯函数单元测试，需要 Node 22.6+。
结尾¶
dsh-reasoning-translator 的价值比较明确：把“显示层翻译”限定在 Web UI 的可见 reasoning 和 final answer 上，不碰 session logs，并提供 Chrome Translator 与 OpenAI-compatible API 两种后端。
相关链接：
- GitHub：https://github.com/pinkllo/dsh-reasoning-translator
- 目录页：https://www.skillhub.cn/plugins/pinkllo/dsh-reasoning-translator
