weaver-work-cli 0.1.25 → 0.1.26

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

@@ -1,6 +1,6 @@
 # 完整端到端示例
 
-> 所有操作通过 `weaver-work-cli --json invoice run <operation> --input-json '<json>'` 执行。
+> 数据准备通过 `weaver-work-cli --json invoice run <operation> --input-json '<json>'` 执行；报销单创建/修改通过 `weaver-work-cli --json workflow run workflow.createForm|createRequest|editLoad|editPrepare|editApply` 执行（`weaver-e10-workflow` 技能）。
 > 认证由 `weaver-work-cli auth` 管理，无需手动传 token/eteamsId。
 > 复杂 JSON 建议先写入 UTF-8 文件再用 `--input <path>` 传入。
 
@@ -253,7 +253,7 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
 }
 ```
 
-### Step 2.5: 获取报销单工作流ID
+### Step 2.5: 获取报销单工作流
 
 **命令：**
 
@@ -277,217 +277,172 @@ weaver-work-cli --json invoice run invoice.reim.workflow.resolve --input-json '{
   "data": {
     "requestWorkflowMap": {
       "1298294241967177729": {
-        "workFlowId": "1181057526276915214",
-        "workFlowName": "交通费报销"
+        "workFlowId": "100003460000000060",
+        "workFlowName": "总部费用报销"
       }
     }
   }
 }
 ```
 
-**决策：** 有事前申请 → 直接取 `workFlowId = "1181057526276915214"`
+**决策：** 有事前申请 → 用 `总部费用报销(100003460000000060)` 载入表单。
 
-### Step 3: 获取表单结构
+### Step 3: 并行载入表单 + 预填信息 + 发票对象
 
-**命令：**
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.form.structure --input-json '{"workflowId":"1181057526276915214"}'
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.form.structure --input-json '{"workflowId":"1181057526276915214"}'
-```
-
-**返回（简化）：**
-
-```json
-{
-  "code": 200,
-  "data": {
-    "mainFormId": "1181057741029226975",
-    "mainFields": [
-      {"fieldId": "1181057741029227445", "fieldName": "申请人", "fieldType": "Employee", "single": true, "marked": true},
-      {"fieldId": "1181057741029227446", "fieldName": "部门", "fieldType": "Department", "single": true, "marked": true},
-      {"fieldId": "1181057741029227447", "fieldName": "报销日期", "fieldType": "DateComponent", "single": true, "marked": false},
-      {"fieldId": "1181057741029227454", "fieldName": "报销方式", "fieldType": "Select", "single": true, "marked": false, "options": [
-        {"optionId": "1181057741029227903", "optionName": "银行（个人报销）", "optionValue": "7"},
-        {"optionId": "1181057741029227900", "optionName": "冲销借款", "optionValue": "4"},
-        {"optionId": "1181057741029227904", "optionName": "银行（付公司）", "optionValue": "6"}
-      ]},
-      {"fieldId": "1181057741029227456", "fieldName": "报销事由", "fieldType": "TextArea", "single": false, "marked": false},
-      {"fieldId": "1181057741029227470", "fieldName": "相关流程", "fieldType": "Workflow", "single": false, "marked": true}
-    ],
-    "subTables": [
-      {
-        "subFormId": "1181057741029227992",
-        "subFormName": "费用明细",
-        "subFields": [
-          {"fieldId": "1181057741029227449", "fieldName": "相关客户", "fieldType": "Ebuilder", "single": true, "marked": true},
-          {"fieldId": "1181057741029227450", "fieldName": "相关项目", "fieldType": "Ebuilder", "single": true, "marked": true},
-          {"fieldId": "1181057741029227459", "fieldName": "实报金额", "fieldType": "Money", "single": true, "marked": false},
-          {"fieldId": "1181057741029227463", "fieldName": "费用类型（科目）", "fieldType": "RelateBrowser", "single": true, "marked": true},
-          {"fieldId": "1181057741029227464", "fieldName": "费用说明", "fieldType": "Text", "single": false, "marked": false},
-          {"fieldId": "1181057741029227465", "fieldName": "附件数", "fieldType": "NumberComponent", "single": true, "marked": false},
-          {"fieldId": "1181057741029227467", "fieldName": "费用日期", "fieldType": "DateComponent", "single": true, "marked": false},
-          {"fieldId": "1181057741029227468", "fieldName": "相关发票", "fieldType": "EinvoiceComponent", "single": false, "marked": false},
-          {"fieldId": "1181057741029227469", "fieldName": "相关凭证", "fieldType": "EinvoiceComponent", "single": true, "marked": false}
-        ]
-      }
-    ]
-  }
-}
-```
-
-### Step 3.5: 获取预填信息 + 费用科目匹配
-
-> **自动填单时不调用 `invoice.reim.field.search`**，费用科目通过 `invoice.reim.row-info` 返回的 subjectId 或静态科目列表匹配获取。
+以下四条命令互相独立，**同时发起**。
 
-**调用 `invoice.reim.row-info` 获取预填信息：**
+**① 载入报销表单（`weaver-e10-workflow`）：**
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoiceId":"1295366637717012482","requestid":"1298294241967177729","cdzt":"1201729946891231232"}'
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoiceId":"1295366637717012482","requestid":"1298294241967177729","cdzt":"1201729946891231232"}'
-```
-
-**返回：**
-
-```json
-{
-  "code": 200,
-  "status": true,
-  "data": {
-    "date": "2026-07-30",
-    "fysm": "交通运输服务",
-    "itinerary": "",
-    "subjectId": "100502270000000006"
-  }
-}
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
 ```
 
-`invoice.reim.row-info` 返回 `subjectId = "100502270000000006"`（市内交通费）→ 直接使用。
-
-> 如果 `subjectId` 为空，则按 [expense-subject-rules.md](reim-expense-subject-rules.md) 静态科目列表匹配：
-> `sellerName` 含"滴滴" → `"100502270000000173"`；`expenseType`="市内交通" → `"100502270000000006"`；匹配不到 → 兜底 `"100502270000000104"`。
-
-### Step 4: 组装填单 JSON
+**返回（`fields` 节选，2026-10-21 真实表单）：**
 
 ```json
 {
-  "work_flow_id": "1181057526276915214",
-  "mainFormId": "1181057741029226975",
-  "request_name": "交通费报销-后端开发111-2026-08-04（共1笔）",
-  "main_fields": [
-    {"fieldId": "1181057741029227445", "value": "1201729946891231232", "fieldName": "申请人"},
-    {"fieldId": "1181057741029227446", "value": "1201729461554241537", "fieldName": "部门"},
-    {"fieldId": "1181057741029227447", "value": "2026-08-04", "fieldName": "报销日期"},
-    {"fieldId": "1181057741029227454", "optionValue": "7", "fieldName": "报销方式"},
-    {"fieldId": "1181057741029227456", "value": "2026-07-30 市内交通 - 滴滴出行", "fieldName": "报销事由"},
-    {"fieldId": "1181057741029227470", "value": "1298294241967177729", "fieldName": "相关流程"}
-  ],
-  "detail_rows": [
-    {
-      "dataIndex": 1,
-      "subFormId": "1181057741029227992",
-      "invoiceId": "1295366637717012482",
-      "fields": [
-        {"fieldId": "1181057741029227467", "value": "2026-07-30", "fieldName": "费用日期"},
-        {"fieldId": "1181057741029227459", "value": "108.2", "fieldName": "实报金额"},
-        {"fieldId": "1181057741029227463", "value": "100502270000000006", "fieldName": "费用类型（科目）"},
-        {"fieldId": "1181057741029227464", "value": "交通运输服务", "fieldName": "费用说明"},
-        {"fieldId": "1181057741029227465", "value": "1", "fieldName": "附件数"},
-        {"fieldId": "1181057741029227468", "value": "1295366637717012482", "fieldName": "相关发票"},
-        {"fieldId": "1181057741029227449", "value": "100504500000311504", "fieldName": "相关客户"}
-      ]
-    }
-  ],
-  "need_user_confirm": [],
-  "unable_to_fill": [
-    {"fieldId": "1181057741029227450", "fieldName": "相关项目", "reason": "事前申请中无相关项目信息"}
+  "status": "FORM_READY",
+  "continuation": "wc-9834fa828b86aed3",
+  "requestName": "总部费用报销-后端开发111-2026-08-04",
+  "fields": [
+    {"id": "1256786432515129369", "name": "事前申请流程", "componentKey": "Workflow", "isBrowser": true},
+    {"id": "100003720000008409", "name": "承担主体", "componentKey": "Employee", "initialValue": "后端开发111", "isBrowser": true},
+    {"id": "100003720000000088", "name": "报销事由", "componentKey": "TextArea"},
+    {"id": "100003720000000073", "name": "申请人", "componentKey": "Employee", "initialValue": "后端开发111", "isBrowser": true},
+    {"id": "100003720000001376", "name": "合同号", "componentKey": "Text", "initialValue": "20260999"},
+    {"id": "100003720000076596", "name": "报销人直接上级", "componentKey": "Employee", "initialValue": "直属主管王五", "isBrowser": true},
+    {"id": "100003720000000084", "name": "报销方式", "componentKey": "Select", "initialValue": "银行（个人报销）", "isSelect": true},
+    {"id": "100003720000000687", "name": "相关客户", "componentKey": "Ebuilder", "isBrowser": true},
+    {"id": "100003720000016373", "name": "申请金额", "subFormId": "100003690000000011", "componentKey": "NumberComponent"},
+    {"id": "100003720000000684", "name": "相关流程", "subFormId": "100003690000000011", "componentKey": "Workflow", "isBrowser": true},
+    {"id": "100003720000000360", "name": "费用类型（科目）", "subFormId": "100003690000000011", "componentKey": "RelateBrowser", "isBrowser": true},
+    {"id": "100003720000077896", "name": "相关发票", "subFormId": "100003690000000011", "componentKey": "EinvoiceComponent", "isEinvoice": true},
+    {"id": "100003720000052200", "name": "币种", "subFormId": "100003690000000011", "componentKey": "RelateBrowser", "initialValue": "人民币", "isBrowser": true},
+    {"id": "100003720000000361", "name": "费用说明", "subFormId": "100003690000000011", "componentKey": "Text"},
+    {"id": "100003720000000419", "name": "费用日期", "subFormId": "100003690000000011", "componentKey": "DateComponent"},
+    {"id": "100003720000079682", "name": "相关凭证", "subFormId": "100003690000000011", "componentKey": "EinvoiceComponent", "isEinvoice": true}
   ]
 }
 ```
 
-### Step 5: 调用 CLI 创建报销单（prepare → 用户确认 → apply）
+> 承担主体、申请人、报销人直接上级、合同号、报销方式都带 `initialValue` → **不传**。明细「币种」虽然也有默认值，但**每行必须显式传** `人民币(100001050000000001)`，否则「申请金额」联动会失效。实报金额、附件数、承担人所有上级等不在 `fields` 里 → **不传**。
 
-**第一步：prepare（将 Step 4 的 JSON 写入文件后传入）**
+**② 批量预填信息：**
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input .\reim-create.json
+weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"invoiceIds":["1295366637717012482"],"requestid":"1298294241967177729"}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
+weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"invoiceIds":["1295366637717012482"],"requestid":"1298294241967177729"}'
 ```
 
-> prepare 返回 `continuation` token 和 `preview` 摘要，展示给用户确认。
+返回 `results[0].data`：`{"date":"2026-07-30","fysm":"交通运输服务","itinerary":"1298798990831518001","subjectId":"100502270000000006","subjectName":"市内交通费"}`
 
-**第二步：用户确认后，调用 apply**
+**③ 交通类发票取行程：** `invoice.get`（`{"fid":"1295366637717012482"}`）→ `from`=「仁济医院南院区门诊部(南门)南侧」、`to`=「浦江瑞和城柒街区30号」。
+
+**④ 取发票对象：** 发票 + `itinerary` 返回的凭证一起传。
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.reim.flow.create.apply --input .\reim-create-apply.json
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.flow.create.apply --input ./reim-create-apply.json
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["1295366637717012482","1298798990831518001"]}'
 ```
 
-> apply 的 JSON 需包含与 prepare 一致的顶层报销单字段、`continuation`（prepare 返回的 token）、`confirm: true`。
+> `itinerary` 与 `browse-field.data` 同时发起时还不知道凭证 ID：先只传发票 `fid`，`row-info-batch` 返回新的凭证 ID 后再补调一次只传凭证。
 
-**返回：**
+### Step 4: 组装 `data`
 
 ```json
 {
-  "code": 200,
-  "msg": "接口返回成功",
-  "status": true,
-  "data": {
-    "requestId": "1300266422434136064"
+  "main": {
+    "1256786432515129369": "交通费报销-后端开发111-2026-07-25(1298294241967177729)",
+    "100003720000000088": "2026-07-30 市内交通 - 滴滴出行",
+    "100003720000000687": "泛微上海(100504500000311504)"
+  },
+  "details": {
+    "100003690000000011": [
+      {
+        "100003720000000419": "2026-07-30",
+        "100003720000016373": "108.2",
+        "100003720000052200": "人民币(100001050000000001)",
+        "100003720000000360": "市内交通费(100502270000000006)",
+        "100003720000000361": "仁济医院南院-浦江瑞和城",
+        "100003720000000684": "交通费报销-后端开发111-2026-07-25(1298294241967177729)",
+        "100003720000077896": [{"optionId": "1295366637717012482", "id": "1295366637717012482", "fid": "1295366637717012482", "content": "增值税电子普通发票-36901189", "...": "browse-field.data 返回的其余键原样保留"}],
+        "100003720000079682": [{"optionId": "1298798990831518001", "id": "1298798990831518001", "fid": "1298798990831518001", "content": "滴滴行程单-...", "...": "browse-field.data 返回的其余键原样保留"}]
+      }
+    ]
   }
 }
 ```
 
-**AI 展示给用户：**
+### Step 5: 预览确认 → 创建
+
+**AI 先展示预览：**
 
 ```markdown
-✅ 报销单创建成功！
+即将创建报销单「交通费报销-后端开发111-2026-08-04」，请确认：
 
----
+| 项目 | 值 |
+| --- | --- |
+| 报销工作流 | 总部费用报销 |
+| 报销事由 | 2026-07-30 市内交通 - 滴滴出行 |
+| 相关客户 | 泛微上海(100504500000311504) |
+| 事前申请 | 交通费报销-后端开发111-2026-07-25(1298294241967177729) |
+| 合计金额 | ¥108.20 |
 
-**报销标题**：交通费报销-后端开发111-2026-08-04（共1笔）
-**报销事由**：2026-07-30 市内交通 - 滴滴出行
-**汇总金额**：¥108.20
-**查看链接**：[点击查看报销单](viewUrl)
+| # | 发票号码 | 金额 | 费用日期 | 费用类型 | 费用说明 | 相关凭证 |
+|---|----------|------|----------|----------|----------|----------|
+| 1 | 36901189 | ¥108.20 | 2026-07-30 | 市内交通费(100502270000000006) | 仁济医院南院-浦江瑞和城 | ✅ 滴滴行程单 |
 
-| # | 发票号码 | 发票金额 | 费用类型 | 发生地点 | 关联凭证 |
-|---|----------|----------|----------|----------|----------|
-| 1 | 36901189 | ¥108.20 | 市内交通 | 仁济医院南院→浦江瑞和城 | ❌ 无凭证 |
+申请人、承担主体、上级、部门、合同号、报销方式由表单按当前登录人默认带出；币种为人民币。
+请回复「存草稿」或「提交审批」；需要修改请直接告诉我。
+```
 
----
+用户回复「提交审批」→ 写入 `reim-create-request.json` 并调用：
 
-⚠️ 以下字段无法自动填写，请手动补充：
-- **相关项目**：事前申请中无相关项目信息
+```json
+{
+  "context": "wc-9834fa828b86aed3",
+  "requestName": "交通费报销-后端开发111-2026-08-04",
+  "action": "submit",
+  "data": {"main": {"...": "Step 4 的 main"}, "details": {"...": "Step 4 的 details"}}
+}
+```
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.createRequest --input .\reim-create-request.json
 ```
 
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create-request.json
+```
+
+**返回 `CREATED_SUBMITTED`** → 把返回的 `finalMarkdown` **原样粘贴**作为回复（已含流程编号、链接、已填内容、明细表），不要自己重拼。
+
 ---
 
 ## 示例2：多张发票 + 有事前申请（要点说明）
@@ -503,42 +458,29 @@ weaver-work-cli --json invoice run invoice.reim.flow.create.apply --input ./reim
 当前为出差报销，必须填写相关客户。请提供本次出差对应的具体客户名称，否则无法继续报销。
 ```
 
-用户给出客户名称（如「XX科技」）→ `invoice.reim.field.search` 搜索到唯一 ID → 填入主表和明细「相关客户」→ 才允许调用 `invoice.reim.flow.create.prepare/apply`。
-用户不提供 → **不允许报销，不创建报销单**。
+用户给出客户名称（如「XX科技」）→ 直接把 `"XX科技"` 填进「相关客户」，由 `createRequest` 解析；唯一命中即可，多候选按 `ambiguities` 让用户选。用户不提供 → **不允许报销，不创建报销单**。
 
-**填单 JSON 关键点**：
+**`data` 关键点**：
 
 ```json
 {
-  "work_flow_id": "来自 invoice.reim.workflow.resolve",
-  "request_name": "北京出差报销-张三-2026-08-04（共2笔）",
-  "main_fields": [
-    {"fieldId": "...", "value": "事前申请的creatorId", "fieldName": "申请人"},
-    {"fieldId": "...", "value": "事前申请的requestid", "fieldName": "相关流程"}
-  ],
-  "detail_rows": [
-    {
-      "dataIndex": 1, "subFormId": "...", "invoiceId": "INV001",
-      "fields": [
-        {"fieldId": "...", "value": "INV001", "fieldName": "相关发票（EinvoiceComponent+single=false）"},
-        {"fieldId": "...", "value": "76.80", "fieldName": "实报金额"}
-      ]
-    },
-    {
-      "dataIndex": 2, "subFormId": "...", "invoiceId": "INV002",
-      "fields": [
-        {"fieldId": "...", "value": "INV002", "fieldName": "相关发票（EinvoiceComponent+single=false）"},
-        {"fieldId": "...", "value": "480.00", "fieldName": "实报金额"}
-      ]
-    }
-  ]
+  "main": {
+    "<事前申请流程id>": "北京出差申请-张三-2026-07-20(1299854672520364033)",
+    "<相关客户id>": "XX科技"
+  },
+  "details": {
+    "<费用明细subFormId>": [
+      {"<申请金额id>": "76.80", "<币种id>": "人民币(100001050000000001)", "<相关发票id>": [{"fid": "INV001", "...": "..."}]},
+      {"<申请金额id>": "480.00", "<币种id>": "人民币(100001050000000001)", "<相关发票id>": [{"fid": "INV002", "...": "..."}]}
+    ]
+  }
 }
 ```
 
 **要点**：
-- `dataIndex` 从 1 递增，两行 `subFormId` 相同
-- 两行都绑定同一个事前申请 requestid
-- 每行 `invoiceId` 必须同时写入 `fields` 中 `EinvoiceComponent`+`single=false` 的字段
+- 一张发票一行，数组顺序就是明细行顺序
+- 两行都绑定同一个事前申请（明细「相关流程」同值）
+- 每行「相关发票」只放该行发票的 1 个对象
 
 ---
 
@@ -548,65 +490,33 @@ weaver-work-cli --json invoice run invoice.reim.flow.create.apply --input ./reim
 
 **差异点**：
 - 候选只有1个 → 直接使用；多个 → 自动匹配最相关的
-- `相关流程`字段留空
+- 「事前申请流程」「相关流程」不传
 - 其他流程与示例1 一致
 
 ---
 
-## 示例4：模糊搜索返回多个候选
-
-> **注意：非出差流程的相关客户固定填 `"100504500000311504"`（泛微上海）。出差/差旅流程必须先让用户提供具体客户，未提供则不允许报销。以下以"相关项目"字段为例说明多候选处理。**
-
-当搜索"相关项目"字段返回多个结果时：
-
-**搜索命令：**
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"智慧园区","fieldId":"1181057741029227450","workflowId":"1181057526276915214"}'
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"智慧园区","fieldId":"1181057741029227450","workflowId":"1181057526276915214"}'
-```
-
-**返回：**
-
-```json
-{
-  "code": 200,
-  "data": [
-    {"name": "智慧园区一期", "id": "P001", "value": "P001"},
-    {"name": "智慧园区二期", "id": "P002", "value": "P002"},
-    {"name": "智慧园区运维", "id": "P003", "value": "P003"}
-  ]
-}
-```
+## 示例4：浏览按钮返回多个候选
 
-**处理方式**：该字段不放入 main_fields/detail_rows 的 fields 中，而是放入 `need_user_confirm`：
+`createRequest` 返回 `NEEDS_CONFIRMATION`，`ambiguities` 里 `kind = "BROWSER"`、`reason = "MULTIPLE_MATCHES"`（例如「相关项目」填了 `"智慧园区"`）：
 
 ```json
 {
-  "need_user_confirm": [
+  "status": "NEEDS_CONFIRMATION",
+  "ambiguities": [
     {
-      "fieldId": "1181057741029227450",
+      "kind": "BROWSER",
       "fieldName": "相关项目",
-      "dataIndex": 1,
-      "reason": "模糊搜索返回多个候选",
+      "reason": "MULTIPLE_MATCHES",
       "candidates": [
         {"id": "P001", "name": "智慧园区一期"},
-        {"id": "P002", "name": "智慧园区二期"},
-        {"id": "P003", "name": "智慧园区运维"}
+        {"id": "P002", "name": "智慧园区二期"}
       ]
     }
   ]
 }
 ```
 
-用户选择后，将选中的 `id` 作为 `value` 补充到对应的 fields 中。
+**处理方式**：把候选原样列给用户选；用户选「智慧园区一期」后，该字段改为 `{"id":"P001","name":"智慧园区一期"}`，用**同一 `context`** 重发 `createRequest`。不要向用户索取 ID。
 
 ---
 
@@ -623,134 +533,56 @@ weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"key
 
 ---
 
-## 示例6：创建后更新报销单（Step 6 update）
-
-假设 Step 5 `invoice.reim.flow.create.apply` 成功，返回 `requestId = "1250065066476052001"`。
+## 示例6：创建后修改报销单（Step 6）
 
-AI 已向用户展示可点击链接，使用 CLI 返回的 `viewUrl`。
+假设 Step 5 `workflow.createRequest` 返回 `requestId = "1300266422434136064"`，用户说"报销事由改成 7 月份上海出差交通费"。
 
-### 场景A：用户确认 need_user_confirm 中的字段
+**① 加载当前表单：**
 
-Step 5 创建时，"相关项目"字段有多个候选，放入了 `need_user_confirm`：
+Windows PowerShell：
 
-```json
-{
-  "need_user_confirm": [
-    {
-      "fieldId": "1181057741029227450",
-      "fieldName": "相关项目",
-      "dataIndex": 1,
-      "reason": "模糊搜索返回多个候选",
-      "candidates": [
-        {"id": "P001", "name": "智慧园区一期"},
-        {"id": "P002", "name": "智慧园区二期"}
-      ]
-    }
-  ]
-}
+```powershell
+weaver-work-cli --json workflow run workflow.editLoad --input-json '{"requestId":"1300266422434136064"}'
 ```
 
-用户选择了"智慧园区一期"（id=P001），调用 `invoice.reim.flow.update.prepare` → 用户确认 → `invoice.reim.flow.update.apply` 补充：
-
-> 将以下 JSON 写入 `reim-update.json`，然后执行 `weaver-work-cli --json invoice run invoice.reim.flow.update.prepare --input ./reim-update.json`，用户确认后再执行 `.apply`（传入顶层更新字段 + continuation + confirm:true）。
+macOS/Linux（bash/zsh）：
 
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1181057741029226975",
-  "detail_rows": [
-    {
-      "subFormId": "1181057741029227992",
-      "dataIndex": 1,
-      "fields": [
-        {"fieldId": "1181057741029227450", "fieldName": "相关项目", "value": "P001"}
-      ]
-    }
-  ]
-}
+```bash
+weaver-work-cli --json workflow run workflow.editLoad --input-json '{"requestId":"1300266422434136064"}'
 ```
 
-### 场景B：用户要求修改金额 + 删除第2行明细
+**② 准备修改**（只传要改的字段，字段须在 `editableFields` 里）：
 
-用户说"第1行金额改成 120 元，第2行明细删掉"：
+Windows PowerShell：
 
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1181057741029226975",
-  "deleteDetailRows": [
-    {"subFormId": "1181057741029227992", "dataIndex": 2}
-  ],
-  "detail_rows": [
-    {
-      "subFormId": "1181057741029227992",
-      "dataIndex": 1,
-      "fields": [
-        {"fieldId": "1181057741029227459", "fieldName": "实报金额", "value": "120.00"}
-      ]
-    }
-  ]
-}
+```powershell
+weaver-work-cli --json workflow run workflow.editPrepare --input-json '{"context":"<editLoad返回的context>","data":{"main":{"100003720000000088":"7月份上海出差交通费"}}}'
 ```
 
-### 场景C：用户补充 unable_to_fill 中的主表字段
-
-Step 5 创建时，"报销事由"无法自动推断：
+macOS/Linux（bash/zsh）：
 
-```json
-{"unable_to_fill": [{"fieldId": "1181057741029227456", "fieldName": "报销事由", "reason": "无法推断报销事由"}]}
+```bash
+weaver-work-cli --json workflow run workflow.editPrepare --input-json '{"context":"<editLoad返回的context>","data":{"main":{"100003720000000088":"7月份上海出差交通费"}}}'
 ```
 
-用户提供了报销事由"7月份上海出差交通费"：
+修改明细行（金额、科目、发票等）时，`data.details` 的结构与行定位以 [`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md) 为准，并对照 `editLoad` 返回的 `currentValues` 确认要改的是哪一行。
 
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1181057741029226975",
-  "main_fields": [
-    {"fieldId": "1181057741029227456", "fieldName": "报销事由", "value": "7月份上海出差交通费"}
-  ]
-}
-```
+**③ 向用户展示 `changedFields` 与 `linkageResult`，确认后保存：**
 
-### 场景D：删除某明细表全部行后重新填写
+Windows PowerShell：
 
-```json
-{
-  "requestId": 1300266422434136064,
-  "mainFormId": "1181057741029226975",
-  "deleteDetailRows": [
-    {"subFormId": "1181057741029227992", "dataIndex": -1}
-  ],
-  "detail_rows": [
-    {
-      "subFormId": "1181057741029227992",
-      "dataIndex": 1,
-      "fields": [
-        {"fieldId": "1181057741029227467", "fieldName": "费用日期", "value": "2026-07-30"},
-        {"fieldId": "1181057741029227459", "fieldName": "实报金额", "value": "108.20"},
-        {"fieldId": "1181057741029227468", "fieldName": "相关发票", "value": "1295366637717012482"}
-      ]
-    }
-  ]
-}
+```powershell
+weaver-work-cli --json workflow run workflow.editApply --input-json '{"context":"<同一context>","confirm":true}'
 ```
 
-### 返回结果
+macOS/Linux（bash/zsh）：
 
-```json
-{
-  "code": 200,
-  "status": true,
-  "msg": "更新成功",
-  "data": {
-    "requestId": "1300266422434136064",
-    "deleteDetailSuccess": true,
-    "updateFormSuccess": true
-  }
-}
+```bash
+weaver-work-cli --json workflow run workflow.editApply --input-json '{"context":"<同一context>","confirm":true}'
 ```
 
+返回 `EDIT_SAVED` 即成功。流程已流转到不可编辑节点时返回"失去操作权限"，如实转述。
+
 ---
 
 ## 示例7-10：多轮对话与组合条件（精简）
@@ -815,32 +647,37 @@ AI 操作：
 
 ---
 
+## 示例12：用户给了合同号（以合同联动为准）
+
+用户说："帮我报销一下去重庆的发票，承担主体：边宝，合同编号：20250104933"
+
+- 合同号传 `"20250104933"`；**承担主体、相关客户、相关项目都不传**（「边宝」也不传），预览里这三项写「由合同 20250104933 联动带出」
+- 创建后 `linkageResult` 返回（2026-10-21 真机）：`字段联动带出：…实报金额=50.07、承担主体=朱洪磊、相关客户=中国航空集团有限公司、合同号=20250104933、相关项目=中航集团办公平台改造及升级项目。`
+- 原样粘贴 `finalMarkdown` 后补一句：「承担主体、相关客户、相关项目已按合同 20250104933 联动带出：朱洪磊 / 中国航空集团有限公司 / 中航集团办公平台改造及升级项目；你提到的承担主体「边宝」与合同不一致，已按合同联动为准。」
+
+---
+
 ## 关键检查清单
 
-组装填单 JSON 前确认：
-
-1. [ ] `work_flow_id` 已设置（来自 Step 2.5 `invoice.reim.workflow.resolve` 返回）
-2. [ ] `mainFormId` 已设置（来自 Step 3 `invoice.reim.form.structure` 返回的 `mainFormId`）
-3. [ ] `request_name` 按规则生成，不超过30字
-3. [ ] 所有字段的 `fieldId` 来自 `invoice.reim.form.structure` 返回，不能自己编造
-4. [ ] Select 类型字段使用 `optionValue`（不是 `value`），值为选项的 optionValue
-5. [ ] 非 Select 类型使用 `value`
-6. [ ] marked=true 的字段 `value` 是数据ID，不是名称文本
-7. [ ] detail_rows 的 `dataIndex` 从 1 开始递增
-8. [ ] 每行明细的 `invoiceId` 对应正确的发票
-9. [ ] 每行明细的 `invoiceId` 同时赋值到 `fields` 中 `fieldType="EinvoiceComponent"` 且 `single=false` 的字段
-10. [ ] 模糊搜索多候选的字段放入 `need_user_confirm`
-11. [ ] 无法推断的字段放入 `unable_to_fill` 并说明原因
-11.5. [ ] **出差/差旅流程：相关客户已由用户提供具体名称并搜索到 ID；未提供则不允许调用 `invoice.reim.flow.create.prepare/apply`**
-12. [ ] 非出差流程：相关客户填固定值 `"100504500000311504"`
-
-调用 `invoice.reim.flow.update.prepare/apply` 前确认：
-
-12. [ ] `requestId` 来自 `invoice.reim.flow.create.apply` 的返回结果
-13. [ ] `mainFormId` 来自 `invoice.reim.form.structure` 返回的 `mainFormId`
-14. [ ] `deleteDetailRows` 推荐使用 `{subFormId, dataIndex}` 对象数组格式
-14. [ ] `detail_rows` 中每行必须包含 `subFormId`（明细表ID）
-15. [ ] `dataIndex` 是 1-based，`-1` 表示删除该明细表全部行
-16. [ ] 只传需要更新的字段，无需传完整表单
-17. [ ] `fieldName` 仅用于可读性，不影响逻辑
-18. [ ] `value` 为空 / `unable_to_fill=true` / `need_search=true` 的字段会被跳过
+调用 `workflow.createRequest` 前确认：
+
+1. [ ] `context` 是本组 `workflow.createForm` 返回的 `continuation`，没有复用别的报销单的句柄
+2. [ ] `workflow.createForm` 传的是 Step 2.5 得到的 `{workFlowName}({workFlowId})`
+3. [ ] `requestName` 按规则生成，不超过30字
+4. [ ] `data` 的键全部来自本次 `createForm` 的 `fields[].id`，没有 `fields` 之外的字段（实报金额、附件数、承担人所有上级等不传）
+5. [ ] 带 `initialValue` 且不需改写的字段没有重复传；**例外：每行明细都显式传了「币种」`人民币(100001050000000001)`**（不传会让「申请金额」联动失效）
+6. [ ] 浏览按钮写 `名称(ID)`，没有裸 ID；Select 写选项名，不是 optionValue
+7. [ ] 每行「相关发票」是 `invoice.browse-field.data` 返回的 1 个发票对象；有凭证时「相关凭证」也是 1 个对象，无凭证不传
+8. [ ] 相关凭证（17/18/57/58）没有单独成行
+9. [ ] 每行「费用类型（科目）」有值，匹配不到填 `其他-管理费用(100502270000000104)`
+10. [ ] 文本字段没有 `*` 号
+11. [ ] **出差/差旅流程：相关客户已由用户提供具体名称；未提供则不允许调用 `workflow.createRequest`**
+12. [ ] 非出差流程：相关客户填 `泛微上海(100504500000311504)`；**用户给了合同号时承担主体 / 相关客户 / 相关项目都不传，以合同联动为准**
+13. [ ] 话费报销：金额字段填的是核算后的实报金额
+14. [ ] 已向用户展示预览，并拿到「存草稿 / 提交审批」的明确确认
+
+修改报销单前确认：
+
+15. [ ] `requestId` 来自 `workflow.createRequest` 的返回结果
+16. [ ] 走 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply`，只传要改的字段
+17. [ ] 只改 `editableFields` 里的字段，遇 `notEditable` 如实转述，不换字段 id 绕过