前言¶
在 DeepSeek Harness（DSH）里做翻译，常见做法是开一个新对话、手写「请把下面内容译成某语言」的提示，再粘贴原文。模型和推理强度往往要临时选一遍，长文还要反复滚动消息区。若希望翻译界面固定、参数可复用，又仍走 Harness 已配置的模型目录与 API Key，就需要一个挂在客户端 UI 上的专用入口。
下面介绍社区插件 dsh-translate-tab（维护者 Zhen-Bo，分类：客户端）。它在侧边栏 Plugins 下增加 Translate，主区域切换为左右双栏：左侧输入原文，右侧流式显示译文，并可选择模型、调节 reasoning effort、自定义翻译提示词。
这是什么¶
dsh-translate-tab 是面向 DeepSeek Harness 的翻译插件。README 将其描述为：在侧边栏 Plugins 下提供 Translate 入口，主区域变为带模型、effort 与 prompt 控件的双栏翻译器。
- 仓库：https://github.com/Zhen-Bo/dsh-translate-tab
- 社区目录页：https://www.skillhub.cn/plugins/Zhen-Bo/dsh-translate-tab
- 许可证：MIT（README 与 package.json 一致）
- npm 包名：
dsh-translate-tab（package.json 版本为 1.0.0）
插件与 Harness 聊天共用同一套 provider 与模型目录；默认使用目录中的默认模型，且 reasoning effort 关闭，以降低首译延迟。
核心功能¶
界面与集成¶
- 侧边栏 Plugins › Translate 打开双栏翻译视图。
- 界面语言随 Harness 语言设置，支持 English、简体中文、繁体中文。
语言¶
支持 15 种语言作为源或目标：繁体中文、简体中文、English、Japanese、Korean、French、German、Spanish、Portuguese、Italian、Russian、Vietnamese、Thai、Indonesian、Arabic。
源语言可自动检测；检测范围包括 Japanese、Korean、Arabic、Thai、Russian、简体中文、繁体中文与 English。
模型与推理¶
- 右上角模型选择器与 Harness 聊天共用模型目录。
- 模型列表下方滑块调节 reasoning effort。
可配置提示词¶
模型选择器旁按钮打开提示词编辑器。提示词作为 user message 发送，支持变量替换：
| 变量 | 含义 |
|---|---|
{{target_language}} |
目标语言英文名，例如 Japanese |
{{source_language}} |
源语言名，或 the detected source language |
{{text}} |
原文；若提示词未包含该变量，会在末尾追加 |
本地存储¶
| 数据 | 位置 | 生命周期 |
|---|---|---|
| 语言、模型、reasoning effort、自定义 prompt | localStorage 键 dsh-translate-tab:v1 |
持久 |
| 原文草稿 | sessionStorage 键 dsh-translate-tab:draft |
当前窗口会话 |
服务端接口（架构说明）¶
宿主侧提供 POST /translate/api/stream，对 Harness 窗口同源请求返回换行分隔的 JSON 流，例如译文片段 {"t":"text","v":"..."}、结束 {"t":"done"} 等。客户端在 src/client（React + TypeScript），服务端在 src/server。
环境与前置条件¶
- 已安装 DeepSeek Harness 桌面版，且
dshCLI 在PATH中。 - 在 Settings › Models 中至少配置一个带有效 API Key 的模型。
安装与启用¶
任选一种安装方式，完成后均需重启 DeepSeek Harness。
通过 DSH Plugin Hub¶
- 安装 Plugin Hub：
dsh plugin --profile desktop add dsh-plugin
- 重启 DeepSeek Harness。
- 打开 Settings › Plugin Market，搜索
dsh-translate-tab并选择 Install。
通过 npm¶
dsh plugin --profile desktop add dsh-translate-tab
重启 DeepSeek Harness。
通过 GitHub¶
dsh plugin --profile desktop add "github:Zhen-Bo/dsh-translate-tab"
重启 DeepSeek Harness。
典型用法¶
- 在侧边栏打开 Plugins › Translate。
- 在左侧输入原文。
- 按 Ctrl+Enter（macOS 为 ⌘+Enter），译文在右侧流式输出。
需要换模型或加强推理时，在页面右上角调整模型与 reasoning effort；要改翻译风格时，编辑带 {{target_language}}、{{source_language}}、{{text}} 的提示词即可。
故障排查（README 摘要）¶
| 提示 | 处理 |
|---|---|
| This model has no API key yet | 在 Settings › Models 添加 Key，或换模型 |
| The API key was rejected | 在 Settings › Models 核对 Key |
| Too many requests | 稍等后重试 |
| The response stopped early | 重新执行翻译 |
| Text is too long | 将原文分段，每段少于 100,000 字符 |
若侧边栏 Plugins 下没有 Translate，检查安装是否成功并重启 Harness。
卸载：
dsh plugin --profile desktop remove dsh-translate-tab
卸载后同样需要重启 DeepSeek Harness。
适用场景与注意¶
适合谁： 已在 DSH 桌面版配置好多模型、希望在固定 UI 里做中英日韩等 15 语互译、并需要流式输出与可保存 prompt 的用户。
权限与安全： 插件在 DeepSeek Harness 当前进程权限下运行，翻译请求经插件服务端路由到所选模型。安装前建议阅读仓库源码与 MIT 许可证，确认行为符合你的环境策略。社区目录（如 skillhub.cn、dsh-plugin.org 列表）为独立生态站点，与 DeepSeek / 幻方无官方从属关系，不宜等同于官方应用商店。
限制： 单次原文长度上限为 100,000 字符（见 Troubleshooting）；未配置 API Key 的模型无法使用。
结尾¶
dsh-translate-tab 把翻译从「临时对话」收拢为侧边栏双栏页：共用 Harness 模型目录、支持 15 语与源语检测、可调 reasoning effort 与提示词模板，适合日常在桌面 Harness 内做对照翻译。
