weaver-work-cli 0.1.39 → 0.1.42

package/skills/weaver-e10-recruit-stage/references/recruit-search-candidate.md

@@ -0,0 +1,146 @@
+---
+name: recruit-search-candidate
+description: 按手机号/姓名/邮箱/创建人/创建时间等条件搜索人才库，返回带 talentId 的候选人列表
+---
+
+# 搜索人才（人才库列表）
+> 本文档中的 `${...}` 形参（表单 objId / 列表 listId / EB 页面 viewId·pageId / 应用 appId / 动作流 id / 菜单 id cusMenuId）为**租户相关值**：表单 objId 经 `recruit-resolve-metadata.md` 的 tag 链运行时解析；列表/页面/菜单 id 由部署参数提供（**可经 `allMenus` 菜单树自动发现**，见 `recruit-resolve-metadata.md` §3.1）；**字段 id（`field_<id>`）经 `ds/fields` 运行时解析，不写死**（见 `recruit-resolve-metadata.md` §5）。
+
+## 1. 基础信息
+- 接口名称：搜索人才（列表查询）
+- 请求方式：`POST`
+- 去域名路径：`/api/ebuilder/form/list/getListDatas`
+- 所属模块：招聘管理（recruit）
+- 所属分组：人才库 / 查询
+
+> 计数接口 `POST /api/ebuilder/form/list/getListDataCount` 复用相同请求体（去掉 `pageSize`），返回 `data.total`，用于"先查数量"。
+
+## 2. 业务用途
+用户说"找手机号 138xxxx 的应聘者""搜 7 月创建的简历""查招聘专员创建的候选人"时调用。返回精简列表，每条带定位 id（`form_data_id` == `talentId`），供后续查看详情使用。手机号是系统唯一区分应聘者的主键。
+
+## 3. 前置条件
+- 需要 EB 列表的 `listId`（视图 id），部署参数（可经 `allMenus` 自动发现，见 resolve-metadata §3.1）；无 tag 反查接口，按租户写死（已知缺口）。
+- 创建人条件需先经"创建人名称→ID"解析为用户 ID（见 recruit-resolve-creator.md）。
+- 渠道值返回裸 ID，经静态字典映射为中文（见 data-dictionary.md）。
+
+## 4. 请求参数
+
+### 4.1 Query 参数
+| 字段 | 位置 | 类型 | 必填 | 约束 | 业务说明 |
+|---|---|---|---|---|---|
+| `passid` | query | string | 是 | EB pass id | 部署参数（可经 `allMenus` 自动发现，见 resolve-metadata §3.1） |
+| `cid` | query | string | 是 | EB app id | 部署参数（可经 `allMenus` 自动发现，见 resolve-metadata §3.1） |
+
+### 4.2 Header 参数
+| 字段 | 位置 | 类型 | 必填 | 约束 | 业务说明 |
+|---|---|---|---|---|---|
+| `ebBusinessId` | header | string | 是 | EB 业务 id | 列表接口必需，部署参数（可经 `allMenus` 自动发现，见 resolve-metadata §3.1） |
+
+### 4.3 Body 参数（key fields）
+| 字段 | 位置 | 类型 | 必填 | 约束 | 业务说明 |
+|---|---|---|---|---|---|
+| `current` | body | int | 是 | 页码，1 基 | 当前页 |
+| `pageSize` | body | int | 是 | 默认 10 | 每页条数 |
+| `tableuid` | body | string | 是 | **每请求随机生成 32 位 hex** | EB 列表缓存键；写死会导致过滤失效 |
+| `listId` | body | string | 是 | 视图 id | 部署参数（可经 `allMenus` 自动发现，见 resolve-metadata §3.1） |
+| `searchParamData` | body | object | 是 | 见 4.4（须含 `searchType:"3"`） | 搜索条件 |
+| `searchType` | body | string | 是 | 固定 `"3"` | 列表查询类型，缺失/错值返回 total=0 假空 |
+| `terminal` | body | string | 是 | `PC` | 终端 |
+| `browser` | body | string | 是 | `Chrome` | 浏览器 |
+| `requiredMatch` | body | int | 是 | `1` | 固定，缺失返回假空 |
+| `mapResult` | body | int | 是 | `1` | 固定，缺失返回假空 |
+| `recheckQuery` | body | int | 是 | `1` | 固定，缺失返回假空 |
+| `isFollow` | body | int | 是 | `0` | 固定 |
+| `isShareToMe` | body | int | 是 | `0` | 固定 |
+| `filterCondition` | body | object | 是 | `{}` | 固定 |
+| `selectedId` | body | string | 否 | 部署参数（可经 `allMenus` 自动发现，见 resolve-metadata §3.1） `${TALENT_SELECTED_ID}` | 选中上下文 id；**可省略（新环境实测不带也返回数据）** |
+| `cusMenuId` | body | string | 是 | 部署参数（可经 `allMenus` 自动发现，见 resolve-metadata §3.1） `${TALENT_MENU_ID}` | 菜单上下文 |
+| `urlPageTitle` / `menuName` | body | string | 是 | EB 页面标题（如 `人才库`） | 菜单上下文 |
+
+### 4.4 searchParamData 条件（commonSearchFields）
+每个条件形态：`{ "field_<fieldId>": [ { "field_<fieldId>": <value>, "field_<fieldId>_condition_type": <cond> } ] }`
+
+| 业务字段 | EB fieldId（运行时解析） | 默认 cond | 说明 |
+|---|---|---|---|
+| 姓名 `name` | `field_{<按 dataKey=name 解析的字段id>}` | `like` | 模糊；精确用 `eq` |
+| 手机号 `telephone` | `field_{<按 dataKey=telephone 解析的字段id>}` | `like` | 系统唯一主键 |
+| 邮箱 `email` | `field_{<按 dataKey=email 解析的字段id>}` | `like` | |
+| 招聘状态 `recruit_status` | `field_{<按 dataKey=recruit_status 解析的字段id>}` | `like` | 传状态值/id |
+| 简历来源 `channel` | `field_{<按 dataKey=channel 解析的字段id>}` | `like` | |
+| 部门 `department` | `field_{<按 dataKey=department 解析的字段id>}` | `like`/`eq` | 若人才表单含部门字段，可据此按部门筛选；字段 id 经 `ds/fields` 解析，不写死 |
+| 创建人 `creator` | `field_{<按 dataKey=creator 解析的字段id>}`（member 字段，值 `[{id,name,...}]`） | — | 先解析为 ID |
+| 创建时间 `create_time` | `field_{<按 dataKey=create_time 解析的字段id>}` | `between` | 值 `[from, to]`，`YYYY-MM-DD[ HH:mm:ss]` |
+
+> 字段 id 不写死：调用前经 `recruit-resolve-metadata.md` §5 的 `ds/fields` 按 `dataKey` 解析出 `fieldId`，再拼 `field_{fieldId}` 作为过滤键。
+
+- 多条件组合：`searchParamData.type` = `and` | `or`。
+- 分页：`current` / `pageSize`。
+
+### 4.5 字段级过滤（groupFields，实测，任意表单字段均可过滤）
+除 `commonSearchFields` 外，EB 列表还接受 `searchParamData.groupFields` 做字段级过滤，形态更简单，实测（需求/职位列表的筛选项即用此机制）：
+`"groupFields": { "field_<fieldId>": [<value>] }`
+- `<value>` 形态：下拉/选项类字段传**选项 ID**（如 `840774534427852804`，从 `data-dictionary.md` 或 `ds/fields` 的选项反查）；文本类传文本值；日期类传 `[from, to]`。
+- 可过滤字段不限于上面 7 个：人才表单任何字段（含 招聘状态 `recruit_status`、简历来源 `channel`、姓名 `name`、手机号 `telephone`、邮箱 `email`、创建人 `creator`、创建时间 `create_time`）都能作为 `groupFields` 键；字段 id 同样经 `ds/fields` 解析，不写死。
+- 组合：`commonSearchFields` 与 `groupFields` 可并存，最终按 `searchParamData.type`（and/or）合并。
+- 用法示例："渠道=内推的候选人" → `groupFields: { "field_<简历来源字段id>": ["<内推选项id>"] }`；"招聘状态=候选中的" → `groupFields: { "field_<招聘状态字段id>": ["<候选中选项id>"] }`。选项 ID 不确定时先查 `data-dictionary.md` 或向用户澄清选项。
+
+## 5. 响应数据结构
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `data.data` | array | 记录数组；每条含 `form_data_id`（== `id` == `rowKey` == `ebrecord_rowkey`）= 该人才的 `talentId` |
+| `data.total` | int | 总数（部分部署返回 0 时，以 `len(data.data)` 兜底） |
+| `data.columns` | array | 列定义 |
+
+## 6. 请求示例
+```json
+{
+  "current": 1,
+  "pageSize": 10,
+  "tableuid": "<每请求随机生成 32 位 hex>",
+  "listId": "${TALENT_LIST_ID}",
+  "searchParamData": {
+    "searchType": "3",
+    "commonSearchFields": {
+      "field_<手机号字段id>": [
+        { "field_<手机号字段id>": "13800000000", "field_<手机号字段id>_condition_type": "like" }
+      ]
+    },
+    "type": "and"
+  },
+  "terminal": "PC", "browser": "Chrome",
+  "requiredMatch": 1, "mapResult": 1, "recheckQuery": 1,
+  "isFollow": 0, "isShareToMe": 0, "filterCondition": {},
+  "selectedId": "${TALENT_SELECTED_ID}", "cusMenuId": "${TALENT_MENU_ID}",
+  "urlPageTitle": "人才库", "menuName": "人才库"
+}
+```
+
+## 7. 响应示例
+```json
+{
+  "code": 200, "status": true,
+  "data": {
+    "total": 1,
+    "data": [ { "form_data_id": "1276382457065553922", "talent": "张三", "telephone": "13800000000" } ],
+    "columns": [ { "field": "talent", "title": "姓名" } ]
+  }
+}
+```
+
+## 8. 错误码
+| 错误码 | 含义 | AI 处理建议 |
+|---|---|---|
+| 来源文档未提供接口特有错误码 | — | 非 200 / `code!=200` / 重定向 → 提示 认证可能过期（`weaver-work-cli auth status`），引导走 `weaver-work-cli auth login` |
+
+## 9. 调用参考
+- 用户场景：直接表达"搜/找/查 某条件候选人"。
+- 创建人名称需先经 recruit-resolve-creator.md 解析为 ID，再作为 `field_{<创建人字段id>}` 条件（创建人字段 id 经 `ds/fields` 解析，见 `recruit-resolve-metadata.md` §5）。
+- 命中多条时展示列表，每条附 EB 详情链接（拼装规则见 SKILL.md 链接拼装，依赖登录态）。
+
+## 10. 注意事项
+- `tableuid` **必须每请求随机生成**（32 位 hex），不可写死，否则后端返回旧缓存/忽略条件。
+- `total` 可能为 0 但 `data.data` 非空，以记录数兜底。
+- **分页与总量展示**：搜索 pageSize 默认 10。返回行数 <10 → 全部展示；返回行数 =10（可能还有更多）→ 调计数接口 `getListDataCount`（复用相同请求体、去掉 `current`/`pageSize`，返回 `data.total`）取真实总量；`total >10` 时展示前 10 条并在底部提示「共 N 条，已展示前 10 条，还有 N-10 条未展示，可补充手机号/邮箱等条件精确匹配或说"下一页/看更多"继续」。**列表响应的 `data.total` 恒为 0 时不可作为总量依据**（实测），一律以计数接口为准。
+- 列表 `listId`（视图 id）无 tag 反查接口，按租户写死于配置（已知缺口）。
+- 列表查询必带上下文参数（`searchType`/`requiredMatch`/`mapResult`/`recheckQuery`/`isFollow`/`isShareToMe`/`filterCondition`/`selectedId`/`cusMenuId`/`urlPageTitle`/`menuName`）见 `recruit-resolve-metadata.md` §7；缺任一项会返回 `total=0` 假空，**勿据此判「人才库为空」**。
+- 渠道/创建人返回裸 ID，需映射/反查后才可读（见 SKILL.md）。

package/skills/weaver-e10-recruit-stage/references/recruit-urge-feedback.md

@@ -0,0 +1,69 @@
+---
+name: recruit-urge-feedback
+description: 发送消息通知催促面试官填写面试评价（runEsb 动作流）
+---
+
+# 催促面试评价
+> 本文档中的 `${...}` 形参（表单 objId / 列表 listId / EB 页面 viewId·pageId / 应用 appId / 动作流 id）为**租户相关值**：表单 objId 经 `recruit-resolve-metadata.md` 的 tag 链运行时解析；其余由部署参数提供（**可经 `allMenus` 菜单树自动发现**，见 `recruit-resolve-metadata.md` §3.1）；字段 ID（field_937…）依当前租户表单而定，详见 `data-dictionary.md`。
+
+## 1. 基础信息
+- 接口名称：催促面试评价（触发动作流 runEsb）
+- 请求方式：`POST`
+- 去域名路径：`/api/ebuilder/form/esb/runEsb`
+- 所属模块：招聘管理（recruit）
+- 所属分组：面试 / 写操作（外部通知）
+
+## 2. 业务用途
+用户说"催一下面试官填评价""提醒面试官给反馈""催促面试评价"时调用。通过动作流（`runEsb`）向面试官发送系统通知，催促其填写面试反馈。属 **L3 外部通知**，**默认不触发**，需用户明确确认且显式开启（如 `--notify`）后才发送，避免打扰真人。
+
+## 3. 前置条件
+- 已安装招聘服务（第 0 步闸门通过）。
+- **定位前置（必做）**：催评前必须先按手机号（叠加姓名）搜索定位候选人（`recruit-search-candidate`）拿到 `talentId`，再从其人才详情的面试卡片取目标面试记录：命中 0 条→提示未找到、不臆测；命中多条→列出候选清单（姓名/手机/渠道/状态/创建时间/`talentId`）请用户确认，**绝不自动取第一条**（催错人打扰面试官）。消歧规则见 SKILL.md「自然语言 → 参数映射」。
+- 目标面试记录（来自人才详情的面试卡片，取 `interviewFeedBack` 关联的反馈记录 id，作为 `runEsb.dataIds`；动作流 id 见下方 §4 运行时解析，不从卡片取）。
+
+## 4. 请求参数
+| 字段 | 位置 | 类型 | 必填 | 业务说明 |
+|---|---|---|---|---|
+| `objId` | body | string | 是 | 面试反馈列表的 `passid`（=objId，来自 面试列表 allMenus 或列表查询响应）；与下方 `getListButtons` 的 `passid` 同值 |
+| `esbActionIds` | body | string | 是 | 催评动作流 id（见 recruit-resolve-metadata.md §4，运行时按钮配置解析，不写死） |
+| `dataIds` | body | string | 是 | 目标面试反馈记录 id（来自人才详情面试卡片 `interviewFeedBack` 关联记录）；动作流要通知的具体数据，缺失会 405 / 不触发 |
+
+> 注：正式版**不写死** `esbActionIds`；运行时对**面试反馈列表**调 `GET /api/ebuilder/form/list/getListButtons/{listId}?passid={列表passid}`，取 `buttons[].actions[]` 中 `actionType=esb` 且名称含「面试安排催评」（排除「批量催评」）的按钮 `id` 作为 `esbActionIds`（详见 `recruit-resolve-metadata.md` §4），天然跨环境，不依赖部署参数。
+
+## 5. 响应数据结构
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `code` | int | 200 成功 |
+| `status` | boolean | `true` 正常 |
+| `data` | object | 动作流执行结果 |
+
+## 6. 请求示例
+```json
+POST /api/ebuilder/form/esb/runEsb
+{ "objId": "<面试反馈列表 passid（=objId）>", "dataIds": "<面试反馈记录 id，来自人才详情面试卡片>", "esbActionIds": "<解析：面试反馈列表 getListButtons → 名称含「面试安排催评」的 esb 按钮 id>" }
+```
+
+## 7. 响应示例
+```json
+{ "code": 200, "status": true, "data": { "success": true } }
+```
+
+## 8. 错误码
+| 错误码 | 含义 | AI 处理建议 |
+|---|---|---|
+| 非 200 | 认证/动作流错误 | 提示检查认证（`weaver-work-cli auth status`） / `esbActionIds` |
+
+## 9. 调用参考
+- 用户场景："催一下面试官填评价"。
+- **交互语义（关键）**：用户只说「催评 / 提醒面试官填评价」= 定位候选人 + 展示下方确认摘要并说明「将发送系统通知」，**不实际调用**。必须用户明确说「确认催 / 现在发 / 开启通知」才调用 `runEsb`；用户未明确确认前，回复保持在本摘要，不静默触发，也不提示「已发送」。
+- **确认摘要模板（触发前必展示，必须带出定位键）**：
+  > 即将向 **姓名（手机：XXX ｜ `talentId=XXX`）** 的面试官发送「请填写面试评价」系统通知：
+  > - 面试主题：XXX ｜ 面试官：XXX
+  > 这是外部通知，请确认对象无误——回复「确认催」后我才实际发送。
+- **姓名来源（script 实测防坑）**：确认摘要中「姓名」取人才详情 BaseInfo `talent.hrm.name`（最准），不取面试主题 `subject` 前缀——新建未挂职位的候选人 subject 可能为 `undefined-…`/`null-…`，取前缀会得「undefined」。若 BaseInfo 取不到再回退 subject 前缀并清洗 `^(undefined|null)\s*-`。
+
+## 10. 注意事项
+- **外部通知，默认不触发，且交互上明示**：用户一句话「催评」只到定位+确认摘要；除非用户明确说「确认催/现在发」，否则只说明「可催评」，不实际调用，也不谎报已发。
+- **定位前置**：催评前必须先定位到唯一候选人（见 §3），命中多条先消歧，绝不自动取第一条。
+- 动作流 `esbActionIds` 跨环境会变（迁入/升级后失效），正式版走 §4 按钮配置解析（getListButtons 取 esb 按钮 id），不写死、不依赖部署参数。
+- **L3 不得因超时盲目重试**：若首次 `runEsb` 疑似超时，须先查询该面试评价的反馈状态确认未发送，再决定是否补发；严禁直接重试导致对面试官重复发送通知。

package/skills/weaver-e10-shared/SKILL.md

@@ -67,7 +67,7 @@ Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读
 
 下述 `auth xiaoe` 流程仅适用于上述已确认的 XiaoE 智能体环境；其他智能体不执行宿主脚本检测，直接进入浏览器 OAuth 流程。`auth xiaoe` 命令本身就是认证方式的显式选择；`hasXiaoEEnv` 使用桌面的 `--runtime-agent xiaoe` 或任意 `XIAOE_*` 环境变量识别运行环境。
 
-首次缺少本地会话时，已识别为 XiaoE 的业务命令会在 CLI 公共会话加载层自动获取登录信息；如需提前登录，只运行 `weaver-work-cli auth xiaoe`。CLI 内部按「平台凭证 Node 换票 → CLI 自带 `xiaoe_env.py` 兼容换票 → 宿主 `tokens.py` → 桌面 XiaoE 客户端会话 → `WEAVER_XIAOE_*` 环境映射」顺序取凭据；其中 `XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 地址。`xiaoe_env.py` 属于 CLI npm 包，不放入 shared Skill，且只能由 CLI 内部执行和解析。已有 XiaoE 会话被接口明确拒绝为失效时，CLI 根据会话元数据在公共请求层静默恢复并重放一次；这个流程绕开 shared Skill，Agent 不参与，也不得再补跑登录或原业务命令。失败时 CLI 返回最终结构化错误。
+首次缺少本地会话时，已识别为 XiaoE 的业务命令会在 CLI 公共会话加载层自动获取登录信息；如需提前登录，只运行 `weaver-work-cli auth xiaoe`。CLI 内部按「平台凭证 Node 换票 → CLI 自带 `xiaoe_env.py` 兼容换票 → 宿主 `tokens.py` → 桌面 XiaoE 客户端会话 → `WEAVER_XIAOE_*` 环境映射」顺序取凭据；其中 `XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 地址。`xiaoe_env.py` 属于 CLI npm 包，不放入 shared Skill，且只能由 CLI 内部执行和解析。已有 XiaoE 会话达到换票结果的 `expiryTimes` 时，CLI 会在业务请求发出前静默换票；已有 XiaoE 会话被接口明确拒绝为失效时，CLI 根据会话元数据在公共请求层静默恢复并重放一次。这个流程绕开 shared Skill，Agent 不参与，也不得再补跑登录或原业务命令。失败时 CLI 返回最终结构化错误。
 
 1. 首次无本地登录态、需要在业务命令之前显式建立 E10 会话时，可运行：
    ```text
@@ -76,7 +76,7 @@ Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读
 2. 不得因为本地存在旧 profile、`auth profile current` 指向旧环境，或 `auth profile list` 里只有旧环境，就跳过 XiaoE 统一登录；也不得先要求用户选择旧 profile 或输入域名。
 3. XiaoE 统一登录由 CLI 按序取凭证：① 平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`，先走 Node 换票，再由 CLI npm 包自带的标准库 `xiaoe_env.py` 作兼容回退；② 宿主 `xiaoeUserData/tokens.py`（仅桌面宿主，CLI 在 macOS/Windows 都会先自动发现 XiaoE 客户端内置 Python，再回退到系统 Python）；③ 内置原生实现读取桌面 XiaoE 客户端会话换取 `eteamId`，依次查找 `XIAOE_USER_SETTINGS_PATH`、`XIAOE_ROBOT_DATA_ROOT` / `XIAOE_ROBOT_ROOT` 和默认 `XiaoE/Robots/<id>/user_settings.json`，因此会话有效时不要求存在 `tokens.py`；④ `WEAVER_XIAOE_*` 环境映射。宿主只注入 `XIAOE_DOMAIN`、`XIAOE_USER_TOKEN` 等平台变量，不会注入 ETEAMSID 环境变量，CLI 也不读取 `XIAOE_ETEAMSID`。Agent 不要打印、转述、索取或要求用户手动设置这些凭证，也不要直接执行任一脚本或因为脚本报缺依赖就让用户安装 Python 包——凭据链内部的兼容回退由 CLI 完成。
 4. `auth xiaoe` 是 XiaoE 认证方式的显式入口：CLI 不再判断当前宿主，只检查并消费可用凭据源。E10 目标地址按「显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → CLI 内置默认值」解析，绝不能把 `XIAOE_DOMAIN` 当作 E10 地址。Token、Cookie、ETEAMSID 仍属于凭证，禁止在回复中展示。
-5. XiaoE 统一登录走不通时，无论 macOS、Windows、Linux 或 Web，CLI 都返回 `authentication/xiaoe_credential_unavailable`，绝不自动打开浏览器或降级到 `auth login`；本任务必须停止，不得另行调用其他登录 Skill 或登录命令。
+5. XiaoE 统一登录走不通时，无论 macOS、Windows、Linux 或 Web，CLI 都返回 `authentication/xiaoe_credential_unavailable`，绝不自动打开浏览器或降级到 `auth login`；本任务必须停止，不得另行调用其他登录 Skill 或登录命令。网页端若带 `details.reason=host_credential_not_injected`，只反馈「网页技能沙箱未获得宿主登录凭据」，该问题由宿主/沙箱启动层修复，不要让用户重新登录或手动提供凭据。若失败全程都是网络错误（连不上 E10，登录态根本没被验证过），子类型是 `authentication/xiaoe_network_unavailable`、`retryable: true`，文案为「暂时无法连接 E10，请稍后重试」——此时只反馈并建议稍后重试，不要引导用户重新登录。
 6. `auth status --no-check` 不会触发 XiaoE 统一登录；业务命令加载到 `agentType=XiaoE` 或 `loginSource=xiaoe-unified` 的会话并被 E10 明确拒绝为失效时，即使没有 `XIAOE_*` 或 `--runtime-agent xiaoe`，也会静默触发一次统一登录并重放该请求一次。无可读取的本地会话时，则需要当前 `XIAOE_*` 或 `--runtime-agent xiaoe` 等宿主标记才能自动获取；显式 `--auth` 不触发自动替换。具体读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
 
 ### 认证错误只报告状态，不指定登录命令

package/skills/weaver-e10-shared/references/e10-auth-and-session.md

@@ -29,7 +29,7 @@ weaver-work-cli auth whoami
 - 业务命令失败，stderr JSON 中 `error.type === "authentication"`（如 `E10 auth not found`）
 - 业务命令返回 `error.subtype === "session_expired"`（E10 登录态 401/302 失效）
 
-CLI 的认证错误只是状态信号，不是登录命令。已有 XiaoE 会话过期时，公共请求层会根据持久化会话的 `agentType` / `loginSource` 自动恢复，不依赖 `XIAOE_*`、`--runtime-agent xiaoe`、shared Skill 或 Agent。业务命令无可读取的本地会话时，若当前 `XIAOE_*`、`--runtime-agent xiaoe` 等标记已识别为 XiaoE，公共会话加载层也会先静默获取登录信息。失败时返回 `xiaoe_credential_unavailable`，提示已尝试自动获取，Agent 只反馈并停止；不要再次登录或重跑。需要在业务命令之前主动建立会话时，可按下述流程显式登录。
+CLI 的认证错误只是状态信号，不是登录命令。已有 XiaoE 会话达到换票结果的 `expiryTimes` 时，CLI 会在业务请求发出前静默换票；被接口判定过期时，公共请求层会根据持久化会话的 `agentType` / `loginSource` 自动恢复，不依赖 `XIAOE_*`、`--runtime-agent xiaoe`、shared Skill 或 Agent。业务命令无可读取的本地会话时，若当前 `XIAOE_*`、`--runtime-agent xiaoe` 等标记已识别为 XiaoE，公共会话加载层也会先静默获取登录信息。失败时返回 `xiaoe_credential_unavailable`，提示已尝试自动获取，Agent 只反馈并停止；不要再次登录或重跑。该错误的 `details` 会带 `attemptedSteps`（按序评估过的凭证通道及结果，如 `platform_token:missing`、`e10_session:failed`）、`lastError`（最后一条真实原因）与 `baseUrl`，另有 `failures` 记录每一次失败的阶段（`platform_token` / `bundled_env_script` / `token_script` / `client_session` / `teams_check` / `e10_session`）、类别（`network` / `http` / `credential`）以及网络错误的 `causeCode`（如 `ECONNREFUSED`、`ETIMEDOUT`）和 HTTP 的 `httpStatus`，原样转述给用户即可说明卡在哪一步；需要过程日志时由用户在业务命令上加 `--verbose`。失败全程都是网络错误时，子类型改为 `xiaoe_network_unavailable`、`retryable: true`，文案为「暂时无法连接 E10，请稍后重试」：这不是凭据问题，只提示稍后重试，不要让用户去重新登录。需要在业务命令之前主动建立会话时，可按下述流程显式登录。
 
 此时**禁止**：
 
@@ -69,7 +69,7 @@ CLI 的认证错误只是状态信号，不是登录命令。已有 XiaoE 会话
 
 `auth login` 会在本机 `127.0.0.1:19800` 监听浏览器回调，最长等待 5 分钟。Agent 沙箱/托管环境中的外部浏览器无法回调容器内地址。`auth xiaoe` 不会进入这条浏览器流程。执行规则：
 
-1. 任意系统运行 `auth xiaoe` 时，收到 `xiaoe_credential_unavailable` 即反馈并停止；不要自动改跑 `auth login`。
+1. 任意系统运行 `auth xiaoe` 时，收到 `xiaoe_credential_unavailable` 即反馈并停止；不要自动改跑 `auth login`。收到 `xiaoe_network_unavailable` 同样是停止，但按「暂时无法连接 E10」反馈并建议稍后重试。
 2. 仅非 XiaoE 环境在用户确认真实 E10 域名且确认 CLI 与浏览器同机后执行 `auth login`；仍须限时等待，超时未完成即终止并反馈。
 3. 仅非 XiaoE 环境在用户无法完成浏览器登录、且明确要求并同意人工录入时，才可使用保底方式 `weaver-work-cli auth set --eteamsid "<ETEAMSID>" --base-url "<用户确认的登录域名>"`；它不是业务认证错误的默认恢复路径。ETEAMSID 由用户从已登录浏览器主动提供，Agent 不得索取、展示或转述该值。
 4. 严禁不加限制地前台运行 `auth xiaoe` / `auth login` 并等待 OAuth 回调。
@@ -139,6 +139,8 @@ weaver-work-cli --profile PROFILE_NAME auth status --no-check
 
 宿主不会注入 ETEAMSID 环境变量，CLI 也不读取 `XIAOE_ETEAMSID`；ETEAMSID 一律由登录链路换取。CLI 支持两类宿主格式：平台注入的 `XIAOE_DOMAIN` + `XIAOE_USER_TOKEN`，以及 `WEAVER_XIAOE_*` 域名映射。这些格式属于宿主集成细节，不作为用户操作步骤；Agent 不要打印、转述、要求用户手动填写或将其导出到当前 shell。
 
+小 e 网页端若返回 `details.reason=host_credential_not_injected`，表示当前沙箱仅保留了网页端运行时标记，宿主平台凭据未透传给 CLI。Agent 只反馈“网页技能沙箱未获得宿主登录凭据”并停止；不要要求用户手动提供环境变量、Token 或 ETEAMSID，也不要改走浏览器 OAuth。该问题必须由宿主/沙箱启动层保留原有凭据注入来修复；隔离认证目录时只覆盖 `WEAVER_WORK_CLI_AUTH_ROOT`，不得清空整个进程环境。
+
 ## XiaoE 凭据由 CLI 独占处理
 
 运行 `auth xiaoe`，或已登录的 XiaoE 业务请求被 E10 明确拒绝为会话失效时，CLI 按以下顺序自行取凭据，Agent **不参与、也不得复现**。后者全程静默、合并同一 profile 的并发恢复，并最多重放原请求 1 次；流式请求、网络错误、`partial` / `write_uncertain` 均不触发重放：

package/skills/weaver-e10-shijingran/SKILL.md

@@ -5,7 +5,7 @@ display_name: 泛微E10事井然项目管理
 display_name_en: Weaver E10 Shijingran Project Management
 description_zh: 泛微E10事井然项目管理助手，封装项目和任务的创建、查询、修改、删除操作，并提供项目/任务类型、紧急程度、状态等字典查询能力。适用于在对话中通过 Agent 创建、查询、修改、删除项目或任务等场景。
 description_en: Weaver E10 Shijingran project management assistant. Covers CRUD operations for projects and tasks, and provides dictionary queries for project/task types, priorities, and statuses. Used when an Agent needs to create, query, modify, or delete projects or tasks in conversation.
-version: 1.0.8
+version: 1.0.9
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -79,7 +79,7 @@ Agent 不得自行拼接、改写或向用户索取上述凭证（禁止要求
 1. 判断用户目标对象和最小必要条件，按路由读取最小必要 reference；已知出厂字段直接使用 `operations.md` 的字段 quick reference。
 2. 名称条件先解析为 ID；0 个匹配要告知，多个匹配必须让用户选择，不得猜。
 3. 查询默认第 1 页 10 条；返回条数等于 pageSize 时提示可能还有更多，等待用户要求再翻页。
-4. 列表和详情中不要单独输出 `detail_url` 列；将 `task_name` / `proj_name` 渲染为 Markdown 链接（方括号内为记录名称，紧跟的圆括号内为 `detail_url` 的取值）。链接不可用时名称保持纯文本并如实说明，不得编造 URL。
+4. 列表、详情和新建结果的记录名称都不要单独输出 `detail_url` / `detail_urls` 列；将 `task_name` / `proj_name` 渲染为 Markdown 链接（方括号内为记录名称，圆括号内为链接取值：列表/详情取 `detail_url`，新建取 `detail_urls[i]`）。链接不可用时名称保持纯文本并如实说明，不得编造 URL。
 5. 写操作先 `prepare`，向用户摘要目标、差异、风险、默认值和不可逆性；用户明确确认后才 `apply`。
 6. `partial/write_uncertain`、登录失效、回查失败或网络中断时停止写流程，不自动重试。
 
@@ -88,6 +88,7 @@ Agent 不得自行拼接、改写或向用户索取上述凭证（禁止要求
 - 列表和详情默认只给摘要：记录数 + 下方固定展示列，不粘贴完整 JSON，不罗列全部原始字段；完整响应过长时先落本地 UTF-8 文件再给摘要与路径。
 - 默认展示列以 [`operations.md`](references/operations.md) 的「输出处理」为准：任务列表 `task_name / task_type / plan_start_time / plan_finish_time / manager / task_status / progress / create_time`；项目列表把 `task_*` 换成 `proj_*`；详情在此基础上补 `project`/`priority` 与描述、创建时间。用户明确指定字段时以用户为准。
 - 记录名称列（`task_name` / `proj_name`）渲染为 Markdown 链接 `[名称](detail_url)`，**不单独输出 `detail_url` 列**；`detail_url_warning` 时名称保持纯文本并如实说明，不得编造 URL。
+- 新建成功（`project.task.create.apply` / `project.project.create.apply`）的返回默认带 `data.detail_urls`，与 `data.dataIds` 同序；用 `detail_urls[i]` 把第 i 条记录的 `task_name` / `proj_name` 渲染为 `[名称](url)`，不得只回复一串 ID 或一句"创建成功"。
 - 关联字段（`manager`、`participant(s)`、`task_type`、`proj_status` 等）只展示 `name`，不展示内部 ID；字典 ID、对象 ID、`groupId` 只用于入参。
 - 未指定状态时先说明默认口径「只查未开始 + 进行中」（默认系统状态口径见 [`operations.md`](references/operations.md)）；返回条数等于 `pageSize` 时提示可能还有下一页。
 

package/skills/weaver-e10-shijingran/references/operations.md

@@ -93,7 +93,8 @@ weaver-work-cli --json project run project.task.list --input-json '{"pageNo":1,"
 - `project.task.list`、`project.project.list`、`project.task.detail`、`project.project.detail` 默认为有记录 ID 的业务数据补充 `detail_url`；传 `fields` 且不包含 `detail_url` 时，CLI 不生成链接，也不调用对象 ID 接口。
 - 任务列表用 `data.datas[].mainTable[].detail_url` 把 `task_name` 渲染为 `[名称](detail_url)`；项目列表用同一位置渲染 `proj_name`。
 - 任务详情用 `data.datas[0].mainTable.detail_url` 把 `task_name` 渲染为 `[名称](detail_url)`；项目详情用同一位置渲染 `proj_name`。
-- 若返回 `detail_url_warning`，说明主查询已成功但链接暂不可用；如实提示，不重试主查询，不编造 URL。
+- **新建成功后的返回值同样带链接**：`project.task.create.apply` / `project.project.create.apply` 默认在 `data.detail_urls` 返回详情页地址，与 `data.dataIds` **一一对应且同序**。展示新建结果时用 `detail_urls[i]` 把第 i 条记录的 `task_name` / `proj_name` 渲染为 `[名称](url)`，只报 ID 不算完成任务。
+- 若返回 `detail_url_warning`，说明主查询或写入已成功但链接暂不可用；如实提示，不重试主操作，不编造 URL。
 - 需要最高执行效率时（只做摘要、计数、筛选或名称转 ID），传 `withDetailUrl:false`，或在 `fields` 中不包含 `detail_url`；仅当用户会点开详情或明确要链接时保留默认的详情链接。
 
 ## 字典查询
@@ -143,6 +144,7 @@ weaver-work-cli --json project run project.form.fields --input-json '{"table":"t
 - 任务详情必须且仅默认展示 `task_name`、`task_type`、`project`、`manager`、`task_status`、`progress`、`plan_start_time`、`plan_finish_time`、`task_desc`、`create_time`；`task_name` 渲染为 `[名称](detail_url)`，不单独输出 `detail_url` 列。
 - 项目列表必须且仅默认展示 `proj_name`、`proj_type`、`plan_start_time`、`plan_finish_time`、`manager`、`proj_status`、`progress`、`create_time`；`proj_name` 渲染为 `[名称](detail_url)`，不单独输出 `detail_url` 列。
 - 项目详情必须且仅默认展示 `proj_name`、`proj_type`、`priority`、`manager`、`proj_status`、`progress`、`plan_start_time`、`plan_finish_time`、`proj_desc`、`create_time`；`proj_name` 渲染为 `[名称](detail_url)`，不单独输出 `detail_url` 列。
+- 新建成功（`project.task.create.apply` / `project.project.create.apply`）必须给出记录名称并渲染为 `[名称](detail_urls[i])`：第 i 条取 `data.detail_urls[i]`，与 `data.dataIds[i]` 同序对应；不得只回复一串 ID 或一句"创建成功"。
 - 用户明确指定展示字段时，以用户指定为准，但仍不要罗列全部原始字段。
 - 关联字段返回 `[{name,id}]` 时展示 `name`，不展示内部 ID。
 - 明确说明默认状态口径；返回条数等于 `pageSize` 时提示可能有下一页。

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

@@ -1241,13 +1241,13 @@
     }
   },
   "artifactBaseline": {
-    "aggregateSha256": "eb2413bba08ce89d006615d49d08ef5967ba2220d11481e674dafd78680100c8",
+    "aggregateSha256": "9a7a1911d6baf2b992e9ec10b05547d161725f146c3c267b39e9d6bc73d998b3",
     "files": [
       {
         "path": "docs/_catalog.md",
         "role": "generated-doc",
-        "size": 5332,
-        "sha256": "a81903939aea5bf1196d1e3243709d2facf50d9bdcf74d8a6ca731061310dbbe"
+        "size": 5903,
+        "sha256": "9c1ea787068498c443d3ed758ba02180000a213f8fb2ffcc04a465ab1be93c8f"
       },
       {
         "path": "docs/project.md",
@@ -1258,14 +1258,14 @@
       {
         "path": "skill-template/business-info.json",
         "role": "generated-template",
-        "size": 8216,
-        "sha256": "370a45e86c6b7e33869c5df1bf08d9f22bd98fa8b157b49716e13bca0e7b63c3"
+        "size": 10132,
+        "sha256": "30b4b6827ad8d4a7b6cd04fc67df396597d6260a02e790b19aa0749c62357dcf"
       },
       {
         "path": "skill-template/domains/shijingran.md",
         "role": "generated-template",
-        "size": 531,
-        "sha256": "6312bffbae22b9f5b0ed8508db8ac36f1de6a8c706d88df53df18e4e4eec7c53"
+        "size": 534,
+        "sha256": "853f73687d75a82e21f9518aaac057889fa91e8d934be6a989e8cc60a8d90366"
       },
       {
         "path": "skills/weaver-e10-shijingran/references/field-resolution.md",
@@ -1276,98 +1276,98 @@
       {
         "path": "skills/weaver-e10-shijingran/references/operations.md",
         "role": "generated-reference",
-        "size": 11290,
-        "sha256": "72d106a12c7ed8c1f418112bc032eb2acd72224771101e6877603d4b2b81fc3c"
+        "size": 11933,
+        "sha256": "05cc6fb5059261757d65c47d043f4aee16a4b28e5676f1c13f9e36da4743ed78"
       },
       {
         "path": "skills/weaver-e10-shijingran/references/write-operations.md",
         "role": "generated-reference",
-        "size": 3859,
-        "sha256": "3d4a6625eea85716b9718cf64df18728aef9463ab0b88f2e57d2b7a897adde5c"
+        "size": 4216,
+        "sha256": "6d9c6dece8de31dcea481bff38b41ddf3bc2b9f80f3511c4db4a6e68917ae066"
       },
       {
         "path": "skills/weaver-e10-shijingran/SKILL.md",
         "role": "generated-skill-entry",
-        "size": 14475,
-        "sha256": "4d92d0dda6c2f30b7501dcbc2e5d1b9e42b69a22d73b2df8d0c6a61326821154"
+        "size": 14859,
+        "sha256": "544ac1c52f02fae1629864bdbd9e325a71ecd778837582a5c62dcb50225814da"
       },
       {
         "path": "src/shortcuts/index.ts",
         "role": "generated-cli",
-        "size": 1420,
-        "sha256": "569bef374df2d86b511150a0c609ce1abee63f8317994513bce6241276b5be40"
+        "size": 8160,
+        "sha256": "f9af49e21204417077166eb1510b368b605b8c3ab11a94f72cc99a4dd471d24a"
       },
       {
         "path": "src/shortcuts/project/continuation.ts",
         "role": "generated-cli",
-        "size": 3290,
-        "sha256": "2cb027c038c2bd9d7ee350df2f1380b28b0e0400bfeb9d5507debf4a08ee4cb1"
+        "size": 3366,
+        "sha256": "6663706182a5bdd5a38774d415f86cb9c9a09e40f0e7d69e65017fc70c2cd2b8"
       },
       {
         "path": "src/shortcuts/project/errors.ts",
         "role": "generated-cli",
-        "size": 2199,
-        "sha256": "811a9df01daed2aca8b0f1e7f3788c66fa0225666a3711ad166cc925232e2ec9"
+        "size": 2275,
+        "sha256": "60e810cbce79d1eddaf0a2d71a2b396dcb59b3c9c8111ae972cbfb8e46e0acc8"
       },
       {
         "path": "src/shortcuts/project/host.ts",
         "role": "generated-cli",
-        "size": 7147,
-        "sha256": "7f01ff757dcb05b0ea4a7346810a8ab6f203fcde45f3ba5362f3ffbfb4df2c95"
+        "size": 7481,
+        "sha256": "8004f455e679a9b26ac8d717bd0712dbd5d4c1715c69eb03b5b1212811014473"
       },
       {
         "path": "src/shortcuts/project/index.ts",
         "role": "generated-cli",
-        "size": 4396,
-        "sha256": "f8006888fb5c4da422c9584cf867be729b3b375d82208748f891c5662711eda8"
+        "size": 4514,
+        "sha256": "ca49682ceba69ba8a0356ea021f749415190a46e531955419968a48cfb3f112d"
       },
       {
         "path": "src/shortcuts/project/manifest.ts",
         "role": "generated-cli",
-        "size": 1396,
-        "sha256": "20defdc2d1c349f9395e4ca331706a1311fe9258638bca76e61c5de6994f1143"
+        "size": 1435,
+        "sha256": "faf46784f6371458c8e20be6b1975dea1db74986196a35243ff4ed99df826386"
       },
       {
         "path": "src/shortcuts/project/operations.ts",
         "role": "generated-cli",
-        "size": 631,
-        "sha256": "b5e61dc31da158456a1ad67850ea66c4f11bd87f2ef00af7c0f33c00db34ebee"
+        "size": 647,
+        "sha256": "8b4f86d3535310b09d05ee6c59d33c6d63235e5e0bc638f8d3f8dfefcff93ee0"
       },
       {
         "path": "src/shortcuts/project/operations/read.ts",
         "role": "generated-cli",
-        "size": 24404,
-        "sha256": "3b803ae1c0ca6731575cc003b1de996b6ba4cedd7336940ce7c7ace183357ba2"
+        "size": 24518,
+        "sha256": "09c5a231cf9f6d63eea6675f63367c3f834e93fc014b320e1d83f79a9adcef35"
       },
       {
         "path": "src/shortcuts/project/operations/registry.ts",
         "role": "generated-cli",
-        "size": 1317,
-        "sha256": "643e326fea47b63593d926e55e2f2cd554f2259d2a5d3a2317f25dc306c1991a"
+        "size": 1354,
+        "sha256": "3406fd9458cbd169f95cc75bac803ff437b12b02b1efd40600d8875bea213893"
       },
       {
         "path": "src/shortcuts/project/operations/shared.ts",
         "role": "generated-cli",
-        "size": 2961,
-        "sha256": "935def605c99d9c6d5b4eeab2bab62baf28dffb10f36514392a7e13499d91084"
+        "size": 4249,
+        "sha256": "91a777c9c849ac8f682dfd23bf6e1ca09cb3f44fc5340dbaec2ba28b8fe1f001"
       },
       {
         "path": "src/shortcuts/project/operations/types.ts",
         "role": "generated-cli",
-        "size": 2968,
-        "sha256": "0459bdf2e484679ccc917ed212abb7334129402cd4dc88e61c76edcba82ac744"
+        "size": 3053,
+        "sha256": "ca57f63bf41417a178da1585194a2df008d36f7f8f0e0eb67a4f71a5169e7213"
       },
       {
         "path": "src/shortcuts/project/operations/write.ts",
         "role": "generated-cli",
-        "size": 12903,
-        "sha256": "795e803156480b2bbcf4d27a5a36915e955c64e88737b3f4f222d7a6f1ce03bb"
+        "size": 14495,
+        "sha256": "a8ea08cb7e86054d0c1cc3b41c0e4b2a46b80ae13ff60d6b449655b60b2da24b"
       },
       {
         "path": "test/business/project-operations.test.ts",
         "role": "generated-test",
-        "size": 15966,
-        "sha256": "27abe41e8c6819d48c926fc10ebfaee7653defc8672c3634d0e838d42cde7f35"
+        "size": 18719,
+        "sha256": "317d795ac9825566aaa5a9aadd0f7abb341ddae2fcd4221e46b70e1b6820b738"
       },
       {
         "path": "skills/weaver-e10-shijingran/references/disabled-capabilities.md",
@@ -1383,6 +1383,7 @@
     "源资料版本为 1.0.4，覆盖 25 个接口文档、1 个目录文档和 1 个字段解析流程指引。",
     "project.attachment.upload 与 project.field.auto-resolve 因源资料缺少安全实现契约而保留为 withheldOperations。",
     "2026-09-24：刷新本技能包内产物指纹（SKILL.md / references），新增 references/disabled-capabilities.md；行尾统一为 LF。",
-    "2026-10-08：SKILL.md 的「登录与请求头凭证契约」改为请求头声明表格（Cookie / eteamsid / User-Agent），刷新本包产物指纹。"
+    "2026-10-08：SKILL.md 的「登录与请求头凭证契约」改为请求头声明表格（Cookie / eteamsid / User-Agent），刷新本包产物指纹。",
+    "2026-11-04：新建项目/任务后的返回值补充 detail_urls（详情链接），写入文档与展示契约同步；整体重建产物基线指纹。"
   ]
 }

package/skills/weaver-e10-shijingran/references/write-operations.md

@@ -50,6 +50,8 @@ weaver-work-cli --json project run project.task.create.prepare --input-json '{"r
 {"continuation":"PREPARE_CONTINUATION","confirm":true}
 ```
 
+apply 成功后，`data.dataIds` 是新记录 ID 列表，`data.detail_urls` 是对应的详情页地址（与 `dataIds` 同序）。展示新建结果时按索引把记录名称渲染为 `[名称](detail_urls[i])`，不要只给 ID；若返回 `detail_url_warning`，说明写入已成功但链接暂不可用，如实说明即可，不要重试 apply。
+
 ## 修改
 
 - `project.task.update.prepare` / `project.project.update.prepare` 输入 `id` 和 `fields`。

package/skills/weaver-e10-workflow/SKILL.md

@@ -100,7 +100,11 @@ cliHelp: "weaver-work-cli workflow --help"
 - 两类词**同时出现** → 按 `workflow.todoSmartConvert`（归拢优先；`todoStat` 只服务纯统计诉求）。
 - 三类词**都没有**（只是"有哪些待办 / 列出来 / 多少条"）→ `workflow.search`，不要调 `workflow.todoStat`。
 - **例外**：「批量处理待办」后面跟了明确写动作（提交 / 置已读 / 催办 / 共享 / 转发 / 退回）时，仍走 `workflow.batch*`，不要因为出现"批量处理"就转成汇总。
+- **汇总范围的小分类（2026-11-02）**：用户原话出现小分类词（待处理 / 待阅 / 超时 / 未读 / 被退回 / 草稿 / 抄送 / 转发…）时，`prep`/`run` 要传 `--sub-category <词>`（或 `--tabid <tabid>`，显式 tabid 优先；todo 词表：待处理=7、待阅=5、超时=6、被退回=8、草稿=14、全部=0），否则「汇总下我的待处理」会静默取回全部（tabid=0）。未表达小分类时不传。仅影响汇总取数，`workflow.search` 不受影响。
+- **参与身份默认口径（2026-11-03，generalRules）**：汇总取数是否默认排除/包含抄送类身份，以 `default.json` 的 `generalRules` **现行内容为准**（该文件用户可直接编辑，配置可能随时调整），取数 warning 会提示实际生效口径。**用户提示词显式提到抄送/包含抄送/只要抄送/指定身份时，必须显式传 `--isremarks` 覆盖默认值**（全量=全部 23 个身份码；只要抄送=`30,31,33,70,71`）。
+- **缓存与规则口径的纪律（2026-11-03 用户定稿）**：①汇总缓存文件缺失、被清理或条目 miss ⇒ 一律按「冷缓存、从未生成过」处理，直接走待写摘要流程，**不追溯原因、不从备份恢复、不当异常上报**；②`aigroup/default.json` 是用户本机可编辑的规则文件，改动是常态，**只管读并按现行内容执行**——不与仓库版本比对、不覆盖恢复、不探究谁改的。
 - **不要**为了"先看一眼有哪些"去调 `workflow.todoStat` / `workflow.search` 再回头走汇总链路——那会多花一轮，且交付形态会被带偏。
+- **禁止复用上一轮快照（2026-11-04 用户定稿，2026-11-04 复盘踩坑）**：汇总请求（原话含「汇总待办」/「摘要」等归拢说法）一律**重新执行 `run`（collect 取数）**，**禁止**因为"数据刚取过 / 快照没过期 / 省一轮调用"而复用上一轮的快照 URL 或原样重发旧 `<browsertool>` 块。理由：汇总输出不只取决于待办数据，还取决于**本地规则文件**（`aigroup/default.json`、用户意图）——数据没变 ≠ 输入口径没变，规则改动（如 `needSummary`、`requestSummaryPrompt`）必须靠重新取数才会生效；本地 serve 的快照本身不校验规则新鲜度，复用它等于静默输出旧口径。仅当用户明确说"把刚才的链接再发一次"才允许原样重发。`finish` 的 `ruleFp` 拦截只在真正走到导出时生效，**不能**作为跳过取数的借口。
 
 
 ### 用户意图 → JSON（2026-10-28 新增，模型负责理解、CLI 负责落盘）
@@ -123,7 +127,7 @@ weaver-work-cli --json workflow aigroup set --input-json '{"workflowName":["费
 | 名词 | 含义 |
 | --- | --- |
 | `workflowName` | 工作流名称。**第一次分组 = 按 `workflowName` 分组**，得到的每组叫「工作流分组」 |
-| **ai二次分组** | 工作流分组之后、在组内再切子组的过程。**只有这一步需要 AI 计划（`aiGroups`）** |
+| **ai二次分组** | 在组内再切子组的过程。**只有这一步需要 AI 计划（`aiGroups`）**；**排在单条摘要之后**（2026-11-03：分组与摘要不耦合，摘要阶段不再被 `aiGroups` 阻塞） |
 | **原始列表数据** | `/getTodoListData` 返回的待办条目集合，整条链路的唯一数据源 |
 | **流程标题** | 条目字段 `requestNameTitle`；没有流程详情数据时 AI 只能靠它判断语义 |
 | **流程详情数据** | `/getWorkflowRequest` 返回的表单字段 + 基础信息（分组素材 / 摘要素材 / 阈值指标都取它） |
@@ -209,6 +213,8 @@ weaver-work-cli --json workflow aigroup set --input-json '{"workflowName":["费
 ### 5) 命令输出读取纪律（禁止截断、禁止重复取数）
 
 - **禁止对命令输出做管道截断**：不要用 `| head`、`| tail`、`| more` 等处理 `weaver-work-cli --json ...` 的 stdout。截断会破坏 JSON，并且必然导致重复执行同一条命令（实测最常见的一条命令被执行 2 次，就是 `| head` 引起的）。
+- **`tools/` 脚本（`todo-summary.cjs` 等）的输出同样禁止截断、禁止重跑**（2026-11-02 用户定稿，实测踩坑）：这类输出是**纯文本素材**而不是 JSON——截断不会报错，只会让素材**悄悄缺条**。实测 `build` 的「待写摘要」一节共 17.6 KB / 9 条，用 `| head -c 9000` 只看得到前 5 条，且此时缓存已经写过、重跑 `build` 也补不回被跳过的那几条，最后只能把整套链路重跑一遍（同一任务 12 轮 → 1 轮，脚本耗时 71.9s → 3.0s）。因此：**脚本输出一律整段直读，不 `head` / `head -c` / `tail` / `grep` 过滤正文**；确需留存时用 `> <out>/xxx.log` 一次落盘、再用 Read **一次**读完（只允许这种"整段落盘"，不许分段看、不许先截断看一眼再重跑）。`prep` / `build` / `finish` 的 stdout 已包含下一步所需的全部内容（组/行/序号、待写摘要素材、最终结构、自检、载荷），**不需要、也不允许**为了"确认一下"再去翻中间产物。
+- **中间产物不要重复探查**：`<out>/` 下的 `items.json` / `state.json` / `smartgroup.json` / `build.log` / `finish.log` 是脚本自己的中间态；不要 `ls` 输出目录、不要读 `state.json` 核对、不要翻日志找已完成的信息——每次探查≈1 轮≈20s（实测一次任务这样白花 3 轮、约 25s）。只有 stdout 里确实缺、且下一步**必须**用的字段（如某条 `requestId`）才去读，读就一次读完。
 - **一律直读 stdout（失败时读 stderr，见下条），不要落盘、不要写脚本回读**：`--json` 输出是**多行 pretty JSON**，且已按体积做过控制（`workflow.todoStat` 约 20 KB/400 余行；`workflow.search` 的条目已收窄到必要字段、泛化待办查询实测约 **14 KB**；`workflow.detail` 只有几 KB；`workflow.createForm` / `editLoad` 遇到大表单会落盘、stdout 只回提示）——都在宿主单次输出上限以内——**直接读即可**。注意 `workflow.createForm` 的 `fields` / `historyRequestData` / `systemFields` 三个键是**压成单行**输出的（只去缩进、内容一字不改），其中 `fields` 那一行字段多时可能上万字符——**这属正常，不是被截断**，照常按 JSON 解析。**禁止**把 stdout 重定向到文件（`> /tmp/xxx.json`）再写脚本解析回读：它不会带来任何新信息，只会白白多出一次工具往返（实测多一轮约 +7s，占整轮耗时可观）。
 - **`workflow.search` 的体积纪律（别等被截断）**：泛化待办按要求走 `planJson` 分组（各组独立渲染、各 10 条，体积天然分散）；要看更多用 `current` 分页续查；**不要靠加大 `pageSize` 一次拉全**。CLI 侧已按 **24 KB（美化口径）** 设体积守卫：超线时自动把完整结果落盘，并在结果**最前面**给出 `resultFile`（结构化 JSON）+ `resultMdFile`（纯 `finalMarkdown`），**stdout 仍保留全量 `finalMarkdown`** ⇒ 正常渲染**直接用 stdout 即可、不需要读文件**；只有需要完整结构化明细（如逐条 `requestId`）时才从 `resultFile` 按需提取，并一次读完（不要 `| head`/`| tail`）。宿主把输出截成一小段预览时：**不要重跑同一条命令**（结果一样、白烧一轮），改用更小页或 `planJson` 分组重取；宿主提示的落盘副本（`~/.workbuddy/projects/**/tool-results/**`）**不能用 Read 工具读**（会拿 `Permission … has been denied`），确实要用时以 shell 命令读取并只提取需要的字段。
 - **失败出口在 stderr（stdout 为空即失败）**：命令失败时退出码非 0、**错误 JSON 只出现在 stderr**（`{ok:false, error:{type,subtype,message,retryable}}`），**stdout 是空的**。因此：**stdout 为空 → 一律视为失败并去读 stderr**，按 `error.subtype` 决定下一步（如 `todo_stat_requires_smart_mode` → 不要重试 todoStat，改走 `workflow.search`；`plan_requires_smart_mode` → 去掉 `planJson` 重查）；判断成败**以 `ok` 字段为准**，宿主界面把命令显示成"运行成功"只代表进程结束，不代表业务成功。