前言¶
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 将文献综述这一非标准化任务转化为标准化的插件流程。它通过前置的用户确认步骤，降低了产出内容与用户预期的偏差。对于需要频繁处理文献综述的开发者或研究人员，该插件提供了一个可落地的自动化方案。
