npm - sino-bc-cli - Versions diffs - 1.8.28 → 1.8.30 - Mend

sino-bc-cli 1.8.28 → 1.8.30

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.

Files changed (144) hide show

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

@@ -1,188 +1,182 @@
-# 项目
+# 营销协同文档
 对应命令：`document +<shortcut>` 与 `document api <name>`。
-## 1. 删除项目文档
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
-`POST /sino-bc-nexus/project/document/delete`
+## 1. 协同文档详情
+`GET /sino-bc-nexus/document/detail`
 主体上下文：`tenant=true`。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-调用示例：`sino-bc-cli document api project-document-delete --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+调用示例：`sino-bc-cli document api document-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
-删除项目文档
+协同文档详情
 **输入参数（--data）**
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
-| `documentId` | integer | body | 否 | 文档ID |
+| `id` | integer | query | 是 |  |
-## 2. 查询项目文档已关联任务列表（同项目同 storage_key 的 TASK 文档行）
+## 2. 协同文档列表（全量）
-`POST /sino-bc-nexus/project/document/linked-tasks`
+`POST /sino-bc-nexus/document/list`
 主体上下文：`tenant=true`。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
-调用示例：`sino-bc-cli document api project-document-linked-tasks --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-查询项目文档已关联任务列表（同项目同 storage_key 的 TASK 文档行）
+调用示例：`sino-bc-cli document api document-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+协同文档列表（全量）
 **输入参数（--data）**
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
-| `documentId` | integer | body | 否 | 项目文档ID（doc_type=PROJECT） |
+| `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. 查询项目文档
+## 3. 协同文档列表（分页）
-`POST /sino-bc-nexus/project/document/list`
+`POST /sino-bc-nexus/document/page`
 主体上下文：`tenant=true`。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
-调用示例：`sino-bc-cli document api project-document-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-查询项目文档
+调用示例：`sino-bc-cli document api document-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+协同文档列表（分页）
 **输入参数（--data）**
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
-| `projectId` | integer | body | 否 | 项目ID |
+| `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 | 否 | 文件名（模糊匹配） |
-| `projectStageId` | integer | body | 否 | 项目阶段ID；传 0 表示「其他」（无 PROJECT_STAGE 标记或 ref_id=0） |
-## 4. 修改项目文档所属阶段
+## 4. 根据上传记录ID获取上传文件信息
-`POST /sino-bc-nexus/project/document/update-stage`
+`GET /sino-bc-nexus/file/upload-info-by-record`
 主体上下文：`tenant=true`。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-调用示例：`sino-bc-cli document api project-document-update-stage --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+调用示例：`sino-bc-cli document api file-upload-info-by-record --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
-修改项目文档所属阶段
+preview=true 表示预览文档，不记下载日志
 **输入参数（--data）**
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
-| `documentId` | integer | body | 否 | 项目文档ID |
-| `projectStageId` | integer | body | 否 | 项目阶段ID；不传或 null 表示「其他」 |
+| `fileUploadRecordId` | integer | query | 是 |  |
+| `preview` | boolean | query | 否 |  |
-## 5. 上传项目文档（multipart/form-data：projectId项目ID，file 为文件 part）
+## 5. 获取上传文件信息
-`POST /sino-bc-nexus/project/document/upload`
+`GET /sino-bc-nexus/file/upload-info`
 主体上下文：`tenant=true`。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
-调用示例：`sino-bc-cli document api project-document-upload --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-上传项目文档（multipart/form-data：projectId项目ID，file 为文件 part）
+调用示例：`sino-bc-cli document api file-upload-info --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
-编码：`multipart/form-data`；文件字段填写本地路径，`--dry-run` 只预览、不上传。
+preview=true 表示预览文档，不记下载日志
 **输入参数（--data）**
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
-| `file` | string | form | 是 | 本地文件路径；发送时读取为文件。文件 |
-| `projectId` | integer | query | 是 |  |
-| `projectStageId` | integer | query | 否 |  |
+| `storageKey` | string | query | 是 |  |
+| `preview` | boolean | query | 否 |  |
-## 6. 协同文档详情
+## 6. 文件上传
-`GET /sino-bc-nexus/document/detail`
+`POST /sino-bc-nexus/file/upload`
 主体上下文：`tenant=true`。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
-调用示例：`sino-bc-cli document api document-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-协同文档详情
+调用示例：`sino-bc-cli document api file-upload --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
-**输入参数（--data）**
+文件上传
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `id` | integer | query | 是 |  |
-## 7. 协同文档列表（全量）
-`POST /sino-bc-nexus/document/list`
-主体上下文：`tenant=true`。
-角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-调用示例：`sino-bc-cli document api document-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
-协同文档列表（全量）
+编码：`multipart/form-data`；文件字段填写本地路径，`--dry-run` 只预览、不上传。
 **输入参数（--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 | 否 | 文件名（模糊匹配） |
+| `file` | string | form | 是 | 本地文件路径；发送时读取为文件。文件 |
+| `projectId` | integer | query | 否 |  |
-## 8. 协同文档列表（分页）
+## 7. 获取上传文件链接
-`POST /sino-bc-nexus/document/page`
+`GET /sino-bc-nexus/file/url`
 主体上下文：`tenant=true`。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
-调用示例：`sino-bc-cli document api document-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-协同文档列表（分页）
+调用示例：`sino-bc-cli document api file-url --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 | 否 | 文件名（模糊匹配） |
+| `storageKey` | string | query | 是 |  |

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

@@ -2,6 +2,8 @@
 对应命令：`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`
@@ -10,7 +12,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`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>`。
@@ -30,7 +34,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`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>`。
@@ -52,7 +58,9 @@ taskId / logId 二选一。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`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>`。
@@ -81,7 +89,9 @@ taskId / logId 二选一。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli im api lark-im-message-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -102,7 +112,9 @@ taskId / logId 二选一。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli im api lark-im-message-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -133,7 +145,9 @@ taskId / logId 二选一。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`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>`。
@@ -154,7 +168,9 @@ taskId / logId 二选一。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`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>`。
@@ -175,7 +191,9 @@ taskId / logId 二选一。
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`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>`。
@@ -192,3 +210,70 @@ taskId / logId 二选一。
 | `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=true`。
+角色范围：`sso/system`。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+调用示例：`sino-bc-cli im api lark-im-message-notify --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+# 机器人通知飞书员工消息
+**输入参数（--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=true`。
+角色范围：`sso/passport/system`。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+调用示例：`sino-bc-cli im api lark-im-chat-summary-switch --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+# 群自动汇总全局开关
+## 11. 业务项目告警
+`POST /sino-bc-nexus/lark/im/chat/project-unmatched/alert`
+主体上下文：`tenant=true`。
+角色范围：`sso`。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+调用示例：`sino-bc-cli im api lark-im-chat-project-unmatched-alert --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+# 每日 Summary 群无法匹配项目告警
+**输入参数（--data）**
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `chatId` | string | body | 是 | 无法匹配项目的飞书群ID；必填，最长128字符，发送前trim |

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

@@ -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 CHANGED Viewed

@@ -1,7 +1,9 @@
-# 广告投放媒体
+# 媒体字典
 对应命令：`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`
@@ -10,4 +12,6 @@
 角色范围：`sso/system/passport`。
+风险：`read`。
 查询投放渠道列表

package/dist/api-doc/oapi/organization.md CHANGED Viewed

@@ -2,6 +2,8 @@
 对应命令：`organization +<shortcut>` 与 `organization api <name>`。
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 ## 1. 获取用户可以查看的签约主体列表
 `GET /sino-bc-nexus/corporation/list`
@@ -10,7 +12,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli organization api corporation-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -24,7 +28,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli organization api org-member-tree --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -38,7 +44,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli organization api team-member-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -52,7 +60,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli organization api user-info --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -66,7 +76,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli organization api user-listBySourceType --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。