Files
eip4-platform/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md

8.1 KiB
Raw Blame History

AI Agent 借鉴 NocoBase 的落地路线

日期:2026-06-17

本文记录 EIP4 对 NocoBase AI + no-code 体系的可借鉴点和落地顺序。目标不是照搬 NocoBase 的 TypeScript 插件运行时,而是吸收它的工程边界:核心平台稳定、业务能力包化、AI 通过受控 CLI/API 操作、所有变更可审计、可验证、可回滚。

参考:

一、判断

NocoBase 最核心的启发是:AI 不应该默认直接写一堆业务代码,而是基于平台已有的可配置能力工作。AI 负责把自然语言需求转换为数据模型、页面配置、工作流、权限和发布包,人负责审核关键边界。

EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署包这些受控对象,因此更适合走“AI 操作元数据和发布包”的路线,而不是引入一套新的插件运行时。

二、可借鉴点

NocoBase 做法 EIP4 对应落点 处理方式
AI 基于 no-code 基础设施工作 platform-ai 生成实体/页面/服务流/菜单草稿 已落地,继续收敛到受控接口
CLI 作为 Agent 操作入口 platform-cli P1 建立,后续扩展环境/发布/回滚
Skills 让 Agent 理解平台 docs/skills/ P1 建立规范骨架
插件生命周期 EIP4 FeaturePackage 生命周期 P2 设计和持久化
版本控制/里程碑回滚 SYS_AI_REVISION / release evidence P2-P3
FlowEngine 的可配置模型 EIP4 typed page schema + component registry P4 借鉴思想,不照搬实现

三、落地顺序

P0:全自动开发主链路

状态:已完成。

完成内容:

  • POST /api/ai/features/auto-develop
  • 草稿生成、变更包、release plan、本地 apply、smoke、自动修复、人工部署包
  • JDBC 审计和运行证据
  • 本地 jar 验证通过

验收标准:

  • 本地可从一段功能需求生成可审核部署包
  • 线上执行仍停在人审边界

P1:受控入口和 Agent 知识包

状态:第一版完成。

目标:

  • 建立 platform-cli,让 Agent 通过命令调用 EIP4,而不是直接猜 HTTP 接口或直连数据库。
  • 建立 docs/skills/,把 EIP4 的环境管理、自动开发、发布管理写成 Agent 可复用的操作规程。

本阶段交付:

  • eip4 env status
  • eip4 ai auto-develop
  • docs/skills/eip4-env-manage.md
  • docs/skills/eip4-ai-feature-development.md
  • docs/skills/eip4-release-manage.md

验收标准:

  • CLI 单测覆盖命令解析和请求组装
  • README 和自动开发文档给出 CLI 用法
  • Agent 后续操作优先引用 Skills 和 CLI

P2:FeaturePackage 和里程碑版本

状态:第一版完成。

目标:

  • 把 AI 生成结果从松散的 draft/change-set 升级为稳定的 FeaturePackage。
  • 保存里程碑版本,支持本地回滚和线上部署前差异确认。

建议对象:

  • FeaturePackage: manifest、entity、serviceflow、page schema、menu、acl、sql、rollback、smoke、evidence
  • SYS_AI_FEATURE_PACKAGE
  • SYS_AI_REVISION

验收标准:

  • 一个功能包可以导出、导入、重复校验
  • 每个通过 smoke 的里程碑都能追溯输入、输出、测试证据和回滚脚本

第一版已落地:

  • POST /api/ai/tasks/{taskId}/change-sets/{changeSetId}/feature-package
  • GET /api/ai/tasks/{taskId}/feature-packages
  • POST /api/ai/tasks/{taskId}/feature-packages/{packageId}/revisions
  • GET /api/ai/tasks/{taskId}/revisions
  • eip4 ai feature-package
  • eip4 ai revision
  • sys_ai_feature_package
  • sys_ai_revision

未完成项:

  • 功能包导出/导入文件格式
  • revision 差异比较
  • 回滚执行编排

P3:发布、回滚和环境治理

状态:进行中。

目标:

  • CLI 扩展为环境管理和发布编排入口。
  • 建立本地、测试、生产环境的只读探测、部署前检查和人工批准边界。

建议命令:

  • eip4 env list/use/status
  • eip4 release package
  • eip4 release verify
  • eip4 release apply --require-approval
  • eip4 release rollback-plan --package-file FILE --output FILE

验收标准:

  • 默认不能连接线上执行写操作
  • 生产写操作必须有显式环境、审批标记和部署包
  • 发布失败能用结构化 evidence 回到本地修复链路

源码级修订:

  • 参考 NocoBase env/status.ts 和 env-guard.ts,platform-cli 新增本地 env registry/current env。
  • 参考 NocoBase revision 创建前检查版本控制插件的思路,EIP4 后续 revision restore/diff 不能只依赖 JSON 快照,必须有发布系统能力检查。
  • 新增 eip4 release verify --package-file FILE,先做离线发布前门禁,阻断未替换占位符和缺失本地 evidence 的功能包。
  • 新增 eip4 release export/import-preview,形成 .eip4pkg.json 文件格式和 checksum 门禁;导入预览不写环境、不启用功能。
  • 新增 eip4 release diff/rollback-plan,先落地离线差异检查和计划型回滚;回滚计划不执行生产 SQL。
  • 详细源码对照见 docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md。

P4:Typed Page Schema 和组件注册表

状态:第一版完成。

目标:

  • 借鉴 NocoBase FlowEngine 的“可配置模型”思想,把页面 block、field、action、linkage 抽象为 typed schema。
  • 让 AI 和人工设计器操作同一份 schema。

验收标准:

  • 页面 schema 有版本、类型、组件能力表和校验器
  • AI 只能选择注册过的组件和动作
  • 设计器变更和 AI 变更能互相接续

第一版已落地:

  • GET /api/page/schema/components 下发组件能力表。
  • POST /api/page/schema/validate 做 typed page schema 离线校验。
  • PUT /api/page/schema/{templateId}/overlay 保存 overlay 前强制校验组件和 actionType。
  • 当前仍是第一版 registry;后续要继续补 linkage/event/resource 和组件属性级 schema。

P5:多 Agent 协作和 AI 员工

状态:第一版完成。

目标:

  • 在平台内提供面向业务用户的 AI 助手能力,而不只是在开发侧使用 Agent。

建议方向:

  • 数据分析 Agent
  • 表单配置 Agent
  • 服务流诊断 Agent
  • 权限风险审查 Agent
  • 发布审计 Agent

验收标准:

  • 每个 Agent 有独立权限、审计、工具白名单
  • 业务侧操作和开发侧操作共用平台审计模型

第一版已落地:

  • GET /api/ai/tools 下发工具注册表和 scope 要求。
  • GET /api/ai/employees 下发 AI employee 定义。
  • POST /api/ai/tools/access-check 统一检查 employee/tool/scope/targetEnv/productionWrite。
  • 生产写默认阻断;当前只开放本地开发、校验、smoke、功能包和发布准备工具。

四、不照搬的部分

NocoBase 是 TypeScript/Yarn workspace/插件包体系。EIP4 是 Java/Spring/Maven,并且必须兼容 EIP3 的实体、服务流和 XML 模板迁移路径。直接照搬 NocoBase 插件运行时会引入过高迁移成本。

EIP4 应该借鉴的是边界和流程:

  1. 稳定核心能力。
  2. 业务功能包化。
  3. Agent 通过 CLI/API 操作。
  4. 人审控制生产变更。
  5. 每一步有 evidence、版本和回滚。

五、当前推进状态

阶段 状态 说明
P0 完成 platform-ai 主链路已提交
P1 第一版完成 已新增 platform-cli 和 Skills 规范骨架
P2 第一版完成 已新增功能包快照、里程碑 revision、CLI 命令和持久化表
P3 进行中 已完成 env registry/current env/cross-env guard/release verify/export/import-preview/diff/rollback-plan 第一版
P4 第一版完成 已新增组件 registry、typed schema validator、校验 API 和 overlay 保存前门禁
P5 第一版完成 已新增 AI tool registry、AI employee registry 和 access-check 门禁