weaver-work-cli 0.1.24 → 0.1.26

package/skills/weaver-e10-workflow/references/workflow-memory.md

@@ -114,8 +114,7 @@ weaver-work-cli --json workflow run workflow.memoryExtract --input ./mem-extract
 每轮完整实质任务结束后（输出最终回复前），必须自行判断本轮是否出现**新的、有价值的语义记忆**（例如用户新澄清/确认了具体工作流、**字段名 / 浏览按钮字段值 / 选项字段的选项值**；与已有记忆重复的不算）：
 
 - **有** → 组装本轮"用户原始意图 + 澄清过程 + 确认结果"的消息列表并调用 `workflow.memoryExtract`（同步，`async` 语义为返回真实结果）：
-  - `saved:true` → 用自然语言告知用户会记住什么（如"后续发起请假流程会默认按本次偏好填写"），不展示接口原文；
-  - `saved:false` → 按静默失败处理，不告知用户、不重试，直接继续回答。
+  - `saved:true` / `saved:false` → **都静默处理**（不告知用户、不展示接口原文、不重试），直接继续回答。
 - **没有** → 不调用，直接输出最终回复。
 
 **硬禁令（必须遵守）**：
@@ -158,8 +157,6 @@ weaver-work-cli --json workflow run workflow.memoryExtract --input ./mem-extract
 - **每页条数偏好**：用于列表查询的 `pageSize`；**本次用户明确指定的条数优先于记忆偏好**。
 - **紧急/超时流程优先展示**、详情摘要关注字段、已确认的审批建议规则、展示/确认/异常处理偏好。
 
-记忆影响了本轮决策时（工作流消歧、摘要字段优先级、审批建议、每页条数、紧急超时优先展示），最终回复**不要展示记忆原文**，但必须保留自然语言说明依据了哪类历史偏好（如"我按你之前确认的偏好，把报销优先理解为总部费用报销。"）。
-
 记忆**不能**用于：猜测当前系统元数据（工作流 ID/字段/节点元数据必须来自当前链路解析）、替代 `index` 序号映射定位、绕过操作门禁（`canSubmitRejectTransfer` 等）、仅凭记忆自动执行审批（记忆只能生成建议，执行以用户本轮明确指示为准）。
 
 ## 注意

package/skills/weaver-e10-workflow/references/workflow-query.md

@@ -488,7 +488,7 @@ CLI 按 OA 版本自动路由，**两种模式的返回形态不同，按实际
 - **分组之间明显分隔**：上一分组的最后一张卡片与下一分组标题之间留空行（建议再补一行 `---` 让分组边界更清晰）。
 - **禁止（仅限本节的分组卡片渲染）**：不要把卡片输出成 Markdown 表格、也不要压成连续文本编号列表——卡片一律原样粘贴 CLI 生成的 `finalMarkdown`；不要自行重算或改写各组数量。**本条只约束分组卡片渲染，不适用于其它场景**：发起/修改流程的表单预览与明细表按 [`workflow-create.md`](workflow-create.md) 的规则展示（明细表**必须**用表格列展示），批量操作结果按 [`workflow-batch.md`](workflow-batch.md) 用表格展示。
 
-**渲染纪律（省时关键）**：分组顺序、标题计数口径、顶部汇总行口径、卡片粘贴边界都已在本节与「渲染红线」给定——**照做即可，不要重新推导、不要反复确认**（避免"这个组该不该排前面""汇总行要不要含草稿"这类来回权衡）。进入渲染阶段后只做三件事：按固定顺序拼接各组已取到的内容、写分组标题、为每组写一行汇总。**结尾最多写一句说明**（例如"依据您的历史偏好每页 5 条"）——**不得附带任何 0 计数、类别清单，或"某某类别为空/未列出/不涉及"之类表述**（口径见「渲染红线」空组约束）。
+**渲染纪律（省时关键）**：分组顺序、标题计数口径、顶部汇总行口径、卡片粘贴边界都已在本节与「渲染红线」给定——**照做即可，不要重新推导、不要反复确认**（避免"这个组该不该排前面""汇总行要不要含草稿"这类来回权衡）。进入渲染阶段后只做三件事：按固定顺序拼接各组已取到的内容、写分组标题、为每组写一行汇总。**结尾不写说明句**——不写"依据您的历史偏好…"这类，也**不得附带任何 0 计数、类别清单，或"某某类别为空/未列出/不涉及"之类表述**（口径见「渲染红线」空组约束）。
 
 ## 渲染红线
 
@@ -514,7 +514,7 @@ CLI 按 OA 版本自动路由，**两种模式的返回形态不同，按实际
 
 **"任何位置"的口径（最容易漏的地方，逐条对照）**——为 0 的类别要**只字不提**，**连"为什么没列"也不许解释**：
 
-- ❌ 结尾说明句里夹带：`说明：本次分组依据您的历史偏好（每页 5 条）；紧急/超时这一类当前计数为 0，故未列出。`——说明"依据了记忆偏好"是允许的，**但夹带 0 计数不允许**；两者同句时只保留前半句。
+- ❌ 结尾说明句里夹带：`说明：本次分组依据您的历史偏好（每页 5 条）；紧急/超时这一类当前计数为 0，故未列出。`——**夹带 0 计数不允许**；回复里也**不再出现"依据了记忆 / 历史偏好"这类说明**，这样的结尾说明句整句都不写。
 - ❌ 其它分组的汇总摘要里带一句：`……动作对象指向客户或商务部等业务角色，无紧急、超时。`
 - ❌ 顶部汇总行里写 `紧急 0 条 / 超时 0 条`。
 - ❌ 换任何说法的否定式提及：`本次不涉及紧急/超时`、`暂无紧急事项`、`未列出的类别为空`、`其余类别无数据`。

package/skills/weaver-e10-yepiaotong/SKILL.md

@@ -3,8 +3,8 @@ name: weaver-e10-yepiaotong
 display_name: 泛微业票通发票
 display_name_en: Weaver Invoice
 description: "泛微 E10 业票通发票管理：查询票夹、OCR/查验、附件、流程发票字段、报销填单、智能开票确认链。"
-description_zh: "泛微 E10 业票通发票管理。支持查询个人/企业票夹、查看详情、上传、OCR/查验预览、下载附件、流程表单发票字段数据，通过 prepare/apply 确认链处理导入、新增、编辑、删除、报销单创建/更新、智能开票/存台账。"
-description_en: "Weaver E10 Yepiaotong invoice skill for folder queries, detail lookup, OCR and validation previews, attachment downloads, workflow invoice field data, reimbursement form submission, and confirmed invoice issuing."
+description_zh: "泛微 E10 业票通发票管理。支持查询个人/企业票夹、查看详情、上传、OCR/查验预览、下载附件、流程表单发票字段数据，通过 prepare/apply 确认链处理导入、新增、编辑、删除、智能开票/存台账；报销填单由本技能准备发票与预填数据，报销单创建/修改调用 weaver-e10-workflow 的发起/修改能力。"
+description_en: "Weaver E10 Yepiaotong invoice skill for folder queries, detail lookup, OCR and validation previews, attachment downloads, workflow invoice field data, reimbursement data preparation (forms are created and edited via weaver-e10-workflow), and confirmed invoice issuing."
 version: 1.0.3
 author: 泛微网络科技股份有限公司
 agent_created: true
@@ -17,7 +17,7 @@ cliHelp: "weaver-work-cli invoice --help"
 **`--is-connector` 判据**：用户明确使用连接器、或上下文要求用连接器完成任务 → 传 `true`；本次任务或上下文直接选择单独技能 → 不传；用户没有明确说明时，按**正在运行的这份 Skill 是哪一级**定——**用户级（条目标 `(user)`）不传，连接器级（标 `(connector)`）传**（同名 Skill 只会运行用户级那一份）。传 `true` 时不要再写 `--profile` / `--base-url`。完整规则见 `[../weaver-e10-shared/SKILL.md](../weaver-e10-shared/SKILL.md)`。
 
 认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
-所有命令通过 `weaver-work-cli --json invoice run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli invoice schema` 是 operation、字段和风险等级的合约来源。
+所有命令通过 `weaver-work-cli --json invoice run <operation>` 执行（唯一例外：报销单的创建/修改调用 `weaver-e10-workflow` 技能的 `weaver-work-cli --json workflow run workflow.*`，见下方「报销填单」）：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli invoice schema` 是 operation、字段和风险等级的合约来源。
 命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
 涉及发票附件、图片、本地文件、远程 URL 文件或 OCR/文件解析的操作，执行前必须提醒用户：文件内容可能被上传到 E10 业票通、OCR/查验服务，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
 
@@ -88,7 +88,8 @@ cliHelp: "weaver-work-cli invoice --help"
 | 准备/确认编辑发票                  | `invoice run invoice.update.prepare/apply`       | `[invoice-update.md](references/invoice-update.md)`                               |
 | 准备/确认删除发票                  | `invoice run invoice.delete.prepare/apply`       | `[invoice-delete.md](references/invoice-delete.md)`                               |
 | 生成流程表单发票浏览按钮 JSON          | `invoice run invoice.browse-field.data`          | `[invoice-browse-field-data.md](references/invoice-browse-field-data.md)`         |
-| 报销自动填单、报销单创建/更新            | `invoice run invoice.reim.`*                     | `[invoice-reim.md](references/invoice-reim.md)`                                   |
+| 报销自动填单（发票、事前申请、工作流、预填数据）   | `invoice run invoice.reim.`*                     | `[invoice-reim.md](references/invoice-reim.md)`                                   |
+| 报销单创建 / 修改                   | `workflow run workflow.createForm/createRequest`、`workflow.editLoad/editPrepare/editApply`（`weaver-e10-workflow` 技能） | `[reim-workflow.md](references/reim-workflow.md)` Step 3~6；命令契约见 `[workflow-create.md](../weaver-e10-workflow/references/workflow-create.md)` |
 | 报销完整工作流编排、行为准则             | AI 内部                                            | `[reim-workflow.md](references/reim-workflow.md)`                                 |
 | 批量获取多张发票预填信息               | `invoice run invoice.reim.row-info-batch`    | `[reim-api-reference.md](references/reim-api-reference.md)`                       |
 | 报销 CLI operation 入参与返回值    | AI 内部                                            | `[reim-api-reference.md](references/reim-api-reference.md)`                       |
@@ -98,6 +99,7 @@ cliHelp: "weaver-work-cli invoice --help"
 | 话费补贴 / 话费报销硬拦截规则           | AI 内部                                            | `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`           |
 | 报销端到端示例                    | 参考                                               | `[reim-examples.md](references/reim-examples.md)`                                 |
 | 智能开票或存入待开台账                | `invoice run invoice.issuing.make.prepare/apply` | `[invoice-issuing.md](references/invoice-issuing.md)`                             |
+| 按契约锁合同/开票台账开票、查开票结果      | `invoice run invoice.issuing.qys.list/prepare` -> `invoice.issuing.make.apply` -> `invoice.issuing.result` | `[invoice-issuing-qys-ledger.md](references/invoice-issuing-qys-ledger.md)` |
 | 开票字段提取规则、税率推断、金额计算         | AI 内部                                            | `[invoice-issuing-field-rules.md](references/invoice-issuing-field-rules.md)`     |
 | 开票端到端示例                    | 参考                                               | `[invoice-issuing-examples.md](references/invoice-issuing-examples.md)`           |
 | 共享、转让、标签或 schema 未列出的能力    | 无可用命令                                            | `[invoice-disabled-capabilities.md](references/invoice-disabled-capabilities.md)` |
@@ -116,10 +118,11 @@ cliHelp: "weaver-work-cli invoice --help"
 - 编辑发票：`invoice.update.prepare` -> 用户确认 -> `invoice.update.apply`
 - 删除发票：`invoice.delete.prepare` -> 用户确认 -> `invoice.delete.apply`
 - 流程发票字段：已有 `fid` 或详情时，用 `invoice.browse-field.data` 生成浏览按钮对象；不要运行旧源码脚本或直接调接口。
-- 报销快速路径（0.1.13 新增，流程为「总部费用报销」时优先用）：查票分类 `invoice.reim.candidates.list` -> 用户确认范围 -> `invoice.reim.flow.create.auto-prepare`（或 `invoice.reim.template.build` + `flow.create.prepare`）-> 用户确认 -> `invoice.reim.flow.create.apply`，详见 `[reim-fast-path.md](references/reim-fast-path.md)`；明细字段与上级口径以该文档固化映射为准，其他流程仍走下面的手工路径。
-- **⚠️ 报销单「合同编号」固定填 `20260999`**（除非用户当次明确给出别的合同号）：`template.build` / `auto-prepare` 必须显式传 `contractNo`，不传时 `合同号(100003720000001376)` 会**整条缺失且 `warnings` 不提示**，等于静默留空；手工组装路径同样不能留空或放进 `unable_to_fill`。口径见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)` 主表字段映射。
-- 报销填单（完整工作流见 `[reim-workflow.md](references/reim-workflow.md)`）：先用 `invoice.list`/`invoice.get`/`invoice.reim.file-ocr.preview` 获取发票 -> 展示汇总并确认 -> 用 `invoice.reim.requests.list`、`invoice.reim.workflow.resolve`、`invoice.reim.form.structure`、`invoice.reim.row-info`（单张）或 `invoice.reim.row-info-batch`（多张，推荐）、`invoice.reim.employee-superiors` 组装报销单 JSON（匹配规则见 `[reim-matching-rules.md](references/reim-matching-rules.md)`，填单规则见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`，科目匹配见 `[reim-expense-subject-rules.md](references/reim-expense-subject-rules.md)`；命中话费补贴/话费报销时先读 `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`）-> `invoice.reim.flow.create.prepare` -> 用户确认 -> `invoice.reim.flow.create.apply`。创建成功后修改只能用 `invoice.reim.flow.update.prepare/apply`。
+- 报销填单（完整工作流见 `[reim-workflow.md](references/reim-workflow.md)`）：先用 `invoice.reim.candidates.list`（按日期批量）/`invoice.list`/`invoice.get`/`invoice.reim.file-ocr.preview` 获取发票 -> 展示汇总并确认 -> `invoice.reim.requests.list` 匹配事前申请 -> `invoice.reim.workflow.resolve` 得到报销工作流 -> 并行 `workflow.createForm`（`weaver-e10-workflow`，传 `{workFlowName}({workFlowId})`）、`invoice.reim.row-info-batch`、`invoice.browse-field.data`（发票 + 配对凭证）-> 按规则组装 `data`（匹配规则见 `[reim-matching-rules.md](references/reim-matching-rules.md)`，填单规则见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`，科目匹配见 `[reim-expense-subject-rules.md](references/reim-expense-subject-rules.md)`；命中话费补贴/话费报销时先读 `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`）-> 展示预览、用户确认「存草稿 / 提交审批」-> `workflow.createRequest` -> 原样粘贴 `finalMarkdown`。创建成功后修改只能用 `workflow.editLoad` -> `workflow.editPrepare` -> 用户确认 -> `workflow.editApply`。
+- 报销单创建/修改依赖同级的 `weaver-e10-workflow` 技能（`../weaver-e10-workflow/`）；该技能不存在时停止并告知用户需要安装，不要改用其他方式创建报销单。
+- **⚠️ 报销单「合同号」固定为 `20260999`**（除非用户当次明确给出别的合同号）：`createForm` 已带出该默认值时不传；没带出或用户给了别的合同号时显式传。**用户给了合同号时，承担主体 / 相关客户 / 相关项目都不传，以合同联动带出的值为准（用户口头指定的承担主体也一样）**。口径见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)` 主表字段规则。
 - 智能开票：Agent 读取 `invoice-issuing.md` 和 `invoice-issuing-field-rules.md`，从用户输入或附件中提取购方、税号、商品明细、金额和税率；资料不足时追问用户补齐，再执行 `invoice.issuing.make.prepare` -> 用户确认开票或存台账 -> `invoice.issuing.make.apply`。当前资料包没有客户档案查询 operation，不要调用 `invoice.customer.`*。
+- 契约锁台账开票（用户提到合同号、契约锁合同或“按台账开票”时优先走这条，不要让 Agent 自己提取字段）：`invoice.issuing.qys.list` -> 用户选定台账行 -> `invoice.issuing.qys.prepare`（CLI 按不含税金额组装开票入参）-> 用户确认 -> `invoice.issuing.make.apply`（`payload` 用 prepare 返回的 `normalizedPayload`）-> `invoice.issuing.result` 查一次结果。详见 `[invoice-issuing-qys-ledger.md](references/invoice-issuing-qys-ledger.md)`。
 
 ## 执行原则（减少误路由、误重试和无效消耗）
 

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

@@ -11,6 +11,7 @@
 **用户**：帮我开一张专票给深圳腾讯科技有限公司，税号 91440300MA5G3JE95L，10万的信息技术咨询服务费，含税
 
 **AI 处理**：
+
 - 提取：purchaser_name, purchaser_tax_no, goods_name, amount_raw=100000, amount_is_tax_inclusive=true
 - 推断税率：信息技术咨询服务 → 6%
 - 用户确认税率 → "好的"
@@ -25,7 +26,9 @@
 **用户**：帮我开票
 
 **AI**：
+
 > 需要以下信息：
+>
 > 1. **购方名称**（开给谁？）
 > 2. **商品/服务名称**（开什么？）
 > 3. **金额**（多少钱？含税还是不含税？）
@@ -33,7 +36,8 @@
 **用户**：开给杭州阿里巴巴，技术服务费5万，不含税
 
 **AI**：
-> 请问是开**个人票（普票，无需税号）**还是**企业专票（需提供税号）**？
+
+> 请问是开**个人票（普票，无需税号）还是企业专票（需提供税号）**？
 
 **用户**：专票，税号 91330100MA27F4RQ12
 
@@ -41,11 +45,14 @@
 
 ---
 
+
+
 ## 示例 3：个人普票
 
 **用户**：开普票，购方张三，500块钱的餐饮服务，含税
 
 **AI**：
+
 > 是否确认开**个人普票**？（个人票无需税号）
 
 **用户**：对，开个人票
@@ -56,9 +63,12 @@
 
 ---
 
+
+
 ## 示例 4：多明细行
 
 **用户**：开专票给北京XX公司，税号 91110000MA01B6BH1K，明细：
+
 1. 软件开发服务 8万不含税
 2. 技术咨询服务 2万不含税
 3. 服务器硬件 5台每台6000含税
@@ -67,16 +77,21 @@
 
 ---
 
+
+
 ## 示例 5：Excel 附件开票
 
 **用户**：（上传 Excel）帮我按这个表开票，购方杭州XX科技，税号91330100XX，专票，不含税
 
 **AI**：
+
 1. 解析 Excel 表头判断同一张发票多明细行
 2. 推断税率 → 预览 → 确认 → 提交
 
 ---
 
+
+
 ## 示例 6：存入待开台账
 
 **用户**：帮我开票给XX公司...（常规流程）
@@ -84,3 +99,36 @@
 预览后用户回复："**先存台账**"
 
 **AI**：调用 makeInvoice 时添加 `"operateType": "5"` → 展示"已存入待开台账"
+
+---
+
+
+
+## 示例 7：按契约锁台账开票
+
+**用户**：帮我把南昌我爱我家那份合同开票
+
+**AI**：
+
+1. `invoice.issuing.qys.list`，`keyword="南昌我爱我家"` → 命中 1 行（合同号 20266105541，技术服务费，开票金额 20000，6%）
+2. `invoice.issuing.qys.prepare`，`formDataId="1328267444527472669"`，`mode="issue"`
+3. 展示预览：
+
+> 合同号 20266105541（南昌我爱我家科技有限公司开放平台续购20000元10000份）
+> 购方：南昌我爱我家科技有限公司，税号 91360125083909438T，全电专票
+> 技术服务费，税率 6%，不含税 20000.00，税额 1200.00，价税合计 21200.00
+> 确认开票吗？
+
+**用户**：确认开票
+
+**AI**：`invoice.issuing.make.apply`（`payload` = `normalizedPayload`）→ `invoice.issuing.result`，`externalDocumentNo="QYS-1328267444527472669"` → 展示发票号码或“开票中”
+
+---
+
+
+
+## 示例 8：台账命中多行
+
+**用户**：开一下技术服务费那几单
+
+**AI**：`invoice.issuing.qys.list`，`keyword="技术服务费"` → 命中 4 行，列出合同号、合同名称、购方、不含税金额、税率，请用户选择具体哪一行；用户选定后按示例 7 继续，一次只开一行。

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

@@ -0,0 +1,66 @@
+# 契约锁开票台账开票
+
+## 什么时候读取
+
+用户要按契约锁合同开票、按合同号开票、从“契约锁合同商品信息”台账开票，或说“把 XX 公司那份合同开了”“开一下合同 20266105541 的票”时读取本文件。用户自己口述购方、金额、明细的开票不走本文件，改读 `invoice-issuing.md`。
+
+## Operation
+
+| 阶段 | Operation | 风险 |
+| --- | --- | --- |
+| 查询待开票台账行 | `invoice.issuing.qys.list` | read |
+| 按台账行组装开票入参并预览 | `invoice.issuing.qys.prepare` | read-before-write |
+| 确认开票或存台账 | `invoice.issuing.make.apply` | high-risk-write |
+| 查询异步开票结果 | `invoice.issuing.result` | read |
+
+## 组装规则（CLI 固化，Agent 不参与计算）
+
+- 一行台账开一张发票，外部单号固定为 `QYS-{formDataId}`。
+- 台账“开票金额”和“商品单价”是**不含税**金额：`taxSign="0"`，税额 = 金额 × 税率（四舍五入到分），价税合计 = 金额 + 税额。
+- 商品名称优先取“开票名称”，为空时取“商品名称”；税率取台账“商品税率”（如 `6.0%` → 0.06）。
+- 发票类型取台账“发票类型”的选项 ID（如全电专票 = `8`）；购方名称、税号、地址、电话、开户行、账号按台账原值透传，空值不填。
+- 销方固定为上海泛微网络科技股份有限公司。
+- 已有发票号码、已关联开票流程、开票中金额大于 0 或已废弃的行，`qys.list` 默认不返回，`qys.prepare` 直接拒绝。
+
+Agent **不得**自行修改预览里的金额、税率、税号或商品名称。用户要改，先让用户去台账改数据，再重新 `qys.prepare`。
+
+## 对话流程
+
+1. 用户给出合同号时传 `contractNo`；给出公司名、合同名等线索时传 `keyword`。调用 `invoice.issuing.qys.list`。
+2. 命中 0 行：告诉用户没有可开票的行；如果用户坚持该合同存在，可加 `includeIssued=true` 再查一次，展示 `blockers` 说明为什么不能开。
+3. 命中多行：列出合同号、合同审批流程名称、购方名称、商品、开票金额（不含税）、税率，让用户选择。不要替用户选。
+4. 用户选定后调用 `invoice.issuing.qys.prepare`，`mode` 默认 `issue`；用户说“先存台账/先不开”时用 `ledger`。
+5. 向用户展示预览：合同号、合同审批流程名称、购方名称、购方税号、发票类型、商品名称、税率、不含税金额、税额、价税合计。`warnings` 非空时逐条列出并询问是否仍然继续。
+6. 用户明确回复“确认开票”或同义确认后，把 `normalizedPayload` 原样作为 `payload`，连同 `continuation`、`confirm=true` 调用 `invoice.issuing.make.apply`。
+7. 正式开票成功后，用 `preview.externalDocumentNo` 调一次 `invoice.issuing.result`：`SUCCESS` 时展示发票号码；`PENDING` 时说明开票中、稍后再查；`FAILED` 时展示 `returnMessage`。不要循环轮询。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.issuing.qys.list --input-json '{"keyword":"南昌我爱我家"}'
+weaver-work-cli --json invoice run invoice.issuing.qys.prepare --input-json '{"formDataId":"1328267444527472669","mode":"issue"}'
+weaver-work-cli --json invoice run invoice.issuing.result --input-json '{"externalDocumentNo":"QYS-1328267444527472669"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json invoice run invoice.issuing.qys.list --input-json '{"keyword":"南昌我爱我家"}'
+weaver-work-cli --json invoice run invoice.issuing.qys.prepare --input-json '{"formDataId":"1328267444527472669","mode":"issue"}'
+weaver-work-cli --json invoice run invoice.issuing.result --input-json '{"externalDocumentNo":"QYS-1328267444527472669"}'
+```
+
+`invoice.issuing.make.apply` 的 `payload` 较长，按 `invoice-issuing.md` 的做法先把 `{"payload":<normalizedPayload>,"continuation":"<continuation>","confirm":true}` 写入 UTF-8 JSON 文件，再用 `--input <path>` 传入。
+
+## 输出处理
+
+- `qys.list` 返回 `items[]`（可读字段 + `issuable` + `blockers`）、`matched`、`truncated`、`scanned`、`scanComplete`。`scanComplete=false` 表示台账超过扫描上限，需提醒用户结果可能不全。
+- `qys.prepare` 返回 `preview`、`warnings`、`ledgerRow`、`normalizedPayload`、`continuation`。只给用户看 `preview` 和 `warnings`，不要贴完整 JSON。
+- `make.apply` 失败或连接中断时按 `invoice-issuing.md` 处理，**禁止自动重试**；同一台账行的外部单号固定，重复提交会被后端识别。
+
+## 注意
+
+- 当前版本开票后不会自动回写台账的发票号码、开票时间等字段；向用户说明需要在台账侧另行处理。
+- 正式开票是不可逆的高风险写入；同一 continuation 只服务一次确认，用户改了台账数据必须重新 `qys.prepare`。

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

@@ -6,27 +6,34 @@
 
 ## Operation
 
-| 意图 | Operation | 风险 |
-| --- | --- | --- |
-| E10 fileId 转发票识别结果 | `invoice.reim.file-ocr.preview` | read-with-upload |
-| 查询事前申请 | `invoice.reim.requests.list` | read |
-| 获取报销工作流 ID | `invoice.reim.workflow.resolve` | read |
-| 获取报销表单结构 | `invoice.reim.form.structure` | read |
-| 获取单张发票明细行预填信息 | `invoice.reim.row-info` | read |
-| 获取当前人员及上级 | `invoice.reim.employee-superiors` | read |
-| 搜索表单关联字段值 | `invoice.reim.field.search` | read |
-| 准备/确认创建报销单 | `invoice.reim.flow.create.prepare/apply` | read-before-write / high-risk-write |
-| 准备/确认更新报销单 | `invoice.reim.flow.update.prepare/apply` | read-before-write / high-risk-write |
+本技能负责报销的**数据准备**；报销单的**创建与修改**统一调用 `weaver-e10-workflow` 技能的发起/修改能力。
+
+| 意图 | Operation | 所属技能 | 风险 |
+| --- | --- | --- | --- |
+| E10 fileId 转发票识别结果 | `invoice.reim.file-ocr.preview` | yepiaotong | read-with-upload |
+| 报销候选发票分类（可报 / 已挂单 / 红冲） | `invoice.reim.candidates.list` | yepiaotong | read |
+| 查询事前申请 | `invoice.reim.requests.list` | yepiaotong | read |
+| 获取报销工作流 ID 与名称 | `invoice.reim.workflow.resolve` | yepiaotong | read |
+| 获取发票明细行预填信息 | `invoice.reim.row-info` / `invoice.reim.row-info-batch` | yepiaotong | read |
+| 取发票字段对象 | `invoice.browse-field.data` | yepiaotong | read |
+| 获取当前人员及上级（兜底） | `invoice.reim.employee-superiors` | 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 |
+
+> workflow 侧命令的入参、返回处置以 [`../../weaver-e10-workflow/references/workflow-create.md`](../../weaver-e10-workflow/references/workflow-create.md)、[`workflow-edit.md`](../../weaver-e10-workflow/references/workflow-edit.md) 为准。`weaver-e10-workflow` 技能不可用时停止并告知用户需要安装该技能，不要改用其他方式创建报销单。
 
 ## 处理链
 
-1. 获取发票：已有 `fid` 时可用 `invoice.get` 或 `invoice.browse-field.data`；已有 E10 `fileId` 时用 `invoice.reim.file-ocr.preview`；需要查票夹时用 `invoice.list`，默认未报销发票。
+1. 获取发票：已有 `fid` 时可用 `invoice.get`；已有 E10 `fileId` 时用 `invoice.reim.file-ocr.preview`；按日期批量报销用 `invoice.reim.candidates.list`（只取 `available`），按关键词/号码筛选用 `invoice.list`，默认未报销发票。
 2. 展示发票汇总，让用户确认哪些发票进入报销。
 3. 用 `invoice.reim.requests.list` 获取事前申请，再按时间、费用类型和标题做匹配；原始 ID、日期、金额必须逐字符保留。
 4. 用 `invoice.reim.workflow.resolve` 得到报销工作流，必要时按工作流分组。
-5. 对每组并行读取 `invoice.reim.form.structure`、`invoice.reim.row-info` 和 `invoice.reim.employee-superiors`；只有需要用户修正关联字段时才用 `invoice.reim.field.search`。
-6. Agent 按表单结构组装报销单 JSON，先调用 `invoice.reim.flow.create.prepare`，展示标题、主表字段数、明细行数、发票和风险；用户明确确认后再调用 `.apply`。命中「话费补贴标准审批流程」或「话费报销」时，必须先读 [`reim-phone-subsidy-rules.md`](reim-phone-subsidy-rules.md)，按月度标准核算实报金额，不能直接用发票金额填单。
-7. 报销单创建成功后，后续修正使用 `invoice.reim.flow.update.prepare/apply`，不要重复创建同一组发票的报销单。
+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`，结果原样粘贴 `finalMarkdown`。命中「话费补贴标准审批流程」或「话费报销」时，必须先读 [`reim-phone-subsidy-rules.md`](reim-phone-subsidy-rules.md)，按月度标准核算实报金额，不能直接用发票金额填单。
+7. 报销单创建成功后，后续修正使用 `workflow.editLoad` → `workflow.editPrepare` → 用户确认 → `workflow.editApply`，不要重复创建同一组发票的报销单。
+
+完整编排见 [`reim-workflow.md`](reim-workflow.md)。
 
 ## 命令
 
@@ -44,50 +51,66 @@ macOS/Linux（bash/zsh）：
 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"}'
 ```
 
-创建报销单建议用 UTF-8 JSON 文件传入完整报销单 JSON。
+载入报销表单（拿 `continuation` 与可写字段 `fields`）：
 
 Windows PowerShell：
 
 ```powershell
-Set-Content -Encoding utf8 -LiteralPath .\reim-create.json -Value @'
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.createForm --input-json '{"workflow":["总部费用报销(100003460000000060)"]}'
+```
+
+创建报销单：`data` 含发票对象、体积较大，先写入 UTF-8 JSON 文件再传入。
+
+Windows PowerShell：
+
+```powershell
+Set-Content -Encoding utf8 -LiteralPath .\reim-create-request.json -Value @'
 {
-  "work_flow_id": "1181057526276915214",
-  "mainFormId": "1181057741029226975",
-  "request_name": "交通费报销-示例-2026-08-04",
-  "main_fields": [],
-  "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
+  "context": "<createForm 返回的 continuation>",
+  "requestName": "交通费报销-示例-2026-08-04",
+  "action": "draft",
+  "data": {
+    "main": {"100003720000000088": "2026-07-30 市内交通 - 滴滴出行"},
+    "details": {"100003690000000011": [{"100003720000016373": "108.2", "100003720000052200": "人民币(100001050000000001)"}]}
+  }
 }
 '@
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input .\reim-create.json
+weaver-work-cli --json workflow run workflow.createRequest --input .\reim-create-request.json
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-cat > ./reim-create.json <<'JSON'
+cat > ./reim-create-request.json <<'JSON'
 {
-  "work_flow_id": "1181057526276915214",
-  "mainFormId": "1181057741029226975",
-  "request_name": "交通费报销-示例-2026-08-04",
-  "main_fields": [],
-  "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
+  "context": "<createForm 返回的 continuation>",
+  "requestName": "交通费报销-示例-2026-08-04",
+  "action": "draft",
+  "data": {
+    "main": {"100003720000000088": "2026-07-30 市内交通 - 滴滴出行"},
+    "details": {"100003690000000011": [{"100003720000016373": "108.2", "100003720000052200": "人民币(100001050000000001)"}]}
+  }
 }
 JSON
-weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
+weaver-work-cli --json workflow run workflow.createRequest --input ./reim-create-request.json
 ```
 
-确认后把 prepare 返回的 continuation 原样放入 apply 输入，并在同一个顶层 JSON 中加入 `"confirm": true`。`invoice.reim.flow.create.*` 的 `inputSchema` 会逐字段暴露 `work_flow_id`、`mainFormId`、`request_name`、`main_fields`、`detail_rows`、`need_user_confirm` 和 `unable_to_fill`，不要再包一层通用 `payload`。
+示例里的字段 id 来自「总部费用报销」，实际一律以本次 `createForm` 返回的 `fields` 为准；明细行的「相关发票」「相关凭证」要放 `invoice.browse-field.data` 返回的发票对象数组。
 
 ## 输出处理
 
-`invoice.reim.flow.create.apply` 成功返回 `requestId`、`requestName` 和 `viewUrl`。给用户展示报销单标题、总金额、发票摘要和链接。若返回 `partial/write_uncertain`，停止，不要重放 `.apply`；最多做一次只读查询或请用户在 E10 页面核对。
-
-`invoice.reim.flow.update.apply` 若服务端返回删除或更新部分失败，CLI 会按 `partial/write_uncertain` 报告，Agent 不要继续连环重试。
+`workflow.createRequest` 在成功（`CREATED` / `CREATED_SUBMITTED`）、提交失败（`CREATED_SUBMIT_FAILED`）和缺必填（`NEEDS_INPUT`）时返回 `finalMarkdown`，**原样粘贴给用户**，不要自己重拼表格；链接只出现在回复文本里，不要主动打开。若返回 `partial/write_uncertain`，停止，不要重放；最多做一次只读查询或请用户在 E10 页面核对。
 
 ## 注意
 
-报销单创建和更新都是高风险写入，必须走 `prepare -> 用户确认 -> apply`。同一组发票 `invoice.reim.flow.create.apply` 成功后禁止再次创建；要修改已创建的报销单只能走 `invoice.reim.flow.update.prepare/apply`。
+报销单创建涉及金额，**调用 `workflow.createRequest` 前必须先展示预览并取得用户明确确认**；同一组发票创建成功后禁止再次创建，修改只能走 `workflow.edit*`。
 
-出差/差旅流程需要具体相关客户。未拿到用户提供的客户并完成关联字段搜索前，不要调用 `invoice.reim.flow.create.prepare/apply`。
+出差/差旅流程需要具体相关客户。未拿到用户提供的客户前，不要调用 `workflow.createRequest`。
 
 `invoice.reim.file-ocr.preview` 会让 E10 侧文件进入发票识别流程；如果 fileId 来自用户新上传或附件解析，先提醒用户文件内容可能进入大模型上下文，也可能发送到 E10/OCR 服务，并等待明确确认。