为 DeepSeek Harness 提供显示层翻译。
读懂思考，跟上任务，也看清回答。原文完整保留，译文不进入模型上下文。
中文 · English · 日本語 · 한국어 · Español · Français · Deutsch · Русский · Português
· 
· 
· 
· 
---
## 看见思考发生
|
|
|
演示一 · 思考链与回答翻译
|
演示二 · 更多实际操作
|
## 与官方翻译插件对比
本插件与官方思考翻译都接管思考界面，请二选一启用。检测到官方插件启用时，本插件暂停翻译并显示冲突提示；关闭官方插件后自动恢复，不会修改官方插件的启用状态。
## 一条命令，开始使用
```bash
dsh plugin --profile web add dsh-think-translate
```
安装后**完整重启 DSH Web**，打开 **设置 → 思考链翻译**，选择目标语言和翻译提供方即可。 开启 **在侧边栏显示翻译入口**，即可把翻译设置固定到左侧全局面板列表。独立页面按翻译偏好、翻译服务和运行状态分成卡片，小窗口自动使用单栏布局；设置弹窗使用紧凑的单栏分区，控件样式与独立页面一致。选择保存在当前浏览器中，刷新页面或重启 DSH 后仍会保留；在设置窗口或翻译页面关闭此开关即可取消固定。
从 GitHub 安装、升级与其他安装方式
从 GitHub 安装：
```bash
dsh plugin --profile web add github:UncleK/dsh-think-translate
```
升级 npm 版本：
```bash
dsh plugin --profile web add dsh-think-translate@latest
```
安装或升级后均需完整重启 DSH。手动部署可通过目录联接把包链接到 profile，并在 `cordis.patch.yml` 中插入 `dsh-think-translate` 插件行；普通使用建议选择上面的安装命令。
## 需要读懂的，不只是思考链
思考链，边想边读
按段落与句子分批翻译。可选全部预翻译、懒加载历史，或仅在展开后翻译。
|
任务与回答，一起跟上
覆盖任务卡片和输入区任务列表；回答正文提供独立翻译开关。
|
审查理由，也能看清
自动审查拒绝一次调用时，保留原文并追加目标语言的理由，原有操作按钮照常使用。
|
原文与代码，完整保留
代码、路径和命令在翻译前受到保护。译文只用于显示，不进入模型上下文。
|
本地模型，用时再加载
复用已有 Ollama 和模型，支持手动释放、禁用后释放与空闲自动释放。
|
提供方，按你的顺序工作
拖动排序并逐行启停。失败时尝试下一家，明显串语言的结果也会触发回退。
|
### 连接你已经在用的提供方
**Ollama · Google · Bing · OpenAI 兼容端点 · Anthropic Messages API**
也可以发现 DSH 已配置的提供方，无需重复填写端点和密钥。每一行都能单独测试，列表顺序就是尝试顺序。
```text
你的首选提供方 → 下一家已启用提供方 → … → 全部失败时保留原文
```
自定义端点、密钥与自动恢复
- 自定义端点支持 OpenAI 兼容的 `/v1/chat/completions` 和原生 Anthropic Messages API。
- 自动发现当前 DSH profile 及覆盖配置中的提供方；可重新扫描并加入翻译链。
- 声明 `apiKeyEnv` 的提供方在请求时解析密钥，解析结果不会写回插件配置。
- 手动输入的密钥通过 DSH 凭据服务保存，插件配置只保存引用；服务可用时自动迁移旧配置中的明文密钥。凭据服务不可用时拒绝保存新的明文密钥，迁移失败保留旧配置。
- 配置接口不返回密钥值。编辑时留空保留旧密钥，勾选“移除已保存的密钥”才会删除；DSH 凭据文件由宿主保护，不代表系统钥匙串加密。
- 成功译文缓存在当前浏览器，按提供方、模型和翻译配置区分；变更配置后不复用旧译文，已开始的旧请求也不会回写到新缓存。缓存版本升级会清理旧译文，但保留语言等首选项。
- 失败结果在 Host 内存冷却 30 秒，之后翻译会恢复重试。
- 已经是目标语言的正文会按语言检测规则跳过；提供方测试仍会真实发起请求。
### 术语表：让译法保持一致
“启用内置词表”和“启用自定义词条”分别放在对应区域，独立勾选、立即保存。内置词表默认关闭，含 60 条常用英文 AI、编程术语和产品名，九种目标语言各有对应译法；可展开查看完整列表。关闭其中一个不会影响另一个，也不会删除已填词条。
在“自定义补充”中添加自己的词条即可，无需复制内置内容。已启用的自定义同名词条（不区分大小写）优先覆盖内置译法；每种语言额外 128 条自定义额度不被内置词条占用。输入改动后会显示“未保存”提示并突出保存按钮；切换目标语言保留各语言草稿，并提醒其他语言的未保存项。正在编辑时刷新或离开网页会触发浏览器的未保存确认。
宽屏页面的术语表横跨整行，内置预览与自定义编辑左右排列，运行状态横向展示；窄窗口和设置弹窗使用单列。
在设置或侧边栏翻译页面编辑当前目标语言的术语表，每行填写“原词 => 译词”，点击“保存术语表”生效。两边写相同内容，可以固定保留产品名。
```text
DeepSeek => DeepSeek
agent => 智能体
reasoning => 思考过程
```
每种目标语言独立保存，最多 128 条；英文按完整词匹配且不区分大小写，长词优先。保存会让旧译文缓存失效，关闭术语表会保留已填写的词条。术语只作用于实际翻译的正文，不改写原文、代码、路径或命令。
### 本地翻译模型，按需加载与释放
| 你的操作 | 插件行为 |
|---|---|
| 实际翻译或点击测试 | 按需启动服务、加载所选模型 |
| 点击“释放模型内存” | 当前翻译结束后释放；保留模型文件、开关和排序 |
| 取消勾选本地提供方 | 停用并释放所选模型 |
| 重新勾选或打开设置 | 不预加载；下一次实际翻译时再加载 |
| 设置空闲释放 | 默认 5 分钟，可选 1 / 5 / 10 / 30 / 60 分钟或关闭 |
空闲策略从下次使用起生效，由 Ollama 对当前模型计时，不修改全局环境变量。缺少软件或模型时，只有点击准备按钮后才安装或下载，并显示进度。
### 让语言设置跟着你
中文 · English · 日本語 · 한국어 · Español · Français · Deutsch · Русский · Português
9 种目标语言、设置面板和任务文案保持一致，现已包含葡萄牙语，选择会在刷新后保留。
## 遇到问题，先看这里
安装或升级后，看不到翻译入口
完整重启 `dsh web`。客户端模块图在进程启动时组合，仅刷新页面有时不足以加载新插件。设置页底部会显示实际安装包的版本号。
本地模型列表为空
检查 `ollama list` 或 `/api/tags`，确认运行中的服务使用了正确的模型目录；同时检查该服务生效的 `OLLAMA_MODELS`。不需要重新下载已经存在于其他模型目录中的文件。
升级 DSH 后，源码启动报 client bundles not found
在 DeepSeek Harness 仓库根目录先运行 `pnpm run build`，完成后重新启动 DSH Web。
翻译失败会影响正常对话吗
所有已启用提供方都失败时保留原文，插件不会用失败结果覆盖会话原文。可以在设置中逐行测试提供方，并查看最近错误；冷却后翻译会自动恢复重试。
最近更新与兼容性
**1.2.20** 增加 60 条常用技术术语的九语言内置词表，内置和自定义独立勾选；自定义词条优先、额度独立。新增未保存提醒，并改进宽屏布局。
**1.2.19** 增加按目标语言保存的术语表、DSH 凭据保护、配置感知缓存、官方插件互斥提示、技术文本保护与 Windows/Linux CI。
**1.2.18** 新增常驻侧边栏翻译入口（可在设置窗口或翻译页面开启，按浏览器保存），并将翻译页面与设置弹窗重构为卡片式分区，窄窗口自动切换为响应式单栏布局。
**1.2.17** 修复已加载 Ollama 模型保存空闲时长后不生效的问题，本地推理等待延长至 120 秒，并显示服务端剩余空闲时间。修复 issue #17 中已复现的部分，长期内存增长仍在调查。
**1.2.16** 补齐葡萄牙语翻译目标与界面，同步 9 种语言的 README、横幅和对比图，并声明市场三张展示图。
**1.2.15** 增加本地模型内存管理，适配 DSH `0.2.2-alpha.2` 的官方图片渲染、整轮思考折叠和正文原文选择。
**1.2.14** 拒绝明显错误语言的译文并尝试下一提供方，清理旧译文缓存并保留设置。
**1.2.13** 支持自动审查拒绝理由翻译。感谢 [llg1634](https://github.com/llg1634) 提供问题报告、初始补丁和测试。
更早版本与具体变更见 [GitHub Releases](https://github.com/UncleK/dsh-think-translate/releases)。
开发与工作原理
```text
浏览器 → 同源翻译接口 → 已启用的提供方链 → 译文或原文
```
- `lib/index.js`：Host 路由、提供方适配、配置、内存缓存与本地模型管理。
- `lib/client.js`：设置、显示层翻译、流式分批和浏览器缓存。
- `lib/config.json`：运行期配置，已从 Git 和 npm 包排除。
- 无需额外构建，源码即产物；修改 Host 后重启 DSH。
- 检查命令：`npm test`。
- CI 在 push / PR 时执行 `npm ci --ignore-scripts` 和 `npm test`，覆盖 Windows、Linux 与 Node 20/22/24/26；Node 20 用于验证当前声明的最低兼容版本。成为合并必需检查需要仓库另行配置。
- 代码保护覆盖 Markdown 代码、明确可识别的路径、URL、文件名和常见命令片段；有空格的路径请加引号，复杂命令和有歧义的技术内容请使用反引号或代码块。
配置发现、凭据处理和维护说明见 [维护笔记](https://github.com/UncleK/dsh-think-translate/blob/main/docs/maintenance-notes.md)。
---
dsh-think-translate
反馈问题 · 版本发布 · MIT License