Files
eip4-platform/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md

216 lines
8.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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-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 门禁 |