把最多 30 篇上传的 PDF 文献变成提示词驱动的文献综述、关键信息提取、研究思路与研究设计,并导出带页码引用的报告(DOCX/PDF)或演示文稿(PPTX/PDF)。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:HaoKuo/dsh-notebook-studio
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 中文
把一批 PDF 文献上传到 dsh 会话里,用提示词对它们做文献综述、关键信息提取,梳理研究思路与研究设计,再生成带页码引用的报告(DOCX/PDF)或演示文稿(PPTX/PDF)。所有结论都系在 [n] PDF p.x 证据上,成稿写入会话工作区。
仓库地址:https://github.com/HaoKuo/dsh-notebook-studio · 版本记录:RELEASE_NOTES.md
功能
- 上传一批文献 — 每个会话项目最多 30 篇文字版 PDF,可多选文件或整个文件夹(非 PDF 跳过),重复文件按内容哈希去重;每篇有自己的状态,解析失败会说明原因并可重试,扫描件不做 OCR。
- 做文献综述 — 写下目标(例如"比较 X 上的证据与分歧"),得到 4–7 节的综述,每段都标注它来自哪篇文献的哪一页,并附参考文献。
- 提取关键信息 — 从文献里提取方法、样本、结果与局限,并生成跨文献证据表,每条都指回具体文献与页码。
- 形成研究思路与研究设计 — 用同一批带引用的证据起草研究问题、空白点、思路和研究设计;这部分属于模型在文献之上的综合,事实仍指向
[n] PDF p.x。 - 生成报告 — DOCX 或 PDF,含执行摘要、分节论述、证据表、文献原图与参考文献。
- 生成演示文稿 — PPTX 或 PDF:先生成可编辑可保存的带引用大纲,再逐页写出核心结论、论述和讲者备注。
- 在 Chat 里问文献 —
studio_search返回文献名、PDF 页码、证据 ID 与原文摘录;中文提问会先改写成英文关键词。 - 插图按内容规划 — 报告每节 0–2 张、演示每页一个主要视觉区域:原图、可编辑流程图、证据表,以及明确标注非论文结果的 AI 示意图。
- 编辑、预览、导出与溯源 — 改完任何文字都可重新排版到新目录(不覆盖已有导出),在 Studio 内预览 PDF,下载 DOCX/PPTX/PDF 或来源 JSON,并查看每条引用背后的真实路径与出处。
- 自选模型 — 可用 dsh 已注册的模型,或自带 OpenAI 兼容接口;密钥只存本地,生图可选且默认关闭,联网参考可选且只发送关键词、以
[Wn]单列。 - 后台运行 — 离开工作台不会中断任务;任务记录列出类型、时间与耗时,重试会复用已完成的页面与文献,上传可取消。
- 边界 — 仅支持文字版 PDF(无 OCR)、每项目 30 篇、单用户;不提供音频/视频概览、思维导图、抽认卡/测验、信息图,也没有共享笔记本。
要求与安装
- DeepSeek Harness
0.1.7-rc.2、0.2.0-rc.2、0.2.1-rc.2或0.2.2-alpha.2(engines.dsh)、Node.js 24、Python 3.12 + PyMuPDF。 - PDF 排版需要包含中文字形的 TTF 字体:本机自动选用 Arial Unicode,其他环境设置
STUDIO_CJK_FONT=/path/to/font.ttf。 - 可选:兼容
images/generations的生图服务(base64 PNG);dsh 的ctx.web.search联网参考。
在仓库根目录执行:
npm ci
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
npm run check
dsh plugin --profile web add "$PWD"
mkdir -p "$HOME/.dsh/skills"
ln -sfn "$PWD/.agents/skills/research-studio" "$HOME/.dsh/skills/research-studio"
从 GitHub 安装
宿主通过 pnpm 安装 git 源,无需本地克隆:
dsh plugin --profile web add github:HaoKuo/dsh-notebook-studio
# 固定到某个发布版本:github:HaoKuo/dsh-notebook-studio#v0.6.6
PDF 解析按 STUDIO_PYTHON(设置后必须可用)→ 包内 .venv → PATH 上的 python3/python 依次寻找,并要求该解释器能 import pymupdf;都不满足时报错会列出每个候选与修复方法:
python3 -m venv ~/.venv-studio && ~/.venv-studio/bin/pip install "PyMuPDF>=1.26,<2"
export STUDIO_PYTHON=~/.venv-studio/bin/python # 启动 dsh web 前设置
安装或更新后重启 dsh web,以重新打包 Web Client。
使用流程
工作台从 dsh 侧栏「插件」上方的 NotebookStudio 打开:左侧资料库,中间编辑/PDF 预览,右侧创作设置,模型与 API 放在齿轮设置中。「返回对话」退出工作台但不更换会话。
- 先选择一个 dsh 会话,再点击 NotebookStudio;没有会话时会提示选择或新建。换项目就在宿主侧栏选择另一个会话。
- 在资料库中添加文献(可多选或选文件夹,非 PDF 会跳过)。每项目最多 30 篇,单篇必须非空且严格小于 30,000,000 字节(30 MB),按内容哈希去重;扫描件不做 OCR。离开工作台会取消未传完的上传,已入库文献与正在运行的任务继续。
- 在「模型设置」选择已加载的 dsh 文本模型(默认 DeepSeek Flash),或填写独立 API 的 Base URL、模型与密钥。图片模型默认关闭;启用时需兼容
/v1/images/generations(本机 Qwen 可留空密钥)。单张图默认等待 600 秒,可设 30–1800 秒。 - 文献显示「已索引」后,勾选本次使用的 PDF 并填写写作目标。「加入网络搜索参考」只发送提示词关键词、不发送 PDF 正文;网络来源以
[Wn]并附 URL 与时间单列,不能冒充[n] PDF p.x的论文证据。 - 选择 DOCX 或 PDF 点「生成完整报告」,或选择 PPTX 或 PDF 点「生成完整演示」。演示先生成有引用的大纲,再逐页带入 PDF 摘录生成结论、论述和讲者备注并排版;大纲可先生成、编辑保存,再据此生成成稿。
- 插图按正文规划:报告每节 0–2 张,演示每页一个主要视觉区域——结果用原图、机制用流程图、比较用表格、抽象概念可用 AI 示意图。生图串行执行,失败时以该章节/页的流程图补位,不冒充论文结果。
- 「预览成稿」查看 PDF,「导出」下载所选格式,「文件与来源」给出实际路径与来源清单。成稿保存在当前会话工作区的
notebook-studio/<会话专属目录>/<report或deck-随机后缀>/;重新排版写入新目录,不覆盖已编辑的副本。 - 「打开正文编辑」可修改标题、摘要、段落、表格结论和逐页正文;「保存并重新排版」应用修改时不调用文本模型改写正文,也不接受修改引用 ID 或素材来源,因此改动过的结论仍需人工核对证据。
- 同一浏览器页面内,离开后重新进入 NotebookStudio 会保留该会话的提示词、选篇和草稿;不同会话隔离,刷新会丢失未保存草稿。
- 在 Chat 中使用
studio_search问答,回答应附证据 ID、文献名和 PDF 页码;左侧也可检索证据、查看任务记录并重试失败文献。
宿主兼容范围
插件只使用公开槽位(sidebar.panellist、main、session-maybe 子槽、layout.selectPanel(null)),不使用私有路由、不改宿主核心布局、不模拟点击。已在 dsh 0.2.2-alpha.2、0.2.1-rc.2、0.2.0-rc.2 与 0.1.7-rc.2 上验证 npm run check、profile 合成,以及运行中的 dsh web 能挂载宿主侧插件。
目录和安全
src/:Host(RPC、上传、SQLite FTS5、模型调用、DOCX/PPTX/PDF);lib/client.js:Web Client;worker/:PyMuPDF 解析;tests/:回归测试;.agents/skills/:检索技能。- 内部数据库、原始 PDF、提取图和缓存保留在
~/.dsh/studio/v1/<会话专属目录>/,交付文件另存到会话工作区。输出路径只取自 Host 的会话cwd——模型与客户端都不能指定任意路径,输出子目录的符号链接会被拒绝;上传经认证,下载与预览按当前会话的记录 ID 校验。 - API Key 保存在权限受限的 SQLite 文件中,读取设置只返回「已配置」。文本 API 会收到所选 PDF 摘录,联网搜索只收到提示词关键词,启用云端图片服务后示意图提示词会发送给该服务。请先确认文献上传、原图使用与各 API 提供方的授权;图片不标记为论文实验结果。
- DOCX/PPTX 可编辑;PDF 由同一内容单独排版,不是 Office 的逐像素转换。没有原图或生图模型时仍可输出原生流程图与对照表;质量结论须经人工对照测评。
npm run check 覆盖 JavaScript 与 Python;真实文献的云端完整生成与真实联网检索不在自动测试范围内。
许可证
MIT,见 LICENSE。
链接
同类插件
tt-a1i/archify#integrations/deepseek-harness★ 98372
从仓库或系统描述生成经过校验的自包含交互式架构图、流程图、时序图、数据流图和生命周期图。
dream-num/dsh-univer-office★ 742
为 DeepSeek Harness 打造一个真正的办公环境。Univer Office 插件将电子表格、文档、幻灯片、画布、多维表格等汇聚到同一个运行时——数据互联、修改经过校验、变更按版本管理,并以隔离工作树支持多 Agent 协作。
Roland0511/dsh-marktext★ 388
基于 MarkText 内核 muya 的右侧栏所见即所得 Markdown 编辑器:打开 .md 按渲染结果编辑,保存走 ctx.fs 并带版本守卫。
ECNU/EduWork#dsh-knowledge-studio★ 383
基于工作区资料的 Studio,复用 DSH 模型与共享成果服务,制作报告、演示文稿、表格、思维导图、测验、闪卡及音视频。Office 生成需 Python 3.12+ 及相关依赖,并配置 DSH_OFFICE_PYTHON;媒体渲染需 Chromium;本地语音转写另需 whisper.cpp 和模型。
PerryLink/dsh-industry-research★ 225
面向 DeepSeek Harness 的确定性行业研究报告:公司与行业研究流程基于分阶段证据产出结构化、可核验的报告。
joeseesun/qiaomu-ui-learn-dsh★ 87
浏览界面设计参考和交互标本,练习设计测验,并导出 Markdown 学习笔记。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。