前言¶
DeepSeek Harness (DSH) 採用了插件化架構，將複雜流程拆解爲可複用的 Skill。文獻綜述工作通常包含“閱讀解讀”、“人工確認”與“格式化輸出”三個階段。如果直接生成內容，容易偏離用戶需求。dsh-paper-survey 插件通過強制執行“解讀先行”的流程，在用戶確認後再生成 PPT，解決了綜述工作流中的控制問題。
插件簡介¶
插件名稱爲 dsh-paper-survey，由開發者 zeros335882878 維護，屬於工作流類別。其核心價值在於：解讀先行 → 用戶確認 → A/B 兩頁結構生成綜述 PPT。它遵循 DSH “一切皆插件” 的理念，將科研綜述流程固化爲標準化的工作流插件。
核心功能¶
該插件包含三個核心 Skill，分別對應綜述流程的不同階段：
-
主流程編排 (
paper-survey)
負責串聯整個工作流。它執行三步流程：解讀 → 確認 → 寫作，並負責版本管理。這是觸發綜述生成的入口。 -
單篇論文解讀 (
paper-interpret)
爲單篇論文提供固定的解讀框架。框架包含 5 塊結構，且每條設計都附有對應 RQx（研究問題）的解釋，確保解讀內容緊扣研究目標。 -
綜述 PPT 生成 (
paper-deck)
依據 A/B 兩頁結構生成綜述 PPT。它負責逐字搬運內容，並應用 pptxgenjs 的排版規範，最後進行 QA（質量檢查）。
安裝與啓用¶
在本地目錄下執行以下命令即可安裝：
dsh plugin --profile web add ./dsh-paper-survey
安裝完成後，可通過以下命令驗證配置是否生效：
dsh --profile web --dump-config | grep -A2 paper-survey
典型用法¶
在 DSH 會話中，通過自然語言觸發相應的 Skill：
- 觸發綜述全流程：輸入“幫我把這幾篇論文做成綜述 PPT”，將調用
paper-survey。 - 觸發單篇解讀：輸入“解讀一下這篇論文”，將調用
paper-interpret。 - 觸發 PPT 調整：輸入“生成/調整 PPT 版式”，將調用
paper-deck。
環境要求¶
該插件的運行依賴特定環境，需提前檢查：
- PDF 提取：需要安裝 Python 3 及 PyMuPDF 庫。
- PPT 生成：需要安裝 Node.js 及 pptxgenjs 庫。
注意事項¶
- 流程控制：遵循“解讀未獲用戶認可前不產出任何 PPT 頁面”的鐵律，避免盲目生成。
- 技術機制：插件基於 Cordis skill provider 機制開發，結構仿照
dsh-ponytail。 - 觸發詞：Skill 內容支持中英文關鍵詞均可觸發。
總結¶
dsh-paper-survey 將文獻綜述這一非標準化任務轉化爲標準化的插件流程。它通過前置的用戶確認步驟，降低了產出內容與用戶預期的偏差。對於需要頻繁處理文獻綜述的開發者或研究人員，該插件提供了一個可落地的自動化方案。
