sino-bc-cli 1.8.25 → 1.8.27

package/README.md

@@ -211,3 +211,9 @@ sino-bc-cli biz-line +list --data '{"name":"<业务线名称>"}' --dry-run
 ## License
 
 MIT
+
+## 业务线策略生成
+
+Agent 使用 `biz-line-strategy-generate` 专家技能（需 Python 3），最多并发 3 条业务线。默认每条生成桌面 Excel；明确要求“写入数据库”时，生成并上传 Excel 后删除本地临时文件，将文件 key、四大策略和 learning 一并保存为 AI 策略。
+
+两种模式的 Excel 均在预算、广告产品、受众策略前展示匹配标签；素材不加标签。运行需提供页面实际的策略字典筛选值。数据库模式先核对全部关联项目的上周消耗，全部为 0 时直接保存无投放数据状态。调用示例与参数见安装后的专家技能说明。

package/dist/SKILL.md

@@ -3,12 +3,12 @@ name: sino-bc-cli
 description: >
   Use when 查询或操作 BeyondClick 业务线、周策略、投放品类、策略标签、AI策略、关联项目、广告策略维度与成效、广告投放媒体渠道，或配置 sino-bc-cli：
   投放品类、业务线列表/详情/状态、周策略增删改查、策略周期/消耗/红绿灯、优化项目、投放渠道；
-  生成业务线投放策略并导出 Excel（预算/广告产品/受众/素材及 learning）；
+  生成业务线投放策略、导出 Excel 或按要求入库（预算/广告产品/受众/素材及 learning）；
   保存业务线 AI 策略；通用文件上传与按 storageKey 取下载链接；
   Facebook / Google / TikTok 广告策略维度（目标、出价、定向等配置分布）
   与广告策略成效（消耗、曝光、点击等）；
   SSO 组别；  以及 /init、/update、/get-config、/set-config、/schema。
-  也用于优化项目月度分析、消耗与工时趋势、优化师人效、Excel 报表导出（project-analysis），
+  也用于优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效、Excel 报表导出（project-analysis），
   以及营销协同项目、阶段、任务、文档、文件、投放数据、看板、飞书消息、组织用户、租户和用户资料接口，
   以及财务对账单、发票结算、月度对账、后付额度与预付钱包。
   用户提到业务线、周策略、策略生成、AI策略、策略标签、通用文件、对账单、钱包、广告结构、广告层级、广告成效、广告策略维度、biz-line、
@@ -31,12 +31,12 @@ sino-bc-cli/
 ├── sino-bc-shared/            横切：配置、信封、确认门
 ├── sino-bc-auth/              身份令牌与浏览器授权
 ├── sino-bc-biz-line/          业务线、周策略、投放品类、策略标签、AI策略、广告策略维度与成效
-├── biz-line-strategy-generate/ 编排：四大策略 + Excel
+├── biz-line-strategy-generate/ 编排：四大策略 + Excel / 数据库
 ├── sino-bc-common-file/       通用文件上传与下载链接
 ├── sino-bc-media/             广告投放媒体：投放渠道等媒体字典
 ├── sino-bc-sso/               SSO 组别
 ├── sino-bc-tenant/            签约主体
-├── sino-bc-project-analysis/  优化项目月度分析、趋势、人效与导出
+├── sino-bc-project-analysis/  优化项目月度分析、工时系统原始表、趋势、人效与导出
 ├── sino-bc-project/           营销协同项目、成员、分组、建项字段
 ├── sino-bc-project-stage/     营销协同项目阶段
 ├── sino-bc-task/              营销协同任务交付闭环
@@ -47,7 +47,7 @@ sino-bc-cli/
 ├── sino-bc-dashboard/         营销协同看板
 ├── sino-bc-im/                营销协同飞书群消息
 ├── sino-bc-organization/      组织、团队与当前用户
-└── sino-bc-user/              SSO / 签约主体（租户）用户资料
+└── sino-bc-user/              SSO 资料、按姓名模糊列表与签约主体用户
 ```
 
 Agent 读取时用本机实际安装路径（常见为 `~/.agents/skills/sino-bc-cli/`、`~/.cursor/skills/sino-bc-cli/` 等）；也可用 `sino-bc-cli /skill target list` 查看。
@@ -84,12 +84,12 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 | 身份令牌、网关地址、成功/失败怎么看、写操作要不要确认 | [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md) | `/auth login` `/set-config auth-token <AT> [RT]` `/get-config` |
 | 浏览器授权登录、身份令牌状态、清除凭证、查询可用签约主体 | 同上 | `/auth login\|status\|logout` `/tenant list` |
 | 投放品类、策略标签、业务线列表/详情/状态、周策略增删改查、保存 AI 策略、策略周期/消耗/红绿灯、关联项目/优化项目 | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
-| 生成业务线投放策略并导出 Excel（预算/广告产品/受众/素材及 learning） | [`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md) | `scripts/run_workflow.py`（Python 3；最多 3 条并发，逐条清理，仅留最终 Excel） |
+| 生成业务线投放策略、导出 Excel 或按要求入库（预算/广告产品/受众/素材及 learning） | [`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md) | `scripts/run_workflow.py`（Python 3；最多 3 条并发，逐条清理；默认桌面 Excel，入库时上传并删除本地 Excel） |
 | 通用文件上传、按 storageKey 取下载链接（策略 Excel 等） | [`sino-bc-common-file/SKILL.md`](sino-bc-common-file/SKILL.md) | `common-file +upload` / `+url` |
 | 投放渠道、广告投放媒体字典 | [`sino-bc-media/SKILL.md`](sino-bc-media/SKILL.md) | `media +channels` |
 | Facebook / Google / TikTok 广告策略维度（目标、出价、定向等配置分布）或广告策略成效（消耗、曝光、点击等） | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>`（维度 / 成效） |
 | SSO 组别 | [`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md) | `sso +group-list` |
-| 优化项目月度汇总、项目明细、消耗/工时趋势、优化师人效、导出 Excel | [`sino-bc-project-analysis/SKILL.md`](sino-bc-project-analysis/SKILL.md) | `project-analysis +summary` / `+projects` 等 |
+| 优化项目月度汇总、项目明细、工时系统项目/任务/明细、消耗/工时趋势、优化师人效、导出 Excel | [`sino-bc-project-analysis/SKILL.md`](sino-bc-project-analysis/SKILL.md) | `project-analysis +summary` / `+projects` / `+atw-projects` 等 |
 | 营销协同对客项目、成员、分组、建项字段 | [`sino-bc-project/SKILL.md`](sino-bc-project/SKILL.md) | `project api <name>` |
 | 营销协同项目阶段 | [`sino-bc-project-stage/SKILL.md`](sino-bc-project-stage/SKILL.md) | `project-stage api <name>` |
 | 营销协同任务交付闭环、审核/确认/暂停 | [`sino-bc-task/SKILL.md`](sino-bc-task/SKILL.md) | `task api <name>` |
@@ -100,7 +100,7 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 | 营销协同看板预算分布与时间轴 | [`sino-bc-dashboard/SKILL.md`](sino-bc-dashboard/SKILL.md) | `dashboard api <name>` |
 | 营销协同飞书群消息 | [`sino-bc-im/SKILL.md`](sino-bc-im/SKILL.md) | `im api <name>` |
 | 组织架构、团队成员、登录态当前用户（`organization +info`） | [`sino-bc-organization/SKILL.md`](sino-bc-organization/SKILL.md) | `organization api <name>` |
-| 按 userId 查询 SSO 或签约主体（租户）用户姓名 | [`sino-bc-user/SKILL.md`](sino-bc-user/SKILL.md) | `user +sso-info` / `user +tenant-info`（租户用户 `corporationId` 放 `--data`） |
+| 按 userId 或姓名查询 SSO / 签约主体（租户）用户 | [`sino-bc-user/SKILL.md`](sino-bc-user/SKILL.md) | `user +sso-info` / `+sso-list` / `+tenant-info`（租户用户 `corporationId` 放 `--data`） |
 
 不要用本技能处理：本仓库源码开发、扩展命令、npm 发版。
 
@@ -120,12 +120,12 @@ Agent 先读子技能 `sino-bc-shared`，再按意图读域技能或额外专家
 10. 广告投放媒体：投放渠道等媒体字典：[`sino-bc-media/SKILL.md`](sino-bc-media/SKILL.md)（仓库 [`skills/oapi/sino-bc-media/SKILL.md`](skills/oapi/sino-bc-media/SKILL.md)）
 11. 组织架构、团队成员与当前用户：[`sino-bc-organization/SKILL.md`](sino-bc-organization/SKILL.md)（仓库 [`skills/oapi/sino-bc-organization/SKILL.md`](skills/oapi/sino-bc-organization/SKILL.md)）
 12. 营销协同项目：生命周期、成员、分组与建项字段：[`sino-bc-project/SKILL.md`](sino-bc-project/SKILL.md)（仓库 [`skills/oapi/sino-bc-project/SKILL.md`](skills/oapi/sino-bc-project/SKILL.md)）
-13. 优化项目月度分析、消耗与工时趋势、优化师人效及 Excel 导出：[`sino-bc-project-analysis/SKILL.md`](sino-bc-project-analysis/SKILL.md)（仓库 [`skills/oapi/sino-bc-project-analysis/SKILL.md`](skills/oapi/sino-bc-project-analysis/SKILL.md)）
+13. 优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出：[`sino-bc-project-analysis/SKILL.md`](sino-bc-project-analysis/SKILL.md)（仓库 [`skills/oapi/sino-bc-project-analysis/SKILL.md`](skills/oapi/sino-bc-project-analysis/SKILL.md)）
 14. 营销协同项目阶段：[`sino-bc-project-stage/SKILL.md`](sino-bc-project-stage/SKILL.md)（仓库 [`skills/oapi/sino-bc-project-stage/SKILL.md`](skills/oapi/sino-bc-project-stage/SKILL.md)）
 15. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/oapi/sino-bc-sso/SKILL.md`](skills/oapi/sino-bc-sso/SKILL.md)）
 16. 营销协同任务：交付闭环与操作日志：[`sino-bc-task/SKILL.md`](sino-bc-task/SKILL.md)（仓库 [`skills/oapi/sino-bc-task/SKILL.md`](skills/oapi/sino-bc-task/SKILL.md)）
 17. 签约主体：[`sino-bc-tenant/SKILL.md`](sino-bc-tenant/SKILL.md)（仓库 [`skills/oapi/sino-bc-tenant/SKILL.md`](skills/oapi/sino-bc-tenant/SKILL.md)）
-18. SSO 用户与签约主体（租户）用户资料：[`sino-bc-user/SKILL.md`](sino-bc-user/SKILL.md)（仓库 [`skills/oapi/sino-bc-user/SKILL.md`](skills/oapi/sino-bc-user/SKILL.md)）
+18. SSO 用户资料、按姓名模糊列表与签约主体（租户）用户资料：[`sino-bc-user/SKILL.md`](sino-bc-user/SKILL.md)（仓库 [`skills/oapi/sino-bc-user/SKILL.md`](skills/oapi/sino-bc-user/SKILL.md)）
 19. 财务对账单、发票结算、月度对账、后付额度与预付钱包：[`sino-bc-wallet/SKILL.md`](sino-bc-wallet/SKILL.md)（仓库 [`skills/oapi/sino-bc-wallet/SKILL.md`](skills/oapi/sino-bc-wallet/SKILL.md)）
 20. 业务线策略生成：[`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md)（仓库 [`skills/custom/biz-line-strategy-generate/SKILL.md`](skills/custom/biz-line-strategy-generate/SKILL.md)）
 

package/dist/affordance/biz-line.md

@@ -32,12 +32,6 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +status --data '{...}'`
 
-## +delete
-
-- **WHEN**：删除业务线 （写操作需 --yes）
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +delete --data '{...}'`
-
 ## +strategies
 
 - **WHEN**：查询投放策略分页列表
@@ -62,12 +56,6 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategy-update --data '{...}'`
 
-## +strategy-delete
-
-- **WHEN**：删除投放策略 （写操作需 --yes）
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +strategy-delete --data '{...}'`
-
 ## +categories
 
 - **WHEN**：查询业务线字典和策略标签

package/dist/affordance/project-analysis.md

@@ -68,6 +68,24 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli project-analysis +summary --data '{...}'`
 
+## +atw-projects
+
+- **WHEN**：查询工时系统项目列表（分页）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project-analysis +atw-projects --data '{...}'`
+
+## +atw-tasks
+
+- **WHEN**：查询工时系统项目任务列表（分页）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project-analysis +atw-tasks --data '{...}'`
+
+## +atw-timesheets
+
+- **WHEN**：查询工时系统工时明细（分页）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project-analysis +atw-timesheets --data '{...}'`
+
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

package/dist/affordance/user.md

@@ -16,16 +16,22 @@
 
 ## +sso-info
 
-- **WHEN**：查询SSO用户信息
+- **WHEN**：查询SSO用户信息(用户ID)
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli user +sso-info --data '{...}'`
 
 ## +sso-info-batch
 
-- **WHEN**：批量查询SSO用户信息
+- **WHEN**：批量查询SSO用户信息(用户ID)
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli user +sso-info-batch --data '{...}'`
 
+## +sso-list
+
+- **WHEN**：查询SSO用户列表（支持名称模糊）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +sso-list --data '{...}'`
+
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

package/dist/affordance/wallet.md

@@ -61,14 +61,6 @@
 - **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +invoice-pdf
-
-- **WHEN**：结算单详情 PDF
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +invoice-pdf --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
-
 ## +invoice-download
 
 - **WHEN**：下载发票

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

@@ -141,23 +141,7 @@
 | `id` | integer | body | 是 |  |
 | `status` | integer | body | 是 | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
 
-## 6. 删除业务线
-
-`POST /sino-opti-hive/biz-line/del`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `id` | integer | body | 是 |  |
-
-## 7. 查询投放策略分页列表
+## 6. 查询投放策略分页列表
 
 `POST /sino-opti-hive/biz-line/strategy/list`
 
@@ -177,7 +161,7 @@
 | `bizLineId` | integer | body | 否 | 可选，不传则按权限查全部可见业务线。 |
 | `trafficLight` | integer | body | 否 | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
 
-## 8. 查询投放策略消耗信息
+## 7. 查询投放策略消耗信息
 
 `POST /sino-opti-hive/biz-line/strategy/spend`
 
@@ -193,7 +177,7 @@
 | --- | --- | --- | --- | --- |
 | `strategyId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
 
-## 9. 新建投放策略
+## 8. 新建投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/save`
 
@@ -242,7 +226,7 @@
 | `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
 | `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
 
-## 10. 更新投放策略
+## 9. 更新投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/update`
 
@@ -294,23 +278,7 @@
 | `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
 | `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
 
-## 11. 删除投放策略
-
-`POST /sino-opti-hive/biz-line/strategy/del`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-删除投放策略
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `id` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
-
-## 12. 查询业务线关联项目和广告账号
+## 10. 查询业务线关联项目和广告账号
 
 `POST /sino-opti-hive/biz-line/project-list`
 
@@ -327,7 +295,7 @@
 | --- | --- | --- | --- | --- |
 | `bizLineId` | integer | body | 是 | 业务线 ID，必填 |
 
-## 13. 查询项目分页列表
+## 11. 查询项目分页列表
 
 `POST /sino-opti-hive/optimize/project/queryByPage`
 
@@ -364,7 +332,7 @@
 | `serviceCodeList` | array | body | 否 | 服务/产品 code 多选。不传时服务端默认 1、85（代投类项目） |
 | `bizLineIdList` | array | body | 否 | 按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 id |
 
-## 14. Facebook广告策略维度数据
+## 12. Facebook广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/facebook/ad/list`
 
@@ -427,7 +395,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 15. Google广告策略维度数据
+## 13. Google广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/google/ad/list`
 
@@ -490,7 +458,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从1开始，默认1 |
 | `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 16. TikTok广告策略维度数据
+## 14. TikTok广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/tiktok/ad/list`
 
@@ -553,7 +521,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 17. Facebook广告策略成效数据
+## 15. Facebook广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
 
@@ -624,7 +592,7 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 18. Google广告策略成效数据
+## 16. Google广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/google/ad/list`
 
@@ -695,7 +663,7 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | body | 否 | 页码，从1开始，默认1 |
 | `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 19. TikTok广告策略成效数据
+## 17. TikTok广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/tiktok/ad/list`
 

package/dist/api-doc/oapi/project-analysis.md

@@ -246,3 +246,89 @@
 | `projectIdList` | array | body | 否 | 项目id列表 |
 | `ssoTeamCodeList` | array | body | 否 | 组别code列表 |
 | `corporationIdList` | array | body | 否 | 签约主体筛选 ID 列表；不等同于网关 x-corporation-id 上下文 |
+
+## 12. 查询工时系统项目列表（分页）
+
+`POST /sino-opti-hive/atw/query/pageProjects`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso`。
+
+分页查询工时系统项目列表，对应 t_atw_project 单表数据。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从1开始；省略默认1，显式null或小于1时报错 |
+| `pageSize` | integer | body | 否 | 每页条数，省略默认10，显式null或小于1时报错 |
+| `atwProjectIdList` | array | body | 否 | 工时系统项目ID列表，IN 查询；不传或空列表不筛选 |
+| `atwCreateTimeStart` | string | body | 否 | 工时系统项目创建时间区间开始（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss |
+| `atwCreateTimeEnd` | string | body | 否 | 工时系统项目创建时间区间结束（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss |
+| `projectIdList` | array | body | 否 | 项目ID列表，IN 查询；不传或空列表不筛选 |
+| `name` | string | body | 否 | 工时系统项目名称；包含匹配，空白不筛选 |
+| `kindCode` | string | body | 否 | 服务产品编码，来自工时系统字典；已知示例：1=广告优化运营（代投）、85=广告诊断顾问、-888=售前咨询，非固定枚举；精确匹配，不传不筛选 |
+
+## 13. 查询工时系统项目任务列表（分页）
+
+`POST /sino-opti-hive/atw/query/pageTasks`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso`。
+
+分页查询工时系统项目任务列表，对应 t_atw_task 单表数据。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从1开始；省略默认1，显式null或小于1时报错 |
+| `pageSize` | integer | body | 否 | 每页条数，省略默认10，显式null或小于1时报错 |
+| `atwTaskIdList` | array | body | 否 | 工时系统任务ID列表，IN 查询；不传或空列表不筛选 |
+| `atwProjectIdList` | array | body | 否 | 工时系统项目ID列表，IN 查询；不传或空列表不筛选 |
+| `projectIdList` | array | body | 否 | 项目ID列表，IN 查询；不传或空列表不筛选 |
+| `name` | string | body | 否 | 工时系统任务名称；包含匹配，空白不筛选 |
+
+## 14. 查询工时系统工时明细（分页）
+
+`POST /sino-opti-hive/atw/query/pageTimesheets`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso`。
+
+分页查询工时系统工时明细，对应 t_atw_timesheet 单表数据。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从1开始；省略默认1，显式null或小于1时报错 |
+| `pageSize` | integer | body | 否 | 每页条数，省略默认10，显式null或小于1时报错 |
+| `atwTimesheetIdList` | array | body | 否 | 工时ID列表，IN 查询；不传或空列表不筛选 |
+| `atwProjectIdList` | array | body | 否 | 工时系统项目ID列表，IN 查询；不传或空列表不筛选 |
+| `atwProjectName` | string | body | 否 | 工时系统项目名称；包含匹配，空白不筛选 |
+| `atwTaskIdList` | array | body | 否 | 工时系统任务ID列表，IN 查询；不传或空列表不筛选 |
+| `atwTaskName` | string | body | 否 | 工时系统任务名称；包含匹配，空白不筛选 |
+| `atwParentTaskIdList` | array | body | 否 | 工时系统父任务ID列表，IN 查询；不传或空列表不筛选 |
+| `atwParentTaskName` | string | body | 否 | 工时系统父任务名称；包含匹配，空白不筛选 |
+| `projectIdList` | array | body | 否 | 项目ID列表，IN 查询；不传或空列表不筛选 |
+| `kindCode` | string | body | 否 | 服务产品编码，来自工时系统字典；已知示例：1=广告优化运营（代投）、85=广告诊断顾问、-888=售前咨询，非固定枚举；精确匹配，不传不筛选 |
+| `kindName` | string | body | 否 | 服务产品名称，来自工时系统字典；包含匹配，空白不筛选 |
+| `userIdList` | array | body | 否 | 用户ID列表，IN 查询；不传或空列表不筛选 |
+| `channelName` | string | body | 否 | 媒体渠道名称，映射表中 channel 列；例如 Facebook、Google，来自工时系统渠道字典；精确匹配，不传不筛选 |
+| `roleType` | string | body | 否 | 角色名称，已有映射：PM、主优化师、其他优化师、优化组长、其他成员；传名称，不传角色数字ID；精确匹配，不传不筛选 |
+| `entryDate` | string | body | 否 | 工时填写归属日，格式 yyyy-MM-dd；精确匹配，不传不筛选 |
+| `year` | integer | body | 否 | 工时填写归属年，格式 yyyy，例如 2026；精确匹配，不传不筛选 |
+| `month` | integer | body | 否 | 工时填写归属月，格式 yyyyMM，例如 202609；精确匹配，不传不筛选 |
+| `week` | integer | body | 否 | 工时填写归属周，格式 YYYYww（ISO周所属年份+两位周数，01–53），例如 202639=2026年第39周；周一开始，跨年时周所属年份可能与日历年份不同；精确匹配，不传不筛选 |
+| `hour` | number | body | 否 | 填写工时，单位小时，支持小数；精确匹配，不传不筛选 |
+| `timeCode` | string | body | 否 | 工时类型编码，来自工时系统字典；不是 time_code_type（REGULAR_TIME/LEAVE_TIME/OVER_TIME）；精确匹配，不传不筛选 |
+| `timeCodeName` | string | body | 否 | 工时类型名称，来自工时系统字典，与 timeCode 对应；包含匹配，空白不筛选 |
+| `activity` | string | body | 否 | 审批状态：UNCOMMITTED=已保存，APPROVING=待审批，REJECTED=未通过，APPROVED=已批准；精确匹配，不传不筛选 |
+| `submitDateStart` | string | body | 否 | 工时提交时间区间开始（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss |
+| `submitDateEnd` | string | body | 否 | 工时提交时间区间结束（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss |
+| `approvedDateStart` | string | body | 否 | 工时审批时间区间开始（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss |
+| `approvedDateEnd` | string | body | 否 | 工时审批时间区间结束（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss |

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

@@ -36,7 +36,7 @@
 | `corporationId` | integer | body | 是 | 签约主体ID |
 | `userId` | integer | body | 是 | 用户ID |
 
-## 3. 查询SSO用户信息
+## 3. 查询SSO用户信息(用户ID)
 
 `POST /platform/sso/user/info`
 
@@ -52,7 +52,7 @@
 | --- | --- | --- | --- | --- |
 | `userId` | integer | body | 是 | 用户ID |
 
-## 4. 批量查询SSO用户信息
+## 4. 批量查询SSO用户信息(用户ID)
 
 `POST /platform/sso/user/info/batch`
 
@@ -67,3 +67,20 @@
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
 | `userIdList` | array | body | 是 | 用户ID集合 |
+
+## 5. 查询SSO用户列表（支持名称模糊）
+
+`POST /bc-business-pu/user/querySsoUserList`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+查询 SSO 用户列表，userIdList和userName至少传一个。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `userIdList` | array | body | 否 | SSO 用户 ID 列表 |
+| `userName` | string | body | 否 | 名称模糊查询关键字 |

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

@@ -75,27 +75,7 @@
 | --- | --- | --- | --- | --- |
 | `invoiceSettlementId` | string | query | 是 | 发票编号/结算单id |
 
-## 4. 结算单详情 PDF
-
-`GET /sino-wallet-pu/invoice/settlement/detail/pdf`
-
-主体上下文：`tenant=true`。
-
-角色范围：`passport`。
-
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-调用示例：`sino-bc-cli wallet api invoice-settlement-detail-pdf --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
-
-已废弃。返回单条 PDF URL；多文件请用发票下载。
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `invoiceSettlementId` | string | query | 是 | 发票编号/结算单id |
-
-## 5. 下载发票
+## 4. 下载发票
 
 `POST /sino-wallet-pu/invoice/settlement/invoice/download`
 
@@ -116,7 +96,7 @@
 | `invoiceSettlementId` | string | body | 是 | 结算单id |
 | `fileType` | string | body | 是 | 发票格式 |
 
-## 6. 结算单还款记录
+## 5. 结算单还款记录
 
 `POST /sino-wallet-pu/invoice/settlement/payment/list`