前言¶
用 DeepSeek Harness（DSH）做文獻工作，常見狀態是：PDF 散落在磁盤各處，讀的時候要開另一個窗口看原文，記筆記又回到另一個工具，最後寫論文再手工整理參考文獻。深度求索的 DSH 一直強調「一切皆插件」，這次介紹的 xurui2022/dsh-paper-manager 就是一個把「讀論文」和「寫論文」接在同一條工作流裏的插件。它把論文庫掛在 DSH 的左側全局面板，右側欄仍保留一個閱讀標籤頁，選段可以翻譯、概括、畫思維導圖、查術語，寫論文時能跨文件夾多選論文生成參考文獻，並把參考文獻頁追加到 Word 文檔末尾。
下面介紹這個插件的定位、功能、安裝和用法。事實以 GitHub README 和 package.json 爲準。
這是什麼¶
dsh-paper-manager 面向學生、研究者和教授，維護者是 XuRui2022，分類爲聯網工具，在社區目錄的星標爲 0。它的前身是 jypjypjypjyp/dsh-paper-reader（MIT），本插件保留其 PDF 原樣渲染、批註與人機共管能力，新增左側欄、文件夾、AI 閱讀、引用工作臺、Word 插入與發佈流程。原始 MIT 歸屬見倉庫的 LICENSE。
一句話定位：一個跑在 DSH 裏的論文閱讀與引用管理器，入口在左側欄，數據落在本機，AI 能力通過宿主對話模型完成。
核心功能¶
閱讀¶
pdf.js 按頁把 PDF 渲染成畫布，排版、字體、插圖、公式都不經過轉換。上傳的原始文件保存在 ~/.dsh/paper-manager/，不做改寫。左側欄入口在 sidebar.panellist 中，點論文管理器圖標切換到 main 全局面板；右側欄的「論文閱讀器」標籤頁仍然可用，兩個入口共享同一份論文庫。
論文庫支持新建、重命名、刪除文件夾，每篇論文可移動到文件夾，過濾器按「全部 / 未分類 / 某文件夾」篩選，上傳自動歸入當前文件夾。
選中正文任意文字會浮出菜單：第一行是「高亮 / 筆記 / 提問」，第二行是「翻譯選段 / 查術語」。高亮與筆記按頁保存，跨縮放定位，面板的「標註」頁可以回看、跳轉、刪除。選段和問題可以寫進會話輸入框，左欄沒有當前會話時自動新開一個，提問語言跟隨界面語言。
工具欄下方是一排 AI 按鈕：翻譯本頁或整篇論文（目標語言默認跟隨界面語言，也可手動切換中/英）、概括、生成思維導圖、提取術語。概括輸出結構化摘要，包含問題 / 方法 / 關鍵結果 / 侷限 / 值得讀的理由；導圖返回可展開的樹；術語給出 8–16 條技術名詞與解釋，每個名詞可跳轉 Google Scholar、Semantic Scholar 或 Wikipedia。
批註是人機共管的：批註存在磁盤上，agent 通過 paper_annotations 工具讀寫，人在閱讀器裏讀寫，AI 寫的批註帶 AI 標籤。每篇論文還可以掛一個開源倉庫地址和/或本地代碼目錄，點文件讓 agent 對照論文讀代碼。
寫作與引用¶
書庫裏的複選框不會因爲切換文件夾而丟失，可以跨文件夾累積選擇，服務端上限 200 篇。支持六種參考文獻格式：GB/T 7714、APA 7、MLA 9、Chicago、IEEE、BibTeX，切換格式即時重排。引用元數據可以編輯作者、年份、標題、期刊/會議、卷、期、頁碼、出版社、DOI、URL、文獻類型，保存後寫回論文元數據。
引用工作臺左側列出已選論文，右側顯示格式化預覽，可以複製、選擇 Word 文件、插入。.docx 用零依賴 OOXML 追加，保留原文檔的樣式、字體、圖片和其他 ZIP 條目，只在 word/document.xml 的節屬性前插入分頁、標題和編號條目；.doc 在 Windows 且安裝了 Microsoft Word 時，通過 Word COM 把生成的參考文獻頁插入原文件末尾，不解析二進制 .doc，也不破壞原文件。插入完成後默認用系統默認程序打開文檔。
發佈¶
發佈流程分兩段：GitHub 連接和插件市場提交。連接時在彈窗中粘貼有 repo 權限的 Personal Access Token，服務端校驗 /user 後以 0600 權限保存在 ~/.dsh/paper-manager/github.json。發佈倉庫會創建或複用 <login>/<repo>，改寫 package.json 的 repository/homepage/bugs，執行 git init/commit/push，成功後把遠端改回不含 token 的乾淨 URL。提交市場則是 fork awesome-dsh-plugin/awesome-dsh-plugin，向 data/plugins/<owner>__<repo>.yml 寫入條目並向主倉庫開 PR。
安裝與啓用¶
本插件按 DSH bundle 方式安裝。開發目錄在 D:\deepseekHarness\paper-manager 時，在 Harness 會話裏執行：
plugin_manager action=install_bundle target=D:\deepseekHarness\paper-manager
或從 GitHub 安裝：
dsh plugin --profile desktop add github:<your-account>/dsh-paper-manager
裝完刷新頁面。左側欄應出現論文管理器圖標，右側欄 + 中仍有「論文閱讀器」。
工作目錄、MinerU Token、模型、語言等設置在左側「插件」→ dsh-paper-manager 詳情頁，使用插件自己的表單和宿主主題 token。
典型用法¶
- 點左側欄論文管理器圖標，打開全局面板。
- 點工具欄上傳按鈕（或把 PDF 拖進面板）導入論文；先在庫面板新建/選擇文件夾，論文會自動歸檔。
- 選中正文文字，使用浮出菜單；工具欄下方一排按鈕可翻譯本頁、概括、生成思維導圖、提取術語。
- 面板分爲四欄：標註、筆記（論文級結論）、代碼、AI 閱讀（翻譯 / 概括 / 思維導圖 / 術語）。
- 寫論文時：在書庫勾選多篇論文（可跨文件夾）→ 點「參考文獻」→ 選格式、覈對/編輯元數據 → 選
.docx或.doc→ 插入。 - 發佈：更多菜單 → GitHub → 連接賬號 → 發佈倉庫 → 提交市場。
AI 請求都走 /paper-manager/api/ai/*，只發送抽取出的正文，不發送 PDF 原件或標註數據。翻譯優先使用 profile 裏的 translator 服務，沒有時回退到默認對話模型（agentDefaultModel），約 6000 字分塊、3 路併發；概括、思維導圖、術語提取直接調用默認對話模型，提示詞按界面語言切換。長論文按頁抽取文字，最多 60 頁 / 15 萬字符。
適用場景與注意¶
適合需要長期讀論文、寫綜述或學位論文，並希望在同一個界面裏完成閱讀與引文整理的人。插件的 AI 能力依賴宿主配置的對話模型與 translator 服務，因此行爲會隨模型變化。
幾個必須知道的限制：
.doc插入依賴 Windows 上安裝的 Microsoft Word，其他平臺請先另存爲.docx。- GitHub 連接目前是「粘貼 Token」而不是 OAuth Device Flow；沒有 Token 時無法代替用戶創建倉庫或開 PR。
- 插件市場提交是開 PR，是否收錄由市場維護者的 CI 與人工審覈決定，新倉庫需滿 1 天。
- 本機沒有可用的已連接瀏覽器控制，UI 只做了 JS 語法、manifest、live slot 與 HTTP API 驗證，未做自動點擊截圖，首次使用請按上面的步驟走一遍。
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證：MIT，原件存儲在
~/.dsh/paper-manager/，對外論文文件夾在~/.paper_reading/<論文名>/。 - 渲染部分使用 vendored pdf.js 3.11（Apache-2.0，許可證見
public/LICENSE-pdfjs.txt）。
社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，也不等同於官方應用商店。
結尾¶
dsh-paper-manager 的價值在於把論文庫、AI 閱讀和引文工作臺收進 DSH 的面板，不用頻繁切換窗口。目錄頁：https://www.skillhub.cn/plugins/XuRui2022/dsh-paper-manager，GitHub：https://github.com/XuRui2022/dsh-paper-manager。
