bailian-cli 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -9,7 +9,7 @@
9
9
  [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6)](https://www.typescriptlang.org)
10
10
  [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
11
11
 
12
- [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [中文文档](https://github.com/modelstudioai/cli/blob/main/README_CN.md) · [API Documentation](https://help.aliyun.com/zh/model-studio/) · [Get API Key](https://bailian.console.aliyun.com/cli?source_channel=key_github&)
12
+ [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [中文文档](https://github.com/modelstudioai/cli/blob/main/README.zh.md) · [API Documentation](https://help.aliyun.com/zh/model-studio/) · [Get API Key](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key)
13
13
 
14
14
  ---
15
15
 
@@ -35,7 +35,7 @@ Equip your AI Agent out-of-the-box with these capabilities, composable across co
35
35
  - **MCP integration** — Orchestrate Bailian MCP servers: list services, inspect tools, and invoke any tool directly from the terminal
36
36
  - **Web search** — Real-time internet retrieval for up-to-date, accurate answers
37
37
  - **Model recommendation** — Describe your scenario and get best-fit model suggestions; supports scoped search, model comparison, and alternative discovery
38
- - **Console capabilities** — Browse Bailian apps (`app list`) and check free-tier quota (`usage free`)
38
+ - **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`)
39
39
  - **Local file auto-upload** — Every URL parameter accepts a local path; uploaded to free temp storage with 48-hour validity
40
40
 
41
41
  ## Showcase: One-Sentence Cinematic Video
@@ -73,7 +73,7 @@ No timeline scrubbing. No frame-by-frame editing. Just one sentence → one vide
73
73
 
74
74
  ```bash
75
75
  npm install -g bailian-cli
76
- npx skills add modelstudioai/skills --all -g
76
+ npx skills add modelstudioai/cli --all -g
77
77
  ```
78
78
 
79
79
  > Requires Node.js >= 22.12.
@@ -108,9 +108,22 @@ bl advisor recommend --message "qwen-max vs deepseek-v3 for code generation"
108
108
  # Browser login (required for console capability commands)
109
109
  bl auth login --console
110
110
 
111
- # Browse apps / free-tier quota
111
+ # Browse apps / free-tier quota / usage statistics / workspaces
112
112
  bl app list
113
113
  bl usage free --model qwen3-max
114
+ bl usage free --expiring 30 # Quotas expiring within 30 days
115
+ bl usage free --sort remaining # Sort by remaining % ascending
116
+ bl usage stats --workspace-id <id> # Usage overview for a workspace
117
+ bl usage stats --model qwen-turbo --workspace-id <id> # Per-model usage
118
+ bl workspace list # List all workspaces
119
+
120
+ # Rate limit management
121
+ bl quota list # View RPM/TPM limits for all models
122
+ bl quota list --model qwen3.6-plus # View limits for a specific model
123
+ bl quota check # Current usage vs rate limits
124
+ bl quota check --model qwen3.6-plus --period 5 # Check usage over last 5 minutes
125
+ bl quota request --model qwen3.6-plus --tpm 6000000 # Request a temporary TPM increase
126
+ bl quota history # View quota change history
114
127
  ```
115
128
 
116
129
  > More examples and scenarios: [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
@@ -119,7 +132,7 @@ bl usage free --model qwen3-max
119
132
 
120
133
  ### DashScope API Key
121
134
 
122
- Required for most commands. Get your key from the [DashScope Console](https://bailian.console.aliyun.com/cli?source_channel=key_github&).
135
+ Required for most commands. Get your key from the [DashScope Console](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key).
123
136
 
124
137
  ```bash
125
138
  # Option 1: Environment variable
@@ -134,7 +147,7 @@ bl text chat --api-key sk-xxxxx --message "Hello"
134
147
 
135
148
  ### Console Login (OAuth)
136
149
 
137
- Required for console capability commands (`app list`, `usage free`). Opens the Bailian console in your browser to sign in.
150
+ 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.
138
151
 
139
152
  ```bash
140
153
  bl auth login --console
@@ -171,14 +184,14 @@ Config file location: `~/.bailian/config.json`
171
184
 
172
185
  ## Links
173
186
 
174
- | Resource | URL |
175
- | :--------------------------- | :---------------------------------------------------------------- |
176
- | Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
177
- | DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
178
- | Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
179
- | Aliyun Model Studio Console | https://bailian.console.aliyun.com/ |
180
- | Get API Key | https://bailian.console.aliyun.com/cli?source_channel=key_github& |
181
- | Get AccessKey | https://ram.console.aliyun.com/manage/ak |
187
+ | Resource | URL |
188
+ | :--------------------------- | :---------------------------------------------------------------------------------------- |
189
+ | Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
190
+ | DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
191
+ | Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
192
+ | Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
193
+ | Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
194
+ | Get AccessKey | https://ram.console.aliyun.com/manage/ak |
182
195
 
183
196
  ## Changelog
184
197
 
@@ -9,7 +9,7 @@
9
9
  [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6)](https://www.typescriptlang.org)
10
10
  [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
11
11
 
12
- [阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [English](https://github.com/modelstudioai/cli/blob/main/README.md) · [API 文档](https://help.aliyun.com/zh/model-studio/) · [获取 API Key](https://bailian.console.aliyun.com/cli?source_channel=key_github&)
12
+ [阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [English](https://github.com/modelstudioai/cli/blob/main/README.md) · [API 文档](https://help.aliyun.com/zh/model-studio/) · [获取 API Key](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key)
13
13
 
14
14
  ---
15
15
 
@@ -35,7 +35,7 @@ _专为 AI Agent 打造,每个命令均可作为结构化工具调用。_
35
35
  - **MCP 集成** — 统一调度百炼 MCP 服务:列出服务、查看工具、直接在终端调用任意工具
36
36
  - **联网搜索** — 实时互联网信息检索,提升回答准确性及时效性
37
37
  - **模型推荐** — 描述你的场景,智能推荐最适合的模型;支持限定范围搜索、模型对比和替代发现
38
- - **控制台能力** — 浏览百炼应用(`app list`),查询模型免费额度(`usage free`)
38
+ - **控制台能力** — 浏览百炼应用(`app list`),查询模型免费额度(`usage free`),查看模型用量统计(`usage stats`),管理业务空间(`workspace list`),管理限流与提额(`quota list/request/check/history`)
39
39
  - **本地文件自动上传** — 所有 URL 参数同时支持本地路径,免费临时存储 48 小时
40
40
 
41
41
  ## 示例:一句话生成一部电影短片
@@ -71,7 +71,7 @@ _专为 AI Agent 打造,每个命令均可作为结构化工具调用。_
71
71
 
72
72
  ```bash
73
73
  npm install -g bailian-cli
74
- npx skills add modelstudioai/skills --all -g
74
+ npx skills add modelstudioai/cli --all -g
75
75
  ```
76
76
 
77
77
  > 需要预先安装 Node.js >= 22.12。
@@ -103,9 +103,22 @@ bl advisor recommend --message "qwen-max 和 deepseek-v3 哪个更适合做代
103
103
  # 浏览器登录(控制台能力相关命令需要)
104
104
  bl auth login --console
105
105
 
106
- # 浏览应用 / 免费额度
106
+ # 浏览应用 / 免费额度 / 用量统计 / 业务空间
107
107
  bl app list
108
108
  bl usage free --model qwen3-max
109
+ bl usage free --expiring 30 # 30 天内过期的额度
110
+ bl usage free --sort remaining # 按剩余百分比升序排列
111
+ bl usage stats --workspace-id <id> # 指定空间的用量概览
112
+ bl usage stats --model qwen-turbo --workspace-id <id> # 指定模型用量
113
+ bl workspace list # 列出所有业务空间
114
+
115
+ # 限流管理与提额
116
+ bl quota list # 查看所有模型的 RPM/TPM 限额
117
+ bl quota list --model qwen3.6-plus # 查看指定模型限额
118
+ bl quota check # 查看当前用量 vs 限流阈值
119
+ bl quota check --model qwen3.6-plus --period 5 # 查看最近 5 分钟用量
120
+ bl quota request --model qwen3.6-plus --tpm 6000000 # 申请临时 TPM 提额
121
+ bl quota history # 查看提额历史记录
109
122
  ```
110
123
 
111
124
  > 更多案例与使用场景:[阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
@@ -114,7 +127,7 @@ bl usage free --model qwen3-max
114
127
 
115
128
  ### DashScope API Key
116
129
 
117
- 大部分命令均需要 API Key。前往 [DashScope 控制台](https://bailian.console.aliyun.com/cli?source_channel=key_github&) 获取。
130
+ 大部分命令均需要 API Key。前往 [DashScope 控制台](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key) 获取。
118
131
 
119
132
  ```bash
120
133
  # 方式一:环境变量
@@ -129,7 +142,7 @@ bl text chat --api-key sk-xxxxx --message "你好"
129
142
 
130
143
  ### 控制台登录(OAuth)
131
144
 
132
- 控制台能力命令(`app list`、`usage free`)需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。
145
+ 控制台能力命令(`app list`、`usage free`、`usage stats`、`workspace list`、`quota list/request/check/history`)需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。
133
146
 
134
147
  ```bash
135
148
  bl auth login --console
@@ -166,19 +179,19 @@ bl update
166
179
 
167
180
  ## 相关链接
168
181
 
169
- | 资源 | 地址 |
170
- | :---------------------- | :---------------------------------------------------------------- |
171
- | 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
172
- | DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
173
- | 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
174
- | 阿里云百炼控制台 | https://bailian.console.aliyun.com/ |
175
- | 获取 API Key | https://bailian.console.aliyun.com/cli?source_channel=key_github& |
176
- | 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
182
+ | 资源 | 地址 |
183
+ | :---------------------- | :---------------------------------------------------------------------------------------- |
184
+ | 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
185
+ | DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
186
+ | 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
187
+ | 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
188
+ | 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
189
+ | 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
177
190
 
178
191
  ## 更新日志
179
192
 
180
- 每个版本的变更详情记录在 [CHANGELOG_CN.md](https://github.com/modelstudioai/cli/blob/main/CHANGELOG_CN.md)。
193
+ 每个版本的变更详情记录在 [CHANGELOG.zh.md](https://github.com/modelstudioai/cli/blob/main/CHANGELOG.zh.md)。
181
194
 
182
195
  ## 参与贡献
183
196
 
184
- 欢迎提 Issue、Feature Request 和 PR。开发环境搭建、仓库结构、新增/修改命令的工作流请见 [CONTRIBUTING_CN.md](https://github.com/modelstudioai/cli/blob/main/CONTRIBUTING_CN.md)。
197
+ 欢迎提 Issue、Feature Request 和 PR。开发环境搭建、仓库结构、新增/修改命令的工作流请见 [CONTRIBUTING.zh.md](https://github.com/modelstudioai/cli/blob/main/CONTRIBUTING.zh.md)。