diff --git a/README.md b/README.md
index 9049822..aa4b8e4 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,7 @@ EIP4 平台正式工程(路线 A'):双层制模块化单体——**保真层供
| platform-converter | 模板转换器(P4) | 可独立 CLI 跑批 |
| platform-flow-gateway | P3 占位:Flowable 网关 | |
| platform-ai | P5 AI Agent 开发底座:草稿/变更包/本地门禁/自动修复/人工部署包 | Agent 不直连线上执行生产变更 |
+| platform-cli | EIP4 Agent 受控命令入口:环境探测、AI 自动开发、后续发布编排 | Agent 优先通过 CLI/API 操作 |
| platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 |
| platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 |
@@ -75,6 +76,10 @@ java -cp "$CP" com.eip4.platform.parity.selfcheck.ParityCli --privilege # C
# 指向 eip4dev 自对拍:
mvn -pl platform-parity exec:java -Dexec.mainClass="com.eip4.platform.parity.selfcheck.ParityCli" \
"-Dexec.args=--discover --jdbc=jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3 --engine=http://localhost:8093 --out=parity-reports/eip4dev"
+
+# EIP4 Agent CLI
+mvn -pl platform-cli package
+java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084
```
## tools/
diff --git a/docs/AI_AGENT_AUTO_DEVELOPMENT.md b/docs/AI_AGENT_AUTO_DEVELOPMENT.md
index 54b7dd7..4fa8717 100644
--- a/docs/AI_AGENT_AUTO_DEVELOPMENT.md
+++ b/docs/AI_AGENT_AUTO_DEVELOPMENT.md
@@ -36,6 +36,27 @@ JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTe
## 请求示例
+推荐优先使用 `platform-cli`,让 Agent 通过稳定命令入口操作自动开发链路:
+
+```bash
+mvn -pl platform-cli package
+java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
+ --base-url http://localhost:8093 \
+ --objective "新增客户等级维护功能" \
+ --feature-name "客户等级维护" \
+ --table-name EIP4AI_CUSTOMER_LEVEL \
+ --entity-name "客户等级" \
+ --template-id eip4ai-customer-level \
+ --menu-name "客户等级维护" \
+ --field NAME:名称:string:100:true \
+ --field CODE:编码:string:64:true \
+ --field ENABLED:启用:boolean::false \
+ --max-repair-attempts 2 \
+ --output target/ai-runs/customer-level.json
+```
+
+底层 REST API 仍可直接调用:
+
```bash
curl -X POST http://localhost:8093/api/ai/features/auto-develop \
-H 'Content-Type: application/json' \
diff --git a/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md b/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md
new file mode 100644
index 0000000..40f1776
--- /dev/null
+++ b/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md
@@ -0,0 +1,167 @@
+# 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 的里程碑都能追溯输入、输出、测试证据和回滚脚本
+
+### 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 | 待开始 | 依赖 P1 的 CLI 和规范稳定 |
+| P3 | 待开始 | 依赖 P2 的功能包和版本模型 |
+| P4 | 待开始 | 依赖页面 schema 现状清理 |
+| P5 | 待开始 | 依赖权限、审计、工具白名单成熟 |
diff --git a/docs/skills/README.md b/docs/skills/README.md
new file mode 100644
index 0000000..381deb5
--- /dev/null
+++ b/docs/skills/README.md
@@ -0,0 +1,20 @@
+# EIP4 Agent Skills
+
+本目录是 EIP4 给 AI Agent 使用的领域操作规程。目标是让 Codex、Claude Code、Cursor、OpenCode 等 Agent 都按同一套规则操作 EIP4,而不是临时猜接口、猜表结构或直连线上库。
+
+## Skills
+
+| Skill | 用途 |
+|---|---|
+| `eip4-env-manage` | 环境探测、启动检查、端口和 profile 边界 |
+| `eip4-ai-feature-development` | 从自然语言需求生成实体、服务流、页面、菜单和本地 smoke |
+| `eip4-release-manage` | 部署包、人审、发布前校验和回滚边界 |
+
+## 通用原则
+
+1. 优先使用 `platform-cli`,其次使用公开 REST API,最后才考虑人工 SQL。
+2. 默认只允许本地开发和测试环境自动执行写操作。
+3. 线上环境只能生成部署包和校验证据,不能由 Agent 默认直接写入。
+4. 每次自动开发必须保留 request、draft、change-set、apply、smoke、repair、deployment package evidence。
+5. 任何失败先回到本地复现和修复,再重新生成部署包。
+
diff --git a/docs/skills/eip4-ai-feature-development.md b/docs/skills/eip4-ai-feature-development.md
new file mode 100644
index 0000000..bad8dd5
--- /dev/null
+++ b/docs/skills/eip4-ai-feature-development.md
@@ -0,0 +1,66 @@
+# Skill: eip4-ai-feature-development
+
+## 触发场景
+
+- 用户描述一个新功能,希望 AI 自动生成。
+- 用户要求从 EIP3 模板、实体、服务流或页面定义生成 EIP4 功能。
+- 用户要求本地自动开发、自动修复和 smoke。
+
+## 输入要求
+
+最小需求应包含:
+
+- 功能目标
+- 功能名称
+- 业务表名
+- 实体名称
+- 页面 templateId
+- 菜单名称
+- 字段列表
+
+字段格式:
+
+```text
+column:label:type[:length][:required]
+```
+
+示例:
+
+```text
+NAME:名称:string:100:true
+CODE:编码:string:64:true
+ENABLED:启用:boolean::false
+```
+
+## 推荐命令
+
+```bash
+java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
+ --base-url http://localhost:8084 \
+ --objective "新增客户等级维护功能" \
+ --feature-name "客户等级维护" \
+ --table-name EIP4AI_CUSTOMER_LEVEL \
+ --entity-name "客户等级" \
+ --template-id eip4ai-customer-level \
+ --menu-name "客户等级维护" \
+ --field NAME:名称:string:100:true \
+ --field CODE:编码:string:64:true \
+ --field ENABLED:启用:boolean::false \
+ --max-repair-attempts 2 \
+ --output target/ai-runs/customer-level.json
+```
+
+## 通过标准
+
+- `applyStatus` 为 `PASSED`。
+- `smokeStatus` 为 `PASSED`。
+- 最终状态为 `READY_FOR_HUMAN_REVIEW`。
+- 部署包存在且 `requiresHumanApproval=true`。
+
+## 失败处理
+
+1. 查看输出 JSON 中的 apply/smoke/repair evidence。
+2. 如果自动修复已尝试但失败,基于 evidence 修改本地代码或元数据生成逻辑。
+3. 重新运行本地 auto-develop。
+4. 不直接连接线上库修复。
+
diff --git a/docs/skills/eip4-env-manage.md b/docs/skills/eip4-env-manage.md
new file mode 100644
index 0000000..252aee9
--- /dev/null
+++ b/docs/skills/eip4-env-manage.md
@@ -0,0 +1,34 @@
+# Skill: eip4-env-manage
+
+## 触发场景
+
+- 用户要求启动、检查或切换 EIP4 环境。
+- 用户要求 Agent 在本地验证功能。
+- 用户要求确认当前服务是否可被 AI 自动开发链路使用。
+
+## 操作规则
+
+1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
+2. 使用 JDK 21,不能使用 JDK 26。
+3. 默认本地 profile:
+ - `local`: `http://localhost:8084`
+ - `dev`: `http://localhost:8093`
+4. 使用 CLI 探测环境:
+
+```bash
+java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084
+```
+
+5. 如果服务未启动,优先使用重新打包后的 jar:
+
+```bash
+JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests
+/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local
+```
+
+## 禁止事项
+
+- 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。
+- 不把线上环境设置为默认写入目标。
+- 不跳过 JDK 版本检查。
+
diff --git a/docs/skills/eip4-release-manage.md b/docs/skills/eip4-release-manage.md
new file mode 100644
index 0000000..98e4f11
--- /dev/null
+++ b/docs/skills/eip4-release-manage.md
@@ -0,0 +1,39 @@
+# Skill: eip4-release-manage
+
+## 触发场景
+
+- 用户要求生成部署包。
+- 用户要求发布 AI 生成的功能。
+- 用户要求线上 bug 修复或回滚。
+
+## 当前边界
+
+当前 `platform-ai` 只生成线上人工部署包,不自动连接线上环境执行写操作。这是设计边界,不是功能缺失。
+
+## 发布前检查
+
+1. 确认本地 auto-develop 已通过。
+2. 确认部署包包含:
+ - manifest
+ - SQL 草案
+ - rollback SQL
+ - 本地 apply evidence
+ - smoke evidence
+ - repair evidence
+3. 确认部署包需要人工审批。
+4. 如果包含 `${parentMenuId}` 等占位符,必须人工替换并复核。
+
+## 线上 bug 修复路径
+
+1. 收集线上错误日志、请求样本或人工复现步骤。
+2. 在本地创建新的 AI 修复任务。
+3. 本地执行 apply/smoke/repair。
+4. 生成新的部署包。
+5. 人工审核后走现有上线流程。
+
+## 禁止事项
+
+- 不让 Agent 默认直接写线上数据库。
+- 不绕过部署包和人审。
+- 不把 smoke 失败的变更包交给发布流程。
+
diff --git a/docs/架构设计.md b/docs/架构设计.md
index fd75ffe..19ebd59 100644
--- a/docs/架构设计.md
+++ b/docs/架构设计.md
@@ -19,6 +19,7 @@ eip4-platform(Maven 多模块单体)
├── platform-flow-gateway Flowable REST 客户端、待办聚合、3 个 handler bean
├── platform-converter 模板转换器 + S3 脚本改写器(可独立 CLI 跑批)
├── platform-ai AI Agent 开发底座、schema 双闸校验、自动修复、本地门禁和人工部署包
+├── platform-cli EIP4 Agent 受控命令入口:环境探测、AI 自动开发、后续发布编排
├── platform-parity C1 逐行对拍框架:录制/重放/逐行 diff(P1 一级交付物,可独立 CLI 跑批)
└── platform-app Spring Boot 启动器,组装上述模块
```
diff --git a/platform-cli/pom.xml b/platform-cli/pom.xml
new file mode 100644
index 0000000..653ebd3
--- /dev/null
+++ b/platform-cli/pom.xml
@@ -0,0 +1,56 @@
+
+
+ 4.0.0
+
+ com.eip4
+ eip4-platform
+ 0.1.0-SNAPSHOT
+
+ platform-cli
+ platform-cli
+ EIP4 Agent 受控命令入口:环境探测、AI 自动开发、发布前门禁编排
+
+
+
+ com.fasterxml.jackson.core
+ jackson-databind
+
+
+ org.junit.jupiter
+ junit-jupiter
+ test
+
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-assembly-plugin
+ 3.7.1
+
+
+
+ com.eip4.platform.cli.Eip4Cli
+
+
+
+ jar-with-dependencies
+
+ false
+
+
+
+ make-assembly
+ package
+
+ single
+
+
+
+
+
+
+
diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/Eip4Cli.java b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4Cli.java
new file mode 100644
index 0000000..bf4ca56
--- /dev/null
+++ b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4Cli.java
@@ -0,0 +1,328 @@
+package com.eip4.platform.cli;
+
+import java.io.IOException;
+import java.io.PrintStream;
+import java.net.URI;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+
+public final class Eip4Cli {
+
+ private static final String DEFAULT_BASE_URL = "http://localhost:8084";
+
+ private final ObjectMapper objectMapper;
+ private final Eip4HttpClient httpClient;
+
+ public Eip4Cli(Eip4HttpClient httpClient) {
+ this.objectMapper = new ObjectMapper();
+ this.httpClient = httpClient;
+ }
+
+ public static void main(String[] args) {
+ ObjectMapper objectMapper = new ObjectMapper();
+ int code = new Eip4Cli(new JdkEip4HttpClient(objectMapper)).run(args, System.out, System.err);
+ if (code != 0) {
+ System.exit(code);
+ }
+ }
+
+ int run(String[] args, PrintStream out, PrintStream err) {
+ try {
+ if (args.length == 0 || isHelp(args[0])) {
+ printHelp(out);
+ return 0;
+ }
+ return switch (args[0]) {
+ case "env" -> runEnv(args, out, err);
+ case "ai" -> runAi(args, out, err);
+ default -> fail(err, "Unknown command: " + args[0]);
+ };
+ } catch (IllegalArgumentException ex) {
+ return fail(err, ex.getMessage());
+ } catch (IOException ex) {
+ return fail(err, "I/O failed: " + ex.getMessage());
+ } catch (InterruptedException ex) {
+ Thread.currentThread().interrupt();
+ return fail(err, "Interrupted");
+ }
+ }
+
+ private int runEnv(String[] args, PrintStream out, PrintStream err) throws IOException, InterruptedException {
+ if (args.length < 2 || isHelp(args[1])) {
+ printEnvHelp(out);
+ return 0;
+ }
+ if (!"status".equals(args[1])) {
+ return fail(err, "Unknown env command: " + args[1]);
+ }
+ Options options = Options.parse(args, 2);
+ String baseUrl = baseUrl(options);
+ URI uri = endpoint(baseUrl, "/v3/api-docs");
+ Eip4HttpResponse response = httpClient.send("GET", uri, null);
+ if (!response.successful()) {
+ err.println("EIP4 env NOT_READY");
+ err.println("baseUrl: " + baseUrl);
+ err.println("status: " + response.statusCode());
+ return 2;
+ }
+ out.println("EIP4 env READY");
+ out.println("baseUrl: " + baseUrl);
+ out.println("apiDocs: " + uri);
+ return 0;
+ }
+
+ private int runAi(String[] args, PrintStream out, PrintStream err) throws IOException, InterruptedException {
+ if (args.length < 2 || isHelp(args[1])) {
+ printAiHelp(out);
+ return 0;
+ }
+ if (!"auto-develop".equals(args[1])) {
+ return fail(err, "Unknown ai command: " + args[1]);
+ }
+ Options options = Options.parse(args, 2);
+ ObjectNode request = buildAutoDevelopRequest(options);
+ String baseUrl = baseUrl(options);
+ Eip4HttpResponse response = httpClient.send(
+ "POST",
+ endpoint(baseUrl, "/api/ai/features/auto-develop"),
+ request);
+ if (!response.successful()) {
+ err.println("AI auto-develop failed");
+ err.println("status: " + response.statusCode());
+ err.println(response.body());
+ return 2;
+ }
+ JsonNode body = response.body().isBlank()
+ ? objectMapper.createObjectNode()
+ : objectMapper.readTree(response.body());
+ String formatted = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(body);
+ String output = options.single("output");
+ if (output == null) {
+ out.println(formatted);
+ } else {
+ Path outputPath = Path.of(output);
+ if (outputPath.getParent() != null) {
+ Files.createDirectories(outputPath.getParent());
+ }
+ Files.writeString(outputPath, formatted + System.lineSeparator(), StandardCharsets.UTF_8);
+ out.println("Wrote run result: " + outputPath.toAbsolutePath());
+ printAutoDevelopSummary(body, out);
+ }
+ return 0;
+ }
+
+ private ObjectNode buildAutoDevelopRequest(Options options) {
+ ObjectNode root = objectMapper.createObjectNode();
+ String baseUrl = baseUrl(options);
+ root.put("baseUrl", baseUrl);
+ root.put("generateDeploymentPackage", !options.has("no-deployment-package"));
+ String maxRepairAttempts = options.single("max-repair-attempts");
+ if (maxRepairAttempts != null) {
+ root.put("maxRepairAttempts", parseInt(maxRepairAttempts, "max-repair-attempts"));
+ }
+
+ ObjectNode feature = root.putObject("feature");
+ putRequired(feature, "objective", options, "objective");
+ putRequired(feature, "featureName", options, "feature-name");
+ putRequired(feature, "tableName", options, "table-name");
+ putRequired(feature, "entityName", options, "entity-name");
+ putRequired(feature, "templateId", options, "template-id");
+ putRequired(feature, "menuName", options, "menu-name");
+
+ List fields = options.values("field");
+ if (fields.isEmpty()) {
+ throw new IllegalArgumentException("Missing required option: --field");
+ }
+ ArrayNode fieldNodes = feature.putArray("fields");
+ for (String field : fields) {
+ fieldNodes.add(parseField(field));
+ }
+ return root;
+ }
+
+ private ObjectNode parseField(String spec) {
+ String[] parts = spec.split(":", -1);
+ if (parts.length < 3 || parts.length > 5) {
+ throw new IllegalArgumentException("Invalid --field, expected column:label:type[:length][:required]");
+ }
+ ObjectNode node = objectMapper.createObjectNode();
+ node.put("column", requiredPart(parts[0], "field column"));
+ node.put("label", requiredPart(parts[1], "field label"));
+ node.put("type", requiredPart(parts[2], "field type").toLowerCase(Locale.ROOT));
+ if (parts.length >= 4 && !parts[3].isBlank()) {
+ node.put("length", parseInt(parts[3], "field length"));
+ }
+ if (parts.length >= 5 && !parts[4].isBlank()) {
+ node.put("required", Boolean.parseBoolean(parts[4]));
+ } else {
+ node.put("required", false);
+ }
+ return node;
+ }
+
+ private void putRequired(ObjectNode node, String jsonName, Options options, String optionName) {
+ node.put(jsonName, requiredPart(options.single(optionName), optionName));
+ }
+
+ private String baseUrl(Options options) {
+ String value = options.single("base-url");
+ if (value == null || value.isBlank()) {
+ value = System.getenv("EIP4_BASE_URL");
+ }
+ if (value == null || value.isBlank()) {
+ value = DEFAULT_BASE_URL;
+ }
+ while (value.endsWith("/")) {
+ value = value.substring(0, value.length() - 1);
+ }
+ return value;
+ }
+
+ private URI endpoint(String baseUrl, String path) {
+ return URI.create(baseUrl + path);
+ }
+
+ private void printAutoDevelopSummary(JsonNode body, PrintStream out) {
+ out.println("status: " + text(body, "status"));
+ out.println("taskId: " + text(body, "taskId"));
+ out.println("changeSetId: " + text(body, "changeSetId"));
+ JsonNode apply = body.path("applyRun");
+ if (!apply.isMissingNode()) {
+ out.println("applyStatus: " + text(apply, "status"));
+ }
+ JsonNode smoke = body.path("smokeRun");
+ if (!smoke.isMissingNode()) {
+ out.println("smokeStatus: " + text(smoke, "status"));
+ }
+ }
+
+ private String text(JsonNode node, String field) {
+ JsonNode value = node.path(field);
+ return value.isMissingNode() || value.isNull() ? "" : value.asText();
+ }
+
+ private int parseInt(String value, String name) {
+ try {
+ return Integer.parseInt(value);
+ } catch (NumberFormatException ex) {
+ throw new IllegalArgumentException("Invalid integer for " + name + ": " + value);
+ }
+ }
+
+ private String requiredPart(String value, String name) {
+ if (value == null || value.isBlank()) {
+ throw new IllegalArgumentException("Missing required value: " + name);
+ }
+ return value;
+ }
+
+ private boolean isHelp(String arg) {
+ return "--help".equals(arg) || "-h".equals(arg) || "help".equals(arg);
+ }
+
+ private int fail(PrintStream err, String message) {
+ err.println(message);
+ err.println("Run `eip4 --help` for usage.");
+ return 1;
+ }
+
+ private void printHelp(PrintStream out) {
+ out.println("""
+ EIP4 CLI
+
+ Usage:
+ eip4 env status [--base-url URL]
+ eip4 ai auto-develop --objective TEXT --feature-name NAME --table-name TABLE --entity-name NAME --template-id ID --menu-name NAME --field column:label:type[:length][:required]
+
+ Environment:
+ EIP4_BASE_URL defaults the target service URL when --base-url is omitted.
+ """);
+ }
+
+ private void printEnvHelp(PrintStream out) {
+ out.println("""
+ Usage:
+ eip4 env status [--base-url URL]
+ """);
+ }
+
+ private void printAiHelp(PrintStream out) {
+ out.println("""
+ Usage:
+ eip4 ai auto-develop [options]
+
+ Required:
+ --objective TEXT
+ --feature-name NAME
+ --table-name TABLE
+ --entity-name NAME
+ --template-id ID
+ --menu-name NAME
+ --field column:label:type[:length][:required]
+
+ Optional:
+ --base-url URL
+ --max-repair-attempts N
+ --no-deployment-package
+ --output FILE
+ """);
+ }
+
+ private static final class Options {
+ private final Map> values = new LinkedHashMap<>();
+
+ static Options parse(String[] args, int from) {
+ Options options = new Options();
+ for (int i = from; i < args.length; i++) {
+ String arg = args[i];
+ if (!arg.startsWith("--")) {
+ throw new IllegalArgumentException("Unexpected argument: " + arg);
+ }
+ String name = arg.substring(2);
+ if (name.isBlank()) {
+ throw new IllegalArgumentException("Invalid option: " + arg);
+ }
+ if ("no-deployment-package".equals(name)) {
+ options.add(name, "true");
+ continue;
+ }
+ if (i + 1 >= args.length || args[i + 1].startsWith("--")) {
+ throw new IllegalArgumentException("Missing value for option: " + arg);
+ }
+ options.add(name, args[++i]);
+ }
+ return options;
+ }
+
+ boolean has(String name) {
+ return values.containsKey(name);
+ }
+
+ String single(String name) {
+ List list = values.get(name);
+ if (list == null || list.isEmpty()) {
+ return null;
+ }
+ return list.get(list.size() - 1);
+ }
+
+ List values(String name) {
+ return values.getOrDefault(name, List.of());
+ }
+
+ private void add(String name, String value) {
+ values.computeIfAbsent(name, ignored -> new ArrayList<>()).add(value);
+ }
+ }
+}
diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpClient.java b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpClient.java
new file mode 100644
index 0000000..d59b411
--- /dev/null
+++ b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpClient.java
@@ -0,0 +1,10 @@
+package com.eip4.platform.cli;
+
+import java.io.IOException;
+import java.net.URI;
+
+import com.fasterxml.jackson.databind.JsonNode;
+
+interface Eip4HttpClient {
+ Eip4HttpResponse send(String method, URI uri, JsonNode body) throws IOException, InterruptedException;
+}
diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpResponse.java b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpResponse.java
new file mode 100644
index 0000000..53dd188
--- /dev/null
+++ b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpResponse.java
@@ -0,0 +1,7 @@
+package com.eip4.platform.cli;
+
+record Eip4HttpResponse(int statusCode, String body) {
+ boolean successful() {
+ return statusCode >= 200 && statusCode < 300;
+ }
+}
diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/JdkEip4HttpClient.java b/platform-cli/src/main/java/com/eip4/platform/cli/JdkEip4HttpClient.java
new file mode 100644
index 0000000..b024461
--- /dev/null
+++ b/platform-cli/src/main/java/com/eip4/platform/cli/JdkEip4HttpClient.java
@@ -0,0 +1,39 @@
+package com.eip4.platform.cli;
+
+import java.io.IOException;
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.time.Duration;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+final class JdkEip4HttpClient implements Eip4HttpClient {
+
+ private static final Duration TIMEOUT = Duration.ofSeconds(30);
+
+ private final HttpClient client;
+ private final ObjectMapper objectMapper;
+
+ JdkEip4HttpClient(ObjectMapper objectMapper) {
+ this.client = HttpClient.newBuilder().connectTimeout(TIMEOUT).build();
+ this.objectMapper = objectMapper;
+ }
+
+ @Override
+ public Eip4HttpResponse send(String method, URI uri, JsonNode body) throws IOException, InterruptedException {
+ HttpRequest.BodyPublisher publisher = body == null
+ ? HttpRequest.BodyPublishers.noBody()
+ : HttpRequest.BodyPublishers.ofString(objectMapper.writeValueAsString(body));
+ HttpRequest request = HttpRequest.newBuilder(uri)
+ .timeout(TIMEOUT)
+ .header("Accept", "application/json")
+ .header("Content-Type", "application/json")
+ .method(method, publisher)
+ .build();
+ HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
+ return new Eip4HttpResponse(response.statusCode(), response.body());
+ }
+}
diff --git a/platform-cli/src/test/java/com/eip4/platform/cli/Eip4CliTest.java b/platform-cli/src/test/java/com/eip4/platform/cli/Eip4CliTest.java
new file mode 100644
index 0000000..50ac686
--- /dev/null
+++ b/platform-cli/src/test/java/com/eip4/platform/cli/Eip4CliTest.java
@@ -0,0 +1,136 @@
+package com.eip4.platform.cli;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.ByteArrayOutputStream;
+import java.io.PrintStream;
+import java.net.URI;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+class Eip4CliTest {
+
+ private final ObjectMapper objectMapper = new ObjectMapper();
+
+ @TempDir
+ Path tempDir;
+
+ @Test
+ void envStatusChecksOpenApiEndpoint() {
+ CapturingClient client = new CapturingClient(new Eip4HttpResponse(200, "{}"));
+ CliResult result = run(client, "env", "status", "--base-url", "http://localhost:8084/");
+
+ assertEquals(0, result.code());
+ assertEquals("GET", client.method);
+ assertEquals(URI.create("http://localhost:8084/v3/api-docs"), client.uri);
+ assertTrue(result.out().contains("EIP4 env READY"));
+ }
+
+ @Test
+ void autoDevelopBuildsRequestAndWritesResponse() throws Exception {
+ String response = """
+ {
+ "status": "READY_FOR_HUMAN_REVIEW",
+ "taskId": "task-1",
+ "changeSetId": "cs-1",
+ "applyRun": {"status": "PASSED"},
+ "smokeRun": {"status": "PASSED"}
+ }
+ """;
+ CapturingClient client = new CapturingClient(new Eip4HttpResponse(200, response));
+ Path output = tempDir.resolve("run.json");
+
+ CliResult result = run(client,
+ "ai", "auto-develop",
+ "--base-url", "http://localhost:8084",
+ "--objective", "新增客户等级维护",
+ "--feature-name", "客户等级维护",
+ "--table-name", "EIP4AI_CUSTOMER_LEVEL",
+ "--entity-name", "客户等级",
+ "--template-id", "eip4ai-customer-level",
+ "--menu-name", "客户等级维护",
+ "--field", "NAME:名称:string:100:true",
+ "--field", "ENABLED:启用:boolean::false",
+ "--max-repair-attempts", "3",
+ "--no-deployment-package",
+ "--output", output.toString());
+
+ assertEquals(0, result.code());
+ assertEquals("POST", client.method);
+ assertEquals(URI.create("http://localhost:8084/api/ai/features/auto-develop"), client.uri);
+ assertFalse(client.body.path("generateDeploymentPackage").asBoolean());
+ assertEquals(3, client.body.path("maxRepairAttempts").asInt());
+ JsonNode feature = client.body.path("feature");
+ assertEquals("EIP4AI_CUSTOMER_LEVEL", feature.path("tableName").asText());
+ assertEquals(2, feature.path("fields").size());
+ assertEquals("NAME", feature.path("fields").get(0).path("column").asText());
+ assertEquals(100, feature.path("fields").get(0).path("length").asInt());
+ assertTrue(feature.path("fields").get(0).path("required").asBoolean());
+ assertTrue(Files.readString(output, StandardCharsets.UTF_8).contains("READY_FOR_HUMAN_REVIEW"));
+ assertTrue(result.out().contains("applyStatus: PASSED"));
+ }
+
+ @Test
+ void autoDevelopRequiresAtLeastOneField() {
+ CapturingClient client = new CapturingClient(new Eip4HttpResponse(200, "{}"));
+
+ CliResult result = run(client,
+ "ai", "auto-develop",
+ "--objective", "新增客户等级维护",
+ "--feature-name", "客户等级维护",
+ "--table-name", "EIP4AI_CUSTOMER_LEVEL",
+ "--entity-name", "客户等级",
+ "--template-id", "eip4ai-customer-level",
+ "--menu-name", "客户等级维护");
+
+ assertEquals(1, result.code());
+ assertTrue(result.err().contains("Missing required option: --field"));
+ assertEquals(0, client.calls);
+ }
+
+ private CliResult run(CapturingClient client, String... args) {
+ ByteArrayOutputStream out = new ByteArrayOutputStream();
+ ByteArrayOutputStream err = new ByteArrayOutputStream();
+ int code = new Eip4Cli(client).run(
+ args,
+ new PrintStream(out, true, StandardCharsets.UTF_8),
+ new PrintStream(err, true, StandardCharsets.UTF_8));
+ return new CliResult(
+ code,
+ out.toString(StandardCharsets.UTF_8),
+ err.toString(StandardCharsets.UTF_8));
+ }
+
+ private final class CapturingClient implements Eip4HttpClient {
+ private final Eip4HttpResponse response;
+ private int calls;
+ private String method;
+ private URI uri;
+ private JsonNode body = objectMapper.createObjectNode();
+
+ private CapturingClient(Eip4HttpResponse response) {
+ this.response = response;
+ }
+
+ @Override
+ public Eip4HttpResponse send(String method, URI uri, JsonNode body) {
+ this.calls++;
+ this.method = method;
+ this.uri = uri;
+ this.body = body == null ? objectMapper.createObjectNode() : body;
+ return response;
+ }
+ }
+
+ private record CliResult(int code, String out, String err) {
+ }
+}
diff --git a/pom.xml b/pom.xml
index f724489..b8f7daa 100644
--- a/pom.xml
+++ b/pom.xml
@@ -25,6 +25,7 @@
platform-flow-gateway
platform-converter
platform-ai
+ platform-cli
platform-parity
platform-app
@@ -70,6 +71,11 @@
platform-ai
${project.version}
+
+ com.eip4
+ platform-cli
+ ${project.version}
+
com.eip4
platform-parity