dsh-bilingual-reader：DeepSeek Harness 侧栏的 PDF 划词翻译插件

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。dsh-better-sidebar 作为侧栏扩展机制，允许开发者注入自定义功能。在阅读论文 PDF 时，如果将选中的术语直接复制到主对话去翻译，会污染上下文，且频繁切换窗口效率较低。dsh-bilingual-reader 解决了这个问题，它是在 dsh-better-sidebar 中直接对 PDF 进行原生渲染，并利用大模型进行划词翻译的插件。

插件定位¶

这是一个运行在 DeepSeek Harness 环境下的侧栏插件，由开发者 Johnblur 维护。它主要解决在阅读长篇论文时，需要快速、精准地获取特定段落或术语翻译，同时保持主对话上下文干净的需求。插件复用 DSH 现有的模型配置，翻译过程完全隔离于主对话之外。

核心功能¶

PDF 原生渲染：利用浏览器或 Electron 的 PDF 引擎显示文档，保持排版完美，支持翻页与文本选择。
划词翻译：选中文字并复制，桌面版可自动触发翻译；若自动翻译不可用，可通过点击「翻译」按钮或按 Ctrl+V 触发。
多语种互译：支持中文、英语、日语、韩语之间的互译，也支持手动添加任意语言。
语种自动识别：源语言选择「自动识别」时，优先使用字符集启发式判断（对中、日、韩语识别准确率高），不确定时再交由大模型识别。
上下文感知：在全文中定位选中内容的唯一位置，提取周边文字作为上下文进行翻译，确保翻译准确。
上下文长度可调：通过滑块控制提取上下文的长度。
设置持久化：源语言、目标语言、上下文长度及自定义语言设置会被保存，下次打开自动加载。
原文 + 译文对照：界面下方同时展示原文与译文，支持一键复制译文。
隔离主对话：翻译调用通过独立的 ctx.llm 进行，结果不写回主会话，不消耗主对话 Token。

安装与启用¶

安装该插件需要 DSH 环境已就绪。执行以下命令即可安装：

dsh plugin add github:Johnblur/dsh-bilingual-reader

安装完成后，需要彻底退出托盘中的 DSH Desktop 应用并重新打开，以确保插件生效。

使用步骤¶

打开 dsh-better-sidebar 侧栏，点击 + 号添加标签。
在新标签中找到「双语阅读」或「翻译」选项（取决于界面语言），点击进入。
点击「浏览…」按钮选择工作区中的 PDF 文件，或直接输入路径点击「加载」。
在 PDF 阅读器中选中一段文字并复制（桌面版支持自动监听剪贴板翻译）。
下方会显示原文与译文。你可以通过下拉框选择互译语言，拖动「上下文」滑块调整取词范围，或通过「领域」选项指定或让插件自动识别。

依赖与版本要求¶

该插件的运行依赖 DSH 运行时注入的特定服务，且对 DSH 版本有明确要求：

依赖项：dsh-better-sidebar、@deepseek-ai/dsh-llm、pdfjs-dist。
DSH 版本适配：
- @deepseek-ai/dsh-llm 必须大于等于 0.1.2-rc.1。
- dsh-better-sidebar 必须大于等于 0.17.1。
- 若安装后提示 does not provide an export named 'deepFreeze'，需升级 dsh-llm 到 v1.0.2 或以上。
DSH Desktop 兼容性：
- 在 DSH Desktop 2.0.9+ 版本中，electron.clipboard 因运行在 utilityProcess 中不再可用。
- 此版本下必须升级插件到 v1.1.1+ 才能正常工作。
配置覆盖：插件复用 DSH 现有的模型与 API Key，无需额外配置。也可通过环境变量覆盖：
- DSH_BILINGUAL_PROVIDER（默认 deepseek-official）
- DSH_BILINGUAL_MODEL（默认 deepseek-v4-flash-vision-exp）
Web 端限制：「自动翻译」功能依赖主机读取系统剪贴板，在纯 Web 端可能不可用。此时请使用「翻译」按钮或按 Ctrl+V。

结语¶

dsh-bilingual-reader 为 DeepSeek Harness 的用户提供了一个轻量级的论文阅读辅助工具。它通过隔离翻译上下文，使得在阅读长文时能保持主对话的整洁与专注。对于需要频繁查阅双语文献的开发者或研究人员，该插件能有效提升阅读效率。

插件目录：dsh-bilingual-reader
源码仓库：GitHub