sino-bc-cli 1.8.37-beta.1 → 1.8.37-beta.3

package/README.md

@@ -6,11 +6,11 @@ BeyondClick 全局命令行工具。用本机命令访问平台能力，**不要
 
 ## 环境要求
 
-- Node.js **>= 24.0.0**
+- Node.js **>= 22.23.3**
 - 能访问 npm 官方源 `https://registry.npmjs.org/`
 
 ```bash
-node -v    # 需要 v24.x 或更高
+node -v    # 需要 v22.23.3 或更高
 ```
 
 ## 架构设计

package/dist/affordance/project-member-aggregation.md

@@ -0,0 +1,23 @@
+# project-member-aggregation 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +list
+
+- **WHEN**：项目成员周消耗聚合分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project-member-aggregation +list --data '{...}'`
+
+## +month-list
+
+- **WHEN**：项目成员月消耗聚合分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project-member-aggregation +month-list --data '{...}'`
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli project-member-aggregation api <name> --data '{...}'`

package/dist/affordance/project.md

@@ -313,6 +313,13 @@
 - **示例**：`sino-bc-cli project +system-detail --data '{...}'`
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
+## +jump-url
+
+- **WHEN**：获取项目或任务跳转链接
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +jump-url --data '{...}'`
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

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

@@ -265,7 +265,7 @@ taskId / logId 二选一。
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso/passport`。
+角色范围：`sso/passport/system`。
 
 风险：`read`。
 

package/dist/api-doc/oapi/project-member-aggregation.md

@@ -0,0 +1,54 @@
+# 项目消耗数据
+
+对应命令：`project-member-aggregation +<shortcut>` 与 `project-member-aggregation api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 项目成员周消耗聚合分页列表
+
+`POST /sino-opti-hive/project-member-aggregation/week/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+项目成员周消耗聚合原始记录分页查询。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `corporationId` | integer | body | 否 | 签约主体ID |
+| `projectId` | integer | body | 否 | 项目ID |
+| `month` | integer | body | 否 | 月份 yyyyMM |
+| `week` | integer | body | 否 | 第X周 yyyyW |
+| `weekStart` | string | body | 否 | 周开始时间 |
+| `weekEnd` | string | body | 否 | 周结束时间 |
+| `userId` | integer | body | 否 | 优化师用户ID |
+
+## 2. 项目成员月消耗聚合分页列表
+
+`POST /sino-opti-hive/project-member-aggregation/month/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`read`。
+
+项目成员月消耗聚合原始记录分页查询
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `corporationId` | integer | body | 否 | 签约主体ID |
+| `projectId` | integer | body | 否 | 项目ID |
+| `month` | integer | body | 否 | 月份 yyyyMM |
+| `userId` | integer | body | 否 | 优化师用户ID |

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

@@ -1112,3 +1112,22 @@
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
 | `id` | integer | query | 是 | 项目ID |
+
+## 44. 获取项目或任务跳转链接
+
+`GET /sino-bc-nexus/project/jump-url`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/passport/system`。
+
+风险：`read`。
+
+根据项目 ID 或任务 ID，返回项目或任务详情页的网页链接和飞书 SSO 链接。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `projectId` | integer | query | 否 | 项目 ID（Java Long）。未传 taskId 时必填且必须大于 0，跳转项目详情；传入 taskId 时忽略此参数，不校验与任务的项目归属是否一致。与 taskId 至少传一个，无默认值。 |
+| `taskId` | integer | query | 否 | 任务 ID（Java Long），传入时必须大于 0，优先跳转任务详情；项目、阶段及主体从任务记录取得，分组从所属项目取得。任务不存在时报错，不回退使用 projectId。与 projectId 至少传一个，无默认值。 |

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

@@ -134,13 +134,12 @@
 | `stageId` | integer | body | 否 | 阶段ID |
 | `name` | string | body | 否 | 任务名称 |
 | `taskInfo` | string | body | 否 | 任务信息，富文本 |
-| `dueAt` | string | body | 否 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `createTime` | string | body | 否 | 可选；任务创建时间，不传则使用服务端当前时间。格式 yyyy-MM-dd HH:mm:ss，精确到秒，不含时区或偏移量。 |
+| `dueAt` | string | body | 否 | 截止时间；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
 | `members` | array | body | 否 | 任务成员列表（userId + role） |
 | `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
 | `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传默认true |
 | `larkChat` | object | body | 否 | 关联飞书聊天范围 |
-| `taskSource` | string | body | 否 | 任务来源 RequestSourceEnum（一般由入口层写入，可选） |
-| `taskSourceSubtype` | string | body | 否 | 任务来源子类型 TaskSourceSubtypeEnum：LARK_SINGLE_CHAT（飞书单聊）/ LARK_GROUP_CHAT（飞书群聊）/ LARK_AILY_AGENT_CHAT（飞书Aily智能体聊天） |
 
 ## 6. 删除任务
 
@@ -407,11 +406,13 @@
 | `stageId` | integer | body | 是 | 阶段ID |
 | `name` | string | body | 是 | 任务名称 |
 | `taskInfo` | string | body | 否 | 任务信息，富文本 |
-| `dueAt` | string | body | 是 | 截止时间；JSON 字符串；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
+| `createTime` | string | body | 否 | 可选；任务创建时间，不传则使用服务端当前时间。格式 yyyy-MM-dd HH:mm:ss，精确到秒，不含时区或偏移量。 |
+| `dueAt` | string | body | 是 | 截止时间；格式 yyyy-MM-dd HH:mm:ss；精确到秒；不含时区/偏移量；示例：2026-09-16 14:30:00 |
 | `members` | array | body | 是 | 任务成员列表（userId + role） |
 | `uploadRecordIdList` | array | body | 否 | 附件上传记录ID列表（来自文件上传接口返回的uploadRecordId） |
 | `targetStatus` | string | body | 否 | 可选，优先于 skipPendingExecution；不传时不补系统角色。无审核人时沿用跳过审核规则，状态异步推进。 |
 | `skipPendingExecution` | boolean | body | 否 | 是否跳过待执行：true-跳过 false-不跳过；不传默认true |
+| `larkChat` | object | body | 否 | 关联飞书聊天范围 |
 
 ## 16. 提交交付（系统）