Files
eip4-platform/docs/skills/eip4-env-manage.md
zhengwr 0e457d9945 feat(cli): agent 接入补全(token/MCP/REST 分流)+ 修 page-recipe recipe-id
- fix: page-recipe 的 maintenance-crud 漏 `-v1`,而 compile 端点精确匹配
  maintenance-crud-v1,agent 照抄示例会 400;统一为 -v1,并引导以
  GET /api/ai/page-recipes 为权威列表,避免硬写字面量漂移。
- env-manage 新增「鉴权/Token」段:非 prod profile permitAll 免 token,
  prod/JWT 环境需 POST /api/auth/login 取顶层 `token` + `Authorization: Bearer`
  (核实 AuthController/JwtAuthFilter)。
- AGENTS.md(writeAgentsMd):把「优先 platform-cli」误导修为按类分流
  (env/ai/release 用 CLI,建模/页面/授权用 REST 或 platform-mcp),
  并点名 platform-mcp 注册方式 + token 获取指引。
- data-modeling/page-recipe/acl-manage 各加调用方式与 token 交叉引用。
- 测试 +3:page-recipe recipe-id 回归、AGENTS.md MCP/auth、bundled skills 防漂移。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 09:50:23 +08:00

2.5 KiB
Raw Permalink Blame History

Skill: eip4-env-manage

触发场景

  • 用户要求启动、检查或切换 EIP4 环境。
  • 用户要求 Agent 在本地验证功能。
  • 用户要求确认当前服务是否可被 AI 自动开发链路使用。

操作规则

  1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
  2. 使用 JDK 21,不能使用 JDK 26。
  3. 默认本地 base URL 由 eip4 init 渲染,当前环境为 {{EIP4_BASE_URL}};多套环境用 eip4 env add/use 管理。
  4. 使用 CLI 探测环境:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
  --name local \
  --base-url {{EIP4_BASE_URL}} \
  --kind local \
  --use

java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status
  1. 如果服务未启动,优先使用重新打包后的 jar:
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

鉴权 / Token

  • 非 prod profile(default / local / ci)放行 /api/**;本地 eip4 init 默认渲染 local,故本地 curl / CLI 无需 token。
  • prod 或开启 JWT 的环境:/api/** 需请求头 Authorization: Bearer <token>(/api/auth/** 例外,登录本身免令牌)。
  • 取 token(登录响应顶层字段 token=JWT、expireSeconds=过期秒数;失败 401 仅含 success:false + msg):
TOKEN=$(curl -s -X POST {{EIP4_BASE_URL}}/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"account":"admin","password":"111111"}' \
  | python3 -c 'import sys,json;print(json.load(sys.stdin)["token"])')

curl {{EIP4_BASE_URL}}/api/meta/entities -H "Authorization: Bearer $TOKEN"

admin/111111 为本地 dev 种子账号;按环境替换。

禁止事项

  • 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。
  • 不把线上环境设置为默认写入目标。
  • 不跳过 JDK 版本检查。
  • 显式选择非当前 env 执行 AI 或发布类命令时,必须要求 --yes 或等效人工确认。

常用命令

java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env list
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env current
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env use --name local
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --all