sino-bc-cli 1.0.0-beta.0

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

@@ -0,0 +1,49 @@
+# 通用字典
+
+对应命令：`dict +<shortcut>` 与 `dict api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 按场景查询字典条目
+
+`GET /sino-bc-nexus/dict/items`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dict api dict-items --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按场景查询字典条目
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `sceneCodes` | array | query | 是 | 场景编码列表；实际参数名sceneCodes。可传sceneCodes=TYPE,REGION，或sceneCodes=TYPE&sceneCodes=REGION。 |
+
+## 2. 按作用域查询字典场景
+
+`GET /sino-bc-nexus/dict/scenes`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli dict api dict-scenes --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按作用域查询字典场景
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bizScope` | string | query | 否 | 业务用途筛选，如PROJECT、TASK；省略或空白不筛选。 |

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

@@ -0,0 +1,182 @@
+# 营销协同文档
+
+对应命令：`document +<shortcut>` 与 `document api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 协同文档详情
+
+`GET /sino-bc-nexus/document/detail`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli document api document-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+协同文档详情
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | query | 是 |  |
+
+## 2. 协同文档列表（全量）
+
+`POST /sino-bc-nexus/document/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli document api document-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+协同文档列表（全量）
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `docType` | string | body | 否 | 文档业务类型 |
+| `docTypeList` | array | body | 否 | 文档业务类型列表 |
+| `projectId` | integer | body | 否 | 所属项目ID |
+| `refType` | string | body | 否 | 关联对象类型 |
+| `refTypeList` | array | body | 否 | 关联对象类型列表 |
+| `refId` | integer | body | 否 | 关联对象ID |
+| `refIdList` | array | body | 否 | 关联对象ID列表 |
+| `fileName` | string | body | 否 | 文件名（模糊匹配） |
+
+## 3. 协同文档列表（分页）
+
+`POST /sino-bc-nexus/document/page`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli document api document-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 |
+| `docType` | string | body | 否 | 文档业务类型 |
+| `docTypeList` | array | body | 否 | 文档业务类型列表 |
+| `projectId` | integer | body | 否 | 所属项目ID |
+| `refType` | string | body | 否 | 关联对象类型 |
+| `refTypeList` | array | body | 否 | 关联对象类型列表 |
+| `refId` | integer | body | 否 | 关联对象ID |
+| `refIdList` | array | body | 否 | 关联对象ID列表 |
+| `fileName` | string | body | 否 | 文件名（模糊匹配） |
+
+## 4. 根据上传记录ID获取上传文件信息
+
+`GET /sino-bc-nexus/file/upload-info-by-record`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli document api file-upload-info-by-record --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+preview=true 表示预览文档，不记下载日志
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `fileUploadRecordId` | integer | query | 是 |  |
+| `preview` | boolean | query | 否 |  |
+
+## 5. 获取上传文件信息
+
+`GET /sino-bc-nexus/file/upload-info`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli document api file-upload-info --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+preview=true 表示预览文档，不记下载日志
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `storageKey` | string | query | 是 |  |
+| `preview` | boolean | query | 否 |  |
+
+## 6. 文件上传
+
+`POST /sino-bc-nexus/file/upload`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli document api file-upload --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+文件上传
+
+编码：`multipart/form-data`；文件字段填写本地路径，`--dry-run` 只预览、不上传。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `file` | string | form | 是 | 本地文件路径；发送时读取为文件。文件 |
+| `projectId` | integer | query | 否 |  |
+
+## 7. 获取上传文件链接
+
+`GET /sino-bc-nexus/file/url`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli document api file-url --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+获取上传文件链接
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `storageKey` | string | query | 是 |  |

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

@@ -0,0 +1,278 @@
+# 飞书IM
+
+对应命令：`im +<shortcut>` 与 `im api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 查询会话成员
+
+`POST /sino-bc-nexus/lark/im/chat/members`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-chat-members --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+必填 chatId。返回 t_lark_im_chat_member 未删除成员，按入群时间旧→新。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 否 | 飞书会话 ID |
+
+## 2. 查询任务或项目日志关联的飞书聊天记录
+
+`POST /sino-bc-nexus/lark/im/lark-chat/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-lark-chat-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+taskId / logId 二选一。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `taskId` | integer | body | 否 | 任务 ID，与 logId 二选一；传 taskId 时汇总该任务下操作日志关联聊天 |
+| `logId` | integer | body | 否 | 操作日志 ID，与 taskId 二选一；配合 logType 只查这一条日志关联的聊天 |
+| `logType` | string | body | 否 | 日志类型，与 logId 同传。TASK_ACTION_LOG=任务操作日志，PROJECT_ACTION_LOG=项目操作日志 |
+
+## 3. 锚点翻页查询群消息
+
+`POST /sino-bc-nexus/lark/im/message/cursor`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-message-cursor --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+必填 chatId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | 排序字段 |
+| `sortDirection` | string | body | 否 | 排序方向 ASC/DESC |
+| `chatId` | string | body | 否 | 飞书会话 ID |
+| `startMessageId` | string | body | 否 | 任务起始消息 ID（om_）；首次无 cursor 时与 threadId 至少一个。翻页有 cursor 后非必填。不裁剪范围 |
+| `endMessageId` | string | body | 否 | 任务结束消息 ID（om_，可选）；不裁剪范围，用于给本页打 isEndMessage |
+| `threadId` | string | body | 否 | 话题 ID（omt_）；传了则翻页只在该话题内 |
+| `cursorMessageId` | string | body | 否 | 翻页锚点消息 ID（om_）；上一页用当前页第一条，下一页用最后一条 |
+| `direction` | object | body | 否 | 翻页方向：BEFORE 更早 / AFTER 更晚；有 cursorMessageId 时必填 |
+
+## 4. 按 chatId + messageId 查询消息明细
+
+`POST /sino-bc-nexus/lark/im/message/detail`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+必填 chatId、messageId；消息须属于该会话。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 否 | 飞书会话 ID |
+| `messageId` | string | body | 否 | 消息 ID（om_） |
+
+## 5. 分页查询群消息
+
+`POST /sino-bc-nexus/lark/im/message/page`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+必填 chatId。
+
+### 日期字段说明（代码同步）
+必填 chatId。可选 senderOpenId、消息时间 startTime/endTime（yyyy-MM-dd HH:mm:ss，含边界）、keyword 模糊匹配 display_text 展示摘要。按 message_create_time 新→旧标准分页（pageNum/pageSize）。出参标明 MAIN/THREAD 归属；话题内回复回 threadRootMessageId。不含引用标记、表情回复。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | 排序字段 |
+| `sortDirection` | string | body | 否 | 排序方向 ASC/DESC |
+| `chatId` | string | body | 否 | 飞书会话 ID |
+| `senderOpenId` | string | body | 否 | 发送者 open_id |
+| `startTime` | string | body | 否 | 消息创建时间起（含）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-01 00:00:00 |
+| `endTime` | string | body | 否 | 消息创建时间止（含）；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；时区 GMT+8（UTC+08:00）；示例：2026-09-02 23:59:59 |
+| `keyword` | string | body | 否 | 内容关键字，模糊匹配 display_text 展示摘要 |
+
+## 6. 按引用链根查询根消息及全部回复
+
+`POST /sino-bc-nexus/lark/im/message/replies`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-message-replies --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+必填 chatId、rootId（被回复那条的 messageId）。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 否 | 飞书会话 ID |
+| `rootId` | string | body | 否 | 引用链根消息 ID（om_），即被回复那条的 messageId |
+
+## 7. 查询消息归属（主群或话题）
+
+`POST /sino-bc-nexus/lark/im/message/scope`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-message-scope --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+必填 chatId、messageId。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 否 | 飞书会话 ID |
+| `messageId` | string | body | 否 | 待判定的消息 ID（om_） |
+
+## 8. 应用机器人发送消息（卡片）
+
+`POST /sino-bc-nexus/lark/im/message/send`
+
+主体上下文：`tenant=true`。
+
+角色范围：`sso/passport/system`。
+
+风险：`write`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-message-send --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+以当前环境 Apollo 应用（cli_aaf316a98c39dbeb 等）的 tenant_access_token 调用飞书 OpenAPI。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 否 | 接收者 ID：群聊 chat_id（oc_）或单聊 open_id（ou_）。回复时可不传 |
+| `receiveIdType` | string | body | 否 | 接收者类型，默认 chat_id。可选 chat_id / open_id / user_id / email |
+| `msgType` | string | body | 否 | 消息类型，默认 interactive（卡片）。可选 text / post / image 等 |
+| `content` | object | body | 否 | 消息体：卡片 JSON 对象或已字符串化的 JSON。 |
+| `uuid` | string | body | 否 | 幂等键；1 小时内相同 uuid 只发一次 |
+| `replyMessageId` | string | body | 否 | 回复的消息 ID（om_）。有值则走 reply，不再按 chatId 新发 |
+| `replyInThread` | boolean | body | 否 | reply 时是否进话题。true=话题内回复，false/空=主群引用回复 |
+
+## 9. 机器人通知飞书员工
+
+`POST /sino-bc-nexus/lark/im/message/notify`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+# 机器人通知飞书员工消息
+
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | body | 否 | 可选项目ID；无指定员工号和任务ID时取项目全部PM_POC |
+| `taskId` | integer | body | 否 | 可选任务ID；无指定员工号时取任务全部EXECUTOR，优先于项目ID |
+| `employeeNumbers` | array | body | 否 | 可选指定员工号；非空优先于任务及项目，第一阶段忽略；后端trim并校验S开头数字 |
+| `msgType` | string | body | 是 | 原生飞书消息类型，如text、post、interactive；不限定枚举，格式匹配由飞书校验 |
+| `content` | object | body | 是 | 原生飞书JSON内容对象；仅序列化一次，不拼接业务文案，不接受JSON字符串 |
+| `requestId` | string | body | 是 | 本次发送唯一标识；相同内容重试沿用，改内容须换新标识 |
+
+## 10. 查询群自动汇总全局开关
+
+`GET /sino-bc-nexus/lark/im/chat/summary/switch`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+# 群自动汇总全局开关
+
+## 11. 业务项目告警
+
+`POST /sino-bc-nexus/lark/im/chat/project-unmatched/alert`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+# 每日 Summary 群无法匹配项目告警
+
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 是 | 无法匹配项目的飞书群ID；必填，最长128字符，发送前trim |
+| `description` | string | body | 否 | 报警描述 |
+
+## 12. 查询项目通知及自动创建任务配置
+
+`GET /sino-bc-nexus/lark/im/chat/summary/task-config`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport`。
+
+风险：`read`。
+
+按项目查询通知对象和自动创建任务配置，需当前主体及项目查询权限。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | query | 是 | 项目ID，正整数 |

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

@@ -0,0 +1,129 @@
+# 发票结算单
+
+对应命令：`invoice +<shortcut>` 与 `invoice api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 对账单关联结算单
+
+`GET /sino-wallet-pu/platform/wallet/bill/detail/settlement/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli invoice api bill-settlement-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查某张对账单下已开的发票结算单，不分页。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `billId` | string | query | 是 | 账单id |
+
+## 2. 发票结算单列表
+
+`POST /sino-wallet-pu/invoice/settlement/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli invoice api invoice-settlement-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按申请时间查当前主体的结算单列表。响应只保留列表，不含待还汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `startTime` | string | body | 是 | yyyy-MM-dd |
+| `endTime` | string | body | 是 | yyyy-MM-dd |
+| `invoiceSettlementId` | string | body | 否 | 结算单id |
+| `billIdList` | array | body | 否 | 账单id列表 |
+| `name` | string | body | 否 | 模糊 |
+| `paymentStatusList` | array | body | 否 | 还款状态 |
+| `issuanceStatusList` | array | body | 否 | 开票状态 |
+| `invoiceTypeList` | array | body | 否 | 发票形式 |
+| `invoiceVatTypeList` | array | body | 否 | VAT发票类型 |
+| `minAmount` | number | body | 否 | 金额起始 |
+| `maxAmount` | number | body | 否 | 金额截止 |
+| `collectFlag` | boolean | body | 否 | 本契约丢弃汇总，可不传 |
+
+## 3. 发票结算单详情
+
+`GET /sino-wallet-pu/invoice/settlement/detail`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli invoice api invoice-settlement-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按结算单号查开票金额、税费、发票/VAT 明细与预览地址。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `invoiceSettlementId` | string | query | 是 | 发票编号/结算单id |
+
+## 4. 下载发票
+
+`POST /sino-wallet-pu/invoice/settlement/invoice/download`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli invoice api invoice-download --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按结算单号和 PDF/OFD 返回发票下载 URL 列表。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `invoiceSettlementId` | string | body | 是 | 结算单id |
+| `fileType` | string | body | 是 | 发票格式 |
+
+## 5. 结算单还款记录
+
+`POST /sino-wallet-pu/invoice/settlement/payment/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli invoice api invoice-settlement-payment-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+查结算单还款历史。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `invoiceSettlementId` | string | body | 是 | 结算单id |

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

@@ -0,0 +1,17 @@
+# 媒体字典
+
+对应命令：`media +<shortcut>` 与 `media api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 查询投放渠道列表
+
+`GET /bc-business-pu/media/queryChannelInfo`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system/passport`。
+
+风险：`read`。
+
+查询投放渠道列表