weaver-work-cli 0.1.23 → 0.1.25

package/skills/weaver-e10-workflow/references/workflow-memory.md

@@ -111,17 +111,16 @@ weaver-work-cli --json workflow run workflow.memoryExtract --input ./mem-extract
 
 ## 记忆规则（保存时机与处理）
 
-每轮完整实质任务结束后（输出最终回复前），必须自行判断本轮是否出现**新的、有价值的语义记忆**（例如用户新澄清/确认了具体工作流、字段名、字段选项；与已有记忆重复的不算，必填字段的填值偏好不算）：
+每轮完整实质任务结束后（输出最终回复前），必须自行判断本轮是否出现**新的、有价值的语义记忆**（例如用户新澄清/确认了具体工作流、**字段名 / 浏览按钮字段值 / 选项字段的选项值**；与已有记忆重复的不算）：
 
 - **有** → 组装本轮"用户原始意图 + 澄清过程 + 确认结果"的消息列表并调用 `workflow.memoryExtract`（同步，`async` 语义为返回真实结果）：
-  - `saved:true` → 用自然语言告知用户会记住什么（如"后续发起请假流程会默认按本次偏好填写"），不展示接口原文；
-  - `saved:false` → 按静默失败处理，不告知用户、不重试，直接继续回答。
+  - `saved:true` / `saved:false` → **都静默处理**（不告知用户、不展示接口原文、不重试），直接继续回答。
 - **没有** → 不调用，直接输出最终回复。
 
 **硬禁令（必须遵守）**：
 
 - **不允许只在思考中写"保存记忆"**：判断"有"后必须**实际调用** `workflow.memoryExtract` 命令，命令完成（拿到真实 `saved`）后再输出最终回复。只在思考/内心说"应该保存"而不执行命令 = 没保存，属于违规。
-- 本次发起的工作流本身、业务别名、以及本次新确认的字段口径偏好（**「字段口径」指字段名、选项含义这类语义澄清，不含单据里填了什么值；必填字段的填值偏好不算**），只要符合开头「新的、有价值的」判据，就属于要保存的情形，不要漏。
+- **发起流程（`workflow.createForm` / `workflow.createRequest`）按更窄的口径**：本轮发起过程中，只有**用户有新的明确澄清**——① 工作流名称；② 字段名称；③ 浏览按钮字段值；④ 选项字段的选项值——才属于要保存的情形（口径见 [`workflow-create.md`](workflow-create.md)）；**这四类之外一律不保存**（用户只是给出普通文本 / 日期 / 金额字段的本次取值、或只是正常走完一次填单，都不算记忆），不要漏也不要多存。
 - **别名条目的 `workflowId` 是「（待确认）」时，它是一张待办不是终态**：本轮只要把该别名唯一解析出了 `workflowId`（**`cards[].workflowId`** 或 `countDetails[].workflowId` 里就有），任务结束时**必须再保存一次把 ID 补上**，不要放着不管——否则下一轮读到的还是「（待确认）」，只能拿纯名称去试探，多命中还要再澄清一次。
 
 消息列表由模型在本地组装并作为入参传入（`msgList` 或 `userMessage`+`assistantMessage`）；可含多轮原始消息（尤其澄清链路），可精简无用消息（命令执行日志、大段接口原始返回、调试输出），不需要模型提前总结。
@@ -158,8 +157,6 @@ weaver-work-cli --json workflow run workflow.memoryExtract --input ./mem-extract
 - **每页条数偏好**：用于列表查询的 `pageSize`；**本次用户明确指定的条数优先于记忆偏好**。
 - **紧急/超时流程优先展示**、详情摘要关注字段、已确认的审批建议规则、展示/确认/异常处理偏好。
 
-记忆影响了本轮决策时（工作流消歧、摘要字段优先级、审批建议、每页条数、紧急超时优先展示），最终回复**不要展示记忆原文**，但必须保留自然语言说明依据了哪类历史偏好（如"我按你之前确认的偏好，把报销优先理解为总部费用报销。"）。
-
 记忆**不能**用于：猜测当前系统元数据（工作流 ID/字段/节点元数据必须来自当前链路解析）、替代 `index` 序号映射定位、绕过操作门禁（`canSubmitRejectTransfer` 等）、仅凭记忆自动执行审批（记忆只能生成建议，执行以用户本轮明确指示为准）。
 
 ## 注意

package/skills/weaver-e10-workflow/references/workflow-operate.md

@@ -142,7 +142,8 @@ weaver-work-cli --json workflow run workflow.operatePrepare --input-json '{"requ
 ## 注意
 
 - `deleteRequest`（删除流程）不可恢复，执行前必须明确告知用户不可逆影响并征得确认。
-- 接收人名称由 CLI 调人员浏览器解析：**多命中**报 `receiver_ambiguous`（`error.message` 说明需回传 `"名称(ID)"`）、**0 命中**报 `receiver_not_found`——CLI **不会静默取第一个**。用户确认后按 `"名称(ID)"` 回传，其余已确认的接收人按同样格式一并带上（逗号分隔）。
+- 接收人名称由 CLI 调人员浏览器解析：**多命中**报 `receiver_ambiguous`（`error.message` 附 `candidates`）、**0 命中**报 `receiver_not_found`——CLI **不会静默取第一个**。
+- **澄清时一律不向用户索取 ID**：只问该接收人的**完整姓名**，或**其它可用于检索的关键词**；用户确认后由你按 `"姓名(ID)"`（ID 取 `candidates` 里的那一项）把值拼好回传，其余已确认的接收人按同样格式一并带上（逗号分隔）。**不要让用户提供 ID**。
 - 失败一律看 **stderr** 的 `{ok:false, error:{type, subtype, message, retryable}}`（**没有** `success`/`stopReason`/`userMessage` 字段）；`error.message` 原样转述，不自行改写或补造结果。
 - `continuation` 是 CLI 托管的短句柄（形如 `wc-1a2b3c4d5e6f7a8b`），Agent 只原样回传，禁止解析、手工构造、修改或复用；`confirm` 必须且只能为 `true`。
 - Apply 被重复执行、且上一次已经成功时，返回 `ok:true` + `data.status = "ALREADY_APPLIED"`（含 `previousResult`；若上一次是"服务端已成功回执、只是没来得及写回结果"，还会给出 `requestId`）——**这不是失败**，本次没有重复写入，按上一次结果汇报即可，不要重跑 Prepare。

package/skills/weaver-e10-workflow/references/workflow-query.md

@@ -1,6 +1,6 @@
 # 流程查询（workflow.search / workflow.todoStat）
 
-> **分段索引 —— 本文件约 108 KB / 833 行，必须按段读：整读会超单次读取上限被明确拒绝**（Read 单次上限约 **20,000 tokens ≈ 100 KB / 800 行**）；**开头的契约段（1-244 行，约 30 KB）一次就能读完**，其余段落按本索引的行区间分次读。**
+> **分段索引 —— 本文件约 108 KB / 835 行，必须按段读：整读会超单次读取上限被明确拒绝**（Read 单次上限约 **20,000 tokens ≈ 100 KB / 800 行**）；**开头的契约段（1-244 行，约 30 KB）一次就能读完**，其余段落按本索引的行区间分次读。**
 > 被拒时按报错提示改用 `offset`/`limit`、**回到本文件按行段重读**即可；**不要**去找宿主的落盘文件（`~/.workbuddy/projects/**/tool-results/**` 无读取权限，去读只会拿到 `Permission … has been denied`、白费一轮——"落盘 + 只回 2048 字节预览"那是**命令输出**超线时的行为，本文件的读取不走那条路）。
 >
 > | 段落 | 行区间 | 读取方式 |
@@ -9,10 +9,10 @@
 > | `planJson` 批量编排 | 245-324 | 泛化待办 / 一次取多组数时读：`offset 245 limit 80` |
 > | 汇报式分组骨架 + 七个维度 + 参与身份说明与分组去向 + 常见业务重点字段 + 汇总渲染规则 + 渲染红线 | 325-524 | 需要输出分组结果前读（分两次）：`offset 325 limit 100`、`offset 425 limit 100` |
 > | 智能分组示例（各业务域样例，**仅供格式参照，不要照抄内容**） | 525-639 | 一般**不用读** |
-> | **异常返回处理 + 澄清后回传**（澄清信封、修正指令、认证失效） | 640-700 | 拿到 `ok:false` 或 `NEEDS_CLARIFICATION` 时读：`offset 640 limit 61` |
-> | 调用示例 | 701-779 | 需要时读：`offset 701 limit 79` |
-> | 返回（返回结构 / 错误码 / 幂等口径） | 780-819 | 处理 `ok` / `error` 时读：`offset 780 limit 40` |
-> | 注意 | 820-833 | 需要时读：`offset 820 limit 14` |
+> | **异常返回处理 + 澄清后回传**（澄清信封、修正指令、认证失效） | 640-702 | 拿到 `ok:false` 或 `NEEDS_CLARIFICATION` 时读：`offset 640 limit 63` |
+> | 调用示例 | 703-781 | 需要时读：`offset 703 limit 79` |
+> | 返回（返回结构 / 错误码 / 幂等口径） | 782-821 | 处理 `ok` / `error` 时读：`offset 782 limit 40` |
+> | 注意 | 822-835 | 需要时读：`offset 822 limit 14` |
 >
 > 行号以本索引为准；**改本文件时同步更新本索引**。按 `##` 标题定位同样有效。
 
@@ -94,7 +94,7 @@
 | 发起人 | `creator`、`creatorDept`、`creatorSubcom` | 姓名/部门/分部；「我/我的」= 当前用户 |
 | 工作流类型 | `workflowType` | 类型名；**多命中/0 命中时 CLI 返回澄清信封并列出候选**，改用 `名称(ID)` 重发 |
 | 当前节点 ID | `nodeId`、`nodeIdTerm`（`in`/`notin`） | 节点 ID |
-| 流程状态 | `flowStatus`、`flowStatusTerm`（`in`/`notin`） | 状态值；`已结束` = 强制+正常结束 |
+| 流程状态 | `flowStatus`、`flowStatusTerm`（`in`/`notin`） | `finish`（已结束）/ `normalFinish`（正常结束）/ `forceFinish`（强制结束）/ `notFinish`（未结束·审批中）——**传英文 key**，不接受中文；可逗号分隔多值 |
 | 精确过滤/排除 | `requestId`、`exRequestId` | 逗号分隔多个 requestId |
 | 排序 | `sort` | `"排序方式:asc\|desc"`，多组逗号分隔 |
 | 条件关系 | `conditionType` | `and`（默认）/`or` |
@@ -488,7 +488,7 @@ CLI 按 OA 版本自动路由，**两种模式的返回形态不同，按实际
 - **分组之间明显分隔**：上一分组的最后一张卡片与下一分组标题之间留空行（建议再补一行 `---` 让分组边界更清晰）。
 - **禁止（仅限本节的分组卡片渲染）**：不要把卡片输出成 Markdown 表格、也不要压成连续文本编号列表——卡片一律原样粘贴 CLI 生成的 `finalMarkdown`；不要自行重算或改写各组数量。**本条只约束分组卡片渲染，不适用于其它场景**：发起/修改流程的表单预览与明细表按 [`workflow-create.md`](workflow-create.md) 的规则展示（明细表**必须**用表格列展示），批量操作结果按 [`workflow-batch.md`](workflow-batch.md) 用表格展示。
 
-**渲染纪律（省时关键）**：分组顺序、标题计数口径、顶部汇总行口径、卡片粘贴边界都已在本节与「渲染红线」给定——**照做即可，不要重新推导、不要反复确认**（避免"这个组该不该排前面""汇总行要不要含草稿"这类来回权衡）。进入渲染阶段后只做三件事：按固定顺序拼接各组已取到的内容、写分组标题、为每组写一行汇总。**结尾最多写一句说明**（例如"依据您的历史偏好每页 5 条"）——**不得附带任何 0 计数、类别清单，或"某某类别为空/未列出/不涉及"之类表述**（口径见「渲染红线」空组约束）。
+**渲染纪律（省时关键）**：分组顺序、标题计数口径、顶部汇总行口径、卡片粘贴边界都已在本节与「渲染红线」给定——**照做即可，不要重新推导、不要反复确认**（避免"这个组该不该排前面""汇总行要不要含草稿"这类来回权衡）。进入渲染阶段后只做三件事：按固定顺序拼接各组已取到的内容、写分组标题、为每组写一行汇总。**结尾不写说明句**——不写"依据您的历史偏好…"这类，也**不得附带任何 0 计数、类别清单，或"某某类别为空/未列出/不涉及"之类表述**（口径见「渲染红线」空组约束）。
 
 ## 渲染红线
 
@@ -514,7 +514,7 @@ CLI 按 OA 版本自动路由，**两种模式的返回形态不同，按实际
 
 **"任何位置"的口径（最容易漏的地方，逐条对照）**——为 0 的类别要**只字不提**，**连"为什么没列"也不许解释**：
 
-- ❌ 结尾说明句里夹带：`说明：本次分组依据您的历史偏好（每页 5 条）；紧急/超时这一类当前计数为 0，故未列出。`——说明"依据了记忆偏好"是允许的，**但夹带 0 计数不允许**；两者同句时只保留前半句。
+- ❌ 结尾说明句里夹带：`说明：本次分组依据您的历史偏好（每页 5 条）；紧急/超时这一类当前计数为 0，故未列出。`——**夹带 0 计数不允许**；回复里也**不再出现"依据了记忆 / 历史偏好"这类说明**，这样的结尾说明句整句都不写。
 - ❌ 其它分组的汇总摘要里带一句：`……动作对象指向客户或商务部等业务角色，无紧急、超时。`
 - ❌ 顶部汇总行里写 `紧急 0 条 / 超时 0 条`。
 - ❌ 换任何说法的否定式提及：`本次不涉及紧急/超时`、`暂无紧急事项`、`未列出的类别为空`、`其余类别无数据`。
@@ -657,6 +657,8 @@ CLI 按 OA 版本自动路由，**两种模式的返回形态不同，按实际
 
 名称类条件**解析不出唯一对象**时不会静默放行：返回澄清信封（`ok:true` + `status:NEEDS_CLARIFICATION` + `data.candidates`），**不返回任何业务数据**。收到澄清就按下面的流程把候选原样交给用户；**不要**自行挑一个候选继续，也**不要**换词重发试探。
 
+**澄清时一律不向用户索取 ID**：只问该对象的**完整名称**，或**其它可用于检索的关键词**——候选确认后的回传格式（`名称(ID)`）由你按 `candidates[].display` 自行拼好，**不要让用户提供 ID**。
+
 返回形态分两类（澄清信封 / 硬失败），**不要混为一谈**：
 
 | 情形 | 返回 | 处理 |
@@ -668,7 +670,7 @@ CLI 按 OA 版本自动路由，**两种模式的返回形态不同，按实际
 | 表单字段元数据读不到 / 空清单 | **澄清信封**（`clarificationType=field_meta`，**无候选**） | 按 `clarificationQuestion` 如实告知用户或改不带 `filterFields` 查询 |
 | 工作流类型 / 发起人 / 发起人部门 / 发起人分部 / 紧急程度 **0 命中** | **`ok:false` + `error.subtype=<字段>_not_found`**（V11.3 是硬失败） | 按上表「异常返回处理」的 `*_not_found` 行处理，**不是**澄清 |
 
-**候选就用服务端返回的这一批（最多 10 条），不要指望 CLI 帮你扩召回**：CLI 按用户原词直接问服务端，返回几条就是几条——这是刻意的，名称类模糊匹配在大租户下可能命中成千上万条，取全既慢又没意义。所以：① 把这批候选**原样**给用户看；② **这批里都不匹配时，请用户给出准确的完整名称（或用 `名称(ID)`）**，不要自行换相近词反复试探、也不要要求 CLI 取更多候选；③ 用户给了更准的词就重发一次，仍不匹配就如实告知。
+**候选就用服务端返回的这一批（最多 10 条），不要指望 CLI 帮你扩召回**：CLI 按用户原词直接问服务端，返回几条就是几条——这是刻意的，名称类模糊匹配在大租户下可能命中成千上万条，取全既慢又没意义。所以：① 把这批候选**原样**给用户看；② **这批里都不匹配时，请用户给出该对象的完整名称（或其它可用于检索的关键词）**，不要自行换相近词反复试探、也不要要求 CLI 取更多候选；③ 用户给了更准的词就重发一次，仍不匹配就如实告知。
 
 `data.candidates` 为空（`candidateCount=0`）说明该名称在当前环境**根本没有对应对象**（多半是错别字/漏字），请用户给准确全名后重发，**不要**当作"没有匹配的流程"答复。
 

package/skills/weaver-e10-workflow/references/workflow-share.md

@@ -41,6 +41,8 @@
 
 名称自动转 ID；`name` 也支持 `"名称(ID)"`（如 `"张三(1001)"`）：此时**直接采用括号里的 ID、不再搜名称**，多命中澄清后按该形式回传即可。多命中返回候选列表让用户确认，禁止静默全选（不允许把同名多人全部设为共享对象）；0 命中报错提示核对名称。
 
+**澄清时一律不向用户索取 ID**：只问该对象的**完整名称**，或**其它可用于检索的关键词**；候选确认后的 `"名称(ID)"` 由你按 `candidates` 里的那一项自行拼好，**不要让用户提供 ID**。
+
 ## 示例
 
 ### 共享给一个人 + 一个部门 + 所有人