用依赖图组织能力,用一致的生命周期管理资源。
一套 Plugin 模型,既能打包固定的插件清单,也能在运行时接入新的插件来源,并可按需启用管理界面。
Pluxel 从 Cordis v3 与 Koishi 的 Plugin 实践出发,延续 Context、生命周期和副作用回收的核心直觉,并重新设计依赖身份、构建验证与运行时边界。
| 任务 | 入口 |
|---|---|
| 创建并运行应用 | 快速开始 |
| 修改已有应用或插件 | 开发指南:源码定位、在线操作与隔离回归 |
| 查公开包和 import | Package 矩阵 |
| 修改框架内部 | 工程索引:职责、约束、实现与验证 |
| 提交变更 | 贡献指南:环境、检查、changelog 与 PR |
Coding agent 从 AGENTS.md 按任务选读。公开用法维护在 docs/,框架内部约束维护在 engineering/;package README 补充本包操作和源码入口。
应用通过 defineHostApplication(factory) 声明 Plugin catalog、可选动态 sources 和服务。Vite 开发与生产构建消费同一声明;加入 catalog 不等于自动启动,运行策略由 Host 管理。
Plugin 通过 constructor 声明必需依赖,框架负责依赖图、启停与 generation 资源清理。配置由 schema 描述,HTTP、持久化等服务由 Host 明确选择。Workbench 可选,业务能力不依赖管理界面。
Pluxel 的公开版本线从
1.0.0开始。安装版本和公开 API 请以所用版本的文档及 npm registry 为准。
Pluxel 以 GNU Affero General Public License v3.0(AGPL-3.0-only)开源。