DeepSeek Harness 插件

PensiveFei/deep-read-summarize

Star 数 ★ 45 下载量(近 30 天) 8,412 分类 工作流与自动化 收录于 2026-08-21 npm deep-read-summarize

DSH 精读与摘要:书籍/论文/视频/网页经可插拔解析器转成结构化 Obsidian 笔记,MapReduce 并行精读子代理、JSON Schema 输出与幂等缓存。

安装

# npm 包(预构建)

dsh plugin --profile web add deep-read-summarize

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:PensiveFei/deep-read-summarize

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。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 | 简体中文

把论文、书籍、视频或网页整理成一份可以继续阅读、编辑和回查的 Markdown 笔记。

这是一个运行在 DeepSeek Harness(DSH) 中的第三方精读插件。它尝试获取来源全文,将长内容分块阅读,再合并成带 YAML frontmatter 的结构化笔记。你可以把结果放进 Obsidian、Logseq 或其他 Markdown 工具。

先看真实笔记 · 安装与第一次使用 · 了解质量与限制 · 常用配置

AI 笔记可能遗漏或误解原文。请把它作为辅助阅读的起点,关键事实与引用仍需对照来源。

看看笔记

这些是维护者提供的历史笔记:两篇论文有早期项目运行记录,视频笔记的生成方式尚未确认。模型、项目版本和运行耗时未记录,它们不是当前版本的性能承诺。部分引文和时间戳已抽查、并标注了公开副本的修改;详见示例说明。

一篇论文的结构化阅读笔记

它能做什么

你提供 工作流尝试获取 你得到
书籍:PDF、EPUB、MOBI 文本和章节 按主题整理的阅读笔记
论文:arXiv、PDF、HTML 论文正文和结构 研究问题、方法、结论与局限
视频链接 优先字幕;无字幕时可尝试本地转写 基于已取得文本的内容拆解
网页链接 页面正文 要点、概念和来源信息

实际提取结果取决于来源是否可访问、工具是否可用、模型和宿主权限。扫描版 PDF 通常需要先进行 OCR,工作流不内置自动 OCR;复杂公式、图表以及质量差的字幕或音频可能需要人工处理。

笔记通常包含概述、结构拆解、术语表、关键引用、批判性分析和应用思考。最终内容仍由模型生成,不同输入和配置可能产生不同结果。

开始使用

1. 安装插件

先安装并启动一次 DSH Desktop,让它初始化桌面 profile;然后完全退出应用,使用 Desktop 随附的 DSH 命令安装:

dsh plugin --profile desktop add deep-read-summarize

安装完成后重新打开 DSH Desktop。随附命令不一定在系统 PATH 中:可使用安装目录下 resources/runtime/cli/bin/dsh(Windows 为 dsh.cmd)。界面和命令可能随宿主版本变化,详见 DSH Desktop 官方说明。请勿在 DSH profile 目录中直接运行 npm install 或 npm update。

运行精读还需要 DSH 中可用的模型和相应权限;不同来源可能需要额外工具。例如 PDF 文本提取可能需要 pdftotext,YouTube 字幕获取可能需要 yt-dlp,无字幕视频的本地转写可能需要 uv 和转写模型。

2. 发起一次精读

在 DSH 对话中输入,例如:

请帮我精读这篇论文,并生成一份 Markdown 阅读笔记:
https://arxiv.org/abs/2307.09042

你也可以提供本地文件路径、网页或视频链接。如果需要,可以在请求中说明输出位置、希望保留的章节或是否需要时间戳。

想要短一些,可以说“请生成简洁笔记,保留要点、术语和关键引用”。主代理可选择简洁模式,默认最低计数为 500 并省略第 5–7 节,仍保留原文核验;如需批判分析等章节,可以在请求中说明。最低篇幅并非字数上限,实际长度仍由模型决定。

支持插件工具的宿主会注册 deep_read_summarize;旧宿主使用插件提供的技能和 workflow 入口。精读工具返回笔记正文及建议路径,实际写入文件需要由主代理完成。生成后请确认文件已保存,并检查结果中是否报告内容缺口或质量问题。

当工作流提取被包装的笔记时,可选字段 draftContext 会记录提取方式,以及模型在笔记前后附带的额外说明。这些额外文字不是经过原文核验的笔记正文。

{
  "input": "https://arxiv.org/abs/2307.09042",
  "type": "paper",
  "options": {
    "maxChunks": 4,
    "outputDir": "./output"
  }
}

type 可选 auto、book、paper、video 或 web。显式指定类型可以跳过部分模糊输入的识别步骤。具体工具调用方式取决于 DSH 宿主;也可以直接在对话里表达需求。

结果能信到什么程度?

工作流会规范化分块范围,程序检查格式和篇幅,独立核验代理读取取得的文本并给出分块与引文证据。插件工具入口还会在宿主侧读取本次原文,对照文件实际行数和第 4 节提取出的逐字引文;读取失败、原文变化或引文不匹配时不会标为通过。结果可通过 qualityPassed、qualityChecks、qualityEvidence 和 citationVerification 查看。

sourceStatus 表示来源状态:complete 仅表示获取的文本与用户提供的本地纯文本逐字节一致;partial 表示已知只取得部分内容;unknown 表示无法确认完整性,包括网页、PDF 提取结果和视频字幕/转写。sourceComplete 保留为兼容布尔值,仅 complete 时为 true;false 同时涵盖 partial 与 unknown。来源状态会写进笔记,unknown 下即使其他检查通过,也不能断言取得了原始来源全文。

citationVerification.status 为 verified、mismatch、unverified 或 not_applicable。旧式裸 workflow 入口没有宿主文件读取能力:需要核验引文时,它会报告 unverified 和质量未通过。程序匹配只检查第 4 节识别出的逐字引文和对应行范围,不能证明其余结论或改写正确。

质量未通过时,保存的笔记开头会保留提示、失败分块及最多 5 项问题;默认 Obsidian 和 generic 模板中的完成状态会在可安全识别时改为“待核验”。完整问题列表仍在 qualityIssues 中。

这些检查有边界:

  • **qualityPassed 不是事实正确性的证明。**语义覆盖与论证判断仍依赖代理;来源为 unknown 时检查通过也不证明获取完整。重要结论、数字和引用请自行复核。
  • **取得全文不等于理解了全文。**复杂表格、公式、图片以及提取错误可能影响结果;来源不完整或分块失败时,结果会报告缺口。
  • **字幕或转写不等于音频原文。**自动字幕和语音识别可能漏句、听错数字或否定词;核验笔记与逐字稿不能证明逐字稿本身准确。
  • **视频时间戳不能凭空推算。**可定位性取决于取得的字幕或转写是否包含时间信息。

常用配置

选项 默认值 用途
lengthMode standard 设为 concise 使用简洁预设,默认 minWords: 500、fastMode: true
minWords 2500 最低篇幅要求;检查规则按中文字符和其他文字的词计算
fastMode false 开启后省略批判性分析、个人应用和延伸阅读章节
maxChunks 4 分块数量上限,最大为 12;不是并发数
readConcurrency 3 精读并发上限;并发更高不一定更快
maxRetries 0 未通过质量检查时的修订次数;成稿成功后默认执行一次核验,不做修订
outputDir ./output 建议的笔记输出目录,由主代理完成写入
requireCitations true 要求关键引用具备可核验的来源信息
includeTimestamps false 视频笔记是否要求时间戳
transcribe true 视频没有可用字幕时,尝试本地转写
whisperModel / language small / zh 选择转写模型和语言;英文视频可显式指定 en
device / cpuThreads cpu / 0 选择转写设备和 CPU 线程策略
transcriptCache true 相同音频及匹配配置时复用已验证的转写缓存
parallelQuality false 显式启用并行原文核验;默认保留原核验路径
readCache false 可选的跨次精读缓存;仅插件工具入口支持

直接调用时可用 options: { "lengthMode": "concise" }。同一次调用显式提供的 minWords、fastMode 优先于预设;例如加上 "fastMode": false 可保留完整章节。简洁模式尽量接近最低篇幅,但不限制最大字数。

开启 readCache 时,还必须提供 readCacheIdentity,写明供应商、固定模型版本及影响输出的设置;这些信息变化时需更换身份。该身份由调用者提供,宿主无法自动验证。缓存为本地明文,可能包含原文摘录;命中后仍会执行独立原文核验。

其他选项包括 frontmatter(obsidian、generic、minimal)和 tempDir。高级选项、取值范围、转写缓存和自定义解析器可参考完整配置与技术参考。

时间、费用与隐私

  • 时间取决于内容长度、获取方式、分块数量、模型和宿主并发。没有字幕的视频需要额外转写,首次使用还可能下载转写模型。
  • 费用取决于你配置的模型、输入与输出量;本项目不能保证固定的耗时或费用。
  • 隐私:本地语音转写在本机运行,但后续精读使用你在 DSH 中配置的模型。若使用云端模型,原文、字幕、笔记或相关上下文可能发送给对应服务商;请先确认其数据处理条款。
  • 本地文件:临时原文、转写和可选缓存可能保存在设备上;处理敏感资料前请确认目录权限与清理方式。

出问题时

  • 插件不可用:确认已在正确的 DSH profile 安装、重启了桌面应用,并检查宿主版本和插件兼容信息。
  • 获取失败或笔记缺段:确认链接可访问、所需工具已安装;查看返回的阶段、来源状态和失败分块。
  • 只有视频简介:说明没有取得可确认的完整字幕或逐字稿;请检查字幕与转写条件,或提供文本。
  • 质量检查未通过:查看 qualityIssues 和 qualityEvidence,必要时对照原文修订;不要把未核实的笔记当作完整结论。

仍有问题?欢迎在 GitHub Issues 提供操作系统、DSH 与插件版本、输入类型和错误信息。请先去掉密钥、私有链接和个人资料。

开发与贡献

源码开发请在独立的项目目录进行,而不是在 DSH profile 目录运行 npm:

git clone https://github.com/PensiveFei/deep-read-summarize.git
cd deep-read-summarize
npm ci
npm test
npm run test:node
npm run lint
npm run validate

项目使用解析器处理不同输入类型,支持自定义解析器。代码和测试见仓库,版本变化见 CHANGELOG,贡献方式见 CONTRIBUTING。

精读质量基准提供 16 个公开可用的短样本、逐条参考事实和离线计分工具;语义质量需要人工复核,不能把未评审的结果视为得分。

**兼容性:**本项目此前验证过 DSH 0.2.0-rc.2 的相关宿主契约;DSH 接口可能变化,其他版本请以实际测试和兼容说明为准。

版权与声明

项目代码采用 MIT License。示例中引用的论文、视频和短引文仍受其各自权利与授权条件约束。

deep-read-summarize 是独立的第三方项目,与 DeepSeek 或 DeepSeek Harness 官方没有隶属、认可或赞助关系。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

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