deep-read-summarize 0.5.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +1 -1
- package/CHANGELOG.md +42 -0
- package/README.en.md +91 -335
- package/README.md +93 -336
- package/cordis.patch.yml +4 -0
- package/docs/RELEASE.md +3 -1
- package/index.js +36 -8
- package/lib/options.js +12 -4
- package/lib/read-cache.js +115 -0
- package/lib/workflow-script.txt +150 -17
- package/package.json +1 -1
- package/parsers/_prompt.js +1 -0
- package/schemas/index.js +12 -0
- package/scripts/chunk-balance.js +71 -0
- package/skills/deep-read-summarize/SKILL.md +7 -5
- package/workflow.js +1 -1
package/README.md
CHANGED
|
@@ -1,401 +1,158 @@
|
|
|
1
1
|
# deep-read-summarize
|
|
2
2
|
|
|
3
|
-
[English](https://github.com/PensiveFei/deep-read-summarize/blob/main/README.en.md) |
|
|
3
|
+
[English](https://github.com/PensiveFei/deep-read-summarize/blob/main/README.en.md) | 简体中文
|
|
4
4
|
|
|
5
5
|
[](https://github.com/PensiveFei/deep-read-summarize/blob/main/LICENSE)
|
|
6
6
|
[](https://github.com/PensiveFei/deep-read-summarize/releases)
|
|
7
7
|
[](https://github.com/PensiveFei/deep-read-summarize/actions/workflows/ci.yml)
|
|
8
8
|
[](https://www.npmjs.com/package/deep-read-summarize)
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
把论文、书籍、视频或网页整理成一份**可以继续阅读、编辑和回查的 Markdown 笔记**。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
这是一个运行在 [DeepSeek Harness(DSH)](https://github.com/deepseek-ai/deepseek-harness) 中的第三方精读插件。它尝试获取来源全文,将长内容分块阅读,再合并成带 YAML frontmatter 的结构化笔记。你可以把结果放进 Obsidian、Logseq 或其他 Markdown 工具。
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
[先看真实笔记](#看看笔记) · [安装与第一次使用](#开始使用) · [了解质量与限制](#结果能信到什么程度) · [常用配置](#常用配置)
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
> AI 笔记可能遗漏或误解原文。请把它作为辅助阅读的起点,关键事实与引用仍需对照来源。
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
## 看看笔记
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
- 📄 [论文:大语言模型的情绪智力](https://github.com/PensiveFei/deep-read-summarize/blob/main/examples/emotional-intelligence.md)
|
|
21
|
+
- 📄 [论文:Chain-of-Thought Prompting](https://github.com/PensiveFei/deep-read-summarize/blob/main/examples/chain-of-thought.md)
|
|
22
|
+
- 🎬 [视频:Andrej Karpathy 的 LLM 入门讲座](https://github.com/PensiveFei/deep-read-summarize/blob/main/examples/intro-to-llms-video.md)
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
这些是维护者提供的历史笔记:两篇论文有早期项目运行记录,视频笔记的生成方式尚未确认。模型、项目版本和运行耗时未记录,它们不是当前版本的性能承诺。部分引文和时间戳已抽查、并标注了公开副本的修改;详见[示例说明](https://github.com/PensiveFei/deep-read-summarize/blob/main/examples/README.md)。
|
|
23
25
|
|
|
24
|
-
|
|
26
|
+

|
|
25
27
|
|
|
26
|
-
##
|
|
28
|
+
## 它能做什么
|
|
27
29
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
34
|
-
| 视频笔记(行动要点) | 会话内摘要 |
|
|
35
|
-
| --- | --- |
|
|
36
|
-
|  |  |
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## 能做什么
|
|
41
|
-
|
|
42
|
-
- 书籍(PDF/EPUB/MOBI)、论文(arXiv/PDF/HTML)、视频(**字幕优先,无字幕自动转写**,出品完整逐字稿精读)、网页
|
|
43
|
-
- 长内容分块后由并行子代理精读,再合并
|
|
44
|
-
- 获取/分块与质量校验的输出受 JSON Schema 约束,结构稳定、下游可解析
|
|
45
|
-
- 分块计划与子代理数量受 `maxChunks` 强制约束(计划失控会顶穿单次调用时限)
|
|
46
|
-
- 关键引用必须标注页码/章节/段落,降低编造风险
|
|
47
|
-
- 配置错误直接报错终止;某块内容解析失败则跳过并标记缺口
|
|
48
|
-
- 输出**标准 Markdown + YAML frontmatter**:正文是通用 CommonMark(无双链、无 callout),Obsidian(配合 Dataview)、Logseq、Jekyll / Hugo / Astro 的内容目录、任意 Markdown 编辑器都能直接用
|
|
49
|
-
|
|
50
|
-
---
|
|
51
|
-
|
|
52
|
-
## 结构
|
|
53
|
-
|
|
54
|
-
```
|
|
55
|
-
输入(链接或文件路径)
|
|
56
|
-
│
|
|
57
|
-
▼
|
|
58
|
-
解析器注册表 ── book / paper / video / web
|
|
59
|
-
│
|
|
60
|
-
▼
|
|
61
|
-
波次1 获取内容 → 写入临时文件 → 生成分块计划
|
|
62
|
-
│
|
|
63
|
-
▼
|
|
64
|
-
波次2 N 个子代理并行精读各块(Map)
|
|
65
|
-
│
|
|
66
|
-
▼
|
|
67
|
-
波次3 合并成稿 + 质量校验(Reduce)
|
|
68
|
-
│
|
|
69
|
-
▼
|
|
70
|
-
Markdown 笔记
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
三个波次,默认约 N+3 次子代理调用(获取、N 块精读、成稿、质量校验)。`auto` 遇到 PDF、未知网页或文本等模糊输入时,额外进行一次轻量类型识别;显式指定 `type` 可跳过识别。
|
|
74
|
-
|
|
75
|
-
`auto` 会将明确的视频链接、arXiv 论文链接和电子书扩展名直接分发到对应解析器;同站的专栏、频道与帮助页仍先分类,PDF 会根据内容区分书籍与论文。无法识别时返回 `stage: "detect"`,请显式指定类型。`options.tempDir` 作为临时根目录,每次调用在其中创建独立的 `run-*` 子目录,获取、音频和转写文件不与其他任务共用。
|
|
76
|
-
|
|
77
|
-
分块计划会排序、裁掉重复区间并补齐缺口,超过 `maxChunks` 时合并相邻块以保留全文。返回的 `coverageComplete` 表示是否依据有效的 `totalLines` 覆盖全部行号;缺少总行数时保留已知范围,同时将 `qualityPassed` 置为 `false` 并说明覆盖无法确认。
|
|
78
|
-
|
|
79
|
-
质量检查分两部分:程序按提供的标量/列表 frontmatter 模板检查字段、必要章节和篇幅(汉字按字、其他文字按词,排除 frontmatter、代码块、HTML 注释及链接地址);独立核验代理读取本次原文文件,逐块检查覆盖,并为第 4 节的逐字引用返回原句和行号。单独的 `pass: true` 无法通过检查。`qualityChecks` 返回检查项,`qualityEvidence` 返回原文路径、分块摘录和引用证据;原文真实性判断仍由读取原文的代理完成,无法核实就报告未通过。修订为空、调用失败或结构退化时保留上一份有效成稿。
|
|
80
|
-
|
|
81
|
-
直接调用 workflow 的 options 必须类型正确:`minWords` 为 1–100000 的整数,`maxChunks` 为正整数(大于 12 仍夹到 12),`maxRetries` 为 0–3 的整数;非法值和未知键在启动时 FATAL。插件 profile 的 config 则逐项告警并回退默认值,避免阻止宿主启动。
|
|
82
|
-
|
|
83
|
-
```
|
|
84
|
-
parsers/ 各输入类型的解析器,按类型分发
|
|
85
|
-
book.js 书籍:PDF/EPUB/MOBI 文本提取、章节分块
|
|
86
|
-
paper.js 论文:arXiv/PDF/HTML 结构识别
|
|
87
|
-
video.js 视频:完整逐字稿(字幕优先,无字幕自动转写,走 scripts/transcribe.js)
|
|
88
|
-
web.js 网页:正文提取
|
|
89
|
-
index.js 注册表:解析器发现与回退
|
|
90
|
-
schemas/ 输出约束的 JSON Schema(波次1 由 workflow.js 注入脚本,单一真相)
|
|
91
|
-
scripts/ lint(含换行/空白卫生检查)、安全检查、跨平台转写引导(transcribe.js)
|
|
92
|
-
lib/ 独立可用的小工具
|
|
93
|
-
cache.js 输入指纹与幂等记录(供自己驱动流程的调用方使用;workflow 沙箱没有文件系统,用不到它)
|
|
94
|
-
workflow-script.txt workflow 脚本正文(普通文本,可直接读改,不需要任何转义)
|
|
95
|
-
tests/ 测试与验证脚本(**不随 npm 包发布**,仓库里才有)
|
|
96
|
-
workflow.js workflow 的 meta 与组装逻辑(解析器内联、schema 注入)
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
> 脚本正文单独放 `lib/workflow-script.txt`:这个文件曾经因为「转义套转义」被改坏过两次,现在它是普通文本,读改都不需要编码步骤。
|
|
100
|
-
|
|
101
|
-
想换某个输入类型的处理方式,在插件包的 `custom-parsers/` 放一个同接口的解析器即可,该目录会随 npm 包分发。也可在插件顶层 config 中指定 `customParsersDir`,使用自己的解析器目录;它不是 workflow options。相同类型会覆盖内置实现,也可新增 `podcast` 等类型。程序化注册后重新生成技能会使用最新注册表;各 profile 的专属目录相互隔离。接口为 `name`、`types`、`buildPrompt(input, opts)`。
|
|
102
|
-
|
|
103
|
-
解析器的 CommonJS 模块会连同字面量相对路径的 `.js` / `.cjs` / `.json` 依赖一起打包,保留模块级常量、helper、方法简写和循环依赖。构建时使用 Acorn 解析 JavaScript;它由 npm 自动安装,不进入 workflow 沙箱。沙箱中的解析器只负责生成提示词,不支持 Node 内置模块、外部包或动态 `require` / `import`;这些依赖会在构建时明确报错。程序化注册的函数须自包含,模块闭包请使用文件解析器。
|
|
104
|
-
|
|
105
|
-
---
|
|
106
|
-
|
|
107
|
-
## 支持平台
|
|
108
|
-
|
|
109
|
-
**Windows / macOS / Linux 同等支持**(0.3.9 起)。插件本身只依赖 Node(DSH 自带),各环节需要的额外工具按平台装:
|
|
110
|
-
|
|
111
|
-
- **书籍 / 论文 PDF** → `pdftotext`(poppler):macOS `brew install poppler`、Windows `winget install poppler`、Debian/Ubuntu `apt install poppler-utils`
|
|
112
|
-
- **B站字幕 / 音频** → `curl`:Windows 10+ 与 macOS / Linux 都自带,零安装
|
|
113
|
-
- **YouTube 字幕** → `yt-dlp`:macOS `brew install yt-dlp`、Windows `winget install yt-dlp.yt-dlp`、任意平台 `pip install -U yt-dlp`
|
|
114
|
-
- **无字幕转写** → `uv`(脚本自举:建 Python 3.12 环境 + 装 faster-whisper):macOS `brew install uv`、Windows `winget install astral-sh.uv`,macOS / Linux 也可用官方安装脚本(`curl -LsSf https://astral.sh/uv/install.sh` 交给 `sh`)
|
|
115
|
-
|
|
116
|
-
其余说明:
|
|
117
|
-
|
|
118
|
-
- 转写是**唯一**需要额外工具链的环节,三平台共用同一份 Node 脚本、同一条命令:`node scripts/transcribe.js --audio <音频> --out <txt>`。
|
|
119
|
-
- 转写默认走 **CPU**,Apple Silicon / Intel Mac 与 Linux 都不需要 CUDA;GPU 需自备 CUDA 运行库,`options.device: "auto"` 会尝试并在失败时自动回退 CPU。
|
|
120
|
-
- 缓存目录按平台取:macOS `~/Library/Caches/deep-read-summarize`、Linux `$XDG_CACHE_HOME/deep-read-summarize`、Windows `%LOCALAPPDATA%\deep-read-summarize`。
|
|
121
|
-
- 已在**真实 macOS** 上跑通一次完整的无字幕转写(0.3.12 起):`uv` 自举 Python 3.12 → 装 faster-whisper → 下载模型 → 输出逐字稿,退出码 0;CI 的 `macos-latest` 作业另外覆盖平台路径解析与整套测试。遇到报错欢迎开 issue 反馈。
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
## 安装(DSH 插件)
|
|
125
|
-
|
|
126
|
-
deep-read-summarize 是 DSH 插件,可通过 npm 或本地安装:
|
|
127
|
-
|
|
128
|
-
```bash
|
|
129
|
-
# npm 安装(自动安装用于解析器构建的 Acorn)
|
|
130
|
-
npm install deep-read-summarize
|
|
131
|
-
|
|
132
|
-
# 或本地安装(dsh profile 目录)
|
|
133
|
-
pnpm add ./deep-read-summarize-0.3.10.tgz
|
|
134
|
-
# 然后在 dsh 配置的 dsh.profile.bundles 追加:
|
|
135
|
-
# - deep-read-summarize
|
|
136
|
-
# 重启 dsh web 即可(POST /dsh-market/restart)
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
安装后自动注册:
|
|
140
|
-
- `deep_read_summarize` 工具(宿主提供 tools / workflowEngine 服务时);模型只传 input/type/options,插件直接提交已加载的工作流
|
|
141
|
-
- `deep-read-summarize` 工作流定义(meta + script;旧宿主保留通过 workflow 工具调用的方式)
|
|
142
|
-
- `deep-read-summarize` 技能(`skills/deep-read-summarize/SKILL.md`)
|
|
143
|
-
- 四种解析器(`parsers/`)与 JSON Schema(`schemas/`)
|
|
144
|
-
|
|
145
|
-
---
|
|
146
|
-
## 快速开始(约 5 分钟)
|
|
30
|
+
| 你提供 | 工作流尝试获取 | 你得到 |
|
|
31
|
+
| --- | --- | --- |
|
|
32
|
+
| 书籍:PDF、EPUB、MOBI | 文本和章节 | 按主题整理的阅读笔记 |
|
|
33
|
+
| 论文:arXiv、PDF、HTML | 论文正文和结构 | 研究问题、方法、结论与局限 |
|
|
34
|
+
| 视频链接 | 优先字幕;无字幕时可尝试本地转写 | 基于已取得文本的内容拆解 |
|
|
35
|
+
| 网页链接 | 页面正文 | 要点、概念和来源信息 |
|
|
147
36
|
|
|
148
|
-
|
|
37
|
+
实际提取结果取决于来源是否可访问、工具是否可用、模型和宿主权限。扫描版 PDF 通常需要先进行 OCR,工作流不内置自动 OCR;复杂公式、图表以及质量差的字幕或音频可能需要人工处理。
|
|
149
38
|
|
|
150
|
-
|
|
151
|
-
# 方式 A:npm 直接安装(无需 clone)
|
|
152
|
-
npm install deep-read-summarize
|
|
39
|
+
笔记通常包含概述、结构拆解、术语表、关键引用、批判性分析和应用思考。最终内容仍由模型生成,不同输入和配置可能产生不同结果。
|
|
153
40
|
|
|
154
|
-
|
|
155
|
-
git clone https://github.com/PensiveFei/deep-read-summarize.git
|
|
156
|
-
cd deep-read-summarize
|
|
157
|
-
npm ci # 安装锁定依赖
|
|
158
|
-
```
|
|
41
|
+
## 开始使用
|
|
159
42
|
|
|
160
|
-
###
|
|
43
|
+
### 1. 安装插件
|
|
161
44
|
|
|
162
|
-
|
|
163
|
-
node -e "console.log(require('deep-read-summarize').name)"
|
|
164
|
-
```
|
|
165
|
-
|
|
166
|
-
看到 `deep-read-summarize` 即包可正常加载。从源码开发时再运行 `npm test` 和 `npm run test:node`;测试不随 npm 包分发。
|
|
167
|
-
|
|
168
|
-
### 3. 一行命令喂入 demo 文件
|
|
45
|
+
先安装并启动一次 DSH Desktop,让它初始化桌面 profile;然后**完全退出应用**,使用 Desktop 随附的 DSH 命令安装:
|
|
169
46
|
|
|
170
47
|
```bash
|
|
171
|
-
|
|
48
|
+
dsh plugin --profile desktop add deep-read-summarize
|
|
172
49
|
```
|
|
173
50
|
|
|
174
|
-
|
|
51
|
+
安装完成后重新打开 DSH Desktop。随附命令不一定在系统 PATH 中:可使用安装目录下 `resources/runtime/cli/bin/dsh`(Windows 为 `dsh.cmd`)。界面和命令可能随宿主版本变化,详见 [DSH Desktop 官方说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/README.zh.md)。请勿在 DSH profile 目录中直接运行 `npm install` 或 `npm update`。
|
|
175
52
|
|
|
176
|
-
|
|
177
|
-
meta: deep-read-summarize
|
|
178
|
-
parsers: book, paper, video, web
|
|
179
|
-
```
|
|
53
|
+
运行精读还需要 DSH 中可用的模型和相应权限;不同来源可能需要额外工具。例如 PDF 文本提取可能需要 `pdftotext`,YouTube 字幕获取可能需要 `yt-dlp`,无字幕视频的本地转写可能需要 `uv` 和转写模型。
|
|
180
54
|
|
|
181
|
-
###
|
|
55
|
+
### 2. 发起一次精读
|
|
182
56
|
|
|
183
|
-
|
|
57
|
+
在 DSH 对话中输入,例如:
|
|
184
58
|
|
|
185
|
-
```
|
|
186
|
-
|
|
59
|
+
```text
|
|
60
|
+
请帮我精读这篇论文,并生成一份 Markdown 阅读笔记:
|
|
61
|
+
https://arxiv.org/abs/2307.09042
|
|
187
62
|
```
|
|
188
63
|
|
|
189
|
-
|
|
64
|
+
你也可以提供本地文件路径、网页或视频链接。如果需要,可以在请求中说明输出位置、希望保留的章节或是否需要时间戳。
|
|
190
65
|
|
|
191
|
-
|
|
66
|
+
支持插件工具的宿主会注册 `deep_read_summarize`;旧宿主使用插件提供的技能和 workflow 入口。精读工具返回笔记正文及建议路径,**实际写入文件需要由主代理完成**。生成后请确认文件已保存,并检查结果中是否报告内容缺口或质量问题。
|
|
192
67
|
|
|
193
|
-
|
|
194
|
-
|
|
68
|
+
<details>
|
|
69
|
+
<summary>直接调用工具的参数示例</summary>
|
|
195
70
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
```jsonc
|
|
71
|
+
```json
|
|
199
72
|
{
|
|
200
|
-
"input": "https://arxiv.org/abs/2307.09042",
|
|
201
|
-
"type": "
|
|
73
|
+
"input": "https://arxiv.org/abs/2307.09042",
|
|
74
|
+
"type": "paper",
|
|
202
75
|
"options": {
|
|
203
|
-
"
|
|
204
|
-
"
|
|
205
|
-
"maxChunks": 4, // 分块上限,1-12(默认调低,控制子代理数与耗时)
|
|
206
|
-
"transcribe": true, // 视频:无字幕时自动本地转写(faster-whisper);false 则跳过转写,见「视频」节
|
|
207
|
-
"whisperModel": "small", // 视频转写模型档位:small | base | medium
|
|
208
|
-
"language": "zh", // 视频转写语言:纯英文视频可设 "en"
|
|
209
|
-
"device": "cpu", // 转写设备:cpu(默认)| auto | cuda;auto/cuda 需自备 CUDA 运行库,失败自动回退 cpu
|
|
210
|
-
"cpuThreads": 0, // 0 保持转写库默认值;1-64 可按实际硬件调优
|
|
211
|
-
"transcriptCache": true, // 音频内容与配置一致时复用本地逐字稿;false 强制每次推理
|
|
212
|
-
"maxRetries": 0, // 质量校验重试次数(默认 0 = 不重试,重试会明显变慢)
|
|
213
|
-
"frontmatter": "obsidian", // frontmatter 键集:obsidian(默认,配 Dataview)| generic(换掉 Hugo 保留键)| minimal
|
|
214
|
-
"requireCitations": true, // 关键结论是否必须标注出处
|
|
215
|
-
"includeTimestamps": false,
|
|
216
|
-
"outputDir": "./output", // 笔记输出目录(可指向 Obsidian 仓库或静态站点内容目录)
|
|
217
|
-
"tempDir": "./.tmp" // 临时文件目录
|
|
76
|
+
"maxChunks": 4,
|
|
77
|
+
"outputDir": "./output"
|
|
218
78
|
}
|
|
219
79
|
}
|
|
220
80
|
```
|
|
221
81
|
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
| 类型 | input |
|
|
225
|
-
|------|-------|
|
|
226
|
-
| 论文 | `https://arxiv.org/abs/2307.09042` |
|
|
227
|
-
| 书籍 | 本地路径,如 `~/books/xxx.pdf` |
|
|
228
|
-
| 视频 | `https://youtube.com/watch?v=xxx` |
|
|
229
|
-
| 网页 | `https://example.com/article` |
|
|
230
|
-
|
|
231
|
-
笔记写到 `options.outputDir` 指定的目录(默认 `./output`,可指向你的 Obsidian 仓库或静态站点内容目录),文件名取自内容标题。
|
|
232
|
-
|
|
233
|
-
### frontmatter 三档(`options.frontmatter`)
|
|
234
|
-
|
|
235
|
-
默认 `obsidian`,键集与历史版本一致,标量和列表值使用安全引号。之所以要分档:`type`、`aliases`、`url` 在 Hugo 里是**保留键**,语义和 Obsidian 完全不同——直接丢进 Hugo 会改变渲染行为,而不是多几个无害字段。
|
|
236
|
-
|
|
237
|
-
| 键 | `obsidian`(默认) | `generic` | `minimal` |
|
|
238
|
-
|---|---|---|---|
|
|
239
|
-
| `title` | ✓ | ✓ | ✓ |
|
|
240
|
-
| `aliases` | ✓ | — | — |
|
|
241
|
-
| `author` / `year` | ✓ | ✓ | — |
|
|
242
|
-
| `type` | ✓ | — | — |
|
|
243
|
-
| `docType` | — | ✓ | — |
|
|
244
|
-
| `url` | ✓ | — | — |
|
|
245
|
-
| `sourceUrl` | — | ✓ | ✓ |
|
|
246
|
-
| `tags` | ✓ | ✓ | ✓ |
|
|
247
|
-
| `created` | ✓ | — | — |
|
|
248
|
-
| `date` | — | ✓ | ✓ |
|
|
249
|
-
| `status` | ✓ | ✓ | — |
|
|
250
|
-
|
|
251
|
-
为什么 `generic` 要换键:
|
|
252
|
-
|
|
253
|
-
- `type` 在 Hugo 里决定**用哪套 layout**(`type: video` 会让它去找 `layouts/video/`)
|
|
254
|
-
- `aliases` 在 Hugo 里是**一组会重定向到本页的旧 URL**
|
|
255
|
-
- `url` 在 Hugo 里会**覆盖页面自身的路径**——来源链接会变成文章的永久链接
|
|
256
|
-
- `date` 才是 Hugo/Jekyll 都认的时间键;`created` 只是自定义字段
|
|
257
|
-
|
|
258
|
-
非法值直接 FATAL 终止(与 `type` 的失败纪律一致,不静默降级)。
|
|
259
|
-
|
|
260
|
-
### 视频:完整逐字稿(字幕优先,无字幕自动转写)
|
|
261
|
-
|
|
262
|
-
视频取文本是**统一流水线**(已去掉「三档」):目标 = 拿到**完整逐字稿**再精读。
|
|
263
|
-
|
|
264
|
-
> **⚠️ 为保证精读质量,处理时间可能略长(刻意取舍,不是卡死)**:**无字幕**视频会先做一次转写(CPU 上约为视频时长的 0.5–2×)再精读,所以这类视频整体会**明显比有字幕视频慢**;换来的是**完整逐字稿 + 真正的精读**。**有字幕**视频仍是秒级。请勿把转写的较慢误判为卡死。
|
|
265
|
-
|
|
266
|
-
1. **有平台字幕**(B站官方 API 的 AI 字幕 / YouTube CC)→ **直接用字幕**(=全文,最快、零依赖)。
|
|
267
|
-
2. **无公开字幕** → 用插件自带转写 `scripts/transcribe.js`(faster-whisper small / int8 / VAD / 中文)得到全文。
|
|
268
|
-
3. 都不行 → **降级**:提示手动提供转写文本,或退回 `desc` 作背景;**绝不阻塞**。
|
|
269
|
-
|
|
270
|
-
`options.transcribe`:**默认 `true`**(无字幕自动转写);设为 `false` 则跳过转写(只用字幕/desc 或降级)。
|
|
271
|
-
|
|
272
|
-
**转写工具链**:脚本用 `uv` 创建 **Python 3.12** 环境,从清华镜像安装 **`faster-whisper==1.2.1`**,通过 `HF_ENDPOINT=https://hf-mirror.com` 下载并缓存模型。健康的缓存环境直接运行,不要求 uv 仍在 PATH,也不再启动单独的 Python 导入探测。实际解释器和依赖版本记录在缓存目录的 `runtime.json`;Python 补丁版本、uv 和传递依赖未全部锁定,不能据此声称环境逐字一致。PyAV 可直接解码音频,无需单独 ffmpeg。三平台使用同一条命令 `node scripts/transcribe.js --audio <音频> --out <txt>`,默认 CPU;`options.device: "auto"` 可尝试自备的 CUDA,失败回退 CPU。缓存目录:Windows `%LOCALAPPDATA%\deep-read-summarize`、macOS `~/Library/Caches/deep-read-summarize`、Linux `$XDG_CACHE_HOME/deep-read-summarize`(未设置时用 `~/.cache`)。创建 Python 环境默认先用镜像,失败再直连 GitHub;`DRS_UV_PYTHON_MIRROR` 可覆盖镜像,空字符串表示直连。
|
|
273
|
-
|
|
274
|
-
> ⚠️ **首次转写会先下载模型(small 约 484MB,走 hf-mirror,非 GitHub),可能需要几分钟**。之后复用模型文件;新音频仍需完整推理。同一音频命中经过校验的逐字稿缓存时,才会跳过推理。**只有「无字幕」视频才会触发转写**(有字幕的视频直接用字幕,不触发、不下载)。
|
|
275
|
-
|
|
276
|
-
**逐字稿缓存与线程**:`options.transcriptCache` 默认开启。缓存键包含音频 SHA-256、受管理的本地模型快照、已安装依赖及解码配置;存储真实分段和起止时间,切换时间戳展示不必重转写。更改内容、配置或本地模型/依赖会失效;自定义本地模型目录、无法确认环境、损坏和过期记录均跳过缓存。缓存复用本地已有快照,不在线探测模型上游是否更新。逐字稿保存在上述缓存根目录的 `transcripts-v1`,单条上限 8 MiB、总量上限 128 MiB、有效期 30 天;清理在写入时执行。它不保存音频,也不会跳过后续精读与原文核验。
|
|
277
|
-
|
|
278
|
-
`options.cpuThreads` 为 0–64 的整数,默认 `0` 保持库的 CPU 线程策略。可用同一音频对比 4/6/8 线程,线程越多不一定越快。CLI 可直接使用:
|
|
279
|
-
|
|
280
|
-
```bash
|
|
281
|
-
node scripts/transcribe.js --audio sample.m4a --out transcript.txt --cpu-threads 8
|
|
282
|
-
node scripts/transcribe.js --audio sample.m4a --out transcript.txt --refresh-cache
|
|
283
|
-
node scripts/transcribe.js --audio sample.m4a --out transcript.txt --no-cache
|
|
284
|
-
node scripts/transcribe.js --clear-cache
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
`--clear-cache` 只清理逐字稿,不删除模型或 Python 环境。`--refresh-cache` 强制推理并更新缓存,`--no-cache` 禁用读写。成功调用输出一行 `metrics` JSON,报告 `cacheHit`、实际设备、音频时长,以及哈希、环境准备、依赖安装、Python、发布和总毫秒耗时;未命中时还报告导入、模型加载、准备(含解码/VAD)与完整分段迭代耗时。缓存命中不会冒用上次推理耗时。
|
|
82
|
+
`type` 可选 `auto`、`book`、`paper`、`video` 或 `web`。显式指定类型可以跳过部分模糊输入的识别步骤。具体工具调用方式取决于 DSH 宿主;也可以直接在对话里表达需求。
|
|
288
83
|
|
|
289
|
-
|
|
84
|
+
</details>
|
|
290
85
|
|
|
291
|
-
|
|
86
|
+
## 结果能信到什么程度?
|
|
292
87
|
|
|
293
|
-
|
|
88
|
+
工作流会规范化分块范围,检查已知原文行号的覆盖情况;成稿后,程序检查格式和篇幅,并由独立核验代理读取取得的文本,检查分块覆盖与关键引文。核验结果可通过 `qualityPassed`、`qualityChecks` 和 `qualityEvidence` 查看。
|
|
294
89
|
|
|
295
|
-
|
|
90
|
+
这些检查有边界:
|
|
296
91
|
|
|
297
|
-
|
|
92
|
+
- **`qualityPassed` 不是事实正确性的证明。**覆盖和原文真实性判断仍依赖核验代理实际读取与判断;重要结论、数字和引用请自行复核。
|
|
93
|
+
- **取得全文不等于理解了全文。**复杂表格、公式、图片以及提取错误可能影响结果;来源不完整或分块失败时,结果会报告缺口。
|
|
94
|
+
- **字幕或转写不等于音频原文。**自动字幕和语音识别可能漏句、听错数字或否定词;核验笔记与逐字稿不能证明逐字稿本身准确。
|
|
95
|
+
- **视频时间戳不能凭空推算。**可定位性取决于取得的字幕或转写是否包含时间信息。
|
|
298
96
|
|
|
299
|
-
##
|
|
97
|
+
## 常用配置
|
|
300
98
|
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
- **分块结构**:不同类型分块方式不同(章节/主题/段落),影响**输出结构**与覆盖。
|
|
318
|
-
|
|
319
|
-
### 硬件
|
|
320
|
-
- **GPU vs CPU**:GPU 收益依赖显卡、运行库、模型与音频;设备可见不代表 CUDA 推理可用,应以实际耗时与文本对照为准。
|
|
321
|
-
|
|
322
|
-
### 其他
|
|
323
|
-
- **首次 vs 复用**:首次要下模型(约 484MB),之后缓存复用。
|
|
324
|
-
- **Token/成本**:分块数/篇幅/引证决定 token 消耗;`fastMode`/`maxChunks` 可省。
|
|
325
|
-
- **引用/编造**:转写或 OCR 的错词可能被当作「原文」引用,**关键引用请复核**。
|
|
326
|
-
- **边界**:纯 BGM、失真音频 → 转写空/差;无字幕且转写不可用 → 降级提示人工提供转写文本。
|
|
327
|
-
|
|
328
|
-
---
|
|
329
|
-
|
|
330
|
-
## 失败怎么处理
|
|
331
|
-
|
|
332
|
-
分两类:
|
|
333
|
-
|
|
334
|
-
- **配置错误**(缺 input、type 非法、options 格式错):直接抛异常终止,不产出半成品。
|
|
335
|
-
- **内容问题**(抓取失败、某块精读失败):返回 `{ ok: false, stage, fatal: false }`,由调用方决定。某一块失败时跳过它、在成稿里标注缺口,不整体中断。
|
|
336
|
-
|
|
337
|
-
---
|
|
338
|
-
|
|
339
|
-
## 保持质量的提速
|
|
340
|
-
|
|
341
|
-
- 支持的新宿主优先使用 `deep_read_summarize`,模型只提交参数,省去复制整份工作流脚本。旧宿主自动保留原入口。
|
|
342
|
-
- 精读仍完整覆盖已知原文,最多三个任务并发;空闲槽位立即领取下一块。按行数均衡工作量,避免一个超大块拖住整批。
|
|
343
|
-
- QC 继续独立读取原文;不再在每轮上下文中重复塞入全部 Map 笔记。缺总行数、精读失败或只有视频简介等问题不能靠改写笔记解决,不再浪费全文修订轮次。
|
|
344
|
-
- 视频 `textSource: "desc"` 明确为降级来源,不能取得完整精读的质量通过状态。B站多 P 链接按 `p` 选择对应 CID、分 P 标题和时长。
|
|
345
|
-
- 返回 `timings` 提供各阶段毫秒耗时,用同一资料、模型、篇幅和质量门槛比较;调度测试不能当成真实 LLM 加速比例。
|
|
99
|
+
| 选项 | 默认值 | 用途 |
|
|
100
|
+
| --- | --- | --- |
|
|
101
|
+
| `minWords` | `2500` | 最低篇幅要求;检查规则按中文字符和其他文字的词计算 |
|
|
102
|
+
| `fastMode` | `false` | 开启后省略批判性分析、个人应用和延伸阅读章节 |
|
|
103
|
+
| `maxChunks` | `4` | 分块数量上限,最大为 12;不是并发数 |
|
|
104
|
+
| `readConcurrency` | `3` | 精读并发上限;并发更高不一定更快 |
|
|
105
|
+
| `maxRetries` | `0` | 未通过质量检查时的修订次数;成稿成功后默认执行一次核验,不做修订 |
|
|
106
|
+
| `outputDir` | `./output` | 建议的笔记输出目录,由主代理完成写入 |
|
|
107
|
+
| `requireCitations` | `true` | 要求关键引用具备可核验的来源信息 |
|
|
108
|
+
| `includeTimestamps` | `false` | 视频笔记是否要求时间戳 |
|
|
109
|
+
| `transcribe` | `true` | 视频没有可用字幕时,尝试本地转写 |
|
|
110
|
+
| `whisperModel` / `language` | `small` / `zh` | 选择转写模型和语言;英文视频可显式指定 `en` |
|
|
111
|
+
| `device` / `cpuThreads` | `cpu` / `0` | 选择转写设备和 CPU 线程策略 |
|
|
112
|
+
| `transcriptCache` | `true` | 相同音频及匹配配置时复用已验证的转写缓存 |
|
|
113
|
+
| `parallelQuality` | `false` | 显式启用并行原文核验;默认保留原核验路径 |
|
|
114
|
+
| `readCache` | `false` | 可选的跨次精读缓存;仅插件工具入口支持 |
|
|
346
115
|
|
|
347
|
-
|
|
116
|
+
开启 `readCache` 时,还必须提供 `readCacheIdentity`,写明供应商、固定模型版本及影响输出的设置;这些信息变化时需更换身份。该身份由调用者提供,宿主无法自动验证。缓存为本地明文,可能包含原文摘录;命中后仍会执行独立原文核验。
|
|
348
117
|
|
|
349
|
-
|
|
118
|
+
其他选项包括 `frontmatter`(`obsidian`、`generic`、`minimal`)和 `tempDir`。高级选项、取值范围、转写缓存和自定义解析器可参考[完整配置与技术参考](https://github.com/PensiveFei/deep-read-summarize/blob/main/docs/README-reference.zh.md)。
|
|
350
119
|
|
|
351
|
-
|
|
120
|
+
## 时间、费用与隐私
|
|
352
121
|
|
|
353
|
-
|
|
122
|
+
- **时间**取决于内容长度、获取方式、分块数量、模型和宿主并发。没有字幕的视频需要额外转写,首次使用还可能下载转写模型。
|
|
123
|
+
- **费用**取决于你配置的模型、输入与输出量;本项目不能保证固定的耗时或费用。
|
|
124
|
+
- **隐私**:本地语音转写在本机运行,但后续精读使用你在 DSH 中配置的模型。若使用云端模型,原文、字幕、笔记或相关上下文可能发送给对应服务商;请先确认其数据处理条款。
|
|
125
|
+
- **本地文件**:临时原文、转写和可选缓存可能保存在设备上;处理敏感资料前请确认目录权限与清理方式。
|
|
354
126
|
|
|
355
|
-
|
|
127
|
+
## 出问题时
|
|
356
128
|
|
|
357
|
-
|
|
129
|
+
- **插件不可用**:确认已在正确的 DSH profile 安装、重启了桌面应用,并检查宿主版本和插件兼容信息。
|
|
130
|
+
- **获取失败或笔记缺段**:确认链接可访问、所需工具已安装;查看返回的阶段、来源状态和失败分块。
|
|
131
|
+
- **只有视频简介**:说明没有取得可确认的完整字幕或逐字稿;请检查字幕与转写条件,或提供文本。
|
|
132
|
+
- **质量检查未通过**:查看 `qualityIssues` 和 `qualityEvidence`,必要时对照原文修订;不要把未核实的笔记当作完整结论。
|
|
358
133
|
|
|
359
|
-
-
|
|
360
|
-
- 子代理写文件需要相应权限;如果权限不够,workflow 会把内容返回,由主代理负责落盘。
|
|
361
|
-
- **本地转写**:视频转写(faster-whisper)在**本机**运行,音频/字幕**不出本地**;抓取视频元数据/字幕/音频时才会向对应平台发起网络请求。
|
|
362
|
-
- 这个仓库只有流程本身:workflow 定义、解析器代码、提示词模板、schema。**不含任何受版权保护内容的提取结果。** 测试用的 fixture 是自写的公共领域寓言。用本工作流处理有版权的材料时,产出物的使用责任在你。
|
|
134
|
+
仍有问题?欢迎在 [GitHub Issues](https://github.com/PensiveFei/deep-read-summarize/issues) 提供操作系统、DSH 与插件版本、输入类型和错误信息。请先去掉密钥、私有链接和个人资料。
|
|
363
135
|
|
|
364
|
-
|
|
136
|
+
## 开发与贡献
|
|
365
137
|
|
|
366
|
-
|
|
138
|
+
源码开发请在**独立的项目目录**进行,而不是在 DSH profile 目录运行 npm:
|
|
367
139
|
|
|
368
140
|
```bash
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
npm
|
|
372
|
-
npm
|
|
141
|
+
git clone https://github.com/PensiveFei/deep-read-summarize.git
|
|
142
|
+
cd deep-read-summarize
|
|
143
|
+
npm ci
|
|
144
|
+
npm test
|
|
145
|
+
npm run test:node
|
|
146
|
+
npm run lint
|
|
147
|
+
npm run validate
|
|
373
148
|
```
|
|
374
149
|
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
改动说明见 CHANGELOG.md,贡献规范见 CONTRIBUTING.md。
|
|
378
|
-
|
|
379
|
-
---
|
|
380
|
-
|
|
381
|
-
## 兼容性
|
|
382
|
-
|
|
383
|
-
**已验证的宿主:DSH 0.2.0-rc.2**(Node 24)。本仓库的依赖面只有两处:
|
|
384
|
-
|
|
385
|
-
| 依赖面 | 现行契约 | 本仓库的用法 |
|
|
386
|
-
| --- | --- | --- |
|
|
387
|
-
| workflow 脚本钩子 | `agent()` / `pipeline()` / `parallel()` / `phase()` / `log()` / `args` | 只用了 `agent/parallel/phase/log/args`;`agent()` 选项只用 `label/phase/schema`(引擎只接受 `label/phase/schema/provider/model`,其它选项会被判为 fatal) |
|
|
388
|
-
| JSON Schema 子集 | `type / properties / required / additionalProperties / items / enum / const / oneOf` + 注解键 | 两个 `agent()` schema 已用宿主真实的 `assertObjectJsonSchema` 实测通过 |
|
|
389
|
-
|
|
390
|
-
两点容易踩的契约细节:
|
|
391
|
-
|
|
392
|
-
- **脚本沙箱没有文件系统/网络/定时器/require**——只能协调子代理;笔记落盘由主代理完成(见上文 ⚠️)。
|
|
393
|
-
- **违反上述子集不是降级而是终止**:引擎抛 `UNSUPPORTED_SCHEMA`,整条 workflow 直接失败。仓库的 `npm test` 里有对应回归(含反向断言,确保校验器不是空放行)。
|
|
150
|
+
项目使用解析器处理不同输入类型,支持自定义解析器。代码和测试见[仓库](https://github.com/PensiveFei/deep-read-summarize),版本变化见 [CHANGELOG](https://github.com/PensiveFei/deep-read-summarize/blob/main/CHANGELOG.md),贡献方式见 [CONTRIBUTING](https://github.com/PensiveFei/deep-read-summarize/blob/main/CONTRIBUTING.md)。
|
|
394
151
|
|
|
395
|
-
|
|
152
|
+
**兼容性:**本项目此前验证过 DSH `0.2.0-rc.2` 的相关宿主契约;DSH 接口可能变化,其他版本请以实际测试和兼容说明为准。
|
|
396
153
|
|
|
397
|
-
|
|
154
|
+
## 版权与声明
|
|
398
155
|
|
|
399
|
-
|
|
156
|
+
项目代码采用 [MIT License](https://github.com/PensiveFei/deep-read-summarize/blob/main/LICENSE)。示例中引用的论文、视频和短引文仍受其各自权利与授权条件约束。
|
|
400
157
|
|
|
401
|
-
|
|
158
|
+
deep-read-summarize 是独立的第三方项目,与 DeepSeek 或 DeepSeek Harness 官方没有隶属、认可或赞助关系。
|
package/cordis.patch.yml
CHANGED
|
@@ -20,6 +20,10 @@
|
|
|
20
20
|
# minWords: 2500 # minimum output length (default: 2500)
|
|
21
21
|
# fastMode: false # skip sections 5-7 for speed (default: false)
|
|
22
22
|
# maxChunks: 4 # chunk cap; also caps sub-agent count (1-12, default: 4)
|
|
23
|
+
# readConcurrency: 3 # concurrent chunk reads and reviews (1-12, default: 3)
|
|
24
|
+
# parallelQuality: false # opt in to parallel independent source review
|
|
25
|
+
# readCache: false # plugin tool only; cross-run cache is opt-in
|
|
26
|
+
# readCacheIdentity: "" # required when enabled: provider, pinned model and settings
|
|
23
27
|
# transcribe: true # video: auto-transcribe when no subtitles (default: true)
|
|
24
28
|
# requireCitations: true # key conclusions must cite source location (default: true)
|
|
25
29
|
# includeTimestamps: false # video timestamps (default: false)
|
package/docs/RELEASE.md
CHANGED
|
@@ -154,7 +154,9 @@ npm view deep-read-summarize --prefer-online # 验证线
|
|
|
154
154
|
| v0.3.18 | npm 已发布 | 修复自动解析器分流、并发临时文件串稿和分块上限导致的全文遗漏 |
|
|
155
155
|
| v0.3.19 | npm 已发布 | 修复 B04–B10,并让质量检查结合程序门禁和可回查的原文证据(O01)。 |
|
|
156
156
|
| v0.4.0 | npm 已发布 | 保留完整精读与独立原文核验,减少脚本搬运、并发空等和无效修订,并修复来源质量判断与视频分P等问题。 |
|
|
157
|
-
|
|
|
157
|
+
| v0.5.0 | npm 已发布 | 无字幕视频新增逐字稿内容缓存、转写阶段计时和 CPU 线程配置,保留默认精读与原文核验门槛。 |
|
|
158
|
+
| v0.6.0 | npm 已发布 | 新增可配置并发、字符均衡分块与可选的并行原文核验和跨次精读缓存,保留原有默认核验路径。 |
|
|
159
|
+
| **v0.6.1** | **npm 已发布(当前)** | 修复普通执行路径的结果序列化错误,避免已生成的精读笔记在返回宿主时被丢弃。 |
|
|
158
160
|
| v1.0.0 | 计划 | API 稳定后发布 |
|
|
159
161
|
|
|
160
162
|
> 早期迭代用 0.x 表达不稳定;API 稳定后再发 1.0.0。
|
package/index.js
CHANGED
|
@@ -21,6 +21,7 @@ const workflow = require('./workflow');
|
|
|
21
21
|
const parsers = require('./parsers');
|
|
22
22
|
const schemas = require('./schemas');
|
|
23
23
|
const { DEFAULT_OPTIONS, normalizeWorkflowOptions } = require('./lib/options');
|
|
24
|
+
const readCache = require('./lib/read-cache');
|
|
24
25
|
|
|
25
26
|
module.exports.name = 'deep-read-summarize';
|
|
26
27
|
module.exports.inject = ['skills'];
|
|
@@ -120,14 +121,41 @@ function readingTool(engine, defaults, registry) {
|
|
|
120
121
|
const options = normalizeWorkflowOptions(Object.assign({}, defaults, args.options));
|
|
121
122
|
if (!exec || !exec.agent) throw new Error('deep_read_summarize requires a calling agent');
|
|
122
123
|
if (exec.signal && exec.signal.aborted) throw new Error('deep_read_summarize was cancelled before start');
|
|
123
|
-
const
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
const
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
124
|
+
const startArgs = { input: args.input, type: args.type || 'auto', options: options };
|
|
125
|
+
const script = workflow.buildSelfContainedScript(registry);
|
|
126
|
+
async function runWorkflow(runArgs) {
|
|
127
|
+
const run = engine.start({ script: script, meta: workflow.meta,
|
|
128
|
+
args: runArgs, parent: exec.agent, signal: exec.signal });
|
|
129
|
+
try {
|
|
130
|
+
const result = await run.result;
|
|
131
|
+
if (result.stopReason !== 'completed') throw new Error('deep_read_summarize ' + result.stopReason + ': ' + (result.error || 'workflow did not complete'));
|
|
132
|
+
if (!result.value || typeof result.value !== 'object' || Array.isArray(result.value)) throw new Error('deep_read_summarize returned an invalid workflow result');
|
|
133
|
+
return result.value;
|
|
134
|
+
} finally { await run.dispose(); }
|
|
135
|
+
}
|
|
136
|
+
if (!options.readCache) return runWorkflow(startArgs);
|
|
137
|
+
const started = Date.now();
|
|
138
|
+
const prepared = await runWorkflow(Object.assign({}, startArgs, { __cachePrepare: true }));
|
|
139
|
+
if (!prepared.__cachePrepared) return prepared;
|
|
140
|
+
if (!Array.isArray(prepared.chunkPrompts) || !Array.isArray(prepared.chunkPlan) || prepared.chunkPrompts.length !== prepared.chunkPlan.length || prepared.chunkPrompts.length > 12 || typeof prepared.tempFile !== 'string' || typeof prepared.tempDir !== 'string' || typeof prepared.selectedType !== 'string' || !prepared.fetched || typeof prepared.fetched !== 'object') throw new Error('deep_read_summarize returned invalid cache preparation');
|
|
141
|
+
const digest = readCache.sourceHash(options.tempDir, prepared.tempDir, prepared.tempFile);
|
|
142
|
+
const keys = prepared.chunkPrompts.map(function (prompt) { return readCache.keyFor(digest, options.readCacheIdentity, prompt, prepared.tempFile); });
|
|
143
|
+
const hits = keys.map(function (key) { return key ? readCache.read(options.tempDir, key) : null; });
|
|
144
|
+
const resume = { tempDir: prepared.tempDir, selectedType: prepared.selectedType, fetched: prepared.fetched, prompts: prepared.chunkPrompts, hits: hits };
|
|
145
|
+
if (exec.signal && exec.signal.aborted) throw new Error('deep_read_summarize was cancelled before cache resume');
|
|
146
|
+
const result = await runWorkflow(Object.assign({}, startArgs, { __cacheResume: resume }));
|
|
147
|
+
// Never use notes matched against a source that changed during the run.
|
|
148
|
+
if (digest && readCache.sourceHash(options.tempDir, prepared.tempDir, prepared.tempFile) !== digest) return runWorkflow(startArgs);
|
|
149
|
+
if (!(exec.signal && exec.signal.aborted) && digest && result.qualityPassed && Array.isArray(result.__cacheReads)) {
|
|
150
|
+
for (let i = 0; i < keys.length; i++) if (keys[i] && !hits[i] && readCache.portable(result.__cacheReads[i], prepared.tempDir)) readCache.write(options.tempDir, keys[i], result.__cacheReads[i]);
|
|
151
|
+
}
|
|
152
|
+
delete result.__cacheReads;
|
|
153
|
+
if (result.timings && prepared.timings) {
|
|
154
|
+
result.timings.detect += prepared.timings.detect || 0;
|
|
155
|
+
result.timings.fetch += prepared.timings.fetch || 0;
|
|
156
|
+
result.timings.total = Date.now() - started;
|
|
157
|
+
}
|
|
158
|
+
return result;
|
|
131
159
|
}
|
|
132
160
|
};
|
|
133
161
|
}
|