Files
eip4-platform/docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md
zhengwr 624ffe8a15 docs: 06-21 进度文档对齐 + P0/P1 实施记录
- 新建 项目进度与路线-总览-2026-06-21(取代06-17版),刷新A/B矩阵+增量交付+下一步+§9实施记录
- README 索引刷新到06-21;旧总览+14份过时/已完成文档加状态横幅;落地路线图回写里程碑

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 13:56:14 +08:00

6.5 KiB
Raw Permalink Blame History

📌 现状以总览为准(2026-06-21):本文系修订前快照,P3 等进度表述前后不一致(P3-1「进行中」vs P3-2/P4/P5「第一版完成」);AI 确定性五环生产线已合 main。以 总览-2026-06-21 B2 + AI_AGENT_Nocobase_ADOPTION_PLAN.md 为准。

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.json checksum 和发布门禁,不写任何环境。
  • 新增 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_PLAN JSON,包含 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
  • AI employee registry
  • ACL/scope check
  • 生产写默认阻断

第一版已落地:

  • AiToolRegistry 注册工具、操作入口、所需 scope、本地限定和生产写边界。
  • GET /api/ai/tools 返回 AI 工具注册表。
  • GET /api/ai/employees 返回 AI employee 定义。
  • POST /api/ai/tools/access-check 只做权限判定,不执行工具;local.apply 等本地工具在 prod target 会被阻断。
  • 当前所有工具都不允许生产写;线上部署仍由人工拿发布包执行。
  • Skills CLI check/update
  • AI Agent 权限和审计
  • MCP 工具白名单