@lark-apaas/fullstack-cli 1.1.23 → 1.1.25

package/README.md

@@ -1,6 +1,6 @@
 # @lark-apaas/fullstack-cli
 
-> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成、能力管理
+> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成、能力管理、构建工具
 
 ## 功能
 
@@ -9,6 +9,7 @@
 3. **OpenAPI 生成** - 自动生成 API 文档和客户端 SDK
 4. **Action 插件管理** - 安装、更新、删除 action 插件
 5. **能力配置管理** - 查看、充血、迁移能力配置
+6. **构建工具** - 获取 STI 制品上传凭证等构建相关操作
 
 ## 安装
 
@@ -201,7 +202,40 @@ fullstack-cli capability migration --skip-code
 }
 ```
 
-### 7. CLI 命令
+### 7. 构建工具
+
+获取构建流程所需的 STI 制品上传凭证：
+
+```bash
+# Pipeline 发布场景 - 需要 commit-id
+fullstack-cli build get-token --app-id app_xxx --scene pipeline --commit-id abc123
+
+# 静态资源部署场景
+fullstack-cli build get-token --app-id app_xxx --scene static
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--app-id <id>` | 是 | 应用 ID |
+| `--scene <scene>` | 是 | 构建场景（`pipeline`、`static`） |
+| `--commit-id <id>` | scene=pipeline 时必填 | Git Commit ID |
+
+**输出：** stdout 输出 API 返回的完整 JSON，日志/错误输出到 stderr，便于脚本解析：
+
+```bash
+token_response=$(fullstack-cli build get-token --app-id "$APP_ID" --scene pipeline --commit-id "$COMMIT_ID")
+credential=$(echo "$token_response" | jq -r '.data.accessKeyID')
+```
+
+**环境变量：**
+- `FORCE_AUTHN_INNERAPI_DOMAIN` — API 域名
+- `FORCE_AUTHN_ACCESS_KEY` — Access Key
+- `FORCE_AUTHN_ACCESS_SECRET` — Secret Key
+- `FORCE_FRAMEWORK_CLI_CANARY_ENV` — Canary 环境（可选）
+
+### 8. CLI 命令
 
 ```bash
 # 查看帮助
@@ -223,11 +257,15 @@ fullstack-cli capability --help
 fullstack-cli capability list
 fullstack-cli capability migration --dry-run
 
+# 构建工具
+fullstack-cli build --help
+fullstack-cli build get-token --app-id <id> --scene <scene> [--commit-id <id>]
+
 # 查看版本
 fullstack-cli --version
 ```
 
-### 8. 全局选项
+### 9. 全局选项
 
 #### Canary 环境