weaver-work-cli 0.1.40 → 0.1.44

package/skills/weaver-e10-workflow/references/source-manifest.json

@@ -887,12 +887,12 @@
     }
   },
   "artifactBaseline": {
-    "aggregateSha256": "89ee9f67e64f8c6e7c94ddbacc98d4adf9accd37bc3c8fb871fe7734161d86df",
+    "aggregateSha256": "ed7364e2360914cc67359420adf51b8af15e65487440edde0fd6485287207a10",
     "files": [
       {
         "path": "skills/weaver-e10-workflow/references/workflow-agent-entry.md",
         "size": 6090,
-        "sha256": "881a99d43b3379804fab5dc1af6911f4646ae4599e8f85dbd1a724598481eeb7"
+        "sha256": "9ee57381a50ad9b332765ef0b192d723a62831a311fc3fd311e0fcda5e8d0ed0"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-batch.md",
@@ -901,8 +901,8 @@
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-create.md",
-        "size": 65844,
-        "sha256": "136ed885b0abb9908150e3d47e763ef5f1ed406d293702c656b6e3c6344bbd32"
+        "size": 63324,
+        "sha256": "e673b83660692c5199c3b82528b3e17e9141f063227a5c718cf3eff3de37ecd3"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-edit.md",
@@ -912,7 +912,7 @@
       {
         "path": "skills/weaver-e10-workflow/references/workflow-memory.md",
         "size": 13481,
-        "sha256": "807dee9118bb1ba7737ed8528a2c3ea44d11b436a62311307197f16f0e1962f7"
+        "sha256": "ac2296d179a54294c2d4ad77fa169c975e03dee1a7fdb8428c303d734476f5fe"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-operate.md",
@@ -921,8 +921,8 @@
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-query.md",
-        "size": 108768,
-        "sha256": "4eb67609ffe8e51e6cac12ee30c66f116f8a0980c9ba29174ddf091157d4897b"
+        "size": 109512,
+        "sha256": "6a65bf34298e5dd85ae823271c2315ff8edb7933cccb925d818d07d65aa1b519"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-share.md",
@@ -932,22 +932,22 @@
       {
         "path": "skills/weaver-e10-workflow/references/workflow-view.md",
         "size": 10803,
-        "sha256": "54e7ae5267f3b4b6ade3bd0458a51704f3804140b60c5dcc910eab31d1bd1368"
+        "sha256": "2c00d2cc1d92b3b46fba95b98af5a06640177cc7b413eaea017cbc0fd6ccb6c4"
       },
       {
         "path": "skills/weaver-e10-workflow/SKILL.md",
-        "size": 41574,
-        "sha256": "fe8860d92a5bf2f96f3a71e203bbd5993a82acb826a774cd98f371e8b80a2a1d"
+        "size": 53238,
+        "sha256": "fe730cf8ff037ad0af2c12688a1291f7b4db4196ec433676d2ce0371725d2825"
       },
       {
         "path": "src/shortcuts/workflow/continuation.ts",
-        "size": 30700,
-        "sha256": "e5fa7d8fbf0ae334977d18c388f829b29f2bb69b6250081d2d21f68a8bac2cec"
+        "size": 30778,
+        "sha256": "ef30882d3a4734c05f9923823c377b5ef2c599a128879ee9a09dac71c377b005"
       },
       {
         "path": "src/shortcuts/workflow/endpoints.ts",
-        "size": 10182,
-        "sha256": "42363eb685546d065a23363f96ef0e8fbd9d9eece1733a6401cd70596900c614"
+        "size": 10485,
+        "sha256": "3eceb475832db9a92677c5410f2c6923ef0eb48bdeb46bf15234abffbc3ba013"
       },
       {
         "path": "src/shortcuts/workflow/errors.ts",
@@ -956,13 +956,13 @@
       },
       {
         "path": "src/shortcuts/workflow/host.ts",
-        "size": 12448,
-        "sha256": "ae66c65b2c99a300a88ff5ff11fd3c1cd6b594138d2d7779f1939c71e648f0fc"
+        "size": 12412,
+        "sha256": "da1c22b62cf888bd76a36662a4466bcad4eeb3bbed182eff40d2158c91fe4e2e"
       },
       {
         "path": "src/shortcuts/workflow/index.ts",
-        "size": 6275,
-        "sha256": "a626636dba15624b7216aead4d5e016ceffa975eae3b999ec9a7091409bed579"
+        "size": 12243,
+        "sha256": "5fef5d769f4311612111b9781329990a3394cd4b48be98586a381755e2672c7e"
       },
       {
         "path": "src/shortcuts/workflow/manifest.ts",
@@ -971,13 +971,13 @@
       },
       {
         "path": "src/shortcuts/workflow/operations.ts",
-        "size": 9461,
-        "sha256": "50f028b494fc572637c90afeade84c0f0cc36de92a5fa355b4813125a3c6eff0"
+        "size": 11377,
+        "sha256": "86be73ca4060e0b0d9be6595f458cbf2375ac0fd18e2b582977e84431e92732a"
       },
       {
         "path": "src/shortcuts/workflow/operations/chatscene.ts",
-        "size": 13774,
-        "sha256": "64abb0654df387c33b8a380e051a0084d9f8efa40652b6d2516cb394912dba7e"
+        "size": 12742,
+        "sha256": "552d255ebccba1717d1943c6b5e6ead30b84d5bdc2f8a2aac0d65685df1d4f12"
       },
       {
         "path": "src/shortcuts/workflow/operations/flow-status.ts",
@@ -986,18 +986,18 @@
       },
       {
         "path": "src/shortcuts/workflow/operations/form.ts",
-        "size": 351032,
-        "sha256": "3b2036ab629078ac50e0ff37de27d3e42de95e9e9e2cb80f32a31783fbe00cfa"
+        "size": 375504,
+        "sha256": "b82d7d6062997c72d92c8f42c2aa91ef4f568d55b173cf128425070a51ee471a"
       },
       {
         "path": "src/shortcuts/workflow/operations/read.ts",
-        "size": 282043,
-        "sha256": "8606f1c0cd165c3ffafbba8d1fecc4c4d22d155de44f194bacd34fa88fa8c2ee"
+        "size": 287970,
+        "sha256": "6d3652228e77b4ec0b69f652cc5728147111f8f6c60f6142e528187401a96315"
       },
       {
         "path": "src/shortcuts/workflow/operations/registry.ts",
-        "size": 1412,
-        "sha256": "60072ec96bc88202b98cf86d2487219e7369d1bd8d161c08aaac914152a829ec"
+        "size": 1548,
+        "sha256": "01c4ed02064f5e9148fd50e90d6c0363322be05162b9a5795a5f7c738c5b43b9"
       },
       {
         "path": "src/shortcuts/workflow/operations/shared.ts",
@@ -1016,8 +1016,8 @@
       },
       {
         "path": "src/shortcuts/workflow/operations/write.ts",
-        "size": 142628,
-        "sha256": "5de4cbc724a4882aabc0d2ee796e2d72141c2c48e622a3499a89a5fc2b0de114"
+        "size": 142668,
+        "sha256": "9bbb969c1660ee0b66cbd7192a14e368fa3dc25d7fed70891ca96eb5cd0145b2"
       },
       {
         "path": "src/shortcuts/workflow/state.ts",
@@ -1026,8 +1026,8 @@
       },
       {
         "path": "src/shortcuts/workflow/stdout-compact.ts",
-        "size": 2958,
-        "sha256": "1d72ac72a69c63655530f0c458f34733ebeb5645a9f1937f3ecdc07815adb40e"
+        "size": 3410,
+        "sha256": "1271956f755f8d1a314f68fb348d0ca64febd36f6559d01e01f85f4a32a0dc4b"
       }
     ]
   },

package/skills/weaver-e10-workflow/references/todo-smart-convert.md

@@ -5,13 +5,13 @@
 **触发分流（2026-10-28 用户定稿，与 `SKILL.md`「待办『汇总』vs『统计』分流」同口径）**：原话含 **「汇总待办」/「批量处理待办」/「摘要」** 等归拢说法 → 走本 operation；原话含 **「统计待办」** → 走 `workflow.todoStat`（不是本 operation）；两类词同时出现按本 operation（归拢优先）；三类词都没有（"有哪些待办 / 列出来 / 多少条"）→ `workflow.search`。**不要**为了"先看一眼有哪些"先去调 `todoStat` / `search` 再回头走本链路——那会多花一轮，且交付形态会被带偏。
 
 > **⚠️ 2026-10-28 起：分组规则已外置到 JSON，代码不再按业务类型分支。**
-> 唯一真源是 `skills/weaver-e10-workflow/aigroup/default.json`（`{defaults, rules[]}`，随 skill 分发、只读），用户意图另存 **CLI 状态目录**下的 `aigroup/user-intents.json`（`aigroup set` 写入，不落 skill 目录）。
+> 唯一真源是 `skills/weaver-e10-workflow/aigroup/default.json`（`{defaults, rules[]}`，随 skill 分发）——**它同时是用户本机可直接编辑的规则文件**：用户调试、增删规则是常态，CLI 与执行方**只管读**，内容是什么就按什么跑；**禁止**与仓库版本比对、禁止覆盖「恢复」、禁止探究改动来源。用户意图另存同目录 `aigroup/user-intents.json`（`aigroup set` 写入；旧位置在 CLI 状态目录，兼容回读）。
 > 现行规则要点：①没有 `aiGroup` ⇒ 全平铺；②`focus:true` ⇒ 按 `focusKeyword`（`[指标, 算子, 值]`，十种算子）确定性成一组，`groupTitle` 为组名，`sysArg` 指明指标取自列表属性还是流程详情；③`focus:false` ⇒ `aiContext`（流程标题/流程详情）交 AI 分组，**必须**给 `aiGroups`；④`focus:true` 收到多个计划子组时**只保留条数最多的一个**，其余平铺；⑤`aiGroups.seq` 已删除，只认 `requestIds`；⑥组摘要 `groupSummary.needAI:false` 时由 CLI 按 JSON `template` 渲染，`true` 时交 AI；⑦单条摘要由 `needSummary` 决定（false ⇒ 用标题）；⑧`focus:false` 还可给 `groupingPrompt`（二次分组口径，见下节）；⑨**`summaryRequiredFields`（要素级交付闸门，2026-11-01）**：规则声明的关键字清单，本组每条摘要必须逐项包含，缺任一项 ⇒ 导出闸门 `exit 1`（见 §6.1）。
 
 **`groupingPrompt`（2026-10-29 新增，schemaVersion 3）**
 - 位置 `aiGroup.groupRule.groupingPrompt`，**只在 `focus:false` 时有意义**；`focus:true` 给它会直接校验失败。可选，不给就按素材自由分组。
 - 分工：`aiContext` 决定**看什么**（是否预取流程详情），`groupingPrompt` 决定**怎么切**（组名词表、归属规则）。
-- 下发方式：`collect` 会把该字段原样放进 `groupingBrief[].groupingPrompt`，`smartGroup` 的 `ai_groups_required` 报错文案也会带上。**模型生成 `aiGroups` 前必须先读它并照做**（组名只能取它给的词表，不得新造）。
+- 下发方式：`collect` 会把该字段原样放进 `groupingBrief[].groupingPrompt`，`subGroup` 阶段的 `ai_groups_required` 报错文案也会带上。**模型生成 `aiGroups` 前必须先读它并照做**（组名只能取它给的词表，不得新造）。
 - 限制：非空字符串、≤500 字（会原样进模型上下文）。
 > 本文档只描述**机制与执行规则**（aiGroups 格式与校验、子组解散/平铺机制、意图判定、素材与缓存、交付形态）；**分组阈值、组名词表、摘要模板、排除清单等业务口径一律以 `aigroup/default.json` 为准**（`prep`/`build` 输出会回显相关内容），与本文冲突时以 JSON 为准。
 
@@ -38,7 +38,7 @@ weaver-work-cli --json workflow aigroup set --input-json '{"workflowName":["费
 | --- | --- | --- |
 | `workflowName` | 工作流名称 | 大组的 `title` 就是它 |
 | **第一次分组** | 按 `workflowName` 把条目分到各个工作流；得到的每个组叫**工作流分组** | `runGroup` → `wfIdGroup[]` |
-| **ai二次分组** | 在工作流分组**内部**再切子组的过程；**只有这一步需要 AI 计划** | `smartGroup` + `aiGroups` |
+| **ai二次分组** | 在工作流分组**内部**再切子组的过程；**只有这一步需要 AI 计划**。**位于单条摘要之后**（2026-11-03 解耦） | `subGroup` + `aiGroups` |
 | **原始列表数据** | `/getTodoListData` 返回的待办条目集合，**整条链路的唯一数据源**（每条对应一个 `requestId`） | `collect` 的 `items[]` |
 | **流程标题** | 条目标题 `requestNameTitle`；没有**流程详情数据**时，AI 只能靠它做语义判断，也是摘要的兜底文案 | `requestData.requestNameTitle` |
 | **流程详情数据** | `/getWorkflowRequest` 返回的表单字段 + 基础信息；用于 a) 分组素材 b) 摘要素材 c) 阈值指标（请假天数/报销金额/到期时间） | `DetailFact { context, metrics }` |
@@ -54,9 +54,10 @@ weaver-work-cli --json workflow aigroup set --input-json '{"workflowName":["费
 | --- | --- |
 | `collect` | 调列表接口取数，并生成首次分组和 `groupingBrief` |
 | `group` | 对已传入的 `items` 重新做首次分组 |
-| `smartGroup` | 校验 `aiGroups`，组装最终三键结构 |
-| `summaryContext` | 拉详情并生成单条摘要素材 |
-| `summary` | 回填 `aiSummaries`，可同时生成组摘要素材 |
+| `smartGroup` | 首次分组 + 详情回填 + **平铺**结构（**不做** ai 二次分组） |
+| `summaryContext` | 生成单条摘要素材（按平铺结构切批） |
+| `summary` | 回填 `aiSummaries`；`withSubGroup:true` 时同进程接着做二次分组 |
+| `subGroup` | **ai 二次分组**：在已回填摘要的成品结构上应用 `aiGroups`，切出汇总项 |
 | `groupSummaryContext` | 生成汇总项摘要素材 |
 | `groupSummary` | 回填 `aiGroupSummaries` |
 | `aggregate` | 兼容旧调用的本地去重、分组和金额合计 |
@@ -65,11 +66,15 @@ weaver-work-cli --json workflow aigroup set --input-json '{"workflowName":["费
 
 ```text
 collect
-  -> smartGroup（可传 withDetailContext:true）
-  -> summary（可传 withGroupSummaryContext:true）
+  -> smartGroup（可传 withDetailContext:true；只做首次分组，平铺）
+  -> summary（回填单条摘要；withSubGroup:true 时接着做二次分组）
   -> groupSummary（仅存在待回填组摘要时）
 ```
 
+阶段划分（2026-11-03 用户定：**分组与摘要不耦合**）：
+`collect` → `smartGroup`（workflowName 分组）→ 单条摘要 → `subGroup`（ai 二次分组）→ 组摘要 → 导出。
+`focus:false` 的组只在 **`subGroup`** 阶段要求 `aiGroups`；摘要阶段不再被它阻塞。
+
 未传 `stage` 时，没有 `items` 进入 `collect`；传入 `items` 进入兼容的本地汇总；回灌带有最终结构的数据时由 CLI 推断后续阶段。显式 `stage` 优先。
 
 每次模型调用由调用方把 AI 耗时追加到 `skillTiming`；CLI 会把当前阶段耗时追加到 `meta.timing.steps`。不要为没有执行的 AI 阶段填入耗时。
@@ -111,8 +116,9 @@ collect
     **详情为空也写**；旧版本条目（v2 及更早，basicInfo 里还带标题）读取时视为无效，自动重拉；
     `excludeOriginFormDataFields` 变了 ⇒ `excludeTag` 对不上 ⇒ 旧条目自动失效重拉（与摘要缓存的 pk 机制同思路）；
   - 摘要缓存：单条摘要文本。条目除 `maxChars`/`pk`（口径）外还带 **`dv`（详情素材特征值，2026-11-01 根治）**：写入时对当前详情素材（basicInfo+fields 内容哈希）取特征值，读取时与当前素材比对——素材升级/排除清单调整/详情缓存被清（无法核验）⇒ 旧摘要失效重写；无 `dv` 的旧条目按旧规则兼容命中。
-    **失效条件（2026-11-02 用户定稿）：只由 `requestSummaryPrompt`（default.json / 用户意图）调整触发**——①条目缺 `pk` = 旧口径条目，**兼容命中**（无法证明口径变过就不作废）；②`maxChars` 仅在用户显式传 `--summary-chars` 时参与比对，规则/默认字数变化（如 50→150）**不作废**历史摘要；③`dv` 仍比对素材变化。对照实测：修复前 285 条旧口径条目全 miss（冷缓存 35 分钟级），修复后同数据集 `prefilled=312｜待写 0`。
+    **失效条件：由 `requestSummaryPrompt`（default.json / 用户意图）调整触发**——①`pk` **严格比对**（2026-11-04 收紧，取代 11-02 的「条目缺 pk 兼容命中」）：调用方传了 pk 时，条目**缺 pk** 或 **pk 不等** ⇒ 一律失效重写。此前「缺 pk 就放过」等于「改 prompt 对老条目永远不生效」——缺 pk 只能说明口径未知，不能证明口径没变。空口径（`pk===''`）照常落库，因此改空 / 改回非空同样能失效，空口径组也不会每次 miss；②`maxChars` 仅在用户显式传 `--summary-chars` 时参与比对，规则/默认字数变化（如 50→150）**不作废**历史摘要；③`dv` 仍比对素材变化，**条目缺 `dv` 依旧兼容命中**（素材侧无法核验，未随本次收紧）。
   记录里带 `lastFeedBackDateTime` 就是为了这个 key：**流程有新反馈 ⇒ key 变 ⇒ 缓存自然失效**。
+- **缓存缺失/未命中 = 冷缓存（2026-11-03 用户定稿）**：`cache/` 下文件不存在、被清理或条目 miss，一律按「从未生成过」处理，直接走待写摘要流程；**禁止**追溯缓存丢失或被删的原因、**禁止**从备份恢复缓存、也不作为异常上报用户。
 - 详情取数时机：`collect` 只为「用户给了 `groupFocus` 且意图适用于本组」的组预取字段；`smartGroup` 对全部条目走一次「缓存优先」的取数（命中零请求）。因此**冷缓存下详情请求集中在 `smartGroup`，`summary` 阶段通常 0 请求**。
 - 摘要缓存**只省 AI、不省详情**：阈值指标只认流程详情数据，所以命中摘要的条目仍会查一次详情缓存；摘要为空的条目用标题兜底。
 
@@ -120,27 +126,31 @@ collect
 
 - `groupBy` 支持 `workflow`、`urgency`、`date`、`none`，默认 `workflow`。
 - 优先组固定为 `id=priority`、标题“建议优先处理的流程”，排在第一位。超时条目必入；没有级别 2 时才使用级别 1，级别 0 不因等级入选。
+- **生成时机（2026-11-03 用户定）**：优先组**不再在分组阶段产出**，而是在**最终结构**上由 `assemblePriorityGroup()` 生成——摘要与组摘要全部回填后，按 `generalRules.priorityGroup` 从各工作流分组的 `displayItems` 里筛出条目、复制一份置顶。因此 `prep`/`build` 的组清单里**没有**这一组（组数比其他阶段少 1），只有最终导出结构才有；判据字段（`overTime`/`userOverTime`/`requestLevel`）都在 `requestData` 上，无需回查列表。该函数**幂等**（输入已有 priority 会先剔除再重建）。
 - 优先组是**叠加视图**，不是筛选：入选条目**仍保留在各自的工作流分组里**（优先组只是置顶入口）。因此 `Σcount` 会大于 `totalCount`，**`totalCount` 一律按去重条数计（= collect 取到的全部条数），不做分组求和**。
 - 普通组保持接口返回的首次出现顺序。只有调用方明确给出排序意图时才传 `groupOrder`；`topN` 只影响中间 Markdown，不裁剪最终数组。
 - `groupingBrief` 用组内 1-based `idx` 标识条目；`idx` 与 `prep` 输出目录 `state.json` 里 `planGroups[].rows[].requestId` 一一对应。生成 `aiGroups` 时一律用 `requestId`：需要映射就从 `state.json` 一次性提取，不要手抄，更不要用 `seq`（已废弃）。
 
 ## 4. `smartGroup` 和 `aiGroups`
 
-`aiGroups` 是扁平数组，每项只允许 `groupId`、`title`、`requestIds` 三个键（**`seq` 已废弃**：传入即报 `aiGroups 元素必须是 {groupId,title,requestIds:[...]}（seq 已废弃）`，2026-11-02 起文档统一只给 `requestIds` 写法）：
+`aiGroups` 是扁平数组，每项允许 `groupId`、`title`、`requestIds`、`summary` 四个键（**`seq` 已废弃**；`summary` 是 2026-11-03 新增的可选键）：
 
 ```json
 [
-  { "groupId": "workflow-id", "title": "安全通知", "requestIds": ["101", "103"] },
+  { "groupId": "workflow-id", "title": "安全通知", "requestIds": ["101", "103"], "summary": "本组为安全补丁升级通告，含 2 条补丁安装提醒，建议优先处理。" },
   { "groupId": "workflow-id", "title": "制度通知", "requestIds": ["102", "104"] }
 ]
 ```
 
+- **`summary`（组摘要）与分组在同一次交互产出**：给了就原样落到 `displayItems[].summary`，`groupSummaryBatches` 不再为它产批次 ⇒ **不必再跑一轮组摘要**。规则 `aiGroup.groupSummary.needAI === true` 的组（如内部留言、安全问题处理工单）**建议一定带**；`needAI:false` 的确定性组（请假/报销/问题支持）由 CLI 模板渲染，带了也以你给的为准。
+- 写 `summary` 时手上有本组的标题 + 每条 `summary`（单条摘要已在前一步写进结构），直接概括即可；字数按 `groupSummaryMaxChars`（默认 100）。
+
 - `requestIds` 必填且非空，成员必须属于本组；未知 `groupId`、未知 `requestId`、重复分配直接失败。
 - 优先组不可二次分组。
 - 组内少于 3 条时**一律平铺单条**，不产生任何汇总项——阈值组（1天以内 / 100元以内）、问题支持过期组、内部留言整组都不例外；**即使给了 `aiGroups` 也忽略**（CLI 写 warning）。这条是硬门槛，没有例外。
 - **计划子组不足 2 条会被解散平铺**（CLI 写 warning「N 个子组不足 2 条，已解散」）——这是机制行为，与上一条相互独立：若 `groupingPrompt` 的自然粒度每组只有 1 条（如 安全问题处理工单 按 git 文件，11 条对应 11 个文件），按它给的计划会全部解散、整组平铺，**这是该计划的必然结果，不是错误**；要真正成组，就得按能凑够每组 ≥2 条的粒度给计划（如按文件族），且组名仍必须来自 `groupingPrompt` 口径、**不得为凑组虚构更粗粒度的新组名**（如"XML/Java 文件类型"）。
 - 组内至少 3 条时，完全省略 `aiGroups` 走 CLI 确定性分组；显式传入后，未知 `groupId`、未知 `requestId`、重复分配直接失败（**仅在本组计划会被采纳时校验**：意图适用于本类型，或本组是内部留言）。
-- `aiGroups` 何时该给——**三种情形**（`prep` 输出会给组标 `[必须给 plan]`，照标注执行即可）：
+- `aiGroups` 何时该给——**三种情形**（`prep` 输出会给组标 `[需二次分组]`，照标注执行即可）：
   - ① 用户给了侧重点（`groupFocus`），且侧重点**按意图表适用于本组类型**；
   - ② 本组是**内部留言** —— 而且**≥3 条时是必须给**：没有侧重点（或侧重点不适用）就按**流程标题**分组，缺计划直接报 `ai_groups_required`；
   - ③ 规则里 `aiGroup.groupRule.focus === false` 的组（如 **安全问题处理工单**，上下文=流程详情）——**≥3 条时必须给**，缺计划同样报 `ai_groups_required`。这类组的分组素材（如漏洞地址里的 git 文件）来自流程详情，prep 无侧重点时不带字段注记 ⇒ 按 references 上文的「单条查询详情」兜底取得，**不要用标题推断**。
@@ -281,7 +291,7 @@ collect
 - `params_pc` / `params_mobile` 必须放在 `sdkOptions` 内、与 `routerProps_pc/mobile` 同级，**不要放进 `arguments` 层**。
 - `app` 的值按原始字符写 **`@weapp/workflow`**（`@` 后面**没有**斜杠，共 15 个字符）：**不要写成 `@//weapp/workflow`、不要转义成 `@\/\/weapp\/workflow`、也不要加前导空格**——带前导空格会导致 app 解析失败（用户 2026-10-27 以截图校正）。
 - 脚本 `exportFinal` 已在 stdout 的 `[JSON_BEGIN]`/`[JSON_END]` 之间直接输出**带标签的整块载荷**，原样粘贴即可；交付 JSON 文件（`~/Downloads/<用户名>_<时间戳>.json`）由脚本自动落盘并打印路径，**默认不 `present_files`（见 §6.1 顶部）**。旧 `--file` 分支（写 `待办汇总-*.json` 外框归档）已于 2026-11-01 **删除**——传了也会被忽略，不要再依赖它。
-- **交付硬闸门（2026-11-01）**：`finish`/`build` 导出前强制校验——①空单条摘要 >0、②空组摘要 >0、③待写摘要未全部回填（列出缺失 requestId）、④详情取数失败（`failed>0`，防"静默降级+标题编内容"）、⑤**降级话术黑名单**（摘要含「未在标题体现 / 标题未体现 / 标题里没有 / 详见流程 / 详见详情 / 待确认」即拦截——把取数失败写成业务信息缺失）、⑥**要素级校验**（规则 `summaryRequiredFields` 声明的关键字，本组每条摘要必须逐项包含，缺任一即拦截并列出缺失项）——任一命中即 `exit 1` 拒绝导出。显式豁免：`--allow-empty-summary`（豁免①②③⑤⑥）、`--allow-detail-fail`（豁免④）。**豁免是给"确认要带瑕疵出文件"用的，不要拿它当常规手段绕过校验。**
+- **交付硬闸门（2026-11-01）**：`finish`/`build` 导出前强制校验——①空单条摘要 >0、②空组摘要 >0、③待写摘要未全部回填（列出缺失 requestId）、④详情取数失败（`failed>0`，防"静默降级+标题编内容"）、⑤**降级话术黑名单**（摘要含「未在标题体现 / 标题未体现 / 标题里没有 / 详见流程 / 详见详情」即拦截——把取数失败写成业务信息缺失；2026-11-03 按用户要求去掉「待确认」：摘要里出现"待确认"属于正常业务表述）、⑥**要素级校验**（规则 `summaryRequiredFields` 声明的关键字，本组每条摘要必须逐项包含，缺任一即拦截并列出缺失项）——任一命中即 `exit 1` 拒绝导出。显式豁免：`--allow-empty-summary`（豁免①②③⑤⑥）、`--allow-detail-fail`（豁免④）。**豁免是给"确认要带瑕疵出文件"用的，不要拿它当常规手段绕过校验。**
   - **组摘要未回填 ≠ 失败（2026-11-02 P2 定稿）**：`finish`/`build` 遇到组摘要待回填时，把**完整素材**（含每个成员的 `requestId`、标题、发起人、单条摘要、`prompt`）写 `<out>/need-group-summaries.json`，以 **`exit 0` + `NEEDS_GROUP_SUMMARIES`** 返回、**不导出**（控制台只给紧凑清单，此前每批 400 字符的截断预览已废除）；在该文件每个元素里补 `summary` 后用 `--group-summaries` **指回同一个文件**重跑即可（脚本自动只取 `groupId`/`summary`，`items` 等多余字段不外传）。`--allow-empty-summary` 豁免后才按空组摘要继续导出。上方①②④⑤⑥等真失败仍 `exit 1`。
 - 体积见 §6.2：**不能按组拆成多个 `<browsertool>` 块**（拆开就不是合法载荷）；超限时先在正文说明条数与预计体积，建议缩小范围，用户坚持再照做。
 

package/skills/weaver-e10-workflow/tools/todo-summary.cjs

@@ -512,6 +512,23 @@ function loadAigroupRuleFile() {
   return aigroupRuleFileCache;
 }
 
+// ── 规则指纹（2026-11-04 新增：交付纪律强化）────────────────────────────
+// 对影响取数/分组/摘要口径的规则文件算指纹：aigroup/default.json + aigroup/user-intents.json（若存在）。
+// prep 时写入 state，finish 导出前比对——规则在取数之后被改过 ⇒ 数据是旧口径产出，拒绝导出，
+// 防「新规则 + 旧数据」的静默交付（2026-11-04 实测：快照 09:49 导出、规则 09:50 修改）。
+function ruleFingerprint() {
+  const { createHash } = require('node:crypto');
+  const aigroupDir = path.join(path.resolve(__dirname, '..'), 'aigroup');
+  const parts = [];
+  for (const name of ['default.json', 'user-intents.json']) {
+    const file = path.join(aigroupDir, name);
+    if (!fs.existsSync(file)) continue;
+    const buf = fs.readFileSync(file);
+    parts.push(`${name}#${createHash('sha256').update(buf).digest('hex').slice(0, 16)}(${buf.length}B)`);
+  }
+  return parts.join(' | ');
+}
+
 /** 组名 → 该规则的 summaryRequiredFields（needSummary:false 的组不校验）。 */
 function requiredFieldsFor(title) {
   const rules = loadAigroupRuleFile().rules || [];
@@ -536,6 +553,20 @@ function exportFinal(result, dir, state, kept, opts = {}) {
   const stats = groupStats(data.wfIdGroup);
   const total = groupTotal;
   // ── 交付硬闸门（2026-11-01 用户拍板）：缺环节 / 静默降级出不了交付物，只有显式豁免才放行 ──
+  // ⓪ 规则新鲜度（2026-11-04 新增）：取数之后规则文件被改过 ⇒ 本次数据是旧口径产出，
+  //    拒绝导出。旧 state（无 ruleFp）仅提示不拦截，保持向后兼容。
+  if (state.ruleFp) {
+    const nowFp = ruleFingerprint();
+    if (nowFp !== state.ruleFp && opts.allowStaleRules !== true) {
+      console.error('\n✖ 交付拦截：规则文件在取数之后被修改，本次数据是旧口径产出。');
+      console.error('  取数时指纹：%s', state.ruleFp);
+      console.error('  当前指纹  ：%s', nowFp);
+      console.error('  → 请重新执行 run 取数后再 finish；确要带旧口径出文件，加 --allow-stale-rules 显式豁免。');
+      process.exit(1);
+    }
+  } else {
+    console.error('⚠ 本次 state 无规则指纹（旧版本产出），跳过规则新鲜度校验。');
+  }
   const allowEmpty = opts.allowEmptySummary === true;
   const detailFailed = Number(opts.detailFailed) || 0;
   const groupEmpty = Number(opts.groupEmpty) || 0;
@@ -563,7 +594,7 @@ function exportFinal(result, dir, state, kept, opts = {}) {
   }
   // ⑤ 降级话术黑名单（2026-11-01）：摘要正文出现"未在标题体现/详见流程"这类表述，
   //    说明执行方把「自己没取到」写成了「业务对象没有」——按模板回查详情补齐后重写。
-  const DEGRADE_PHRASES = ['未在标题体现', '标题未体现', '标题里没有', '详见流程', '详见详情', '待确认'];
+  const DEGRADE_PHRASES = ['未在标题体现', '标题未体现', '标题里没有', '详见流程', '详见详情'];
   const degraded = [];
   for (const group of data.wfIdGroup || []) {
     for (const item of group.displayItems || []) {
@@ -861,6 +892,7 @@ function cmdPrep(args) {
     groupFocus: args.focus && args.focus !== true ? String(args.focus) : null,
     summaryMaxChars: args["summary-chars"] ? Number(args["summary-chars"]) : null,
     groupSummaryMaxChars: args["group-summary-chars"] ? Number(args["group-summary-chars"]) : null,
+    ruleFp: ruleFingerprint(),
     fetched: all.length, kept: kept.length, dropped,
     planGroups,
   }));
@@ -901,7 +933,7 @@ function cmdPrep(args) {
     const kind = kindOfTitle(group.title);
     const skip = group.groupId === 'priority' || group.count <= 1 || (kind !== '' && !focusKinds.has(kind));
     const rule = skip ? null : matchRule(group.title);
-    const marker = skip ? ' [无需分组]' : (rule || group.title.includes('内部留言') ? ' [必须给 plan]' : '');
+    const marker = skip ? ' [无需分组]' : (rule || group.title.includes('内部留言') ? ' [需二次分组]' : '');
     console.log(`=== ${group.groupId} | ${group.title} | ${group.count}${marker}`);
     if (skip) continue;
     // 回显规则内容：组名/分法只按 groupingPrompt 来（词表不得自造），摘要按 requestSummaryPrompt 写
@@ -916,7 +948,8 @@ function cmdPrep(args) {
     }
   }
   console.log('\n下一步：node %s build --dir %s', path.basename(__filename), dir);
-  console.log('（标了 [必须给 plan] 的组——内部留言、以及规则 focus:false 的组如 安全问题处理工单——build 时必须带 --plan <aiGroups.json>；组名/分法/摘要口径见各组下回显的规则内容；其余走确定性分组）');
+  console.log('（标了 [需二次分组] 的组——内部留言、以及规则 focus:false 的组如 安全问题处理工单——在**单条摘要之后**的二次分组阶段才需要 aiGroups；build 阶段不需要，先把摘要写完）');
+  console.log('（写 aiGroups 时给 needAI:true 的组带上 summary 字段，分组+组摘要在同一轮拿到，不用再跑一次组摘要）');
 }
 
 function cmdBuild(args) {
@@ -926,7 +959,8 @@ function cmdBuild(args) {
   const kept = readJson(path.join(dir, 'items.json'));
   const planGroups = state.planGroups || [];
   const countById = new Map(planGroups.map((g) => [g.groupId, g.count]));
-  // `--plan`：确定性类型可不传；prep 标了 [必须给 plan] 的组（内部留言 / focus:false 组）不传会被 CLI 拒（ai_groups_required）。
+  // `--plan`：2026-11-03 起 build 阶段**不再消费** aiGroups（二次分组后移到 subGroup）；
+  // 这里只做校验与落盘，finish 阶段自动读取目录里的 aiGroups.json。
   // 不传时直接走 CLI 确定性分组（等价于 aiGroups 未传）。
   let aiGroups;
   if (planFile) {
@@ -937,7 +971,7 @@ function cmdBuild(args) {
   const byGroup = new Map();
   for (const entry of aiGroups) {
     if (!entry || !entry.groupId || !Array.isArray(entry.requestIds)) {
-      console.error('✖ aiGroups 元素必须是 {groupId,title,requestIds:[...]}（seq 已废弃）'); process.exit(1);
+      console.error('✖ aiGroups 元素必须是 {groupId,title,requestIds:[...],summary?}（seq 已废弃）'); process.exit(1);
     }
     if (!countById.has(String(entry.groupId))) {
       console.error(`✖ 未知 groupId ${entry.groupId}（合法值见 state.json 的 planGroups）`); process.exit(1);
@@ -965,8 +999,8 @@ function cmdBuild(args) {
   const t = Date.now();
   const sg = runStage({
     stage: 'smartGroup',
+    // 2026-11-03：本阶段只做 workflowName 首次分组 + 平铺结构（二次分组在 finish 的 subGroup）。
     items: kept,
-    ...(aiGroups !== undefined ? { aiGroups } : {}),
     withDetailContext: true,
     ...(state.groupFocus ? { groupFocus: state.groupFocus } : {}),
     ...(state.summaryMaxChars ? { summaryMaxChars: state.summaryMaxChars } : {}),
@@ -1006,18 +1040,6 @@ function cmdBuild(args) {
   }
   console.log('  → 读 need-summaries.json（items[].requestId + context），摘要写成 aiSummaries.json（元素 {requestId,summary}）后重跑：');
   console.log('    node %s finish --dir %s --summaries <aiSummaries.json> --timing-report', path.basename(__filename), dir);
-  // 组摘要（aiGroup.groupSummary.needAI=true 的汇总项）：口径随批次下发，模型按它写 aiGroupSummaries
-  const gsBatches = sg.data.groupSummaryBatches || [];
-  if (gsBatches.length > 0) {
-    console.log('\n待写组摘要（写成 aiGroupSummaries.json，元素 {groupId,summary}）：');
-    for (const b of gsBatches) {
-      console.log(`### 组摘要 ${b.groupId}｜${b.parentTitle} → ${b.title}｜${b.count} 条｜目标字数 ${b.suggestedMaxChars}`);
-      if (b.prompt) console.log(`口径：${b.prompt}`);
-      if (b.hint) console.log(`提示：${b.hint}`);
-      if (b.stats && b.stats.tail) console.log(`tail：${b.stats.tail}`);
-    }
-    console.log('\nfinish 时加：--group-summaries <aiGroupSummaries.json>');
-  }
 }
 
 function cmdFinish(args) {
@@ -1026,7 +1048,14 @@ function cmdFinish(args) {
   const kept = readJson(path.join(dir, 'items.json'));
   // `aiGroups.json` 可能不存在（build 没传 --plan 时就是确定性分组），此时按「未传 aiGroups」处理。
   const planPath = path.join(dir, 'aiGroups.json');
+  // `--plan` 给了就以它为准（落到目录里，后续 stage=subGroup 直接读）
+  if (args.plan && args.plan !== true) {
+    const src = String(args.plan);
+    if (src !== planPath && fs.existsSync(src)) fs.copyFileSync(src, planPath);
+  }
   const aiGroups = fs.existsSync(planPath) ? readJson(planPath) : undefined;
+  /** 有没有二次分组计划：没有就只回填单条摘要，不做 subGroup（也就不产组摘要、不导出）。 */
+  const hasPlan = aiGroups !== undefined;
   const sg = readJson(path.join(dir, 'smartgroup.json'));
 
   // 即使没传 --summaries 也要跑一次 summary 阶段：这样才能让**摘要缓存**回填
@@ -1040,7 +1069,9 @@ function cmdFinish(args) {
     withDetailContext: true,
     wfIdGroup: sg.data.wfIdGroup,
     aiSummaries,
-    withGroupSummaryContext: true,
+    // 单条摘要回填完 → 同进程做 ai 二次分组（stage=subGroup）→ 再产组摘要批次；
+    // 没有 aiGroups 时只回填单条摘要，二次分组留到下一步（两条链路完全解耦）。
+    ...(hasPlan ? { withSubGroup: true, withGroupSummaryContext: true } : {}),
     ...(state.summaryMaxChars ? { summaryMaxChars: state.summaryMaxChars } : {}),
     ...(state.groupSummaryMaxChars ? { groupSummaryMaxChars: state.groupSummaryMaxChars } : {}),
     skillTiming: { startedAt: state.startedAt, steps: [{ name: 'collect', kind: 'cli', durationMs: state.collectMs }] },
@@ -1053,6 +1084,15 @@ function cmdFinish(args) {
   fs.writeFileSync(path.join(dir, 'state.json'), JSON.stringify(state));
   console.log('summary 内部 %s / 含进程启动 %s（回填 %d 条，其余走缓存预填）',
     summaryInternal === null ? '-' : fmt(summaryInternal), fmt(summaryWallMs), aiSummaries.length);
+  if (!hasPlan) {
+    // 2026-11-03：ai 二次分组与单条摘要解耦——没有计划就停在这里，不产组摘要、不导出。
+    const filled = (result.meta && result.meta.summarized) || 0;
+    const emptyN = (result.meta && result.meta.empty) || 0;
+    console.log('单条摘要已回填 %d 条（空 %d）。ai 二次分组是下一步：', filled, emptyN);
+    console.log('  把 aiGroups.json 放到 %s（或 --plan <path>），再跑：', path.join(dir, 'aiGroups.json'));
+    console.log('  node %s finish --dir %s --plan <aiGroups.json> --timing-report', path.basename(__filename), dir);
+    return;
+  }
   // 未回填的缺失 id 不在这里单列：summary 阶段的信封不带 summaryBatches/summaryStats，
   // 空 id 列表统一由 exportFinal 的闸门①从最终结构里就地提取（能直接给出 requestId）。
   // 未知 requestId 的 aiSummaries 由 CLI 侧硬校验拒绝（ai_summary_unknown_request，非零退出）。
@@ -1118,6 +1158,7 @@ function cmdFinish(args) {
     // 详情取数发生在 smartGroup 阶段 ⇒ failed 从 smartgroup.json 的 data.summaryStats 取。
     allowEmptySummary: args['allow-empty-summary'] === true,
     allowDetailFail: args['allow-detail-fail'] === true,
+    allowStaleRules: args['allow-stale-rules'] === true,
     detailFailed: ((sg.data || {}).summaryStats || {}).failed || 0,
     groupEmpty: (finalResult.meta && finalResult.meta.groupEmpty) || 0,
   });
@@ -1173,8 +1214,9 @@ else {
   console.log('用法：node ' + path.basename(__filename) + ' <run|prep|build|finish> [options]');
   console.log('  run    [--days N | --from A --to B] [--limit 500] [--out DIR] [--timing-report]   # 一次跑完 prep+build；用户没说时间段就都不传 = 不限时间取前 500 条');
   console.log('  prep   --limit 100 [--exclude 内部留言] [--days 1460] [--sub-category 待处理] [--tabid 7] [--isremarks 1,2] [--out DIR]   # 小分类：--sub-category/--tabid（显式 tabid 优先）；isremarks=备注筛选（数字逗号拼接）');
-  console.log('  build  --dir DIR [--plan aiGroups.json]   # prep 标注 [必须给 plan] 的组必须传；其余不传走确定性分组');
+  console.log('  build  --dir DIR [--plan aiGroups.json]   # aiGroups 可先落盘（不传也行）：build 只做首次分组+平铺，二次分组在 finish');
   console.log('  finish --dir DIR [--summaries aiSummaries.json] [--group-summaries aiGroupSummaries.json] [--timing-report]');
+  console.log('  规则新鲜度：finish 导出前比对 aigroup 指纹——规则在取数后被改过即拦截（新规则+旧数据出不了文件）；确要带旧口径出文件加 --allow-stale-rules');
   console.log('  待写摘要素材：build/ run 停下时写 <out>/need-summaries.json（无损），控制台只留批次索引；写 aiSummaries.json 后 finish --summaries 回填');
   console.log('  组摘要未回填：以 exit 0 + NEEDS_GROUP_SUMMARIES 返回（不导出），完整素材在 <out>/need-group-summaries.json；');
   console.log('          在该文件补 summary 后用 --group-summaries 指回它重跑。真失败（空摘要/降级话术/要素缺失/详情失败）仍 exit 1；');