前言¶

在 DSH（DeepSeek Harness）裏讀論文，常見做法是先把 PDF 轉成文本貼進對話，或依賴外部閱讀器，標註和結論很難和智能體共用。換會話後，之前劃過的段落、寫下的判斷往往要重新找一遍。維護者 jypjypjypjyp 的客戶端插件 dsh-vibe-reading（Vibe Reading）把閱讀界面放進 DSH 右側邊欄：PDF 按原樣渲染，選中即可高亮與批註，論文級筆記與代碼目錄和 agent 跨會話複用，並通過 @ 與 vibe_reading 工具把論文上下文交給模型，而不是反覆粘貼全文。

下面介紹插件定位、能力、安裝步驟與典型用法；事實以 GitHub 倉庫 README 與 package.json（當前版本 0.4.1）爲準。

這是什麼¶

dsh-vibe-reading 是歸類爲「客戶端」的 DSH 插件，面向在 Web 配置下使用 DSH 的開發者與研究者。一句話：右側邊欄裏的論文工作臺——原樣打開 PDF，讀到的留下，AI 接着用。

插件聲明依賴 dsh-better-sidebar（^0.28.2），閱讀器入口掛在 better-sidebar 上；倉庫採用 MIT 許可，隨包內嵌 pdf.js 3.11（Apache-2.0，許可見 public/LICENSE-pdfjs.txt）。運行環境要求 Node.js >=20。

核心功能¶

閱讀與標註¶

• 在側欄中上傳或拖拽導入 PDF；閱讀器使用 vendored pdf.js 渲染，保留版式與字體。
• 選中正文可用浮出菜單做高亮與批註；面板分爲 標註（掛在某頁某段原文，第二行顯示關聯筆記）、筆記（論文級分塊結論，可多條增刪改）、代碼（「開源倉庫 / 本地復現倉庫」兩個頁籤，各有目錄瀏覽）。

正文解析（兩套引擎）¶

導入後默認靜默用 markitdown 轉一份 Markdown。「更多 → 解析正文（MinerU）」會中斷該流程、改用 MinerU（需配置 Token），底部進度條顯示進度。解析結果與原件分目錄存放（見下文存儲佈局）。

與智能體協作¶

• 工具欄 </> 打開「代碼」頁；@ 把 /dsh-vibe-reading 與論文目錄寫入輸入框，由 DSH skill 機制按需加載，而非把全文粘進對話。
• Host 側提供 vibe_reading 工具：list 列庫或讀某篇全部標註與筆記；create / update / delete 管理頁級標註；note / update_note / delete_note 管理論文級筆記；code 讀寫該論文關聯的代碼倉庫路徑。閱讀器「AI 查找倉庫」即引導 agent 走 code 相關動作。
• 插件在 apply() 中註冊運行時 skill dsh-vibe-reading（工具清單、目錄結構、何時寫、每條多長等），規則強調：標註掛原文、筆記記判斷，每條一句話不超過 40 字，只寫結論與依據。

設置¶

工作目錄、MinerU Token、模型、語言等統一在 DSH 左側「插件」→ dsh-vibe-reading 詳情頁，由 DSH 自帶設置表單渲染；閱讀器內「設置」跳轉到同一頁。

存儲與目錄¶

• 內部庫：~/.dsh/vibe-reading/（<uuid>.pdf 原件、<uuid>.json 元數據、settings.json）。
• 對外論文文件夾：~/.paper_reading/<論文名>/，含 pdf/、markdown/（可能帶 images/）、remote/（開源實現）、local/（本地復現）；標註與筆記寫入 notes.md，元信息在 meta.md。

其它行爲¶

結構損壞的 PDF（如缺少 xref / %%EOF）打開時會說明，並提供「下載原件」「重試」，便於用外部工具修復後再導入；閱讀器不嘗試改寫原件。

安裝與啓用¶

從 GitHub 安裝（官方 README 命令）：

# 從 GitHub 安裝
dsh plugin --profile web add github:jypjypjypjyp/dsh-vibe-reading

# 或在本地插件目錄裏 link 進去（開發調試）
dsh plugin --profile web add link:./projects/dsh-vibe-reading

裝完後重啓一次 dsh web（Host 路由在啓動時註冊）。重啓後，右側邊欄的 + 中應出現「Vibe Reading」。

若當前 profile 未激活 dsh-better-sidebar，插件頁可能出現「缺少依賴：右側邊欄」橫幅；點「安裝依賴」會執行 dsh plugin --profile <名字> add dsh-better-sidebar 並寫入 dsh.profile.bundles，需再次重啓。沒有側欄時插件仍會加載，但沒有入口。

社區目錄頁：dsh-vibe-reading @ SkillHub。DSH 插件生態由社區站點與倉庫自行維護，與 DeepSeek / 幻方無官方從屬關係。

典型用法¶

1. 打開右側邊欄，點 +，選擇「Vibe Reading」。
2. 點工具欄上傳或拖入 PDF。需要 MinerU 解析時，在「⋯」或「更多」中選擇「解析正文（MinerU）」，並在插件設置中配置 Token。
3. 閱讀時選中文字使用浮出菜單做標註；在「筆記」欄整理論文級結論；在「代碼」頁維護 remote / local 倉庫路徑，或用「AI 查找倉庫」讓 agent 回填。
4. 對話裏使用 @ 注入 /dsh-vibe-reading 與論文目錄，或讓模型調用 vibe_reading 列出、讀取、創建標註與筆記。

適用場景與注意¶

適合誰：經常在 DSH Web 裏讀論文、希望 PDF 原樣閱讀且標註與 agent 共享的人；需要把論文與開源/本地復現代碼目錄一起管理的人。

權限與安全：插件以當前 dsh 進程權限 讀寫 ~/.dsh/vibe-reading/ 與 ~/.paper_reading/（及設置中的工作目錄）。安裝前建議瀏覽 源碼 與 LICENSE；MinerU Token 等敏感項通過 DSH 祕密字段配置，勿寫入公開文檔。

依賴：Web 客戶端插件；無 better-sidebar 則無 UI 入口，需按上文安裝依賴。

結尾¶

dsh-vibe-reading 把「讀 PDF、留標註、記判斷、連代碼」收進 DSH 右側邊欄，並用 skill 與 vibe_reading 工具把閱讀成果交給後續對話複用。進一步瞭解請看 GitHub 倉庫 與 SkillHub 目錄頁。