Koishi

Koishi是基于Node.js的QQ机器人开发框架，支持多平台

Cordis框架脱胎于JavaScript生态中同名的服务容器库，原用于聊天机器人框架Koishi

Cordis 是一个通用的依赖注入与插件容器框架，最初在 Koishi 生态中发展成熟，后被 DeepSeek Harness 采用作为底层运行时

Koishi的核心设计理念是「没有内核，一切都是插件」

Koishi官方自带约195个内置插件，涵盖工具、LLM接入、适配器、会话管理、WebUI以及沙箱等功能模块

Koishi插件由四个核心结构组成：name（名字）、inject（依赖）、Config（配置）、apply（入口）

apply是Koishi插件的唯一执行入口，核心逻辑都写在其中，通常包含tools.register之类的注册方法

Koishi定义了六种主要运行状态：pending（未就绪，依赖未满足）、loading（apply执行中）、active（已加载活跃）、failed（报错失败）、unloading（正在卸载）、disposed（已移除）

Koishi提供三种服务注入方式：硬依赖（inject）、context.get（运行时按需获取）、context.inject（特定上下文注入）

Koishi的realm服务隔离规则是：发布服务的行必须进realm，只消费服务的行必须留在realm之外

Koishi提供四种资源清理方式：context.on、context.effect、context.setTimeout、context.setInterval

context.on绑定事件监听时需配合next保证中间件链正确传递

Koishi的配置采用四层分层组织：bundle层、profile层、home层、codespatch

Koishi区分host（进程式，进程级配置写在profile的codespatch）和agent/preset（会话式，配置写在home文件夹的agent preset目录）两个运行平面

Koishi的preset预设发布线上包必须使用裸包名表示，本地引用则需写绝对路径（也支持相对路径）

在Koishi插件中，描述（description）字段是模型进行判断的依据，决定了插件能否被模型正确识别和调用

Koishi UI界面操作背后经历四层加载：模块加载层、单元层（unit，Context构造）、挂载层（将插件patch到系统）、端到端层（真正消耗模型API）

Koishi插件的发布流程为：在package.json写好仓库URL、keywords、export等元信息，执行npm publish --access public推送到npm，使用者通过命令安装

Cordis是一个面向JavaScript/TypeScript生态的控制反转（IoC）容器与插件管理框架，最初在Koishi聊天机器人框架中得到大规模实践验证

Cordis是源自Koishi跨平台聊天机器人框架的通用插件运行时系统，设计哲学受微内核操作系统思想影响