为 dsh 的重要文档写的中文导读：它讲什么、为什么重要、怎么读。导读不是翻译，读完请一定点原文。
第一次接触 dsh，从这里开始。
理解 dsh 的设计与运行时。
dsh 的灵魂文档：Cordis 插件树、profile/bundle 组合机制、核心包与事件分类。
docs/architecture.md
读 dsh 任何源码前的前置知识：插件、context、依赖注入、类型化事件、可逆 effect。
docs/cordis-primer.md
一次对话回合内部发生了什么：收件箱、pre-step 瀑布、持久事实与活体状态的双轨设计。
docs/agent-lifecycle.md
从模型吐出 tool-call 到结果落账，dsh 如何用 pre/execute/post 三段瀑布插入策略、沙箱与审批。
docs/tool-execution-pipeline.md
一张生成图看懂服务声明方、实现方、消费方的关系——「换实现」在 dsh 里意味着什么。
docs/capability-seams.md
值得抄走的开发流程与治理机制。
跑起来、用起来、反馈与安全。