weaver-work-cli 0.1.23 → 0.1.24

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

@@ -5,7 +5,7 @@ display_name_en: Weaver Jiuchuanhui Marketing Management
 description: "泛微 E10 九氚汇营销管理：客户、联系人、商机、线索的创建、查询、搜索、修改、转移、公海、联系计划、联系记录、商机推进、线索转客户等 CRM 操作。用户表达营销/CRM 相关业务意图时使用。"
 description_zh: "泛微 E10 九氚汇营销管理。覆盖客户、联系人、商机、线索全生命周期：创建、查询、搜索、修改、转移、公海领取/释放、查重、联系计划、联系记录、商机赢单/输单/无效/暂停/重启、线索转客户，并通过 prepare/apply 确认链处理全部高风险写操作。"
 description_en: "Full-lifecycle CRM operations for customers, contacts, opportunities and clues in Weaver E10 Jiuchuanhui marketing management, including confirmed writes for create, update, transfer, pool claim/release, stage changes and clue-to-customer conversion."
-version: 1.0.0
+version: 2.1.0
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -29,6 +29,14 @@ cliHelp: "weaver-work-cli jiuchuanhui --help"
 
 登录与会话由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系统一托管。业务 Skill 不自建登录流程，不索取、打印或转存任何凭证。
 
+调用 E10 接口时，请求头三件套由 `weaver-work-cli` 统一注入，业务调用方不得覆盖，也不得在业务 JSON 中传入凭证类字段：
+
+| 请求头 | 取值 |
+|---|---|
+| `Cookie` | `<e10-login / CLI 提供的完整原始 Cookie 串>`（禁止裁剪、去重、改写） |
+| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
+| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
+
 
 ## 启动与缓存（MUST）
 

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

@@ -39,7 +39,13 @@ requires:
 
 ## 最高优先级：XiaoE 统一登录
 
-如果当前运行在 XiaoE 宿主环境，或任务上下文/环境变量显示存在 `XIAOE_*` / `xiaoeUserData/tokens.py`，登录处理必须优先走 XiaoE 统一登录：
+只有**当前智能体身份明确是 XiaoE** 时才允许走 XiaoE 统一登录。判定依据只能是宿主/任务上下文明确标识 XiaoE，或当前命令进程由 XiaoE 按次注入了成对的平台凭据。不得把以下任一情况当成 XiaoE 宿主证据：
+
+- 本机存在 `xiaoeUserData/tokens.py` 或 XiaoE 客户端目录；
+- 环境中只有 `XIAOE_SKILL_*`、`WEAVER_XIAOE_*` 配置或历史兼容变量；
+- 过去在同一台机器上登录或安装过 XiaoE。
+
+WorkBuddy、Codex 及其他智能体一律使用 `weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_type "<当前智能体名称>"` 走浏览器 OAuth。`auth login` / `auth oidc` 不会读取或消费 XiaoE 凭据。
 
 ### XiaoE 凭据由 CLI 独占处理（顶层强规则）
 
@@ -49,6 +55,8 @@ Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读
 - 执行 `weaver-work-cli auth export-weaver-env` 并 `eval` / `Invoke-Expression` 到当前 shell，或把 `WEAVER_*` 值写进命令、日志、报告；
 - 要求用户粘贴、或在回复中展示、转述任何凭证。
 
+下述 `auth xiaoe` 流程仅适用于上述已确认的 XiaoE 智能体环境；其他智能体不执行宿主脚本检测，直接进入浏览器 OAuth 流程。
+
 需要登录态时只运行 `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 内部执行和解析。失败时 CLI 返回结构化错误，Agent 不要替它执行脚本、安装 Python 依赖、手工取 Token 或自动引导用户在本地终端重复登录。
 
 1. 未登录、登录失效、准备执行业务命令前需要确认 E10 会话，或 `auth status --no-check` 显示未登录时，先运行：
@@ -61,6 +69,8 @@ Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读
 5. XiaoE 统一登录走不通时，CLI 必须反馈未拿到登录信息的原因。Web/Linux 环境的 `auth xiaoe` 返回 `authentication/xiaoe_web_credential_unavailable`，不会自动打开 localhost 浏览器 OAuth；macOS/Windows 桌面宿主才允许自动降级。用户明确要求网页登录、且 CLI 与浏览器同机时，再显式运行 `weaver-work-cli auth login`。
 6. `auth status --no-check` 只是本地诊断，不会主动触发 XiaoE 统一登录；业务命令和 `auth xiaoe` 才会尝试写入统一登录态。具体读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
 
+`auth login` / `auth oidc` 是严格的浏览器 OAuth 入口，即使同一台机器上存在 XiaoE 凭据或客户端文件，也不得先尝试 XiaoE 统一登录。未显式指定 `--auth` / `--profile` 的业务命令也只能在当前进程身份明确为 XiaoE 时自动尝试统一登录。
+
 ### 浏览器 OAuth 防挂起（顶层强规则）
 
 `auth login`（以及 macOS/Windows 桌面宿主上的 `auth xiaoe` 降级）会在本机 `127.0.0.1:19800` 监听浏览器回调，最长等待 5 分钟。在 Agent 沙箱/托管环境中，外部浏览器无法回调容器内 `127.0.0.1:19800`，因此：
@@ -142,7 +152,7 @@ User-Agent: AgentType=<agentType>,IsAgent=true
 | 强触发条件 | Reference |
 | --- | --- |
 | 命令不可用、Agent 自动安装 CLI、安装、构建、全局 link、检查可用 skill | [`weaver-e10-installation.md`](references/weaver-e10-installation.md) |
-| 登录、profile、E10 会话、baseUrl、auth 文件、`WEAVER_*` / `XIAOE_*` 环境变量；**未登录或登录失效（XiaoE 先自动尝试，其它场景需要用户提供登录域名）** | [`e10-auth-and-session.md`](references/e10-auth-and-session.md) |
+| 登录、profile、E10 会话、baseUrl、auth 文件、`WEAVER_*` / `XIAOE_*` 环境变量；**未登录或登录失效（仅 XiaoE 智能体环境先自动尝试，其它场景需要用户提供登录域名）** | [`e10-auth-and-session.md`](references/e10-auth-and-session.md) |
 | 容器/沙箱/CI/无 GUI 环境、无人值守、登录类命令超过 180 秒未结束、出现 `Open browser login` / `Waiting for E10 authorization callback` / `Could not open browser automatically`、显式传域名后仍降级、认证目录 `EACCES` | [`non-interactive-environment.md`](references/non-interactive-environment.md) |
 | 判断 stdout/stderr、JSON envelope、退出码、脚本封装、自动化调用、大结果渲染/分页控量 | [`json-output-contract.md`](references/json-output-contract.md) |
 | 准备执行写入/删除/导入/更新、遇到 `confirmation.required`、`partial.write_uncertain`、网络中断或回查失败 | [`high-risk-write.md`](references/high-risk-write.md) |

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

@@ -3,7 +3,7 @@
 ## 什么时候读取
 
 用户需要登录、切换 profile、诊断 E10 连接、处理登录失效，或任务涉及 `base-url`、auth 文件、Keychain、`WEAVER_*` 环境变量时读取本文件。
-XiaoE 宿主环境涉及 `XIAOE_*` 环境变量或 `xiaoeUserData/tokens.py` 时也读取本文件。
+当当前智能体身份明确为 XiaoE，且认证流程涉及 `XIAOE_*` 环境变量或 `xiaoeUserData/tokens.py` 时也读取本文件。仅本机存在这些变量、文件或 XiaoE 客户端，不能用来判定当前智能体是 XiaoE。
 
 ## 基本检查
 
@@ -20,7 +20,7 @@ weaver-work-cli auth whoami
 
 登录态判断只允许通过 `weaver-work-cli auth status --no-check`、`weaver-work-cli auth profile list/current`、`weaver-work-cli doctor --e10` 和业务命令返回的 JSON 错误完成。只有用户明确提供外部 auth 文件路径时，才可按用户要求使用 `--auth <path>` 或 `E10_AUTH_PATH`；不能主动搜索旧认证目录。
 
-## 未登录 / 登录失效：XiaoE 先自动尝试，其它场景先问域名
+## 未登录 / 登录失效：仅 XiaoE 智能体自动尝试统一登录
 
 业务命令依赖 E10 登录态。出现以下任一情况即判定为未登录或登录失效：
 
@@ -38,10 +38,11 @@ weaver-work-cli auth whoami
 
 **正确流程（按序执行，缺一不可）：**
 
-0. **XiaoE 宿主环境优先自动尝试统一登录**：如果当前宿主/环境提供 `XIAOE_*` 变量，或存在宿主 `xiaoeUserData/tokens.py`，先运行：
+0. **仅 XiaoE 智能体环境优先自动尝试统一登录**：只有宿主/任务上下文明确标识当前智能体为 XiaoE，或当前命令进程收到 XiaoE 按次注入的成对平台凭据时，才运行：
    ```text
    weaver-work-cli auth xiaoe
    ```
+   本机存在 `xiaoeUserData/tokens.py`、XiaoE 客户端目录、`XIAOE_SKILL_*` 或 `WEAVER_XIAOE_*` 配置都只表示“凭据可能可用”，不表示“当前智能体是 XiaoE”。WorkBuddy、Codex 及其他智能体必须跳过此步，进入下方浏览器 OAuth 流程。
    CLI 会按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile `config.baseUrl` → CLI 内置默认值”解析 E10 登录域名；`XIAOE_DOMAIN` 只作为 XiaoE/erpa 换票服务地址。业务命令在未显式指定 `--auth` / `--profile` 时，也会自动优先尝试这一步。若凭证有效，会直接保存登录态，`agentType` 固定为 `XiaoE`，然后继续原业务操作。若 Web/Linux 返回 `authentication/xiaoe_web_credential_unavailable`，反馈宿主登录态/凭据注入异常后停止，不要自动进入下方浏览器流程，也不要要求用户去本地终端重复登录。Agent 不得因为本地存在旧 profile 就跳过统一登录，也不得要求用户提供或展示 `XIAOE_*` / ETEAMSID。
 
 1. **先调用宿主提供的提问 / 弹框能力询问用户**，让用户二选一：
@@ -78,6 +79,8 @@ weaver-work-cli auth whoami
 weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_type "<当前智能体名称>"
 ```
 
+`auth login` / `auth oidc` 是严格的浏览器 OAuth 入口，不会因为本机可发现 XiaoE 凭据、脚本或客户端文件而改走 XiaoE 统一登录。
+
 在 XiaoE 宿主环境中，`auth xiaoe` 先使用平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN` 换取 ETEAMSID（沙箱唯一可用来源）：先走 Node 主路径，失败后由 CLI npm 包自带的 `scripts/xiaoe_env.py` 作标准库兼容回退；拿不到时再读宿主 `xiaoeUserData/tokens.py` 的 stdout JSON（仅桌面宿主），再退回内置原生实现读取桌面 XiaoE 客户端会话（`XiaoE/Robots/<id>/user_settings.json`，不需要本机 Python）；仍未识别到可用凭证时，才读取 `WEAVER_XIAOE_*` 环境变量里的“当前登录域名 -> ETEAMSID”统一登录映射，并且保存的 `agentType` 固定为 `XiaoE`。`XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不能作为 E10 地址；E10 目标按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → CLI 内置默认值”解析。Node 和 Python 兼容路径都校验业务码及 `data.eteamId`，保留系统 CA 校验，只允许同源重定向或同主机 HTTP→HTTPS 升级。统一登录失败时，Web/Linux 返回 `authentication/xiaoe_web_credential_unavailable`，不自动启动 localhost 浏览器 OAuth；macOS/Windows 桌面宿主才允许自动降级。
 
 需要显式表达“XiaoE 优先”的场景也可以使用等价入口：
@@ -96,6 +99,21 @@ weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_ty
 
 `<当前智能体名称>` 使用发起登录验证的宿主标识，例如 WorkBuddy 传 `workbuddy`，Codex 传 `codex`。CLI 会把该值同时写入 E10 授权 URL 的 `agent_type` 和 `from` 参数，其中 `from` 用于授权确认页的客户端名称展示。如果宿主无法确认名称，才允许省略 `--agent_type`；CLI 会尝试从 `WEAVER_AGENT_TYPE`、`WORKBUDDY_AGENT_TYPE`、`CODEX_AGENT_TYPE` 以及 `WORKBUDDY_*` / `CODEX_*` 环境变量推断，最后回落为 `weaver-work-cli`。
 
+授权成功后，本地回调页会为已识别的桌面智能体显示应用打开弹层。CLI 内置 WorkBuddy
+（`workbuddy://`）、智能小 E（`xiaoe-client://`）和 Codex（`codex://`）映射；其他
+智能体在 `agent_type` 本身是合法协议名时，默认按 `<agent_type>://` 唤起。Windows/macOS
+安装包都需要注册对应协议。用户确认后，页面以
+一次性令牌请求本地 CLI，由 CLI 调用系统协议处理器，避免浏览器直接访问自定义协议时
+出现不可定制的 Chrome/Edge 原生确认框；宿主需要返回当前会话等精确位置时，
+可在执行登录命令时增加 `--agent-return-url "<宿主提供的自定义协议 URL>"`，或注入
+`WEAVER_AGENT_RETURN_URL`。客户端协议名与 `agent_type` 不一致时也应使用该覆盖。返回
+地址只接受桌面应用自定义协议；不要传网页、脚本或
+本地文件 URL。“始终打开”偏好保存在当前本地回调地址的浏览器存储中；未识别到返回协议
+时，页面只提示用户手动返回智能体或终端。本地 CLI 打开通道默认保留 15 分钟；通道结束
+后页面会自动退回浏览器自定义协议打开方式，不直接显示网络请求错误。
+智能小 E 统一登录成功时不会经过浏览器；只有统一登录不可用并降级为桌面浏览器 OAuth 时，
+才显示“返回智能小 E”弹层。
+
 保底方式是让用户手动写入浏览器中的 `ETEAMSID`：
 
 ```text

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

@@ -43,7 +43,7 @@ cliHelp: "weaver-work-cli workflow --help"
 1. **第一轮就并行发起（关键：不要串行拆成多轮往返）**：在**同一条消息**里同时发出下列调用——
     - Read `../weaver-e10-shared/SKILL.md`（若尚未读过）；
     - `weaver-work-cli [--is-connector true] --json workflow run workflow.memoryPrompt`——该命令**无入参**；**先按本文件开头的 `--is-connector` 判据确定前缀，再直接执行**（仅"非首次对话且距上次成功读取记忆不足 6 小时"时跳过）；
-    - **查询类意图**只读 [`workflow-query.md`](references/workflow-query.md) 一份（已覆盖 `workflow.search` 与 `workflow.todoStat`，不要再读其他查询文档）；**但该文件约 108 KB / 838 行——整读会超单次读取上限被明确拒绝**（Read 单次上限约 **20,000 tokens ≈ 100 KB / 800 行**）：**首轮一次读完开头的契约段**（`offset 1 limit 244`，约 30 KB，已覆盖 Operation、全部输入参数含「大分类判定」、时间条件与「待办时间默认语义」、执行流程），其余章节（`planJson` 编排、汇报式分组骨架、渲染规则与示例）**只在需要的那一刻按它开头的「分段索引」给出的行区间补读**；查看/操作/共享/发起/修改等意图读对应那一份 reference 即可，不要顺手把查询文档也一起读；**唯一例外是批量操作**——用 `scopeCondition` 走范围驱动时要构造与 `workflow.search` 同形的查询条件，**这一轮可以同时读 [`workflow-query.md`](references/workflow-query.md) 与 [`workflow-batch.md`](references/workflow-batch.md)**（前者给条件写法，后者给 `scopeCondition`/`action` 的执行口径），其余意图仍只读对应那一份；
+    - **查询类意图**只读 [`workflow-query.md`](references/workflow-query.md) 一份（已覆盖 `workflow.search` 与 `workflow.todoStat`，不要再读其他查询文档）；**但该文件约 108 KB / 835 行——整读会超单次读取上限被明确拒绝**（Read 单次上限约 **20,000 tokens ≈ 100 KB / 800 行**）：**首轮一次读完开头的契约段**（`offset 1 limit 244`，约 30 KB，已覆盖 Operation、全部输入参数含「大分类判定」、时间条件与「待办时间默认语义」、执行流程），其余章节（`planJson` 编排、汇报式分组骨架、渲染规则与示例）**只在需要的那一刻按它开头的「分段索引」给出的行区间补读**；查看/操作/共享/发起/修改等意图读对应那一份 reference 即可，不要顺手把查询文档也一起读；**唯一例外是批量操作**——用 `scopeCondition` 走范围驱动时要构造与 `workflow.search` 同形的查询条件，**这一轮可以同时读 [`workflow-query.md`](references/workflow-query.md) 与 [`workflow-batch.md`](references/workflow-batch.md)**（前者给条件写法，后者给 `scopeCondition`/`action` 的执行口径），其余意图仍只读对应那一份；
     - **泛化待办查询**（如"今天有哪些待办"）先看上一步 `memoryPrompt` 返回的 `oaContext.smartGrouping`：`false`（低版本）→ **直接** `workflow.search`（category=todo，**不要带 `planJson`/`subCategory`**），CLI 已自带分组统计与卡片，原样渲染即结束；`true`（智能分组）→ 才追加 `workflow.todoStat` 做统计规划，再带 `planJson` 取数。**不要在 `smartGrouping` 为 `true` 之前先调 `workflow.todoStat`**——低版本必然失败（报 `todo_stat_requires_smart_mode`）白费一次调用。
    > 以上调用**互不依赖，必须并行**：串行拆轮会成倍拉长耗时。**实测基准**：一次泛化待办查询全程约 70s，其中**模型轮次占 ~95%**（每轮约 8~25s，主因是模型输出量），CLI 命令本身合计只有 1~2s。**能省一轮就省一轮**——尤其不要为"解析上一轮输出""取流程 ID"另起一轮。
     - **[`workflow-memory.md`](references/workflow-memory.md) 本步不读**——记忆读取的命令形态见上一行（**含 `--is-connector` 判据**，按它确定前缀后执行），**记忆保存的规则已在本文件「记忆保存（全局规则）」章节给全**（本轮任务结束时按那一节执行）；只有需要判断"放 `user.md` / `memory.md` / `workflow:{id}` 哪一类"或其它字段细节时，才在需要的那一刻去读它。
@@ -57,13 +57,15 @@ cliHelp: "weaver-work-cli workflow --help"
 - **全程中文**；输出时把技术术语翻译成普通用户能看懂的话（命令要求对返回内容原样输出的除外）。
 - **列表/详情最终回复 = 原样粘贴命令返回的渲染文本全文，一字不改**：**`workflow.search` 用 `finalMarkdown`**（卡片列表；`smart` 模式无顶部行）、**`workflow.detail` 用 `renderMarkdown`**（该 operation 没有 `finalMarkdown`）——两者不要混用、不要自己拼装；其中禁止出现 `<div>`/`<span>`/`style` 等 HTML 标签。
 - 只执行本 skill 列出的 operation，把命令返回的结果、提示、候选**原样呈现**；命令没做的、没返回的、查不到的，反馈用户或停止——**绝不自行发明、探测、绕过**。
+- **澄清一律不向用户索取 ID**：凡是"名称没匹配到 / 有多个候选待确认"的情形（填单、查询、转发接收人、共享对象等一律适用），只问该对象的**完整名称**或**其它可用于检索的关键词**；`名称(ID)`（或 `{id,name}` 这类结构）由你按命令返回的 `candidates` 自己拼好、重发同一条命令，**不要让用户提供 ID**。
 - 失败、超时、登录失效、业务错误一律立即停止，不自动重试、不延长等待、不切换地址、不换接口。**例外**：读操作遇登录失效时按 `weaver-e10-shared` 的认证引导处理，认证完成后重放原请求（写操作见「写操作失败处理」）。
+- **接口异常一律原样反馈给用户，禁止自行尝试解决方案**：命令返回里出现接口报错（`error.type = api`）时，把接口提示原文转述给用户、并说明本次操作**没有完成**；不得替接口解释原因，不得自行改用别的做法去绕。
 - **若决策依据了历史记忆，最终回复要说明；若本轮保存了记忆，要说明会记住什么。**
 - **不得写 agent 工具的工作日志/工程日志/对话记录**；**不读取、不处理与本任务无关的工作区引导/身份文件**（如工作区根的引导说明、身份档案等——那是别的流程负责的事，在本轮纠结它只会让任务跑偏并白白多花几秒）；不读取命令源码、不执行调试命令、不使用调试参数。
 
 ## 记忆保存（全局规则，每轮任务结束都要执行）
 
-**每轮完整实质任务结束、向用户输出最终回复之前**，必须自行判断本轮是否出现**新的、有价值的语义记忆**（例如用户新澄清/确认了具体工作流、字段名、字段选项；与已有记忆重复的不算，必填字段的填值偏好不算）：
+**每轮完整实质任务结束、向用户输出最终回复之前**，必须自行判断本轮是否出现**新的、有价值的语义记忆**（例如用户新澄清/确认了具体工作流、**字段名 / 浏览按钮字段值 / 选项字段的选项值**；与已有记忆重复的不算）：
 
 - **有** → 组装本轮「用户原始意图 + 澄清过程 + 确认结果」的消息列表，**实际调用** `weaver-work-cli [--is-connector true] --json workflow run workflow.memoryExtract --input-json '{"msgList":[{"msgRole":"user","msgValue":"…"},{"msgRole":"assistant","msgValue":"…"}],"async":true}'`（**要不要带 `workflowId` 见下一条**）：
     - **`msgList` 每项的字段名固定是 `msgRole` / `msgValue`**（按对话顺序：user 放用户原话/澄清回复，assistant 放命令返回/你的确认说明），**不要写成 `role` / `content`**；
@@ -76,8 +78,8 @@ cliHelp: "weaver-work-cli workflow --help"
 **硬禁令（违反即为没保存）**：
 
 - **不允许只在思考里写"应该保存记忆"**：判断"有"后必须**真的发出 `workflow.memoryExtract` 命令**，拿到真实 `saved` 结果后再输出最终回复。只在内心说"要保存"而不执行 = 没保存。
-- 本次发起的工作流本身、业务别名、以及本次新确认的字段口径偏好（**「字段口径」指字段名、选项含义这类语义澄清，不含单据里填了什么值；必填字段的填值偏好不算**），只要符合本节开头「新的、有价值的」判据，就属于要保存的情形，不要漏。
-- 用户澄清后确认的工作流/字段口径偏好（**指字段名、选项含义这类语义澄清，不含单据里填了什么值**）属于典型的"有价值记忆"，**属于要保存的情形**，不要漏。
+- **发起流程（`workflow.createForm` / `workflow.createRequest`）按本节更窄的口径**：本轮发起过程中，只有**用户有新的明确澄清**——① 工作流名称；② 字段名称；③ 浏览按钮字段值；④ 选项字段的选项值——才属于要保存的情形（口径见 [`workflow-create.md`](references/workflow-create.md)）；**这四类之外一律不保存**（用户只是给出普通文本 / 日期 / 金额字段的本次取值、或只是正常走完一次填单，都不算记忆），不要漏也不要多存。
+- 用户澄清后确认的**工作流名称 / 字段名称 / 浏览按钮字段值 / 选项字段的选项值**属于典型的"有价值记忆"，**属于要保存的情形**，不要漏。
 - **记忆里的别名条目写「（待确认）」时，它是一张待办、不是终态**：本轮只要把该别名唯一解析出了 `workflowId`（**`cards[].workflowId`** 或 `countDetails[].workflowId` 里就有），任务结束时**必须再保存一次把 ID 补上**（口径同上），不要放着不管。
 
 > 本节的规则已足够直接执行；仅当需要判断"放 user.md / memory.md / workflow:{id} 哪一类"或需要其它字段细节时，才去读 [`workflow-memory.md`](references/workflow-memory.md)。
@@ -125,7 +127,7 @@ cliHelp: "weaver-work-cli workflow --help"
     - **目标是一个范围（没有准确 `requestId`）** → **必须先数条数再执行**：先用 `scopeCondition`（与 `workflow.search` 同形的条件）+ `action:"total"` **只查条数**（`action` 在给了 `scopeCondition` 时**必填**，漏写报 `batch_action_required`），把「范围 + 条数」报给用户确认（`total=0` 但 `scopeTotal>0` 时要说明"有 N 条但不适用本次操作"，不能说成没有数据）。
     - **目标是一个范围、用户已确认条数** → 再用同一条 `scopeCondition` 配 `action:"execute"`；**循环由 CLI 内部完成**（查一页→执行→排除已处理/失败的 ID→再查，直到取完或触达上限），**不要自己写"查一页→数 ID→再执行"的多轮流程**。返回里给的是成功/失败条数、失败清单与 `stoppedReason`（**不含批次数等内部细节**），照它汇报即可——`scope_not_batch_eligible` 表示"范围内有数据但本次操作一条都取不到"（**不是**"没有数据"），要说明原因并给替代操作（如改 `workflow.batchRead`）。
 - 单条共享 -> `workflow.sharePrepare` -> 用户确认 -> `workflow.shareApply`。
-- 发起流程 -> `workflow.createForm`（传 `workflow`，解析可发起的工作流并拿到 `continuation`；返回 `NEEDS_CLARIFICATION` 时按 `candidates` 与用户确认后用 `名称(ID)` 重发）-> 按用户意图填 `data` -> `workflow.createRequest`（`context` 传上一步的 `continuation`，`action` 取 `draft`/`submit`）。**必填是否齐不用模型判断**：`action:"submit"` 缺必填时命令不会创建流程，返回 `NEEDS_INPUT` + `missingFields`，一次问齐后带同一 `context` 重发；`action:"draft"` 则照常建草稿、缺失项只作提醒。
+- 发起流程 -> `workflow.createForm`（传 `workflow`，**目标写法优先用 `名称(ID)`**：自带显式 ID 时不查可发起列表、少一次往返，纯名称才走可发起列表模糊匹配；解析可发起的工作流并拿到 `continuation`；返回 `NEEDS_CLARIFICATION` 时按 `candidates` 与用户确认后用 `名称(ID)` 重发）-> 按用户意图填 `data` -> `workflow.createRequest`（`context` 传上一步的 `continuation`，`action` 取 `draft`/`submit`）。**必填是否齐不用模型判断**：`action:"submit"` 缺必填时命令不会创建流程，返回 `NEEDS_INPUT` + `missingFields`，一次问齐后带同一 `context` 重发；`action:"draft"` 则照常建草稿、缺失项只作提醒。
 - 修改表单 -> `workflow.editLoad` 拿 `context` -> `workflow.editPrepare` -> 用户确认 -> `workflow.editApply`。
 
 ## 执行原则（减少误路由、误重试和无效消耗）
@@ -169,12 +171,12 @@ cliHelp: "weaver-work-cli workflow --help"
 ### 5) 命令输出读取纪律（禁止截断、禁止重复取数）
 
 - **禁止对命令输出做管道截断**：不要用 `| head`、`| tail`、`| more` 等处理 `weaver-work-cli --json ...` 的 stdout。截断会破坏 JSON，并且必然导致重复执行同一条命令（实测最常见的一条命令被执行 2 次，就是 `| head` 引起的）。
-- **一律直读 stdout（失败时读 stderr，见下条），不要落盘、不要写脚本回读**：`--json` 输出是**多行 pretty JSON**，且已按体积做过控制（`workflow.todoStat` 约 20 KB/400 余行；`workflow.search` 的条目已收窄到必要字段、泛化待办查询实测约 **14 KB**；`workflow.detail` 只有几 KB；`workflow.createForm` / `editLoad` 遇到大表单会自动改用高体积密度形态、必要时把 `fields` 移出 stdout 并给出 `resultFile`）——都在宿主单次输出上限以内，每行也都不长——**直接读即可**，不存在行长截断问题。**禁止**把 stdout 重定向到文件（`> /tmp/xxx.json`）再写脚本解析回读：它不会带来任何新信息，只会白白多出一次工具往返（实测多一轮约 +7s，占整轮耗时可观）。
+- **一律直读 stdout（失败时读 stderr，见下条），不要落盘、不要写脚本回读**：`--json` 输出是**多行 pretty JSON**，且已按体积做过控制（`workflow.todoStat` 约 20 KB/400 余行；`workflow.search` 的条目已收窄到必要字段、泛化待办查询实测约 **14 KB**；`workflow.detail` 只有几 KB；`workflow.createForm` / `editLoad` 遇到大表单会落盘、stdout **只回一条提示**（提示里直接给出可照抄的读命令））——都在宿主单次输出上限以内，每行也都不长——**直接读即可**，不存在行长截断问题。**禁止**把 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` 字段为准**，宿主界面把命令显示成"运行成功"只代表进程结束，不代表业务成功。
 - **同一个 operation 最多执行一次**：拿到 stdout 后一次性解析完，不要先截断看一眼再重跑。
-- **结果里出现 `resultFile` 时不要重跑命令**：`workflow.search`、`workflow.todoStat`、`workflow.createForm`、`workflow.editLoad` 等大输出 operation 会把完整数据落盘，并在结果**最前面**返回 `resultFile` 与 `largeOutputNotice`；需要被省略的大字段（如查询的逐条明细、某工作流的 `formFields`、通知正文 `formFieldValues` 全文、大表单的 `fields`）时，直接从 `resultFile` 里**按需提取**（只取要用的键，不要把整份读进上下文），**不要重新执行 operation**。
-- **`createForm` / `editLoad` 大表单的分流形态**（字段多时才有，字段少时就是原样全量）：输出里会多出 `persistedResult`、`outputBytes`，并二选一——① 带 `fields` 但已换成紧凑编码（`columns` 列名 + `rows` 每行一个字段、各列用 `|` 分隔，顺序同 `columns`；非列信息按字段 id 放在 `extra`，**不出现在 `extra` 里的字段即为默认值**）；② 带 `fieldsOmitted: true` + `fieldCount`，`fields` 已整体移出 stdout。两种情况都**照常继续流程**：要字段清单/某个字段的完整元数据时从 `resultFile` 提取即可，**不要因为没看到 `fields` 就重跑 createForm**。`fields` 移出时，同一份输出会补上 **`writableFields`**（可写字段索引，每行 `id|name|subFormId|componentKey|flags`，另带 `optionIndex` / `formatIndex` / `uploadLimits`）——**填 `data` 的键、日期字段的 `format`、附件字段的上传限制都直接用它**，不要再为这些去读 `resultFile`；只有它也被省略（出现 `writableFieldsOmitted`）时，才改从 `resultFile` 取。**必填不要自己推演**：OA 的联动（显示属性）规则不下发，一律按 `createRequest` 的 `missingFields` 补齐。
+- **结果里出现 `resultFile` 时不要重跑命令**：`workflow.search`、`workflow.todoStat`、`workflow.createForm`、`workflow.editLoad` 等大输出 operation 会把完整数据落盘，并在结果**最前面**返回 `resultFile` 与 `largeOutputNotice`；`workflow.search` / `workflow.todoStat` 的 stdout 已保留可用内容，被省略的大字段（如查询的逐条明细、某工作流的 `formFields`、通知正文 `formFieldValues` 全文）再**按需提取**（只取要用的键，不要把整份读进上下文）；**`createForm` / `editLoad` 则相反——stdout 里已没有任何表单属性，必须照抄提示里的读命令把该文件整份读完**，之后不要再重读。两类都**不要重新执行 operation**。
+- **`createForm` / `editLoad` 大表单超线时只回一条提示**（字段少时就是原样全量）：结果里**只有** `resultFile` / `persistedResult` / `outputBytes` / `largeOutputNotice` 四个键，**不带任何表单属性**。`largeOutputNotice` 里直接给出可照抄执行的读命令（文件路径 + `limit` = 该文件总行数），**先照抄它把文件一次读完、再继续下一步**——字段清单、必填、`initialValues` / `historyRequestData`、以及下一步要用的 `contextId` 全在那个文件里。**不要重跑本命令、不要分段读、不要用 `head`/`tail` 截断、也不要用脚本去挖文件。** 只有落盘不可用（极少见）时才返回全量并在 `largeOutputNotice` 里说明。**必填不要自己推演**：OA 的联动（显示属性）规则不下发，一律按 `createRequest` 的 `missingFields` 补齐。
 - **一次解析取全，不要把"判定"与"取 ID"拆成两次**：同一次输出里已有的信息应在同一步一并取出——例如 `countDetails[].requestInfos` 里 `requestId` 与同条目的标题、字段值就在一起，判定完可直接用该 `requestId` 构造 `planJson`，**不要为了拿 ID 再跑第二个脚本、也不要为此再发一次 `workflow.search`**。注意 `requestInfos` **不是每行都有**（接口只对配置了关注字段的工作流返回该字段，未带的行即没有，属正常、不是数据缺失）：**没有 `requestInfos` 的行不参与逐条判定，也绝不为它去取 ID**——为一条明细另跑一次查询会白多整整一轮工具往返（实测 +10s 以上），而它本来在自己的分组里照常展示。
 - **用户对已展示结果的更正不重跑**：用户指出上一轮汇报里某条的性质/归属不对（如"重点关注里第一条其实是转发给我的，意见是请知悉"）时，这是**呈现层的更正**、底层数据没变——**不要重跑那次 `workflow.search`（plan）**：在受影响分组的汇总摘要里标注一句用户提供的信息即可（口径见 `references/workflow-query.md`「渲染红线」）。**只有用户明确要求"重新出一份 / 挪到某组重出"时才重跑**，且复用上一轮那次的 `planJson`、只改受影响的分组。重跑一次 ≈ **1 轮 + 30~50s**，纯属浪费；用户表述是陈述句、看不出意图时，先问一句再动手。
 

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

@@ -888,7 +888,7 @@
     }
   },
   "artifactBaseline": {
-    "aggregateSha256": "3ca81d7b85aa07fd196cea5d127f8a68b5bfa38d7b9050644783264feeed4345",
+    "aggregateSha256": "a70b78d1893cf024dd80372667f58775830d310d20c38d8778ca21bbdf7f1e2f",
     "files": [
       {
         "path": "skills/weaver-e10-workflow/references/workflow-agent-entry.md",
@@ -897,38 +897,38 @@
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-batch.md",
-        "size": 28997,
-        "sha256": "5748b933b2be30f8bbebc51eb0ae70c6d4eed1f2a14d7c601e9c97ed8e02e808"
+        "size": 28467,
+        "sha256": "4467ec07e3b5dddd67098d0aec6818e33ac420d5408733f97708a7eadbac905a"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-create.md",
-        "size": 30764,
-        "sha256": "2b0fb5a3d1b53f7586279f4a51f8a390d02ce6c2dbc3de902602d784508741ce"
+        "size": 42157,
+        "sha256": "0c2d103baed11bd10254ef61f72ca31d3410e1de0d3ce515eafe855c823924d6"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-edit.md",
-        "size": 6304,
-        "sha256": "bab0bf3b7af9cf1b71525ed79904af1477a698be7d6c45560394246cce97a560"
+        "size": 6585,
+        "sha256": "17c233c2c6edd175f7bbc059dc1878b2a6c17154047d47ec6e88e4c38e1fee66"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-memory.md",
-        "size": 13714,
-        "sha256": "e28b9a1a4f10feb0257f7f1848fab69caef43b1713a359f235503150612c44dc"
+        "size": 13929,
+        "sha256": "70758e63429a6cbfaf7a821ad93889b384bb42c895d2082680ed0006a19d4793"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-operate.md",
-        "size": 9523,
-        "sha256": "6b7c2cc03ed3d94a0a04c74c48a394e4bd31c8f3a58143c0682b8683a5eef3fe"
+        "size": 9727,
+        "sha256": "64a87b8e70c767b6e230e910ee0668dc426124667ccb424705008ecc422710ef"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-query.md",
-        "size": 108319,
-        "sha256": "902e3cb5e24114963ad41dac652a0d46d7bc7d1d5a49eda3d9bd3ec861e9527a"
+        "size": 108743,
+        "sha256": "c5bb7942ee840b9934a08475d6d6827dc8f7801c24bab85d859c8d75cc4234f8"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-share.md",
-        "size": 6507,
-        "sha256": "3691ee1e43b1be18d41c1a6ea2a6c6a322d2dd927a8169db475590376af0b83b"
+        "size": 6750,
+        "sha256": "5a1ce6977a36a7f4aa55c8d7cae7763088b9061ecd17954e04dc769ffe300d99"
       },
       {
         "path": "skills/weaver-e10-workflow/references/workflow-view.md",
@@ -937,18 +937,18 @@
       },
       {
         "path": "skills/weaver-e10-workflow/SKILL.md",
-        "size": 39786,
-        "sha256": "3d7b2c84ad5827c5ab5dd9d85ae53b70adb669082b45b0dc023de69290c95927"
+        "size": 40794,
+        "sha256": "d33da96aec46a20a7824dd2e8c6702765bfc06d40e268c79bbe9eebbc5b1e25f"
       },
       {
         "path": "src/shortcuts/workflow/continuation.ts",
-        "size": 30337,
-        "sha256": "5e0f18be2f792dfc551ad496c787d2de68024b560e7157487a494bb080623684"
+        "size": 30700,
+        "sha256": "e5fa7d8fbf0ae334977d18c388f829b29f2bb69b6250081d2d21f68a8bac2cec"
       },
       {
         "path": "src/shortcuts/workflow/endpoints.ts",
-        "size": 8879,
-        "sha256": "1570e01906dd76b63107f8c2027ef8a8ea2a3cd8a4b75598aa4c61d4de4a8e30"
+        "size": 9589,
+        "sha256": "2ef1ea72023bb4b7941aaa258159151999983ebac3c91c1034e5ca40e1c18e89"
       },
       {
         "path": "src/shortcuts/workflow/errors.ts",
@@ -972,18 +972,23 @@
       },
       {
         "path": "src/shortcuts/workflow/operations.ts",
-        "size": 9238,
-        "sha256": "6f272f7e5828dfb7bacb557230744aec884f12299e3a5a6b1fc925ca7aaaa677"
+        "size": 9461,
+        "sha256": "50f028b494fc572637c90afeade84c0f0cc36de92a5fa355b4813125a3c6eff0"
+      },
+      {
+        "path": "src/shortcuts/workflow/operations/flow-status.ts",
+        "size": 3774,
+        "sha256": "7a7a892c1385d0d065c3ad2fdb7c8c2ba451d9ccb77f198e86edc0cc6c6f6e98"
       },
       {
         "path": "src/shortcuts/workflow/operations/form.ts",
-        "size": 225404,
-        "sha256": "4938e30cecf9d6da790325d1162f834bf85c21e8b18f1e5d5c77d9483216f947"
+        "size": 235099,
+        "sha256": "db612187d35df210c3caeaccdfd9618f20ea870c361b5a45aeec5f2434568043"
       },
       {
         "path": "src/shortcuts/workflow/operations/read.ts",
-        "size": 251625,
-        "sha256": "374e4d600dfa9b0754755c051ebfd2f4a6549a52d4cb7e78ec2b6c46c838e9e8"
+        "size": 272728,
+        "sha256": "55a8baf6cd4feef9508a13f8acc5bf3a018b31616368df90fbfc33ab93d92927"
       },
       {
         "path": "src/shortcuts/workflow/operations/registry.ts",
@@ -992,8 +997,8 @@
       },
       {
         "path": "src/shortcuts/workflow/operations/shared.ts",
-        "size": 9076,
-        "sha256": "89c1784879fb269f91de1a3fa0fb836c73ba7b0da31fe57c5781521cb4b4e663"
+        "size": 9323,
+        "sha256": "496c414e40cca8a96cb05800961e03baf6657e61ac36ea0025cd3960f1cc2c05"
       },
       {
         "path": "src/shortcuts/workflow/operations/types.ts",
@@ -1002,8 +1007,8 @@
       },
       {
         "path": "src/shortcuts/workflow/operations/write.ts",
-        "size": 141423,
-        "sha256": "17dd749ca23872888127b1576c2507dbded16284ed69d8114964ac36f75e5f97"
+        "size": 141978,
+        "sha256": "f8ca00a7096aef887bd4ed84391988589b128b8cdde2cbb043d78f0460342414"
       },
       {
         "path": "src/shortcuts/workflow/state.ts",

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

@@ -112,8 +112,6 @@ CLI 内部的循环口径（了解即可，**不要自己复刻**）：
 
 适用："批量提交 / 全部提交 / 一起提交"多条待办。入参 = `confirm: true` + `requestIds`（+ `remark` / `batchSize` / `async`）。
 
-写端点＝ **`POST /api/workflow/core/flow/batchSubmit`**（前端同款；2026-09-20 由 `/api/workflow/core/paService/v1/batchSubmit` 换过来）。请求体形态（CLI 内部拼好，**模型不需要自己构造**）：`{isMobile, isAsync, isSelectAll, conditionId, batchSubmitListParams, requestIds, operateUserIds, remark, handWrittenSign}`，其中 `batchSubmitListParams` 是一段 **JSON 字符串**（内含 `params` 查询上下文与 `searchParams.formDatas` 的空壳条件），`requestIds`/`operateUserIds` 为逗号分隔串。响应是**统一的逐条结果结构**（`data.submitResult[]` 含 `status`/`requestId`/`requestName`/`resultMessage`/`data.requestNameTitle`，另有 `data.failMsg` 映射与 `data.operateId`）——CLI 已按它算成功/失败条数与 `failures`。
-
 返回 `readCount`、`submittedCount`、`skippedRequestIds`（**CLI 本地判定**：`isRemark=100` 不可批量提交、被跳过的条目；接口本身不返回该属性）、`batchRead`、`submitResponse`；原样转述返回的结果与提示文案。
 
 ### 批量置已读 batchRead
@@ -152,7 +150,7 @@ CLI 内部的循环口径（了解即可，**不要自己复刻**）：
 | `position` | 岗位 |
 | `all` | 所有人（无 name） |
 
-名称自动转 ID；`name` 支持 `"名称(ID)"`（此时直接采用括号里的 ID、不再搜名称）。多命中返回候选列表让用户确认，禁止静默全选；0 命中报错提示核对。可选 `minSeclevel` / `maxSeclevel`（用户明确要求限制时传）。返回按每批 `addRequestShare2` 的**逐条结果**计价：`sharedCount` 只数 `data[]` 里 `result === "true"` 的条目，`result === "false"` 的进 `failures`（原因取 `msg`）。
+名称自动转 ID；`name` 支持 `"名称(ID)"`（此时直接采用括号里的 ID、不再搜名称）。多命中返回候选列表让用户确认（**只问用户完整名称或其它可用于检索的关键词，ID 由你按 `candidates` 拼好，不要向用户索取 ID**），禁止静默全选；0 命中报错提示核对。可选 `minSeclevel` / `maxSeclevel`（用户明确要求限制时传）。返回按每批 `addRequestShare2` 的**逐条结果**计价：`sharedCount` 只数 `data[]` 里 `result === "true"` 的条目，`result === "false"` 的进 `failures`（原因取 `msg`）。
 
 ### 批量转发 batchForward
 
@@ -165,7 +163,7 @@ CLI 内部的循环口径（了解即可，**不要自己复刻**）：
 | `group` | 群组 |
 | `all` | 所有人（无 name） |
 
-`name` 支持 `"名称(ID)"`（此时直接采用括号里的 ID、不再搜名称）。接收人含 `all` 时会检查系统是否允许转发给所有人；不允许则停止并提示联系系统管理员，不得去掉 all 后静默继续。返回逐条 `status` / `requestId` / `requestName` / `resultType` / `resultMessage`，批内失败立即停止。
+`name` 支持 `"名称(ID)"`（此时直接采用括号里的 ID、不再搜名称）；多命中同上——**只问用户完整姓名或其它可用于检索的关键词，ID 由你按候选拼好，不要向用户索取 ID**。接收人含 `all` 时会检查系统是否允许转发给所有人；不允许则停止并提示联系系统管理员，不得去掉 all 后静默继续。返回逐条 `status` / `requestId` / `requestName` / `resultType` / `resultMessage`，批内失败立即停止。
 
 ### 批量退回 batchReject