前言¶

在 DeepSeek Harness（DSH）裏做研究或系統讀論文，常見做法是本地 PDF 加筆記工具，再在側邊欄或外部窗口裏和模型對話。PDF 高亮、結構化筆記、按論文維度的共讀上下文，以及「一個課題下的多篇文獻怎麼串起來」，往往分散在不同應用裏。下面介紹的 dsh-paper-desk（維護者 fexas）是 DSH 的客戶端類插件：在側邊欄增加 Papers 入口，用三欄佈局（左側 DSH 側欄、中間 PDF 或項目腦圖畫布、右側 DeepSeek 對話 / Markdown 筆記本）把項目、文獻、標註和 AI 筆記放在同一套界面裏；數據以本地明文文件存放，不依賴獨立數據庫。項目 README 說明界面、AI 精讀筆記與共讀對話默認面向中文用戶。

這是什麼¶

dsh-paper-desk 的定位是：面向 DeepSeek Harness 的、形態接近 Zotero 的論文閱讀工作臺——支持 PDF 高亮、AI 精讀筆記、共讀對話，以及按項目維護的 React Flow 腦圖。插件當前版本爲 1.2.0（見倉庫 package.json），許可證 MIT。社區目錄頁：skillhub.cn 插件頁；源碼與說明：GitHub fexas/dsh-paper-desk。

核心功能¶

以下能力均來自項目 README，按使用路徑歸納。

項目與文獻庫¶

• 兩類項目：Research（找問題、建方法、比 benchmark）或 Learning（概念依賴、時間線、閱讀隊列、回憶練習）。每個項目統一保存論文、標籤、標註、對話、筆記與腦圖。
• 拖入 PDF：上傳、解析並按 Author et al. - Year - Title 形式歸檔；標題、作者、年份來自 PDF 元數據與首頁。
• 論文行（Zotero 式）：展開可見 paper.pdf、notes.md 及附錄等；額外文件原樣存儲、不解析。
• 打開閱讀：點 Read，或在論文行非交互區域雙擊。

PDF 閱讀與標註¶

• PDF.js 閱讀器：適應寬度 / 縮放、翻頁、可選文本、四色高亮、段落錨點筆記、選中翻譯、對選中段落「問 AI」。
• AI 精讀筆記：首次打開時由 DeepSeek 生成結構化 Markdown（TL;DR、核心問題、相關工作、方法動機與要點、實驗閱讀方式、優缺點與展望等）；右側可編輯、預覽、自動保存，並支持「AI 重寫」。
• 共讀對話：每篇論文獨立 DeepSeek 會話，上下文包含正文、生成筆記、高亮與引用段落；會話持久化。

筆記、標籤與檢索¶

• 支持 $...$、$$...$$ 等數學公式（KaTeX）；代碼片段與貨幣符號不被誤渲染。
• Zotero 式標籤芯片；可按多標籤過濾，並搜索標題、作者、標籤與筆記摘要。

項目腦圖¶

• 每項目一份持久化 mindmap.json；Research / Learning 使用不同模板種子節點，均可編輯；整理佈局 使用 dagre 自動排版。
• 從 論文庫 點擊或拖拽論文到畫布；節點可關聯論文、反向鏈接；右側可在 對話（整圖 + 文獻元數據 + 可選選中節點交給 DeepSeek）與 節點（編輯標題、類型、Markdown、關聯論文）之間切換。

數據形態¶

無數據庫；目錄結構示意如下（README 原文）：

paper-desk/
  projects/
    scaling-inference-for-sbi/
      project.json
      mindmap.json
      mindmap-chat.json
      papers/
        kuhmichel-et-al-2026-high-dimensional-simulation-based-inference/
          paper.pdf
          paper.txt
          notes.md
          annotations.json
          chat.json
          attachments/

刪除項目或論文會移入 projects/.trash/，而非直接抹掉。除模型請求外，PDF、文本與聊天記錄留在本地。

環境與依賴¶

• DeepSeek Harness 0.2.x，需啓用 Web GUI 並配置 DeepSeek 類 provider。
• 現代 Chromium 系 Web 渲染環境（含 DSH Desktop）。
• 插件使用當前 DSH profile 的 provider / model，不單獨索要 API Key；未顯式配置時會選用 profile 中第一條可用的 DeepSeek Flash / Chat 路由。
• 本地開發構建需 Node.js 22+（普通用戶通過 DSH 安裝託管包時無需自行 npm run build）。

安裝與啓用¶

在 DSH 中打開 Settings → Plugins，從 GitHub 安裝 bundle fexas/dsh-paper-desk 並啓用。若宿主提示安裝新包後需重啓，則重啓 DSH。

可選配置寫在 profile 的插件行（字段以 README 爲準）：

- id: dsh-paper-desk
  name: dsh-paper-desk
  config:
    provider: deepseek-account
    model: deepseek-flash
    # dataDir: /absolute/path/to/paper-desk-projects

數據目錄默認位置¶

可通過 config.dataDir 覆蓋爲絕對路徑。

典型用法¶

1. 安裝並啓用插件後，在 DSH 側邊欄進入 Papers，新建 Research 或 Learning 項目。
2. 將 PDF 拖入項目，待解析完成後雙擊論文行或使用 Read 打開三欄閱讀界面。
3. 首次打開等待右側生成 notes.md 精讀筆記；在 PDF 中高亮、寫段落筆記，必要時選中段落翻譯或「問 AI」。
4. 使用論文專屬 共讀對話 追問；標籤與搜索用於在多篇文獻間篩選。
5. 在項目內打開 項目腦圖，從論文庫拖入節點，用 整理佈局 排版；在腦圖右側用 對話 做課題或學習路徑層面的討論。

架構上，瀏覽器端 client.js（PDF.js、KaTeX、React Flow 等已打包）通過 RPC 訪問宿主 paperDesk 命名空間讀寫 projects/ 下的 JSON 與 Markdown；瀏覽器不直接訪問文件系統。

適用場景與注意¶

適合：已在 DSH 0.2.x 中使用 DeepSeek provider、希望把「文獻庫 + PDF 標註 + 結構化 AI 筆記 + per-paper 對話 + 項目級腦圖」收攏到同一宿主界面、並願意以本地文件夾作爲唯一數據源的用戶。

注意：

• DSH 社區插件目錄（如 skillhub.cn）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；安裝前請自行審閱 源碼 與 MIT 許可證。
• 插件以當前 DSH 進程權限運行，可讀寫你配置的 dataDir 及上傳的 PDF；僅向已配置的模型發起推理請求。
• README 截斷處另含性能說明（如 PDF 分塊並行加載）；若遇大文件或渲染問題，以倉庫最新 README 與 Issues 爲準。

結尾¶

dsh-paper-desk 把 Zotero 式文獻管理與 DSH 側欄、DeepSeek 精讀筆記和共讀對話、按項目的 React Flow 腦圖疊在同一套客戶端插件裏，並用明文項目目錄避免廠商鎖定。進一步瞭解可訪問 社區目錄頁 與 GitHub 倉庫。