目录

• 再看第1步，最小应用 —— 创建 Context 与事件程序初体验
• 第2步这方面，事件程序进阶 —— once / parallel / serial / bail / waterfall
• 第3步这方面，服务—— 在 Context 上挂载命名 API
• 至于第4步，插件—— 函数式 / 对象式 / 类插件三种形态
• 再看第5步，依赖注入 —— inject 声明、ctx.inject 与 @Inject 装饰器
• 说到第6步。生命周期 —— Fiber、清理函数与 ctx.effect
• 第7步这方面，配置程序 —— Config 校验与热重载
• 第8步的观点是，日志服务 —— 内置 logger 与 exporter
• 第9步的观点是，上下文作用域 —— extend 与 isolate 隔离域
• 第10步这方面，完整应用 —— 动态插件管理的计算器应用

说到第1步，最小应用 —— 创建 Context 与事件程序初体验

Cordis 的一切都从 Context开始。Context 是一个代理对象，充当整个应用的依赖容器与事件总线。直接 new 即可创建，内置的日志、事件、插件注册等服务会随构造自动安装。

// step1.ts —— 最小 Cordis 应用
import * as Cordis from '@deepseek-ai/cordis'
// 创建根上下文
const ctx = new Cordis.Context
// 声明自定义事件的类型
declare module '@deepseek-ai/cordis' {
interface Events {
'app/ready': void
'user/login': void
}
}
// 注册事件监听器
ctx.on => {
console.log
})
ctx.on => {
console.log
})
// 广播事件
ctx.emit
ctx.emit

触发后没有回调执行怎么办？

- 确认已正确声明 Event 接口，否则 TypeScript 会报错但运行仍无回调；- 检查是否在同一 Fiber 上下文中执行 emit 与 on；- 如果使用异步监听器，请确保返回 Promise 并在 await 后看日志。

 已就绪！使用者 张三 登录了

• Context 可直接 new，无需工厂函数。
• // declare module …{ interface Events {…}}: 声明合并，实现类型安全。
• .on: 返回注销函数，可主动取消监听。

至于第2步。事件程序进阶 —— once / parallel / serial / bail / waterfall

Cordis 的事件总线支持多种分发策略，覆盖从简单通知到管道加工的全部场景。

// step2.ts —— 五种事件分发策略
import * as Cordis from '@deepseek-ai/cordis'
const ctx = new Cordis.Context
declare module '@deepseek-ai/cordis' {
interface Events {
'app/tick': void
// bail 场景：返回是否放行；undefined 表示“不表态”
'app/permission': boolean | undefined
// waterfall 场景
'app/transform' => string): string
}
}
// ========== . once ：只触发一次 ==========
let count = ctx.once => {
count++
console.log
})
ctx.emit // 第一次触发
ctx.emit // 不再触发
// ========== . parallel ：并发等待所有异步监听器 ==========
ctx.on => {
await new Promise)
console.log
})
ctx.on => {
console.log
})
await ctx.parallel
// ========== . bail ：依次调用，遇到首个“有效返回值”即停止 ==========
ctx.on => { console.log;return undefined })
ctx.on => { console.log;return true })
ctx.on => { console.log;return false })
const allowed = ctx.bail
console.log
// ========== . waterfall ：链式管道 ==========
ctx.on => `${next}`)
const result = ctx.waterfall
console.log

• bail 中 false/null 未视为 “未表态” - 确认业务逻辑中只用 true 表示放行；否则会继续往下走，
• wf 下不调用 next 会否决整条链 - 常见错误是忘记返回值导致整个流水线中断。
• alert 未触发时请检查 event 名称拼写及声明合并是否生效 - 无法捕获错误时先确认 Event 接口声明无误。按理说，

要点这方面。

可 bail 有顺序依赖处理链  

策略	语义
emit	同步广播 忽略返回值简单通知
parallel	并行执行 await 全部异步副作用收集
serial
	首个有效返回值即停止权限拦截、协商取值

  

END OF EXAMPLE.

Thank you for reading!

Happy coding with Cordis!老实说，

---