weaver-work-cli 0.1.39 → 0.1.40

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

@@ -79,6 +79,11 @@ collect
 ### 取数
 
 - 默认 `category=todo`，只调用对应分类的列表接口；待办接口为 `getTodoListData`。collect 不调用总数、分组统计或详情接口。
+- **小分类 / tabid（2026-11-02）**：用户明确提到小分类词（待处理 / 待阅 / 超时 / 未读 / 被退回 / 草稿 / 抄送 / 转发 / 传阅 / 关注 / 被督办 / 被转办 / 新反馈 / 已查阅）时，`prep`/`run` 传 `--sub-category <词>` 或 `--tabid <tabid>`（等价入口，**显式 tabid 优先**）。todo 词表：全部=0、待处理=7、未读=1、新反馈=2、已查阅=3、待阅=5、超时=6、被退回=8、转发=4、传阅=11、抄送=9、关注=10、被督办=12、被转办=13、草稿=14。用户未表达小分类时**不要传**（默认 tabid=0 = 全部待办，保住「汇总下待办 = 全量」的历史语义）。小分类与时间范围（`--days`/`--from`/`--to`）可叠加：接口先按 tab 圈定、再按时间过滤。**此参数只影响汇总取数**，`workflow.search` 等链路不受影响。
+- **isremarks（2026-11-02，词表已按 wfc_operate.isremark 补齐）**：待办**参与身份**筛选，多个 code 用英文逗号拼接（如 `0,2,20`），放 `getTodoListData` 的 **`params` 层**；`prep`/`run` 传 `--isremarks`，多值取**并集**。**仅汇总链路生效**——注入点在 todoSmartConvert 的 collect 内部，`workflow.search` 的代码路径与 schema 均未改动。词表：`0`=节点操作者、`1`=节点操作者(代理)、`2`=节点协办人、`5`=超时指定干预人、`6`=超时指定干预人(代理)、`7`=异常处理指定干预人、`8`=异常处理指定干预人(代理)、`10`=意见征询接收人、`11`=意见征询接收人(代理)、`20`=传阅接收人、`21`=传阅接收人(代理)、`30`=抄送需反馈、`31`=抄送需反馈(代理)、`33`=抄送协办人、`40`=转发接收人、`41`=转发接收人(代理)、`50`=协办人、`60`=传阅接收人无需反馈、`61`=传阅接收人无需反馈(代理)、`70`=抄送无需反馈、`71`=抄送无需反馈(代理)、`80`=转发接收人无需反馈、`81`=转发接收人无需反馈(代理)。实测（近一年）：`0`→54 条（节点操作者，当前待办的绝对主体），传阅/协办/抄送类身份→0 条；**不传 = 不过滤**（tabid 圈定的全部）。典型用法：「汇总下需要我反馈的抄送」→ `--isremarks 30,31`（抄送需反馈）。
+- **标题摘要模式（2026-11-03 用户定稿）**：内部留言、公司重要通知、安全问题处理工单、产品开发计划制定及任务跟踪（e-todo）、E10项目版本发布申请流程 五类 `needSummary:false`（摘要=流程标题，**不取详情、不进模型**）；安全问题/内部留言的 `aiContext` 改为「流程标题」（分组仍按标题分桶，模型 1 轮）；e-todo 与安全工单的 `summaryRequiredFields` 已删除（标题模式下要素校验会误拦）。收益：单条摘要 282→0 条进模型、素材 194KB→~10KB、详情取数 -93%，冷缓存全量 35 分钟 → **2 轮模型往返（约 1 分钟）**。备份：`/tmp/aigroup-default-backup-20261103.json`（改前快照，含 generalRules）。
+- **通用规则区 `generalRules`（2026-11-03）**：default.json 顶层可选区块（与具体工作流无关的全局行为；schemaVersion 仍为 3，旧版本 CLI 忽略）。当前仅启用 **`priorityGroup`**——第一分组标题与入选规则（`overdue` 已超时 / `levelFallback` 紧急程度降级链；预留 `expiringToday` 未启用）。`identityFilter`（默认排除抄送类身份）已于 11-03 下午移除：汇总默认**包含**抄送数据，需要排除时由调用方显式传 `--isremarks`（非抄送 18 码白名单见 git 历史/本文件 §2 词表）。后续新的通用规则以新键扩展（预留）。
+- **空结果文案（2026-11-03 用户定稿）**：collect 取到 0 条（或排除条件滤光）时，`prep`/`run` **不进 build**（CLI 会抛 `items_empty`），直接以 `exit 0` 输出用户文案并结束——①无任何显式限制条件 ⇒ 「您当前没有待办。」；②带显式限制条件（时间范围/小分类/tabid/参与身份/排除清单/侧重点）⇒ 「您当前没有符合条件的待办，可以尝试调整限制数据的范围后重试。（当前条件：…）」并回显命中的条件。执行方原样转述即可，**不要自动放宽范围重查**。
 - 时间范围一次传入，通过 `current` 递增翻页。默认 `limit=200`，最大 `limit=500`；单页最多 100 条，最多 5 页。`pageSize` 是兼容参数，实际大小由 `limit` 推导。
 - 达到 limit、页内没有新增数据或返回空页时停止；跨页按 `requestId` 去重。超过上限会在 warnings 中说明。
 - 只使用响应中的 `displayData`，不把技术行当作回退数据。长 ID 始终按字符串处理。
@@ -105,10 +110,8 @@ collect
   - 详情缓存（条目格式 v3）：过滤后的 formData 字段 / basicInfo（已剔除标题类字段）/ 阈值指标 / `excludeTag`，
     **详情为空也写**；旧版本条目（v2 及更早，basicInfo 里还带标题）读取时视为无效，自动重拉；
     `excludeOriginFormDataFields` 变了 ⇒ `excludeTag` 对不上 ⇒ 旧条目自动失效重拉（与摘要缓存的 pk 机制同思路）；
-  - 摘要缓存：单条摘要文本。条目除 `maxChars`/`pk`（口径）外还带 **`dv`（详情素材特征值，
-    2026-11-01 根治）**：写入时对当前详情素材（basicInfo+fields 内容哈希）取特征值，
-    读取时与当前素材比对——素材升级/排除清单调整/详情缓存被清（无法核验）⇒ 旧摘要失效重写；
-    无 `dv` 的旧条目按旧规则兼容命中（7 天 TTL 内自然消化）。
+  - 摘要缓存：单条摘要文本。条目除 `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`。
   记录里带 `lastFeedBackDateTime` 就是为了这个 key：**流程有新反馈 ⇒ key 变 ⇒ 缓存自然失效**。
 - 详情取数时机：`collect` 只为「用户给了 `groupFocus` 且意图适用于本组」的组预取字段；`smartGroup` 对全部条目走一次「缓存优先」的取数（命中零请求）。因此**冷缓存下详情请求集中在 `smartGroup`，`summary` 阶段通常 0 请求**。
 - 摘要缓存**只省 AI、不省详情**：阈值指标只认流程详情数据，所以命中摘要的条目仍会查一次详情缓存；摘要为空的条目用标题兜底。
@@ -119,24 +122,24 @@ collect
 - 优先组固定为 `id=priority`、标题“建议优先处理的流程”，排在第一位。超时条目必入；没有级别 2 时才使用级别 1，级别 0 不因等级入选。
 - 优先组是**叠加视图**，不是筛选：入选条目**仍保留在各自的工作流分组里**（优先组只是置顶入口）。因此 `Σcount` 会大于 `totalCount`，**`totalCount` 一律按去重条数计（= collect 取到的全部条数），不做分组求和**。
 - 普通组保持接口返回的首次出现顺序。只有调用方明确给出排序意图时才传 `groupOrder`；`topN` 只影响中间 Markdown，不裁剪最终数组。
-- `groupingBrief` 用组内 1-based `idx` 标识条目。AI 生成 `aiGroups` 时优先用 `seq`，不要手抄长 `requestId`。
+- `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` 已废弃**：传入即报 `aiGroups 元素必须是 {groupId,title,requestIds:[...]}（seq 已废弃）`，2026-11-02 起文档统一只给 `requestIds` 写法）：
 
 ```json
 [
-  { "groupId": "workflow-id", "title": "安全通知", "seq": [1, 3] },
-  { "groupId": "workflow-id", "title": "制度通知", "seq": [2, 4] }
+  { "groupId": "workflow-id", "title": "安全通知", "requestIds": ["101", "103"] },
+  { "groupId": "workflow-id", "title": "制度通知", "requestIds": ["102", "104"] }
 ]
 ```
 
-- `requestIds` 与 `seq` 二选一，不能同时出现，也不能都为空。
+- `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`、重复分配和越界序号直接失败（**仅在本组计划会被采纳时校验**：意图适用于本类型，或本组是内部留言）。
+- 组内至少 3 条时，完全省略 `aiGroups` 走 CLI 确定性分组；显式传入后，未知 `groupId`、未知 `requestId`、重复分配直接失败（**仅在本组计划会被采纳时校验**：意图适用于本类型，或本组是内部留言）。
 - `aiGroups` 何时该给——**三种情形**（`prep` 输出会给组标 `[必须给 plan]`，照标注执行即可）：
   - ① 用户给了侧重点（`groupFocus`），且侧重点**按意图表适用于本组类型**；
   - ② 本组是**内部留言** —— 而且**≥3 条时是必须给**：没有侧重点（或侧重点不适用）就按**流程标题**分组，缺计划直接报 `ai_groups_required`；
@@ -279,6 +282,7 @@ collect
 - `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-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>` 块**（拆开就不是合法载荷）；超限时先在正文说明条数与预计体积，建议缩小范围，用户坚持再照做。
 
 
@@ -308,6 +312,8 @@ collect
 
 ⇒ 端到端提速最有效的不是优化 CLI，而是**减少往返次数**：
 
+- **第一原则（2026-11-02 用户定稿，先看这条）**：**不截断脚本输出、不探查中间产物**。`todo-summary.cjs` 打的是纯文本素材，`| head -c` 不会报错、只会让「待写摘要」悄悄缺条（实测 17.6 KB / 9 条被截成 5 条，缓存随后已写、重跑也补不回，只能整套重跑）；`<out>/` 下的 `items.json` / `state.json` / `smartgroup.json` / `*.log` 更不能为"确认一下"去翻。遵守这两条，同一次汇总可从 12 轮压到 1 轮（脚本口径 71.9s → 3.0s）；违反其中任一条，必然多 2~3 轮、约 25~60s。细则见 SKILL.md「5) 命令输出读取纪律」。
+- **素材落盘（2026-11-02 P3-B）**：`build`/`run` 停在待写摘要时，完整素材（batches 数组，含 `items[].requestId/context` 等，**无损**）写 `<out>/need-summaries.json`，控制台只留批次索引（`NEEDS_SUMMARIES`）；模型用 Read 按需读该文件写 `aiSummaries.json` 后 `finish --summaries` 回填，**不再解析控制台长日志**（冷缓存 268 条时旧输出达 850KB）。
 - 用 `run --days N --limit N --out DIR --timing-report` 一次跑完 `prep + build`（无待写摘要时连 `finish` 一起），别一步步手动跑。
 - **时间段默认（2026-11-01 用户定稿）**：用户**没有说明数据的时间段**时，**不加任何时间条件**——不传 `--days` / `--from` / `--to`，取数范围就是全部待办，默认取**前 500 条**（`--limit` 不传即为 500）；只有用户明确说了时段（"近一年""近 30 天""某区间"）才传 `--days` 或 `--from/--to`。不要替用户默认加时间范围。
 - **有侧重点（`--focus`）时的最短路径是 4 轮**，多一轮就多 5~7s：
@@ -356,7 +362,7 @@ weaver-work-cli --json workflow run workflow.todoSmartConvert --input-json '{"st
 | --- | --- |
 | `stage_invalid` / `input_unknown_key` | 按错误中的允许字段修正 |
 | `items_required` / `items_invalid` / `items_too_many` | 先执行 `collect`，再回灌原始 `items` |
-| `ai_groups_invalid` / `ai_group_*` | 检查 `groupId`、`title`、`seq`/`requestIds` 和覆盖范围 |
+| `ai_groups_invalid` / `ai_group_*` | 检查 `groupId`、`title`、`requestIds`（`seq` 已废弃，改用 `requestIds`）和覆盖范围 |
 | `final_groups_required` / `wfidgroup_invalid` | 原样回灌上一步 `wfIdGroup` |
 | `ai_summaries_required` / `ai_summary_*` | 只提交本轮有效 `requestId`，不能重复 |
 | `ai_group_summaries_required` / `ai_group_summary_*` | 使用汇总项 id，不使用父组 id |

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

@@ -746,6 +746,17 @@ function cmdPrep(args) {
   if (args['sub-category'] && args['sub-category'] !== true) {
     input.subCategory = String(args['sub-category']);
   }
+  // 2026-11-02：小分类的等价直传入口。显式 tabid 优先级高于 subCategory/tabName
+  // （CLI buildSearchQuery：先解析 subCategory/tabName，再用显式 tabid 覆盖）。
+  // 仅影响本次汇总取数范围，不触碰 workflow.search 的默认行为。
+  if (args.tabid && args.tabid !== true) {
+    input.tabid = String(args.tabid);
+  }
+  // 2026-11-02：备注筛选（getTodoListData params.isremarks），多个数字英文逗号拼接。
+  // 仅汇总链路生效（CLI collect 内部注入 params），workflow.search 不受影响。
+  if (args.isremarks && args.isremarks !== true) {
+    input.isremarks = String(args.isremarks);
+  }
   // 摘要字数口径要带进 collect：否则缓存命中按默认 50 字判定，
   // 用户要求「10 字以内」时仍会回填旧的长摘要（2026-10-22 实测踩到）。
   if (args['summary-chars'] && args['summary-chars'] !== true) {
@@ -775,6 +786,29 @@ function cmdPrep(args) {
   const kept = exclude.length ? all.filter((row) => !exclude.includes(String(row.workflowName || ''))) : all;
   const dropped = all.length - kept.length;
 
+  // 2026-11-03 用户定稿：collect 空结果按「是否带显式限制条件」给不同文案，直接结束（exit 0），
+  // 不进 build（CLI 会抛 items_empty 校验错误）。
+  //  - 无限制条件（如「汇总我的待办」）⇒ 「您当前没有待办。」
+  //  - 带限制条件（时间范围 / 小分类 / tabid / 参与身份 / 排除清单 / 侧重点）⇒
+  //    「您当前没有符合条件的待办，可以尝试调整限制数据的范围后重试。」并回显条件。
+  if (all.length === 0 || kept.length === 0) {
+    const constraints = [];
+    if (days > 0) constraints.push(`近 ${days} 天`);
+    if (args.from && args.to) constraints.push(`${args.from} 至 ${args.to}`);
+    if (input.subCategory) constraints.push(`小分类「${input.subCategory}」`);
+    if (input.tabid) constraints.push(`tabid=${input.tabid}`);
+    if (input.isremarks) constraints.push(`参与身份 ${input.isremarks}`);
+    if (exclude.length) constraints.push(`排除流程「${exclude.join('、')}」`);
+    if (input.groupFocus) constraints.push(`侧重点「${input.groupFocus}」`);
+    if (all.length === 0 && constraints.length === 0) {
+      console.log('您当前没有待办。');
+    } else {
+      console.log('您当前没有符合条件的待办，可以尝试调整限制数据的范围后重试。%s',
+        constraints.length ? `（当前条件：${constraints.join('、')}）` : '');
+    }
+    return 'EMPTY';
+  }
+
   // 组结构直接用 CLI 返回的 wfIdGroup（已做 priority 抽取，不能再自己按 workflowName 复算，
   // 否则会把被抽进「建议优先处理」的条目重复计入原流程）。
   // 注意：wfIdGroup[].requestDatas 里**没有 workflowName**，要按 requestId 从 items 回查，
@@ -959,22 +993,19 @@ function cmdBuild(args) {
     cmdFinish({ ...args, dir });
     return;
   }
-  console.log(`\n待写摘要（把结果写成 aiSummaries.json，元素 {requestId,summary}；每批的「口径」必须遵守）：`);
+  // 2026-11-02 P3-B：素材无损落盘（此前整段吐控制台，268 条时 build 输出达 850KB，
+  // 模型要多轮读长文本还易被截断）；控制台只留批次索引，模型用 Read 按需读 need-summaries.json。
+  const needFile = path.join(dir, 'need-summaries.json');
+  fs.writeFileSync(needFile, JSON.stringify(batches, null, 2));
+  console.log(`\n⚠ NEEDS_SUMMARIES：%d 条单条摘要待写（完整素材已写入 %s）：`, pending.length, needFile);
   for (const b of batches) {
     const items = b.items || [];
     if (items.length === 0) continue;
-    console.log(`## 批次 ${b.batchId}｜${b.groupTitle}${b.subGroupTitle && b.subGroupTitle !== b.groupTitle ? ` → ${b.subGroupTitle}` : ''}｜目标字数 ${b.suggestedMaxChars}`);
-    if (b.prompt) console.log(`口径：${b.prompt}`);
-    if (b.hint) console.log(`提示：${b.hint}`);
-    for (const item of items) {
-      console.log(`### ${item.requestId}`);
-      console.log(`T: ${String(item.requestNameTitle || '').slice(0, 160)}`);
-      // 素材**几乎不截断**（4000 字符保险丝）：2026-11-01 实测 240 字截断把 e-todo 模板的
-      // 「预估开发总人天/需求概述」等尾部要素裁掉，模型只能靠标题凑数（要素缺失复盘定稿）。
-      console.log(`C: ${String(item.context || '').replace(/\s+/g, ' ').slice(0, 4000)}`);
-    }
+    console.log(`  - ${b.batchId}｜${b.groupTitle}${b.subGroupTitle && b.subGroupTitle !== b.groupTitle ? ` → ${b.subGroupTitle}` : ''}｜${items.length} 条｜目标字数 ${b.suggestedMaxChars}${b.prompt ? `｜口径：${b.prompt}` : ''}`);
+    if (b.hint) console.log(`    提示：${b.hint}`);
   }
-  console.log('\n下一步：node %s finish --dir %s --summaries <aiSummaries.json>', path.basename(__filename), dir);
+  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) {
@@ -1033,7 +1064,10 @@ function cmdFinish(args) {
       : null;
     if (groupSummariesFile) {
       // 组摘要必须由模型写、且每轮重算；这里只是把「回填」并进同一次命令，省掉一次模型往返。
-      const aiGroupSummaries = readJson(groupSummariesFile);
+      // need-group-summaries.json 可直接指回：这里投影成 CLI 需要的 {groupId,summary}，
+      // 多余字段（title/items/stats 等）不外传，避免 CLI 白名单校验拒绝。
+      const aiGroupSummaries = readJson(groupSummariesFile)
+        .map((x) => ({ groupId: x.groupId || x.id, summary: x.summary }));
       const t2 = Date.now();
       const gs = runStage({
         smartSummaryTitle: result.data.smartSummaryTitle,
@@ -1053,12 +1087,21 @@ function cmdFinish(args) {
       for (const text of gsWarnings) console.log('  ⚠ %s', text);
       finalResult = gs;
     } else {
-      console.log('\n⚠ 还有 %d 个组摘要素材待模型生成（groupSummary 阶段）：', groupBatches.length);
-      for (const batch of groupBatches) console.log(JSON.stringify(batch).slice(0, 400));
-      console.log('  → 写成 [{groupId,summary}] 后加 `--group-summaries <file>` 重跑本命令，可在同一次调用里回填');
-      if (args['allow-empty-summary'] !== true) {
-        console.error('✖ 交付拦截：%d 个组摘要未回填，导出会是空组摘要。补齐 --group-summaries 后重跑，或加 --allow-empty-summary 显式豁免。', groupBatches.length);
-        process.exit(1);
+      // 2026-11-02 P2 定稿：组摘要未回填 ≠ 校验失败。完整素材落盘（此前控制台每批只打
+      // JSON.stringify(batch).slice(0, 400) 的预览，等于没有素材），以 exit 0 + NEEDS_GROUP_SUMMARIES
+      // 返回、不导出；真失败（空单条摘要/降级话术/要素缺失/详情失败）仍由 exportFinal 以 exit 1 拦截。
+      const needFile = path.join(dir, 'need-group-summaries.json');
+      fs.writeFileSync(needFile, JSON.stringify(groupBatches, null, 2));
+      console.log('\n⚠ NEEDS_GROUP_SUMMARIES：%d 个组摘要待回填（完整素材已写入 %s）：', groupBatches.length, needFile);
+      for (const batch of groupBatches) {
+        console.log('  - %s｜%s → %s｜%d 条', batch.groupId, batch.parentTitle, batch.title, batch.count);
+      }
+      if (args['allow-empty-summary'] === true) {
+        console.log('  --allow-empty-summary 已指定：跳过回填、按空组摘要继续导出。');
+      } else {
+        console.log('  → 在该文件的每个元素里补 "summary" 字段（脚本会自动只取 groupId/summary），重跑：');
+        console.log('    node %s finish --dir %s --group-summaries %s --timing-report', path.basename(__filename), dir, needFile);
+        return; // 不导出、退出码 0：素材已备齐、等回填，不是失败
       }
     }
   }
@@ -1093,14 +1136,18 @@ function cmdRun(args) {
   const dir = args.out && args.out !== true
     ? String(args.out)
     : `/tmp/todo-summary-${new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14)}`;
-  cmdPrep({ ...args, out: dir });
+  // collect 空结果已在 prep 里给出用户文案并结束（EMPTY），不再进 build/finish
+  if (cmdPrep({ ...args, out: dir }) === 'EMPTY') return;
   cmdBuild({ ...args, dir });
   // 无待写摘要时 cmdBuild 已经内部走完 cmdFinish（含满意度标题填充与交付闸门），这里直接收工
   if (fs.existsSync(path.join(dir, 'final.data.json'))) return;
+  // build→finish 已把组摘要素材落盘并停下（NEEDS_GROUP_SUMMARIES，exit 0）⇒ 不再重复跑 finish，
+  // 也不再重复打印（cmdFinish 刚打过完整指引），静默收工（2026-11-02 P2）。
+  if (fs.existsSync(path.join(dir, 'need-group-summaries.json'))) return;
   const sg = readJson(path.join(dir, 'smartgroup.json'));
   const pending = ((sg.data.summaryBatches || []).flatMap((batch) => batch.items || []));
   if (pending.length > 0) {
-    console.log('\n⚠ 有 %d 条待写摘要：写成 aiSummaries.json 后跑 finish（**不用重跑** collect/smartGroup）', pending.length);
+    console.log('\n⚠ 有 %d 条待写摘要：素材见 %s；写成 aiSummaries.json 后跑 finish（**不用重跑** collect/smartGroup）', pending.length, path.join(dir, 'need-summaries.json'));
     console.log('  node %s finish --dir %s --summaries <aiSummaries.json> --timing-report', path.basename(__filename), dir);
     return;
   }
@@ -1125,10 +1172,13 @@ else if (cmd === 'run') cmdRun(args);
 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 待处理] [--out DIR]');
+  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('  finish --dir DIR [--summaries aiSummaries.json] [--group-summaries aiGroupSummaries.json] [--timing-report]');
-  console.log('  交付闸门：空摘要 / 组摘要缺失 / 详情取数失败都会 exit 1 拒绝导出；显式豁免：--allow-empty-summary / --allow-detail-fail');
+  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；');
+  console.log('          豁免：--allow-empty-summary / --allow-detail-fail');
   console.log('  默认：载荷只带 params.dataSource（现起本地服务，空闲 30 分钟自动退出）；--no-serve 退回内联 data');
   console.log('  提示：`--timing-report` 会在控制台打一段耗时摘要（阶段墙钟 / CLI 内部），**不产出 md**');
   process.exit(2);

package/dist/chunks/{chunk-2LV74IWP.js → chunk-E7OK5WD5.js}

@@ -1,10 +1,5 @@
 import { createRequire as __esbuildCreateRequire } from 'node:module';
 const require = __esbuildCreateRequire(import.meta.url);
-import {
-  imBusinessError,
-  imConfirmationError,
-  imValidationError
-} from "./chunk-ZEDWSH32.js";
 import {
   collapseNewlines,
   collectI18nIds,
@@ -17,6 +12,11 @@ import {
   parseMsg,
   senderName
 } from "./chunk-YLCYX7LE.js";
+import {
+  imBusinessError,
+  imConfirmationError,
+  imValidationError
+} from "./chunk-ZEDWSH32.js";
 
 // src/shortcuts/im/operations/types.ts
 var READ = "read";