cordiverse/cordis

项目介绍

Cordis 是一个围绕「时空可组合性」构建的 TypeScript 元框架。插件在运行中的应用里加载，也可以在运行期间被替换或重新配置。仓库标签是 effect、framework、nodejs、plugin，核心思路是把控制反转容器放进运行时，让正在跑的程序能在自身运行过程中换掉下面的代码。

作者明确说明项目处于活跃开发中，API 尚未稳定，可能在不通知的情况下变化。配套论文《A Programming Paradigm for Spatiotemporal Composability》已发布在 arXiv，论文仓库见 paper repository。

它适合需要让插件在不重启宿主的情况下加载、分版本和重新配置的 Node.js 开发者，也适合研究运行时 IoC 设计的读者。

快速使用

README 没有给出安装命令、包名或最小可运行示例，因此无法据现有材料复现一条完整的上手流程。缺少的部分包括：如何安装依赖、如何设置入口、如何注册第一个插件。

官方文档入口是仍在建设中的 cordis-primer，可以先去那里查看当前的安装和 API 说明。仓库本身适合用来找源码和示例，因为 README 只是简短的介绍页，不是使用指南。

使用约束

• API 不稳定：README 明说 API 可能随时变化，实际依赖时应当锁定版本，并为破坏性变更做准备。
• 文档尚不成熟：官方文档被描述为仍在建设，部分行为可能需要直接读源码确认。
• 运行环境：设计面向 Node.js 插件架构和运行时 IoC（见仓库标签），不是通用的 UI 或应用框架。
• 插件版本问题：一位 HN 评论者提到，两个插件依赖同一插件的不同版本时可能出现类似「dll hell」的问题（讨论），插件较多的部署值得对照设计核实。
• 许可证：MIT。

HotRepo 点评

项目在 2026 年 8 月中旬进入 GitHub 全部语言日榜，8 月 15 至 18 日分别新增 616、719、959 和 957 Star；2026 年 11 月 5 日又出现在 TypeScript 日榜第 9 位，当日新增 55 Star。8 月 13 日的 HN 讨论只有 2 分和 1 条评论，Star 增长并没有在讨论量上得到对应体现。

目前唯一有实质内容的 HN 评论认可把 IoC 放进运行时的思路，认为它适合由智能体在运行中的系统下改代码的场景，但指出插件版本冲突可能是薄弱点（评论）。考虑到 API 不稳定、文档未完成，Cordis 目前更适合从源码层面评估，而不是作为稳定依赖采用；仅有的一次 TypeScript 榜单记录也不足以判断持续趋势。