前言¶
DeepSeek Harness 里若同时启用官方「思考过程机器翻译」组合包和 dsh-better-display 的阅读页,常见现象是:主对话区能看到译文,切到「阅读」页签后思考块仍是原文。原因不在翻译服务本身,而是官方组合包把译文挂在 conversation.chat.reasoning.body 插槽上,而阅读页用自有组件渲染思考,该插槽在阅读视图里不会被绘制。下面介绍社区插件 dsh-cot-translation-reader(维护者 LingMoe404),它把同一套官方翻译接到阅读页的 dsh-better-display.text-transform 缝上,属于 DSH 生态里的「联网工具」类插件。
这是什么¶
dsh-cot-translation-reader 当前 npm 版本为 0.1.7(MIT 许可)。一句话:在 dsh-better-display 的「阅读」页签里显示 DeepSeek Harness 官方「思考过程机器翻译」的译文。它不实现新的翻译后端,而是复用 @deepseek-ai/dsh-experimental-cot-translation-bundle 提供的 cotTranslation 服务与面板里的翻译设置(翻译服务、目标语言)。
依赖与生效条件¶
两个依赖缺任意一个时,插件安静地不生效:不报错、不改界面。
| 组件 | 作用 |
|---|---|
dsh-better-display ≥ 0.3.9 |
提供 dsh-better-display.text-transform 缝 |
@deepseek-ai/dsh-experimental-cot-translation-bundle |
提供 cotTranslation 服务与翻译设置 |
翻译服务与目标语言仍在官方组合包的插件面板里配置;本插件只负责阅读页展示适配。
核心功能¶
自动翻译与语言选择¶
进入阅读页后会自动请求译文,无需额外点击。目标语言优先使用官方面板里手动指定的值;设为 auto 时读取当前界面语言,再回退到文档或浏览器语言,不会把请求头里的 * 当作目标语言。
单卡片「查看原文 / 查看译文」¶
在 better-display 为思考文本节点提供稳定块标识 data-reader-reasoning-block-key 时,每张思考卡片右上角会出现 查看原文 / 查看译文 按钮,只切换所点击的卡片,不影响其他卡片;相同文本也按独立标识区分,缓存仍在时不会重新请求。配套改动见 dsh-better-display PR #82。该补丁尚未合并发布,npm 上的 better-display 0.3.9 不包含此标识:仍可自动翻译,但不会显示单卡片按钮,也不会通过文本或顺序猜测对应卡片。
只改显示、流式与失败行为¶
会话记录、折叠、复制回答拿到的都是原文。流式生成中的最后一段保持原文,只翻译已经完成的段落。翻译失败时保留原文、自动重试最多 3 次,并在控制台 warn,不会打断阅读。
请求与缓存¶
译文按段落串行请求,避免触发提供商限流;单次长度遵守 Host 返回的 maxTextChars。已缓存的片段不会重复请求。缓存最多保留 512 条卡片;满额时只回收至少五分钟未读取的条目。没有可回收条目时,新卡片继续显示原文且不发送额外翻译请求;闲置缓存被回收后,再次阅读可能重新请求。
生命周期¶
按钮只在启动时扫描一次文档,之后按相关 DOM 变化增量维护,不在每次流式更新时重扫整页。关闭插件或卸载时中止进行中的请求并清理重试定时器。
安装与启用¶
在 profile 所在目录用包管理器安装(命令来自仓库 README):
# npm(推荐)
pnpm add dsh-cot-translation-reader
# 从 GitHub 安装(跟踪 main,不用等发布)
pnpm add github:LingMoe404/dsh-cot-translation-reader
# 本地目录
pnpm add file:../dsh-cot-translation-reader
装完后重启 DSH(Desktop 从托盘完全退出;Web Host 重开一次),确认 dsh-cot-translation-reader 已出现在 profile package.json 的 dsh.profile.bundles 中(插件管理器安装时会自动写入)。
典型用法无需单独配置文件:先安装并启用 dsh-better-display 与 @deepseek-ai/dsh-experimental-cot-translation-bundle,在官方组合包面板里选好翻译服务与目标语言,再安装本插件并重启;打开 better-display 的阅读页签即可看到与主对话区一致的官方 COT 译文行为。
适用场景与注意¶
适合已经在用官方思考翻译、又经常在 dsh-better-display 阅读页里读长思考链的用户。插件以当前 DSH 进程的权限运行,安装前应自行查看 GitHub 源码 与 MIT 许可证;社区目录 skillhub.cn 插件页 与 DeepSeek / 幻方无官方从属关系,并非官方应用商店。
若只需要主对话区的 COT 翻译,不必安装本插件;若阅读页从未打开,也感受不到差异。单卡片切换按钮依赖 better-display 尚未随 0.3.9 发布的 PR,需要该能力时可关注 PR 合并后再升级 better-display。
相关链接¶
- 社区目录:https://www.skillhub.cn/plugins/LingMoe404/dsh-cot-translation-reader
- 仓库:https://github.com/LingMoe404/dsh-cot-translation-reader
经过上面的步骤,阅读页与官方 COT 翻译组合包可以对齐:同一套设置、同一套译文逻辑,只是渲染路径从对话插槽改接到阅读页的 text-transform 缝。