dsh-paperforge：在 DSH 裏讀論文：邊讀、邊問、邊記

前言¶

在 DSH 中開發智能體時，閱讀技術論文並整理筆記是常見的高頻動作。現有的做法往往需要切換應用，將閱讀器與對話、筆記工具割裂。dsh-paperforge 插件通過將 PDF 論文庫、專屬 AI 會話與本地 Markdown 筆記整合，解決了“邊讀、邊問、邊記”的需求，讓思考過程直接沉澱在 DSH 的工作流中。

這是一個記憶類插件，由 PhysicalAI-0 維護。它允許你在 DSH 網頁界面中列出並閱讀工作區裏的 PDF，通過劃詞、截圖等方式生成筆記，並在專屬會話中向 AI 追問。

核心功能¶

插件主要提供以下能力：
1. 論文庫：在左側欄列出工作區內的 PDF 文件，點擊即可進入閱讀佈局。
2. 標註：支持劃詞高亮（六色）和框選截圖，選中的內容會自動寫入筆記目錄。
3. Ask AI：在選中段落或頁頭使用 Ask AI，問題會自動帶上 @論文、頁碼與選段上下文，發送給本篇論文的專屬會話。
4. Markdown 編輯：支持塊級編輯，點擊即可修改源碼，離開即自動保存。插件與 AI 的改動會自動合併。
5. Summary：在論文庫的會話頁籤中勾選多個會話，AI 會將其彙總成一份 Markdown。
6. 複製路徑：在任意文檔頁頭點擊複製圖標，可快速獲取文件路徑。

安裝與啓用¶

確保你的 DSH 版本爲 0.1.7+，且 PATH 中包含 pnpm。

使用官方安裝命令添加插件：

dsh plugin --profile web add github:PhysicalAI-0/dsh-paperforge

安裝後，在存放論文的目錄啓動 dsh web，左側欄會出現「論文」入口。若需卸載，執行：

dsh plugin --profile web remove dsh-paperforge

配置與用法¶

插件提供少量配置項，可覆蓋默認行爲。在 ~/.dsh/profiles/web/cordis.patch.yml 中添加：

- id: paperforge
  config:
    workspaceRoot: <論文目錄的絕對路徑>   # 缺省 = 啓動 dsh web 的目錄
    notesDir: paperforge_notes          # 筆記根目錄名
    model:                              # 論文會話用的模型
      provider: deepseek-official
      name: deepseek-flash
      reasoningEffort: high

典型工作流如下：
1. 啓動 dsh web，在論文目錄下點擊左側「論文」。
2. 選中段落，使用 Ask AI 向 AI 追問，上下文會自動帶上論文引用。
3. 劃下重要文字和圖表，自動收進筆記；勾選會話生成 Summary。
4. 需要時，配置 workspaceRoot 或 notesDir 調整存儲位置，或配置 model 指定論文會話的模型。

注意事項與限制¶

1. 界面限制：右側欄最多兩欄（DSH 限制），如需更多窗口請拖成浮動。
2. 編輯限制：Markdown 按塊編輯，撤銷只在當前塊內生效；跨塊的引用式鏈接與腳註可能不生效。
3. Summary 限制：DSH 每條消息最多引用 3 個會話，插件會分批發送。
4. 同名文件衝突：不同目錄下的同名 PDF 會共用一個筆記文件夾。
5. 權限運行：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

結語¶

dsh-paperforge 通過將閱讀、對話與筆記一體化，適合需要在 DSH 中深度研究論文的開發者。更多細節與源碼請參考 GitHub 倉庫。