← 返回列表
需源码安装
文档状态： 当前中文 README 仅提供简要概览，内容可能滞后于英文版。pre-1.0 阶段请以 English…
暂不能直接安装（需源码编译或环境不满足）：仓库缺少 package.json，无法用 dsh 插件安装命令安装。 · 最近上游提交 2026/9/18 · 已提供中文文档
一个用于长期运行、面向插件的 Rust 应用程序的类型化运行时——生命周期、精确的服务放置、类型化事件、确定性清理、作用域和隔离。
综合分
52.2
GitHub 分
52.2
用户评分
—
★ Stars
50
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add dshbox/cordis-rs仓库缺少 package.json，无法用 dsh 插件安装命令安装，改用 GitHub 源安装
🟢实装验证通过· 2026/9/19
由 dsh-plugin-verify（GitHub Actions）在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/18（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包cordis-rs（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
仓库缺少 package.json，无法用 dsh 插件安装命令安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 08:25:44
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
Cordis
文档状态： 当前中文 README 仅提供简要概览，内容可能滞后于英文版。pre-1.0 阶段请以 English README 为准；接近 1.0 时会再进行一次完整同步。
Cordis v3 是面向长期运行、插件化 Rust 应用的类型化 runtime。它把 Plugin/FiberHandle 生命周期、Service 依赖、类型化 Event、资源清理，以及显式隔离边界放进同一套模型中。
当前状态
Cordis v3 现已成为默认 main 主线。现有 0.6.x 实现保留在 legacy/0.6 维护分支，只接受关键 bug 和安全修复。
安装
普通应用继续使用历史 package/import identity：
[dependencies]
cordis-rs = "0.8"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
use cordis::Context;
cordis-rs 在 v3 中是很薄的 facade，真正的 runtime contract 位于：
cordis-core = "0.3"
框架和第三方 Plugin 作者可以直接依赖 cordis-core。时间与声明式加载能力保持独立：
cordis-timer = "0.3"
cordis-loader = "0.3"
v3 使用 Rust 2024 Edition，MSRV 为 Rust 1.88。
v3 的核心模型
- Context：同一个 Runtime 上的轻量不可变视图。
- Plugin：可复用行为；prepare() 在生命周期准入之前完成输入准备。
- FiberHandle：一个已准入非 root Fiber 的生命周期控制 handle。
- Service / ServiceRealm：Service 解析到精确 realm slot，不存在隐式 fallback。
- Event / Scope：Event routing 与 Service isolation 是相互独立的 Context axes。
- generation 拥有 cleanup；Runtime/Registry 拥有 Fiber residency。
- update 保持 Fiber identity；era swap 会终止旧 Fiber 并创建新的 identity。
完整模型请阅读英文 README.md 和
docs/v3-architecture.md；1.0 readiness 与 exit criteria
见 ROADMAP.md。
从 0.6.x 迁移
cordis-rs 0.8.x 是当前 application-facing v3 发布线；v3 runtime architecture 最初在 0.7.x 发布。这不是 0.6.x 的 source-compatible 升级。迁移入口：
- MIGRATION.md：面向现有用户的迁移说明。
- docs/v3-migration.md：更详细的架构迁移 inventory。
- docs/v3-public-interface.md：v3 public interface authority。
Crate
| Crate | 角色 |
|---|---|
| cordis-rs | 应用 facade，继续提供 use cordis::... |
| cordis-core | canonical runtime contract |
| cordis-timer | generation-owned sleep / interval / timeout |
| cordis-loader | immutable load plans 与 typed target resolution |
License
MIT。项目延续 Cordis lineage；版权声明见 LICENSE。扫码进群