weaver-work-cli 0.1.40 → 0.1.44

package/skills/weaver-e10-yepiaotong/references/invoice-issuing-workflow.md

@@ -1,199 +1,212 @@
-# AI 开票：获取待开票合同数据 → 开票流程草稿（主链路）
+# AI 开票：查询待开票合同 → 创建开票申请草稿
 
 ## 什么时候读取
 
-用户说"开票""开一下合同 XX 的票""把 XX 公司那份合同开票""按台账开票""发起开票流程"等开票意图时，**默认读取本文件**。
-
-**本文件是唯一开票链路（0.1.27 起）**：CLI 已移除 `invoice.issuing.make.prepare/apply`、`invoice.issuing.qys.prepare`、`invoice.issuing.result`，不再存在"直接开票""存待开台账"的接口。用户说"直接开票""不走流程""先存台账"时，一律按本链路发起开票流程草稿，并说明开票必须经所选开票流程审批后由流程侧完成；数据不在待开票合同数据里时，提示用户先录入合同商品信息。
+用户问"我有哪些待开票的合同""哪些合同还没开票""帮我开票""给 XX 合同开票"等开票意图时读取本文件。
 
 ## 链路概览
 
-本链路**不直接开票**：Agent 先获取待开票合同数据（含契约锁、泛微及其他合同），在 E10 按合同号发起「开票申请」流程并**存为草稿**；用户在 E10 核对后自己提交，审批通过后由流程侧完成开票。
+| 步 | 做什么 | 命令 | 所属技能 | 风险 |
+| --- | --- | --- | --- | --- |
+| 1 | 查我有权限看的合同审批流程 | `workflow.search` | `weaver-e10-workflow` | read |
+| 2 | 补齐是否开票、合同号、客户名称、开票金额、销售方 | `invoice.issuing.contracts.list` | 本技能 | read |
+| 3 | 列出待开票合同，问用户给哪份开票 | — | — | — |
+| 4 | 读选中合同的客户和合同正文文档 | `invoice.issuing.contract.detail` | 本技能 | read |
+| 5 | 按销售方选开票申请流程，问预计收款时间，向用户确认 | — | — | — |
+| 6 | 载入开票申请表单 | `workflow.createForm` | `weaver-e10-workflow` | read |
+| 7 | 存草稿 | `workflow.createRequest`（`action` 固定 `draft`） | `weaver-e10-workflow` | high-risk-write |
 
-| 步 | 命令 | 所属技能 | 风险 |
-| --- | --- | --- | --- |
-| 1 | `invoice.issuing.qys.list` | 本技能 | read |
-| 2 | `workflow.createForm` | `weaver-e10-workflow` | read |
-| 3 | `workflow.createRequest`（`action` 固定 `draft`） | `weaver-e10-workflow` | high-risk-write |
-| 修改 | `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply` | `weaver-e10-workflow` | high-risk-write |
+`workflow.*` 由同级的 `weaver-e10-workflow` 技能（`../weaver-e10-workflow/`）提供，命令契约以 [`workflow-query.md`](../../weaver-e10-workflow/references/workflow-query.md)、[`workflow-create.md`](../../weaver-e10-workflow/references/workflow-create.md) 为准。该技能不存在时停止并告知用户需要安装。
 
-流程的创建与修改依赖同级的 `weaver-e10-workflow` 技能（`../weaver-e10-workflow/`），命令契约与返回处置以 [`workflow-create.md`](../../weaver-e10-workflow/references/workflow-create.md)、[`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md) 为准。该技能不存在时停止并告知用户需要安装，不要改用直接开票或其他方式代替。
+**只建草稿，不提交。** 用户说"直接提交 / 直接开票"也只建草稿，并告诉用户在 E10 核对后自己提交。
 
-## 选哪个开票流程
+## Step 1：查合同审批流程（`workflow.search`）
 
-先按用户意图，再按销售方名称。`workflow.createForm` 传选中的 `名称(ID)`。**不要按宽词 `开票` 检索**：「合同开票申请」「发票开具」不是本链路的流程，宽词还会误中冲红流程。
+`category`、`workflow`、`pageSize` 固定。`current` 随翻页变化。`requestName` 可选：用户点名了客户、公司、地名、合同号或流程标题里的词时传入，按流程标题做模糊搜索；没点名就不传。
 
-| 情形 | 流程 |
+| 参数 | 值 |
 | --- | --- |
-| 用户要退票、冲红或红冲 | `合同开票冲红流程(887410479139758085)` |
-| 核算公司完全等于 `上海亘岩网络科技有限公司` | `契约锁合同收款发票开具及快递申请(100003460000001852)` |
-| 核算公司完全等于下面任一名称：`泛微网络`、`泛微软件`、`上海田亩`、`成都泛微`、`泛微国际`、`北京泛微`、`浙江泛微` | `合同收款发票开具及快递申请(100003460000000214)` |
-| 核算公司为空，或不在上面两档名单里 | 先问用户，选定前不建草稿 |
+| `category` | `"all"` |
+| `workflow` | `["老客户增值服务合同审批流程","新客户购买合同审批流程","常规二次销售服务合同审批流程"]` |
+| `pageSize` | `10` |
+| `current` | 默认 `1`；用户要下一页时 `+1` |
+| `requestName` | 可选。用户点名的检索词，如 `"鄂尔多斯"`。不传则不带该字段，按上面四项查。传入后对流程标题做 like 模糊匹配。翻页时原样带上 |
 
-销售方即所属公司，只取本组 `sellerNames`（台账「核算公司」）。名称必须与名单**完全相同**才算命中，不要自行补全或改写（`泛微网络` 不等于 `上海泛微网络科技有限公司`）。用户本轮说了销售方、所属公司或核算公司，以用户原话为准，仍按上表完全匹配。
+- 不要增删、改写这三个流程名，也不要把「合同」「开票」这类宽词当作 `requestName`。
+- 不要另传 `requestNameTerm`。不传时就是 like 模糊。
+- 返回澄清信封（流程名多命中 / 未匹配）时按 `workflow-query.md`「澄清后回传」处理，不要自行换流程。
+- 没传 `requestName` 且 `data.cards` 为空：告诉用户当前没有可查看的合同审批流程，**结束**。
+- 传了 `requestName` 且 `data.cards` 为空：告诉用户没有标题里包含该词的合同审批流程，问要不要去掉 `requestName` 再查。不要自动改词重试。
+- 只取 `data.cards` 进入 Step 2，`workflow.search` 的 `finalMarkdown` **不展示**给用户。
 
-- 非空名称去重后只有一个，且在名单里：用这个名称选流程。
-- 有多个不同名称：列出这些名称，请用户指定一个。没选定之前不建草稿。
-- 全部为空，或名称不在名单里：**不要默认选流程**。只问一句：「台账核算公司是空的（或不在已知名单里，当前是『{名称}』），销售方是哪家？『上海亘岩网络科技有限公司』走契约锁开票流程；泛微网络、泛微软件、上海田亩、成都泛微、泛微国际、北京泛微、浙江泛微走合同收款发票开具及快递申请。」用户给出名称后再按上表选择。
-- 退票、冲红、红冲优先于销售方判断，不按销售方改去上面两个开票流程。
+## Step 2：补齐开票信息（`invoice.issuing.contracts.list`）
 
-冲红不套用 [invoice-issuing-form-fill-rules.md](invoice-issuing-form-fill-rules.md)。`createForm` 后按返回字段的中文名填写；至少要有红冲原因和要冲的原开票流程，用户没给就先问，问齐再存草稿。`action` 仍固定 `draft`。
+把 Step 1 的 `data.cards` **原样**作为 `cards` 传入（一次最多 50 条），CLI 逐个 `requestId` 查询合同虚拟表，再把结果拼回每张卡片。只有 `requestId`、没有卡片时传 `requestIds`（字符串数组），二者只能传一个。
 
-两个开票流程的填单规则相同。下表字段 id 在契约锁流程上实测过；走到「合同收款发票开具及快递申请」时，用当次 `createForm` 里同中文名的字段 id，中文名对不上就不要借用另一条流程的 id。
+每张卡片保留 `workflow.search` 的原字段（`requestId`、`flowName`、`workflowName`、`finished` 等），并追加：
 
-| 常量 | 值 |
+| 字段 | 含义 |
 | --- | --- |
-| 关联字段 | 主表「合同号」；契约锁流程上的字段 id 是 `100003720000056343`，以 `createForm` 返回的 `fields` 按中文名「合同号」定位为准 |
-| 流程标题 `requestName` | `开票申请-{购方名称}-{合同号}` |
-| `action` | 固定 `draft` |
-
-载入后必须核对，**两条都满足才往下填**，否则停止并请用户确认流程：
+| `invoiced` | `false` = 待开票（合同虚拟表有开票明细）；`true` = 已开票（查不到明细） |
+| `contractNo` | 合同号 |
+| `customerName` | 客户（购方）名称 |
+| `invoiceAmount` | 开票金额：全部明细金额之和，两位小数字符串 |
+| `invoiceGroups[]` | 按分组标识汇总：`group`、`amount`（该组金额之和）、`items[]`（`name` 开票项目、`amount`） |
+| `buyerTaxNo` / `sellerName` | 购方税号 / 销售方名称（Step 5 按它选开票申请流程） |
 
-- `workflow.id` 等于上面选中的那条流程 ID；
-- 开票流程的 `fields` 里能按中文名找到主表「合同号」。冲红流程改为能按中文名找到红冲原因或相关开票流程。
+`invoiced=true` 时 `contractNo`、`customerName`、`invoiceAmount` 等都为 `null`，`invoiceGroups` 为空数组。顶层另有 `count`、`pendingCount`（待开票条数）、`invoicedCount`（已开票条数）。
 
-## 对话流程
+- 金额以 CLI 返回为准，**不要自己重新累加**，也不要从 `flowName` 里的「合同总金额」推算开票金额。
+- 返回业务错误时原样转述，不重试，**结束**。
 
-### Step 1：获取待开票合同数据（`invoice.issuing.qys.list`）
+## Step 3：列出待开票合同，问用户给哪份开票
 
-- 用户给了合同号 → 传 `contractNo`；给了公司名、合同名或商品名 → 传 `keyword`。这一步叫「获取待开票合同数据」，数据里有契约锁、泛微和其他合同的待开票行。命令 id 仍是 `invoice.issuing.qys.list`，返回的 `items` / `groups` 结构不变。
-- 用户什么线索都没给（只说"帮我开票"）→ **只问一句**："要给哪个合同开票？请提供合同号或客户名称。"不要追问购方、金额、税率——这些都由台账和流程联动带出。
-- 不要传 `limit` 去翻全量；分组看 `groups`，逐行明细才看 `items`。
-- 获取待开票合同数据返回 `api/business_error`「系统错误」（code 500）时，多半是当前登录租户里没有这份待开票合同数据：如实告知并请用户确认登录的 E10 租户，不要重试、不要换关键词再查。
+只列 `invoiced=false` 的卡片，序号按展示顺序重新从 1 编：
 
-### Step 2：按分组展示（`data.groups`）
+```text
+你的待开票合同（第 1 页，共 3 条待开票，2 条已开票未列出）：
+| 序号 | 合同流程 | 合同号 | 客户名称 | 开票金额 | 流程状态 |
+| 1 | 天洋新材技术服务合同 | 20260100909 | 天洋新材（上海）科技股份有限公司 | 133000.67（分组 1：133000.34；分组 2：0.33） | 审批中 |
+要给哪份合同开票？回序号即可。
+```
 
-`groups` 已按「合同号 + 购方」分好组，**一组 = 一张开票流程**；`totalAmount` 是 CLI 按分累加的开票金额合计（台账开票金额为**含税**金额），**Agent 不做任何金额计算**。
+- 「合同流程」取 `flowName`，去掉末尾「（ 合同号 ： … ， 合同总金额： … ）」括注。
+- 「开票金额」写 `invoiceAmount`；`invoiceGroups` 多于一组时在后面括注各组 `amount`，只有一组时不括注。
+- 「流程状态」：`finished=true` 写"已结束"，否则写"审批中"。
+- 本页 `pendingCount=0`：告诉用户"本页的合同都已开票"；`hasMore=true` 时问是否看下一页。
+- Step 1 返回 `hasMore=true` 时末尾加一句"回『下一页』看更多"；用户要下一页时 `current+1` 重走 Step 1～3，本轮传过 `requestName` 就原样带上，**不要自动翻完所有页**。
+- 用户已经说了客户名、公司名、地名、合同号或标题关键词：Step 1 把该词放进 `requestName` 再查，不要先无条件拉全量再在本地挑。返回后仍按 `customerName` / `contractNo` / `flowName` 核对：只命中一条就直接用这条进 Step 4；命中多条只列命中的让用户选；本页没有且 `hasMore=true` 时带着同一个 `requestName` 翻页，最多查到第 5 页。
+- 用户只是查询、没有要开票时，列完即可，不追问。
+- 用户问某份合同的开票明细时，按 `invoiceGroups[].items` 逐行列出开票项目和金额。
+- **不替用户选合同。** 一次只处理一份；用户要多份时逐份走 Step 4～7。
 
-| `groups` 条数 | 处置 |
-| --- | --- |
-| 0 | 用 `includeIssued=true` 再查**一次**，按组展示 `blockedRows` 与对应 `items[].blockers`（已开票 / 已关联开票流程 / 开票中 / 已废弃），说明这份合同当前没有可开票的行，**结束**。 |
-| 1 | 直接进 Step 3 确认卡片。 |
-| 多条 | 列出分组让用户选（合同号、合同审批流程、购方、销售方、行数、商品、开票金额合计），**不要替用户选**；一次只处理一组。 |
+## Step 4：读合同客户和合同正文（`invoice.issuing.contract.detail`）
 
-`scanComplete=false` 时提醒用户：台账超过扫描上限，结果可能不全。
+入参只有用户选中那条卡片的 `requestId`。CLI 读该合同审批流程的详情（不标记已读），返回：
 
-**税号与发票类型硬拦截**：选定的分组 `specialInvoiceWithoutTaxNo=true`（购方没有税号，台账发票类型却是专票）时，**不展示确认卡片、不发起流程**。只告诉用户：「{购方名称} 没有税号，不能开专票，只能开普票。请先把台账里这份合同的发票类型改成普票（如全电普票），再让我发起。」用户改完台账后从 Step 1 重新查。
+| 字段 | 含义 |
+| --- | --- |
+| `requestName` | 合同审批流程标题 |
+| `customer` | `{id, name}`：取「客户名称」，新客户购买合同没有该字段时取「最终用户卡片」；都没有为 `null` |
+| `customerSource` | `customer` 取自哪个字段 |
+| `contractDocuments[]` | 「合同正文及附件」里的每个文件：`docId`（文档 id）、`fileId`、`name` |
+| `contractDocIds` | 全部 `docId` 用英文逗号连起来；一个都没有为 `null`。开票申请「合同文本」不要填这个字符串 |
 
-- 不要在流程里把「发票类型」改成普票来绕过：发票类型由合同号联动带出，联动值优先，Agent 传的值会被覆盖。
-- 用户坚持要开专票时，说明专票必须有购方税号，请先在台账补全税号。
+返回业务错误时原样转述，不重试，**结束**。
 
-### Step 3：确认卡片（创建前唯一一次确认）
+## Step 5：选开票申请流程，问预计收款时间，向用户确认
 
-按下面模板展示，等用户明确回复"确认""发起""好的"等同义确认后再往下走：
+按 Step 2 卡片的 `sellerName` 选：
 
-```text
-将为以下合同发起「开票申请」流程（只存草稿，不会直接开票）：
-
-合同号：20266105541（南昌我爱我家科技有限公司开放平台续购20000元10000份）
-购方：南昌我爱我家科技有限公司　税号：91360125083909438T
-销售方：上海亘岩网络科技有限公司
-开票流程：契约锁合同收款发票开具及快递申请
-发票类型：全电专票
-| 序号 | 商品 | 税率 | 开票金额（含税） |
-| 1 | 技术服务费 | 6.0% | 20000 |
-开票金额合计（含税）：20000.00（共 1 行）
-
-本次开票金额：20000（默认按总金额开）
-开票事由：合同20266105541（南昌我爱我家科技有限公司开放平台续购20000元10000份）技术服务费全额开票，金额20000元
-开票内容：技术服务费（按货物名称「技术服务费」匹配）
-预计收款时间：（必填）请选择：本月底 2026-10-31 / 下月底 2026-11-30 / 30 天后 2026-11-22，或直接给一个日期
-请回复预计收款时间并确认发起。
-```
+| `sellerName` | 开票申请流程 |
+| --- | --- |
+| 含「亘岩」（上海亘岩网络科技有限公司，合同虚拟表里可能是简称） | `契约锁合同收款发票开具及快递申请(100003460000001852)` |
+| 其他 | `合同收款发票开具及快递申请(100003460000000214)` |
 
-- `group.purchaserBankName` 或 `group.purchaserBankAccount` 非空时，在「购方」行下加一行 `开户行：{purchaserBankName}　账号：{purchaserBankAccount}`，两个值分开写，不要用台账原始的混写串。
-- 「销售方」「开票流程」两行按「选哪个开票流程」填写。核算公司为空、不在名单里，或有多个不同名称时，先按该节问用户，选定前不展示这条确认卡片、不建草稿。
-- 明细表的行取该组 `formDataIds` 对应的 `items[]`：商品取「开票名称」，为空取「商品名称」；金额取 `amount` 原值，不改写。
-- 模板里的「开票内容」行只属于 `契约锁合同收款发票开具及快递申请`。其他流程没有这个字段，确认卡片不写这一行，也不推断、不问。
-- 「开票事由」按填单规则自动生成并展示在卡片里，不问用户；「预计收款时间」由用户决定，卡片里附上按当天日期算好的本月底、下月底、30 天后三个候选日期。**用户没给出日期就不建草稿**：只回"确认 / 继续"时再问一句，拿到日期再往下走；不要自己定默认日期，也不要留空先建（详见填单规则「预计收款时间」）。用户开票时已说了收款时间，卡片里直接展示换算后的日期，末行改为"确认发起吗？"。
-- `warnings` 非空时在卡片末尾逐条列出。命中"同合同另有 N 行已开票…"时追加一句："流程按合同号联动，可能一并带出这些行，请在 E10 草稿里核对明细。"
-- 用户要改购方、金额、税率或商品 → 告知需先在台账修改，再重新从 Step 1 开始；**不要在流程里手工覆盖这些值**。
+不要让用户改选流程，也不要按宽词"开票"检索流程。
 
-### Step 4：载入开票流程表单（`workflow.createForm`）
+### 5.1 问预计收款时间（必问）
 
-- `workflow` 传「选哪个开票流程」里选中的 `名称(ID)`；**不传 `userQuestion`**，也不用 `workflow.createRequestDirect`。
-- 载入后按「选哪个开票流程」里的两条核对规则检查 `workflow.id` 与「合同号」字段（冲红流程改查红冲原因或相关开票流程）；不满足就停止，不往下填，也不要换别的流程凑。
-- `createForm` 返回 OA 业务错误（如表单布局接口报错）时如实转述并停止，不重试、不换流程。
+**用户没给出预计收款时间之前，不进 Step 6。** 用户在前面的对话里还没说过时，先只问这一句：
 
-### Step 5：组装 `data` 并存草稿（`workflow.createRequest`）
+```text
+这份合同的预计收款时间是哪天？（超期未收回款项的发票会直接作废）例如 2026-12-31。
+```
 
-`data` 按 [invoice-issuing-form-fill-rules.md](invoice-issuing-form-fill-rules.md) 组装，一句话概括：**用户说了就按用户的，没说就按默认值**。创建时的默认值包括：合同号、相关合同审批流程、产品类型「契约锁」、开票日期取当天、开票备注填合同号、所售产品版本号取明细规格类型（须与下拉选项完全一致）、开票事由按公式自动生成；预计收款时间填用户在卡片环节给的日期（必须有，没有就回到 Step 3 问）。「开票内容」只在 `契约锁合同收款发票开具及快递申请(100003460000001852)` 上按明细货物名称推断并填写，其他流程忽略。明细每行**只传**「本次开票金额」（契约锁流程上的中文名是「金额（含税）」）。用户没指定金额时，默认等于**该明细行自己的**「总开票金额」（台账该行开票金额）。有多行就按「明细行id」各传各的，不要只传一行、也不要把一行的金额写到另一行。货物名称、购买方名称、明细合同号、明细行id、单价、规格类型、单位、税率、总开票金额、已开票金额、未开票金额都由合同号联动带出，**传了反而会让总开票金额等三列带不出来**。
+- 统一转成 `yyyy-MM-dd`。"月底""下个月 15 号"这类说法按今天的日期换算成具体日期，在 5.2 里写出换算结果让用户确认。
+- 不替用户猜，不用开票日期、合同日期或任何默认值代替，也不能留空。用户说"不知道 / 以后再填"时，说明这一项必须先给，没有就不建草稿。
+- 说不清是哪天（如"年底前后"）或日期无效时，再问一次具体日期。
 
-明细「数量」、主表「开户行名称」「开户行银行帐号」创建时**不传**：
-- 联动会把数量写成税率选项 id。
-- 联动会把开户行写成名称账号混写串。
+### 5.2 确认（只问这一次）
 
-「开票内容」只在 `契约锁合同收款发票开具及快递申请` 创建时传入，取值见填单规则「开票内容推断」。多个货物名称对上不同选项时，先在确认卡片里问用户，选定前不建草稿。其他流程不传这个字段。
+```text
+将为这份合同创建「合同收款发票开具及快递申请」草稿（只存草稿，不会提交）：
+合同流程：深圳市蓝禾技术有限公司-增值服务购买合同-52500-林玉婷-2026-09-18（合同号 20260114549，开票金额 52500.00）
+合同客户：深圳市蓝禾技术有限公司
+合同文本：深圳市蓝禾技术有限公司用户数采购合同_20260914_v1.1.docx
+预计收款时间：2026-12-31
+确认创建吗？
+```
 
-开户行两个字段在 Step 6 第 5 条经编辑链补正。契约锁流程上的开票内容不要再经编辑链改（`editPrepare` 会报错）。只有这条流程没推断出来时，才在 Step 6 第 6 条提醒用户在 E10 里选。数量仍在第 6 条提醒。其余购方信息不传；金额(不含税)、税额不传、不计算。
+- 「合同文本」列出 `contractDocuments[].name`，多个用"、"连接；`docId` 为 `null` 的文件不列。
+- `customer` 为 `null` 时写"合同客户：未取到，草稿建好后请在 E10 里选择"；没有任何 `docId` 非空的合同文件时，「合同文本」同样这样写。
+- 用户确认 → Step 6。用户改了预计收款时间 → 按新日期再确认一次。用户说"取消 / 不开了" → 停止。
 
-- `requestName` **必传**：`开票申请-{购方名称}-{合同号}`，不留用表单默认标题。
-- `action` 固定 `"draft"`：用户说"直接提交"也只建草稿，并告诉用户去 E10 核对后提交。
+## Step 6：载入开票申请表单（`workflow.createForm`）
 
-`data` 较大时写成 UTF-8 JSON 文件用 `--input <path>` 传入。
+- `workflow` 传 Step 5 选定的 `名称(ID)`；**不传 `userQuestion`**，不用 `workflow.createRequestDirect`。
+- 核对 `workflow.id` 与选定的 ID 一致；不一致就停止并告诉用户。
+- 按中文名在 `fields` 里找主表字段 id（下表 id 为当前环境实测值，以 `fields` 为准）；某个字段找不到就不填它，建完草稿后提醒用户在 E10 里填。
 
-### Step 6：回显与核对
+| 要填的值 | 合同收款发票开具及快递申请 | 契约锁合同收款发票开具及快递申请 |
+| --- | --- | --- |
+| 合同审批流程 | 「合同流程」`100501872195629954` | 「相关合同审批流程」`100003720000056262` |
+| 客户 | 「合同客户」`100501873639686776` | 「合同客户」`100003720000056240` |
+| 合同正文文档 | 「合同文本」`100501873669461025` | 「相关合同(与开票金额相关的合同)」`100003720000056261` |
+| 预计收款时间 | 「预计收款时间（超期未收回款项的发票会直接作废）」`100501870975576757` | 「预计收款时间」`100003720000056250` |
+| 合同号 | 不传（见 Step 7） | 「合同号」`100003720000056343` |
 
-1. 按 `workflow-create.md`「createRequest 返回后的处置」处理：`CREATED` / `NEEDS_INPUT` / `BROWSER_FILL` 有 `finalMarkdown` 就**原样粘贴**；`NEEDS_CONFIRMATION` 按 `ambiguities` 处理；`partial` / `write_uncertain` 停止，只读回查一次。
-2. `CREATED` 后用返回的 `linkageResult`（一段「字段联动带出：字段=值、…」文本）核对联动结果。明细其余列由联动写入，`previewDetails` 里只有 Agent 自己填的金额，属正常。只核对三项：
-   - 含「是否存在合同明细数据=存在」；
-   - 含「总开票金额=」和「货物名称=」（明细整行已从台账带出）；
-   - 「本次开票总金额」等于本次填入各行「金额（含税）」之和；按默认值开时，它等于 `group.totalAmount`。数值比较时 `5900.00` 与 `5900` 视为相等。
+- `createForm` 返回 OA 业务错误时原样转述并停止，不重试。
 
-   另外用 `editLoad` 的 `currentValues` 核对每一明细行：「本次开票金额」为空，或不等于该行「总开票金额」时，按填单规则「创建后补正」补成该行「总开票金额」，只改这一列。补完后「本次开票总金额」应等于各行「本次开票金额」之和。
+## Step 7：存草稿（`workflow.createRequest`）
 
-   三项都满足、且每行「本次开票金额」已经等于该行「总开票金额」时**不额外说明**。补完仍不一致时，在 `finalMarkdown` 之后**只追加一行**：`⚠️ 流程汇总的本次开票总金额为 X，与本次填写的开票金额 Y 不一致（或未带出合同明细），请在 E10 核对后再提交。`
-3. `missingFields` 非空时原样转述（提交前需补齐）；`finalMarkdown` 末尾已有这段提示时不要重复。
-4. `BROWSER_FILL`（小e 环境）只输出那段 `<browsertool>` 标签块，不做第 2 步核对。
-5. **补正开户行名称与账号**（`CREATED` 后都要做，取值规则见填单规则「创建后补正」）：
-   - `workflow.editLoad` 读草稿（`requestId` 取创建返回值），从 `currentValues` 取主表「开户行名称」「开户行银行帐号」「开户行及帐号」，以及每行「明细行id」「数量」（第 6 条要用）。
-   - 算出补正值：取 `group.purchaserBankName` / `group.purchaserBankAccount`，为空时拆「开户行及帐号」。已经相同就不提交。
-   - 有要补的：`workflow.editPrepare` **只传主表这两个字段**，不传任何明细、不传开票内容。然后向用户列出补正项，并问「要把开户行名称和账号分开补进草稿吗？」，用户确认后 `workflow.editApply`。
-   - 「开户行及帐号」格式无法拆分时不补这两项，告诉用户原值，请其在 E10 里手工拆填。
-   - `editPrepare` / `editApply` 报错时原样转述，不重试；草稿本身已建好，不受影响。
-6. **提醒用户在 E10 里改的项**：在本轮回复末尾加一段「提交前请在 E10 里改」。只有 `契约锁合同收款发票开具及快递申请` 才处理开票内容：已经写入时不提；没推断出来才写「开票内容：明细货物名称没有对应的下拉选项，请在 E10 里选择」。其他流程不要提开票内容。数量按填单规则提醒，如：
+`data.main` **只放下面这几项**：
 
-   ```text
-   提交前请在 E10 里改：
-   - 明细第 1 行数量：联动带出的是 1201835186337538063，请在 E10 改成 1
-   ```
+| 字段 | 值 | 什么时候传 |
+| --- | --- | --- |
+| 合同审批流程 | `{"id":"<requestId>","name":"<requestName>"}`（Step 4） | 必传 |
+| 客户 | `{"id":"<customer.id>","name":"<customer.name>"}`（Step 4） | `customer` 非 `null` |
+| 合同正文文档 | 与合同流程相同的 `{"id":"<docId>","name":"<文件名>"}`。`id` 取 `contractDocuments[].docId`，`name` 取同项 `name`。只有一个文件时传这一个对象；多个文件时传对象数组 | 至少有一个 `docId` 非空 |
+| 预计收款时间 | 用户在 Step 5 确认的日期，`"yyyy-MM-dd"` | 必传 |
+| 合同号 | Step 2 卡片的 `contractNo`，原样字符串 | 仅契约锁流程，且 `contractNo` 非 `null` |
 
-   没有要改的项就不要加这段。不要为了开票内容或数量调用 `editPrepare`。
+- 「合同收款发票开具及快递申请」的「合同号」是带浏览按钮的文本字段，`workflow.createRequest` 写不进去：传字符串会在浏览按钮里查不到而返回 `NEEDS_CONFIRMATION`，传 `{id,name}` 草稿里仍为空。这张表**不传合同号**，由「合同流程」联动带出。
+- 其余字段（税号、开票地址、开户行、发票类型等）由联动带出或用表单默认值，**Agent 不填、不算、不覆盖**。
+- `requestName` 不传，用表单自带的标题；`action` 固定 `"draft"`。
+- 返回按 `workflow-create.md`「createRequest 返回后的处置」处理：`CREATED` / `NEEDS_INPUT` / `BROWSER_FILL` 有 `finalMarkdown` 就原样粘贴；`NEEDS_CONFIRMATION` 按 `ambiguities` 处理；`partial` / `write_uncertain` 停止，只读回查一次，**禁止重放 `createRequest`**。
+- 合同文本和合同流程一样传 `{id, name}`，文档控件可以关联上。不要传 `contractDocIds` 逗号串，也不要只传数字 id；`docId` 或 `name` 为空的文件不放进这个值。
+- `finalMarkdown` 提示「合同号」未填时，再补一句"合同号请在 E10 草稿里选择：{contractNo}"。Step 5 里未取到的客户同样补一句提醒。
 
-### Step 7：之后的操作
+### 之后的操作
 
-- **禁止重复创建**：同一合同 `createRequest` 成功后，不要再次 `createForm` + `createRequest`；修改一律走 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply`。
-- 用户问"开出来了吗 / 发票号是多少"：说明开票在流程审批通过后由流程侧完成，请在 E10 查看该流程；CLI 已无 `invoice.issuing.result`，不要尝试用 `QYS-{formDataId}` 查开票结果。
-- 用户中途说"取消 / 不开了" → 立即停止；草稿已创建时告知可在 E10 通过链接删除。
+- **禁止重复创建**：同一份合同 `createRequest` 成功后，不要再次 `createForm` + `createRequest`。要改字段一律走 `workflow.editLoad` → `workflow.editPrepare`（只传要改的字段）→ 用户确认 → `workflow.editApply`。
+- 用户问"开出来了吗 / 发票号是多少"：说明开票在草稿提交、审批通过后由流程侧完成，请在 E10 查看该流程。
 
 ## 命令
 
-下面这条是核算公司为「上海亘岩网络科技有限公司」时的开票草稿。核算公司是泛微网络、泛微软件、上海田亩、成都泛微、泛微国际、北京泛微、浙江泛微之一时，把 `workflow.createForm` 的流程换成 `合同收款发票开具及快递申请(100003460000000214)`，`data` 里的字段 id 改成该流程 `createForm` 返回的同中文名 id。
-
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.issuing.qys.list --input-json '{"contractNo":"20266105586"}'
-weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["契约锁合同收款发票开具及快递申请(100003460000001852)"]}'
+weaver-work-cli --json workflow run workflow.search --input-json '{"category":"all","workflow":["老客户增值服务合同审批流程","新客户购买合同审批流程","常规二次销售服务合同审批流程"],"pageSize":10,"current":1}'
+weaver-work-cli --json workflow run workflow.search --input-json '{"category":"all","workflow":["老客户增值服务合同审批流程","新客户购买合同审批流程","常规二次销售服务合同审批流程"],"pageSize":10,"current":1,"requestName":"鄂尔多斯"}'
+cat > ./issuing-contracts.json <<'JSON'
+{
+  "cards": [
+    {
+      "index": 1,
+      "requestId": "1316385507701719135",
+      "flowName": "深圳市蓝禾技术有限公司-增值服务购买合同-52500-林玉婷-2026-09-18  （ 合同号 ： 20260114549 ， 合同总金额 ： 52500.00）",
+      "workflowId": "1283761687634100307",
+      "workflowName": "常规二次销售服务合同审批流程",
+      "finished": true
+    }
+  ]
+}
+JSON
+weaver-work-cli --json invoice run invoice.issuing.contracts.list --input ./issuing-contracts.json
+weaver-work-cli --json invoice run invoice.issuing.contract.detail --input-json '{"requestId":"1316385507701719135"}'
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["合同收款发票开具及快递申请(100003460000000214)"]}'
 cat > ./issuing-request.json <<'JSON'
 {
   "context": "<createForm 返回的 continuation>",
-  "requestName": "开票申请-深圳市康哲药业有限公司-20266105586",
   "action": "draft",
   "data": {
     "main": {
-      "100003720000056343": "20266105586",
-      "100003720000056262": "深圳市康哲药业有限公司2026年度维护(1327967410806063252)",
-      "100003720000056342": "契约锁",
-      "100003720000056243": "年度维护费",
-      "100003720000056255": "2026-10-23",
-      "100003720000056250": "2026-11-30",
-      "100003720000118915": "20266105586",
-      "100003720000056252": "合同20266105586（深圳市康哲药业有限公司2026年度维护）年度维护费全额开票，金额5900元"
-    },
-    "details": {"100003690000001811": [{
-      "100003720000118901": "5900"
-    }]}
+      "100501872195629954": { "id": "1316385507701719135", "name": "深圳市蓝禾技术有限公司-增值服务购买合同-52500-林玉婷-2026-09-18" },
+      "100501873639686776": { "id": "100504500000364509", "name": "深圳市蓝禾技术有限公司" },
+      "100501873669461025": { "id": "2008969490679427312", "name": "深圳市蓝禾技术有限公司用户数采购合同_20260914_v1.1.docx" },
+      "100501870975576757": "2026-12-31"
+    }
   }
 }
 JSON
@@ -203,36 +216,62 @@ weaver-work-cli --json workflow run workflow.createRequest --input ./issuing-req
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.issuing.qys.list --input-json '{"contractNo":"20266105586"}'
-weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["契约锁合同收款发票开具及快递申请(100003460000001852)"]}'
+weaver-work-cli --json workflow run workflow.search --input-json '{"category":"all","workflow":["老客户增值服务合同审批流程","新客户购买合同审批流程","常规二次销售服务合同审批流程"],"pageSize":10,"current":1}'
+weaver-work-cli --json workflow run workflow.search --input-json '{"category":"all","workflow":["老客户增值服务合同审批流程","新客户购买合同审批流程","常规二次销售服务合同审批流程"],"pageSize":10,"current":1,"requestName":"鄂尔多斯"}'
+Set-Content -Encoding utf8 -LiteralPath .\issuing-contracts.json -Value @'
+{
+  "cards": [
+    {
+      "index": 1,
+      "requestId": "1316385507701719135",
+      "flowName": "深圳市蓝禾技术有限公司-增值服务购买合同-52500-林玉婷-2026-09-18  （ 合同号 ： 20260114549 ， 合同总金额 ： 52500.00）",
+      "workflowId": "1283761687634100307",
+      "workflowName": "常规二次销售服务合同审批流程",
+      "finished": true
+    }
+  ]
+}
+'@
+weaver-work-cli --json invoice run invoice.issuing.contracts.list --input .\issuing-contracts.json
+weaver-work-cli --json invoice run invoice.issuing.contract.detail --input-json '{"requestId":"1316385507701719135"}'
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["合同收款发票开具及快递申请(100003460000000214)"]}'
 Set-Content -Encoding utf8 -LiteralPath .\issuing-request.json -Value @'
 {
   "context": "<createForm 返回的 continuation>",
-  "requestName": "开票申请-深圳市康哲药业有限公司-20266105586",
   "action": "draft",
   "data": {
     "main": {
-      "100003720000056343": "20266105586",
-      "100003720000056262": "深圳市康哲药业有限公司2026年度维护(1327967410806063252)",
-      "100003720000056342": "契约锁",
-      "100003720000056243": "年度维护费",
-      "100003720000056255": "2026-10-23",
-      "100003720000056250": "2026-11-30",
-      "100003720000118915": "20266105586",
-      "100003720000056252": "合同20266105586（深圳市康哲药业有限公司2026年度维护）年度维护费全额开票，金额5900元"
-    },
-    "details": {"100003690000001811": [{
-      "100003720000118901": "5900"
-    }]}
+      "100501872195629954": { "id": "1316385507701719135", "name": "深圳市蓝禾技术有限公司-增值服务购买合同-52500-林玉婷-2026-09-18" },
+      "100501873639686776": { "id": "100504500000364509", "name": "深圳市蓝禾技术有限公司" },
+      "100501873669461025": { "id": "2008969490679427312", "name": "深圳市蓝禾技术有限公司用户数采购合同_20260914_v1.1.docx" },
+      "100501870975576757": "2026-12-31"
+    }
   }
 }
 '@
 weaver-work-cli --json workflow run workflow.createRequest --input .\issuing-request.json
 ```
 
-## 注意
+`cards` 数组填 Step 1 返回的 `data.cards` 全部条目。上面第一条 `workflow.search` 是默认查询，不传 `requestName`。第二条只在用户点名了检索词时使用，`requestName` 按流程标题模糊搜索，例如「鄂尔多斯」。契约锁流程把 `createForm` 的 `workflow` 换成 `契约锁合同收款发票开具及快递申请(100003460000001852)`，`main` 的键换成 Step 6 表里契约锁那一列的字段 id，并加上合同号 `"100003720000056343": "<contractNo>"`。
+
+## 示例
+
+**用户**：帮我开票
+
+**AI**：`workflow.search`（`category=all`、三个合同审批流程、`pageSize=10`，不传 `requestName`）→ 把 `data.cards` 传给 `invoice.issuing.contracts.list` → 按 Step 3 的格式列出 `invoiced=false` 的合同，问给哪份开票。
+
+**用户**：1
+
+**AI**：`invoice.issuing.contract.detail`（第 1 条的 `requestId`）→ `sellerName` 是「泛微网络」，选「合同收款发票开具及快递申请」→ 按 Step 5.1 问预计收款时间。
+
+**用户**：12 月底
+
+**AI**：换算成 `2026-12-31`，按 Step 5.2 的格式（含「预计收款时间：2026-12-31」）请用户确认。
+
+**用户**：确认
+
+**AI**：`workflow.createForm` → 核对流程 ID、按中文名找到字段 → `workflow.createRequest`（`action="draft"`，`main` 填合同流程、合同客户、合同文本 `{id, name}`、预计收款时间；契约锁流程再加合同号）→ `CREATED` → 原样粘贴 `finalMarkdown`。`finalMarkdown` 提示合同号未填或客户未取到时，再按 Step 7 补提醒。
+
+**用户**：给鄂尔多斯开票
 
-- 台账里的合同号、购方、税号、金额、税率按原值使用，**不改写、不补位、不格式化**。
-- 本链路不读取、不上传任何附件或图片；用户另外提供文件要求"按文件开票"时，说明当前只支持按待开票合同数据发起开票流程，需先把数据录入后再获取。
-- 一次只发起一组（一张流程）；用户要求多份合同一起开时，逐组走 Step 3～6，每组各调一次 `createForm`，`continuation` 不跨组复用。
-- 写请求已发出但结果不确定时按 SKILL.md「写操作失败处理」处理，**禁止重放 `createRequest`**。
+**AI**：`workflow.search`（`category=all`、三个合同审批流程、`pageSize=10`、`requestName="鄂尔多斯"`，按流程标题模糊搜索）→ 把 `data.cards` 传给 `invoice.issuing.contracts.list` → 只列 `invoiced=false` 的命中合同。一条就进 Step 4，多条让用户选。

package/skills/weaver-e10-yepiaotong/references/invoice-output-view.md

@@ -1,4 +1,4 @@
-# 发票输出投影与渲染（--format / --view / --fields）
+# 发票输出投影（--view / --fields）
 
 ## 什么时候读取
 
@@ -6,48 +6,36 @@
 
 不读本文件的场景：写操作（导入/新增/编辑/删除/报销填单）——这些按各自 reference 处理；单张发票详情见 `invoice-detail.md`。
 
-## 三层出口：渲染档 / 语义视图 / 点路径投影
+## 两种出口：语义视图 / 点路径投影
 
 | 出口 | 用途 | 输出形态 |
 |---|---|---|
-| `--format markdown` | **要在对话里展示给用户时首选** | markdown 文本（表格/卡片），非 JSON |
-| `--view summary`（列表）/ `--view detail`（`invoice.get`） | 要给程序消费的语义化数据 | JSON envelope，字段口径已固化 |
+| `--view summary`（列表）/ `--view detail`（`invoice.get`） | **默认首选**：展示给用户或交给下游判断 | JSON envelope，字段口径已固化 |
 | `--fields a,b.c` | 精确控制字段或用于无视图的 operation | JSON envelope，保持原嵌套 |
 
-三者的取舍：**给人看 → `--format markdown`；给下游代码看 → `--view`；只在特殊字段需求下才用 `--fields`。**
+取舍：**默认用 `--view`；只在特殊字段需求下才用 `--fields`。**
 
 ## 为什么需要投影
 
 `invoice.list` / `invoice.enterprise.list` 的默认输出是**面向程序的完整包络**：单条发票 40+ 字段（`custom_field_*`、`oa`、`suser`、`rb`、`agricultural_*` 等），10 条约 35KB，而真正要看的只有 8 个字段（约 3KB）。
 
-**不要**因此自己现写解析脚本，也不要把完整 JSON 贴给用户。CLI 已原生提供上面三层出口。
+**不要**因此自己现写解析脚本，也不要把完整 JSON 贴给用户。CLI 已原生提供上面两种出口。
 
-## 首选展示：`--format markdown`
-
-一次调用直接得到可读表格，列顺序、千分位、票种简称、挂单状态都已内置：
+macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli invoice list --format markdown
-weaver-work-cli invoice get --fid 1310817108299735054 --format markdown
+weaver-work-cli --json invoice run invoice.list --view summary --input-json '{"page_size":50,"start_pos":0,"consumption_tm_begin":"2026-10-01","consumption_tm_end":"2026-10-31"}'
+weaver-work-cli --json invoice get --fid 1310817108299735054 --view detail
 ```
 
-票夹列表渲染为标题行（票夹口径 + 总数 + 合计金额）+ 8 列表格；发票详情渲染为「标头 + 字段表」（含附件、费用说明、开票人、查验标记）。
-
-规则：
-
-- **自带字段口径**，不必也不能再传 `--view`（`invoice.list` 固定 summary、`invoice.get` 固定 detail）；传了不一致的视图返回 `validation/input_conflict`
-- **与 `--fields` 互斥**（要自定义字段就用 `--fields` 出 JSON）
-- **与全局 `--json` 互斥**：markdown 是渲染档不是数据档，同时传返回 `validation/input_conflict`，提示去掉 `--json`
-- 只支持 `invoice.list` / `invoice.enterprise.list` / `invoice.get`；其他 operation 返回 `validation/format_unsupported`
-- 仍要自行拼表时用下面的 `--view`，不要退回完整 JSON
-
-### 拿到输出后怎么展示：贴进正文，别包代码围栏
+Windows PowerShell：
 
-`--format markdown` 产出的是 **markdown 源码字符串**，表格、加粗、可点链接都要靠消费端的 markdown 渲染器解析。因此 Agent 拿到后要把它**作为消息正文原样输出**：
+```powershell
+weaver-work-cli --json invoice run invoice.list --view summary --input-json '{"page_size":50,"start_pos":0,"consumption_tm_begin":"2026-10-01","consumption_tm_end":"2026-10-31"}'
+weaver-work-cli --json invoice get --fid 1310817108299735054 --view detail
+```
 
-- **不要用代码围栏（三个反引号）包裹**：围栏的语义是「原样照录、不解析」，包上就退化成等宽纯文本 —— 发票号码的链接变死文本、表格散架，等于把渲染档降级回 plaintext。
-- **不要改写、不要重新拼表**：CLI 给的就是成品，转录要保真；别自行加反斜杠转义（把 `*` 写成 `\*`）、别调整字符或列顺序。
-- 在终端里直接执行只能看到源码，这属正常；要预览渲染效果，用支持 markdown 的客户端（浏览器、聊天界面），或在本地用 markdown 渲染器（如 `glow`、`mdcat`）。
+展示给用户时按 `--view summary` 的字段拼一张 markdown 表格，直接写在消息正文里（不要包代码围栏，否则链接失效）：先一行写票夹口径、`total` 张数和 `totalAmount` 合计，再列 `#`、发票号码（`[number](detailUrl)`）、开票日期、票种、价税合计、购方、销方、费用说明（没有时用 `content`）、行程/备注（起止地或上下车站、城市、备注）、报销（`reimRequests` 为空写"未挂单"）。
 
 ## 语义视图：`--view summary`（列表）/ `--view detail`（详情）
 
@@ -64,6 +52,12 @@ weaver-work-cli invoice get --fid 1310817108299735054 --format markdown
 | `amount` / `total` / `taxAmount` | 不含税金额 / 价税合计 / 税额 |
 | `buyer` / `buyerTaxNo` | 购买方名称 / 税号 |
 | `payer` / `payerTaxNo` | 销售方名称 / 税号 |
+| `expenseNote` | 费用说明（`ext.expenseDesc`），如「上海-武汉」「上南六村-三林南」 |
+| `content` | 消费内容（`ext.content`，为空时取商品名称） |
+| `city` / `province` | 城市 / 省份（`ext.city` / `ext.province`，省份为空时取票面 `province`） |
+| `comment` | 备注（`ext.comment`），**常写出差地、订单号和行程**，如「2026/10/25上海-武汉 CZ3580」 |
+| `from` / `to` | 出发地 / 到达地（打车、火车、机票等交通票） |
+| `stationGetOn` / `stationGetOff` | 上车站 / 下车站（`ext.station_geton` / `station_getoff`） |
 | `valid` | 查验状态原始值（`1`=已查验） |
 | `status` | 发票状态原始值 |
 | `reimState` | 票面 `comm_info.pro.sreim` 原始值，**语义未定义，不要自行解读** |
@@ -71,9 +65,11 @@ weaver-work-cli invoice get --fid 1310817108299735054 --format markdown
 | `fileName` | 附件文件名 |
 | `detailUrl` | 发票详情页链接，展示时必须转成可点击超链接 |
 
-列表级字段：`total`（票夹总数）、`totalAmount`（价税合计）、`totalAmountExcludingTax`、`hasMore`、`scope`、`itemCount`（本次返回张数）。
+列表级字段：`total`（票夹总数）、`totalAmount`（价税合计）、`totalAmountExcludingTax`、`hasMore`、`scope`、`itemCount`（本次返回张数）。`items` 已剔除全额红冲票，`itemCount` 可能少于 `page_size`；`total` 和两个合计是服务端汇总，仍含红冲票。翻页按 `page_size` 递增 `start_pos`，有没有下一页只看 `hasMore`。
+
+`expenseNote` 到 `stationGetOff` 这几项来自票面 `ext`。`invoice.list` 默认带 `mext=2147483647` 让服务端返回完整 `ext`（不传 `mext` 时服务端不返回 `ext`）；默认完整输出里每条发票还多一个已解析的 `extInfo` 对象（同一套字段名），原始 `ext` 字符串仍保留，可用 `--fields extInfo.comment` 精确取值。
 
-`--view summary` 只对 `invoice.list` 与 `invoice.enterprise.list` 生效；`invoice.get` 用 `--view detail`（见 `invoice-detail.md`，在 summary 字段上多出 `attachments` / `expenseNote` / `issuer` / `checkState`）。对其他 operation 传视图参数会返回 `validation/view_unsupported`，此时改用 `--fields`、`--format markdown`（若该 operation 有模板）或默认完整输出。
+`--view summary` 只对 `invoice.list` 与 `invoice.enterprise.list` 生效；`invoice.get` 用 `--view detail`（见 `invoice-detail.md`，在 summary 字段上多出 `attachments` / `issuer` / `checkState`）。对其他 operation 传视图参数会返回 `validation/view_unsupported`，此时改用 `--fields` 或默认完整输出。
 
 ## 备用：`--fields` 点路径投影
 
@@ -86,8 +82,8 @@ weaver-work-cli invoice get --fid 1310817108299735054 --format markdown
 
 > ⚠️ **`--fields` 里不要写裸 `total` 取金额。** 发票对象顶层的 `total` 是 E10 的独立字段（实测恒为 `0`），**价税合计在 `comm_info.price.total`**，不含税金额在 `comm_info.price.amount`，税额在 `comm_info.price.dtax`。要金额就用 `--fields comm_info.price.total`，或直接用 `--view summary`（那里的 `total` 已是价税合计）。
 
-三个参数都不属于 operation 的 `inputSchema`，它们只裁剪/渲染输出、不改变任何请求参数，因此不违反"列表查询不支持字段"的白名单校验。
-参数错误会在**发起业务请求之前**就返回（`view_unsupported` / `view_invalid` / `format_unsupported` / `format_invalid` / `input_conflict`），不会先打一次网络请求；只有 `field_not_found` 需要拿到结果才能判断。
+两个参数都不属于 operation 的 `inputSchema`，它们只裁剪输出、不改变任何请求参数，因此不违反"列表查询不支持字段"的白名单校验。
+参数错误会在**发起业务请求之前**就返回（`view_unsupported` / `view_invalid` / `input_conflict`），不会先打一次网络请求；只有 `field_not_found` 需要拿到结果才能判断。
 
 ## 回执：`meta.projection`
 
@@ -106,7 +102,7 @@ weaver-work-cli invoice get --fid 1310817108299735054 --format markdown
 
 ## 兜底：CLI 版本低于 0.1.17
 
-旧版 CLI 没有 `--view` / `--fields` / `--format`（可用 `weaver-work-cli --version` 确认）。此时用随本 reference 提供的脚本 `invoice-summarize.py`，字段口径与 `--view summary` 完全一致：
+旧版 CLI 没有 `--view` / `--fields`（可用 `weaver-work-cli --version` 确认）。此时用随本 reference 提供的脚本 `invoice-summarize.py`，字段口径与 `--view summary` 完全一致：
 
 macOS/Linux（bash/zsh）：
 
@@ -131,5 +127,5 @@ python "$env:USERPROFILE\.workbuddy\skills\weaver-e10-yepiaotong\references\invo
 
 - **发票号码必须用 `detailUrl` 渲染成可点击超链接**，格式为 `[号码](detailUrl)`；`--view summary` 已保留该字段，`--fields` 时记得把它列进字段表，否则详情链接会丢失。
 - 需要完整票面字段（`ext` 里的商品明细、`flist` 附件列表等）时不要用投影，走 `invoice.get`。
-- 统计金额以 `totalAmount` / `totalAmountExcludingTax` 为准，不要用单条 `total` 相加去"复核"服务端汇总——两者口径可能不同（作废票、红冲票的处理方式未在契约中定义）。
+- 统计金额以 `totalAmount` / `totalAmountExcludingTax` 为准，不要用单条 `total` 相加去"复核"服务端汇总——两者口径可能不同（列表已剔除全额红冲票而服务端汇总仍含；作废票的处理方式未在契约中定义）。
 - `reimState` 与列表筛选参数 `sreim` **不是同一套语义**：`sreim` 是筛选入参（`"0"`=全部、`"1"`=报销中、`"2"`=报销完成、`"3"`=未报销、`"4"`=不可报销），而票面 `comm_info.pro.sreim` 的取值含义未在 CLI 契约里定义，只能原样呈现。

package/skills/weaver-e10-yepiaotong/references/invoice-personal-list.md

@@ -32,6 +32,8 @@
 
 `bill_type` 是票据类型筛选参数：`0` 获取发票，`1` 获取凭证。用户没有明确要求“凭证”时，必须省略 `bill_type`，让 CLI 默认传 `0` 查询发票。
 
+`mext` 按位选择服务端返回哪些 `ext` 字段，**不传时 CLI 默认 `2147483647`，返回完整 `ext`**（费用说明、城市、备注、起止地等）。不要自己传 `mext`；只有明确不需要 `ext` 时才传 `0`。
+
 ## 示例
 
 Windows PowerShell：
@@ -56,7 +58,9 @@ weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"s
 
 ## 返回
 
-返回 `items`、`total`、`totalAmount`、`totalAmountExcludingTax`、`hasMore` 和 `scope="personal"`。每条 item 包含 `detailUrl`（如 `https://xxx/sp/inc/incDetail?fid=<fid>`）。分页时递增 `start_pos`，保持筛选条件和排序不变。
+返回 `items`、`total`、`totalAmount`、`totalAmountExcludingTax`、`hasMore` 和 `scope="personal"`。每条 item 包含 `detailUrl`（如 `https://xxx/sp/inc/incDetail?fid=<fid>`），以及已解析的 `extInfo`：`expenseNote`（费用说明）、`content`、`city`、`province`、`comment`（备注，常写出差地和行程）、`from` / `to`、`stationGetOn` / `stationGetOff`，空值省键；原始 `ext` 字符串仍保留。`--view summary` 会把这些字段平铺出来，见 [invoice-output-view.md](invoice-output-view.md)。
+
+`items` 已剔除全额红冲票（`comm_info.pro.status=8`），所以本页条数可能少于 `page_size`；`total` / `totalAmount` / `totalAmountExcludingTax` 是服务端汇总，仍含被剔除的红冲票，张数对不上时不要自己"修正"。分页时 `start_pos` 按 `page_size` 递增（不要按本页条数递增，否则会重复拉到同一批票），是否还有下一页只看 `hasMore`，保持筛选条件和排序不变。
 
 向用户展示发票列表时，**发票号码必须用 markdown 链接格式** `[号码](detailUrl)` 展示，让用户点击直接打开发票详情页。