sino-bc-cli 1.8.25 → 1.8.26

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.
@@ -12,7 +12,7 @@ description: >
12
12
 
13
13
  1. **直接用本 CLI 执行**,不要自己拼网关 HTTP。地址、OpenAPI path、`Authorization`、`X-GATEWAY-TYPE: A2C-CLI` 都由 CLI 注入。
14
14
  2. **判断成功看 `ok == true` 或退出码 0**,不要看上游 `code`。信封与分流 → [`references/output-contract.md`](references/output-contract.md)。
15
- 3. **退出码 10 是写操作待确认,不是错误**。停下向用户确认意图,得到同意后在原命令末尾追加 `--yes`。**不要自行补 `--yes`**。→ [`references/write-approval.md`](references/write-approval.md)。
15
+ 3. **退出码 10 是高风险写待确认,不是错误**(仅 catalog `risk` 为 `high-risk-write`)。停下向用户确认意图,得到同意后在原命令末尾追加 `--yes`。**不要自行补 `--yes`**。→ [`references/write-approval.md`](references/write-approval.md)。
16
16
  4. **完整身份令牌(authToken,即 JWT)不要回显。**
17
17
  5. **查接口参数与风险用 `/schema`**,不要去啃 Markdown 文档猜字段。`sino-bc-cli /schema` 列清单;`sino-bc-cli /schema <name>` 返回 `inputSchema` + `_meta`(始终 JSON,默认不暴露 method/path)。
18
18
  6. **接口标记 `x-cli-tenant` 时必须成对绑定主体**:先 `/auth status` 取 `authContextId`,再 `/tenant list` 查当前身份可用主体。在任务或对话中成对保存,每次调用显式传入 `--corporation-id` 与 `--auth-context-id`。漏传且原因为 `context_required` 时可补齐已有有效绑定;认证上下文变化时清除旧绑定并重新查询主体,不能只替换认证标记。若原因为 `no_available_corporation`:当前身份没有可用签约主体,**停下告知用户联系管理员**,不要补 flag 重试,也不要再走 `/tenant list` 绑定。`--yes` 不能绕过。不要写全局主体配置。是否需要主体看 `/schema <name>` 的 `_meta.tenant`。磁盘 `identity-cache.json` 里的 passport map **不是**会话源,禁止用它回填 `--corporation-id`。
@@ -24,7 +24,7 @@
24
24
  失败写 **stderr**:
25
25
 
26
26
  ```json
27
- { "ok": false, "command": "biz-line +delete", "error": { "type": "validation", "message": "...", "hint": "..." } }
27
+ { "ok": false, "command": "biz-line +save", "error": { "type": "validation", "message": "...", "hint": "..." } }
28
28
  ```
29
29
 
30
30
  flag 解析类失败(未知 flag / 缺少取值 / 取值非法)会额外带 `error.params`,每项 `{ "name": "--foo", "reason": "unknown flag" }`,可直接拿 `name` 定位是哪个参数出错,不必从 `hint` 里正则解析。主体上下文失败同样带 `error.params[].reason`,稳定取值:`context_required`、`auth_context_changed`、`auth_required`、`no_available_corporation`。其它没有单一出错字段的失败(上游业务错误、未知接口 name)不会有这个字段。
@@ -35,7 +35,7 @@ flag 解析类失败(未知 flag / 缺少取值 / 取值非法)会额外带
35
35
  | --- | --- | --- |
36
36
  | `0` | 成功 | — |
37
37
  | `2` | `validation` / `config`:参数或配置有误 | **改命令再试**。若 `error.params[].reason` 为 `no_available_corporation`:告知用户没有可用签约主体并请联系管理员,**不要**补 `--corporation-id` / `--auth-context-id` 重试 |
38
- | `10` | `confirmation_required`:写操作待确认,不是失败 | 向用户确认后在原命令末尾追加 `--yes` 重试 |
38
+ | `10` | `confirmation_required`:高风险写待确认(仅 `high-risk-write`),不是失败 | 向用户确认后在原命令末尾追加 `--yes` 重试 |
39
39
  | `1` | `api`:上游网关或业务接口失败 | 可重试或告知用户 |
40
40
 
41
41
  ## 自动翻页
@@ -14,7 +14,7 @@ metadata:
14
14
 
15
15
  ## Core Concepts
16
16
 
17
- 业务线字典按 `sceneCode` 查询;AI 策略落库与周策略增删改不是同一条接口。
17
+ 业务线字典按 `sceneCode` 查询;AI 策略落库与周策略新建/更新不是同一条接口。
18
18
 
19
19
  - `+categories` 必填 `sceneCode`。投放品类用 `PLACEMENT_CATEGORY`,客户类型用 `CUSTOMER_TYPE`。三类策略标签分别用 `BUDGET_STRATEGY` / `MEDIA_STRATEGY` / `AUDIENCE_STRATEGY`,且必须带非空 `filterCondition`(实际字典配置值,不是业务线 ID 或场景名);缺它会得到 `[]`,不要据此判断没有标签。
20
20
  - 保存 AI 策略走 `+ai-strategy-save`。周策略仍走 `+strategy-save`。Excel 先 `common-file +upload`,把 `storageKey` 填进 `fileStorageKey`。
@@ -37,12 +37,10 @@ metadata:
37
37
  | 新建业务线 | `biz-line-save` | 角色:sso |
38
38
  | 更新业务线 | `biz-line-update` | 角色:sso |
39
39
  | 更新业务线状态 | `biz-line-status-update` | 角色:sso |
40
- | 删除业务线 | `biz-line-del` | 角色:sso;⚠️ 需 `--yes` |
41
40
  | 查询投放策略分页列表 | `biz-line-strategy-list` | 角色:sso |
42
41
  | 查询投放策略消耗信息 | `biz-line-strategy-spend` | 角色:sso |
43
42
  | 新建投放策略 | `biz-line-strategy-save` | 角色:sso |
44
43
  | 更新投放策略 | `biz-line-strategy-update` | 角色:sso |
45
- | 删除投放策略 | `biz-line-strategy-del` | 角色:sso;⚠️ 需 `--yes` |
46
44
  | 查询业务线字典和策略标签 | `biz-line-open-dict-items` | 角色:sso |
47
45
  | 查询业务线关联项目和广告账号 | `biz-line-project-list` | 角色:sso |
48
46
  | 查询项目分页列表 | `optimize-project-query-by-page` | 角色:sso |
@@ -20,7 +20,7 @@ metadata:
20
20
  - 对账单是可开票的账单聚合;月度对账单是按「主体 + 月份」打包的对账文件和邮件。不要混用。
21
21
  - 列表接口若响应还包一层 `xxxPage`,不要开 CLI 翻页;汇总字段未注册,不要传 `collectFlag` 指望拿到合计。
22
22
  - 月度对账单下载用列表里的 `fileId` 当 `storageKey`,不要用本地 `emailSendRecordId` 预览邮件。
23
- - `invoice-settlement-detail-pdf` 已废弃,多文件下载走 `+invoice-download`。
23
+ - 发票多文件下载走 `+invoice-download`。
24
24
 
25
25
  ## Shortcuts(推荐优先使用)
26
26
 
@@ -42,7 +42,6 @@ metadata:
42
42
  | 对账单关联结算单 | `bill-settlement-list` | 主体必填:`--corporation-id` 与 `--auth-context-id`;角色:passport |
43
43
  | 发票结算单列表 | `invoice-settlement-list` | 主体必填:`--corporation-id` 与 `--auth-context-id`;角色:passport |
44
44
  | 发票结算单详情 | `invoice-settlement-detail` | 主体必填:`--corporation-id` 与 `--auth-context-id`;角色:passport |
45
- | 结算单详情 PDF | `invoice-settlement-detail-pdf` | 主体必填:`--corporation-id` 与 `--auth-context-id`;角色:passport |
46
45
  | 下载发票 | `invoice-download` | 主体必填:`--corporation-id` 与 `--auth-context-id`;角色:passport |
47
46
  | 结算单还款记录 | `invoice-settlement-payment-list` | 主体必填:`--corporation-id` 与 `--auth-context-id`;角色:passport |
48
47
  | 月度对账单列表 | `bill-reconciliation-page` | 主体必填:`--corporation-id` 与 `--auth-context-id`;角色:passport |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sino-bc-cli",
3
- "version": "1.8.25",
3
+ "version": "1.8.26",
4
4
  "description": "BeyondClick CLI - 命令行工具集合,提供快捷访问 BeyondClick 平台的命令行接口",
5
5
  "preferGlobal": true,
6
6
  "bin": {