手册/第 11 章
11
延伸阅读:按「你想搞清楚什么」排序
dsh 有 4,763 篇 Markdown。按目录读会迷路,按问题读不会。 下面每一行都是「一个问题 → 一篇文档」,路径都相对仓库根目录。
六条最短路径
| 你想搞清楚 | 读这篇 | 大概要多久 |
|---|---|---|
| 整体架构与「新行为放哪」 | docs/architecture.md | 20 分钟,必读 |
| Cordis 那套插件/作用域怎么运作 | docs/cordis-primer.md | 15 分钟,读代码前必读 |
| 一次 turn 的完整生命周期 | docs/agent-lifecycle.md | 15 分钟 |
| 工具调用到底经过哪些环节 | docs/tool-execution-pipeline.md | 10 分钟 |
| 某个事件谁发谁收 | docs/event-producer-consumer.md | 查表,随时 |
| 六个 seam 的全景图 | docs/capability-seams.md | 10 分钟 |
按角色读
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) |
外部链接
- 文档站:deepseek-harness.github.io
- Cordis 仓库:cordiverse/cordis
- 范式论文:A Programming Paradigm for Spatiotemporal Composability(arXiv 2608.25512)
- Discord:DeepSeek Harness community
- 插件发现:给仓库打
dsh-plugintopic
读完这本手册之后
如果你只记三件事,记这三条:
- dsh 是一棵组合出来的树。没有特权核心,改行为 = 换提供者或挂监听,不是打补丁。
- 日志是唯一真相。模型可见的东西必须被记录;格式有代际,已发布文件不可变。
- 扩展之前先分诊。持久事实 → Session 事件;在飞的活儿 → Agent 事件;策略 → Capability 事件或 seam。
剩下的都是细节,而细节都在 docs/architecture.md 里,且写得比大多数项目都清楚。
docs/cookbook/extension-cookbook.md docs/event-producer-consumer.md docs/capability-seams.md