术语速查
| 术语 | 本教程定义 |
|---|
| Agent | 带状态、能力和驱动接口的活跃智能体实例 |
| Harness | 连接模型、环境、状态、策略、UI 的宿主运行时 |
| Context | Cordis 的 scoped service / event / lifecycle 容器 |
| Service | 以稳定 ctx.key 暴露的能力契约或实现 |
| Effect | 带 disposer、可随插件卸载撤销的注册/副作用 |
| Turn | 从领取输入到系统再次无欠账工作的完整轮次 |
| Step | 一次 LLM 请求及其工具调用阶段 |
| Seam | 可替换能力边界，通常含 Definition/Provider/Consumer |
| Projection | 从 append-only log 派生的当前视图 |
| Profile | 部署/用户级插件组合 |
| Bundle | 可分发的 Cordis 配置层 |
事件分类记忆法
| 模式 | 适合 |
|---|
| emit | 通知，监听者不决定结果 |
| parallel | 多个监听者都要 await，但彼此无顺序 |
| serial | 按注册顺序做有序检查 |
| waterfall | 改写/包装/短路请求与执行 |
官方源码索引
版本提醒：DSH 官方标记为 developer preview，master 快速变化。学习时把本教程当成架构地图，并始终对照你实际 checkout 的 README、类型与测试；不要依赖某个函数名永久不变。