weaver-work-cli 0.1.24 → 0.1.26

package/skills/weaver-e10-yepiaotong/references/reim-phone-subsidy-rules.md

@@ -1,7 +1,7 @@
 # 话费补贴 / 话费报销规范（硬拦截）
 
 > **命中「话费补贴标准审批流程」或「话费报销」时必须严格执行本文件，禁止按普通发票金额直接填单。**
-> **材料不齐、岗位标准未确认、或无法拆出可报销账单金额时，禁止调用 `invoice.reim.flow.create.prepare/apply`。**
+> **材料不齐、岗位标准未确认、或无法拆出可报销账单金额时，禁止调用 `workflow.createRequest`。**
 
 ---
 
@@ -83,9 +83,9 @@
 
 | 字段 | 怎么填 |
 |------|--------|
-| 明细所有 `fieldType="Money"`（实报金额、报销金额、申请金额等） | 填本规范算出的**实报金额**，不要填发票原价 |
-| 主表申请金额 / 人民币金额 | 各行实报金额之和 |
-| 费用类型（科目） | 通讯科目 `"100502270000000010"`（`invoice.reim.row-info` 的 `subjectId` 已是通讯类时可直接用） |
+| 明细里 `createForm` 返回的可写金额字段（申请金额等；实报金额、人民币金额不可写，不传） | 填本规范算出的**实报金额**，不要填发票原价 |
+| 主表金额字段（仅当出现在 `createForm` 的 `fields` 里时才传） | 各行实报金额之和 |
+| 费用类型（科目） | 通讯科目，写成 `"{科目名称}(100502270000000010)"`（`invoice.reim.row-info` 的 `subjectId` 已是通讯类时可直接用，名称取 `subjectName`） |
 | 费用说明 | 写清所属月份、可报销账单金额、岗位上限、实报金额，例如 `2026-08话费 账单280 上限200 实报200`（禁止 `*` 号） |
 
 > 这是「金额一律填发票 `amount`」的**唯一覆盖规则**，只适用于本规范命中的话费报销。发票原始 `amount` 仍须原样保留在上下文中，不得改写发票数据本身。
@@ -145,5 +145,5 @@ cusCreateDateEnd   = 最晚发票 invoiceDate
 4. 按账单构成剔除赠送套餐、家庭宽带，算出可报销账单金额
 5. 按 `min(可报销账单金额, 上限)` 得到实报金额，展示给用户确认
 6. 查询事前申请时使用 **3 年回溯**（`cusCreateDateStart` 往前推 1095 天），用 `requestname="话费"` 缩小范围
-7. 匹配到事前申请后，用户确认，才允许进入 `invoice.reim.flow.create.prepare` → `.apply`
+7. 匹配到事前申请后，用户确认，才允许进入 [reim-workflow.md](reim-workflow.md) Step 5（预览确认 → `workflow.createRequest`）
 8. 材料不齐、岗位未确认、账单构成无法拆分、或用户拒绝 → **结束流程，禁止创建**

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,19 @@
 
 ## 报销共享常量（所有 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)"` | 出差流程必须由用户提供具体客户 |
+| 兜底费用科目 | `"其他-管理费用(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 +98,7 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 
 ### 1. 立即获取数据，展示后确认
 
-当用户表达报销意图时（如"帮我报销"、"我要报销"、"报销一下"等），**必须立即调用 `invoice.list` 获取发票数据，展示发票汇总信息后询问用户确认，确认后再自动执行后续填单流程**。禁止反问用户要求提供发票信息、事前申请信息、报销用途等。
+当用户表达报销意图时（如"帮我报销"、"我要报销"、"报销一下"等），**必须立即调用 `invoice.list`（或 `invoice.reim.candidates.list`）获取发票数据，展示发票汇总信息后询问用户确认，确认后再自动执行后续填单流程**。禁止反问用户要求提供发票信息、事前申请信息、报销用途等。
 
 **禁止的行为：**
 
@@ -117,7 +115,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. 根据用户意图智能构建查询条件
 
@@ -150,7 +148,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 +164,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 +176,7 @@ CLI 已默认 `sreim="3"`、`bill_type=0`、`page_size=10`。报销查票时只
 - 事前申请有数据 → 自动匹配，不需要用户确认"是否关联"
 - 事前申请为空 → 跳过匹配，直接用发票数据填单，不需要问用户
 - 匹配到唯一结果 → 直接使用，不需要用户确认
-- **只有在必须用户做选择时才暂停**（如：多候选需要选一个、发票列表为空无法继续、**出差流程必须填写相关客户**）
+- **只有在必须用户做选择时才暂停**（如：多候选需要选一个、发票列表为空无法继续、**出差流程必须填写相关客户**、创建前确认报销单内容）
 - **⚠️ 严禁篡改任何原始数据值**
 
 ---
@@ -190,31 +188,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 → 原样展示 finalMarkdown
          ↓
-Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
+Step 6 (可选): workflow.editLoad / editPrepare / editApply → 用户修正
 ```
 
 ### ⚡ 并行调用策略（必须遵守）
@@ -222,11 +221,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 +246,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` | 按关键词 / 号码 / 类型筛选 | 需自己过滤红冲票 |
 
 ### 默认查询策略（用户未指定日期时）
 
@@ -266,9 +269,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 +337,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 +345,8 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 ]
 ```
 
+> `preApprovalName` 要保留：填「事前申请流程 / 相关流程」字段时写成 `{preApprovalName}({preApprovalId})`。
+
 ### Step 2 匹配结果展示（推荐）
 
 匹配完成后，**建议向用户展示匹配结果**，而不是静默进入下一步。展示格式：
@@ -364,9 +370,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,27 +394,42 @@ 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)"]}'
+```
 
-## Step 3.5: 获取发票预填信息（`invoice.reim.row-info`）
+从返回里取：
 
-通过 `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`「历史流程数据参考规则」 |
+
+- `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` 解析。
+
+---
 
-> **⚠️ 多张发票的 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 推断逻辑
 
 ### 交通类发票额外处理
 
@@ -418,45 +439,59 @@ Step 6 (可选): invoice.reim.flow.update.prepare/apply → 用户修正
 
 ---
 
-## Step 3.6: 获取当前人员及上级信息
+## Step 3.6: 取发票对象（`invoice.browse-field.data`）
 
-通过 `invoice.reim.employee-superiors` 获取。
+发票字段（`EinvoiceComponent`）只接受发票对象，不接受文本或裸 ID。把本组所有**发票** + 已确定的**配对凭证**的 `fid` 一次传入：
 
-> **可缓存**：同一会话只需调用一次。
+macOS/Linux（bash/zsh）：
 
-- `directSuperior.id` → "报销人上级" + "承担人直接上级"（⚠️ 必填。**注意不是 `allSuperiors[0]`** —— `allSuperiors[0]` 是上级链最高层，与直接上级不是同一人）
-- `allSuperiors` 全部 `id` 逗号拼接 → "承担人所有上级"（⚠️ 必填）
+```bash
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
+```
+
+Windows PowerShell：
+
+```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`。
+
+> 发票都来自用户已确认的票夹，属于 `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）
+- 键只取 `createForm` 的 `fields[].id`；`fields` 里没有的字段不传，带默认值且不需改写的字段不传（例外：明细「币种」每行必传）
+- 浏览按钮写 `名称(ID)`；Select 写选项名；发票字段写 `[发票对象]`
+- 一张发票一行；相关凭证（17/18/57/58）放进配对发票那一行，每行最多 1 张
+- **费用类型（科目）每行必须有值**，匹配不到填 `"其他-管理费用(100502270000000104)"`
+- **合同号固定 `"20260999"`**（除用户当次明确给出别的合同号）；表单默认值已是它时不必传
+- **用户给了合同号 → 承担主体、相关客户、相关项目都不传，以合同联动为准**（用户口头指定的承担主体也不传）；创建后从 `linkageResult` 读出实际带出的值告诉用户
+- **⚠️ 出差流程相关客户规则见 Step 4.5；话费报销规则见 Step 4.6。**
 
 ---
 
@@ -466,10 +501,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 +519,94 @@ 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 无法复核，属于无效展示。
-
-### 优先：直接用 CLI 已渲染好的展示字段（快速路径 / `auto-prepare` / `template.build`）
-
-`invoice.reim.template.build` 与 `invoice.reim.flow.create.auto-prepare` 的返回已包含渲染完成的展示数据。**返回里有 `preview.mainFields` / `labels` 就直接用，不要再自己调 `field.search` / `row-info` 查名。**
+## Step 5: 预览确认 → `workflow.createRequest`
 
-| 返回字段 | 内容 | 怎么用 |
-| --- | --- | --- |
-| `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` 提醒用户核对 |
-
-相关客户只给名称也能用：传 `relatedCustomerName`（不传 ID 时 CLI 会自动反查 ID；ID 与名称同时传则不额外请求，只用于渲染）。
-
-### 兜底：返回里没有上述字段时（旧版 CLI、或手工组装路径）按来源表自查
-
-| 展示项 | 中文名来源 | 兜底 |
-| --- | --- | --- |
-| 费用类型（科目） | `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"}
-```
+> **⚠️ 报销单涉及金额，创建前必须先给用户看预览并取得明确确认**——这是本技能对 `workflow-create.md`「拼完 data 立即发 createRequest」的唯一加严，其余返回处置照 `workflow-create.md` 执行。
+> **⚠️ 出差流程拦截：相关客户未由用户提供具体信息前，禁止调用。**
+> **⚠️ 话费报销拦截：账单截图、账单构成或岗位标准未确认前，禁止调用。**
 
-关键词取不准时按 2-3 个候选词依次试（公司字号、简称）；仍查不到就显示 `未知来源(100504500000311504)` 并放进 `need_user_confirm` 让用户核对，**禁止编造名称**。
+### 5.1 预览（创建前）
 
-展示格式示例：
+向用户展示一次，**字典类值一律带中文名 `名称(ID)`**（`data` 里本来就是这种写法，直接照抄）：
 
 ```markdown
+即将创建报销单「交通费报销-龚为明-2026-10-21（共2笔）」，请确认：
+
 | 项目 | 值 |
 | --- | --- |
+| 报销工作流 | 总部费用报销 |
+| 报销事由 | 2026-07-30 市内交通 - 滴滴出行 |
 | 相关客户 | 泛微上海(100504500000311504) |
-| 报销人上级 / 承担人直接上级 | 温明刚(6490972696771260615) |
-| 承担人所有上级 | 熊学武(8005823778783571762), 章宏武(4270809363797382452), 周军锋(9080972482706531342), 温明刚(6490972696771260615), 韦利东(8005823776035471761) |
-| 报销方式 | 银行（个人报销）(optionValue=7) |
-| 费用科目（每行） | 日常消费(1256664958132969489) |
+| 事前申请 | 交通费报销-后端开发111-2026-07-25(1298294241967177729) |
+| 合计金额 | ¥185.80 |
+
+| # | 发票号码 | 金额 | 费用日期 | 费用类型 | 费用说明 | 相关凭证 |
+|---|----------|------|----------|----------|----------|----------|
+| 1 | 36901189 | ¥108.20 | 2026-07-30 | 市内交通费(100502270000000006) | 仁济医院南院-浦江瑞和城 | ✅ 滴滴行程单 |
+| 2 | 36901200 | ¥77.60 | 2026-07-30 | 市内交通费(100502270000000006) | 虹桥机场T2-人民广场 | — |
+
+申请人、承担主体、上级、部门、合同号、报销方式由表单按当前登录人默认带出；币种为人民币。
+请回复「存草稿」或「提交审批」；需要修改请直接告诉我。
 ```
 
-纯数值/文本字段（金额、日期、张数、费用说明）保持原样，不加 ID。
+- 有未挂上的凭证、未配对的凭证、话费核算明细时，在表格下方逐条列出
+- 用户没说清 → 默认按「存草稿」（`action:"draft"`）处理并在回复里说明
 
----
+### 5.2 创建
 
-## Step 5: 生成报销单流程
+macOS/Linux（bash/zsh）：
 
-通过 `invoice.reim.flow.create.prepare` → 用户确认 → `invoice.reim.flow.create.apply` 完成。
+```bash
+weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create-request.json
+```
 
-> **⚠️ 禁止重复调用：同一组发票数据只能调用一次。调用成功后，修改已创建的报销单使用 Step 6 的 update。**
-> **⚠️ 出差流程拦截：相关客户未由用户提供具体信息前，禁止调用。**
-> **⚠️ 话费报销拦截：账单截图、账单构成或岗位标准未确认前，禁止调用。**
+Windows PowerShell：
 
-### 创建成功后
+```powershell
+weaver-work-cli --json workflow run workflow.createRequest --input .\reim-create-request.json
+```
 
-CLI 返回 `requestId` 和 `viewUrl`，**用结构化汇总信息展示给用户**（链接用 CLI 返回的 `viewUrl`，不要自己拼接）：
+`reim-create-request.json` 的内容：
 
-```markdown
-✅ 报销单创建成功！
+```json
+{
+  "context": "<Step 3 createForm 返回的 continuation>",
+  "requestName": "交通费报销-龚为明-2026-10-21（共2笔）",
+  "action": "draft",
+  "data": {
+    "main": {"100003720000000088": "2026-07-30 市内交通 - 滴滴出行", "100003720000000687": "泛微上海(100504500000311504)"},
+    "details": {"100003690000000011": [{"100003720000016373": "108.2", "100003720000052200": "人民币(100001050000000001)"}]}
+  }
+}
+```
 
----
+> `data` 含发票对象，体积较大，建议写成 UTF-8 文件用 `--input <path>` 传入。
 
-**报销标题**：交通费报销-后端开发111-2026-08-04（共2笔）
-**报销事由**：2026-07-30 市内交通 - 滴滴出行
-**汇总金额**：¥185.80
-**查看链接**：[点击查看报销单](viewUrl)
+### 5.3 返回处置
 
-| # | 发票号码 | 发票金额 | 费用类型 | 发生地点 | 关联凭证 |
-|---|----------|----------|----------|----------|----------|
-| 1 | 36901189 | ¥108.20 | 市内交通 | 仁济医院南院→浦江瑞和城 | ✅ 已关联 |
-| 2 | 36901200 | ¥77.60 | 市内交通 | 虹桥机场T2→人民广场 | ❌ 无凭证 |
+**完全按 `workflow-create.md`「createRequest 返回后的处置」执行**：
 
----
-```
+| 返回 | 处置 |
+| --- | --- |
+| `CREATED` / `CREATED_SUBMITTED` / `CREATED_SUBMIT_FAILED` | **原样粘贴 `finalMarkdown`**，一字不改；链接只出现在回复文本里 |
+| `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 +616,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) - 发起与修改流程的命令契约