weaver-work-cli 0.1.25 → 0.1.28

package/skills/weaver-e10-yepiaotong/references/reim-workflow.md

@@ -1,8 +1,8 @@
 # AI 报销单自动填单 — 工作流编排
 
 > 本文件是报销自动填单的完整工作流参考。
-> CLI 命令用法见 [`invoice-reim.md`](invoice-reim.md)。
-> 实际调用通过 `weaver-work-cli --json invoice run <operation>` 执行，不能直接 curl E10 接口。
+> 发票、事前申请、预填信息等数据准备走本技能的 `weaver-work-cli --json invoice run <operation>`；**报销单的创建与修改统一走 `weaver-e10-workflow` 技能**（`workflow.createForm` / `workflow.createRequest` / `workflow.edit*`），命令契约与返回处置见 [`../../weaver-e10-workflow/references/workflow-create.md`](../../weaver-e10-workflow/references/workflow-create.md) 与 [`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md)。
+> 所有调用都必须通过 CLI 执行，不能直接 curl E10 接口。
 
 ---
 
@@ -31,21 +31,20 @@
 
 ## 报销共享常量（所有 reference 统一引用本节）
 
-以下常量在报销 reference 中多处出现，**统一以本节为准**，其余文件引用本节不再重复定义。
+以下常量在报销 reference 中多处出现，**统一以本节为准**，其余文件引用本节不再重复定义。浏览按钮类字段一律写成 `名称(ID)`。
 
 | 常量 | 值 | 说明 |
 |------|-----|------|
-| 默认合同编号 | `"20260999"` | 快速路径 `template.build`/`auto-prepare` 与手工路径统一使用；CLI 0.1.19 起未传入时自动填充并产生 warning |
-| 非出差相关客户 | `"100504500000311504"` | 泛微上海；出差流程必须由用户提供具体客户 |
-| 兜底费用科目 | `"100502270000000104"` | 其他-管理费用；所有匹配策略均未命中时使用 |
-| 人民币币种 ID | `"100001050000000001"` | — |
-| 报销方式默认值 | optionValue `"7"` | 银行（个人报销） |
+| 默认合同编号 | `"20260999"` | 用户当次未给出别的合同号时使用；表单默认值已是它时不必再传。用户给了别的合同号 → 承担主体 / 相关客户 / 相关项目以合同联动为准，见 [reim-form-fill-rules.md](reim-form-fill-rules.md#用户给了合同号以合同联动为准) |
+| 非出差相关客户 | `"泛微上海(100504500000311504)"` | 出差流程必须由用户提供具体客户 |
+| 发票金额 | 价税合计 `info.comm_info.price.total` | 报销金额字段一律填它；**不是** `price.amount` / `invoice.get` 的 `amount`（都是不含税） |
+| 兜底费用科目 | `"其他-管理费用(100502270000000104)"` | 所有科目匹配策略均未命中时使用 |
+| 人民币币种 | `"人民币(100001050000000001)"` | 明细每行必传（即使表单默认带出），否则字段联动失效，见 [reim-form-fill-rules.md](reim-form-fill-rules.md) |
+| 报销方式默认值 | `"银行（个人报销）"` | Select 传选项名；表单默认带出时不传 |
 | 全额红冲状态值 | `status = 8` | `comm_info.pro.status`；此类发票必须过滤，不允许报销 |
 | 相关凭证 typeCode | 17, 18, 57, 58 | 不能独立成行，必须与发票配对 |
-| directSuperior 取值 | `directSuperior.id` | ⚠️ **不是 `allSuperiors[0]`**（后者是上级链最高层） |
-| continuation 有效期 | 600 秒 | 过期后重新 prepare 即可，无需重新征询用户确认 |
-
-> **continuation 过期处理**：`prepare`/`auto-prepare` 签发的 continuation 有 600 秒有效期。中间若用户核对耗时过长导致过期（返回 `validation/continuation_expired`），**重新 `prepare` 后立即 `apply` 即可**（用户已确认过的内容无需重新征询）。不要重放旧 continuation。
+| 直接上级取值 | `directSuperior` | ⚠️ **不是 `allSuperiors[0]`**（后者是上级链最高层） |
+| 总部费用报销 | `总部费用报销(100003460000000060)` | 费用明细 `subFormId` = `100003690000000011`（字段清单以 `createForm` 实际返回为准） |
 
 ---
 
@@ -100,7 +99,7 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 
 ### 1. 立即获取数据，展示后确认
 
-当用户表达报销意图时（如"帮我报销"、"我要报销"、"报销一下"等），**必须立即调用 `invoice.list` 获取发票数据，展示发票汇总信息后询问用户确认，确认后再自动执行后续填单流程**。禁止反问用户要求提供发票信息、事前申请信息、报销用途等。
+当用户表达报销意图时（如"帮我报销"、"我要报销"、"报销一下"等），**必须立即调用 `invoice.list`（或 `invoice.reim.candidates.list`）获取发票数据，展示发票汇总信息后询问用户确认，确认后再自动执行后续填单流程**。禁止反问用户要求提供发票信息、事前申请信息、报销用途等。
 
 **禁止的行为：**
 
@@ -117,7 +116,7 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 - 最近一周无结果 → 自动用一个月参数再查
 - 直接调用 `invoice.reim.requests.list` 获取用户的事前申请
 - **获取到发票后，先展示发票汇总信息（张数、基础信息），明确告知用户查询范围，询问用户确认是否报销**
-- 用户确认后，自动执行匹配 → 获取表单结构 → 组装填单 JSON → `invoice.reim.flow.create.prepare` → 用户确认 → `.apply` 生成报销单
+- 用户确认后，自动执行匹配 → 载入报销表单 → 组装 `data` → `workflow.createRequest` 直接存草稿
 
 ### 2. 根据用户意图智能构建查询条件
 
@@ -128,6 +127,7 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 | "帮我报销" / "我要报销" | 查**最近一周**发票 → 无结果则查**最近一个月** → **展示发票汇总，询问确认** → 确认后走后续流程 |
 | "报销打车费" | 设置 `content="滴滴"` 筛选交通类 → **展示发票汇总，询问确认** → 确认后走后续流程 |
 | "报销上周的发票" | 设置时间范围为上周 → **展示发票汇总，询问确认** → 确认后走后续流程 |
+| "报销上周去北京的费用" / "报销去重庆的发票" | 按**出差时间 + 城市**查票（见 Step 1A「出差 / 城市意图查票」）→ **展示发票汇总，询问确认** → 确认后走后续流程 |
 | "报销发票号码 xxx" | 设置 `number="xxx"` 精确匹配 → **展示发票汇总，询问确认** → 确认后走后续流程 |
 | 用户直接提供了发票数据 | **跳过 Step 1A** → **展示发票汇总，询问确认** → 确认后继续后续流程 |
 | 用户提供了 fileId | 先调用 `invoice.reim.file-ocr.preview`（Step 0）→ **展示发票汇总，询问确认** → 确认后继续 |
@@ -150,7 +150,7 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 
 | 用户输入 | 起始步骤 |
 |----------|---------|
-| "帮我报销" | 1A → **1C（发票确认）→ 用户确认** → 1B → 2 → 2.5 → 3 → 3.5 → 4 → 5 |
+| "帮我报销" | 1A → **1C（发票确认）→ 用户确认** → 1B → 2 → 2.5 → 3 → 4 → 5 |
 | "报销打车费" / "报销上周的" | 1A（加筛选条件）→ **1C → 用户确认** → 后续同上 |
 | 提供 fileId | Step 0 → **1C → 用户确认** → 1B → 后续同上 |
 | 直接给发票数据 | **1C → 用户确认** → 1B → 后续同上 |
@@ -166,9 +166,9 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 
 > **⚠️ 禁止输出内部推理过程**。直接对用户说话，不要解释自己在做什么。
 
-#### 报销后修正（`invoice.reim.flow.update`）
+#### 报销后修正
 
-用户确认 `need_user_confirm`、补充 `unable_to_fill`、修改字段值、删除/追加明细行 → 均通过 `invoice.reim.flow.update.prepare/apply` 完成。
+用户补充缺失字段、修改字段值 → 通过 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply` 完成（Step 6）。
 
 ### 4. 自动化决策原则
 
@@ -178,7 +178,7 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 - 事前申请有数据 → 自动匹配，不需要用户确认"是否关联"
 - 事前申请为空 → 跳过匹配，直接用发票数据填单，不需要问用户
 - 匹配到唯一结果 → 直接使用，不需要用户确认
-- **只有在必须用户做选择时才暂停**（如：多候选需要选一个、发票列表为空无法继续、**出差流程必须填写相关客户**）
+- **只有在必须用户做选择时才暂停**（如：多候选需要选一个、发票列表为空无法继续、**出差流程必须填写相关客户**、话费材料不齐）；**创建报销单不再暂停确认，直接存草稿**
 - **⚠️ 严禁篡改任何原始数据值**
 
 ---
@@ -190,31 +190,32 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
          ↓
 Step 0 (可选): invoice.reim.file-ocr.preview → 识别发票
          ↓
-Step 1A: invoice.list (可跳过) ←→ Step 1B: invoice.reim.requests.list
+Step 1A: invoice.list / invoice.reim.candidates.list (可跳过) ←→ Step 1B: invoice.reim.requests.list
          ↓
 Step 1C: 展示发票汇总 → 用户确认是否报销
          ↓ (用户确认)
 Step 2: 发票 ↔ 事前申请匹配绑定 (reim-matching-rules.md)
          ↓
-Step 2.5: invoice.reim.workflow.resolve → 获取工作流ID
+Step 2.5: invoice.reim.workflow.resolve → 获取报销工作流 ID 与名称
          ↓
-Step 2.6: 按工作流ID分组（多个工作流 → 多组，各组独立执行后续步骤）
+Step 2.6: 按工作流分组（多个工作流 → 多组，各组独立执行后续步骤）
          ↓  ↓  ↓ (每组)
-  ┌──────────────────────────────────────────┐
-  │ ▼ 并行组 A（同时发起）                      │
-  │ Step 3:   invoice.reim.form.structure    │
-  │ Step 3.5: invoice.reim.row-info × N      │
-  │ Step 3.6: invoice.reim.employee-superiors │
-  │ 交通类额外: invoice.get × M               │
-  └──────────────────────────────────────────┘
+  ┌──────────────────────────────────────────────┐
+  │ ▼ 并行组 A（同时发起）                          │
+  │ Step 3:   workflow.createForm（载入报销表单）     │
+  │ Step 3.5: invoice.reim.row-info-batch          │
+  │ Step 3.6: invoice.browse-field.data（发票对象）   │
+  │ 交通类额外: invoice.get × M                     │
+  └──────────────────────────────────────────────┘
          ↓ (全部返回后)
-Step 4: 组装填单 JSON (reim-form-fill-rules.md)
+Step 4: 组装 createRequest 的 data (reim-form-fill-rules.md)
          ↓
 Step 4.5: 出差流程 → 提醒用户填写相关客户（未提供则不允许报销）
+Step 4.6: 话费报销 → 核对材料并按标准核算实报金额
          ↓
-Step 5: invoice.reim.flow.create.prepare → 用户确认 → .apply → 展示汇总
+Step 5: workflow.createRequest（action 固定 draft，直接存草稿，不问用户）→ 原样展示 finalMarkdown
          ↓
-Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
+Step 6 (可选): workflow.editLoad / editPrepare / editApply → 用户修正
 ```
 
 ### ⚡ 并行调用策略（必须遵守）
@@ -222,11 +223,10 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 | 并行组 | 可并行的操作 | 说明 |
 |--------|------------|------|
 | **Step 1 并行** | `invoice.reim.requests.list` 与 Step 1C 发票展示 | 用户确认期间预取事前申请 |
-| **Step 3 并行** | `form.structure` + `row-info` × N + `employee-superiors` + `invoice.get` × M | 全部互相独立，**必须同时发起** |
-| **多张发票** | 多张发票的 `row-info` | 各发票独立，强制并行 |
+| **Step 3 并行** | `workflow.createForm` + `invoice.reim.row-info-batch` + `invoice.browse-field.data` + `invoice.get` × M | 全部互相独立，**必须同时发起** |
 | **交通类行程** | 多张交通发票的 `invoice.get` | 各发票独立，强制并行 |
 
-> **缓存策略**：`form.structure` 和 `employee-superiors` 在同一会话、同一 workFlowId 下只需调用一次，结果可跨多组报销单复用。
+> **`createForm` 不跨组复用**：它返回的 `continuation` 与本次单据绑定，**每个报销单各调一次 `createForm`**，不能拿上一单的 `continuation` 再发起。
 
 ---
 
@@ -248,7 +248,12 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 
 > **如果用户已提供发票数据或已通过 Step 0 获取，则跳过此步骤。**
 
-通过 `invoice.list` 查询。
+两种方式任选其一：
+
+| 方式 | 适用 | 说明 |
+| --- | --- | --- |
+| `invoice.reim.candidates.list` | 按日期范围批量报销（推荐） | 自动翻页、自动过滤红冲票，并把发票分成 `available`（可报）/ `assigned`（已挂单）两组；**只从 `available` 里选**。见 [reim-api-reference.md](reim-api-reference.md#1b-报销候选发票分类) |
+| `invoice.list` | 按关键词 / 号码 / 类型筛选 | 需自己过滤红冲票 |
 
 ### 默认查询策略（用户未指定日期时）
 
@@ -258,6 +263,26 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 4. 有结果 → Step 1C 展示汇总，告知"最近一周没找到，已扩大到一个月"
 5. 仍无结果 → 告知用户未找到发票，建议指定日期范围
 
+### 出差 / 城市意图查票
+
+用户提到了去某个城市（「去北京」「重庆的发票」）时，**不能只按开票日期筛**：出差的票常在回来后才开，用户说的"上周"是出差时间，不是开票时间。
+
+1. **时间范围（开票日期 `date_begin` / `date_end`）**
+   - 用户说了出差时间（「上周」「10月12日到15日」）→ 从**出差开始日**查到**今天**
+   - 没说时间 → 最近一个月；没有与该城市相关的票 → 扩到最近 90 天
+2. **按城市逐张筛**（不按 `content` 关键词筛，城市不在消费内容里）：
+
+   | 发票 | 怎么判断与目的城市相关 |
+   | --- | --- |
+   | 火车票 / 机票 | 出发站或到达站所在城市是目的城市（列表项带 `from` / `to` 时直接用，没有再调 `invoice.get`）；站名换成城市（「北京南」→ 北京） |
+   | 酒店 / 餐饮 | 销方名称或地址里的城市 |
+   | 打车 / 网约车 | 销方名称里的城市（「重庆滴滴出行科技有限公司」→ 重庆）；或行程单起止点所在城市 |
+   | 其他 | 销方名称或地址里的城市；判断不了的不算相关 |
+
+3. **按出差时间再筛一次**：用户说了出差时间时，火车票 / 机票的乘车日期、酒店入住日期要落在出差时间内（前后各放宽 1 天）；打车票和其他票只要开票日期不早于出差开始日即可。
+4. **展示**：Step 1C 只列与该城市相关的票，并说明「按 {城市}、{时间范围} 查的」。同期查到的其他票不混进来，只在表格下一句话提示「同期还有 N 张其他发票，需要一起报请告诉我」。
+5. **没有相关的票** → 明确告诉用户查了哪个时间范围、按什么条件筛的、为什么同期的票不算（如「火车票是杭州东 → 全椒」），然后停下，不要自己扩到不相关的票或无限放宽时间。
+
 ### 日期筛选参数
 
 | 参数 | 用途 | 使用时机 |
@@ -266,9 +291,9 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 | `create_tm_begin` / `create_tm_end` | 录入/创建日期范围 | 用户明确说"录入日期"/"创建日期"时 |
 
 **⚠️ 数据过滤（红冲票排除）：**
-- **快速路径**：`candidates.list` **自动过滤** `status=8` 的全额红冲发票（过滤张数在 `summary.filteredRedReversedCount` 中报告），无需手动处理。
-- **手动路径**：使用 `invoice.list` 获取发票后，**必须在进入任何后续流程前先过滤掉 `info.comm_info.pro.status == 8` 的发票**。过滤后向用户报告："已自动排除 N 张全额红冲发票"。
-- 全额红冲发票不允许报销，**两条路径都不能让红冲票进入匹配/组装环节**。
+- `candidates.list` **自动过滤** `status=8` 的全额红冲发票（过滤张数在 `summary.filteredRedReversedCount` 中报告）。
+- 使用 `invoice.list` 时，**必须在进入任何后续流程前先过滤掉 `info.comm_info.pro.status == 8` 的发票**，并向用户报告："已自动排除 N 张全额红冲发票"。
+- 全额红冲发票不允许报销，**不能让红冲票进入匹配/组装环节**。
 
 关键返回字段映射见 [reim-api-reference.md](reim-api-reference.md#1-获取发票数据)。
 
@@ -334,6 +359,7 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
   {
     "invoiceId": "INV001",
     "preApprovalId": "1298294241967177729",
+    "preApprovalName": "交通费报销-后端开发111-2026-07-25",
     "preApprovalWorkflowId": "1181057526276915214",
     "matchConfidence": "high",
     "matchReasons": ["时间范围匹配", "费用类型一致"]
@@ -341,6 +367,8 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 ]
 ```
 
+> `preApprovalName` 要保留：填「事前申请流程 / 相关流程」字段时写成 `{preApprovalName}({preApprovalId})`。
+
 ### Step 2 匹配结果展示（推荐）
 
 匹配完成后，**建议向用户展示匹配结果**，而不是静默进入下一步。展示格式：
@@ -364,9 +392,9 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 
 ---
 
-## Step 2.5: 获取报销单工作流ID
+## Step 2.5: 获取报销单工作流
 
-通过 `invoice.reim.workflow.resolve` 获取。
+通过 `invoice.reim.workflow.resolve` 获取报销工作流的 `workFlowId` 与 `workFlowName`（Step 3 用 `{workFlowName}({workFlowId})` 载入表单）。
 
 **⚠️ 核心逻辑：当存在多个工作流时，需要将发票/事前申请按工作流分组，每组各创建一个报销单。**
 
@@ -388,75 +416,114 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 
 ---
 
-## Step 3: 获取报销单表单字段结构
+## Step 3: 载入报销表单（`workflow.createForm`）
 
-通过 `invoice.reim.form.structure` 获取。
+调用 `weaver-e10-workflow` 的 `workflow.createForm`，`workflow` 传 Step 2.5 得到的 `{workFlowName}({workFlowId})`（带 ID 时 CLI 不查可发起列表，直接载入）：
 
-> **可缓存**：同一 workFlowId 下只需调用一次。
+macOS/Linux（bash/zsh）：
 
-返回 `mainFields`（主表）和 `subTables`（明细表），每个字段含 `fieldId`、`fieldName`、`fieldType`、`single`、`marked`、`options`。
+```bash
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
+```
 
-> 完整返回示例见 [reim-api-reference.md](reim-api-reference.md#3-获取报销单表单字段结构)
+Windows PowerShell：
 
----
+```powershell
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
+```
+
+> ⚠️ **AI 报销调用 `createForm` 时不传 `userQuestion`**（`workflow-create.md` 里「强烈建议每次都传」**不适用于报销**），也**不用 `workflow.createRequestDirect`**（一步发起）。
+> 传了 `userQuestion` 会让流程侧的智能填参按用户原话算 `data`：发票字段只给 `"invoice"` 占位符、承担主体会按用户口述填（与「合同联动为准」冲突）、不会逐行传币种、标题和费用说明也不按本技能格式；同时 `historyRequestData` 不再返回。报销的 `data` 一律按本技能 Step 4 的规则自己组装。
+> 万一返回里还是带了 `data`（例如别的环节传了 `userQuestion`），**忽略它**，照常按 Step 4 组装；此时没有 `historyRequestData`，费用承担公司交给 `missingFields` 提醒。
+
+从返回里取：
 
-## Step 3.5: 获取发票预填信息（`invoice.reim.row-info`）
+| 返回键 | 用途 |
+| --- | --- |
+| `continuation`（= `contextId`） | Step 5 `createRequest` 的 `context` |
+| `fields` | **可写字段全集**：按 `name` 找业务字段取 `id`；带 `subFormId` 的是明细字段；带 `initialValue` 的有默认值 |
+| `requestName` | 表单默认标题（报销单标题按 [reim-form-fill-rules.md](reim-form-fill-rules.md#流程标题requestname) 生成后用 `requestName` 参数覆盖） |
+| `historyRequestData` | 只用于本技能规则没覆盖的字段（如费用承担公司），口径见 `workflow-create.md`「历史流程数据参考规则」；**只有不传 `userQuestion` 时才返回** |
+| `workflowMemory` | 该工作流的记忆（可能没有这个键）；只能补本技能规则没覆盖的非必填字段，与本技能规则冲突时以本技能为准 |
+
+- `NEEDS_CLARIFICATION`（`workflow_not_exist` / `no_create_right`）→ 按 `workflow-create.md` 如实告知用户，停止本组。
+- 大表单超线（stdout 只有一句话 + `resultFile`）→ 按 `workflow-create.md` 读一次 `resultFile`，不要重跑。
+- **不再需要** `invoice.reim.form.structure`、`invoice.reim.field.search`：字段清单由 `createForm` 给出，浏览按钮的名称 → ID 由 `createRequest` 解析。
 
-通过 `invoice.reim.row-info` 获取。
+---
 
-> **⚠️ 多张发票的 row-info 调用必须并行发起。**
+## Step 3.5: 获取发票预填信息（`invoice.reim.row-info-batch`）
 
-- 入参：`cdzt`=当前用户ID，`requestid`=事前申请ID（无则留空），`invoiceId`=发票ID
-- 返回的 `date`、`fysm`、`itinerary`、`subjectId` **在 Step 4 中优先使用**
-- 某字段返回空/null → 回退到 AI 推断逻辑
+- 入参：`invoiceIds`=本组全部**发票**（不含凭证）ID，`requestid`=匹配到的事前申请 ID（无则留空）
+- 返回的 `date`、`fysm`、`itinerary`、`subjectId`、`subjectName` **在 Step 4 中优先使用**
+- 某张失败或字段为空 → 该行回退到 AI 推断逻辑
+- `itineraryData`（行程单逐段明细）**暂不拆行**，仍一张发票一行，见 [reim-form-fill-rules.md](reim-form-fill-rules.md#4-行程单多段行程暂不拆行)
 
 ### 交通类发票额外处理
 
-交通类发票（`expenseType` 含交通/出行/打车，或 `consumeContent` 含客运服务费/运输服务，或 `sellerName` 含滴滴/享道等）→ **额外并行调用 `invoice.get`** 获取出发地和目的地。
+交通类发票（`expenseType` 含交通/出行/打车，或 `consumeContent` 含客运服务费/运输服务，或 `sellerName` 含滴滴/享道等），以及出差报销里的火车票 / 机票 → **额外并行调用 `invoice.get`** 获取出发地和目的地。`invoice.get` 取不到起止点时，用行程单 `itineraryData` 兜底。
 
-> 详细精简规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md#地名精简规则)
+> 费用说明统一写 `起点-终点`，规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md#行程--出差费用说明)
 
 ---
 
-## Step 3.6: 获取当前人员及上级信息
+## Step 3.6: 取发票对象（`invoice.browse-field.data`）
+
+发票字段（`EinvoiceComponent`）只接受发票对象，不接受文本或裸 ID。把本组所有**发票** + 已确定的**配对凭证**的 `fid` 一次传入：
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
+```
+
+Windows PowerShell：
 
-通过 `invoice.reim.employee-superiors` 获取。
+```powershell
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
+```
 
-> **可缓存**：同一会话只需调用一次。
+> `row-info` 的 `itinerary` 要等 Step 3.5 返回后才知道。为了不串行，Step 3 并行组里先只传发票 + AI 已配对的凭证；`itinerary` 返回了新的凭证 ID 时再补调一次，只传新增的 `fids`。
 
-- `directSuperior.id` → "报销人上级" + "承担人直接上级"（⚠️ 必填。**注意不是 `allSuperiors[0]`** —— `allSuperiors[0]` 是上级链最高层，与直接上级不是同一人）
-- `allSuperiors` 全部 `id` 逗号拼接 → "承担人所有上级"（⚠️ 必填）
+> 发票都来自用户已确认的票夹，属于 `workflow-create.md` 里"指名从票夹取"的情形，**不需要**上传提醒。
 
 ---
 
-## Step 4: 组装填单结构化 JSON
+## Step 3.7（兜底）: 当前人员及上级（`invoice.reim.employee-superiors`）
 
-> **详细填单规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md)**
-> **费用科目匹配规则见 [reim-expense-subject-rules.md](reim-expense-subject-rules.md)**
->
-> **⚠️ 费用类型（科目）字段必须有值。匹配不到时直接填兜底值 `"100502270000000104"`。**
-> **⚠️ 合同编号固定填 `"20260999"`**（除用户当次明确给出别的合同号）：主表 `合同号(100003720000001376)` 不能留空、不能放进 `unable_to_fill`；走快速路径 `template.build`/`auto-prepare` 时同样必须显式传 `contractNo`，否则该字段静默缺失。口径见 [reim-form-fill-rules.md](reim-form-fill-rules.md) 主表字段映射。
-> **⚠️ 出差流程相关客户规则见 Step 4.5。**
-> **⚠️ 话费补贴 / 话费报销必须遵守 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md)，见 Step 4.6。**
+承担主体、报销人上级等人员字段通常由表单默认值带出，**默认不调用**。只有以下情况才调用一次（同一会话可复用）：
+
+- `fields` 里承担主体 / 申请人 / 报销人上级等字段**没有 `initialValue`**；或
+- `createRequest` 的 `missingFields` 列出了这些字段。
+
+取值：当前人员 → `{currentEmployee.name}({currentEmployee.id})`；直接上级 → `{directSuperior.name}({directSuperior.id})`（**不是 `allSuperiors[0]`**）；所有上级 → `allSuperiors` 每项的 `名称(ID)`。
+
+---
+
+## Step 4: 组装 `createRequest` 的 `data`
 
-核心结构概览：
+> **详细填值规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md)**
+> **费用科目匹配规则见 [reim-expense-subject-rules.md](reim-expense-subject-rules.md)**
 
 ```json
 {
-  "work_flow_id": "报销流程工作流ID（Step 2.5）",
-  "mainFormId": "主表formId（Step 3）",
-  "request_name": "流程标题",
-  "main_fields": [{"fieldId": "...", "value": "...", "fieldName": "..."}],
-  "detail_rows": [{"dataIndex": 1, "subFormId": "...", "invoiceId": "...", "fields": [...]}],
-  "need_user_confirm": [],
-  "unable_to_fill": []
+  "main": {"<主表字段id>": "<值>"},
+  "details": {"<费用明细subFormId>": [{"<明细字段id>": "<值>"}]}
 }
 ```
 
 **关键约束：**
-- **发票 vs 相关凭证分类**：`invoiceTypeCode` 为 17/18/57/58 的是相关凭证，不能独立成行，必须与对应发票配对放在同一行明细中
-- 每行 `fields` 中有两个 `EinvoiceComponent` 字段：`single=false` 填**发票** `invoiceId`，`single=true` 填**配对凭证** `invoiceId`
-- `dataIndex` 从 1 递增，`subFormId` 用「费用明细」表的（按名称定位明细表，**不要机械取 `subTables[0]`** —— 总部费用报销的 `subTables[0]` 是「外包订单」，「费用明细」`100003690000000011` 排第 3）
+- **⚠️ `createRequest` 必传 `requestName`**：按 [reim-form-fill-rules.md](reim-form-fill-rules.md)「流程标题」公式生成，**禁止留用表单默认标题**（不传会静默留用「{流程名}-{申请人}-{日期}」默认值，无任何提示）
+- **⚠️ 主表必填「报销事由」**：按 [reim-form-fill-rules.md](reim-form-fill-rules.md)「报销事由」公式生成写入 `data.main`，**禁止留空**
+- 键只取 `createForm` 的 `fields[].id`；`fields` 里没有的字段不传，带默认值且不需改写的字段不传（例外：明细「币种」每行必传）
+- 浏览按钮写 `名称(ID)`；Select 写选项名；发票字段写 `[发票对象]`
+- 一张发票一行；相关凭证（17/18/57/58）放进配对发票那一行，每行最多 1 张
+- 行程单有多段行程也**不拆行**
+- 有行程单 / 交通类 / 出差报销的明细，费用说明写精简后的 `起点-终点`：**整串最多 1 个 `-`、不含 `|` 和空格**，禁止原样填 `大道|重庆财经学院-西门 - 鱼胡路-地铁站` 这类原始地址
+- **费用类型（科目）每行必须有值**，匹配不到填 `"其他-管理费用(100502270000000104)"`
+- **合同号固定 `"20260999"`**（除用户当次明确给出别的合同号）；表单默认值已是它时不必传
+- **用户给了合同号 → 承担主体、相关客户、相关项目都不传，以合同联动为准**（用户口头指定的承担主体也不传）；创建后从 `linkageResult` 读出实际带出的值告诉用户
+- **⚠️ 出差流程相关客户规则见 Step 4.5；话费报销规则见 Step 4.6。**
 
 ---
 
@@ -466,10 +533,11 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 > 完整规则见 [reim-form-fill-rules.md - 出差流程相关客户](reim-form-fill-rules.md#出差流程相关客户硬拦截)。
 
 简要规则：
+- 用户给了合同号 → 相关客户由合同联动带出，不拦截
 - `workFlowName` 或 `requestname` 含「差旅」「出差」→ 暂停，提醒用户提供具体客户名称
-- 用户给出客户名称 → `invoice.reim.field.search` 搜索 ID → 填入主表和明细
-- 用户拒绝 / 不提供 → **结束报销，禁止调用 `invoice.reim.flow.create.prepare`**
-- 非出差流程：相关客户固定填 `"100504500000311504"`
+- 用户给出客户名称 → 原样填进「相关客户」，由 `createRequest` 解析；多候选/查不到按 `workflow-create.md` 的浏览按钮口径处理
+- 用户拒绝 / 不提供 → **结束报销，禁止调用 `workflow.createRequest`**
+- 非出差流程：相关客户固定填 `"泛微上海(100504500000311504)"`
 
 ---
 
@@ -483,103 +551,73 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 - 必须提供本人实名制当月手机账单截图及账单构成
 - 必须确认岗位对应月度上限（350 / 200 / 100），禁止猜测岗位
 - 剔除手机设备赠送套餐、家庭宽带套餐后，实报金额 = `min(可报销账单金额, 上限)`
-- 低于标准按实际支付，超过上限按上限支付
-- 材料不齐 / 岗位未确认 / 用户拒绝 → **结束报销，禁止调用 `invoice.reim.flow.create.prepare`**
+- 材料不齐 / 岗位未确认 / 用户拒绝 → **结束报销，禁止调用 `workflow.createRequest`**
 
 ---
 
-## Step 4.7: 预览展示规则 —— 字典类 ID 必须带中文名
-
-> **向用户展示单据预览、汇总、确认清单时，凡是字典/选择类 ID 值，一律渲染成 `中文名(ID)`，禁止只给裸 ID。**
-> 用户要靠中文名核对金额、科目、上级和客户；裸 ID 无法复核，属于无效展示。
+## Step 5: 直接存草稿（`workflow.createRequest`，`action:"draft"`）
 
-### 优先：直接用 CLI 已渲染好的展示字段（快速路径 / `auto-prepare` / `template.build`）
-
-`invoice.reim.template.build` 与 `invoice.reim.flow.create.auto-prepare` 的返回已包含渲染完成的展示数据。**返回里有 `preview.mainFields` / `labels` 就直接用，不要再自己调 `field.search` / `row-info` 查名。**
-
-| 返回字段 | 内容 | 怎么用 |
-| --- | --- | --- |
-| `preview.mainFields[]` | `{ fieldId, fieldName, value \| optionValue, text }` | **主表预览直接读 `text`**。人员/客户渲染成 `温明刚(6490972696771260615)`；选择类渲染成 `银行（个人报销）(optionValue=7)`；逗号列表（承担人所有上级）逐项带名 |
-| `preview.detailRows[]` | `{ dataIndex, invoiceId, invoiceNumber, amount, expenseNote, subject, currency }` | **明细表预览直接读 `subject` / `currency`**，已带中文名 |
-| `labels` | `employees` / `subjects` / `currencies` / `customers` / `selectOptions` / `customer` / `detailSubForm` / `workflow` | 需要自己拼其它展示时取字典 |
-| `labels.unresolved`、`preview.unresolvedLabels` | 未取到中文名的 ID 清单 | 非空时按下方兜底口径如实展示，并放进 `need_user_confirm` 提醒用户核对 |
+> **⚠️ AI 报销一律存草稿，组装完 `data` 直接调用，不展示「存草稿 / 提交审批」让用户选，也不再等创建前确认。** 草稿不进审批，用户在 E10 里核对后自己提交。
+> - `action` 固定 `"draft"`，**不要传 `"submit"`**——即使用户说了「提交」，本流程也只建草稿，并在回复里告诉用户去 E10 页面核对后提交。
+> - **`requestName` 必传**（按「流程标题」公式生成）、**`data.main` 必含「报销事由」**（按「报销事由」公式生成）——两者不传会静默留用表单默认标题 / 留空，且无 warning。
+> - 用户在 Step 1C 已确认过用哪些发票；之后匹配、组装、创建一路自动执行。
+>
+> **以下拦截仍然有效（未满足前禁止调用）：**
+> - **出差流程**：相关客户未由用户提供具体信息（或合同联动带出）前，禁止调用。
+> - **话费报销**：账单截图、账单构成或岗位标准未确认前，禁止调用。
 
-相关客户只给名称也能用：传 `relatedCustomerName`（不传 ID 时 CLI 会自动反查 ID；ID 与名称同时传则不额外请求，只用于渲染）。
+### 5.1 创建
 
-### 兜底：返回里没有上述字段时（旧版 CLI、或手工组装路径）按来源表自查
+macOS/Linux（bash/zsh）：
 
-| 展示项 | 中文名来源 | 兜底 |
-| --- | --- | --- |
-| 费用类型（科目） | `invoice.reim.row-info` 的 `subjectName`（与 `subjectId` 同源，**同一行数据直接取**） | 用 `reim-expense-subject-rules.md` 查找表反查；仍无则保留 `未知科目(ID)` |
-| 币种 | `invoice.reim.row-info` 的 `bz[].name` | `人民币(100001050000000001)` |
-| 申请人 / 提单人员 / 承担主体 | `invoice.reim.employee-superiors` 的 `currentEmployee.name` | — |
-| 报销人上级 / 承担人直接上级 | 同命令 `directSuperior.name` | — |
-| 承担人所有上级 | 同命令 `allSuperiors[].name`，按原顺序逗号拼接，**每个都带 ID** | — |
-| 报销方式等 Select 字段 | `invoice.reim.form.structure` 主表该字段 `options` 里 `optionValue` → `optionName` | 保留 `optionValue=7` |
-| 相关客户 | `invoice.reim.field.search` 返回项的 `name` | 见下方警告 |
-
-⚠️ **相关客户无法用 ID 反查**（实测）：`invoice.reim.field.search` 把待查的那个 ID 当 `keywords` 传，一律返回 `[]`（例如 `keywords="100504500000311504"` → 空）。必须改用**关键词模糊搜索**再按 `id` 匹配：
-
-```text
-keywords="泛微"  →  命中 {"name":"泛微上海","id":"100504500000311504"}
+```bash
+weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create-request.json
 ```
 
-关键词取不准时按 2-3 个候选词依次试（公司字号、简称）；仍查不到就显示 `未知来源(100504500000311504)` 并放进 `need_user_confirm` 让用户核对，**禁止编造名称**。
+Windows PowerShell：
 
-展示格式示例：
-
-```markdown
-| 项目 | 值 |
-| --- | --- |
-| 相关客户 | 泛微上海(100504500000311504) |
-| 报销人上级 / 承担人直接上级 | 温明刚(6490972696771260615) |
-| 承担人所有上级 | 熊学武(8005823778783571762), 章宏武(4270809363797382452), 周军锋(9080972482706531342), 温明刚(6490972696771260615), 韦利东(8005823776035471761) |
-| 报销方式 | 银行（个人报销）(optionValue=7) |
-| 费用科目（每行） | 日常消费(1256664958132969489) |
+```powershell
+weaver-work-cli --json workflow run workflow.createRequest --input .\reim-create-request.json
 ```
 
-纯数值/文本字段（金额、日期、张数、费用说明）保持原样，不加 ID。
-
----
-
-## Step 5: 生成报销单流程
-
-通过 `invoice.reim.flow.create.prepare` → 用户确认 → `invoice.reim.flow.create.apply` 完成。
-
-> **⚠️ 禁止重复调用：同一组发票数据只能调用一次。调用成功后，修改已创建的报销单使用 Step 6 的 update。**
-> **⚠️ 出差流程拦截：相关客户未由用户提供具体信息前，禁止调用。**
-> **⚠️ 话费报销拦截：账单截图、账单构成或岗位标准未确认前，禁止调用。**
-
-### 创建成功后
+`reim-create-request.json` 的内容：
 
-CLI 返回 `requestId` 和 `viewUrl`，**用结构化汇总信息展示给用户**（链接用 CLI 返回的 `viewUrl`，不要自己拼接）：
+```json
+{
+  "context": "<Step 3 createForm 返回的 continuation>",
+  "requestName": "龚为明7月上海交通费报销",
+  "action": "draft",
+  "data": {
+    "main": {"100003720000000088": "上海市内交通费（滴滴出行）", "100003720000000687": "泛微上海(100504500000311504)"},
+    "details": {"100003690000000011": [{"100003720000016373": "108.2", "100003720000052200": "人民币(100001050000000001)"}]}
+  }
+}
+```
 
-```markdown
-✅ 报销单创建成功！
+> `data` 含发票对象，体积较大，建议写成 UTF-8 文件用 `--input <path>` 传入。
 
----
+### 5.2 返回处置
 
-**报销标题**：交通费报销-后端开发111-2026-08-04（共2笔）
-**报销事由**：2026-07-30 市内交通 - 滴滴出行
-**汇总金额**：¥185.80
-**查看链接**：[点击查看报销单](viewUrl)
+**完全按 `workflow-create.md`「createRequest 返回后的处置」执行**：
 
-| # | 发票号码 | 发票金额 | 费用类型 | 发生地点 | 关联凭证 |
-|---|----------|----------|----------|----------|----------|
-| 1 | 36901189 | ¥108.20 | 市内交通 | 仁济医院南院→浦江瑞和城 | ✅ 已关联 |
-| 2 | 36901200 | ¥77.60 | 市内交通 | 虹桥机场T2→人民广场 | ❌ 无凭证 |
+| 返回 | 处置 |
+| --- | --- |
+| `CREATED` | **原样粘贴 `finalMarkdown`**，一字不改；链接只出现在回复文本里。之后按需补几句：合同联动带出的值与用户口述不同、未挂上 / 未配对的凭证、话费核算明细、`missingFields` 提交前要补的字段 |
+| `BROWSER_FILL`（小e 环境） | **没有写服务端、没有 `requestId`**：把 `finalMarkdown`（一段 `<browsertool>` 标签块）**整段原样输出**作为回复正文，不包代码块、不加任何前后说明，也不补上面那几句提醒；由页面打开新建页带入字段值，用户在页面上保存。之后**不要走 Step 6**（没有可改的单据） |
+| `NEEDS_INPUT` | 缺的是承担主体、上级、合同号、相关客户、科目等本技能有规则的字段 → 按 [reim-form-fill-rules.md](reim-form-fill-rules.md) 补值后用同一 `context` 重发；其余原样粘贴 `finalMarkdown` 一次问齐用户 |
+| `NEEDS_CONFIRMATION` | 按 `ambiguities` 处理（浏览按钮多候选让用户选；`MULTIPLICITY` 只保留 1 个值） |
+| `partial` / `write_uncertain` | 停止，不重放；只读回查一次后告知用户 |
 
----
-```
+> **⚠️ 禁止重复创建**：同一组发票 `createRequest` 成功后，**不要再次 `createForm` + `createRequest`**；修改一律走 Step 6。
 
 ---
 
-## Step 6（可选）: 更新报销单流程
+## Step 6（可选）: 修改已创建的报销单
 
-通过 `invoice.reim.flow.update.prepare/apply` 完成。
+通过 `weaver-e10-workflow` 的 `workflow.editLoad`（传 Step 5 返回的 `requestId`）→ `workflow.editPrepare`（`data` 写法同 Step 4，只传要改的字段）→ 用户确认 → `workflow.editApply`。详见 [`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md)。
 
-- 支持 `deleteDetailRows` + `main_fields` + `detail_rows` 三种操作组合
-- 删除先于更新执行，删除失败不阻断更新
+- 流程已流转到不可编辑节点时 `editApply` 返回"失去操作权限"，如实转述
+- 只读字段会被拒绝（`notEditable`），如实转述，不要换字段 id 绕过
 
 ---
 
@@ -589,26 +627,27 @@ CLI 返回 `requestId` 和 `viewUrl`，**用结构化汇总信息展示给用户
 - 发票列表为空 → 提示"未找到未报销的发票"，结束
 - 出差/差旅流程缺少相关客户 → 见 Step 4.5
 - 话费报销缺少账单截图、账单构成或岗位标准 → 见 Step 4.6
-- 模糊搜索返回多结果 → 放入 `need_user_confirm` 让用户选择
+- `createRequest` 返回 `NEEDS_INPUT` / `NEEDS_CONFIRMATION` 且本技能规则补不上 → 按 `workflow-create.md` 问用户
 
 **严禁重复调用：**
-- **`create.apply` 已调用成功 → 严禁再次调用，后续修改一律使用 `update`**
+- **`createRequest` 已成功 → 严禁再次创建，后续修改一律使用 Step 6**
 
 **自动继续（不问用户）：**
 - 事前申请为空 / 匹配失败 → 跳过事前关联，直接用发票填单
-- 匹配结果唯一 / 模糊搜索唯一结果 → 直接使用
+- 匹配结果唯一 → 直接使用
 
 **用户中途取消：**
 - 用户说"取消"/"不报了"/"算了" → 立即停止
-- 已调用 create 成功 → 告知用户可通过链接手动删除
+- 已创建成功 → 告知用户可通过链接手动删除
 
 ---
 
 ## 参考文档
 
-- [reim-api-reference.md](reim-api-reference.md) - 所有 CLI operation 入参与返回值
+- [reim-api-reference.md](reim-api-reference.md) - 报销数据准备 CLI operation 入参与返回值
 - [reim-matching-rules.md](reim-matching-rules.md) - 发票与事前申请匹配逻辑
-- [reim-form-fill-rules.md](reim-form-fill-rules.md) - 表单字段填充策略与填单 JSON 组装规则
-- [reim-expense-subject-rules.md](reim-expense-subject-rules.md) - 费用科目自动匹配规则（JSON 查找表）
+- [reim-form-fill-rules.md](reim-form-fill-rules.md) - `createRequest` 的 `data` 填值规则
+- [reim-expense-subject-rules.md](reim-expense-subject-rules.md) - 费用科目自动匹配规则
 - [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md) - 话费补贴 / 话费报销月度标准与实报金额
 - [reim-examples.md](reim-examples.md) - 完整端到端示例
+- [`workflow-create.md`](../../weaver-e10-workflow/references/workflow-create.md) / [`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md) - 发起与修改流程的命令契约