# AI Agent 借鉴 NocoBase 的落地路线 日期:2026-06-17 本文记录 EIP4 对 NocoBase AI + no-code 体系的可借鉴点和落地顺序。目标不是照搬 NocoBase 的 TypeScript 插件运行时,而是吸收它的工程边界:核心平台稳定、业务能力包化、AI 通过受控 CLI/API 操作、所有变更可审计、可验证、可回滚。 参考: - NocoBase README: https://github.com/nocobase/nocobase - NocoBase Plugin Development: https://docs.nocobase.com/plugin-development/ - NocoBase Project Structure: https://docs.nocobase.com/plugin-development/project-structure - NocoBase AI Builder: https://docs.nocobase.com/ai-builder/ - NocoBase AI Plugin Development: https://docs.nocobase.com/ai-dev/ - NocoBase CLI: https://docs.nocobase.com/api/cli/ - NocoBase Skills: https://github.com/nocobase/skills ## 一、判断 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 --package-id` 验收标准: - 默认不能连接线上执行写操作 - 生产写操作必须有显式环境、审批标记和部署包 - 发布失败能用结构化 evidence 回到本地修复链路 ### P4:Typed Page Schema 和组件注册表 目标: - 借鉴 NocoBase FlowEngine 的“可配置模型”思想,把页面 block、field、action、linkage 抽象为 typed schema。 - 让 AI 和人工设计器操作同一份 schema。 验收标准: - 页面 schema 有版本、类型、组件能力表和校验器 - AI 只能选择注册过的组件和动作 - 设计器变更和 AI 变更能互相接续 ### P5:多 Agent 协作和 AI 员工 目标: - 在平台内提供面向业务用户的 AI 助手能力,而不只是在开发侧使用 Agent。 建议方向: - 数据分析 Agent - 表单配置 Agent - 服务流诊断 Agent - 权限风险审查 Agent - 发布审计 Agent 验收标准: - 每个 Agent 有独立权限、审计、工具白名单 - 业务侧操作和开发侧操作共用平台审计模型 ## 四、不照搬的部分 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 | 待开始 | 依赖 P2 的功能包和版本模型 | | P4 | 待开始 | 依赖页面 schema 现状清理 | | P5 | 待开始 | 依赖权限、审计、工具白名单成熟 |