5.6 KiB
5.6 KiB
NocoBase 源码级对照和 EIP4 修订
日期:2026-06-17
本文件补充 docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md 的源码级依据。结论:EIP4 不照搬 NocoBase 的 TypeScript 插件运行时,但 P3 之后必须参考它的 CLI/env/revision/skills/tool-registry 边界,否则容易只做出“HTTP wrapper”,做不到可持续的 Agent 开发体系。
一、已抽样源码
| 主题 | NocoBase 源码 | 对 EIP4 的影响 |
|---|---|---|
| CLI env status | packages/core/cli/src/commands/env/status.ts |
CLI 要有 env registry/current env/status,不应只靠 --base-url |
| 跨 env 确认 | packages/core/cli/src/lib/env-guard.ts |
显式选择非当前 env 时需要确认边界 |
| API client | packages/core/cli/src/lib/api-client.ts |
CLI 请求应带结构化 env/token/role/header,后续不能散落在命令里 |
| runtime command registry | packages/core/cli/src/generated/command-registry.ts |
可根据运行时 API 生成命令,EIP4 后续可用 OpenAPI 生成安全 CLI |
| generic resource command | packages/core/cli/src/lib/resource-command.ts |
CRUD 类命令应统一处理 JSON body、分页、过滤、错误输出 |
| plugin import/enable | packages/core/cli/src/commands/plugin/import.ts, packages/core/cli/src/commands/plugin/enable.ts |
EIP4 的 FeaturePackage 后续也要区分导入、启用、发布和重启/刷新 |
| revision create | packages/core/cli/src/commands/revision/create.ts |
revision 不能只是保存 JSON,发布前要检查版本控制能力是否可用 |
| skills install | packages/core/cli/src/commands/skills/install.ts |
Skills 应由 CLI 安装/检查/更新,而不是只放仓库文档 |
| AI plugin server | packages/plugins/@nocobase/plugin-ai/src/server/plugin.ts |
AI 功能要注册 tools、skills、MCP、AI employees、ACL snippet |
| FlowEngine | packages/core/flow-engine/src/flowEngine.ts, packages/core/flow-engine/src/models/flowModel.tsx |
页面 schema 需要演进到 typed model/action/event/resource registry |
二、对当前实现的校正
P0-P2 是否做实
已做实:
platform-ai主链路有 Java 实现、JDBC/内存 store、DDL、Web API 和测试。platform-cli是可运行 jar,不是伪命令。FeaturePackage和Revision已有最小持久化模型。
但它还不是 NocoBase 级完整度:
- CLI 之前缺少 env registry/current env。
- revision 只是功能包快照,不是完整版本控制。
- Skills 只是仓库文档,没有 CLI 安装/检查/更新。
- AI tools/permissions/MCP/AI employee 还没有平台级注册。
- 页面配置还没有 typed FlowModel registry。
已按源码对照修订的 P3 第一批
platform-cli新增本地 env registry,默认保存到~/.eip4/eip4-cli.json。- 新增
eip4 env add/list/use/current/status。 - AI 命令支持
--env。 - 显式选择非当前 env 时必须加
--yes,避免误操作共享环境。 - 新增
eip4 release verify --package-file FILE,离线检查功能包是否具备本地门禁 evidence、人审标记、SQL/rollback,并阻断${...}占位符。 - 新增
eip4 release export --package-file FILE --output FILE,将功能包封装为.eip4pkg.json,包含格式版本和 SHA-256 checksum。 - 新增
eip4 release import-preview --package-file FILE,离线验证.eip4pkg.jsonchecksum 和发布门禁,不写任何环境。 - 新增
eip4 release diff --left FILE --right FILE,离线比较两个功能包或.eip4pkg.json的标识、SQL、rollback SQL 和 manifest 差异。 - 新增
eip4 release rollback-plan --package-file FILE --output FILE,只生成结构化回滚计划,不执行生产写入。
三、后续实现顺序
P3-1:CLI env 和发布前治理
状态:进行中。
目标:
- env registry/current env
release verify- package/revision 差异检查
- 生产环境默认只读
P3-2:FeaturePackage 导出/导入
状态:第一版完成。
目标:
.eip4pkg.json文件格式- checksum
- import preview
- import 后不自动启用
第一版已落地:
- export: 普通 feature package JSON ->
.eip4pkg.json信封。 - import-preview: 校验 format/version/checksum/payload 和 release gate。
- import-preview 只读,不落库、不启用、不发布。
P3-3:Revision diff/restore
状态:第一版完成。
目标:
- revision diff
- rollback plan
- rollback 只生成计划和 SQL,不默认执行生产写入
第一版已落地:
- diff: 比较两个普通 feature package JSON 或
.eip4pkg.json,支持 checksum 校验和 JSON 输出。 - rollback-plan: 生成
EIP4_ROLLBACK_PLANJSON,包含 package/task/changeSet、rollback SQL、source evidence 和人审要求。 - rollback-plan 会阻断 rollback SQL 中的
${...}占位符;命令不连接环境、不落库、不执行 SQL。
P4:Typed UI Registry
状态:第一版完成。
目标:
- typed page schema
- component/action/event registry
- AI 只能选择 registry 中允许的组件和动作
第一版已落地:
PageComponentRegistry提供页面组件能力表,当前覆盖 page/crud/form/operation/button、常用 layout/display 和字段组件。TypedPageSchemaValidator校验根节点、已注册组件和 actionType 能力。GET /api/page/schema/components返回组件能力表。POST /api/page/schema/validate离线校验页面 schema,不写库。PUT /api/page/schema/{templateId}/overlay保存前会先跑 typed schema 校验,未注册组件或不支持 action 会被 400 阻断。
P5:AI tools/skills/employee/ACL
目标:
- AI tool registry
- Skills CLI check/update
- AI Agent 权限和审计
- MCP 工具白名单