前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構，允許用戶在本地或遠程環境中通過插件擴展能力。在處理研究任務時，往往需要同時閱讀多篇 PDF 文獻，進行綜述、提取證據並生成結構化報告。dsh-notebook-studio 專爲這一場景設計，它將文獻處理工作流集成在 DSH 的側邊欄中，通過提示詞驅動生成帶頁碼引用的文檔。
插件介紹¶
dsh-notebook-studio 是 DeepSeek Harness（dsh）插件。其主要功能是上傳多篇 PDF 文獻，利用大模型進行文獻綜述、關鍵信息提取與研究設計，並最終生成帶頁碼引用的報告（DOCX/PDF）或演示文稿（PPTX/PDF）。該插件由 HaoKuo 維護，採用 MIT 許可證。
核心功能¶
- 上傳文獻集：支持從文件或文件夾上傳 PDF，單個項目最多支持 30 篇文本 PDF，系統會根據內容哈希去重。
- 文獻綜述：輸入目標後，生成 4-7 個章節的綜述，每一段落均引用來源的 PDF 頁碼。
- 關鍵信息提取：將各篇論文的方法、樣本、結果和限制提取爲跨論文的證據表，每個條目鏈接回具體論文和頁碼。
- 研究設計輔助：基於引用的證據，起草研究問題、識別研究缺口和提出研究構想。
- 報告生成：輸出 DOCX 或 PDF 格式報告，包含執行摘要、章節內容、證據表、原始圖表和參考文獻。
- 演示文稿生成：輸出 PPTX 或 PDF 格式演示文稿，先生成帶引用的大綱，再逐頁生成結論、討論和演講者備註。
- 論文問答：在聊天中使用
studio_search，答案會附帶證據 ID、論文名稱和 PDF 頁碼。 - 內容插圖：按需生成插圖（每報告章節 0-2 個，每幻燈片 1 個），包含原始圖表、流程圖或 AI 概念圖。
- 編輯與導出：支持在編輯器中修改文本並重新排版，預覽 PDF，下載多種格式或源 JSON，並可追溯引用的真實路徑。
- 模型選擇：支持使用 DSH 註冊的任何模型或獨立的 OpenAI 兼容端點。
- 後臺運行：離開工作臺不會中斷任務，已完成的頁面和論文會被複用重試。
安裝與啓用¶
安裝前請確保已滿足依賴要求：DeepSeek Harness 0.1.7-rc.2 或 0.2.0-rc.2，Node.js 24，以及 Python 3.12（需安裝 PyMuPDF）。如果需要中文排版，請確保設置了包含 CJK 字形的 TTF 字體（如 Arial Unicode），或設置環境變量 STUDIO_CJK_FONT。
通過命令行安裝插件：
dsh plugin --profile web add github:HaoKuo/dsh-notebook-studio
安裝完成後，請重啓 dsh web 以使 Web 客戶端生效。
典型用法¶
- 打開工作臺：在 DSH 會話側邊欄選擇“Plugins”，點擊“NotebookStudio”打開工作臺。如果沒有會話，系統會提示創建或選擇一個。
- 添加文獻：在左側“Library”中添加 PDF 文件或文件夾（非 PDF 文件會被跳過）。系統會自動索引，最多 30 篇。
- 配置模型：在右側“Model settings”中選擇已加載的 DSH 文本模型（默認爲 DeepSeek Flash）或輸入獨立的 API 地址和密鑰。
- 設定目標：勾選已索引的文獻，輸入研究目標。如需添加網絡搜索參考，可在提示詞中添加可選的
[Wn]關鍵詞條目。 - 生成文檔：點擊“Generate full report”生成 DOCX/PDF，或點擊“Generate full deck”生成 PPTX/PDF。演示文稿會先生成帶引用的大綱。
- 問答與驗證：在 Chat 中使用
studio_search進行提問，驗證 AI 是否正確引用了文獻來源。
適用場景與限制¶
- 適用場景：適合需要快速梳理多篇文獻、撰寫帶引用綜述或研究計劃的研究人員。
- 文件限制：僅支持基於文本的 PDF（不支持 OCR），單個項目限制 30 篇論文，僅限單用戶使用。
- 輸出限制：不支持生成思維導圖、抽認卡、測驗或信息圖。
- 共享限制：不支持共享筆記本。
- 排版要求：生成中文 PDF 需要指定包含 CJK 字體的 TTF 字體文件。
- 默認設置：圖片生成默認關閉，需手動開啓並配置兼容
/v1/images/generations的端點。
生態背景與安全¶
DSH 的插件系統允許開發者通過 Host 槽位擴展功能。本插件僅使用公開的 Host 槽位（如側邊欄、主面板），不涉及私有路由或核心佈局修改。插件源碼託管於 GitHub，安裝前建議檢查許可證和源碼邏輯。該插件屬於社區項目，與 DeepSeek 官方或 SkillHub 目錄無官方隸屬關係。
結語¶
dsh-notebook-studio 通過將文獻處理流程標準化，減少了手動整理引用和格式化的時間。它允許研究者專注於核心問題，而將繁瑣的綜述和結構化生成交給插件完成。
