前言¶

在 DeepSeek Harness（DSH）裏讀論文，常見做法是自行打開 PDF 或 TeX，再把片段貼進對話。路徑、章節和頁碼往往要手工補全，筆記也容易和原文脫節。若希望論文庫、章節導航、公式渲染和「選中即提問」留在同一套界面裏，並讓模型通過統一工具按章節檢索、記筆記或整理審稿材料，需要把閱讀流程做成插件而不是零散腳本。

下面介紹社區插件 dsh-paper-reader-studio（維護者 SpBs2004，分類：記憶）：在 Harness 左側增加「論文」面板，並註冊 paper 工具供對話調用。插件以 bundle 形式發佈，MIT 許可；當前 package 版本爲 0.2.1。生態上 DSH 主張「一切皆插件」，目錄站點 SkillHub 插件頁 與 GitHub 倉庫爲社區維護，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

dsh-paper-reader-studio 給 Harness 裝一個「論文」頁：論文庫 → 章節大綱 → 正文（.tex 經解析並用 KaTeX 渲染公式；.pdf 默認走 pdf.js 頁面閱讀）→ 筆記；支持中英對照、劃選送入當前對話，以及模型側 paper 工具（列庫、大綱、按章節讀、搜索、寫筆記、審稿材料等）。

打開方式：左側欄面板列表中的「論文」圖標（paper-reader）。主界面爲三欄：

論文庫（根目錄下拉 + ＋/⚙ 目錄管理） │ 大綱 + 正文                    │ 筆記

核心功能¶

論文目錄（面板管理，無需改配置）¶

左上角根目錄欄右側：

• ＋ 打開「論文目錄」彈窗：輸入或粘貼絕對路徑，點「添加」。
• ⚙ 打開同一彈窗：查看各目錄來源與論文數，逐項「×」移除。
• 「瀏覽…」優先調用宿主原生目錄選擇器；沒有則直接粘貼路徑。

目錄來源分三種：工作目錄（宿主默認，可移除）、配置默認（cordis.patch.yml 的 roots）、手動添加（面板里加的）。增刪即時生效並持久化，不必重啓或改配置文件。

狀態文件默認位於 <DSH_HOME>/paper-reader/roots.json（Windows 上多爲 C:\Users\<你>\.dsh\paper-reader\roots.json），只記錄相對配置的 added / removed 增量；同一 profile 的會話共用這份列表。

三種用法¶

1. 讀：左側選論文 → 中間顯示章節大綱與正文。.tex 保留行號；.pdf 默認進入頁面閱讀，也可切迴文本模式。點大綱可跳轉（PDF 到對應頁）；標題欄 ↗ 在右側預覽中打開文件（.tex 跳到當前章行號）。
2. 問：正文或 PDF 頁面中劃選 → 浮條選「解釋 / 質疑 / 審稿視角」→ 自動回到對話，提問攜帶論文路徑、章節、頁碼與原文引用。「翻譯」在浮層出譯文；「摘錄」寫入論文同目錄的 <論文>.notes.md。
3. 讓模型用：對話中模型可調用 paper 工具，例如：

paper({ action: 'list' })
paper({ action: 'outline', path: 'D:/papers/.../x.tex' })
paper({ action: 'read', id: 'abc123', section: 'Convergence analysis' })
paper({ action: 'search', id: 'abc123', query: 'differential inclusion' })
paper({ action: 'note_add', id: 'abc123', note: { kind: 'question', text: '…', quote: '…' } })
paper({ action: 'review', id: 'abc123' })
paper({ action: 'bib', id: 'abc123' })

另有 notes_read、translate 等；note_add 是唯一寫操作。模型側還有 roots / root_add / root_remove，與面板共用同一套目錄邏輯。

PDF 頁面閱讀¶

PDF 默認按原版頁面渲染（連續滾動、懶渲染、工具欄翻頁與縮放、TextLayer 支持劃選提問並帶 p.N）。每篇記住頁碼與縮放；大綱點擊可跳頁。標題欄「文本模式」可回到提取文本視圖（可搜索、可複製、可中英對照）。pdf.js 動態加載，不打進首屏 client.js；宿主提供只讀路由 /paper-reader/file 與 /paper-reader/static/pdfjs/…，根目錄外文件 404。若出現「PDF 渲染失敗：… 404」，通常需重啓 Harness 或重新加載插件以加載新版宿主路由。

配置（cordis.patch.yml）¶

筆記格式¶

筆記爲 <論文>.notes.md，追加寫入，條目形如：

## 2026-11-03 18:40 · 摘錄 · §3.2 · L412
> 原文引文……

筆記正文……

安裝與啓用¶

插件以 bundle 裝入某個 profile：桌面版對應 desktop，dsh web 對應 web。較新的 dsh CLI 會拒絕直接操作 desktop profile（由 Electron 獨佔管理），桌面版請用方式一；命令行適用於 web / headless / 自建 profile。

安裝前請知悉：插件在當前 dsh 進程權限下運行，可訪問你配置的論文根目錄；安裝前應自行查看 GitHub 源碼 與 MIT 許可證（vendor/pdfjs/ 爲 Mozilla pdf.js，Apache-2.0）。

方式一：應用內安裝（推薦；桌面版僅能如此）¶

在 DSH 會話中說：

安裝插件 github:SpBs2004/dsh-paper-reader-studio

即調用：

plugin_manager(action="install_bundle", target="github:SpBs2004/dsh-paper-reader-studio")

本地開發可把 target 換成插件目錄絕對路徑，會以 link: 依賴安裝。

方式二：命令行（web / headless / 自建 profile）¶

需與 Harness 版本一致的 dsh CLI 和 pnpm：

dsh plugin --profile web add github:SpBs2004/dsh-paper-reader-studio

命令行安裝不會熱加載，裝完需重啓對應 Harness 進程。確認：package.json 含 dsh-paper-reader-studio，且出現在 dsh.profile.bundles。

卸載與升級（git 依賴固定安裝時 commit，升級先刪再裝）：

dsh plugin --profile web remove dsh-paper-reader-studio
dsh plugin --profile web add github:SpBs2004/dsh-paper-reader-studio

方式三：本機目錄（開發）¶

dsh plugin --profile web add link:E:\path\to\dsh-paper-reader-studio

裝完後刷新頁面（Ctrl+R）。宿主半有路由等改動時需重載插件或重啓 Harness。

典型用法小結¶

先做目錄：面板 ＋ 添加本機論文絕對路徑（或依賴 cordis.patch.yml 的 roots）。再選一篇 .tex 或 .pdf 讀大綱與正文；劃選後用浮條解釋或摘錄。需要模型批量處理時，在對話中讓它 paper({ action: 'list' }) 後 read / search / review。PDF 全文查找可切文本模式，或用 paper 的 search。

適用場景與限制¶

適合：本機已有 TeX/PDF 論文目錄，希望在 Harness 內統一瀏覽、記 .notes.md、並把帶出處的選段送入對話；也讓 agent 按章節讀文獻或出審稿摘要。

需注意（摘自 README）：

• PDF 頁面閱讀依賴宿主路由；升級宿主半後需重載插件。
• PDF 頁面模式暫不支持全文查找；掃描版無文本層時劃選無法帶出可選中文本。
• 右側 PDF 預覽不支持跳到第 N 頁；面板內頁面閱讀支持。
• 公式多爲 KaTeX MathML；少數宏可能顯示爲等寬源碼；定理編號與複雜 TeX 計數器可能和編譯結果不完全一致。

結尾¶

dsh-paper-reader-studio 把論文庫、大綱、KaTeX/PDF 閱讀、選段對話和 paper 工具收進一個面板，目錄可在 UI 裏維護而不必頻繁改配置。需要安裝說明與細節時，以倉庫 README 爲準。

• 插件目錄頁：https://www.skillhub.cn/plugins/SpBs2004/dsh-paper-reader-studio
• GitHub：https://github.com/SpBs2004/dsh-paper-reader-studio