Cordis

Cordis 是什么

Cordis 是一个用 TypeScript 编写的元框架（Meta-Framework），其核心理念是「时空可组合性（Spatiotemporal Composability）」。它并不直接提供业务能力，而是定义了一套让模块、插件、依赖与生命周期能够被动态组合、替换和卸载的底层模型。

项目由 Koishi 生态的作者主导，配套论文《A Programming Paradigm for Spatiotemporal Composability》已在 arXiv 发布，官方入门文档为 cordis-primer。

注意：Cordis 仍处于活跃开发阶段，API 尚未稳定，可能在不通知的情况下发生变化。

核心概念

时空可组合性

传统框架中，模块的加载顺序、依赖关系和生命周期往往是静态绑定的。Cordis 试图把「时间维度」（何时加载、何时卸载、何时生效）与「空间维度」（模块之间的依赖与作用域）统一到一个可组合的模型中，使应用像积木一样可以随时拼装和拆解。

插件与依赖注入

Cordis 以插件为基本单元，通过统一的依赖注入机制管理插件之间的引用关系。插件可以声明自己需要什么、提供什么，框架负责在合适的时机完成装配。

// 概念示意：插件声明依赖与提供的能力
ctx.plugin(MyPlugin, { /* 配置 */ })

Effect 体系

仓库 Topics 中包含 effect，说明 Cordis 借鉴了 Effect 式的副作用管理思路，把资源获取与释放、异步任务的生命周期纳入统一调度，避免插件卸载后残留副作用。

适用与不适用

适合：

• 需要热插拔、动态扩展能力的 Node.js 服务
• 自研框架、工具链或桌面应用的底层内核
• 对插件架构、依赖注入、Effect 系统感兴趣的研究型开发者

不太适合：

• 追求开箱即用、文档完备的快速业务开发
• 无法接受 API 频繁变动的生产环境

上手建议

1. 先阅读 arXiv 论文与 cordis-primer，理解「时空可组合性」的设计动机。
2. 从最小插件示例入手，观察插件的加载与卸载行为。
3. 关注仓库的更新节奏，锁定版本后再用于正式项目。