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 CHANGED
@@ -86,7 +86,7 @@ npm install -g bukesiyi-cli
86
86
 
87
87
  ```console
88
88
  $ buke --version
89
- bukesiyi-cli/0.5.0
89
+ bukesiyi-cli/0.7.0
90
90
  ```
91
91
 
92
92
  也可使用 `npx bukesiyi-cli <命令>` 临时运行,例如 `npx bukesiyi-cli whoami`。
@@ -162,9 +162,11 @@ $ buke login bk_test_0123456789abcdef_……
162
162
  | `buke drama` | 短剧创作、剧本和分镜、人物与场景绑定、规格、报价、重拍、选版和交付 |
163
163
  | `buke series list / show / create / episode-create` | 查询剧集、关联首集、创建续集 |
164
164
  | `buke graphic` | 图文方案、报价生成、局部修改、版本管理和下载 |
165
+ | `buke shorts|videos|drama|graphic result` | 一条命令查状态并取件:已交付就下载,未交付说明下一步;支持 `--wait` |
165
166
  | `buke library list / search / show / rename / archive / restore` | 统一查询和管理作品;以返回的 `archivable` 为准 |
166
167
  | `buke assets list / search / show / upload / rename / archive / restore` | 查询平台、个人及上传素材,上传文件并管理个人素材 |
167
168
  | `buke --version` | 输出版本号 |
169
+ | `buke update` | 通过 npm 自更新到最新版;启动时的版本提示可用 `BUKE_DISABLE_UPDATE_CHECK` 关闭 |
168
170
  | `buke --help`、`buke <命令> --help` | 输出命令及选项帮助 |
169
171
 
170
172
  写操作支持 `--idempotency-key <键>`。未指定时,CLI 自动生成并在结果中返回。重试同一操作必须保留原键和请求内容;新键表示新尝试,可能产生新订单及费用。模板短片的报价哈希与幂等键绑定,`shorts quote` 和 `shorts order` 必须使用相同键。
@@ -185,6 +187,10 @@ $ buke login bk_test_0123456789abcdef_……
185
187
 
186
188
  `drama create` 支持 `--model` 和 `--resolution`。未显式指定模型时,报价前可适配人物参考;显式指定不兼容模型时进入需要处理的状态,不自动替换。`drama quote` 展示实际制作规格、费用及适配说明。
187
189
 
190
+ 四条创作线的 `result` 子命令把查询和取件合成一步:查一次状态,已交付就直接下载(缺省名 `drama-<编号>.mp4` 等,图文进 `--out` 目录,缺省 `graphic-<编号>/`),失败或取消按 9 退出;`--wait` 沿用对应线 status 的等待语义(超时 8、失败或取消 9、停靠态 0)。短剧、商品视频、图文与短剧的提交类和查询类命令,可读输出带一行「网页查看」、`--json` 顶层带 `webLink` 字段,可在浏览器直接打开原任务;短剧模板短片无对应网页,不返回该字段。
191
+
192
+ 启动时 CLI 检查 npm 上的最新版本(2 秒封顶、失败静默、结果缓存 24 小时),有新版时在标准错误提示;设 `BUKE_DISABLE_UPDATE_CHECK` 为非空值可关闭。`buke update` 等价于 `npm install -g bukesiyi-cli@latest`,失败退出 5 并给出手动命令。
193
+
188
194
  短剧普通状态 JSON 可包含 `order.productionCompatibility` 和 `order.failures`。等待终态失败时,失败数组位于 JSON 顶层 `failures`,与 `error`、`recovery` 并列。素材定位不可确认时返回 `reference: null`,不推测具体图片;旧记录不会自动补齐证据。修正素材或通过 `drama spec` 明确修改规格后,须重新报价和确认,CLI 不自动切换模型或付费重试。
189
195
 
190
196
  ## 创作与管理示例
@@ -269,13 +275,15 @@ $ buke whoami --json
269
275
  | `BUKE_API_KEY` | 优先使用的 API 密钥;设置后不读取本机凭据文件。`login` 验证后将其保存至本机 |
270
276
  | `BUKE_BASE_URL` | 服务源地址。`--base-url` 优先于该变量;未配置时使用 `https://buke41.com` |
271
277
  | `BUKE_CONFIG_DIR` | 凭据目录,须为绝对路径,支持展开开头的 `~`。默认依次采用 `$XDG_CONFIG_HOME/buke`、`~/.config/buke`;Windows 使用 `%APPDATA%\buke` |
278
+ | `BUKE_DISABLE_KEYCHAIN` | 设为 `1` 即强制把密钥存进 0600 凭据文件,不读写 macOS 登录钥匙串;Windows/Linux 本就不使用钥匙串 |
279
+ | `BUKE_DISABLE_UPDATE_CHECK` | 设为非空值即关闭启动时的版本检查(不联网、不提示);`buke update` 不受影响 |
272
280
  | `BUKE_PASSWORD` | 网页会话登录密码;只在登录时使用,可改用隐藏终端输入 |
273
281
  | `BUKE_SESSION_TOKEN` | 受控环境提供的真实网页会话令牌;不能使用 API 密钥 |
274
282
  | `BUKE_WORKSPACE_ID` | 网页会话工作区;`--workspace` 优先,调用前核对真实成员身份 |
275
283
 
276
284
  网页会话额外支持 `BUKE_PASSWORD`(仅登录时读取)、`BUKE_SESSION_TOKEN`(受控环境提供真实会话)和 `BUKE_WORKSPACE_ID`(工作区,显式 `--workspace` 优先并核对成员身份)。
277
285
 
278
- API 密钥保存在 `credentials.json`,网页会话保存在同目录的 `session.json`。macOS 和 Linux 上文件权限仅允许当前用户读写。文件包含明文凭据,不得提交至代码仓库、写入镜像或直接共享。
286
+ API 密钥保存在 `credentials.json`,网页会话保存在同目录的 `session.json`。macOS 和 Linux 上文件权限仅允许当前用户读写。文件包含明文凭据,不得提交至代码仓库、写入镜像或直接共享。macOS 上 `login` 优先把密钥存进登录钥匙串(`bukesiyi-cli/api-key`)并删除明文文件,钥匙串不可用时才落 0600 文件;设 `BUKE_DISABLE_KEYCHAIN=1` 可强制用文件。写入钥匙串时密钥会短暂出现在 `security` 命令行参数上,介意者可改用 `BUKE_API_KEY` 环境变量。
279
287
 
280
288
  启用 Node.js 环境代理时,CLI 会拒绝可能经代理传输密钥的本机 HTTP 请求。本机调试可通过 `NO_PROXY` 排除回环地址:
281
289
 
@@ -320,6 +328,7 @@ export NO_PROXY='localhost,127.0.0.1,[::1]'
320
328
  | `CLI_CREDENTIALS_WRITE_FAILED` | 5 | 无法保存或删除凭据。修正目录权限,或通过 `BUKE_CONFIG_DIR` 指定可写目录 |
321
329
  | `CLI_NETWORK` | 5 | 网络连接失败。检查地址、网络、代理和证书;确认配置正确后有限重试 |
322
330
  | `CLI_TIMEOUT` | 5 | 请求超过时限;JSON 请求默认 15 秒、成片下载默认 120 秒。检查网络或代理;涉及提交时先核对原请求结果 |
331
+ | `CLI_UPDATE_FAILED` | 5 | `buke update` 未完成自动更新。按错误消息里的手动命令运行 `npm install -g bukesiyi-cli@latest`;网络或权限恢复后可重试 |
323
332
  | `CLI_REDIRECT` | 5 | 目标服务返回重定向,CLI 未跟随。核对服务源地址后重新登录 |
324
333
  | `CLI_BAD_RESPONSE` | 5 | 响应不符合 API 结构。检查服务地址、代理或网关;仅对可重试状态采用有限退避 |
325
334
  | `CLI_DOWNLOAD_NOT_READY` | 7 | 下载接口返回 HTTP 202,文件尚未就绪。查询原任务后再次下载;CLI 不保存响应为成片、不自动重试,也不重新生成 |