知识库导读
DeepSeek Harness：源码阅读路线与章节导航
库内容概览
该教程从运行环境和 Cordis 插件框架进入 Agent 循环，再讨论模型、工具、持久化、隔离和外部接口。章节适合作为读源码的路线；实现细节仍需与对应代码版本对照。 原知识库。
本站建议阅读路线
建议先读总体架构、框架基础与核心循环，然后查看持久化和安全隔离。把教程中的文件路径映射到目标源码提交，记录章节与代码是否一致；出现差异时不要把示意代码当成当前接口。
章节入口
- README
- 01-总体架构
- 02-环境与运行
- 03-Cordis 框架基础
- 04-核心与 Agent 循环
- 05-LLM 能力
- 06-工具与数据类能力
- 07-Agent 编排
- 08-上下文与人类协作
- 09-持久化与数据平面
- 10-安全沙箱与隔离
- 11-Session 日志深度
- 12-Typert 类型图系统
- 13-Web Client 架构
- 14-API Gateway 与 SDK
- 15-凭证与授权
- 16-Webhook 与外部事件
- 17-Self-Modification 扩展
此处提供精选目录链接，未镜像全部正文。更多章节请进入原知识库。目录采集于 2026-10-05，已采集链接数量不等于已逐篇阅读数量。
建议练习与验收
针对一次工具调用，记录输入、模型请求、工具结果、取消与会话日志的关系。以模拟工具注入超时，检查状态与日志；保存提交号和测试结果，不运行不熟悉的 Shell 示例。
以上路线与练习为本站建议，尚未执行。AI 汇集文章不自动归为博主原创，授权和出处以具体原文为准。
全部条目整理
共 18 个条目：18 个有正文，0 个为目录入口。点击标题展开；可用浏览器查找定位关键词。
正文读取于 2026-10-05。摘要为主题级导读，术语根据正文提取，学习问题为本站补充；不镜像全文，不表示已完成实践，也不把汇集库内容视为博主原创。技术新闻、产品能力和性能数字需回到原始发布核验。
001 README
章节摘要：教程索引把运行环境、Agent 执行、数据保存和扩展接口串成一条阅读路线。先建立模块位置，再结合代码版本阅读细节。
关键概念：模块职责、阅读顺序、源码版本
学习问题：
- 如果只想理解一次工具调用，应该先读哪些章节？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
002 01-总体架构
章节摘要：运行时把模型、工具与会话等能力放在可替换的插件边界中。启动过程将配置转为插件树，再连接运行所需的服务。
关键概念：插件边界、Session、Profile
学习问题：
- 替换模型适配器时，哪些模块应该保持不变？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
003 02-环境与运行
章节摘要：本章从开发环境进入 CLI 启动和配置组合，讨论运行模式与退出过程。环境版本和配置覆盖顺序应对照目标提交验证。
关键概念：CLI、Profile、配置覆盖
学习问题：
- 同一配置在两台机器上表现不同，应先检查哪些输入？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
004 03-Cordis 框架基础
章节摘要：Cordis 用上下文和服务连接插件，注册行为与资源生命周期关联。不同事件派发方式决定处理顺序和扩展点的协作方式。
关键概念：Context、Service、生命周期
学习问题：
- 卸载插件后，事件监听器与它创建的资源应怎样清理？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
005 04-核心与 Agent 循环
章节摘要：Agent 的工作由回合和步骤组织，模型响应与工具结果进入执行过程。取消、作用域与状态变化共同决定一轮交互怎样结束。
关键概念：Turn、Step、Cancel
学习问题：
- 工具运行到一半收到取消信号，状态和结果应怎样记录？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
006 05-LLM 能力
章节摘要：模型服务通过适配层连接执行循环与具体提供方。流式结果、请求路由和重试属于不同职责，需分开观察失败原因。
关键概念：Provider、Adapter、流式响应
学习问题：
- 一次模型超时与适配器错误应如何区分和重试？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
007 06-工具与数据类能力
章节摘要：工具先声明和注册，再经执行管道被调用；文件、进程与网页等能力由各自插件提供。执行前后是校验与记录的重要位置。
关键概念：工具注册、Schema、执行管道
学习问题：
- 怎样验证参数错误时工具没有产生实际副作用？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
008 07-Agent 编排
章节摘要：编排层把委托、工作线程、工作流和预设连接起来。要理解协作，需同时追踪任务归属、生命周期和结果返回位置。
关键概念：Subagent、Workflow、Preset
学习问题：
- 子任务失败时，父任务怎样接收结果并决定是否继续？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
009 08-上下文与人类协作
章节摘要：用户交互、执行上下文与计划机制用于协调人工判断和自动执行。询问、批准与权限提升应有可检查的请求和回应记录。
关键概念：Approval、Question、Guard
学习问题：
- 一次拒绝能否在后续重试中被错误地当作批准？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
010 09-持久化与数据平面
章节摘要：数据平面管理会话的创建、保存、查询与压缩。读取路径和写入格式一起影响重启恢复，以及不同客户端能否看到同一状态。
关键概念：Session、持久化、Compaction
学习问题：
- 进程中断后，怎样确认会话恢复到了哪个事件？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
011 10-安全沙箱与隔离
章节摘要：隔离层限制命令可访问的资源，并提供与权限请求协作的边界。各平台后端能力不同，配置不能脱离目标操作系统理解。
关键概念：Landlock、Seatbelt、bwrap
学习问题：
- 哪些操作由操作系统隔离，哪些还依赖应用层策略？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
012 11-Session 日志深度
章节摘要：会话日志用事件序列保存交互，界面所需状态可从日志派生。重放与分叉要区分已发生事件和后续新执行。
关键概念：JSONL、Projection、Replay
学习问题：
- 日志最后一行不完整时，怎样恢复而不重复执行工具？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
013 12-Typert 类型图系统
章节摘要：类型图把源码中的类型信息带到运行时和跨模块发现过程。扩展能力时，需要协调类型生成、注册和消费方的理解。
关键概念：Typert、类型图、运行时注册
学习问题：
- 类型声明更新后，哪些缓存或生成产物需要同步？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
014 13-Web Client 架构
章节摘要：Web 客户端通过组件与插槽扩展界面，依据会话投影显示交互结果。实时连接负责传递变化，界面仍需处理断线与恢复。
关键概念：React、Slot、WebSocket
学习问题：
- 重连后如何避免界面遗漏事件或显示重复内容？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
015 14-API Gateway 与 SDK
章节摘要：网关为前端和 SDK 提供通信入口，协议与连接管理决定请求怎样匹配响应。跨语言客户端还需验证相同的错误语义。
关键概念：BFF、JSON-RPC、SDK
学习问题：
- 断线重试一个请求时，怎样避免服务端重复处理？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
016 15-凭证与授权
章节摘要：凭证能力协调配置来源、授权交互和密钥使用。阅读时需区分解析优先级、存储方式与轮换过程，避免把凭证写入日志。
关键概念：Credential、OAuth、密钥轮换
学习问题：
- 更换密钥后，已有连接和失败重试会读取哪一份凭证？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
017 16-Webhook 与外部事件
章节摘要：外部事件经验证和规则匹配后才能触发工作。事件接收、会话创建和执行结果需关联，便于检查重复投递与权限范围。
关键概念：Webhook、签名验证、可信规则
学习问题：
- 相同事件被投递两次，怎样做到可追踪且不重复执行？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
018 17-Self-Modification 扩展
章节摘要：实验性自修改能力让运行时检查并调整插件配置。安装、卸载和热重载改变能力边界，需要观察失败回滚及权限约束。
关键概念：插件自省、热重载、回滚
学习问题：
- 插件安装失败后，如何证明旧能力仍可正常工作？
- 如何用对应源码、测试或运行日志验证本章的理解？
来源署名：云栖梦泽 · MiniDocs。具体实现以原文及对应代码版本为准。
摘要用于辅助阅读，原文观点以原文为准。实验与问题是建议练习，不代表 determine 已完成相关工作。
评论与交流
评论管理 ↗