weaver-work-cli 0.1.8 → 0.1.21

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

@@ -104,8 +104,8 @@ CLI 已固定 `flag`（个人票夹=0 / 企业票夹=6），默认 `sreim="3"`
 | --- | --- | --- | --- |
 | `page_size` | Integer | 否 | 每页条数，默认 `10`，建议不超过 `20` |
 | `start_pos` | Integer | 否 | 分页起始位置，默认 `0` |
-| `date_begin` / `date_end` | Integer | 否 | 开票日期范围（**秒级时间戳**）。用户未指定日期时，默认最近一周 |
-| `create_tm_begin` / `create_tm_end` | Integer | 否 | 录入/创建日期范围（**秒级时间戳**），仅用户明确说录入/创建日期时使用 |
+| `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 数组（见下方映射表） |
@@ -115,6 +115,7 @@ CLI 已固定 `flag`（个人票夹=0 / 企业票夹=6），默认 `sreim="3"`
 ### 时间戳计算
 
 > **所有日期参数的秒级时间戳由 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`）时才用秒级时间戳。
 > 完整公式和 Fallback 见 [reim-workflow.md - 时间戳内联计算](reim-workflow.md#时间戳内联计算零工具调用)。
 
 示例（最近一周，只传必要字段）：
@@ -427,6 +428,7 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
 
 - `cusCreateDateEnd` = 最晚发票 invoiceDate（事前申请不会晚于开票日期）
 - `cusCreateDateStart` = 最早发票 invoiceDate 往前推 90 天（合理的事前申请窗口期）
+- **话费报销例外**：话费补贴事前申请可能在很早以前审批，`cusCreateDateStart` 需往前推 **1095 天（3 年）**，并加 `requestname="话费"` 缩小结果。详见 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md)。
 
 ### 返回示例
 
@@ -869,14 +871,18 @@ weaver-work-cli --json invoice run invoice.reim.employee-superiors --input-json
       "id": "1201729946891231232",
       "name": "后端开发111"
     },
+    "directSuperior": {
+      "id": "1201729946891231233",
+      "name": "直属主管王五"
+    },
     "allSuperiors": [
       {
         "id": "1201729946891231111",
-        "name": "部门经理张三"
+        "name": "分管领导熊总"
       },
       {
-        "id": "1201729946891231222",
-        "name": "总监李四"
+        "id": "1201729946891231233",
+        "name": "直属主管王五"
       }
     ]
   },
@@ -890,16 +896,16 @@ weaver-work-cli --json invoice run invoice.reim.employee-superiors --input-json
 | --- | --- |
 | `currentEmployee.id` | 当前人员 ID（**字符串**，避免雪花 ID 超过 JS 安全整数精度） |
 | `currentEmployee.name` | 当前人员名称 |
-| `allSuperiors` | 所有上级列表（含直接上级和间接上级），每项含 `id` 和 `name` |
-| `allSuperiors[0]` | 第一个元素即为直接上级 |
+| `allSuperiors` | 所有上级列表（直接上级 + 间接上级，按层级从高到低排列），每项含 `id` 和 `name` |
+| `directSuperior` | **直接上级**（对象，含 `id` 和 `name`）。⚠️ **与 `allSuperiors[0]` 不是同一人**：`allSuperiors[0]` 是上级链中最高层（如分管领导），直接上级必须取 `directSuperior` |
 | `allSuperiors[].id` | 上级人员 ID（**字符串**） |
 
 ### 填单字段对应关系
 
 | 表单字段 | 取值方式 |
 | --- | --- |
-| 报销人上级 | `allSuperiors[0].id`（直接上级 ID，直接赋值） |
-| 承担人直接上级 | `allSuperiors[0].id`（直接上级 ID，直接赋值） |
+| 报销人上级 | `directSuperior.id`（直接上级 ID，直接赋值；**不是 `allSuperiors[0]`**） |
+| 承担人直接上级 | `directSuperior.id`（同上） |
 | 承担人所有上级 | `allSuperiors` 中所有 `id` 用逗号拼接（如 `"id1,id2,id3"`） |
 
 ---
@@ -969,6 +975,80 @@ weaver-work-cli --json invoice run invoice.reim.row-info --input-json '{"invoice
 
 ---
 
+## 5.6b 批量获取发票预填信息（0.1.19 新增）
+
+CLI operation：`invoice.reim.row-info-batch`
+
+一次调用获取多张发票的预填信息，内部并行处理（并发度 4），避免 Agent 逐张串行调用 `invoice.reim.row-info` 导致 N-1 次额外 CLI 启动与网络往返。
+
+### 入参
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `invoiceIds` | Array\<String\> | 是 | 发票 ID 列表，1-100 个 |
+| `requestid` | String | 否 | 事前申请流程 ID（无可不传或留空） |
+| `cdzt` | String | 否 | 当前用户/人员 ID，不传则 CLI 使用当前登录用户 |
+
+### 命令
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"invoiceIds":["1297093330645237792","1297093330645237793"]}'
+```
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.reim.row-info-batch --input-json '{"invoiceIds":["1297093330645237792","1297093330645237793"]}'
+```
+
+### 返回示例
+
+```json
+{
+  "results": [
+    {
+      "invoiceId": "1297093330645237792",
+      "status": "success",
+      "data": {
+        "date": "2026-07-29",
+        "fysm": "交通运输服务",
+        "itinerary": "1298798990831518001",
+        "subjectId": "100502270000000006"
+      }
+    },
+    {
+      "invoiceId": "1297093330645237793",
+      "status": "fail",
+      "error": "获取发票 1297093330645237793 行预填失败"
+    }
+  ],
+  "succeeded": 1,
+  "failed": 1,
+  "total": 2,
+  "workflow": { "workflow": "invoice.reim.row-info-batch", "version": 1, "state": "PARTIAL" }
+}
+```
+
+### 返回字段说明
+
+| 字段 | 说明 |
+| --- | --- |
+| `results[].invoiceId` | 对应的发票 ID |
+| `results[].status` | `"success"` 或 `"fail"` |
+| `results[].data` | 成功时返回，结构与单张 `row-info` 一致（`date`、`fysm`、`itinerary`、`subjectId`） |
+| `results[].error` | 失败时返回错误信息 |
+| `succeeded` / `failed` / `total` | 成功/失败/总数统计 |
+
+### 使用场景
+
+- **手工组装报销单时**（Step 3.5），用 `row-info-batch` 替代 N 次 `row-info` 调用
+- 部分失败不影响其他发票，失败的回退到 AI 推断逻辑
+- 快速路径（`template.build`/`auto-prepare`）内部已自带批量获取，无需额外调用
+
+---
+
 ## 5.7 获取发票详情（交通类发票行程信息）
 
 CLI operation：`invoice.get`

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

@@ -497,6 +497,7 @@ weaver-work-cli --json invoice run invoice.reim.flow.create.apply --input ./reim
 **场景**：2 张发票（交通+住宿）均匹配到同一条出差事前申请。
 
 **出差拦截**：`workFlowName` 含「差旅」或事前申请名称含「出差」→ **必须先提醒用户填写相关客户**。
+**话费拦截**：`workFlowName` 含「话费补贴标准审批流程」或「话费报销」→ **必须先按 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md) 核对账单截图、账单构成和岗位上限，再按标准计算实报金额**。
 
 ```markdown
 当前为出差报销，必须填写相关客户。请提供本次出差对应的具体客户名称，否则无法继续报销。

package/skills/weaver-e10-yepiaotong/references/reim-expense-subject-rules.md

@@ -1,7 +1,33 @@
 # 费用科目匹配规则
 
-> **费用类型（科目）字段必须有值。优先使用 `invoice.reim.row-info` 返回的 `subjectId`；为空时按下方查找表匹配；全部未命中则填兜底值 `"100502270000000104"`。**
+> **费用类型（科目）字段必须有值。优先使用 `invoice.reim.row-info`（或 `row-info-batch`）返回的 `subjectId`；为空时按下方查找表匹配；全部未命中则填兜底值 `"100502270000000104"`。**
 > **绝不能为空、不能报错、不能放入 `unable_to_fill`。**
+> **兜底科目 `"100502270000000104"` 见 [reim-workflow.md 共享常量](reim-workflow.md#报销共享常量所有-reference-统一引用本节)。**
+
+---
+
+## 匹配决策树（完整流程图）
+
+```
+invoice.reim.row-info 返回 subjectId?
+  ├── 有值 → 直接使用，结束
+  └── 空/null → 进入查找表匹配 ↓
+        优先级1: expenseType 匹配?
+          ├── 命中 → 使用对应 ID，结束
+          └── 未命中 → ↓
+        优先级2: sellerName 关键词匹配?
+          ├── 命中 → 使用对应 ID，结束
+          └── 未命中 → ↓
+        优先级3: consumeContent 关键词匹配?
+          ├── 命中 → 使用对应 ID，结束
+          └── 未命中 → ↓
+        优先级4: requestname 辅助匹配?
+          ├── 命中 → 使用对应 ID，结束
+          └── 未命中 → ↓
+        兜底条件匹配（押金/电子设备/家具/研发/销售）?
+          ├── 命中 → 使用对应 ID，结束
+          └── 全不命中 → 填 "100502270000000104"，结束
+```
 
 ---
 
@@ -11,75 +37,69 @@
 
 ### 优先级1：expenseType 匹配
 
-```json
-{
-  "市内交通": "100502270000000006",
-  "住宿": "100502270000000183",
-  "餐饮": "100502270000000064",
-  "办公": "100502270000000003",
-  "通讯": "100502270000000010",
-  "活动": "100502270000000002",
-  "招待": "100502270000000005"
-}
-```
+| 关键词 | 科目 ID | 科目名称 |
+|--------|---------|----------|
+| 市内交通 | `100502270000000006` | 市内交通费 |
+| 住宿 | `100502270000000183` | 住宿费 |
+| 餐饮 | `100502270000000064` | 餐饮费 |
+| 办公 | `100502270000000003` | 办公费 |
+| 通讯 | `100502270000000010` | 通讯费 |
+| 活动 | `100502270000000002` | 活动费 |
+| 招待 | `100502270000000005` | 招待费 |
 
 > expenseType 为空或 "日常消费"/"其他费用" 等泛指值时跳过此表。
 
 ### 优先级2：sellerName 关键词匹配
 
-```json
-{
-  "滴滴|享道|曹操|高德|首汽": "100502270000000173",
-  "酒店|宾馆|民宿|如家|汉庭|全季": "100502270000000183",
-  "餐饮|饭店|海底捞|美团|饿了么": "100502270000000064",
-  "办公|文具": "100502270000000003",
-  "中国移动|中国联通|中国电信": "100502270000000010"
-}
-```
+| 关键词（任一命中） | 科目 ID | 科目名称 |
+|---------------------|---------|----------|
+| 滴滴、享道、曹操、高德、首汽 | `100502270000000173` | 交通费-管理费用 |
+| 酒店、宾馆、民宿、如家、汉庭、全季 | `100502270000000183` | 住宿费 |
+| 餐饮、饭店、海底捞、美团、饿了么 | `100502270000000064` | 餐饮费 |
+| 办公、文具 | `100502270000000003` | 办公费 |
+| 中国移动、中国联通、中国电信 | `100502270000000010` | 通讯费 |
 
 ### 优先级3：consumeContent 关键词匹配
 
-```json
-{
-  "客运服务费|运输服务": "100502270000000006",
-  "住宿服务|住宿费": "100502270000000183",
-  "餐饮服务|餐费": "100502270000000064",
-  "电脑|手机|平板|显示器|电子设备": "100502270000000128",
-  "押金|保证金": "100502270000000127",
-  "家具|桌椅|办公桌|柜子": "100502270000000129"
-}
-```
+| 关键词（任一命中） | 科目 ID | 科目名称 |
+|---------------------|---------|----------|
+| 客运服务费、运输服务 | `100502270000000006` | 市内交通费 |
+| 住宿服务、住宿费 | `100502270000000183` | 住宿费 |
+| 餐饮服务、餐费 | `100502270000000064` | 餐饮费 |
+| 话费、手机账单、通信费、通讯费 | `100502270000000010` | 通讯费 |
+| 电脑、手机、平板、显示器、电子设备 | `100502270000000128` | 电子设备 |
+| 押金、保证金 | `100502270000000127` | 押金保证金 |
+| 家具、桌椅、办公桌、柜子 | `100502270000000129` | 家具 |
 
 ### 优先级4：requestname 辅助匹配（事前申请名称）
 
-```json
-{
-  "招待|接待": "100502270000000005",
-  "采购|办公": "100502270000000003"
-}
-```
+| 关键词（任一命中） | 科目 ID | 科目名称 |
+|---------------------|---------|----------|
+| 招待、接待 | `100502270000000005` | 招待费 |
+| 采购、办公 | `100502270000000003` | 办公费 |
+| 话费、通讯 | `100502270000000010` | 通讯费 |
 
 > 出差/差旅类事前申请 + 交通类发票 → 使用优先级2的 sellerName 匹配结果。
 
 ### 兜底（必定命中）
 
-| 条件 | 科目 ID |
-|------|---------|
-| 发票涉及押金、保证金 | `100502270000000127` |
-| 发票涉及电脑、电子设备 | `100502270000000128` |
-| 发票涉及家具、桌椅 | `100502270000000129` |
-| 用户为研发部门 | `100502270000000090` |
-| 事前申请含"销售"关键词 | `100502270000000105` |
-| **以上都不满足** | **`100502270000000104`** |
+| 条件 | 科目 ID | 科目名称 |
+|------|---------|----------|
+| 发票涉及押金、保证金 | `100502270000000127` | 押金保证金 |
+| 发票涉及电脑、电子设备 | `100502270000000128` | 电子设备 |
+| 发票涉及家具、桌椅 | `100502270000000129` | 家具 |
+| 用户为研发部门 | `100502270000000090` | 研发费用 |
+| 事前申请含"销售"关键词 | `100502270000000105` | 销售费用 |
+| **以上都不满足** | **`100502270000000104`** | **其他-管理费用** |
 
 ---
 
 ## 滴滴/网约车科目选择
 
-| 条件 | 科目 ID |
-|------|---------|
-| 默认（无法确认部门） | `100502270000000173`（管理费用） |
-| 确认为研发部门人员 | `100502270000000177`（研发费） |
+| 条件 | 科目 ID | 科目名称 |
+|------|---------|----------|
+| 默认（无法确认部门） | `100502270000000173` | 交通费-管理费用 |
+| 确认为研发部门人员 | `100502270000000177` | 交通费-研发费 |
 
 ---
 
@@ -92,3 +112,4 @@
 ```
 
 > ID 必须原样复制，严禁修改。每行明细的科目独立匹配。
+> 快速路径（`template.build`/`auto-prepare`）已内置科目匹配：`row-info` 返回 `subjectId` 为空时自动使用默认科目 `"1256664958132969489"`（日常消费）。

package/skills/weaver-e10-yepiaotong/references/reim-fast-path.md

@@ -0,0 +1,119 @@
+# 报销快速路径（0.1.13 新增 operation）
+
+> 三个新 operation 把「查票 → 分类 → 组 payload → prepare」压成两步，人工只保留确认 + apply。
+> 固化映射来自 2026-09-14 / 2026-09-21 两次真实 apply 成功的「总部费用报销」单据，只覆盖该流程。
+
+## 1. `invoice.reim.candidates.list`（read）— 票夹候选分类
+
+自动翻页拉取未报销（sreim=3）发票，并按 `oreim.list_reim` / 红冲状态分成三组，**不再需要手动翻页和逐条剔重**：
+
+macOS/Linux（bash）：
+
+```bash
+weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"date_begin":"2026-09-14","date_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"}'
+```
+
+- 入参（全部可选）：`date_begin`/`date_end`（YYYY-MM-DD，开票日期范围）、`page_size`（10-200，默认 50）、`max_items`（1-500，默认 200，超出截断并产生 warning）、`include_red_reversed`（默认 `false`）。
+- **红冲票默认已过滤**：全额红冲发票（`status=8`）不可报销，默认**不出现在结果里任何一组**，被过滤的张数由 `summary.filteredRedReversedCount` 告知（不会静默丢弃）。需要看红冲票时传 `include_red_reversed: true`，此时它们进 `redReversed` 组。
+- 过滤发生在翻页循环内部：即使某一页全是红冲票也会继续翻页，直到凑够 `max_items` 张**可用**发票或数据取完，因此 `fetched` 只计保留下来的发票数、`total` 仍是接口返回的符合条件的总张数。
+- 输出：`available` / `assigned` / `redReversed` 三组（后一组默认恒为空），每组元素含 `fid`、`number`、`date`、`total`、`buyer`、`payer`、`typeName`、`status`、`valid`、`reimRequests`；`summary` 给出三组的张数与金额合计，外加 `filteredRedReversedCount`；`warnings` 含截断与金额解析告警。
+- **报销范围永远从 `available` 里选**；`assigned` 是已挂单的（重复提交 = 重复报销）。
+- **⚠️ 关于"两次连续查询之间 assigned↔available 翻转"（2026-09-21 已定位，结论：分类是准的，不是误判）**：同一天内观察到 25 张发票从 `assigned` 翻到 `available`，一度被怀疑是 `oreim.list_reim` 缓存滞后。最终用 `workflow.detail` 逐个复核 requestId 后定案：`1313947830149185538`（报销单 2026-09-11）、`1314910388070170941`（2026-09-14）、`1317591500119752761`（当天新建）**均返回"流程已被删除"**，10+15+2 张发票随之释放。⇒ **翻转的根因是报销单被删除，发票真实释放，`candidates.list` 的三分类如实反映了状态变化。**
+  - **因此不要每次报销都对每张入选票再跑一次 `invoice.get` 复核 `oreim.list_reim`** —— 那会让快速路径失去意义。只有在**观察到异常翻转**（或对某张票的归属存疑）时才做核实，正确顺序是：`weaver-work-cli workflow run workflow.detail --input-json '{"requestId":"<id>"}'` 查单据是否还存在（被删的单会明确返回"流程已被删除"）→ 再用 `invoice.get` 看 `oreim.list_reim`。
+  - **已知局限**：`list_reim` 元素只有报销单**名称**（无 requestId、无单号、无单据状态），`reimRequests` 里拿不到能直接喂给 `workflow.detail` 的 id。要核实只能先按名称用 `workflow.search` 找 requestId —— 注意**被删除的单在 `workflow.search` 里搜不到**，这本身就是一个"单可能已被删"的信号，但无法区分"从未存在"与"已被删除"。
+  - 另一个易踩点：`sreim="3"`（未报销）**不会**把挂单中的发票排除掉（实测 13 张挂单票仍出现在 `sreim=3` 的 39 张结果里），所以不能靠 `sreim` 判断是否已挂单，分类必须看 `list_reim`。
+
+## 2. `invoice.reim.template.build`（read）— 固化模板组装 payload
+
+输入发票 ID 列表 + 标题，一条命令产出完整 `payload`（19 个主表字段 + N 行明细）。内部自动完成：取上级（`directSuperior`）→ 解析候选工作流（或用传入 `workflowId`）→ 取表单结构并**按名称定位「费用明细」子表** → 批量取发票详情与行预填。
+
+macOS/Linux（bash）：
+
+```bash
+weaver-work-cli --json invoice run invoice.reim.template.build --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
+```
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.reim.template.build --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
+```
+
+- 入参：`invoiceIds`（必填，1-100 个，顺序 = 明细行顺序）、`requestName`（必填，≤100 字）；可选 `workflowId`（不传则自动解析唯一候选流程）、`reason`（报销事由，缺省用 requestName）、`relatedCustomerId`、`relatedCustomerName`、`contractNo`（**默认值 `"20260999"`，视为必传**）。
+- **⚠️ `contractNo` 默认填 `"20260999"`，不能省略**：主表 `合同号(100003720000001376)` 只有在入参给了 `contractNo` 时才写进 `payload.main_fields`（不传时该字段**整条缺失**，实测同一票同参数：不传 18 个主表字段，传 `"contractNo":"20260999"` 后 19 个），报销单里它会留空**且 `warnings` 不会提示**，属于静默漏填。
+- **默认值口径与 [`reim-form-fill-rules.md`](reim-form-fill-rules.md) 的主表字段映射表一致**：合同编号 = 固定值 `"20260999"`。**除非用户明确给出别的合同号，否则一律填 `"20260999"`** —— 快速路径也必须遵守这条，不能因为「入参可选」就留空。
+- 用户另有指定时以用户指定为准；用户明确说"不填合同号"时才允许留空。
+- 输出：`payload`（可直接喂给 `flow.create.prepare` / apply）、`preview`、`labels`、`warnings`。
+  - `preview.mainFields[]` / `preview.detailRows[]`：**已把字典类 ID 渲染成「中文(id)」，预览直接展示这两项即可，不必再查名**（详见 `reim-workflow.md` Step 4.7）。
+  - `labels`：`employees` / `subjects` / `currencies` / `customers` / `selectOptions` / `customer` / `detailSubForm` / `workflow` 字典；`labels.unresolved` 为没取到中文名的 ID 清单，非空时如实展示并提醒用户核对。
+  - 相关客户只给名称也行：传 `relatedCustomerName`（不传 ID 时 CLI 反查 ID；ID + 名称同传则不额外请求，仅用于渲染）。
+- 行为细节（与 2026-09 实测口径一致）：
+  - 报销人上级 / 承担人直接上级 = `directSuperior.id`（**不是 allSuperiors[0]**）；承担人所有上级 = allSuperiors 全部 id 逗号拼接。
+  - 费用明细子表优先按名称「费用明细」匹配，兜底按「相关发票」字段结构签名匹配。
+  - 费用说明自动去掉 `*`；科目缺省「日常消费」；币种人民币；报销方式银行（optionValue "7"）。
+  - 发票已挂单 → warning；发票全额红冲（status=8）或金额合计为 0 → **直接报错拒绝组装**。
+  - `relatedCustomerId` 不传会留空并产生 warning（E10 apply 时可能因必填校验失败，非出差场景建议传）。
+- 模板只固化了「总部费用报销」(`100003460000000060`) 的字段映射。若解析到的候选流程不是它，字段映射可能不适用 —— 此时**改走 `reim-workflow.md` 的手工组装路径**。
+
+## 3. `invoice.reim.flow.create.auto-prepare`（read-before-write）— 一站式 prepare
+
+与 `template.build` 相同的入参，组装 payload 后**直接签发 `flow.create.apply` 的 continuation**，一步到 `AWAITING_CONFIRMATION`：
+
+macOS/Linux（bash）：
+
+```bash
+weaver-work-cli --json invoice run invoice.reim.flow.create.auto-prepare --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
+```
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.reim.flow.create.auto-prepare --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
+```
+
+输出含 `payload` + `preview` + `labels` + `continuation` + `expiresInSeconds: 600`。**用户确认后**，把 payload 的字段**展开到顶层**（即 `work_flow_id` / `mainFormId` / `request_name` / `main_fields` / `detail_rows` / `need_user_confirm` / `unable_to_fill`），再补 `continuation` 与 `confirm: true`，交给 `invoice.reim.flow.create.apply` 提交。**不要写成 `{"payload": {...}, "continuation": ...}` 的嵌套结构**（`reim-api-reference.md` 第 7 节已明确「不要再包一层通用 payload」）。
+
+## 推荐流程（快速路径）
+
+```
+candidates.list（选 available）
+  → 向用户展示汇总并确认范围
+  → auto-prepare（或 template.build + flow.create.prepare）  ← 必带 relatedCustomerId + contractNo:"20260999"（用户另有指定时用其值）
+  → 展示 preview + warnings（**ID 一律带中文名，见 `reim-workflow.md` Step 4.7**），等用户确认
+  → flow.create.apply（展开 payload 到顶层 + continuation + confirm=true）
+  → 回查验证（candidates.list 或 invoice.list）
+```
+
+人工确认环节不可跳过：apply 是 high-risk-write，金额、抬头、明细、上级必须经过用户核对。
+
+> **apply 入参改用 `--input <path>` 时的解析坑（0.1.18 实测）**：stdout 会在 JSON **之前多出一行** `[weaver-work-cli] 使用 --input <path> 读取 JSON 文件；多步传递请优先用 --input-ref，简单数据请用 --input-json。`。脚本解析必须先定位第一个 `{` 再 `JSON.parse`，直接解析会抛 `Unexpected token 'w'`。
+
+> **continuation 只有 600 秒有效期**：`prepare` / `auto-prepare` 签发后要尽快 `apply`，中间不要插入文档查询、多轮确认或其它耗时命令，否则会返回 `validation/continuation_expired`。遇到过期**重新 `prepare` 后立即 `apply`** 即可（用户已确认过的内容无需重新征询），**不要重放旧 continuation**。
+
+## 快速路径适用判断
+
+Agent 在决定走快速路径还是手工路径时，按以下规则判断：
+
+| 条件 | 走快速路径 | 走手工路径 |
+|------|------------|------------|
+| `workflow.resolve` 返回的 workFlowId = `100003460000000060`（总部费用报销） | ✅ | — |
+| workFlowId 不是 `100003460000000060` | — | ✅ |
+| `template.build` 返回 error 含 `structure_invalid` 或字段映射异常 | — | ✅（自动回退） |
+| 需要逐字段精细控制（如手动指定某行的费用科目） | — | ✅ |
+| 有事前申请需要绑定 | — | ✅（模板不做事前绑定） |
+| 无事前申请 + 总部费用报销流程 | ✅（优先） | — |
+
+> **⚠️ 快速路径的 `template.build` 和 `auto-prepare` 已内置挂单检查**：如果某张发票已挂在其他报销单上，`warnings` 会明确告知"继续组装存在重复报销风险"，Agent 应展示给用户确认。
+
+> **⚠️ 0.1.19 起 `contractNo` 默认值**：CLI 未收到 `contractNo` 入参时自动使用 `"20260999"` 并产生 warning，不再静默缺失。但仍建议显式传入以确保意图明确。
+
+## 与手工路径的关系
+
+- `invoice.reim.requests.list`（事前申请匹配）仍按 `reim-matching-rules.md` 走，模板不做事前申请绑定。
+- 其他流程（出差报销等）或需要逐字段精细控制的场景，仍走 `reim-workflow.md` / `reim-form-fill-rules.md` 的手工组装路径。

package/skills/weaver-e10-yepiaotong/references/reim-form-fill-rules.md

@@ -102,11 +102,12 @@
 
 ## detail_rows 填充规则
 
-来自 `invoice.reim.form.structure` 返回的 `subTables[0].subFields`（**只填第一个明细表**）。
+来自 `invoice.reim.form.structure` 返回的明细表列表 `subTables`。**不要机械取 `subTables[0]`** —— 部分流程（如总部费用报销 `100003460000000060`）返回多个明细表，`subTables[0]` 可能是「外包订单」等其他表。
 
-- **只填写 `subTables` 中第一个明细表（`subTables[0]`）的字段，其他明细表不用填值**
+- **必须先定位「费用明细」表**：优先按名称匹配（总部费用报销的「费用明细」`subFormId` = `100003690000000011`，排在 `subTables` 第 3 位）；名称拿不准时，取含 `EinvoiceComponent` 类型字段、且字段构成符合费用行（金额/日期/费用说明/相关发票）的明细表
+- **只填写定位到的「费用明细」表的字段，其他明细表（外包订单等）不用填值**
 - `dataIndex` 从 1 开始递增
-- `subFormId` = `subTables[0].subFormId`
+- `subFormId` = 费用明细表自身的 `subFormId`（按上面的定位结果取，**不是** `subTables[0].subFormId`）
 
 ### 过滤红冲发票（前置处理第一步）
 
@@ -142,7 +143,7 @@
 
 ### 明细行中的两个 EinvoiceComponent 字段
 
-`subTables[0].subFields` 中存在两个 `EinvoiceComponent` 类型的字段：
+费用明细表的 `subFields` 中存在两个 `EinvoiceComponent` 类型的字段：
 
 | 字段 | fieldType | single | 填入内容 |
 |------|-----------|--------|----------|
@@ -239,8 +240,8 @@
 | 部门/报销部门/部门ID/承担人部门 | 事前申请的 `creatorDepartmentId`，或当前用户部门 ID | 有数据就填 |
 | 相关流程/事前申请 | 事前申请的 `requestid` | 有数据就填 |
 | **承担主体** | **当前用户 ID（`creatorId`）** | **⚠️ 必填，永远不能为空** |
-| **报销人上级** | **`invoice.reim.employee-superiors` 返回的 `allSuperiors[0].id`（直接上级 ID，直接赋值）** | **⚠️ 必填，永远不能为空** |
-| **承担人直接上级** | **`invoice.reim.employee-superiors` 返回的 `allSuperiors[0].id`（直接上级 ID，直接赋值）** | **⚠️ 必填，永远不能为空** |
+| **报销人上级** | **`invoice.reim.employee-superiors` 返回的 `directSuperior.id`（直接上级 ID，直接赋值；取值口径见 [reim-workflow.md](reim-workflow.md#报销共享常量所有-reference-统一引用本节)）** | **⚠️ 必填，永远不能为空** |
+| **承担人直接上级** | **`invoice.reim.employee-superiors` 返回的 `directSuperior.id`（直接上级 ID，直接赋值；取值口径见 [reim-workflow.md](reim-workflow.md#报销共享常量所有-reference-统一引用本节)）** | **⚠️ 必填，永远不能为空** |
 | **承担人所有上级** | **`invoice.reim.employee-superiors` 返回的 `allSuperiors` 所有 `id` 用逗号拼接（如 `"id1,id2,id3"`）** | **⚠️ 必填，永远不能为空** |
 | **费用类型（科目）** | **优先 `invoice.reim.row-info` 返回的 `subjectId`；为空时按 [expense-subject-rules.md](reim-expense-subject-rules.md) 匹配，匹配不到用兜底 `"100502270000000104"`** | **⚠️ 必填，永远不能为空** |
 | 相关发票 | `invoiceId` | 必填 |
@@ -254,8 +255,8 @@
 > - **相关客户（出差流程）**：必须由用户提供具体客户后再填，未提供则**暂停且不允许调用 `invoice.reim.flow.create.prepare/apply`**，不能用固定值顶替
 > - **合同编号**：固定填 `"20260999"`，不需要从其他来源提取
 > - **承担主体**：使用当前用户 ID（`creatorId`）
-> - **报销人上级**：`invoice.reim.employee-superiors` 返回的 `allSuperiors[0].id`
-> - **承担人直接上级**：`invoice.reim.employee-superiors` 返回的 `allSuperiors[0].id`
+> - **报销人上级**：`invoice.reim.employee-superiors` 返回的 `directSuperior.id`
+> - **承担人直接上级**：`invoice.reim.employee-superiors` 返回的 `directSuperior.id`
 > - **承担人所有上级**：`invoice.reim.employee-superiors` 返回的 `allSuperiors` 所有 `id` 用逗号拼接
 
 ### 出差流程相关客户（硬拦截）
@@ -286,6 +287,18 @@
 5. **禁止**用固定值 `"100504500000311504"` 顶替出差的相关客户
 6. **禁止**把出差相关客户放入 `unable_to_fill` 后继续创建报销单
 
+### 话费补贴 / 话费报销（硬拦截）
+
+> **命中「话费补贴标准审批流程」或「话费报销」时，必须按 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md) 计算实报金额，禁止按发票原价填 Money 字段。**
+
+**如何判断（满足任一即可）：** `workFlowName` 含「话费补贴标准审批流程」或「话费报销」；事前申请名称含「话费补贴」或「话费报销」；用户明确说话费报销 / 话费补贴。
+
+**填单前必须齐备：** 本人实名制当月手机账单截图、账单构成、用户岗位对应的月度上限。缺任一则暂停，不允许进入 `invoice.reim.flow.create.prepare/apply`。
+
+**实报金额：** 先从账单构成中剔除「手机设备赠送套餐」「家庭宽带套餐」，再按 `min(可报销账单金额, 岗位月度上限)` 支付。低于标准按实际可报销账单支付，超过上限按上限支付。
+
+**Money 字段覆盖：** 本场景下明细/主表所有金额字段填上述实报金额，不填发票 `amount`。发票原始金额只用于核对，不得改写发票数据。
+
 ---
 
 ## 字段名称 → 数据来源映射表
@@ -304,11 +317,11 @@
 | **相关客户** | **按是否出差分流** | **非出差**：固定填 `"100504500000311504"`（泛微上海）。**出差流程**：必须提醒用户填写具体客户，拿到客户名称后搜索 ID 再填；用户未提供则不允许报销 |
 | **合同编号** | **固定值** | **固定填 `"20260999"`，不从其他来源提取，不能留空或放入 unable_to_fill** |
 | **承担主体** | **事前申请/当前用户** | **`creatorId`（marked=true），不能留空或放入 unable_to_fill** |
-| **报销人上级** | **`invoice.reim.employee-superiors`** | **`allSuperiors[0].id`（直接上级 ID，直接赋值），不能留空或放入 unable_to_fill** |
-| **承担人直接上级** | **`invoice.reim.employee-superiors`** | **`allSuperiors[0].id`（直接上级 ID，直接赋值），不能留空或放入 unable_to_fill** |
+| **报销人上级** | **`invoice.reim.employee-superiors`** | **`directSuperior.id`（直接上级 ID，直接赋值；取值口径见 [reim-workflow.md](reim-workflow.md#报销共享常量所有-reference-统一引用本节)），不能留空或放入 unable_to_fill** |
+| **承担人直接上级** | **`invoice.reim.employee-superiors`** | **`directSuperior.id`（直接上级 ID，直接赋值；取值口径见 [reim-workflow.md](reim-workflow.md#报销共享常量所有-reference-统一引用本节)），不能留空或放入 unable_to_fill** |
 | **承担人所有上级** | **`invoice.reim.employee-superiors`** | **`allSuperiors` 所有 `id` 用逗号拼接赋值（如 `"id1,id2,id3"`），不能留空或放入 unable_to_fill** |
 | 币种 | options 默认选项 | 默认选"人民币"的 optionValue |
-| 申请金额/人民币金额 | 发票 | 发票金额合计（所有**发票**的 `amount` 之和，不含相关凭证） |
+| 申请金额/人民币金额 | 发票 | 默认：发票金额合计（所有**发票**的 `amount` 之和，不含相关凭证）。**话费报销**：各行按 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md) 算出的实报金额之和 |
 
 ### 明细表字段映射
 
@@ -331,8 +344,9 @@
 | **相关凭证**（`EinvoiceComponent`, `single=true`） | **`invoice.reim.row-info` 优先** → 凭证配对 | 优先 `invoice.reim.row-info` 返回的 `itinerary`，回退到凭证配对逻辑；**无凭证则不填** |
 
 > **⚠️ 明细行金额字段填写规则（重要，容易遗漏）：**
-> 明细表中 `fieldType="Money"` 的字段，无论 `fieldName` 叫什么名字（实报金额、报销金额、申请金额、人民币金额、含税金额等），**全部统一填该行发票的 `amount`**。
-> 遍历 `subFields` 时，只要 `fieldType="Money"`，就填 `amount`，不要因为字段名不是"实报金额"就跳过。
+> 明细表中 `fieldType="Money"` 的字段，无论 `fieldName` 叫什么名字（实报金额、报销金额、申请金额、人民币金额、含税金额等），**默认全部统一填该行发票的 `amount`**。
+> 遍历 `subFields` 时，只要 `fieldType="Money"`，就填金额，不要因为字段名不是"实报金额"就跳过。
+> **例外：** 话费补贴 / 话费报销必须改填 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md) 算出的实报金额，不能填发票原价。
 
 ### 交通类发票费用说明特殊规则
 
@@ -353,28 +367,32 @@
 
 **4. 长度控制**：每个地名精简后控制在 10 字以内
 
-```
-示例：
-  from = "北京SKP（西2门）西北侧"
-  → 精简 = "北京SKP西2门"
-  （去掉"西北侧"冗余方位，括号内"西2门"是关键标识保留）
-
-  from = "泛微网络科技股份有限公司（北方大区业务运营中心）"
-  → 精简 = "泛微网络（北方运营中心）"
-  （去掉"科技股份有限公司"，括号内精简为核心部分）
-
-  from = "仁济医院南院区门诊部(南门)南侧", to = "浦江瑞和城柒街区30号"
-  → 费用说明 = "仁济医院南院-浦江瑞和城"
-  （去掉"门诊部""南门""南侧""柒街区30号"）
-
-  from = "虹桥机场T2航站楼出发层", to = "北京南站"
-  → 费用说明 = "虹桥机场T2-北京南站"
-  （去掉"航站楼出发层"，T2是关键标识保留）
-
-  from = "上海市闵行区三鲁公路3419号", to = "浦东国际机场T1航站楼到达层"
-  → 费用说明 = "三鲁公路-浦东机场T1"
-  （去掉门牌号"3419号"、"国际""航站楼到达层"）
-```
+**精简快速参考表**（按类型分组，覆盖常见场景）：
+
+| 原始地址 | 精简结果 | 处理说明 |
+|----------|----------|----------|
+| 仁济医院南院区门诊部(南门)南侧 | 仁济医院南院 | 去括号、去方位后缀、去附属设施 |
+| 浦江瑞和城柒街区30号 | 浦江瑞和城 | 去门牌号、去街区编号 |
+| 北京SKP（西2门）西北侧 | 北京SKP西2门 | 括号内"西2门"是出入口标识→保留；"西北侧"冗余→去 |
+| 虹桥机场T2航站楼出发层 | 虹桥机场T2 | T2是航站楼标识→保留；"航站楼出发层"冗余→去 |
+| 浦东国际机场T1航站楼到达层 | 浦东机场T1 | 去"国际"、"航站楼到达层" |
+| 上海市闵行区三鲁公路3419号 | 三鲁公路 | 去行政区划前缀、去门牌号 |
+| 泛微网络科技股份有限公司（北方大区业务运营中心） | 泛微网络（北方运营中心） | 去企业后缀，括号内精简保留 |
+| 北京南站 | 北京南站 | 已够短，原样保留 |
+| 上海南站地铁站2号出入口 | 上海南站 | 去"地铁站"、"出入口" |
+| 杭州萧山国际机场T3航站楼国内出发 | 萧山机场T3 | 去城市名（已在行程上下文中）、"国际"、"国内出发" |
+| 上海市浦东新区世纪大道100号环球金融中心 | 环球金融中心 | 去地址前缀，保留标志性建筑名 |
+| 中国人民解放军海军军医大学第一附属医院(长海医院) | 长海医院 | 括号内是通用简称→用简称 |
+| 上海火车站（北广场）东北侧 | 上海火车站 | 去广场方位和方向后缀 |
+
+**边界情况处理**：
+
+| 边界场景 | 处理方式 |
+|----------|----------|
+| from/to 只有经纬度或地址代码，无可读地名 | 跳过精简，回退到 `fysm` 或 `consumeContent` |
+| 精简后 from 和 to 相同（同一地点上下车） | 保留，写成 `{地点}` 而非 `{地点}-{地点}` |
+| from 或 to 为空 | 只写有值的那个，不加 `-` 分隔符 |
+| 地名含英文（如 Costco、IKEA） | 原样保留英文品牌名，不翻译 |
 
 > **注意**：交通类发票的费用说明**忽略** `invoice.reim.row-info` 返回的 `fysm` 和 `consumeContent`，只使用 `{出发地精简}-{目的地精简}`。如果 `invoice.get` 未返回 from/to，则回退到常规费用说明逻辑。
 
@@ -415,11 +433,12 @@
 1.5. **⚠️ 禁止 `*` 号**：所有填入报销单的文本值（费用说明、报销事由等）**禁止包含 `*` 符号**。从 `consumeContent` 等字段取值时必须先去掉所有 `*` 号（如 `*交通运输服务*客运服务费` → `交通运输服务客运服务费`）
 2. 设置 `work_flow_id` + `mainFormId` + 生成 `request_name`
 2.5. **⚠️ 出差流程拦截相关客户**：若判定为出差/差旅，先提醒用户填写具体相关客户；用户未提供则**停止组装，不允许进入 Step 5**。非出差才填固定值 `"100504500000311504"`
+2.6. **⚠️ 话费报销拦截**：若判定为「话费补贴标准审批流程」或「话费报销」，先按 [reim-phone-subsidy-rules.md](reim-phone-subsidy-rules.md) 核对账单截图、账单构成和岗位上限，再按标准计算实报金额；材料不齐或岗位未确认则**停止组装，不允许进入 Step 5**
 3. 遍历 `mainFields` → 推断值 → 有值加入 `main_fields`，多候选→`need_user_confirm`，无法推断→`unable_to_fill`
 4. **⚠️ 对每张发票调用 `invoice.reim.row-info` 获取预填信息**（详见 [reim-api-reference.md](reim-api-reference.md#56-获取发票明细行预填信息)）：
    - 入参：`cdzt`=当前用户ID，`requestid`=匹配到的事前申请ID（无则留空），`invoiceId`=发票ID
    - 返回的 `date`、`fysm`、`itinerary`、`subjectId` **优先使用**，只有返回为空/null时才回退到 AI 推断
-5. 每张**发票**（非凭证）= 一行明细（`dataIndex` 从 1 递增），**完整遍历 `subTables[0].subFields` 的每个字段**推断值
+5. 每张**发票**（非凭证）= 一行明细（`dataIndex` 从 1 递增），**完整遍历费用明细表（按上面规则定位）的 `subFields` 每个字段**推断值
 6. **每行必须填写**：费用类型（科目）、所有金额字段、费用日期、费用说明、相关发票等
 7. **每行必须将发票 `invoiceId` 赋值到 `EinvoiceComponent`+`single=false` 的字段**
 8. **相关凭证**：优先使用 `invoice.reim.row-info` 返回的 `itinerary`；如无返回，使用原有凭证配对逻辑

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

@@ -84,6 +84,10 @@
   - invoiceDate 在 createTime 后 7 天内 → 加满分
   - invoiceDate 在 createTime 后 7~30 天 → 加大部分分
   - invoiceDate 在 createTime 后 30~90 天 → 加少量分
+
+  **话费报销例外**：话费补贴事前申请可能在审批通过后长期有效，
+  不受 90 天窗口限制。只要 invoiceDate >= createTime 即可匹配，
+  不因时间距离远而降分。详见 reim-phone-subsidy-rules.md。
 ```
 
 ### 维度3：金额校验