Merge pull request #46 from modelstudioai/feat/model-usage

feat: add model usage\quota\workspace command

Author: XXPermanentXX

.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}

CHANGELOG.md

@@ -15,6 +15,17 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - `DashScopeKnowledgeRetrieveRequest` / `DashScopeKnowledgeRetrieveResponse` types and `knowledgeRetrieveEndpoint` added to `bailian-cli-core`.
 - Comprehensive E2E tests for knowledge retrieve covering both auth paths, dry-run, rerank flags, and error cases.
 
+- `bl usage` command group:
+  - `bl usage free` — query free-tier quota for all models (or a specific model with `--model`).
+  - `bl usage freetier` — enable (`--on`) or disable (`--off`) auto-stop for free-tier models.
+  - `bl usage stats` — query model usage statistics (requires `--workspace-id`).
+- `bl quota` command group:
+  - `bl quota list` — view model RPM/TPM rate limits (filter with `--model`, show all with `--all`).
+  - `bl quota check` — check current RPM/TPM usage against rate limits.
+  - `bl quota history` — view quota change history with pagination.
+  - `bl quota request` — request a temporary quota increase for a model.
+- `bl workspace list` — list all workspaces with region and endpoint details.
+
 ### Changed
 
 - Credential resolution priority: explicit API-Key → explicit AK/SK flags → auto-detected API-Key → fallback AK/SK from config/env.

CHANGELOG.zh.md

@@ -6,10 +6,20 @@
 
 [English](CHANGELOG.md) · [README](README.zh.md) · [参与贡献](CONTRIBUTING.zh.md)
 
-## [1.3.0] - 2026-06-10
+## [1.3.0] - 2026-06-11
 
 ### 新增
 
+- `bl usage` 命令组：
+  - `bl usage free` — 查询所有模型的免费额度（可通过 `--model` 指定模型）。
+  - `bl usage freetier` — 启用（`--on`）或禁用（`--off`）免费额度模型的自动停服。
+  - `bl usage stats` — 查询模型用量统计（需指定 `--workspace-id`）。
+- `bl quota` 命令组：
+  - `bl quota list` — 查看模型 RPM/TPM 速率限制（支持 `--model` 过滤，`--all` 展示全部）。
+  - `bl quota check` — 查看当前 RPM/TPM 用量与速率限制。
+  - `bl quota history` — 查看配额变更记录，支持分页。
+  - `bl quota request` — 申请模型临时配额提升。
+- `bl workspace list` — 列出所有业务空间，包含地域和 endpoint 信息。
 - `bl knowledge retrieve` 新增 API-Key 鉴权（DashScope 网关），与原有 AK/SK 并存，可用时自动优先使用 API-Key。
 - 新增检索参数：`--dense-similarity-top-k`、`--sparse-similarity-top-k`、`--rerank-model`、`--rerank-mode`、`--rerank-instruct`，API-Key 与 AK/SK 两条链路均支持。
 - `bailian-cli-core` 新增 `DashScopeKnowledgeRetrieveRequest` / `DashScopeKnowledgeRetrieveResponse` 类型及 `knowledgeRetrieveEndpoint` 端点。

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.zh.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.zh.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/advisor/recommend.ts

@@ -234,12 +234,12 @@ export default defineCommand({
     },
   ],
   examples: [
-    'bl advisor recommend --message "我要做一个能理解图片的客服机器人"',
-    'bl advisor recommend --message "做一个Agent自动根据用户意图生成动画片"',
-    'bl advisor recommend --message "法律合同审查，要求高精准度"',
-    'bl advisor recommend --message "做一个低成本高并发的在线客服" --output json',
-    'bl advisor recommend --message "长文本摘要" --dry-run',
-    "bl advisor recommend                                          # 交互式输入需求",
+    'bl advisor recommend --message "I need a visual-understanding chatbot"',
+    'bl advisor recommend --message "Build an Agent that auto-generates animations"',
+    'bl advisor recommend --message "Legal contract review, high precision required"',
+    'bl advisor recommend --message "Low-cost high-concurrency online customer service" --output json',
+    'bl advisor recommend --message "Long document summarization" --dry-run',
+    "bl advisor recommend                                          # Interactive input",
   ],
   async run(config: Config, flags: GlobalFlags) {
     const positional = ((flags as Record<string, unknown>)._positional as string[]) ?? [];

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,
 };