# EIP4 对照 NocoBase 的 AI Agent 接入差距与补齐计划 日期:2026-06-22 本文回答一个具体问题:**外部 coding agent(Claude Code / Codex / Cursor / OpenCode)接入平台做开发这件事,EIP4 和 NocoBase 现在差在哪、要补什么。** 口径限定:只谈「外部 agent 驱动确定性开发」这条线(EIP4 称 ①面)。平台内置生成式 LLM(②面)受对外承诺红线约束,单列在「四、不做的部分」,本文不展开。 前序文档: - `AI_AGENT_Nocobase_ADOPTION_PLAN.md`(2026-06-17 借鉴路线,P0–P5) - `AI_AGENT_Nocobase_SOURCE_REVIEW.md`(2026-06-17 源码级对照) - 本文是上述两份在「接入体验」维度的增量,已对齐 NocoBase 2026 现状(AI employees 加 Skills、新增 MCP server plugin)。 NocoBase 参考: - AI Builder:https://docs.nocobase.com/ai-builder/ - Skills 仓库:https://github.com/nocobase/skills - AI Employees / MCP:https://docs.nocobase.com/ai-employees/ ,https://docs.nocobase.com/ai-employees/features/mcp - LLM Service:https://v2.docs.nocobase.com/ai-employees/features/llm-service --- ## 一、一句话结论 EIP4 和 NocoBase 的**核心判断一致**:AI 不从零生成代码,而是在已过生产验证的 no-code 底座上操作元数据/页面/流程,人审控制生产变更。EIP4 ①面 v1 已交付、骨架完整;**差距全在「接入体验」而非「架构方向」**:NocoBase 把接入做成了一键安装 + 标准 MCP 协议,EIP4 还停在「手动喂 md + agent 死记 CLI」。补齐这层,EIP4 的外部 agent 接入即可达到 NocoBase 同等顺滑度。 --- ## 二、现状对照(带证据) ### EIP4 已有的接入资产(基线) | 资产 | 证据 | 状态 | |---|---|---| | 确定性生成主链路 | `platform-ai/.../service/AiFeatureDraftGenerator.java`、`AiAgentService.java`、`AiLocalReleaseExecutor.java` | ✅ 已合 main | | CLI(可运行 jar) | `platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar`;命令族 `env` / `ai` / `release` | ✅ | | Skills 规程 | `docs/skills/`:`README.md` + `eip4-env-manage` + `eip4-ai-feature-development` + `eip4-release-manage` | ⚠️ 仅 4 个,且只是仓库文档 | | REST API | `/api/ai/*`、`/api/design/*`、`/api/meta/*`、`/api/page/schema/{components,validate,overlay}` | ✅ | | Typed schema 门禁 | `POST /api/page/schema/validate`、overlay 保存前强制校验 | ✅ | | AI 工具/权限注册表 | `GET /api/ai/tools`、`/api/ai/employees`、`POST /api/ai/tools/access-check` | ✅(注册表层,非运行时调度)| | 人审红线 | `AiDeploymentPackage.requiresHumanApproval=true`、状态恒 `READY_FOR_HUMAN_REVIEW` | ✅ | | 版本/回滚 | `eip4 ai revision`、`eip4 release rollback-plan`(只生成计划不执行)| ✅ | ### EIP4 CLI 命令清单(核实自 `Eip4Cli.java`) ``` eip4 env add | list | use | current | status eip4 ai auto-develop | feature-package | revision eip4 release diff | export | import-preview | rollback-plan | verify ``` **注意:没有 `init`,也没有 `skills install/check/update`。** 这是和 NocoBase 的关键体验差。 ### 逐项对照 | 维度 | NocoBase(2026 现状) | EIP4(现状) | 差距 | |---|---|---|---| | 核心理念:AI 在 no-code 底座工作、不从零生成 | ✅ | ✅ | 无(同源)| | 外部 agent 接入门槛 | `nb init --ui` **自动安装 ~13 个 Skills**,`cd && claude` 直连 | 需人工把 `docs/skills/*.md` 复制/引用给 agent | **大** → G1 | | Skills 覆盖面 | ~13:env / data-modeling / ui-builder / workflow / acl / plugin-manage / publish / revision / plugin-dev / data-analysis … | 4:env / ai-feature / release | **中** → G3 | | Skills 安装与校验 | CLI 安装/检查/更新(`skills install`)| 无,纯仓库文档 | 中 → G3 | | MCP server(外部 AI 用标准协议操作平台)| ✅ 已有 MCP server plugin(2026 新增)| ❌ 仅 `AiArtifactType.java:6` 一行注释 | **大** → G2 | | CLI 命令族 | `nb` env/pm/revision/publish | `eip4` env/ai/release | 小(基本对齐)| | 人审确认 | Skill Permission(Ask / Allow)| `READY_FOR_HUMAN_REVIEW` + `requiresHumanApproval` | 无(机制等价)| | 版本/回滚 | `nb revision` | `eip4 ai revision` / `release rollback-plan` | 无 | | 端口/连接配置一致性 | `nb init` 引导写入 | skills 文档写 `8084`,实际环境跑 `8093/8094` | **小但扎手** → G1 | | 内置 LLM / AI employees(②面)| ✅ 接 OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama | ❌ 刻意不做(repair 钩子默认关)| 受红线约束 → 见「四」| --- ## 三、补齐计划(按对外接入体验优先级) ### G1 — 一键接入体验(P0,最快见效)✅ 已完成(2026-06-22) **问题**:接入要人工搬运 md + agent 不知道端口,第一步就劝退。 **做什么**: 1. 新增 `eip4 init`(或独立脚本 `scripts/install-skills.sh`),把 `docs/skills/*.md` 安装到各 agent 能自动读取的位置: - Claude Code:`.claude/skills/`(或写入项目 `CLAUDE.md` 引用块) - Codex:项目根 `AGENTS.md` - OpenCode:其 agent 规则/上下文目录 2. 安装时把 skills 里的 `--base-url` 占位符**用当前 env registry 的 current env 渲染**(解决 `8084` vs `8093/8094` 不一致)。 3. 安装完打印「下一步:`cd && claude`」引导,对齐 NocoBase 体验。 **验收**: - 一条命令后,新开 Claude Code 会话能识别 `eip4-ai-feature-development` skill,并据此跑通 `eip4 ai auto-develop` 产出 `READY_FOR_HUMAN_REVIEW` 包。 - skills 文档内端口与实际启动端口一致,agent 不再连错。 **成本**:小(1 个 CLI 子命令 + 文本渲染 + 端口统一)。 **落地(2026-06-22)**:`eip4 init` 已实现于 `platform-cli`(`Eip4Cli.runInit`),TDD 4 个新测试 + 原有共 19 单测全绿。配套:`docs/skills/*.md` 的 base URL 改为 `{{EIP4_BASE_URL}}` 占位符;新增 `platform-cli/src/main/resources/eip4-skills/manifest.json`(skill 清单 + name/description);`pom.xml` 用 maven-resources-plugin 把 `docs/skills` 打进 jar。真实 jar 端到端验证通过:`init` 产出 `.claude/skills//SKILL.md`(带 frontmatter)+ 根 `AGENTS.md`(`EIP4-SKILLS` 标记块,块外内容保留、可重复执行,且**内嵌每个 skill 渲染后全文**——Claude Code 用 `.claude/skills/` 原生 skill,Codex/OpenCode 读 `AGENTS.md` 即得完整规程,三工具全覆盖),base URL 按 `--base-url`/`--env`/current env 渲染,零占位符残留。skills 随 jar 打包,`init` 默认从 classpath 读取,无需仓库在场。 ### G2 — MCP server(P1,接入面标准化)✅ 已完成(2026-06-22) **问题**:现在 agent 要靠 skill 文档「死记」CLI/REST 用法;NocoBase 已用 MCP 把能力做成可发现、可调用的标准工具。 **做什么**:起一个 **EIP4 MCP server** 最小骨架,把已有端点包成 MCP tools(stdio + streamable HTTP 两种 transport,对齐 NocoBase): - `eip4.auto_develop` → `POST /api/ai/features/auto-develop` - `eip4.list_page_recipes` → `GET /api/ai/page-recipes` - `eip4.validate_page_schema` → `POST /api/page/schema/validate` - `eip4.list_components` → `GET /api/page/schema/components` - `eip4.access_check` → `POST /api/ai/tools/access-check` - (只读)`eip4.list_entities` / `eip4.entity_attributes` → `/api/meta/*` 红线沿用:所有写工具走本地 env;生产写默认阻断;产物恒 `READY_FOR_HUMAN_REVIEW`。MCP 工具粒度 1:1 复用现有 `AiToolRegistry` 的 scope 与 `access-check`,不新开权限面。 **验收**: - Claude Code / Codex 通过 MCP 连上后 `list tools` 能看到上述 eip4 工具。 - 通过 MCP 调 `eip4.auto_develop` 能产出待人审部署包,证据与 CLI 路径一致。 **成本**:中(一个独立 server 进程;建议先 stdio + 复用 REST,不重写业务)。 **落地(2026-06-22)**:新增 `platform-mcp` 模块(stdio MCP server,MCP Java SDK 1.1.0 / jackson2 路线)。`McpServer.sync(StdioServerTransportProvider).tools(...).build()`,注册 7 个工具:`eip4_auto_develop / list_page_recipes / validate_page_schema / list_components / access_check / list_entities / entity_attributes`,忠实转发 EIP4 REST,复用人审红线、不另开权限面。工具逻辑 TDD(`Eip4McpTools` 9 单测,注入 mock REST client);真实 stdio JSON-RPC e2e 通过:`initialize` 协商 + `tools/list` 返回 7 工具(inputSchema 正确解析)+ `tools/call` 链路(死端口优雅 isError)。坑:父 pom 为 amis 校验钉死 `networknt:json-schema-validator:1.5.2`,与 MCP 需要的 `2.0.0`(含 `dialect.Dialects`)冲突 → 在 platform-mcp 显式覆盖 2.0.0(仅本模块)。接入:`claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url `。 ### G3 — Skills 覆盖面 + 安装/检查(P1)✅ 基本完成(2026-06-22,serviceflow 诊断暂缓) **问题**:4 个 skill 覆盖不到「建模/选 recipe/权限/服务流诊断」等高频动作,agent 仍要猜。 **做什么**: 1. 补 skills(对标 NocoBase 但只覆盖 EIP4 真实能力,不照搬不存在的功能): - `eip4-data-modeling`(建实体/字段/引用列,映射 `/api/meta/entity`) - `eip4-page-recipe`(三种 recipe:maintenance-crud-v1 / tree-crud-v1 / master-detail-v1 的选用与字段约束) - `eip4-acl-manage`(菜单授权/角色,映射 `/api/admin/*`) - `eip4-serviceflow-diagnose`(默认流生成与排错) 2. 给 CLI 加 `eip4 skills list/check`,校验本地已安装 skill 版本与仓库是否一致。 **验收**:agent 不再询问「表怎么建 / recipe 怎么选 / 权限怎么配」即可独立完成一个新功能。 **成本**:中(主要是文档 + 一个 CLI 校验命令)。 **落地(2026-06-22)**:新增 3 个 skill(`eip4-data-modeling` / `eip4-page-recipe` / `eip4-acl-manage`,全部基于核实过的 `/api/meta/entity`、`/api/design/recipe/compile`、`/api/admin/*` 端点写就),manifest + jar 打包同步,`docs/skills` 现共 6 个。CLI 新增 `eip4 skills list`(列内置 skills)+ `eip4 skills check --dir`(检测目标项目已装/缺失,缺失退出非 0),TDD 2 新测试、platform-cli 共 22 单测全绿。真实验证:`skills list` 列 6 个、`init` 装 6 个、`skills check` 全 installed(exit 0)、新 skill 端口正确渲染零占位符残留。**`serviceflow-diagnose` 暂缓**:经源码核实平台没有「查看/诊断服务流定义」的 agent 可操作端点(仅能 `POST/GET /api/flow/{id}` 执行 + 看 FlowController 日志),需先补「查看流定义」端点才值得做,否则只能写出无法落地的规程。 --- ## 四、不做的部分(红线) - **平台不内置生成式 LLM(②面)**:NocoBase 做了内置 AI employees + LLM Service(OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama)。EIP4 进程内唯一 LLM 是 `HttpAiLlmRepairClient`,`@ConditionalOnProperty(...repair.enabled,"true")` **默认关,且只修不生成**。是否立②面 = v1 之后的产品决策,本文不推进。 - **终点恒人审**:任何接入路径产物都停在 `READY_FOR_HUMAN_REVIEW`,生产写默认阻断。G1–G3 不得绕过该门禁。 - **对外口径**:限「AI 辅助、人工复核」;严禁承诺「AI 全自动开发 / 人力大幅下降」(决策会纪要商务条款③)。 --- ## 五、建议执行顺序 1. **G1 一键接入**(P0,半天级):投入最小、最快让 claude code/codex 真正能用上 EIP4。 2. **G2 MCP server 最小骨架**(P1):把接入面标准化,去掉「agent 死记用法」。 3. **G3 Skills 补全**(P1,可与 G2 并行):提升 agent 自主完成度。 4. ②面(内置 LLM)维持观望,待产品对红线拍板。 --- ## 六、与既有路线图的关系 本文 G1–G3 落在 `AI_AGENT_Nocobase_ADOPTION_PLAN.md` 的 P1(受控入口/Skills)与 P5(MCP 白名单)之间,是把当时「第一版完成」的接入层提升到 NocoBase 2026 的体验基线。`SOURCE_REVIEW.md` P5 未完成项明确列了「MCP 工具白名单」「Skills CLI check/update」——本文 G2/G3 即其落地化。进度以 `项目进度与路线-总览-2026-06-21.md` 为准,落地后回写该总览。