前言¶
DeepSeek Harness（DSH）支持通过插件扩展功能。阅读论文通常涉及在文件管理器和聊天窗口之间切换，手动总结或分段提问。dsh-paper-reader 插件将论文阅读流程集成到 DSHA 的对话界面中，通过三栏布局实现从浏览、阅读到实时提问的一体化操作。
功能概览¶
该插件为 DSHA 提供了一个三栏阅读界面：
- 左栏：显示工作区内的文稿目录树，支持浏览文件。
- 中栏：以黑底白字渲染论文，支持 PDF.js 渲染、缩放、反色及文字抽取。
- 右栏：集成 DSHA 平台子代理，提供实时对话与分析功能，并支持右栏停靠模式。
插件具备以下核心能力：
- 集成 DSHA 平台子代理进行论文分析。
- 支持只读镜像展示子代理会话。
- 支持 Markdown 与 PDF 格式。
- 支持文件目录树浏览。
安装与启用¶
安装插件需要使用官方的 DSHA 插件管理命令。
dsha-plugin import /tmp/dsh-paper-reader.zip
安装、更新或卸载后，必须重启 DSHA Web 应用才能使插件生效。
使用方法¶
进入三栏阅读模式的操作步骤如下：
- 在任意会话中，点击输入框右侧的「论文」按钮。
- 在左栏选择一篇文稿（首次进入会自动打开第一篇 Markdown 文件），在中栏阅读正文。
- 在右栏直接向子代理提问，子代理会根据论文内容进行回答。
- 在右栏对话时，可以使用「停止」按钮中断流式输出。
- 需要使用原生界面的完整操作时，点击「原生打开」查看；或点击「返回对话」回到原来的聊天界面。
配置与限制¶
插件运行依赖于环境变量配置，且存在一些特定的使用限制。
环境变量配置：
- DSHA_PAPER_ROOTS：用于追加可读的根目录（默认为 dsh 进程工作目录），用冒号分隔多个路径。手机存储默认不可读，需通过此变量开启。
- DSHA_PAPER_PDFJS_DIR：指定 pdf.js 所在目录，默认为插件内的 node_modules/pdfjs-dist。
使用限制：
- 面板显示为只读镜像，完整的操作（如审批、模型切换）需在原生子会话中完成。
- 子代理处于休眠时，可通过人类通道唤醒；一轮结束后会被平台回收，但镜像仍可查看历史记录。
- LaTeX 公式按源码显示，DOCX 格式仅支持下载。
- 安装、更新或卸载后需重启 DSHA Web 才能生效。
结语¶
dsh-paper-reader 将 DSHA 的对话能力与本地文件浏览结合，简化了论文阅读流程。更多细节与源码，可参考目录页或GitHub 仓库。
