DeepSeek Harness 学习手册 第 11 / 11 章 总目录 单页全本 架构图 GitHub

手册/第 11 章

11

延伸阅读:按「你想搞清楚什么」排序

dsh 有 4,763 篇 Markdown。按目录读会迷路,按问题读不会。 下面每一行都是「一个问题 → 一篇文档」,路径都相对仓库根目录。

六条最短路径

你想搞清楚读这篇大概要多久
整体架构与「新行为放哪」docs/architecture.md20 分钟,必读
Cordis 那套插件/作用域怎么运作docs/cordis-primer.md15 分钟,读代码前必读
一次 turn 的完整生命周期docs/agent-lifecycle.md15 分钟
工具调用到底经过哪些环节docs/tool-execution-pipeline.md10 分钟
某个事件谁发谁收docs/event-producer-consumer.md查表,随时
六个 seam 的全景图docs/capability-seams.md10 分钟

按角色读

A我只想用它
README.md → docs/user/guide/index.md → SAFETY.md(务必读)。 不需要碰架构文档。
B我要写插件
docs/user/develop/basic/index.md(第一个插件)→ docs/cordis-primer.md → docs/cookbook/extension-cookbook.md → 按需看 adding-a-tool.md / adding-an-llm-adapter.md。
C我要改内核
docs/architecture.md 全文 → docs/cordis-primer.md → docs/subsystems/core.md → packages/core/agent-loop/README.md(那里写了实现顺序)。
D我要做发行版/桌面端
docs/architecture.md 的 Profiles and bundles → packages/boot/app-boot/README.md → docs/cli-help.md(patch / profile / plugin 子命令)。

百科式入口

文件它是什么
docs/config-catalog.md生成的配置字段目录(写 patch 时查字段用)
docs/cli-help.md完整的启动器/子命令/出厂 profile 帮助
docs/subsystems/*.md分子系统深挖:core、tools、session、subagent、agent-team、conversation、working-directory…
docs/cordis-tutorial/index.md把 primer 的概念动手做一遍
docs/development.md开发流程、构建目标、Web/Desktop 命令表
AGENTS.md给 agent 读的仓库约定(如果你让 agent 帮你改 dsh)

外部链接

读完这本手册之后

如果你只记三件事,记这三条:

  1. dsh 是一棵组合出来的树。没有特权核心,改行为 = 换提供者或挂监听,不是打补丁。
  2. 日志是唯一真相。模型可见的东西必须被记录;格式有代际,已发布文件不可变。
  3. 扩展之前先分诊。持久事实 → Session 事件;在飞的活儿 → Agent 事件;策略 → Capability 事件或 seam。

剩下的都是细节,而细节都在 docs/architecture.md 里,且写得比大多数项目都清楚。

docs/cookbook/extension-cookbook.md docs/event-producer-consumer.md docs/capability-seams.md

本章学习记录

记录仅保存在当前浏览器。