sino-bc-cli 1.0.0-beta.0

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

@@ -0,0 +1,21 @@
+# 后付额度
+
+对应命令：`quota +<shortcut>` 与 `quota api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 后付信用额度
+
+`GET /sino-wallet-pu/platform/quota/credit/info`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli quota api quota-credit-info --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查当前主体后付授信与使用率；非后付不展示。

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

@@ -0,0 +1,98 @@
+# 月度对账单
+
+对应命令：`reconciliation +<shortcut>` 与 `reconciliation api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 月度对账单列表
+
+`POST /sino-wallet-pu/platform/bill-reconciliation/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli reconciliation api bill-reconciliation-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按月份区间分页查标准化对账文件（主体+月份，通常每月一条）。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billMonthStart` | string | body | 是 | yyyy-MM |
+| `billMonthEnd` | string | body | 是 | yyyy-MM |
+
+## 2. 月度对账单发送记录
+
+`POST /sino-wallet-pu/platform/bill-reconciliation/send-log/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli reconciliation api bill-reconciliation-send-log --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按账单月份分页查邮件发送记录。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billMonth` | string | body | 是 | yyyy-MM |
+
+## 3. 对账邮件预览
+
+`POST /sino-wallet-pu/platform/bill-reconciliation/send-log/preview`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli reconciliation api bill-reconciliation-email-preview --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按业财发送记录 id 返回邮件 HTML。不要用列表里的本地 emailSendRecordId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `sendRecordId` | integer | body | 是 | 发送记录页的 sendRecordId |
+
+## 4. 月度对账单下载链接
+
+`GET /sino-wallet-pu/platform/bill-reconciliation/generate/download-url`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli reconciliation api bill-reconciliation-download-url --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+用文件 storageKey（即列表 fileId）换 3 小时有效下载/预览 URL。不要传 corporationId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `storageKey` | string | query | 是 | 文件存储 key，即列表 fileId |

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

@@ -0,0 +1,254 @@
+# 报表相关
+
+对应命令：`report +<shortcut>` 与 `report api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 查询项目维度筛选列表
+
+`POST /sino-bc-nexus/project/delivery-data/detail-choose-list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-delivery-data-detail-choose-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查询项目维度筛选列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | 排序字段 |
+| `sortDirection` | string | body | 否 | 排序方向 ASC/DESC |
+| `projectId` | integer | body | 否 | 项目id |
+| `dimension` | string | body | 否 |  |
+| `keywords` | string | body | 否 | 关键词搜索 |
+
+## 2. 查询项目成效列表
+
+`POST /sino-bc-nexus/project/delivery-data/detail-list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-delivery-data-detail-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查询项目成效列表
+
+### 日期字段说明（代码同步）
+入参 startDate/endDate 继承自 ICenter QueryParameter，格式 yyyy-MM-dd，例如 2026-09-16、2026-09-30。响应 DataView 的 data/dataList 为动态维度值，日期列按 ICenter 原样透传，以 header 及实际粒度为准，不统一转换日期格式。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目id |
+| `startDate` | string | body | 否 | 统计开始日期；继承自 ICenter QueryParameter；JSON 字符串，格式 yyyy-MM-dd，仅日期；示例：2026-09-16 |
+| `endDate` | string | body | 否 | 统计结束日期；继承自 ICenter QueryParameter；JSON 字符串，格式 yyyy-MM-dd，仅日期；示例：2026-09-30 |
+
+## 3. 维度分布
+
+`POST /sino-bc-nexus/project/delivery-data/dimension-module`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-delivery-data-dimension-module --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+维度分布
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目id |
+| `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
+| `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
+| `dimensionTab` | string | body | 否 | REGION / MEDIA / GOAL |
+| `regionLevel` | string | body | 否 | REGION 时必填：REGION / COUNTRY |
+| `topN` | integer | body | 否 | 维度分布取前 N 名，默认 5 |
+
+## 4. KPI 进度与走势
+
+`POST /sino-bc-nexus/project/delivery-data/kpi-module`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-delivery-data-kpi-module --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+KPI 进度与走势
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目id |
+| `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
+| `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
+
+## 5. 消耗分析
+
+`POST /sino-bc-nexus/project/delivery-data/spend-module`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-delivery-data-spend-module --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+消耗分析
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目id |
+| `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
+| `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
+
+## 6. 核心指标卡
+
+`POST /sino-bc-nexus/project/delivery-data/core-metrics`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-delivery-data-core-metrics --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+核心指标卡
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目id |
+| `startDate` | string | body | 否 | 统计开始时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `endDate` | string | body | 否 | 统计结束时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-16 14:30:00 |
+| `granularity` | string | body | 否 | 时间粒度 DAY / WEEK；默认 WEEK，周期不足 2 周时默认 DAY |
+| `stageId` | integer | body | 否 | 投放阶段 ID（取自 stage-tabs）；>0 为阶段主键；0 强制项目总览； |
+| `indicators` | array | body | 否 | 选择指标 key 有序列表（来自 KA 指标卡配置） |
+
+## 7. 分页查询项目自动归集广告系列
+
+`POST /sino-bc-nexus/project/campaign/setting/campaign/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-campaign-setting-campaign-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分页查询项目自动归集广告系列
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | 排序字段 |
+| `sortDirection` | string | body | 否 | 排序方向 ASC/DESC |
+| `projectId` | integer | body | 否 | 项目id |
+| `campaignId` | string | body | 否 | 广告系列id（模糊匹配） |
+| `campaignName` | string | body | 否 | 广告系列名称（模糊匹配） |
+
+## 8. 查询广告系列设置
+
+`POST /sino-bc-nexus/project/campaign/setting/get`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-campaign-setting-get --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查询广告系列设置
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目id |
+
+## 9. 保存广告系列设置
+
+`POST /sino-bc-nexus/project/campaign/setting/save`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli report api project-campaign-setting-save --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+保存广告系列设置
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 项目id |
+| `autoRules` | array | body | 否 |  |
+| `manualCampaigns` | array | body | 否 |  |
+| `excludeCampaigns` | array | body | 否 |  |
+| `channelIds` | array | body | 否 | 渠道id列表，为空表示全部渠道 |
+| `exampleCampaignId` | string | body | 否 | 示例Campaign id |
+| `exampleCampaignName` | string | body | 否 | 示例Campaign名称 |
+| `splitStr` | string | body | 否 | 分隔符 |
+| `matchConditions` | array | body | 否 |  |
+| `conditionLogic` | string | body | 否 | 条件逻辑：ALL-且，ANY-或 |
+| `position` | integer | body | 否 | 第N位 |
+| `operator` | string | body | 否 | 运算符：eq-等于，contains-包含 |
+| `keyword` | string | body | 否 | 匹配关键词 |
+| `campaignId` | string | body | 否 | 广告系列id |
+| `campaignName` | string | body | 否 | 广告系列名称 |

package/dist/api-doc/oapi/sso-team-group.md

@@ -0,0 +1,54 @@
+# 优化组别
+
+对应命令：`sso-team-group +<shortcut>` 与 `sso-team-group api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 优化组别列表
+
+`POST /sino-opti-hive/sso-team/group-manage/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询优化组别列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `leaderUserName` | string | body | 否 | 组长名称，支持模糊搜索 |
+| `industryList` | array | body | 否 | 枚举值：APP：游戏 ECBR：电商品牌 GAME：游戏 |
+
+## 2. 优化组别详情
+
+`GET /sino-opti-hive/sso-team/group-manage/detail`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+组别详情
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `code` | string | query | 是 | 部门code，可从优化组别列表获取 |
+
+## 3. 优化组别选项列表
+
+`GET /sino-opti-hive/sso-team/group-list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+查询组别列表(优化组别)