Cordis 内核到底在管什么？五要素我带你看源码

. 地图：把 dsh 拆开，Cordis 在哪一层

dsh 是个 monorepo。仓库根 package.json 名字是 @deepseek-ai/dsh-root版本 -rc.workspaces 字段把 /vendor/* /packages/*/* /apps/* 都包进来。Cordis 并不在 /packages/ 下而是被 vendor 进来的第三方微内核：

@deepseek-ai/dsh-root v0.-rc.
├── vendor/cordis @deepseek-ai/cordis v4.
├── vendor/* cosmokit 等其他被 vendor 的依赖
└── packages/* dsh 应用层 

痛点： 如果你误以为 Cordis 就是 dsh 内部的一部分。就会导致依赖管理混乱——它是一个独立 npm 包，只是被 dsh 锁进了

. Plugin：能力注册的入口

Cordis 并不发明新东西，一个插件就是“挂了 ctx 的对象”。至于挂载有两条路，

• 类方法：继承 Service。构造时自动注册，
• 对象方法：{ inject?,apply }，inject 声明依赖；apply 在收到 ctx 时执行。其实，

两种方法最终都会走到 ctx.reflect.provide。而 provide 本身是在 fiber.effect 里执行的。

如果你直接在构造函数里写副作用。而忘记包装进 fiber.effect，卸载时就会泄漏资源。其实，

. Context：稳定键的共享仓库

Context 是一个 Proxy。公开接口如下：

// context.ts:
export interface Context {
: Dict // 隔离表：服务名 → 作用域标签
: Dict // 拦截表：服务名 → per‑plugin 配置
再看root，this // 根 ctx
baseUrl?: string
再看events，EventsService // 事件总线
logger的观点是，LoggerService // 命名 logger
reflect: ReflectService // 反射层
registry: RegistryService // 插件注册
}

只有上述键是 Cordis 内置的。其它如 ctx.tools、ctx.llm、ctx.fs 等都需通过 ctx.provide 等注入，否则访问会得到 

. Service：可被替换的具体能力

Service 是一个极薄的抽象壳，它把所有重量委托给 reflect.provide。说到关键钩子包括，

• : 决定该实例在哪个隔离作用域里生效。
• : 自动从父 ctx 链上收集 intercept 配置。并按 root→head 合并，为 Trajectory 不变量提供物理保障。
• : 支持子类继承时仍能。

. Typed Events：种分发策略与陷阱

AWS dispatch modes:

emit '广播'
同步派发，忽略返回值； 适合日志、统计等无副作用需求。若监听器抛错，则全链路停止。

parallel '并行'
Promise.allSettled；所有监听器并行跑，不关心返回值或错误；适合互相独立且无顺序需求的场景。

serial '串行 await' await 串行，首个 bail 值停止后续；适合需要按顺序处理且可能短路的情况。

bail '同步 bail' 同步派发，一旦遇到非 null/false/

waterfall '中间件式' 每个监听器拿到。若不调用 next 就否决整条链；实现拦截器语义，类似 Express/Koa，但完全同步，无 Promise 链依赖。

on：仅在 ACTIVE 状态下允许注册，否则抛错！这防止了插件初始化期间意外绑定事件导致未预期行为。若忘记检查状态，在插件热更新或多线程环境下易产生竞态条件。

*注意* ：使用 emit 时请确保所有监听器均无副作用或异常，否则将全链路崩溃；使用 serial/bail 时请确认返回值符合 bail 判断规则，否则可能永远不会触发接下来逻辑。

. Effects：可逆副作用与资源管理之道

主要 ：每一次 effect 都必须通过 ctx.fiber.effect 注册，以保证卸载时能自动逆向清理。不遵循此约束会导致 setInterval/fs.watch 等泄漏！ 细节* ：父 effect 收集子 effect 的 disposer，形成树结构；卸载时采用 LIFO 顺序撤销，从叶子往根递归，从而避免资源交叉污染和竞争死锁.* 容错 ：任何 disposer 抛错都会被捕获并记录至 logger.error。却不影响其它 disposer 的执行，保证卸载过程尽量完整。*