Audit Ledger · 2026-10

内容审计

对象：runoob DeepSeek Harness 教程的全部 33 个章节。状态、影响范围、严重程度、优先级与依据逐条列出；无法确证的内容标为「存疑待核实」。

结论：教程整体与当前 0.2.x 预览版一致，没有 P0 级硬错误。主要风险不在「写错」，而在「写的是会变的」：版本要求、模型名、benchmark 与发布时间需要逐条核实。

29仍然成立

0表述过时

1建议补充

3存疑待核实

01优先处理

按「会不会让你照抄出错」排序
优先级	问题	为什么先处理
P2	1.2 安装：四条路线怎么选	npm 包存在（0.2.1-rc.5），但 npm 元数据未声明 engines；Node 24.9+ 与「Node 22 不再支持」需以官方安装页为准。
P2	2.5 多模态：图片输入与视觉模型	视觉模型名、单图 token 上限与 benchmark 数字无法独立确证；以 DeepSeek 官方模型页与 API 文档为准。
P2	2.6 四种运行模式：标准 / PTC / 极简 / 创造	「2026 年 8 月开源」等时间与 PTC 并行上限来自教程，未在公开元数据中确证；以官方发布说明为准。

02台账（33 节全覆盖）

状态口径：仍然成立 / 表述过时 / 建议补充 / 存疑待核实。没有证据的「感觉旧」不写成过时。

按本站阅读顺序排列；链接指向原文
#	章节	状态	影响范围	严重度	优先级	依据 / 说明
1	Agent = Model + Harness	仍然成立	概念定位	低	—	与 npm 0.2.1-rc.5、PyPI 0.2.1rc2 的预览状态一致；MIT 许可已在 npm 元数据核对。
2	安装：四条路线怎么选	存疑待核实	版本要求	中	P2	npm 包存在（0.2.1-rc.5），但 npm 元数据未声明 engines；Node 24.9+ 与「Node 22 不再支持」需以官方安装页为准。
3	桌面版：先用只读任务验收	仍然成立	产品使用	低	—	平台与安装包信息来自教程；具体界面与审批行为会随预览版变化，以官网为准。
4	第一次 Web UI：从启动到只读任务	仍然成立	上手流程	低	—	端口、工作区与权限说明与教程一致；具体 UI 文案可能随版本变化。
5	模型配置：官方、目录与自定义端点	仍然成立	配置	低	—	提供方类型与存储路径来自教程；模型列表与可用模型以当前端点返回为准。
6	Python SDK：把 Agent 放进程序	仍然成立	SDK 集成	低	—	PyPI 包存在（0.2.1rc2，requires Python >=3.10）；API 细节以 `deepseek_harness` 当前类型为准。
7	插件：查找、安装、验证	仍然成立	插件管理	低	—	安装命令与验证思路与教程一致；索引源与插件市场状态会变化。
8	自动化任务：会话级提醒	仍然成立	功能边界	低	—	调度规则与投递语义来自教程；具体保留窗口与 UI 以当前版本为准。
9	多模态：图片输入与视觉模型	存疑待核实	模型与计费	中	P2	视觉模型名、单图 token 上限与 benchmark 数字无法独立确证；以 DeepSeek 官方模型页与 API 文档为准。
10	四种运行模式：标准 / PTC / 极简 / 创造	存疑待核实	发布信息	低	P2	「2026 年 8 月开源」等时间与 PTC 并行上限来自教程，未在公开元数据中确证；以官方发布说明为准。
11	第一个插件：apply(ctx) 与三种形态	仍然成立	插件基础	低	—	与教程及官方事故复盘 0001 的描述一致。
12	加载本地插件：cordis.yml + --patch	仍然成立	插件加载	低	—	路径与 patch 行为来自教程；不同版本的 Loader 报错文案可能不同。
13	自动清理：ctx.effect 与资源账本	仍然成立	插件资源	低	—	清理机制与异步处置器行为来自教程；具体 disposer 调度以 Cordis 当前实现为准。
14	声明依赖：inject 与可选服务	仍然成立	依赖机制	低	—	必需/可选依赖与服务消失行为与教程一致。
15	第一个工具：defineTool	仍然成立	工具开发	低	—	defineTool 字段与行为来自教程；复杂 schema 能力以 `@deepseek-ai/dsh-tools` 类型为准。
16	插件配置：Config 与 Schemastery	仍然成立	配置	低	—	Config/schema 约定与 HMR 行为来自教程。
17	生命周期：Fiber 状态机	仍然成立	生命周期	低	—	状态机与清理顺序来自教程；Cordis 后续版本可能增加状态。
18	依赖驱动加载与嵌套上下文	仍然成立	加载机制	低	—	依赖驱动与子上下文行为来自教程；重载语义以 Cordis 当前实现为准。
19	服务与依赖：Service 基类	仍然成立	服务机制	低	—	Service 基类与声明合并来自教程；内置服务清单以仓库生成文档为准。
20	服务隔离、scope 与工具过滤	仍然成立	多 Agent 隔离	中	—	隔离与 scope 语义来自教程；lineage 字段与 restriction 行为以当前版本为准。
21	事件系统：五种分发模式	建议补充	事件语义	低	P2	教程自己指出官方文档把 waterfall 标为「不 await」，但示例普遍 await；建议补充一段明确的版本差异说明。
22	能力三角色：Definition / Provider / Consumer	仍然成立	架构	低	—	三角色划分与 Bash 示例来自教程；具体包名以当前仓库为准。
23	实战：写一个可替换的能力	仍然成立	能力拆分	低	—	代码骨架与包结构来自教程；类型导入路径以当前仓库为准。
24	LLM 适配器：接入任意模型	仍然成立	模型接入	中	—	适配器骨架与字段表来自教程；具体类型以 `@deepseek-ai/dsh-llm` 为准。
25	StreamChunk 协议与错误处理	仍然成立	协议	中	—	五条规则与错误处理来自教程；分片字段以 `@deepseek-ai/dsh-llm` 类型为准。
26	组合包 bundle 与 profile	仍然成立	打包	低	—	manifest 键与目录结构来自教程；字段以当前 dsh CLI 为准。
27	安装插件与配置加载顺序	仍然成立	配置	中	—	四层顺序与按行替换来自教程；具体输出格式以当前 CLI 为准。
28	发布插件：npm、tarball 与 Git	仍然成立	分发	中	—	三种方式与 allowBuilds 流程来自教程；pnpm 版本行为以官方文档为准。
29	工具执行流水线与权限门禁	仍然成立	权限	高	—	流水线顺序与决策类型来自教程；钩子 API 以当前 dsh-tools 类型为准。
30	沙箱与审批：失败关闭	仍然成立	安全边界	高	—	沙箱模式、enforcement 与审批结果来自教程；平台差异以官方安全文档为准。
31	会话日志与轮次生命周期	仍然成立	可观测性	高	—	会话事件与投影规则来自教程；事件字段以当前 SessionEvent 类型为准。
32	防御性编程：五个边界模式	仍然成立	稳定性	高	—	五个模式与示例来自教程；原文标题拼写为「DeeSeek」，本站更正为 DeepSeek。
33	事故复盘与工程文化	仍然成立	工程文化	中	—	四问、四个案例与测试分层来自教程；原文标题拼写为「DeeSeek」，本站更正。

03审计方法与依据

抓取原文 34 个页面，提取正文与代码块，逐节核对「安装命令、版本要求、模型名、API 名、统计数字」。
可独立核对的事实：npm 包 @deepseek-ai/dsh 当前 latest 为 0.2.1-rc.5，license 为 MIT；PyPI 包 deepseek-harness-sdk 为 0.2.1rc2，要求 Python >= 3.10；GitHub 仓库可访问。
无法独立核对的事实：Node 24.9 硬性要求（npm 元数据未声明 engines）、视觉模型名与 384 token 上限、Opus-4.8 对比与 benchmark 数字、开源月份。
原文标题里有两处「DeeSeek」拼写错误（第 33、34 章对应的 slug），本站正文已更正，链接仍指向原页。

04建议的更新顺序

1.2 已将 Node 版本要求标为「待核实」，补充 node -v 检查方法；后续仍需核对所选版本的官方安装文档。
2.5 已在正文展开模型名、token 与对比数字的待核实说明，并标出既有审计日期；补齐官方证据后再更新结论。
在 4.3 明确 waterfall 的 await 差异：官方文档说「不 await」，示例普遍 await，读代码时以类型签名为准。