# 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 探测环境: ```bash 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 ``` 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 ``` ## 鉴权 / Token - 非 prod profile(default / local / ci)放行 `/api/**`;本地 `eip4 init` 默认渲染 local,故本地 curl / CLI **无需 token**。 - prod 或开启 JWT 的环境:`/api/**` 需请求头 `Authorization: Bearer `(`/api/auth/**` 例外,登录本身免令牌)。 - 取 token(登录响应顶层字段 `token`=JWT、`expireSeconds`=过期秒数;失败 401 仅含 `success:false` + `msg`): ```bash 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` 或等效人工确认。 ## 常用命令 ```bash 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 ```