DeepSeek Harness 插件

HaoKuo/dsh-notebook-studio

Star 数 ★ 0 分类 文档与渲染 收录于 2026-10-08

把最多 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 放在齿轮设置中。「返回对话」退出工作台但不更换会话。

  1. 先选择一个 dsh 会话,再点击 NotebookStudio;没有会话时会提示选择或新建。换项目就在宿主侧栏选择另一个会话。
  2. 在资料库中添加文献(可多选或选文件夹,非 PDF 会跳过)。每项目最多 30 篇,单篇必须非空且严格小于 30,000,000 字节(30 MB),按内容哈希去重;扫描件不做 OCR。离开工作台会取消未传完的上传,已入库文献与正在运行的任务继续。
  3. 在「模型设置」选择已加载的 dsh 文本模型(默认 DeepSeek Flash),或填写独立 API 的 Base URL、模型与密钥。图片模型默认关闭;启用时需兼容 /v1/images/generations(本机 Qwen 可留空密钥)。单张图默认等待 600 秒,可设 30–1800 秒。
  4. 文献显示「已索引」后,勾选本次使用的 PDF 并填写写作目标。「加入网络搜索参考」只发送提示词关键词、不发送 PDF 正文;网络来源以 [Wn] 并附 URL 与时间单列,不能冒充 [n] PDF p.x 的论文证据。
  5. 选择 DOCX 或 PDF 点「生成完整报告」,或选择 PPTX 或 PDF 点「生成完整演示」。演示先生成有引用的大纲,再逐页带入 PDF 摘录生成结论、论述和讲者备注并排版;大纲可先生成、编辑保存,再据此生成成稿。
  6. 插图按正文规划:报告每节 0–2 张,演示每页一个主要视觉区域——结果用原图、机制用流程图、比较用表格、抽象概念可用 AI 示意图。生图串行执行,失败时以该章节/页的流程图补位,不冒充论文结果。
  7. 「预览成稿」查看 PDF,「导出」下载所选格式,「文件与来源」给出实际路径与来源清单。成稿保存在当前会话工作区的 notebook-studio/<会话专属目录>/<report或deck-随机后缀>/;重新排版写入新目录,不覆盖已编辑的副本。
  8. 「打开正文编辑」可修改标题、摘要、段落、表格结论和逐页正文;「保存并重新排版」应用修改时不调用文本模型改写正文,也不接受修改引用 ID 或素材来源,因此改动过的结论仍需人工核对证据。
  9. 同一浏览器页面内,离开后重新进入 NotebookStudio 会保留该会话的提示词、选篇和草稿;不同会话隔离,刷新会丢失未保存草稿。
  10. 在 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。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。