bukesiyi-cli 0.6.0 → 0.7.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 +11 -2
- package/dist/main.js +1822 -399
- package/package.json +3 -2
- package/skills/buke/SKILL.md +52 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bukesiyi-cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0",
|
|
4
4
|
"description": "《不可思议》的命令行工具:制作 API 与网页工作台(命令名 buke)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -9,7 +9,8 @@
|
|
|
9
9
|
"files": [
|
|
10
10
|
"bin",
|
|
11
11
|
"dist",
|
|
12
|
-
"README.md"
|
|
12
|
+
"README.md",
|
|
13
|
+
"skills"
|
|
13
14
|
],
|
|
14
15
|
"engines": {
|
|
15
16
|
"node": ">=20"
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: buke
|
|
3
|
+
description: 不可思议(https://buke41.com)官方 CLI buke 的使用技能。当需要创建或查询连续短剧(drama)、商品视频(videos)、图文(graphic)、模板短片(shorts)任务,管理产品、作品、素材,查余额,或调用网页工作台固定操作目录(buke web)时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# buke ——《不可思议》AI 视频创作平台 CLI
|
|
7
|
+
|
|
8
|
+
包名 bukesiyi-cli,命令名 buke,服务地址 https://buke41.com。
|
|
9
|
+
每条命令 `buke <命令> --help` 就是它的完整用法手册;全局加 `--json` 后 stdout 只输出一个 JSON 文档(错误也是同形 JSON,带 code 和恢复提示),供脚本与 agent 解析,人读提示一律走 stderr。
|
|
10
|
+
|
|
11
|
+
## 登录与账号
|
|
12
|
+
|
|
13
|
+
- `buke login`:用 API 密钥登录并保存在本机。密钥按顺序取第一种:环境变量 `BUKE_API_KEY` → 管道 `printf '%s' "$KEY" | buke login` → 终端隐藏输入。密钥不要写进命令行参数——出现即拒绝执行。
|
|
14
|
+
- `buke whoami` 验证当前密钥;`buke logout` 删除本机密钥;`buke balance` 查余额。
|
|
15
|
+
- 网页工作台用独立会话:`buke web login --username <账号>`(密码走 `BUKE_PASSWORD`、管道或隐藏输入);会话与 API 密钥不能混用。
|
|
16
|
+
|
|
17
|
+
## 先建档,再创作
|
|
18
|
+
|
|
19
|
+
商品视频和短剧要求先有产品:`buke products create --name <名称>` → `buke products set-images <产品id> --front <图>` → `buke products confirm-lock <产品id> --color <色> --silhouette <廓形> --material <材质>`。
|
|
20
|
+
|
|
21
|
+
## 提交创作任务
|
|
22
|
+
|
|
23
|
+
- 连续短剧:`buke drama create --product <产品id> [--duration 30s|60s|90s]`;推进与文本 `buke drama status|message|document <订单id> ...`;报价确认 `buke drama quote <订单id>` 拿报价哈希 → `buke drama confirm <订单id> --quote-hash <哈希> --yes`。
|
|
24
|
+
- 商品视频:`buke videos create --product <产品id> [--intent <一句话>]`;对话推进 `buke videos message <视频id> --text <内容>`;付费确认 `buke videos confirm <视频id> --expected-version <已查看版本> --expected-credits <已查看金额> --yes`。
|
|
25
|
+
- 图文:`buke graphic create --text <制作要求> [--product <产品id>]`;出图 `buke graphic generate <项目id> --quote-hash <哈希> --yes`。
|
|
26
|
+
- 模板短片:`buke shorts catalog` 挑模板 → `buke shorts order --template <模板id> --props <props.json|->`(收费模板先 `buke shorts quote` 拿 quote-hash)。
|
|
27
|
+
|
|
28
|
+
## 一条命令收尾:result --wait
|
|
29
|
+
|
|
30
|
+
`buke drama result <订单id> --wait`、`buke videos result <视频id> --wait`、`buke graphic result <项目id> --wait`、`buke shorts result <订单id> --wait`——轮询到终态,可交付时直接落盘(`--out` 指定位置;`--timeout <秒>` 默认 600)。退出码:成功 0、任务失败 9、超时 8。
|
|
31
|
+
|
|
32
|
+
## 幂等、恢复与网页链接
|
|
33
|
+
|
|
34
|
+
- 提交类命令省略 `--idempotency-key` 时自动生成并回显;重试同一次请求必须带原键原内容,回到同一任务;失败输出的恢复提示里有可直接复制的命令,照抄执行即可。
|
|
35
|
+
- drama / videos / graphic 的提交、确认与 result 输出末尾有「网页查看:」链接(JSON 字段 `webLink`),可直接交给用户去网页端继续处理。
|
|
36
|
+
|
|
37
|
+
## 网页工作台操作目录
|
|
38
|
+
|
|
39
|
+
CLI 没有专属命令的能力走网页通道,渐进披露三步:
|
|
40
|
+
|
|
41
|
+
1. `buke web operations`:列出全部固定操作(每行:操作编号 方法 路径 说明);`--group <分组>` 筛选。
|
|
42
|
+
2. `buke web operations --json`:同一个目录的机读合同,含 method、path、body 形状、上传策略、响应类型。
|
|
43
|
+
3. `buke web call <操作编号> --params <JSON文件|-> --query <JSON文件> --data <JSON文件>` 调用。写操作必须 `--yes`;返回文件或签发密钥的操作必须 `--out <新文件>`(0600 落盘,明文不进终端)。充值与后台管理不在目录中。
|
|
44
|
+
|
|
45
|
+
## 退出码
|
|
46
|
+
|
|
47
|
+
0 成功;2 参数或用法不对;3 未登录或密钥无效、过期、无权限;4 余额不足;5 服务端或网络错误(本机凭据读写失败也是 5);6 报价已变化(重新 quote 后再确认);7 太频繁或还没到时候,稍后再试;8 等待超时;9 任务失败;10 不存在;130 被 Ctrl-C 打断。
|
|
48
|
+
|
|
49
|
+
## 更新
|
|
50
|
+
|
|
51
|
+
- `buke update`:通过 npm 全局更新自身(`npm install -g bukesiyi-cli@latest`);成功后顺带把本技能文件装到 `~/.agents/skills/buke/SKILL.md`。
|
|
52
|
+
- 启动时的版本检查可用 `BUKE_DISABLE_UPDATE_CHECK=1` 关闭;不影响 `buke update` 与技能顺装。
|