文章目录1. 项目概述1.1 什么是 Cordis1.2 项目状态1.3 适用场景1.4 设计哲学1.5 Deepseek Harness与Cordis的关系2. 快速开始2.1 环境要求2.2 安装2.3 最简示例2.4 使用脚手架创建项目2.5 项目结构2.6 使用 CLI 启动3. 核心概念：Context（上下文）3.1 什么是 Context3.2 创建 Context3.3 Context 的 Proxy 机制3.4 Context 扩展（extend）3.5 Context 隔离（isolate）共享标签（Shared Label）3.6 Context 拦截（intercept）3.7 Context 的内置属性4. 核心概念：Service（服务）4.1 什么是 Service4.2 Service 基类4.3 创建一个 Service4.4 Service 的初始化与清理4.5 声明依赖（inject）带配置的依赖注入使用 @Inject 装饰器4.6 提供服务（provide）与设置服务（set）4.7 函数式服务（Callable Service）4.8 Service 的 filter 机制5. 核心概念：Plugin（插件）5.1 什么是 Plugin5.2 函数式插件5.3 对象式插件5.4 类式插件（Service 插件）5.5 插件的配置验证5.6 插件的加载与卸载5.7 嵌套插件5.8 命令式注入（ctx.inject）6. 核心概念：Fiber（纤程）6.1 什么是 Fiber6.2 Fiber 状态机6.3 状态转换PENDING → LOADING → ACTIVEACTIVE → UNLOADING → PENDINGFAILED 状态DISPOSED 状态6.4 惯性锁（Inertia Lock）6.5 Fiber 的核心属性6.6 Fiber 的核心方法await()restart()update(config, noSave?)getEffects()6.7 根 Fiber7. 核心概念：Events（事件系统）7.1 事件系统概述7.2 监听事件监听选项7.3 五种派发模式1. emit（同步发射）2. parallel（异步并行）3. serial（异步串行）4. bail（同步拦截）5. waterfall（瀑布流）7.4 事件与上下文过滤7.5 内置事件8. 核心概念：Effect（副作用管理）8.1 什么是 Effect8.2 基本用法8.3 四种 Effect 形式1. 同步函数返回清理函数2. Generator（生成器）3. 异步函数返回清理函数4. 异步生成器（Async Generator）8.4 Effect 的执行机制8.5 自动逆序清理8.6 Effect 元数据与调试8.7 非活动上下文保护9. 项目架构全景9.1 Monorepo 结构9.2 各包职责9.3 核心架构图9.4 核心设计模式10. 技术栈与构建工具10.1 编程语言与运行时10.2 构建工具链10.3 测试框架1. 项目概述1.1 什么是 CordisCordis 是一个**“时空可组合性元框架”（Meta-Framework of Spatiotemporal Composability）**。它不是一个传统意义上的 Web 框架或应用框架，而是一个提供了插件系统、依赖注入、生命周期管理、事件系统等基础能力的底层框架，用于构建高度可组合、可扩展的应用系统。项目官方定义：“A Meta-Framework of Spatiotemporal Composability”Cordis 的核心理念来自其同名学术论文《A Programming Paradigm for Spatiotemporal Composability》，该论文提出了一种新的编程范式，关注时间维度（生命周期管理）和空间维度（上下文隔离）的可组合性。1.2 项目状态当前版本：v4.0.0-rc.81.3 适用场景Cordis 适合构建以下类型的应用：插件化架构的应用：需要支持第三方插件扩展的系统模块化应用：模块之间有复杂依赖关系，需要动态加载/卸载