weaver-work-cli 0.1.8 → 0.1.20

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：金额校验

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

@@ -0,0 +1,149 @@
+# 话费补贴 / 话费报销规范（硬拦截）
+
+> **命中「话费补贴标准审批流程」或「话费报销」时必须严格执行本文件，禁止按普通发票金额直接填单。**
+> **材料不齐、岗位标准未确认、或无法拆出可报销账单金额时，禁止调用 `invoice.reim.flow.create.prepare/apply`。**
+
+---
+
+## 何时适用（满足任一即可）
+
+| 判断依据 | 条件 |
+|----------|------|
+| 报销工作流名称 `workFlowName` | 含「话费补贴标准审批流程」或「话费报销」 |
+| 事前申请名称 `requestname` / `requestnametitle` | 含「话费补贴」或「话费报销」 |
+| 用户表述 | 明确说「话费报销」「话费补贴」 |
+
+> 通讯类发票（`expenseType` 含「通讯」、销方为「中国移动 / 中国联通 / 中国电信」）若已匹配到上述流程，同样适用。
+
+---
+
+## 必须提供的材料
+
+报销前必须同时具备：
+
+1. **本人实名制当月手机账单截图**
+2. **账单构成**（能区分基本套餐 / 通话流量 / 赠送套餐 / 家庭宽带等分项）
+
+缺少任一项时：
+
+1. **在 Step 5 之前必须暂停**
+2. 明确提醒用户：「话费报销必须提供本人实名制当月手机账单截图及账单构成，否则无法继续报销。」
+3. 用户补齐后再计算可报销金额
+4. 用户拒绝或不提供 → **结束报销流程，禁止创建报销单**
+
+涉及账单截图、图片或本地文件时，仍须先按 SKILL 提醒文件可能进入大模型上下文和 E10，等用户明确确认后再读取。
+
+---
+
+## 月度报销标准（上限）
+
+| 岗位 | 月度上限 |
+|------|----------|
+| 各条线负责人、EBU销售及项目负责人 | 350 元 |
+| 售前条线 | 200 元 |
+| 销售条线 | 200 元 |
+| 项目条线 | 200 元 |
+| 外勤为主的客服岗位 | 100 元 |
+| 外联业务为主的招聘岗位 | 100 元 |
+| 外联服务为主的司机 | 100 元 |
+| 专职内外服务的技术模块负责人、技术支持同仁或项目开发同仁 | 100 元 |
+| 涉及外勤或支撑服务较多的其他岗位 | 100 元 |
+
+岗位未确认时**禁止猜测**（尤其不要默认 350）。先问用户属于上表哪一类，确认后再算金额。
+
+标准按**自然月**分别封顶：一次报销多个月份时，每个月单独套用上限，不能把多个月的额度合并。
+
+---
+
+## 可报销金额怎么算
+
+1. 从账单构成中取出**当月手机账单合计**
+2. **剔除不属于报销范畴的费用**（见下表），得到「可报销账单金额」
+3. 与该岗位月度上限比较后支付：
+
+| 条件 | 实报金额 |
+|------|----------|
+| 可报销账单金额 **低于** 报销标准 | **按实际可报销账单金额**支付 |
+| 可报销账单金额 **超过** 标准上限 | **按上限标准**支付 |
+
+公式：`实报金额 = min(可报销账单金额, 岗位月度上限)`
+
+### 不属于报销范畴（必须剔除）
+
+- 手机设备赠送套餐费用
+- 家庭宽带套餐费用
+
+账单里混有上述项目、但构成不清、无法拆出可报销金额时：暂停询问用户确认分项，不要把整张账单或整张发票金额直接当实报金额。
+
+发票票面金额只作核对，**不是**话费报销的实报金额来源。发票金额可以高于实报金额；差额不得报销。
+
+---
+
+## 填单规则
+
+| 字段 | 怎么填 |
+|------|--------|
+| 明细所有 `fieldType="Money"`（实报金额、报销金额、申请金额等） | 填本规范算出的**实报金额**，不要填发票原价 |
+| 主表申请金额 / 人民币金额 | 各行实报金额之和 |
+| 费用类型（科目） | 通讯科目 `"100502270000000010"`（`invoice.reim.row-info` 的 `subjectId` 已是通讯类时可直接用） |
+| 费用说明 | 写清所属月份、可报销账单金额、岗位上限、实报金额，例如 `2026-08话费 账单280 上限200 实报200`（禁止 `*` 号） |
+
+> 这是「金额一律填发票 `amount`」的**唯一覆盖规则**，只适用于本规范命中的话费报销。发票原始 `amount` 仍须原样保留在上下文中，不得改写发票数据本身。
+
+向用户确认报销内容时，必须同时列出：
+
+| 展示项 | 说明 |
+|--------|------|
+| 发票金额 | 票面原值，仅供核对 |
+| 可报销账单金额 | 剔除赠送套餐、家庭宽带后 |
+| 适用岗位标准 | 上表对应上限 |
+| **实报金额** | `min(可报销账单金额, 上限)` |
+
+---
+
+## 事前申请查询：必须回溯 2~3 年
+
+话费补贴的事前申请（「话费补贴标准审批流程」）可能在很早以前发起，审批通过后长期有效，每月按标准报销。
+
+**默认 90 天回溯窗口不适用于话费报销。** 识别为话费报销后，`invoice.reim.requests.list` 的 `cusCreateDateStart` 必须至少往前推 **3 年**（1095 天）：
+
+```
+cusCreateDateStart = 最早发票 invoiceDate 往前推 1095 天（3 年）
+cusCreateDateEnd   = 最晚发票 invoiceDate
+```
+
+示例（发票日期 2026-09-20）：
+
+```json
+{
+  "pageNo": 1,
+  "pageSize": 20,
+  "requestname": "话费",
+  "cusCreateDateStart": "2023-09-20",
+  "cusCreateDateEnd": "2026-09-20"
+}
+```
+
+> 如果 3 年内仍查不到，可继续问用户是否有更早的事前申请，但不要猜测或跳过。
+
+### 匹配时间窗口同步放宽
+
+默认匹配规则要求 `invoiceDate 在 [createTime, createTime + 90天]`。**话费报销不适用此窗口**，因为一次审批可覆盖数年的月度报销。
+
+话费报销匹配时：
+- **取消 90 天窗口限制**：只要 `invoiceDate >= createTime`（发票日期不早于事前申请日期）即可匹配
+- 费用类型匹配仍然生效：`requestname` 含「话费」「通讯」即为匹配
+- 金额校验仍然生效（按月度上限核算后的实报金额与事前申请预算比较）
+
+---
+
+## 操作步骤
+
+1. 识别为话费补贴 / 话费报销后，**先不要创建报销单**
+2. 确认本人实名制当月账单截图和账单构成；缺则暂停索要
+3. 确认用户岗位对应的月度上限；未确认则暂停询问
+4. 按账单构成剔除赠送套餐、家庭宽带，算出可报销账单金额
+5. 按 `min(可报销账单金额, 上限)` 得到实报金额，展示给用户确认
+6. 查询事前申请时使用 **3 年回溯**（`cusCreateDateStart` 往前推 1095 天），用 `requestname="话费"` 缩小范围
+7. 匹配到事前申请后，用户确认，才允许进入 `invoice.reim.flow.create.prepare` → `.apply`
+8. 材料不齐、岗位未确认、账单构成无法拆分、或用户拒绝 → **结束流程，禁止创建**