sino-bc-cli 1.8.26 → 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/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/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 | 否 | 名称模糊查询关键字 |