dsh-cot-translation-reader
Verifieddsh-cot-translation-reader · v0.1.9 · MIT · Web UI
Show the official COT machine translation inside dsh-better-display's reading view. · 在阅读视图里显示官方「思考过程机器翻译」的译文。
Install
dsh plugin add dsh-cot-translation-reader Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-cot-translation-reader
让 DeepSeek Harness 的阅读页显示思考过程的机器翻译。
在 dsh-better-display 的「阅读」页签里,自动显示官方 COT 机器翻译的译文,并可按卡片在原文与译文之间切换。
为什么需要它
官方 COT 翻译组合包把译文注册在 conversation.chat.reasoning.body 插槽上,而阅读页用自己的组件渲染思考内容——那个插槽在阅读页里永远不会渲染。于是会出现一种错觉:明明装了翻译包,阅读页却还是原文。
本插件补上这段适配:注册到阅读页的 dsh-better-display.text-transform 缝,把宿主翻译服务的译文交给阅读页绘制。
特性
| 能力 | 说明 | |
|---|---|---|
| 🌏 | 自动翻译 | 思考内容出现即请求译文,无需点击;目标语言优先跟随官方设置,auto 时读取界面语言,不会把 Accept-Language: * 当成目标语言 |
| 🔀 | 单卡片切换 | 每张思考卡片可独立切换「查看原文 / 查看译文」,只影响所点击的卡片;相同文本也按块标识区分 |
| 👁 | 只改显示 | 会话记录、折叠、复制回答拿到的仍是原文,插件不写回会话 |
| ✍️ | 流式友好 | 生成中的最后一段保持原文,只翻译已经完成的段落 |
| ♻️ | 失败降级 | 翻译失败保留原文,自动重试最多 3 次,不打断阅读 |
| 🚦 | 串行与限流 | 逐段串行请求,单次长度遵守宿主返回的 maxTextChars,已缓存片段不重复请求 |
| 🛡 | 缓存有界 | 最多保留 512 条卡片缓存;满额只回收闲置五分钟以上的条目,必要时保留原文而不是制造请求风暴 |
| 🧹 | 卸载干净 | 关闭或卸载时中止进行中的请求并清理重试定时器 |
安装
前置条件
| 组件 | 版本 | 作用 |
|---|---|---|
| dsh-better-display | ≥ 0.3.9(单卡片按钮需 ≥ 0.3.12) | 提供 dsh-better-display.text-transform 缝与思考块标识 |
| @deepseek-ai/dsh-experimental-cot-translation-bundle | 最新 | 提供宿主翻译服务与翻译设置(服务商、目标语言) |
两者缺任意一个时,本插件安静地不生效:不报错,也不改界面。
通过插件市场
在 DSH 插件面板里搜索 dsh-cot-translation-reader 安装,然后完全重启 DSH。
通过 npm
pnpm add dsh-cot-translation-reader
从 GitHub 安装(跟踪 main,不必等发版)
pnpm add github:LingMoe404/dsh-cot-translation-reader
安装后
- 完全退出 DSH Desktop(托盘退出),或重启一次 Web Host。
- 确认 profile 的
package.json中已登记 bundle(插件管理器会自动写入):
{
"dsh": {
"profile": {
"bundles": ["dsh-cot-translation-reader"]
}
}
}
使用
- 自动翻译:打开「阅读」页签即可,思考卡片会逐步从原文切换为译文。
- 查看原文 / 查看译文:阅读页每张思考卡片右上角有按钮,只切换当前卡片。需要 better-display ≥ 0.3.12。
- 目标语言:在官方翻译组合包的设置里选择;设为
auto时跟随界面语言。
兼容矩阵
| better-display | 自动翻译 | 单卡片按钮 |
|---|---|---|
0.3.9 – 0.3.11 |
✅ | ❌(缺少 data-reader-reasoning-block-key) |
≥ 0.3.12 |
✅ | ✅ |
没有块标识时插件不会按文本或卡片顺序猜测归属,只显示自动翻译。
工作原理
┌──────────────────────────── DeepSeek Harness Host ────────────────────────────┐
│ translator / cotTranslation(官方 COT 组合包提供,设置也在这里) │
└───────────────────────────────▲──────────────────────────────────────────────┘
│ POST /cot-translation-reader/translate
┌───────────────────────────────┴──────────────────────────────────────────────┐
│ 浏览器端:注册 dsh-better-display.text-transform 的 reasoning 转换器 │
│ 阅读页 read() → 译文;原文模式 → 当前源文本;通知 → 卡片重绘 │
└──────────────────────────────────────────────────────────────────────────────┘
翻译只发生在展示层,不触碰会话记录、转录与折叠输入。
开发与验证
npm ci
npm run typecheck # 类型检查
npm test # 78 项单元/集成测试(1 项真实网络测试默认跳过)
npm run build # 构建 + 产物加载检查 + 40–600 张卡片稳定性检查
| 命令 | 检查内容 |
|---|---|
npm run check:runtime |
导入构建后的 Host 入口、在隔离 VM 执行浏览器工厂,不挂载插件 |
npm run check:stability |
用合成数据跑 40 / 41 / 45 / 100 / 512 / 600 张卡片,验证不循环重译 |
npm test |
语言协商、缓存、按钮隔离、构建产物等回归 |
tools/client-build.js 是从 DeepSeek Harness 公共构建产物复刻的客户端打包配方(见文件头注释),因此构建不需要完整 Harness 源码树。
发布
推送 v* tag 即发布。.github/workflows/publish.yml 使用 npm Trusted Publishing(OIDC) 换取短期凭据,仓库与本机都不保存 npm token,也不需要动态码;发布前会校验 tag 与版本一致,并重新构建、检查产物。
git tag -a v0.1.8 -m "v0.1.8"
git push origin v0.1.8
常见问题
阅读页没有译文? 确认官方 COT 翻译组合包已启用、目标语言设置正确,并且 better-display 至少为 0.3.9。宿主未提供翻译服务时,插件不会显示任何内容,也不会报错。
有译文但没有「查看原文」按钮? 按钮需要 better-display ≥ 0.3.12 提供的思考块标识。升级阅读页插件并完全重启 DSH。
插件市场更新报 duplicate exact route?
升级到本插件 0.1.8 及以上:重复激活现在是安全无操作,不再因重复路由导致启动失败。
相关项目
- dsh-better-display:提供阅读页与
text-transform扩展点 - @deepseek-ai/dsh-experimental-cot-translation-bundle:官方思考翻译组合包
作者
许可
MIT © 泠萌404