weaver-work-cli 0.1.28 → 0.1.31

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

@@ -17,6 +17,7 @@
 | 获取发票明细行预填信息 | `invoice.reim.row-info` / `invoice.reim.row-info-batch` | yepiaotong | read |
 | 取发票字段对象 | `invoice.browse-field.data` | yepiaotong | read |
 | 获取当前人员及上级（兜底） | `invoice.reim.employee-superiors` | yepiaotong | read |
+| 相关客户 / 相关项目模糊搜索 | `invoice.reim.field.search` | yepiaotong | read |
 | 载入报销表单 | `workflow.createForm` | workflow | read |
 | 创建报销单（固定存草稿） | `workflow.createRequest` | workflow | high-risk-write |
 | 修改已创建的报销单 | `workflow.editLoad` / `workflow.editPrepare` / `workflow.editApply` | workflow | read / read-before-write / high-risk-write |
@@ -25,30 +26,30 @@
 
 ## 处理链
 
-1. 获取发票：已有 `fid` 时可用 `invoice.get`；已有 E10 `fileId` 时用 `invoice.reim.file-ocr.preview`；按日期批量报销用 `invoice.reim.candidates.list`（只取 `available`），按关键词/号码筛选用 `invoice.list`，默认未报销发票。
+1. 获取发票：已有 `fid` 时可用 `invoice.get`；已有 E10 `fileId` 时用 `invoice.reim.file-ocr.preview`；按日期批量报销用 `invoice.reim.candidates.list`（只取 `available`），按关键词/号码筛选用 `invoice.list`，默认未报销发票。日期筛选默认用消费日期 `consumption_tm_begin` / `consumption_tm_end`。
 2. 展示发票汇总，让用户确认哪些发票进入报销。
-3. 用 `invoice.reim.requests.list` 获取事前申请，再按时间、费用类型和标题做匹配；原始 ID、日期、金额必须逐字符保留。
+3. 用 `invoice.reim.requests.list` 获取事前申请，再只按开票日期和事前申请发起日期关联。一张发票时间上只落在一条里就直接绑定；落在多条里，或没有开票日期，先让用户选。原始 ID、日期、金额必须逐字符保留。用户没有指定结束日期时不要传 `cusCreateDateEnd`，CLI 按东八区当天 + 1 天填入。传入的结束日 CLI 也会再 + 1 天后发给接口。
 4. 用 `invoice.reim.workflow.resolve` 得到报销工作流，必要时按工作流分组。
-5. 对每组并行调用 `workflow.createForm`（`workflow` 传 `{workFlowName}({workFlowId})`）、`invoice.reim.row-info-batch`、`invoice.browse-field.data`（发票 + 配对凭证的 `fid`）。
-6. 按 [`reim-form-fill-rules.md`](reim-form-fill-rules.md) 组装 `createRequest` 的 `data`，直接调用 `workflow.createRequest` 存草稿（`action` 固定 `"draft"`，不问用户），结果原样粘贴 `finalMarkdown`。命中「话费补贴标准审批流程」或「话费报销」时，必须先读 [`reim-phone-subsidy-rules.md`](reim-phone-subsidy-rules.md)，按月度标准核算实报金额，不能直接用发票金额填单。
-7. 报销单创建成功后，后续修正使用 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply`，不要重复创建同一组发票的报销单。
+5. 对每组并行调用 `workflow.createForm`（`workflow` 传 `{workFlowName}({workFlowId})`）、`invoice.reim.row-info-batch`、`invoice.browse-field.data`（只传发票的 `fid`，不传凭证）。
+6. 按 [`reim-form-fill-rules.md`](reim-form-fill-rules.md) 组装 `createRequest` 的 `data`。差旅 / 外出报销时，每一行明细「相关流程」必须是 `{requestname}({requestid})`，没有事前申请就先让用户选，禁止空着建单。**相关客户和相关项目同一次让用户一起输入**（项目可「不填」），不要先建空草稿，也不要拆成两轮，不要询问合同号。用户给出名称时，先 `invoice.reim.field.search`：一条直接填 `名称(ID)`，多条让用户选，零条请用户换名称。合同号按已确认的项目从 `historyRequestData` 最近一条带出，对不上则用 `20260999`（见 [`reim-workflow.md`](reim-workflow.md) Step 4.4、Step 4.5）。明细「费用说明」「费用明细」「相关凭证」禁止写入，由「相关发票」联动自动填充。然后直接调用 `workflow.createRequest` 存草稿（`action` 固定 `"draft"`，不问用户「存草稿 / 提交审批」），结果原样粘贴 `finalMarkdown`。命中「话费补贴标准审批流程」或「话费报销」时，必须先读 [`reim-phone-subsidy-rules.md`](reim-phone-subsidy-rules.md)，按月度标准核算实报金额，不能直接用发票金额填单。
+7. 报销单创建成功后，先按 [reim-workflow.md](reim-workflow.md) Step 5.3 检查落库结果：客户 / 项目是否被联动冲空。已确认过的名称直接写回，不要再问。再用 `workflow.editLoad` → `workflow.editPrepare` → `workflow.editApply` 写回。不要重复创建同一组发票的报销单。用户主动改已有报销单时同样走这条修改链。
 
 完整编排见 [`reim-workflow.md`](reim-workflow.md)。
 
 ## 命令
 
-查询事前申请：
+查询事前申请。下面示例里的 `cusCreateDateEnd` 是业务结束日，CLI 会再 + 1 天后发给接口。只查列表、用户没指定结束日期时，去掉该字段，CLI 按东八区当天 + 1 天填入：
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20,"requestname":"交通","cusCreateDateStart":"2026-07-01","cusCreateDateEnd":"2026-07-31"}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":100,"requestname":"交通","cusCreateDateStart":"2026-07-01","cusCreateDateEnd":"2026-07-31"}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20,"requestname":"交通","cusCreateDateStart":"2026-07-01","cusCreateDateEnd":"2026-07-31"}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":100,"requestname":"交通","cusCreateDateStart":"2026-07-01","cusCreateDateEnd":"2026-07-31"}'
 ```
 
 载入报销表单（拿 `continuation` 与可写字段 `fields`）：
@@ -101,16 +102,18 @@ JSON
 weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create-request.json
 ```
 
-示例里的字段 id 来自「总部费用报销」，实际一律以本次 `createForm` 返回的 `fields` 为准；明细行的「相关发票」「相关凭证」要放 `invoice.browse-field.data` 返回的发票对象数组。
+示例里的字段 id 来自「总部费用报销」，实际一律以本次 `createForm` 返回的 `fields` 为准；明细行的「相关发票」要放 `invoice.browse-field.data` 返回的发票对象数组；「相关凭证」不传，由发票联动带出。
 
 ## 输出处理
 
-`workflow.createRequest` 在成功（`CREATED` / `CREATED_SUBMITTED`）、提交失败（`CREATED_SUBMIT_FAILED`）和缺必填（`NEEDS_INPUT`）时返回 `finalMarkdown`，**原样粘贴给用户**，不要自己重拼表格；链接只出现在回复文本里，不要主动打开。若返回 `partial/write_uncertain`，停止，不要重放；最多做一次只读查询或请用户在 E10 页面核对。
+`workflow.createRequest` 在成功（`CREATED` / `CREATED_SUBMITTED`）、提交失败（`CREATED_SUBMIT_FAILED`）和缺必填（`NEEDS_INPUT`）时返回 `finalMarkdown`，**原样粘贴给用户**，不要自己重拼表格；链接只出现在回复文本里，不要主动打开。`CREATED` / `CREATED_SUBMIT_FAILED` 贴完后按 [reim-workflow.md](reim-workflow.md) Step 5.3 检查客户 / 项目是否被联动冲空。若返回 `partial/write_uncertain`，停止，不要重放；最多做一次只读查询或请用户在 E10 页面核对。
 
 ## 注意
 
 载入表单的 `workflow.createForm` **不传 `userQuestion`**、也不用 `workflow.createRequestDirect`：报销的 `data` 由本技能规则组装，不用流程侧智能填参。AI 报销**一律存草稿**（`action:"draft"`），组装完直接调用 `workflow.createRequest`，不让用户选「存草稿 / 提交审批」；草稿由用户在 E10 里核对后自己提交。同一组发票创建成功后禁止再次创建，修改只能走 `workflow.edit*`。
 
-出差/差旅流程需要具体相关客户。未拿到用户提供的客户前，不要调用 `workflow.createRequest`。
+相关客户和相关项目必须在建单前**一次**让用户一起填写（项目可「不填」），**禁止先建空草稿再问，也不要询问合同号**。出差/差旅流程需要具体相关客户，不能用「泛微上海」顶替。用户给出的名称先用 `invoice.reim.field.search` 消歧后再写入。合同号按已确认的项目从历史报销单带出，对不上则用 `20260999`。
+
+明细「费用说明」「费用明细」禁止自己生成，由「相关发票」联动自动填充；落库后仍空也只告知，不要补写。
 
 `invoice.reim.file-ocr.preview` 会让 E10 侧文件进入发票识别流程；如果 fileId 来自用户新上传或附件解析，先提醒用户文件内容可能进入大模型上下文，也可能发送到 E10/OCR 服务，并等待明确确认。

package/skills/weaver-e10-yepiaotong/references/reim-api-reference.md

@@ -105,18 +105,19 @@ CLI 已固定 `flag`（个人票夹=0 / 企业票夹=6），默认 `sreim="3"`
 | --- | --- | --- | --- |
 | `page_size` | Integer | 否 | 每页条数，默认 `10`，建议不超过 `20` |
 | `start_pos` | Integer | 否 | 分页起始位置，默认 `0` |
-| `date_begin` / `date_end` | Integer \| String | 否 | 开票日期范围。可传秒级时间戳，也可直接传 `"YYYY-MM-DD"`（0.1.15 起 CLI 按东八区零点换算）。用户未指定日期时，默认最近一周 |
+| `consumption_tm_begin` / `consumption_tm_end` | Integer \| String | 否 | **消费日期范围（报销默认）**。可传秒级时间戳，也可直接传 `"YYYY-MM-DD"`（CLI 转成秒级时间戳：起始日东八区零点，结束日当天 `23:59:59`）。用户未指定日期时，默认最近一周 |
+| `date_begin` / `date_end` | Integer \| String | 否 | 开票日期范围。可传秒级时间戳，也可直接传 `"YYYY-MM-DD"`（0.1.15 起 CLI 按东八区零点换算）。仅用户明确说开票日期时使用 |
 | `create_tm_begin` / `create_tm_end` | Integer \| String | 否 | 录入/创建日期范围，写法同上。仅用户明确说录入/创建日期时使用 |
 | `content` | String | 否 | 消费内容关键词（如 `"滴滴"`、`"住宿"`） |
 | `number` | String | 否 | 发票号码精确匹配 |
 | `types` | Array\<Integer\> | 否 | 发票类型 ID 数组（见下方映射表） |
 
-不支持 `fylxs`、`consumption_tm_begin`、`consumption_tm_end`；日期筛选一律用 `date_begin` / `date_end`。
+不支持 `fylxs`。报销日期筛选默认用 `consumption_tm_begin` / `consumption_tm_end`，不要和开票日期混用。
 
 ### 时间戳计算
 
 > **所有日期参数的秒级时间戳由 AI 按内联公式直接计算（UTC+8 时区）。**
-> 0.1.15 起 `date_begin` / `date_end` / `create_tm_begin` / `create_tm_end` 也直接接受 `"YYYY-MM-DD"`（CLI 按东八区零点换算），日期区间不跨时区歧义时优先写 `"YYYY-MM-DD"`，更省一次心算；需要精确到时分秒的边界（如 `23:59:59`）时才用秒级时间戳。
+> 0.1.15 起日期字段也直接接受 `"YYYY-MM-DD"`（CLI 转成秒级时间戳）。`consumption_tm_end` 按东八区当天 `23:59:59` 换算，其余按零点。日期区间不跨时区歧义时优先写 `"YYYY-MM-DD"`；已经算好的秒级时间戳可原样传入。
 > 完整公式和 Fallback 见 [reim-workflow.md - 时间戳内联计算](reim-workflow.md#时间戳内联计算零工具调用)。
 
 示例（最近一周，只传必要字段）：
@@ -125,8 +126,8 @@ CLI 已固定 `flag`（个人票夹=0 / 企业票夹=6），默认 `sreim="3"`
 {
   "page_size": 10,
   "start_pos": 0,
-  "date_begin": 1785513600,
-  "date_end": 1786982399
+  "consumption_tm_begin": 1785513600,
+  "consumption_tm_end": 1786982399
 }
 ```
 
@@ -137,23 +138,23 @@ CLI 已固定 `flag`（个人票夹=0 / 企业票夹=6），默认 `sreim="3"`
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"date_begin":1785513600,"date_end":1786982399}'
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":1785513600,"consumption_tm_end":1786982399}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"date_begin":1785513600,"date_end":1786982399}'
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0,"consumption_tm_begin":1785513600,"consumption_tm_end":1786982399}'
 ```
 
 ### 预筛选入参（先获取到事前申请时使用）
 
-> **前提：开票日期一定不早于事前申请日期。** CLI 用 `date_begin` / `date_end`（开票日期，秒级时间戳）筛选。
+> **前提：消费日期一定不早于事前申请日期。** CLI 用 `consumption_tm_begin` / `consumption_tm_end`（消费日期，秒级时间戳）筛选。
 
 如果已有事前申请数据，利用事前申请的 `createTime` 来缩小查询范围：
 
-- `date_begin` = 最早事前申请 createTime 对应的秒级时间戳
-- `date_end` = 当前日期 23:59:59 对应的秒级时间戳
+- `consumption_tm_begin` = 最早事前申请 createTime 对应的秒级时间戳
+- `consumption_tm_end` = 当前日期 23:59:59 对应的秒级时间戳
 
 ### 返回示例
 
@@ -300,11 +301,11 @@ CLI 信封中列表在 `data.items`。下面是单条发票的票面结构（对
 | 分类 | type 值 | 说明 | 填单位置 |
 | --- | --- | --- | --- |
 | **发票** | 除 17/18/57/58 以外的所有值 | 正式发票，每张独立成一行明细 | 明细「相关发票」（`EinvoiceComponent`） |
-| **相关凭证** | 17, 18, 57, 58 | 行程单、小票/水单、电子支付凭证、其他支付凭证，不能独立成行 | 明细「相关凭证」（`EinvoiceComponent`），每行最多 1 张 |
+| **相关凭证** | 17, 18, 57, 58 | 行程单、小票/水单、电子支付凭证、其他支付凭证，不能独立成行 | 明细「相关凭证」不赋值，由发票联动带出 |
 
-**关键规则：相关凭证必须与发票配对，放在同一行明细中，不能单独成行。**
+**关键规则：相关凭证不能单独成行，也不写入明细「相关凭证」，由「相关发票」联动带出。**
 
-详细的配对和填单规则见 [form-fill-rules.md](reim-form-fill-rules.md#发票与相关凭证分类)
+详细规则见 [form-fill-rules.md](reim-form-fill-rules.md#3-相关凭证不赋值由联动带出)
 
 ### 发票类型 ID 映射表
 
@@ -362,7 +363,7 @@ CLI 信封中列表在 `data.items`。下面是单条发票的票面结构（对
 | 57 | 支付凭证 |
 | 58 | 其他票据凭证 |
 
-> **相关凭证类型**（不能独立成行，填单时放入"相关凭证"字段）：17（小票/水单）、18（滴滴行程单——注意：滴滴开具的增值税电子普通发票 type=3，是正式发票可独立成行；type=18 仅指滴滴的支付行程凭证）、57（支付凭证）、58（其他票据凭证）
+> **相关凭证类型**（不能独立成行，也不写入"相关凭证"字段，由发票联动带出）：17（小票/水单）、18（滴滴行程单——注意：滴滴开具的增值税电子普通发票 type=3，是正式发票可独立成行；type=18 仅指滴滴的支付行程凭证）、57（支付凭证）、58（其他票据凭证）
 
 ---
 
@@ -375,16 +376,16 @@ CLI operation：`invoice.reim.candidates.list`（read）
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"date_begin":"2026-09-14","date_end":"2026-09-21"}'
+weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"consumption_tm_begin":"2026-09-14","consumption_tm_end":"2026-09-21"}'
 ```
 
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"date_begin":"2026-09-14","date_end":"2026-09-21"}'
+weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"consumption_tm_begin":"2026-09-14","consumption_tm_end":"2026-09-21"}'
 ```
 
-- 入参（全部可选）：`date_begin`/`date_end`（YYYY-MM-DD，开票日期范围）、`page_size`（10-200，默认 50）、`max_items`（1-500，默认 200，超出截断并产生 warning）、`include_red_reversed`（默认 `false`）。
+- 入参（全部可选）：`consumption_tm_begin`/`consumption_tm_end`（消费日期范围，报销默认）、`date_begin`/`date_end`（开票日期范围，仅用户明确说开票日期时用）、`page_size`（10-200，默认 50）、`max_items`（1-500，默认 200，超出截断并产生 warning）、`include_red_reversed`（默认 `false`）。日期字段接受 `YYYY-MM-DD` 或秒级时间戳。
 - **红冲票默认已过滤**：全额红冲发票（`status=8`）不出现在任何一组，被过滤的张数由 `summary.filteredRedReversedCount` 告知。需要看红冲票时传 `include_red_reversed: true`，此时它们进 `redReversed` 组。
 - 输出：`available` / `assigned` / `redReversed` 三组，每组元素含 `fid`、`number`、`date`、`total`、`buyer`、`payer`、`typeName`、`status`、`valid`、`reimRequests`；`summary` 给出三组的张数与金额合计；`warnings` 含截断与金额解析告警。
 - **报销范围永远从 `available` 里选**；`assigned` 是已挂在报销单上的（再报 = 重复报销）。
@@ -405,7 +406,7 @@ CLI operation：`invoice.reim.requests.list`
 | 参数         | 类型      | 必填  | 默认值 | 说明      |
 | ---------- | ------- | --- | --- | ------- |
 | `pageNo`   | Integer | 是   | 1   | 页码，从1开始 |
-| `pageSize` | Integer | 是   | 20  | 每页条数    |
+| `pageSize` | Integer | 否   | 100 | 每页条数。不传时 CLI 默认 100，显式传入则覆盖 |
 
 
 #### 筛选条件
@@ -414,16 +415,18 @@ CLI operation：`invoice.reim.requests.list`
 | 参数                   | 类型     | 说明                   | 示例              |
 | -------------------- | ------ | -------------------- | --------------- |
 | `requestname`        | String | 流程标题模糊搜索             | `"差旅"`, `"交通费"` |
-| `cusCreateDateStart` | String | 发起日期-开始 (yyyy-MM-dd) | `"2026-07-01"`  |
-| `cusCreateDateEnd`   | String | 发起日期-结束 (yyyy-MM-dd) | `"2026-07-31"`  |
+| `cusCreateDateStart` | String | 发起日期-开始 (yyyy-MM-dd)。不传则不限开始日期 | `"2026-07-01"`  |
+| `cusCreateDateEnd`   | String | 发起日期结束 (yyyy-MM-dd)。**不传时 CLI 按东八区当天 + 1 天填入；传入时 CLI 用该日期再 + 1 天后发给接口。** 调用方传业务结束日本身，不要自己再加 1 天 | `"2026-07-31"`  |
 
 
 ### 推荐默认入参
 
+查事前申请、用户没有指定结束日期时，用下面这份入参。不传 `pageSize` 时 CLI 也按 100 填入。不要自己计算或传入 `cusCreateDateEnd`，CLI 会按东八区当天 + 1 天写入。如果传了 `cusCreateDateEnd`，CLI 会用传入日期再 + 1 天后发给接口，调用方不要自己先加 1 天。
+
 ```json
 {
   "pageNo": 1,
-  "pageSize": 20
+  "pageSize": 100
 }
 ```
 
@@ -432,13 +435,13 @@ CLI operation：`invoice.reim.requests.list`
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":100}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":100}'
 ```
 
 ### 预筛选入参（先获取到发票时使用）
@@ -450,18 +453,21 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
 ```json
 {
   "pageNo": 1,
-  "pageSize": 20,
+  "pageSize": 100,
   "cusCreateDateStart": "2026-04-21",
   "cusCreateDateEnd": "2026-07-30"
 }
 ```
 
-- `cusCreateDateEnd` = 最晚发票 invoiceDate（事前申请不会晚于开票日期）
+- `cusCreateDateEnd` = 最晚发票 invoiceDate（事前申请不会晚于开票日期）。CLI 会再 + 1 天后发给接口；不需要按开票日收窄时不要传，交给「东八区当天 + 1 天」默认值
 - `cusCreateDateStart` = 最早发票 invoiceDate 往前推 90 天（合理的事前申请窗口期）
 - **话费报销例外**：话费补贴事前申请可能在很早以前审批，`cusCreateDateStart` 需往前推 **1095 天（3 年）**，并加 `requestname="话费"` 缩小结果。详见 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md)。
+- 取回列表后，发票和事前申请**只按时间关联**：开票日期落在发起日之后 90 天内（话费不设 90 天上限）。正好 1 条就绑定；2 条及以上先问用户。见 [reim-matching-rules.md](reim-matching-rules.md)。
 
 ### 返回示例
 
+CLI 只保留下面 7 个字段，接口原文里的 `requestnametitle`、部门、节点、URL 等不再输出。
+
 ```json
 {
   "code": 200,
@@ -472,16 +478,10 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
       "requestid": "1298294241967177729",
       "workflowid": "1181057526276915214",
       "requestname": "交通费报销-后端开发111-2026-07-31",
-      "requestnametitle": "交通费报销-后端开发111-2026-07-31 (相关客户:, 相关项目:, 承担主体: , 流程编号:Weaver-FYBX202607000069, 报销总金额:14.47 , 费用承担公司:)",
       "flowStatus": 6,
       "creatorId": "1201729946891231232",
       "creatorName": "后端开发111",
-      "creatorSubCompanyId": "1169438875220598808",
-      "creatorDepartmentId": "1201729461554241537",
-      "createTime": "2026-07-31 15:24:45",
-      "requestMark": "Weaver-FYBX202607000069",
-      "userDepartmentId": "1201729461554241537",
-      "nodeid": "1181057741029220917"
+      "createTime": "2026-07-31 15:24:45"
     }
   ],
   "fail": false
@@ -491,20 +491,15 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
 ### 返回字段说明
 
 
-| 字段                    | 说明                     |
-| --------------------- | ---------------------- |
-| `requestid`           | 事前申请流程ID（用于匹配绑定和填单）    |
-| `workflowid`          | 工作流ID（用于获取表单结构）        |
-| `requestname`         | 流程标题                   |
-| `requestnametitle`    | 标题纯文本（含扩展信息：客户、项目、金额等） |
-| `flowStatus`          | 流程状态（6=已完成）            |
-| `creatorId`           | 发起人ID                  |
-| `creatorName`         | 发起人姓名                  |
-| `creatorDepartmentId` | 发起人部门ID                |
-| `creatorSubCompanyId` | 发起人分部ID                |
-| `createTime`          | 发起时间                   |
-| `requestMark`         | 流程编号                   |
-| `nodeid`              | 当前节点ID                 |
+| 字段            | 说明                  |
+| ------------- | ------------------- |
+| `requestid`   | 事前申请流程ID（用于匹配绑定和填单） |
+| `workflowid`  | 工作流ID（用于获取表单结构）     |
+| `requestname` | 流程标题                |
+| `flowStatus`  | 流程状态（6=已完成）         |
+| `creatorId`   | 发起人ID               |
+| `creatorName` | 发起人姓名               |
+| `createTime`  | 发起时间                |
 
 
 ---
@@ -709,7 +704,7 @@ weaver-work-cli --json invoice run invoice.reim.employee-superiors --input-json
 
 CLI operation：`invoice.reim.row-info`
 
-根据发票 ID 获取该发票在明细行中应填写的费用日期、费用说明、关联凭证、费用科目。**返回值优先级高于 AI 自行推断**。
+根据发票 ID 获取该发票在明细行中应填写的费用日期、关联凭证、费用科目。`fysm` 只作返回字段，**不要写入明细「费用说明」**，该列由发票联动带出。关联凭证 `itinerary` 也不写入「相关凭证」。日期、科目的返回值优先级高于 AI 自行推断。
 
 ### 入参
 
@@ -741,13 +736,13 @@ weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoice
 | 字段          | 说明               | 对应明细行字段                                  |
 | ----------- | ---------------- | ---------------------------------------- |
 | `date`      | 费用日期             | 费用日期/发生日期                                |
-| `fysm`      | 费用说明             | 费用说明/摘要                                  |
-| `itinerary` | 关联凭证 ID（多个用逗号拼接） | 相关凭证（`EinvoiceComponent`，每行最多 1 张） |
+| `fysm`      | 费用说明原文           | **不写入**明细「费用说明」。该列由发票联动带出 |
+| `itinerary` | 关联凭证 ID（多个用逗号拼接） | **不写入**，明细「相关凭证」由发票联动带出 |
 | `subjectId` | 费用科目 ID          | 费用类型（科目）                                 |
 | `subjectName` | 费用科目名称        | 与 `subjectId` 拼成 `名称(ID)`                    |
 | `sqje` / `sbje` | 整张发票的申请金额 | 仅参考；金额字段填发票价税合计（`price.total`） |
 | `containsItinerary` | 是否关联了行程单 | — |
-| `itineraryData` | **行程单逐段明细**数组，每段含 `date`、`sqje`（该段金额）、`fysm`（`{起点} - {终点}`）、`subjectId` / `subjectName`、`itinerary`（凭证 ID）、`invoiceId` | **暂不拆行**；只在 `invoice.get` 取不到起止点时给费用说明兜底，见 [reim-form-fill-rules.md](reim-form-fill-rules.md#4-行程单多段行程暂不拆行) |
+| `itineraryData` | **行程单逐段明细**数组，每段含 `date`、`sqje`（该段金额）、`fysm`、`subjectId` / `subjectName`、`itinerary`（凭证 ID）、`invoiceId` | **暂不拆行**，也不要用其中的 `fysm` 生成费用说明。见 [reim-form-fill-rules.md](reim-form-fill-rules.md#4-行程单多段行程暂不拆行) |
 
 
 ### 返回示例
@@ -768,10 +763,10 @@ weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoice
 ### 使用场景与优先级
 
 - **调用时机**：Step 4 组装明细行时，对每张发票调用 `invoice.reim.row-info`
-- **优先级**：此 CLI 返回的 `date`、`fysm`、`itinerary`、`subjectId` 四个值**优先于 AI 自行推断的值**
-- **容错**：如果某个字段为空/null，则回退到 AI 推断逻辑
-- **itinerary 处理**：如果 `itinerary` 有值，直接作为该行的配对凭证，**替代原有的凭证配对逻辑**；先用 `invoice.browse-field.data` 取凭证对象再填入「相关凭证」。逗号分隔返回多个时，每行只挂最匹配的 1 张（规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md#3-凭证与发票配对)）
-- **itineraryData 处理**：暂不拆行，不管几段都是一张发票一行；只用来给费用说明兜底（第一段起点 - 最后一段终点）
+- **优先级**：此 CLI 返回的 `date`、`subjectId` **优先于 AI 自行推断的值**。`fysm` 不写入「费用说明」
+- **容错**：日期、科目为空/null 时，回退到 AI 推断逻辑。费用说明没有回退，保持不传
+- **itinerary 处理**：不用来写「相关凭证」，也不拿它去 `invoice.browse-field.data` 取凭证对象。明细「相关凭证」由发票联动带出（见 [reim-form-fill-rules.md](reim-form-fill-rules.md#3-相关凭证不赋值由联动带出)）
+- **itineraryData 处理**：暂不拆行，不管几段都是一张发票一行。不要拿第一段和最后一段去写费用说明
 
 ---
 
@@ -851,7 +846,7 @@ weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"i
 
 CLI operation：`invoice.get`
 
-根据发票 ID 获取发票完整详情。**主要用途：交通类发票获取出发地、目的地，用于生成费用说明。**
+根据发票 ID 获取发票完整详情。报销填单时不要为了生成费用说明去取出发地、目的地。
 
 ### 命令
 
@@ -941,7 +936,7 @@ weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"13019569599
 
 CLI operation：`invoice.browse-field.data`（read）
 
-报销单明细的「相关发票」「相关凭证」都是 `EinvoiceComponent`，**只接受发票对象，不接受文本或裸 ID**。一次传入本组全部发票与配对凭证的 `fid`，按 `fid` 把返回对象放进对应行。入参与对象结构见 [invoice-browse-field-data.md](invoice-browse-field-data.md)。
+报销单明细的「相关发票」是 `EinvoiceComponent`，**只接受发票对象，不接受文本或裸 ID**。一次传入本组全部发票的 `fid`（不传凭证，「相关凭证」由发票联动带出），按 `fid` 把返回对象放进对应行。入参与对象结构见 [invoice-browse-field-data.md](invoice-browse-field-data.md)。
 
 macOS/Linux（bash/zsh）：
 
@@ -957,6 +952,48 @@ weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid
 
 ---
 
+## 5.9 相关客户 / 相关项目模糊搜索
+
+CLI operation：`invoice.reim.field.search`（read）
+
+用户给出相关客户或相关项目名称后、写入之前调用。封装 `GET /api/government/formStructure/fieldRelateSearch`（参数走 query）。编排见 [reim-form-fill-rules.md](reim-form-fill-rules.md#相关客户模糊搜索)。**必须在建草稿前搜完确认，不要先建空单再搜。**
+
+### 入参
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `keywords` | String | 是 | 用户原话，不要改写 |
+| `fieldId` | String | 是 | 本次 `createForm` 里对应字段 id（相关客户或相关项目） |
+| `workflowId` | String | 是 | 本次报销工作流 ID |
+| `nodeId` | String | 否 | 默认 `100004140000000271` |
+
+### 命令
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"学院","fieldId":"100003720000000687","workflowId":"100003460000000060"}'
+```
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.reim.field.search --input-json '{"keywords":"学院","fieldId":"100003720000000687","workflowId":"100003460000000060"}'
+```
+
+### 返回
+
+| 字段 | 说明 |
+| --- | --- |
+| `keywords` | 本次搜索词 |
+| `match` | `unique` / `multiple` / `none` |
+| `items` | `{id,name,value}` 列表，`value` 与 `id` 相同 |
+| `selected` | `match=unique` 时是那一条；否则 `null` |
+
+`match=unique` → 直接填 `"名称(ID)"`，不问用户。`match=multiple` → 把 `items` 的名称列给用户选。`match=none` → 请用户换更完整的名称。不要把未消歧简称直接丢给 `createRequest`。
+
+---
+
 ## 6. 创建 / 修改报销单（`weaver-e10-workflow`）
 
 报销单创建与修改不再使用本技能的 operation，统一调用 `weaver-e10-workflow` 技能：
@@ -968,3 +1005,7 @@ weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid
 | 修改已创建的报销单 | `workflow.editLoad` → `workflow.editPrepare` → `workflow.editApply` | [`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md) |
 
 `data` 的组装规则见 [reim-form-fill-rules.md](reim-form-fill-rules.md)，编排顺序见 [reim-workflow.md](reim-workflow.md) Step 3 ~ Step 6。
+
+`workflow.createForm` 的 `historyRequestData` 已是本工作流近一年、非草稿、我发起的前 5 条。总部费用报销用它按已确认的相关项目带出合同号，**不要询问合同号**（见 [reim-workflow.md](reim-workflow.md) Step 4.4）。客户和项目同一次让用户一起输入。不要再调用 `workflow.search` 或 `workflow.detail`。
+
+相关客户、相关项目必须在调用 `workflow.createRequest` 前一次问齐（见 Step 4.5），禁止先建空草稿再问，也不要询问合同号。明细「费用说明」「费用明细」「相关凭证」禁止填值，由「相关发票」联动带出，落库后仍空也不要补写。草稿落库后再查客户 / 项目是否被联动冲空（见 Step 5.3）。已确认值被冲空则 `workflow.edit*` 写回。看不清时用 `workflow.editLoad` 读 `currentValues`。