feat: add usage/quota/workspace cli command

Author: gujieye

.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"3eed9a85-f117-45ce-82e9-e404b5547852","pid":17131,"procStart":"Wed Jun  3 09:14:36 2026","acquiredAt":1780915535766}

README.md

@@ -35,7 +35,7 @@ Equip your AI Agent out-of-the-box with these capabilities, composable across co
 - **MCP integration** — Orchestrate Bailian MCP servers: list services, inspect tools, and invoke any tool directly from the terminal
 - **Web search** — Real-time internet retrieval for up-to-date, accurate answers
 - **Model recommendation** — Describe your scenario and get best-fit model suggestions; supports scoped search, model comparison, and alternative discovery
-- **Console capabilities** — Browse Bailian apps (`app list`) and check free-tier quota (`usage free`)
+- **Console capabilities** — Browse Bailian apps (`app list`), check free-tier quota (`usage free`), view model usage statistics (`usage stats`), manage workspaces (`workspace list`), and manage rate limits (`quota list/request/check/history`)
 - **Local file auto-upload** — Every URL parameter accepts a local path; uploaded to free temp storage with 48-hour validity
 
 ## Showcase: One-Sentence Cinematic Video
@@ -108,9 +108,22 @@ bl advisor recommend --message "qwen-max vs deepseek-v3 for code generation"
 # Browser login (required for console capability commands)
 bl auth login --console
 
-# Browse apps / free-tier quota
+# Browse apps / free-tier quota / usage statistics / workspaces
 bl app list
 bl usage free --model qwen3-max
+bl usage free --expiring 30                           # Quotas expiring within 30 days
+bl usage free --sort remaining                        # Sort by remaining % ascending
+bl usage stats --workspace-id <id>                    # Usage overview for a workspace
+bl usage stats --model qwen-turbo --workspace-id <id> # Per-model usage
+bl workspace list                                     # List all workspaces
+
+# Rate limit management
+bl quota list                                         # View RPM/TPM limits for all models
+bl quota list --model qwen3.6-plus                    # View limits for a specific model
+bl quota check                                        # Current usage vs rate limits
+bl quota check --model qwen3.6-plus --period 5        # Check usage over last 5 minutes
+bl quota request --model qwen3.6-plus --tpm 6000000   # Request a temporary TPM increase
+bl quota history                                      # View quota change history
 ```
 
 > More examples and scenarios: [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
@@ -134,7 +147,7 @@ bl text chat --api-key sk-xxxxx --message "Hello"
 
 ### Console Login (OAuth)
 
-Required for console capability commands (`app list`, `usage free`). Opens the Bailian console in your browser to sign in.
+Required for console capability commands (`app list`, `usage free`, `usage stats`, `workspace list`, `quota list/request/check/history`). Opens the Bailian console in your browser to sign in.
 
 ```bash
 bl auth login --console

README_CN.md

@@ -35,7 +35,7 @@ _专为 AI Agent 打造，每个命令均可作为结构化工具调用。_
 - **MCP 集成** — 统一调度百炼 MCP 服务：列出服务、查看工具、直接在终端调用任意工具
 - **联网搜索** — 实时互联网信息检索，提升回答准确性及时效性
 - **模型推荐** — 描述你的场景，智能推荐最适合的模型；支持限定范围搜索、模型对比和替代发现
-- **控制台能力** — 浏览百炼应用（`app list`），查询模型免费额度（`usage free`）
+- **控制台能力** — 浏览百炼应用（`app list`），查询模型免费额度（`usage free`），查看模型用量统计（`usage stats`），管理业务空间（`workspace list`），管理限流与提额（`quota list/request/check/history`）
 - **本地文件自动上传** — 所有 URL 参数同时支持本地路径，免费临时存储 48 小时
 
 ## 示例:一句话生成一部电影短片
@@ -103,9 +103,22 @@ bl advisor recommend --message "qwen-max 和 deepseek-v3 哪个更适合做代
 # 浏览器登录（控制台能力相关命令需要）
 bl auth login --console
 
-# 浏览应用 / 免费额度
+# 浏览应用 / 免费额度 / 用量统计 / 业务空间
 bl app list
 bl usage free --model qwen3-max
+bl usage free --expiring 30                           # 30 天内过期的额度
+bl usage free --sort remaining                        # 按剩余百分比升序排列
+bl usage stats --workspace-id <id>                    # 指定空间的用量概览
+bl usage stats --model qwen-turbo --workspace-id <id> # 指定模型用量
+bl workspace list                                     # 列出所有业务空间
+
+# 限流管理与提额
+bl quota list                                         # 查看所有模型的 RPM/TPM 限额
+bl quota list --model qwen3.6-plus                    # 查看指定模型限额
+bl quota check                                        # 查看当前用量 vs 限流阈值
+bl quota check --model qwen3.6-plus --period 5        # 查看最近 5 分钟用量
+bl quota request --model qwen3.6-plus --tpm 6000000   # 申请临时 TPM 提额
+bl quota history                                      # 查看提额历史记录
 ```
 
 > 更多案例与使用场景：[阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
@@ -129,7 +142,7 @@ bl text chat --api-key sk-xxxxx --message "你好"
 
 ### 控制台登录（OAuth）
 
-控制台能力命令（`app list`、`usage free`）需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。
+控制台能力命令（`app list`、`usage free`、`usage stats`、`workspace list`、`quota list/request/check/history`）需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。
 
 ```bash
 bl auth login --console

packages/cli/README.md

@@ -35,7 +35,7 @@ Equip your AI Agent out-of-the-box with these capabilities, composable across co
 - **MCP integration** — Orchestrate Bailian MCP servers: list services, inspect tools, and invoke any tool directly from the terminal
 - **Web search** — Real-time internet retrieval for up-to-date, accurate answers
 - **Model recommendation** — Describe your scenario and get best-fit model suggestions; supports scoped search, model comparison, and alternative discovery
-- **Console capabilities** — Browse Bailian apps (`app list`) and check free-tier quota (`usage free`)
+- **Console capabilities** — Browse Bailian apps (`app list`), check free-tier quota (`usage free`), view model usage statistics (`usage stats`), manage workspaces (`workspace list`), and manage rate limits (`quota list/request/check/history`)
 - **Local file auto-upload** — Every URL parameter accepts a local path; uploaded to free temp storage with 48-hour validity
 
 ## Showcase: One-Sentence Cinematic Video
@@ -108,9 +108,22 @@ bl advisor recommend --message "qwen-max vs deepseek-v3 for code generation"
 # Browser login (required for console capability commands)
 bl auth login --console
 
-# Browse apps / free-tier quota
+# Browse apps / free-tier quota / usage statistics / workspaces
 bl app list
 bl usage free --model qwen3-max
+bl usage free --expiring 30                           # Quotas expiring within 30 days
+bl usage free --sort remaining                        # Sort by remaining % ascending
+bl usage stats --workspace-id <id>                    # Usage overview for a workspace
+bl usage stats --model qwen-turbo --workspace-id <id> # Per-model usage
+bl workspace list                                     # List all workspaces
+
+# Rate limit management
+bl quota list                                         # View RPM/TPM limits for all models
+bl quota list --model qwen3.6-plus                    # View limits for a specific model
+bl quota check                                        # Current usage vs rate limits
+bl quota check --model qwen3.6-plus --period 5        # Check usage over last 5 minutes
+bl quota request --model qwen3.6-plus --tpm 6000000   # Request a temporary TPM increase
+bl quota history                                      # View quota change history
 ```
 
 > More examples and scenarios: [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
@@ -134,7 +147,7 @@ bl text chat --api-key sk-xxxxx --message "Hello"
 
 ### Console Login (OAuth)
 
-Required for console capability commands (`app list`, `usage free`). Opens the Bailian console in your browser to sign in.
+Required for console capability commands (`app list`, `usage free`, `usage stats`, `workspace list`, `quota list/request/check/history`). Opens the Bailian console in your browser to sign in.
 
 ```bash
 bl auth login --console

packages/cli/README_CN.md

@@ -35,7 +35,7 @@ _专为 AI Agent 打造，每个命令均可作为结构化工具调用。_
 - **MCP 集成** — 统一调度百炼 MCP 服务：列出服务、查看工具、直接在终端调用任意工具
 - **联网搜索** — 实时互联网信息检索，提升回答准确性及时效性
 - **模型推荐** — 描述你的场景，智能推荐最适合的模型；支持限定范围搜索、模型对比和替代发现
-- **控制台能力** — 浏览百炼应用（`app list`），查询模型免费额度（`usage free`）
+- **控制台能力** — 浏览百炼应用（`app list`），查询模型免费额度（`usage free`），查看模型用量统计（`usage stats`），管理业务空间（`workspace list`），管理限流与提额（`quota list/request/check/history`）
 - **本地文件自动上传** — 所有 URL 参数同时支持本地路径，免费临时存储 48 小时
 
 ## 示例:一句话生成一部电影短片
@@ -103,9 +103,22 @@ bl advisor recommend --message "qwen-max 和 deepseek-v3 哪个更适合做代
 # 浏览器登录（控制台能力相关命令需要）
 bl auth login --console
 
-# 浏览应用 / 免费额度
+# 浏览应用 / 免费额度 / 用量统计 / 业务空间
 bl app list
 bl usage free --model qwen3-max
+bl usage free --expiring 30                           # 30 天内过期的额度
+bl usage free --sort remaining                        # 按剩余百分比升序排列
+bl usage stats --workspace-id <id>                    # 指定空间的用量概览
+bl usage stats --model qwen-turbo --workspace-id <id> # 指定模型用量
+bl workspace list                                     # 列出所有业务空间
+
+# 限流管理与提额
+bl quota list                                         # 查看所有模型的 RPM/TPM 限额
+bl quota list --model qwen3.6-plus                    # 查看指定模型限额
+bl quota check                                        # 查看当前用量 vs 限流阈值
+bl quota check --model qwen3.6-plus --period 5        # 查看最近 5 分钟用量
+bl quota request --model qwen3.6-plus --tpm 6000000   # 申请临时 TPM 提额
+bl quota history                                      # 查看提额历史记录
 ```
 
 > 更多案例与使用场景：[阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
@@ -129,7 +142,7 @@ bl text chat --api-key sk-xxxxx --message "你好"
 
 ### 控制台登录（OAuth）
 
-控制台能力命令（`app list`、`usage free`）需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。
+控制台能力命令（`app list`、`usage free`、`usage stats`、`workspace list`、`quota list/request/check/history`）需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。
 
 ```bash
 bl auth login --console

packages/cli/src/commands/catalog.ts

@@ -36,9 +36,16 @@ import speechRecognize from "./speech/recognize.ts";
 import fileUpload from "./file/upload.ts";
 import consoleCall from "./console/call.ts";
 import usageFree from "./usage/free.ts";
+import usageFreetier from "./usage/freetier.ts";
+import usageStats from "./usage/stats.ts";
 import pipelineRun from "./pipeline/run.ts";
 import pipelineValidate from "./pipeline/validate.ts";
 import advisorRecommend from "./advisor/recommend.ts";
+import workspaceList from "./workspace/list.ts";
+import quotaList from "./quota/list.ts";
+import quotaRequest from "./quota/request.ts";
+import quotaHistory from "./quota/history.ts";
+import quotaCheck from "./quota/check.ts";
 
 /** Command registry map (no dependency on registry.ts — safe for build-time import). */
 export const commands: Record<string, Command> = {
@@ -74,11 +81,18 @@ export const commands: Record<string, Command> = {
   "file upload": fileUpload,
   "console call": consoleCall,
   "usage free": usageFree,
+  "usage freetier": usageFreetier,
+  "usage stats": usageStats,
   "pipeline run": pipelineRun,
   "pipeline validate": pipelineValidate,
   "config show": configShow,
   "config set": configSet,
   "config export-schema": configExportSchema,
   "advisor recommend": advisorRecommend,
+  "workspace list": workspaceList,
+  "quota list": quotaList,
+  "quota request": quotaRequest,
+  "quota history": quotaHistory,
+  "quota check": quotaCheck,
   update: update,
 };