前言¶
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 倉庫。
