当需要给 DeepSeek Harness 写插件、调试插件…

# Cordis 生命周期排查：ctx 未注入问题

一、核心原因排查（按概率排序）

1. 插件导出方式错误（最常见）

• Cordis 要求入口是可调用对象（函数或 class），且第一个参数接收 Context
• 检查 package.json 的 main/exports 是否指向正确的编译产物
• 要点：ctx 是通过 apply(ctx, options) 注入的，如果你导出的是普通对象或没有用 export default，框架无法调用，ctx 自然为 undefined

2. 忘记注入服务依赖

• 拦截 deepseek-chat 这类服务，需要在插件声明中显式注入对应服务名
• 若该服务在你的插件加载时尚未注册，ctx 中对应字段不存在
• 方案：使用 ctx.inject(['服务名']) 声明依赖，让 Cordis 自动延迟到服务就绪后再激活插件

3. 流式响应的拦截时机不对

• 流式响应（SSE/chunk）通常在请求发出前处理，而非响应完成后
• 建议监听的事件钩子：服务发出请求前的 before-send 类钩子，或直接包装该服务的请求方法
• 注意：某些平台适配器对 chunk 分片，你的前缀应加在首帧或合并后的文本上，否则会重复拼接

二、快速自查清单

• [ ] 入口是否为 export default (ctx, config) => {...} 或 class 形式
• [ ] 是否声明了 inject 依赖
• [ ] package.json 的 name、main 字段是否正确，Koishi/Cordis 系对命名有约定
• [ ] 是否在控制台看到插件加载日志（如无，说明根本没被调用）
• [ ] 是否混用了不同大版本的 API（如 Cordis 3/4 的生命周期方法名有差异）

三、调试建议

• 在 apply 函数第一行加 ctx.logger('插件名').info('loaded') 确认是否被调用
• 打印 Object.keys(ctx) 查看实际注入了哪些服务
• 用官方脚手架生成的模板做最小复现，逐段对比你的代码

如方便，可贴出插件入口文件，我可进一步定位具体写法问题。