前言¶
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 通过将文献处理流程标准化，减少了手动整理引用和格式化的时间。它允许研究者专注于核心问题，而将繁琐的综述和结构化生成交给插件完成。
