weaver-work-cli 0.1.28 → 0.1.31

package/docs/todo-smart-convert/mock/ai-todo-query-target.json

@@ -0,0 +1,209 @@
+{
+  "smartSummaryTitle": "黄经理，您当前有 149 条待办，清单如下：",
+  "totalCount": 149,
+  "wfIdGroup": [
+    {
+      "id": "priority",
+      "topPriority": true,
+      "title": "建议优先处理的流程",
+      "count": 2,
+      "defaultExpanded": true,
+      "displayItems": [
+        {
+          "type": "request",
+          "requestData": {
+            "requestId": 880000001,
+            "workflowId": 1003,
+            "userMasterId": 900001,
+            "isremark": 0,
+            "nodeId": 500301,
+            "overTime": true,
+            "userOverTime": "已超时",
+            "requestLevel": 2,
+            "requestLevelShow": "紧急",
+            "requestNameHtml": "客户晚宴招待（亚太区合作伙伴大会收官）",
+            "requestNameTitle": "客户晚宴招待（亚太区合作伙伴大会收官）",
+            "creater": 910026,
+            "createrName": "韩雪",
+            "summary": "为配合 11/08 亚太区合作伙伴大会收官，申请客户晚宴招待费用 ¥1,280。"
+          }
+        },
+        {
+          "type": "request",
+          "requestData": {
+            "requestId": 880000002,
+            "workflowId": 1001,
+            "userMasterId": 900002,
+            "isremark": 0,
+            "nodeId": 500302,
+            "overTime": false,
+            "userOverTime": "11-01到期",
+            "requestLevel": 2,
+            "requestLevelShow": "紧急",
+            "requestNameHtml": "产品经理实战训练营报名",
+            "requestNameTitle": "产品经理实战训练营报名",
+            "creater": 910027,
+            "createrName": "陈安",
+            "summary": "11 月产品经理实战训练营报名，需 11/01 前确认参训名单。"
+          }
+        }
+      ]
+    },
+    {
+      "id": "1001",
+      "topPriority": false,
+      "title": "内部留言",
+      "count": 3,
+      "defaultExpanded": false,
+      "displayItems": [
+        {
+          "type": "group",
+          "id": "1001-1",
+          "title": "培训通知",
+          "count": 2,
+          "summary": "含「11月产品经理实战训练营」等 2 条培训通知，由 陈安、林珂 发起，可展开逐条查看或直接汇总处理",
+          "defaultExpanded": false,
+          "requestDatas": [
+            {
+              "requestId": 880000003,
+              "workflowId": 1001,
+              "userMasterId": 900003,
+              "isremark": 0,
+              "nodeId": 500303,
+              "overTime": false,
+              "userOverTime": "",
+              "requestLevel": 0,
+              "requestLevelShow": "正常",
+              "requestNameHtml": "11月产品经理实战训练营报名",
+              "requestNameTitle": "11月产品经理实战训练营报名",
+              "creater": 910027,
+              "createrName": "陈安",
+              "summary": "训练营 11/12 开班，需 11/01 前报名。"
+            },
+            {
+              "requestId": 880000004,
+              "workflowId": 1001,
+              "userMasterId": 900004,
+              "isremark": 0,
+              "nodeId": 500304,
+              "overTime": false,
+              "userOverTime": "",
+              "requestLevel": 0,
+              "requestLevelShow": "正常",
+              "requestNameHtml": "E10 集训（第三期）通知",
+              "requestNameTitle": "E10 集训（第三期）通知",
+              "creater": 910028,
+              "createrName": "林珂",
+              "summary": "第三期 E10 集训 11/05 开课，请提前安排时间。"
+            }
+          ]
+        },
+        {
+          "type": "request",
+          "requestData": {
+            "requestId": 880000005,
+            "workflowId": 1001,
+            "userMasterId": 900005,
+            "isremark": 0,
+            "nodeId": 500305,
+            "overTime": false,
+            "userOverTime": "",
+            "requestLevel": 0,
+            "requestLevelShow": "正常",
+            "requestNameHtml": "华东区大客户成功案例分享",
+            "requestNameTitle": "华东区大客户成功案例分享",
+            "creater": 910029,
+            "createrName": "郑蔓",
+            "summary": "分享华东区大客户落地的 E10 多租户方案与实施要点。"
+          }
+        }
+      ]
+    },
+    {
+      "id": "1003",
+      "topPriority": false,
+      "title": "报销申请",
+      "count": 4,
+      "defaultExpanded": false,
+      "displayItems": [
+        {
+          "type": "group",
+          "id": "1003-1",
+          "title": "小额费用报销汇总（单笔 ≤ ¥100）",
+          "count": 3,
+          "summary": "单笔 ¥36 ~ ¥88，合计 ¥310，涵盖 3 类费用，由 郑楠、韩东、李哲 发起，可展开逐条查看或直接汇总处理",
+          "defaultExpanded": false,
+          "requestDatas": [
+            {
+              "requestId": 880000006,
+              "workflowId": 1003,
+              "userMasterId": 900006,
+              "isremark": 0,
+              "nodeId": 500306,
+              "overTime": false,
+              "userOverTime": "",
+              "requestLevel": 0,
+              "requestLevelShow": "正常",
+              "requestNameHtml": "市内交通报销",
+              "requestNameTitle": "市内交通报销",
+              "creater": 910030,
+              "createrName": "郑楠",
+              "summary": "市内交通费 ¥36"
+            },
+            {
+              "requestId": 880000007,
+              "workflowId": 1003,
+              "userMasterId": 900007,
+              "isremark": 0,
+              "nodeId": 500307,
+              "overTime": false,
+              "userOverTime": "",
+              "requestLevel": 0,
+              "requestLevelShow": "正常",
+              "requestNameHtml": "客户接待餐费报销",
+              "requestNameTitle": "客户接待餐费报销",
+              "creater": 910031,
+              "createrName": "韩东",
+              "summary": "客户接待餐费 ¥88"
+            },
+            {
+              "requestId": 880000008,
+              "workflowId": 1003,
+              "userMasterId": 900008,
+              "isremark": 0,
+              "nodeId": 500308,
+              "overTime": false,
+              "userOverTime": "",
+              "requestLevel": 0,
+              "requestLevelShow": "正常",
+              "requestNameHtml": "办公耗材采购报销",
+              "requestNameTitle": "办公耗材采购报销",
+              "creater": 910032,
+              "createrName": "李哲",
+              "summary": "打印纸 1 箱 ¥186"
+            }
+          ]
+        },
+        {
+          "type": "request",
+          "requestData": {
+            "requestId": 880000009,
+            "workflowId": 1003,
+            "userMasterId": 900009,
+            "isremark": 0,
+            "nodeId": 500309,
+            "overTime": false,
+            "userOverTime": "",
+            "requestLevel": 0,
+            "requestLevelShow": "正常",
+            "requestNameHtml": "Q4 标书打印与归档费用",
+            "requestNameTitle": "Q4 标书打印与归档费用",
+            "creater": 910033,
+            "createrName": "陈安",
+            "summary": "为应对 Q4 标书打印与归档高峰，申请专项打印装订费用 ¥1,860。"
+          }
+        }
+      ]
+    }
+  ]
+}

package/docs/todo-smart-convert/subgroup-rules.md

@@ -0,0 +1,245 @@
+# 二次分组（subgroup）规则
+
+> 范围：`smartGroup` 阶段里把「工作流分组」再切成「汇总项 + 单条」的全部规则
+> 源码：`todoSmartConvert.smartGroup.ts`、`businessRules.ts`、`todoSmartConvert.group.ts`
+> 核对日期：2026-10-27（ai二次分组改造后定稿：删除 `other` 汇总项、<3 条硬门槛不再被计划覆盖、意图表驱动、详情缓存）
+
+## 0. 一句话
+
+大组是否做 ai二次分组、怎么分，由 **「业务类型」+「用户意图是否适用本组」+「有没有给本组计划」+「组内条数门槛」** 四个因素决定；CLI 负责判定与兜底，AI 只提供「子组怎么切、叫什么名」。
+
+**没有计划就不产汇总项**——只有三类确定性汇总项（请假阈值组 / 财务阈值组 / 客户问题支持过期组）例外，其余一律平铺。
+
+## 1. 门槛与硬约束
+
+| 规则 | 值 / 行为 |
+|---|---|
+| 最小条数 | `GROUP_MIN_ITEMS_FOR_SUBGROUP = 3`（`group.ts`） |
+| 不足 3 条 | **一律平铺单条**，不产生任何汇总项；**即使给了 `aiGroups` 也忽略**并写 warning（硬门槛不再被计划覆盖） |
+| 优先组 | 不做 ai二次分组；`aiGroups` 里出现 `groupId:"priority"` ⇒ 硬失败 `ai_group_priority_unsupported` |
+| 计划作用范围 | 只作用于本组；本组是否采纳还受「业务类型 + 意图是否适用」限制（见 §2） |
+| 全局开关已取消 | `aiGroups: []` 等价于「没传」，不再有单独的「兼容校验路径」 |
+| 叠加视图影响 | 优先条目仍算进它所属工作流分组的条数，所以「原本 2 条 + 1 条超时」的组现在算 3 条，**会跨过门槛** |
+| 空 `groupFocus` | 只影响「计划是否被采纳」；不影响 `<3` 门槛与确定性规则 |
+
+## 2. 决策顺序（每个非优先组，严格按代码顺序）
+
+```
+kind          = detectBusinessKind(group.title)                 // 组名判定，见 §5
+groupHasFocus = hasFocus && focusAppliesToKind(groupFocus, kind) // 意图表，见 §4
+plansAllowed  = groupHasFocus || kind === 'internal-message'     // 计划是否可能被采纳
+
+D0 优先组 ─────────────────────────────────▶ 全部单条；defaultExpanded=true；结束
+D1 满意度类 ───────────────────────────────▶ 全部单条；summary 用标题兜底（不调 AI）；忽略计划 + warning
+D2 组内 <3 条 ─────────────────────────────▶ 全部平铺；忽略计划 + warning（硬门槛）
+D3 计划不被采纳（kind 非内部留言 且 意图不适用）
+        ───────────────────────────────────▶ 全部平铺 + warning（区分「意图不适用」与「本类型默认不分组」两种文案）
+D4 计划被采纳但本组一条计划都没有
+        内部留言 ─────────────────────────▶ **硬失败 `ai_groups_required`**（没有平铺这个第三态，必须补计划）
+        其他类型 ─────────────────────────▶ warning「意图适用但模型未给本组计划，按无意图处理」→ 落到 D5
+D5 无生效计划 ⇒ 只有三类确定性汇总项会产汇总项：
+    leave / finance ─────────────────────▶ 阈值组（≤1天 / ≤100元；**有命中才建**）+ 其余平铺
+    issue-support ───────────────────────▶ 「已过期及今天即将过期的流程」（**有命中才建**）+ 其余平铺
+    other ───────────────────────────────▶ 全部平铺（写一条 warning 说明原因）
+    （internal-message 到不了这里：D4 已硬失败）
+D6 有生效计划 ⇒ 按计划切（见 §6）：
+    a) 保留标题（1天以内/100元以内）逐条核阈值，超阈值剔出转平铺 + 点名
+    b) 子组 <2 条 ⇒ 解散，条目转平铺
+    c) 漏分条目 ⇒ 平铺（**不造 other**）
+D7 排序：无 focus → 条数降序（稳定排序）；有 focus → 沿用 AI 给的顺序
+D8 编号：id = `${groupId}-${排序后下标+1}`
+```
+
+> **结构恒定**：`displayItems` 只有两种形态——真子组（`type:"group"`）或平铺条目（`type:"request"`）。
+> 不再出现「与父组同名」的整组汇总项，也不再出现 `other` 兜底汇总项。
+
+## 3. 行为矩阵（最容易 review 错的地方）
+
+| 本组情况 | 无计划 · 无 focus | 无计划 · 意图适用 | 有本组计划 · 采纳 | 有本组计划 · 不采纳 |
+|---|---|---|---|---|
+| 优先组 | 全单条（置顶展开） | 同左 | 硬失败 | 硬失败 |
+| 满意度类 | 全单条 + 标题摘要 | 全单条 + 标题摘要 | 全单条（忽略计划 + warning） | 同左 |
+| **任意类型 <3 条** | 平铺 | 平铺 | **平铺（硬门槛，忽略计划）** | 平铺 |
+| 内部留言 ≥3 条 | **必须给计划**：按流程标题分（缺计划 → `ai_groups_required`） | **必须给计划**：按侧重点+详情分 | **按计划细分** | —（总是采纳） |
+| 请假/财务 ≥3 条 | 阈值组 + 其余平铺 | 按计划细分 | 按计划细分（保留标题仍在核阈值） | 阈值组 + 其余平铺 |
+| 客户问题支持 ≥3 条 | 过期组 + 其余平铺 | 按计划细分 | 按计划细分 | 过期组 + 其余平铺 |
+| 其他类 ≥3 条 | 平铺 + warning | 按计划细分 | 按计划细分 | **平铺**（本类型无 focus 时忽略计划） |
+
+> **只有内部留言（无 focus）和「意图适用本组的任意类型」会消费 `aiGroups`**；其他类在无 focus 时给了计划也会被忽略并写 warning。
+
+## 4. 意图表 `INTENT_RULES`（`businessRules.ts`）
+
+用户意图不是「随便一句中文」，而是**按维度分类**的：专属意图只作用于对应业务类型，通用意图只作用于内部留言与其他类。
+
+| id | 标签 | 命中词（正则片段） | 作用类型 `kinds` |
+|---|---|---|---|
+| `leave` | 请假维度 | 请假/休假/年假/调休/病假/事假/婚假/产假/陪产/丧假/探亲/工伤/哺乳/假别/假期/假种/天数 | `leave` |
+| `finance` | 财务维度 | 报销/费用/金额/发票/差旅/借款/付款/请款/科目/票据/对公/核销 | `finance` |
+| `issue-support` | 问题支持维度 | 问题/模块/处理阶段/客户问题/工单/支持 | `issue-support` |
+| `generic` | 通用维度 | 客户/发起人/创建人/提交人/时间/日期/紧急/等级/优先级/主题/标题/类型/类别/状态/节点/内容 | `internal-message`、`other` |
+
+判定规则（`intentAppliesToKind`，顺序不可换）：
+
+1. `groupFocus` 为空，或本组是满意度类 ⇒ **不适用**（= 无意图）；
+2. 先看**专属意图**（`leave`/`finance`/`issue-support`）：任一命中 ⇒ **只按专属的 `kinds` 判**，通用词同时出现也忽略；
+3. 专属都没命中才看通用意图；
+4. 都不命中 ⇒ **视为没有意图**：不报错、不喂 AI，按该类型的确定性规则处理。
+
+> 推论：`"按费用类型"` 对财务类适用、对请假类**不**适用（专属「财务维度」不包含 `leave`）；
+> `"按客户"` 对内部留言/其他类适用、对请假/财务/问题支持**不**适用。
+> 给错类型的意图不会硬失败，只会退回确定性规则并写 warning。
+
+## 5. 业务类型判定
+
+按**组名（= workflowName）**判定，顺序不可换（客户问题支持精确名优先、满意度次之，避免「费用报销满意度调查」被归为财务）：
+
+| 类型 | 判据 | 无计划时的分组行为 | 组摘要 / 单条摘要 |
+|---|---|---|---|
+| `issue-support` | **精确名**：`Ecology客户问题支持解决流程`、`E10客户问题支持解决流程` | 「已过期及今天即将过期的流程」一组，其余平铺；无命中则全平铺 | 过期组 = CLI 固定模板 |
+| `satisfaction` | `满意度\|满意调查\|评价调查\|服务评价\|问卷调查` | 全部单条 | 单条 `summary` **= 条目标题**（不调 AI） |
+| `internal-message` | `INTERNAL_MESSAGE_WORKFLOW_PATTERN`（内部留言/内部消息/留言板/意见建议…） | **平铺单条**（有计划才细分） | 计划子组留空交 AI |
+| `leave` | 请假/休假/年假/调休/病假/事假/婚假/产假/陪产/丧假/探亲假/工伤假/哺乳假/公休 | ≤1 天合并，其余平铺 | 阈值组 = CLI 固定模板 |
+| `finance` | 报销/费用/付款/请款/借款/发票/差旅/对公/资金/核销 | 单笔 ≤100 元合并，其余平铺 | 阈值组 = CLI 固定模板（金额区间/合计/费用类数） |
+| `other` | 兜底 | **平铺单条** | 无汇总项 |
+
+阈值：`LEAVE_DAY_THRESHOLD = 1`、`FINANCE_AMOUNT_THRESHOLD = 100`；标题固定 `1天以内` / `100元以内`。
+
+**指标（天数/金额）只来自流程详情数据**（`RowMetrics`），取不到时该条**平铺并点名**，不猜、不硬凑进阈值组。
+财务组一条金额都取不到时，组摘要退回「标题清单」模板，而不是编一个 `¥0 ~ ¥0`。
+
+## 6. `aiGroups` 的字段校验与切分细节
+
+### 6.1 入参校验（`readAiGroups`）
+
+| 检查 | 失败 |
+|---|---|
+| 必须是数组 | `ai_groups_invalid` |
+| 每项只允许 `groupId` / `title` / `requestIds` / `seq` | `ai_groups_invalid`（列出多余字段） |
+| `groupId` / `title` 必须是非空字符串（19 位 ID 用数字会失真） | `ai_groups_invalid` |
+| `groupId` 必须存在于本次分组结果 | `ai_group_unknown_group`（回传可用列表） |
+| `groupId` 不能是 `priority` | `ai_group_priority_unsupported` |
+| `requestIds` 与 `seq` 二选一，不能同时给、也不能都空 | `ai_groups_invalid` |
+| `seq` 只接受 ≥1 的整数 | `ai_groups_invalid` |
+| `seq` 越界 | `ai_group_seq_out_of_range` |
+| `requestId` 不属于该组 | `ai_group_unknown_request` |
+| 同一条被分进两个子组 | `ai_group_duplicate_request` |
+
+`seq` 口径：**组内 1-based 下标**，顺序 = `group.requestDatas` 顺序（与 `collect` 的 `groupingBrief[].items[].idx` 同源）。叠加视图后优先条目也在该数组里，序号顺延。
+
+### 6.2 切分后的三道兜底
+
+| 兜底 | 行为 |
+|---|---|
+| **保留标题核阈值** | 请假/财务组里，模型拿 `1天以内` / `100元以内` 当子组名时，逐条核 `metrics`；超阈值的**剔出→平铺**并点名（`不满足阈值` warning）。其它标题不核 |
+| **子组 <2 解散** | 子组只剩 1 条不成立，解散后条目平铺；被解散的在同一条 warning 里报数量 |
+| **漏分平铺** | 没被 `used` 标记的条目全部平铺，**不建 `other` 汇总项**，写 warning 报数量 |
+
+> 三道兜底都不丢数据：任何条目要么在子组里，要么出现在 `displayItems` 的单条里。
+
+## 7. 排序与编号
+
+- **无 focus**：子组按条数降序；`sort` 稳定，同条数保持 AI 给的先后。
+- **有 focus**：完全沿用 AI 数组顺序。
+- **编号**：`id = 父组id-序号`，序号 = **排序后**的下标（从 1 起）。因此条数变化导致排序变动时，`id` 会跟着变（已知问题，见 §11）。
+
+## 8. 组摘要 / 单条摘要由谁写
+
+| 路径 | `summary` |
+|---|---|
+| 阈值组（`1天以内` / `100元以内`） | 组摘要 = CLI 固定模板，**即使本轮传了 `aiGroups` 也照写** |
+| 客户问题支持过期组 | 组摘要 = CLI 固定模板 |
+| AI 计划产生的子组（含请假/财务里自定义标题的子组） | 组摘要先留空串，由 `groupSummaryContext` → AI → `groupSummary` 回填 |
+| 其他类 / 内部留言（无计划） | 无汇总项，不存在组摘要 |
+| 满意度类单条 | **单条 summary = 条目标题**（确定性，不调 AI，保证非空） |
+| 其余单条 | 由 `summary` 阶段 AI 写；详情为空时标题兜底 |
+
+### 8.1 三套固定模板原文（`businessRules.ts`）
+
+公共尾巴：`可展开逐条查看或直接汇总处理`（CLI 固定文案与喂模型的 `stats.tail` 共用同一个常量）
+
+| 类型 | 模板 |
+|---|---|
+| 请假 | `共{N}条，涵盖{M}类假别（事假、病假、年假等），由A、B、C等发起。{尾巴}` |
+| 财务 | `单笔 ¥{min} ~ ¥{max}，合计 {红字}¥{sum}{/红字}，涵盖{M}类费用（差旅、餐饮等），由A、B、C等发起。{尾巴}` |
+| 问题支持 | `含 {N} 条已过期或今日到期的问题流程，由 A、B 等 N 人发起，其余 {M} 条按单条展示，{尾巴}` |
+
+三条口径（2026-10-27 用户定）：
+
+1. **类别（假别/费用类别）去重后最多列 3 个，没列完才补「等」**——列全了不加「等」。
+   一个类别都取不到时只说「1类假别」/「1类费用」，不编名字。
+2. **发起人超过 2 人才补「等」**（1~2 人把名字列全），最多列 3 个。
+3. 财务合计用**纯文本** `¥{金额}`，**不加任何 HTML 标签**（2026-10-27 用户要求；此前用 `<span style="color:#d9363e;font-weight:700">` 做红字，但载荷内联进聊天消息时会被当真实标签解析、吞掉后续内容）。
+
+> 费用类别只来自**流程详情字段**（`费用类型`/`费用类别`/`报销类型`…）或**标题关键词**兜底。
+> 租户表单若没有这类字段、标题也没有关键词，就只会输出「1类费用」——不猜。
+
+### 8.2 组摘要不缓存（规则）
+
+组摘要**每轮都重新生成**：组内条目变动频繁，按组缓存必然出现「文案说 3 条、卡片是 5 条」。
+缓存的只有单条摘要（`requestId` 粒度）。
+
+## 9. 错误码
+
+`ai_groups_invalid` / `ai_group_unknown_group` / `ai_group_priority_unsupported` / `ai_group_seq_out_of_range` / `ai_group_unknown_request` / `ai_group_duplicate_request` / **`ai_groups_required`**
+
+> `ai_groups_required`（2026-10-27）：**内部留言 ≥3 条却没有本组计划**时硬失败（`retryAllowed=true`），报错里给出 `groupId` 与「1..N」可用序号，并说明默认维度是**流程标题**。
+> `ai_groups_missing_group` **已删除**：**非内部留言**的类型「意图适用却没给计划」= 视为无意图 + warning（内部留言不走这条路）。
+
+## 10. 真实数据核对（近一年 77 条 / 17 组，2026-10-27）
+
+| 组 | 条数 | 结果 |
+|---|---|---|
+| 公司重要通知 | 32 | **全部平铺**（其他类无 focus ⇒ 忽略计划/无计划都不分） |
+| 安全问题处理工单 | 11 | **全部平铺** |
+| 契约锁满意度调查反馈 / 满意度调查反馈 | 5 / 5 | 全平铺，`summary` = 标题 |
+| 泛微请假流程 | 3 | `1天以内`(2) + 平铺 1 |
+| 总部费用报销 | 4 | `100元以内`(2) + 平铺 2 |
+| 内部留言 | 2 | <3 硬门槛 ⇒ 平铺 |
+| 其余 11 组 | 各 1~5 | 平铺 |
+
+汇总项只剩 `1天以内(2)`、`100元以内(2)`；空摘要 0；`totalCount = 77`，Σ`count = 98`（差值 21 = 优先组的叠加条数）。
+
+## 11. review 关注点
+
+### 11.0 ✅ 2026-10-27（ai二次分组改造收口）
+
+| 项 | 旧行为 | 新行为 |
+|---|---|---|
+| AI 漏分 | 并入/新建 `other` 汇总项（标题就是英文 `other`） | **全部平铺**，不造 `other` |
+| 组内 <3 条但有计划 | 计划覆盖门槛，照分 | **硬门槛优先**，忽略计划 + warning |
+| 意图适用却没给本组计划 | 硬失败 `ai_groups_missing_group` | **视为无意图** + warning，走确定性规则 |
+| 意图判定 | 「没命中关键词就算通用」 | **意图表 `INTENT_RULES`**：专属只作用对应类型，通用只作用内部留言/其他 |
+| 子组只剩 1 条 | 保留 | **解散 → 平铺** |
+| 摘要命中 ⇒ 跳过详情 | 跳过（导致阈值指标拿不到，10.2 复发） | **摘要缓存只省 AI，不省详情**（详情缓存按 `requestId__lastFeedBackDateTime` 命中则零请求） |
+| `formatInternalMessageOverflowSummary` | 残留导出 + 调用 | 已删（含 `SMART_UNCOVERED_TITLE` 的全部消费点） |
+
+### 11.1 ✅ 已修（2026-10-26）：阈值组内容校验曾是死代码
+
+原条件用了 `explicitEmptyPlans`（`aiGroups` 长度为 0），却写在 `groupPlans.length > 0` 的分支里，**永远不成立**：
+3 条 500/1000/1500 元的报销，`aiGroups:[{title:"100元以内",…}]` 照样输出 `count=3` 且无 warning。
+**修法**：条件改成 `plan.title === 保留标题`，模型用了保留标题才逐条核阈值。
+
+### 11.2 ✅ 已修（2026-10-26）：阈值分组被「详情全空」误吞
+
+触发条件：本轮传了 `aiGroups` + 该组全部命中摘要缓存（⇒ 没拉详情）⇒ `fact === undefined` 被当成「详情为空」⇒ 整组走「沿用父组名整组展示」，阈值分支没机会执行。
+**修法**：排除 `cachedIds`、阈值分支提前；2026-10-27 进一步改成「摘要命中不再跳过详情」（详情缓存兜住请求量），从根上消除这类判据混用。
+
+### 11.3 ⚠️ 满意度组的计划被静默忽略 → 已改为写 warning
+
+`D1` 在其它判定之前 `return`，现在会明确写两条：`满意度类不做 ai二次分组，已忽略 aiGroups` + `summary 由标题兜底（不调 AI）`。
+
+### 11.4 ✅ 已修（2026-10-26）：`aiGroups: []` 不再硬失败
+
+空数组与「未传」语义统一（都走业务类型确定性规则）；原先的非阈值类硬失败已不存在。
+
+### 11.5 子组 `id` 不稳定
+
+编号基于**排序后**的下标，条数一变编号就漂移。如果前端拿 `id` 做展开状态记忆或 diff key，会出现「内容没变但 id 变了」。
+
+### 11.6 `other` 是英文标题 —— 已随 `other` 汇总项一起删除
+
+`SMART_UNCOVERED_TITLE` 不再进入最终结构，卡片上不会再出现英文 `other`。
+
+### 11.7 门槛与叠加视图的相互作用
+
+优先条目也算进所属工作流组的条数，原本 2 条、含 1 条紧急的组现在算 3 条 —— 会**从平铺变成可二次分组**。近一年数据实测符合预期（`totalCount 77` / `Σcount 98`）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weaver-work-cli",
-  "version": "0.1.28",
+  "version": "0.1.31",
   "description": "面向泛微工作工具链的可扩展 TypeScript CLI 基础框架（E10 业票通等能力）",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,7 +19,7 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "clean": "node scripts/clean.mjs",
-    "build": "npm run clean && tsc && node scripts/postbuild.mjs",
+    "build": "npm run clean && tsc && node scripts/bundle.mjs && node scripts/postbuild.mjs",
     "test": "node --import tsx --test $(find test -name '*.test.ts' -type f | sort)",
     "start": "node dist/index.js",
     "build:skill": "node scripts/package-skill.mjs",
@@ -50,6 +50,7 @@
   ],
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "esbuild": "^0.28.2",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0"
   }

package/scripts/bundle.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+// B 方案：把整个 CLI 打成一个 ESM 包（入口 dist/index.js + 按需分块），替代"几千个 js 文件各读一次"。
+//
+// 为什么要它：沙箱里每次 `stat`/`open`/`read` 都很贵，而 tsc 产物是 390 个 js 文件 ——
+// 每条命令光是把这些文件一个个读进来就要几百次系统调用。打包后入口只有 1 个文件，
+// 懒加载（A 方案）产生的那几个 shortcut 各成一个 chunk，仍然只在需要时才 import。
+//
+// 关键约定：
+// - `@napi-rs/keyring` 必须保持 external：它是原生模块，不能内联进 bundle。
+// - 用 `splitting` 保住动态 import 的边界，否则 A 方案的懒加载会被打回单文件。
+// - 入口仍是 dist/index.js（package.json 的 bin 指向它），其余 tsc 产物保持不动。
+import { createRequire } from 'node:module';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const esbuild = require('esbuild');
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const srcDir = path.join(repoRoot, 'src');
+const outDir = process.argv[2] ? path.resolve(process.argv[2]) : path.join(repoRoot, 'dist');
+
+/**
+ * tsc 的产物用 `.js` 后缀指源码（NodeNext 要求），但源码文件其实是 `.ts`。
+ * esbuild 不会自动做这个映射，这里补一个 onResolve：`.js` 不存在就换成同名的 `.ts`。
+ */
+const tsFromJs = {
+  name: 'ts-from-js',
+  setup(build) {
+    build.onResolve({ filter: /\.js$/ }, (args) => {
+      if (args.kind === 'entry-point') return null;
+      if (!args.path.startsWith('.')) return null;
+      const absolute = path.resolve(args.resolveDir, args.path);
+      if (existsSync(absolute)) return null;
+      const asTs = absolute.replace(/\.js$/, '.ts');
+      if (existsSync(asTs)) return { path: asTs };
+      return null;
+    });
+  },
+};
+
+const startedAt = Date.now();
+await esbuild.build({
+  entryPoints: [path.join(srcDir, 'index.ts')],
+  outdir: outDir,
+  bundle: true,
+  platform: 'node',
+  format: 'esm',
+  target: 'node18',
+  splitting: true,
+  chunkNames: 'chunks/[name]-[hash]',
+  external: ['@napi-rs/keyring'],
+  legalComments: 'none',
+  logLevel: 'warning',
+  // commander 是 CJS，内部会 `require('node:events')`。esbuild 的 ESM 输出在模块作用域里
+  // 找不到 `require` 就会抛 "Dynamic require of ... is not supported"，所以给每个产物文件
+  // 补一个真正的 CJS require（banner 会加到 entry 与所有 chunk 上）。
+  banner: { js: "import { createRequire as __esbuildCreateRequire } from 'node:module';\nconst require = __esbuildCreateRequire(import.meta.url);" },
+  plugins: [tsFromJs],
+});
+
+console.log(`bundle: ${path.relative(repoRoot, outDir)}/index.js (+chunks) in ${Date.now() - startedAt} ms`);

package/scripts/package-skill.mjs

@@ -77,7 +77,7 @@ function shouldSkip(entry, relativePath) {
   if (entry.name === '.DS_Store' || entry.name.startsWith('.')) return true
   if (relativePath === 'product.json') return true
   if (relativePath === 'references/source-manifest.json') return true
-  if (entry.isDirectory() && ['assets', 'node_modules', 'scripts'].includes(entry.name)) return true
+  if (entry.isDirectory() && ['cache', 'assets', 'node_modules', 'scripts'].includes(entry.name)) return true
   return false
 }
 

package/skill-template/business-info.json

@@ -444,19 +444,40 @@
   "weaver-e10-jinchengda": [
     "合同",
     "合同管理",
+    "今承达",
     "合同类型",
     "合同模板",
+    "模板推荐",
+    "范文推荐",
     "合同条款",
+    "条款分类",
+    "条款标签",
     "条款引用",
     "签约主体",
+    "我方签约主体",
+    "客户签约主体",
+    "供应商签约主体",
+    "合同智能审查",
+    "AI 审查",
+    "审查报告",
+    "风险点",
+    "内控问题",
+    "法审",
+    "纠错",
+    "合同比对",
+    "文档比对",
+    "版本对比",
+    "比对报告",
+    "企业资信",
+    "资信查询",
+    "合同发起",
     "合同审批",
-    "发起审批",
-    "保存审批",
+    "发起合同",
+    "保存合同表单",
     "提交审批",
     "催办",
     "审批进度",
-    "审批意见",
-    "今承达"
+    "审批意见"
   ],
   "weaver-e10-archive-oa": [
     "档案定位",

package/skill-template/domains/jinchengda.md

@@ -1,23 +1,36 @@
 本业务域用于泛微 E10 今承达合同管理。入口 `SKILL.md` 按飞书 `lark-approval` 风格组织：CRITICAL 共享前置、路由优先级、选命令表、处理链、执行原则、写操作失败决策树和“不在本 skill 范围”。具体用法拆到 `references/`：
 
 - `contract-agent-entry.md`：schema、`contract run` 统一入口、退出码与输入方式。
+- `contract-ai-review.md`：合同智能审查的上传（`ebContract`）、审查页地址与审查记录导出。
+- `contract-flow-launch.md`：四个合同流程的 page/launch，`workflow` 模块上传与 `automaticFormFilling`。
+- `contract-template-recommend.md`：自然语言需求驱动的模板/范文推荐。
+- `contract-doc-compare.md`：`docCompared` 上传、文档检索、历史版本、比对页与差异结果。
+- `contract-credit-page.md`：企业资信页入口与主体全称规则。
 - `contract-template-selector.md`：合同类型树、模板分类树、模板列表与模板详情。
 - `contract-clause-recommender.md`：条款标签、条款分类树、条款搜索、条款列表与条款组。
+- `contract-clause-library-crud.md`：条款库 `checkPermissionV2` 鉴权门，分类/条款/条款组的 `prepare → apply` 写入与回读复核。
+- `contract-ai-assistant.md`：合同智能助手——助手/16 智能体/提示语/内控规则/要素抽取/关联流程与假成功防护。
+- `contract-performance-query.md`：业绩核算六菜单过滤链接与来源/收款台账只读查询（needs_ui 不代操作、组合页不透传、total 取 Count）。
+- `contract-quote-to-contract.md`：报价单转合同（sheet 用户选、真实模板硬门禁、分层打分、纵向合并数值列只归首行）。
 - `contract-clause-reference-save.md`：已引用条款查询与条款引用写入的 `prepare -> apply` 协议。
 - `contract-signing-subjects.md`：应用 Tag、表单 Tag、字段定义、字段选项与签约主体查询。
 - `contract-subject-create.md`：新建签约主体的 `prepare -> apply` 写入协议。
 - `contract-workflow-discovery.md`：workflowId、表单字段与字段选项的运行时解析链。
 - `contract-request-write.md`：创建、保存、提交、催办四个写操作的确认链与错误边界。
 - `contract-request-status.md`：流程状态、签字意见与 `flowStatus.code` 枚举。
-- `contract-disabled-capabilities.md`：企业资信、撤回/退回等未实现能力的处理边界。
+- `contract-disabled-capabilities.md`：资信数据、撤回/退回等未实现能力的处理边界。
 - `source-manifest.json`：源资料指纹，用于后续更新检测。
 
 Agent 调优重点：
 
 - `weaver-work-cli contract schema` 是 operation 合约第一信息源。
 - 业务输入不得包含 `userid`、`userId`、Cookie、ETEAMSID、Token 或内部控制字段，用户 ID 由 CLI 从会话注入。
-- 环境相关 ID（`appId`、`objId`、`formId`、`workflowId`、`nodeId`）必须运行时解析，未找到就停止，不使用标准环境 ID 兜底。
-- 各接口成功码不统一（`code=0`、`code=200`、`message.code="0"`、`message.errcode="0"`），HTTP 200 不等于业务成功。
+- 环境相关 ID（`appId`、`objId`、`formId`、`workflowId`、`nodeId`）必须运行时解析，未找到就停止，不使用标准环境 ID 兜底；固定业务常量（审查 `ai_id`、范文 `textObjId`、四个流程的 `workflowId`/`fieldId`、上传 `module`）反之禁止替换。
+- 上传统一两段式：`preUploadCheck` → `module/upload`，三个场景的 `module`（`ebContract` / `workflow` / `docCompared`）不可混用；成功判据是非空 `fileId`。
+- 页面地址不做整体编码：中文与 `[]` 字面保留，只有资信页 `name[N]` 的值编码一次。
+- 各接口成功码不统一（`code=0`、`code=200`、`message.code="0"`、`message.errcode="0"`、文件服务无 message），HTTP 200 不等于业务成功。
+- 条款库全部 operation 先过 `checkPermissionV2`（`data.checkPermission === true` 才放行）；`clauseNum` 漏传会静默存空编号，必须在回读时校验。
 - 写操作只接受 CLI 生成的 continuation，不手工构造或复用；提交审批与催办需要与“创建并保存”分开的第二次确认。
 - 提交后必须回读 `contract.request.status` 的 `flowStatus.code`（1 审批中 / 3 已归档）才算生效。
 - 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。
+- 打开页面 ≠ 完成业务：不得把“已打开审查页/流程页”报告成“审查完成/流程已发起”。