双栏翻译 Zhen-Bo/dsh-translate-tab

🌐 dsh-translate-tab

DeepSeek Harness 的翻译插件。

Listed on dsh-plugin.org

安装 · 快速开始 · 用法 · 故障排查

DeepSeek Harness 中的 Translate 页面。左侧是英文原文，自动识别语言后，右侧译成繁体中文。

✨ 功能

- 侧边栏集成： 在 Plugins 下新增 Translate 入口，点开后在主区域显示双栏翻译视图。
- 共用模型目录： 使用与 Harness 聊天相同的服务商和模型，推理强度可调。
- 默认低延迟： 使用目录中的默认模型，关闭推理强度。
- 15 种语言： 支持自动识别源语言。
- 提示词可配置： 支持 {{target_language}}、{{source_language}} 和 {{text}} 变量。
- 界面本地化： 跟随 Harness 的语言设置，支持英文、简体中文和繁体中文。

📋 环境要求

- DeepSeek Harness 桌面应用，且 dsh 命令行在 PATH 中
- 在 Settings › Models 中至少配置一个模型，并填好有效的 API key

📦 安装

从 DSH Plugin Hub 安装

1. 安装 DSH Plugin Hub：

dsh plugin --profile desktop add dsh-plugin

2. 重启 DeepSeek Harness。
3. 打开 Settings › Plugin Market，搜索 dsh-translate-tab，选择 Install。

从 npm 安装

1. 从 npm registry 安装插件：

dsh plugin --profile desktop add dsh-translate-tab

2. 重启 DeepSeek Harness。

从 GitHub 安装

1. 从仓库安装插件：

dsh plugin --profile desktop add "github:Zhen-Bo/dsh-translate-tab"

2. 重启 DeepSeek Harness。

🚀 快速开始

1. 在侧边栏打开 Plugins › Translate。
2. 在左侧栏输入原文。
3. 按 Ctrl + Enter，macOS 上按 ⌘ + Enter。

译文会流式输出到右侧栏。

🧭 用法

语言

繁体中文、简体中文、英文、日文、韩文、法文、德文、西班牙文、葡萄牙文、意大利文、俄文、越南文、泰文、印尼文和阿拉伯文，每种语言都可作为源语言或目标语言。
自动检测作用于原文，可识别日语、韩语、阿拉伯语、泰语、俄语、简体中文、繁体中文和英语。

模型与推理强度

模型选择器在右上角。推理强度用模型列表下方的滑块设置。

翻译提示词

提示词编辑器从模型选择器旁边的按钮打开。提示词作为用户消息发送，其中的变量会按下表替换：

| 变量 | 值 |
| {{target_language}} | 目标语言名称，用英文，例如 Japanese |
| {{source_language}} | 源语言名称，或 the detected source language |
| {{text}} | 原文。提示词里没写这个变量时，追加到末尾 |

存储

| 数据 | 位置 | 生命周期 |
| 语言、模型、推理强度和自定义提示词 | localStorage 键 dsh-translate-tab:v1 | 持久保存 |
| 原文草稿 | sessionStorage 键 dsh-translate-tab:draft | 当前窗口会话 |

🔧 故障排查

| 提示信息 | 解决办法 |
| This model has no API key yet | 在 Settings › Models 里添加密钥，或换一个模型 |
| The API key was rejected | 在 Settings › Models 里核对密钥 |
| Too many requests | 稍等片刻再重试 |
| The response stopped early | 重新运行翻译 |
| Text is too long | 把原文拆成每段不超过 100,000 个字符 |

如果 Plugins 下找不到 Translate，检查安装路径，然后重启 DeepSeek Harness。

🧹 卸载

dsh plugin --profile desktop remove dsh-translate-tab

之后重启 DeepSeek Harness。

🧩 架构

| 路径 | 运行环境 | 作用 |
| src/client | Harness 窗口 | 用 React 和 TypeScript 写的翻译页面 |
| src/server | Harness 主机 | POST /translate/api/stream，流式返回单次模型调用 |
| src/shared | 两者 | 路由、文本长度限制和流事件类型 |
| locale | Harness 窗口 | 界面文案，注册到 Harness 语言服务 |
| lib | 两者 | 构建产物，由 Harness 加载 |

流格式

该路由接受来自 Harness 窗口的同源请求，返回按行分隔的 JSON：

{"t":"text","v":"..."} translated text
{"t":"done"} finished
{"t":"aborted"} cancelled
{"t":"error","message":"..."} failed

💻 开发

1. 安装依赖，把工作副本链接到桌面配置档：

npm install
dsh plugin --profile desktop add "link:D:/path/to/dsh-translate-tab"

2. 以监听模式运行构建，然后重启 DeepSeek Harness 加载改动：

npm run dev

| 命令 | 用途 |
| npm run build | 构建 lib/client.js 和 lib/index.js |
| npm run check | 运行类型检查、lint、测试和构建 |
| npm run fix | 用 gts 格式化代码 |

📄 许可证

基于 MIT License 授权。