sino-bc-cli 1.8.28 → 1.8.30

package/dist/api-doc/oapi/auth.md

@@ -1,7 +1,9 @@
-# CLI设备授权
+# 访问凭证管理
 
 对应命令：`auth +<shortcut>` 与 `auth api <name>`。
 
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## 1. 获取授权链接地址
 
 `POST /platform/auth/cli/device/oauth/code`
@@ -10,6 +12,8 @@
 
 角色范围：`未声明`。
 
+风险：`read`。
+
 CLI 生成浏览器授权链接。尚未确认时只保存短期申请；同一 deviceCode 未过期重复调用返回原链接且不延长 TTL。已落库的 deviceCode 不能重新申请，返回 DENIED。本接口免登录，由 deviceCode 校验。
 
 **输入参数（--data）**
@@ -28,6 +32,8 @@ CLI 生成浏览器授权链接。尚未确认时只保存短期申请；同一
 
 角色范围：`未声明`。
 
+风险：`read`。
+
 按设备凭证查询授权状态或领取首代凭证。未确认返回 PENDING；申请过期或领取恢复窗口已过返回 EXPIRED；确认后首次领取写入授权及首代 token，宽限 300 秒内可恢复同一代结果。本接口免登录，由 deviceCode 校验。
 
 **输入参数（--data）**
@@ -44,6 +50,8 @@ CLI 生成浏览器授权链接。尚未确认时只保存短期申请；同一
 
 角色范围：`未声明`。
 
+风险：`read`。
+
 轮换刷新凭证。刷新凭证不存在、已删除、已失效或宽限外重试返回 INVALID_GRANT；首次轮换签发下一代 token 对，宽限内重试返回同一代结果，不产生分支、不延长到期。
 
 **输入参数（--data）**

package/dist/api-doc/oapi/bill.md

@@ -0,0 +1,130 @@
+# 对账单
+
+对应命令：`bill +<shortcut>` 与 `bill api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 对账单列表
+
+`POST /sino-wallet-pu/platform/wallet/bill/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按生成时间查当前主体的账单聚合列表（BillAggregation）。响应只保留列表，不含待还汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `startTime` | string | body | 是 | yyyy-MM-dd |
+| `endTime` | string | body | 是 | yyyy-MM-dd |
+| `billName` | string | body | 否 | 支持模糊 |
+| `channelIdList` | array | body | 否 | 0 代表服务费系统 |
+| `minAmount` | number | body | 否 | 账单金额最小值 |
+| `maxAmount` | number | body | 否 | 账单金额最大值 |
+| `invoiceStatusList` | array | body | 否 | 开票状态 |
+| `billTypeList` | array | body | 否 | 账单类型 |
+| `startMonth` | string | body | 否 | yyyyMM，如 202309 |
+| `endMonth` | string | body | 否 | yyyyMM，如 202310 |
+
+## 2. 对账单基本信息
+
+`GET /sino-wallet-pu/platform/wallet/bill/detail/basic`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-detail-basic --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 billId 查单条对账单金额、渠道、类型、开票状态。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `billId` | string | query | 是 | 对账单id |
+
+## 3. 对账单明细
+
+`POST /sino-wallet-pu/platform/wallet/bill/detail/original/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-original-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按对账单类型返回媒体 / 服务费 / Credit Memo / 服务费红冲其中一类明细。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billId` | string | body | 是 | 对账单id |
+
+## 4. 对账单操作历史
+
+`POST /sino-wallet-pu/platform/wallet/bill/detail/operate/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-operate-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分页查对账单操作记录。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billId` | string | body | 是 | 对账单id |
+
+## 5. 对账单与发票枚举
+
+`POST /sino-wallet-pu/platform/wallet/enum/bill-invoice/by-type/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-invoice-enum --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 types 批量取渠道、开票/还款状态、账单类型等枚举。type 必须用原文，含拼写。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `types` | array | body | 是 | 至少 1 个。INVOICE_E_FILE_TYPE 结果不可靠，下载格式请用 PDF/OFD。 |

package/dist/api-doc/oapi/biz-line-ai-strategy.md

@@ -1,6 +1,8 @@
 # 业务线AI策略
 
-对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`。
+对应命令：`biz-line-ai-strategy +<shortcut>` 与 `biz-line-ai-strategy api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 
 ## 1. 保存业务线AI策略
 
@@ -10,6 +12,8 @@
 
 角色范围：`sso/system`。
 
+风险：`write`。
+
 保存一个业务线、一个完整自然周的AI策略生成结果，返回新AI策略ID。bizLineId取自业务线列表；周期为已结束的周一至周日，默认支持2026-09-07及之后的周期（以服务配置为准）。仅优化系统管理员可调用，以BizLinePermCacheManager返回结果的admin标记为准：admin=true放行，其他情况拒绝。
 
 生成成功：generateCode传READY，提交四大策略文本、效果（1有效/2无效/3待观察）、Learning、三类标签ID列表和Excel文件存储key。标签ID从GET /sino-opti-hive/dict/items的对应策略场景查询，列表允许[]，JSON序列化后每类最多500字符；文件先上传，fileStorageKey不是下载URL。
@@ -43,3 +47,73 @@
 | `creativeStrategyLearning` | string | body | 否 | READY时必填，非空的策略效果总结及经验。 |
 | `fileStorageKey` | string | body | 否 | READY时必填；上传策略Excel后返回的存储key，不是下载URL。 |
 | `remark` | string | body | 否 | 非READY时必填，说明不能生成或生成失败的原因。 |
+
+## 2. 业务线AI策略分页列表
+
+`POST /sino-opti-hive/biz-line/ai-strategy/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system/passport`。
+
+风险：`read`。
+
+业务线AI策略分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `bizLineId` | integer | body | 否 | 业务线ID |
+| `weekStart` | string | body | 否 | 周期开始日期（周一，yyyy-MM-dd） |
+| `weekEnd` | string | body | 否 | 周期结束日期（周日，yyyy-MM-dd） |
+| `generateCode` | string | body | 否 | 生成结果状态码：READY=生成成功，NO_PROJECT=未关联项目，UNSUPPORTED_CHANNEL=渠道不支持，NO_AD_ACCOUNT=未关联广告账号，NO_DELIVERY_DATA=无投放数据，GENERATION_FAILED=生成失败 |
+
+## 3. 业务线AI策略使用日志分页列表
+
+`POST /sino-opti-hive/biz-line/ai-strategy/use-log/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system/passport`。
+
+风险：`read`。
+
+业务线AI策略使用日志分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `aiStrategyId` | integer | body | 否 | AI策略ID |
+| `operateType` | string | body | 否 | 操作类型：GET_STRATEGY=获取策略，ADOPT_STRATEGY=采用策略，REJECT_STRATEGY=暂不采用 |
+| `rejectReasonType` | string | body | 否 | 暂不采用原因类型：DATA_INACCURATE=数据不准确，CONTENT_REDUNDANT=内容太过冗余，ACTION_OMISSION_OR_ATTRIBUTION_ERROR=操作遗漏及归因错误，OTHER=其他 |
+
+## 4. 用户填写原始策略快照分页列表
+
+`POST /sino-opti-hive/biz-line/ai-strategy/snapshot/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system/passport`。
+
+风险：`read`。
+
+用户填写原始策略快照分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `aiStrategyId` | integer | body | 否 | 本次AI策略ID |
+| `strategyId` | integer | body | 否 | 策略ID |
+| `bizLineId` | integer | body | 否 | 业务线ID |
+| `year` | integer | body | 否 | 策略所属ISO周年份（跨年周可能与自然年不同） |
+| `weekStart` | string | body | 否 | 周期开始日期（周一，yyyy-MM-dd） |
+| `weekEnd` | string | body | 否 | 周期结束日期（周日，yyyy-MM-dd） |