weaver-work-cli 0.1.40 → 0.1.44

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

@@ -2,10 +2,10 @@
 name: weaver-e10-yepiaotong
 display_name: 泛微业票通发票
 display_name_en: Weaver Invoice
-description: "泛微 E10 业票通发票管理：查询票夹、OCR/查验、附件、流程发票字段、报销填单、获取待开票合同数据后发起开票流程。"
-description_zh: "泛微 E10 业票通发票管理。支持查询个人/企业票夹、查看详情、上传、OCR/查验预览、下载附件、流程表单发票字段数据，通过 prepare/apply 确认链处理导入、新增、编辑、删除；报销填单由本技能准备发票与预填数据，报销单创建/修改调用 weaver-e10-workflow 的发起/修改能力；AI 开票先获取待开票合同数据（含契约锁、泛微及其他合同），再按合同号调用 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 AI invoicing that drafts an invoice-application workflow from pending contract data, including Qiyuesuo, Weaver, and other contracts (direct issuing is not supported)."
-version: 1.0.6
+description: "泛微 E10 业票通发票管理：查询票夹、OCR/查验、附件、流程发票字段、报销填单、查询待开票合同并创建开票申请草稿。"
+description_zh: "泛微 E10 业票通发票管理。支持查询个人/企业票夹、查看详情、上传、OCR/查验预览、下载附件、流程表单发票字段数据，通过 prepare/apply 确认链处理导入、新增、编辑、删除；报销填单由本技能准备发票、事前申请、工作流等数据，报销单创建/修改调用 weaver-e10-workflow 的发起/修改能力；AI 开票先用 weaver-e10-workflow 查出当前用户有权限看的合同审批流程，补齐是否开票、合同号、客户名称和开票金额后列出待开票合同，用户选定并确认后，按销售方调用 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 AI invoicing that lists the user's contracts pending invoicing and, after confirmation, drafts the invoice-application workflow via weaver-e10-workflow."
+version: 1.0.7
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -13,11 +13,11 @@ requires:
 cliHelp: "weaver-work-cli invoice --help"
 ---
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 `[../weaver-e10-shared/SKILL.md](../weaver-e10-shared/SKILL.md)`，其中包含安装、E10 认证、JSON 输出、超时与重试预算、非交互环境处置和高风险写入规则。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须调用宿主提供的提问/确认弹框，向用户说明必须补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行）及补齐计划，并把下面两条待执行命令原样完整展示在确认信息中；Agent 不能在未确认时自行安装。用户明确确认后，Agent 必须直接代为按顺序执行且每条仅执行一次，不得要求或引导用户手动执行：① 缺 CLI 时执行 `npm install -g weaver-work-cli`；② 再执行 `weaver-work-cli skills install shared --target-dir <SKILLS_ROOT>` 装回共享 skill，`<SKILLS_ROOT>` 取本 SKILL.md 所在目录的上一级绝对目录（即与本技能同级的 skills 根目录），不要省略 `--target-dir`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
+**CRITICAL — 开始前 MUST 直接执行本技能的业务命令（`weaver-work-cli --json invoice run ...`）；不要预先读取共享规则，也不要先跑 `auth status`、`doctor --e10`、`auth xiaoe` 等登录或状态检查。** 小e（XiaoE）环境下登录由 CLI 自己在公共会话加载层完成：进程内存在任意 `XIAOE_*` 环境变量（宿主新增 `XIAOE_CLIENT_TYPE=client|cloud`，分别表示桌面客户端与网页端）时，缺少本地会话会自动换取登录信息并继续执行原请求，已有会话被拒绝为失效时静默恢复并原样重放 1 次，换票结果落盘供后续命令复用。Agent 不参与该过程，**也不得在思考过程或回复中描述登录、换票、重登、会话恢复等中间步骤**，只呈现业务结果。仅以下三种情形才读取 `[../weaver-e10-shared/SKILL.md](../weaver-e10-shared/SKILL.md)`：① 命令不可用（`command not found` / 退出码 127），或返回 `authentication` / `session_expired` 且 CLI 自动恢复后仍失败、`subtype=xiaoe_credential_unavailable`；② 即将执行写入/删除/导入类操作（确认、continuation 与回查协议）；③ 需要判定是否传 `--is-connector`。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须调用宿主提供的提问/确认弹框，向用户说明必须补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行）及补齐计划，并把下面两条待执行命令原样完整展示在确认信息中；Agent 不能在未确认时自行安装。用户明确确认后，Agent 必须直接代为按顺序执行且每条仅执行一次，不得要求或引导用户手动执行：① 缺 CLI 时执行 `npm install -g weaver-work-cli`；② 再执行 `weaver-work-cli skills install shared --target-dir <SKILLS_ROOT>` 装回共享 skill，`<SKILLS_ROOT>` 取本 SKILL.md 所在目录的上一级绝对目录（即与本技能同级的 skills 根目录），不要省略 `--target-dir`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
 **`--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>` 执行（唯一例外：报销单与开票流程的创建/修改调用 `weaver-e10-workflow` 技能的 `weaver-work-cli --json workflow run workflow.*`，见下方「报销填单」「AI 开票」）：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli invoice schema` 是 operation、字段和风险等级的合约来源。
+登录与会话由 CLI 托管，Agent 不做登录前置；只有本文件 CRITICAL 列出的三种情形才按共享规则使用 `weaver-work-cli auth ...` 命令体系判断登录态。禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
+所有命令通过 `weaver-work-cli --json invoice run <operation>` 执行（例外：报销单与开票申请的创建/修改、AI 开票的合同流程查询调用 `weaver-e10-workflow` 技能的 `weaver-work-cli --json workflow run workflow.*`，见下方「报销填单」「AI 开票」）：简单 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/查验服务，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
 
@@ -27,7 +27,7 @@ cliHelp: "weaver-work-cli invoice --help"
 
 本文件在技能加载时已整体注入上下文，**不要再用 Read 读本 SKILL.md**；仅需核对 `version` / `agent_created` 时读前 15 行，且**修改本包内文件不必先确认 `agent_created`**（此处已声明 `true`）。
 
-- **共享规则 `../weaver-e10-shared/SKILL.md` 同一会话只读一次**：内容已在本轮上下文时直接复用；仅新会话或内容明显过期时重读。
+- **共享规则 `../weaver-e10-shared/SKILL.md` 不是前置**：只有 CRITICAL 列出的三种情形才读，同一会话只读一次；内容已在本轮上下文时直接复用。
 - **只读命中路由的那个 reference**。reference 是参数与字段的第一信息源；reference 已覆盖的参数不要再跑 `--help`，`schema` 只用于确认 operation 清单与风险等级。
 - **单点查询压缩成三个动作**：读 1 个 reference → 1 条 CLI 命令 → 直接输出。已给出 `fid` / `number` 时禁止 `list → filter → get` 链路。
 - **同一字段不重复查**：一轮内已有新鲜结果就复用，不要为"再确认一次"重跑同一个只读 operation。
@@ -53,10 +53,10 @@ cliHelp: "weaver-work-cli invoice --help"
 - 发票上传 / OCR 识别 / 查验预览 / 附件下载
 - 导入发票 / 新增发票 / 编辑发票 / 删除发票
 - 发票报销 / 自动填单 / 事前申请报销 / 报销单创建或更新
-- 开票 / 开专票 / 开普票 / 存台账 / 智能开票 / 按合同开票 / 发起开票流程
+- 开票 / 智能开票 / 待开票合同 / 哪些合同还没开票 / 开票申请
 - `fid` / `fileId` / 发票号码 / 发票代码 / 查验状态 / 报销状态
 
-**判定规则：** 只要最终动作是对业票通发票做查询、查看、上传、OCR、查验预览、下载、导入、新增、编辑、删除、流程表单发票字段、发票报销填单或开票/存台账，就归 `weaver-e10-yepiaotong`。只有当用户处理的是非发票类 E10 业务、通用工作流或尚未封装的业票通能力时，才不使用本 Skill。
+**判定规则：** 只要最终动作是对业票通发票做查询、查看、上传、OCR、查验预览、下载、导入、新增、编辑、删除、流程表单发票字段、发票报销填单或开票，就归 `weaver-e10-yepiaotong`。只有当用户处理的是非发票类 E10 业务、通用工作流或尚未封装的业票通能力时，才不使用本 Skill。
 
 **查验路由判断（常见误用）：**
 
@@ -76,7 +76,7 @@ cliHelp: "weaver-work-cli invoice --help"
 | 查看可用 operation、字段和风险等级     | `invoice schema`                                 | `[invoice-agent-entry.md](references/invoice-agent-entry.md)`                     |
 | 查询个人票夹                     | `invoice run invoice.list`                       | `[invoice-personal-list.md](references/invoice-personal-list.md)`                 |
 | 查询企业票夹                     | `invoice run invoice.enterprise.list`            | `[invoice-enterprise-list.md](references/invoice-enterprise-list.md)`             |
-| **让发票列表/详情直接可读（别写解析脚本）** | `invoice list --format markdown` / `invoice get --fid X --format markdown`；给程序消费用 `--view summary` / `--view detail` | `[invoice-output-view.md](references/invoice-output-view.md)` |
+| **让发票列表/详情直接可读（别写解析脚本）** | 列表加 `--view summary`，详情加 `--view detail` | `[invoice-output-view.md](references/invoice-output-view.md)` |
 | 按 `fid` 或 `number` 查看详情    | `invoice run invoice.get`                        | `[invoice-detail.md](references/invoice-detail.md)`                               |
 | 上传发票文件                     | `invoice run invoice.upload`                     | `[invoice-file-upload.md](references/invoice-file-upload.md)`                     |
 | OCR 预览，不保存到票夹              | `invoice run invoice.ocr.preview`                | `[invoice-ocr-preview.md](references/invoice-ocr-preview.md)`                     |
@@ -88,10 +88,9 @@ 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)`                       |
 | 相关客户 / 相关项目模糊搜索              | `invoice run invoice.reim.field.search`      | `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「相关客户模糊搜索」 |
 | 报销 CLI operation 入参与返回值    | AI 内部                                            | `[reim-api-reference.md](references/reim-api-reference.md)`                       |
 | 发票与事前申请匹配规则                | AI 内部                                            | `[reim-matching-rules.md](references/reim-matching-rules.md)`                     |
@@ -99,9 +98,7 @@ cliHelp: "weaver-work-cli invoice --help"
 | 报销表单字段填充与 JSON 组装规则        | AI 内部                                            | `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`                   |
 | 话费补贴 / 话费报销硬拦截规则           | AI 内部                                            | `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`           |
 | 报销端到端示例                    | 参考                                               | `[reim-examples.md](references/reim-examples.md)`                                 |
-| **开票（默认，唯一链路）：获取待开票合同数据后发起开票流程草稿** | `invoice run invoice.issuing.qys.list` -> `workflow run workflow.createForm/createRequest`（`weaver-e10-workflow`） | `[invoice-issuing-workflow.md](references/invoice-issuing-workflow.md)` |
-| 开票流程填单规则（默认值：本次开票金额 = 总金额等） | AI 内部 | `[invoice-issuing-form-fill-rules.md](references/invoice-issuing-form-fill-rules.md)` |
-| 开票端到端示例                    | 参考                                               | `[invoice-issuing-examples.md](references/invoice-issuing-examples.md)`           |
+| **AI 开票：查询待开票合同 → 创建开票申请草稿** | `workflow run workflow.search` -> `invoice run invoice.issuing.contracts.list` -> `invoice run invoice.issuing.contract.detail` -> `workflow run workflow.createForm/createRequest`（`workflow.*` 属 `weaver-e10-workflow`） | `[invoice-issuing-workflow.md](references/invoice-issuing-workflow.md)` |
 | 共享、转让、标签或 schema 未列出的能力    | 无可用命令                                            | `[invoice-disabled-capabilities.md](references/invoice-disabled-capabilities.md)` |
 
 
@@ -118,18 +115,13 @@ cliHelp: "weaver-work-cli invoice --help"
 - 编辑发票：`invoice.update.prepare` -> 用户确认 -> `invoice.update.apply`
 - 删除发票：`invoice.delete.prepare` -> 用户确认 -> `invoice.delete.apply`
 - 流程发票字段：已有 `fid` 或详情时，用 `invoice.browse-field.data` 生成浏览按钮对象；不要运行旧源码脚本或直接调接口。
-- 报销填单（完整工作流见 `[reim-workflow.md](references/reim-workflow.md)`）：先用 `invoice.reim.candidates.list`（按日期批量）/`invoice.list`/`invoice.get`/`invoice.reim.file-ocr.preview` 获取发票（日期筛选默认 `consumption_tm_begin` / `consumption_tm_end`；出差 / 去某城市报销时出发城市没说默认上海，消费日期落在出差时间内的出发城市打车票也一起筛进来，见 `[reim-workflow.md](references/reim-workflow.md)`「出差 / 城市意图查票」）-> 展示汇总并确认 -> `invoice.reim.requests.list` 只按开票日期和事前申请发起日期关联（只比日期不比钟点，发起日与开票日同一天算对上，默认绑定），一张发票同时落在多条上时让用户选 -> `invoice.reim.workflow.resolve` 得到报销工作流 -> 并行 `workflow.createForm`（`weaver-e10-workflow`，传 `{workFlowName}({workFlowId})`，**不传 `userQuestion`**，也不用 `workflow.createRequestDirect`）、`invoice.browse-field.data`（只传发票）-> 按规则组装 `data`（**`requestName` 与「报销事由」必传**，按 form-fill-rules 的标题/事由公式生成，禁止留用表单默认标题或留空；发票与事前申请只按时间关联，见 `[reim-matching-rules.md](references/reim-matching-rules.md)`，填单规则见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`；明细「费用类型（科目）」不传，由发票联动带出；命中话费补贴/话费报销时先读 `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`；工作流是「总部费用报销」时，用本次 `createForm` 的 `historyRequestData` 在项目确认后带出合同号，**不要询问合同号**；相关客户和相关项目需要填写时同一次让用户一起输入，未确认不建单，见 `[reim-workflow.md](references/reim-workflow.md)` Step 4.4、Step 4.5；明细「费用说明」「费用明细」不写入 `data`，由发票联动带出）-> 直接 `workflow.createRequest` 存草稿（`action` 固定 `"draft"`，**不问用户「存草稿 / 提交审批」**，草稿由用户在 E10 核对后自己提交）-> 原样粘贴 `finalMarkdown` -> **必须做 Step 5.3**：查客户 / 项目是否被联动冲空（已确认值直接写回，不要先建空草稿再问）。创建成功后修改只能用 `workflow.editLoad` -> `workflow.editPrepare` -> 用户确认 -> `workflow.editApply`。
+- 报销填单（完整工作流见 `[reim-workflow.md](references/reim-workflow.md)`）：先用 `invoice.reim.candidates.list`（按日期批量）/`invoice.list`/`invoice.get`/`invoice.reim.file-ocr.preview` 获取发票（日期筛选默认 `consumption_tm_begin` / `consumption_tm_end`；**出差报销先找出差流程**：`invoice.reim.requests.list` 传 `requestname="出差"`，用 `workflow.summary`（`weaver-e10-workflow`，只读）读「起始日期」「结束日期」，按起始日期前 1 天 ~ 结束日期后 1 天用 `invoice.reim.candidates.list` 查票，期间 `available` 的发票全部列入并全部绑这条出差流程，多条出差流程对不上时先问用户；找不到出差流程才按城市筛（出发城市没说默认上海），见 `[reim-workflow.md](references/reim-workflow.md)`「按出差流程查票」「出差 / 城市意图查票」）-> 展示汇总并确认 -> `invoice.reim.requests.list`（用户没指定日期时不传 `cusCreateDateStart` / `cusCreateDateEnd`，CLI 默认查最近 7 天、查不到放宽到 1 个月；话费传 `scene="phone"` 查最近 90 天）只按开票日期和事前申请发起日期关联（只比日期不比钟点，发起日与开票日同一天算对上，默认绑定），**多条事前申请确认不了是哪条时（一张发票时间上落在多条、没有开票日期、用户点名的对上多条），必须一次问清用户，选定前不往下走、不替用户选** -> `invoice.reim.workflow.resolve` 得到报销工作流 -> 并行 `workflow.createForm`（`weaver-e10-workflow`，传 `{workFlowName}({workFlowId})`，**不传 `userQuestion`**，也不用 `workflow.createRequestDirect`）、`invoice.browse-field.data`（只传发票）-> 按规则组装 `data`（**`requestName` 与「报销事由」必传**，按 form-fill-rules 的标题/事由公式生成，禁止留用表单默认标题或留空；发票与事前申请只按时间关联，见 `[reim-matching-rules.md](references/reim-matching-rules.md)`，填单规则见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`；明细每行只写「相关发票」和（可选的）「相关流程」；命中话费补贴/话费报销时先读 `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`；工作流是「总部费用报销」时，用本次 `createForm` 的 `historyRequestData` 在项目确认后带出合同号，**不要询问合同号**；相关客户和相关项目需要填写时同一次让用户一起输入，未确认不建单，见 `[reim-workflow.md](references/reim-workflow.md)` Step 4.4、Step 4.5）-> 直接 `workflow.createRequest` 存草稿（`action` 固定 `"draft"`，**不问用户「存草稿 / 提交审批」**，草稿由用户在 E10 核对后自己提交）-> 原样粘贴 `finalMarkdown` -> **必须做 Step 5.3**：查客户 / 项目是否被联动冲空（已确认值直接写回，不要先建空草稿再问）。创建成功后修改只能用 `workflow.editLoad` -> `workflow.editPrepare` -> 用户确认 -> `workflow.editApply`。
 - 报销单创建/修改依赖同级的 `weaver-e10-workflow` 技能（`../weaver-e10-workflow/`）；该技能不存在时停止并告知用户需要安装，不要改用其他方式创建报销单。
-- **⚠️ 报销单不询问合同号。** 默认 `20260999`。用户本轮自己说了才用用户的；否则按已确认的相关项目，从 `historyRequestData` 里该项目最近一条带出。对不上或项目「不填」则用默认。带出的合同号不是 `20260999` 时，创建阶段承担主体不传。**相关客户和相关项目同一次让用户一起输入**，确认后再写入 `data`，禁止空着先建草稿，也不要拆成两轮。名称先 `invoice.reim.field.search`。明细「费用说明」不自己生成，交给发票联动。口径见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「总部费用报销历史参考」「费用明细字段规则」。
-- **⚠️ 明细列「费用明细」禁止填值**：`createForm` 的 `fields` 里名称是「费用明细」的明细列不要写入 `data`。只传「相关发票」，由发票联动带出。用户给了文字也不要写入。建单后这一列仍空，就说明联动没带出，不要补写。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
-- **⚠️ 明细「费用说明」禁止自己生成**：`createForm` 的 `fields` 里名称是「费用说明」或「摘要」的明细列不要写入 `data`。不要用 `fysm`、起止点、消费内容或话费账单说明去填。只传「相关发票」，由发票联动带出。用户给了文字也不要写入。建单后仍空，只说明联动没带出，不要补写。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
-- **⚠️ 明细每行只写「相关发票」**：有绑定的事前申请时再写「相关流程」（差旅 / 外出每行必须有）。费用日期、金额、币种、费用类型（科目）、费用说明、费用明细、相关凭证、明细相关客户 / 项目、附件数等其余明细列**一律不传**，由「相关发票」联动带出；表单默认值、`row-info` 返回值、用户口述都不写进去。建单后仍空只告知联动没带出，不补写。建单不再调用 `invoice.reim.row-info-batch`。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
-- **⚠️ 明细「费用类型（科目）」不允许 AI 填值**：创建时不写入 `data`，保留空值，由「相关发票」联动带出。不要用 `row-info` 的 `subjectId`、科目匹配规则或兜底科目「其他-管理费用」自己填。建单后仍空只告知联动没带出，不补写，也不让用户选科目；只有用户明确要求改某行科目时才走修改链。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
-- **⚠️ 明细「相关凭证」不允许赋值**：创建和修改都不写入 `data`，由「相关发票」联动带出。不做凭证配对，`invoice.browse-field.data` 只传发票。建单后仍空只告知联动没带出，不补写，也不让用户挂行程单。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「3. 相关凭证不赋值」。
+- **⚠️ 报销单不询问合同号。** 默认 `20260999`。用户本轮自己说了才用用户的；否则按已确认的相关项目，从 `historyRequestData` 里该项目最近一条带出。对不上或项目「不填」则用默认。带出的合同号不是 `20260999` 时，创建阶段承担主体不传。**相关客户和相关项目同一次让用户一起输入**，确认后再写入 `data`，禁止空着先建草稿，也不要拆成两轮。名称先 `invoice.reim.field.search`。口径见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「总部费用报销历史参考」。
+- **⚠️ 明细每行只写「相关发票」**：有绑定的事前申请时再写「相关流程」（差旅 / 外出每行必须有）。费用日期、金额、币种、费用类型（科目）、费用说明 / 摘要、费用明细、相关凭证、明细相关客户 / 项目、附件数等其余明细列**创建时一律不传**，由「相关发票」联动带出：表单默认值、用户口述、科目匹配规则、兜底科目都不写进去，也不要用消费内容、起止点或话费账单说明自己生成费用说明。不做凭证配对，`invoice.browse-field.data` 只传发票。建单后仍空只告知联动没带出，不补写，也不让用户选科目、挂行程单；只有用户明确要求改某行科目时才按 `[reim-expense-subject-rules.md](references/reim-expense-subject-rules.md)` 走修改链。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
 - **⚠️ 主表「事前申请流程」不允许赋值**：创建报销单时不写入 `data.main`，保留空值。匹配到的事前申请只写到明细每行「相关流程」（`{requestname}({requestid})`）。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「主表字段规则」。
-- **AI 开票（默认主链路，所有开票意图先走这条）**：`invoice.issuing.qys.list`（合同号传 `contractNo`，公司名等传 `keyword`；没有线索只问一句合同号或客户名）-> 按返回的 `groups`（一组 = 合同号 + 购方 = 一张流程）让用户选组 -> **购方无税号却是专票（`specialInvoiceWithoutTaxNo=true`）时硬拦截：没有税号只能开普票，请用户先在台账改为普票，不发起流程** -> 展示确认卡片（明确"只建草稿，不会直接开票"；必填的「预计收款时间」在卡片里请用户从本月底 / 下月底 / 30 天后候选里选或直接给日期，不自己定默认值，**用户没给日期就不建草稿**）-> 用户确认 -> `workflow.createForm`（`weaver-e10-workflow`，按台账「核算公司」`sellerNames` 选择，名称必须完全相同：只有「上海亘岩网络科技有限公司」时传 `契约锁合同收款发票开具及快递申请(100003460000001852)`；是泛微网络、泛微软件、上海田亩、成都泛微、泛微国际、北京泛微、浙江泛微之一时传 `合同收款发票开具及快递申请(100003460000000214)`；为空或不在这份名单里时先问用户，选定前不建草稿。用户要退票、冲红或红冲时改为 `合同开票冲红流程(887410479139758085)`，不套用开票填单规则。**不传 `userQuestion`**，**不要按宽词“开票”检索**）-> 按 `[invoice-issuing-form-fill-rules.md](references/invoice-issuing-form-fill-rules.md)` 组装 `data`（用户说了就按用户的，没说就按默认值，例如本次开票金额默认 = 总金额、开票事由自动生成、所售产品版本号取明细规格类型（与下拉选项完全一致才填）；「开票内容」只在 `契约锁合同收款发票开具及快递申请(100003460000001852)` 上按明细货物名称推断后传入，其他流程忽略该字段；明细每行只传「金额（含税）」，其余列（货物名称、明细行id、单价、规格类型、税率、总开票金额 / 已开票金额 / 未开票金额等）由合同号联动带出，多传会让总开票金额带不出来；明细「数量」和主表「开户行名称」「开户行银行帐号」创建时不传（数量会被联动写成税率选项 id；开户行会被写成名称账号混写串）；其余购方信息由合同号联动带出，不传）；`requestName` 按 `开票申请-{购方名称}-{合同号}` 必传 -> `workflow.createRequest`（`action` 固定 `"draft"`）-> 原样粘贴 `finalMarkdown`，再用 `linkageResult` 的「是否存在合同明细数据」「总开票金额」和「本次开票总金额」核对明细是否带出、本次填的开票金额是否一致（台账开票金额为含税金额）-> **创建后补正**：`workflow.editLoad` 读草稿。开户行名称 / 账号取分组里 CLI 拆好的 `purchaserBankName` / `purchaserBankAccount`（为空时按「，账号：」拆只读字段「开户行及帐号」），`workflow.editPrepare` **只传主表这两个字段**，用户确认后 `workflow.editApply`。只有契约锁开票流程才在创建时写入「开票内容」，不要再用编辑链改（`editPrepare` 会报错）；没有匹配到选项时才提醒用户在 E10 选择。其他流程没有这个字段，不推断、不提醒。明细数量不经编辑链改（会多出一行）：回复末尾把每行数量改成台账 `items[].quantity`（按「明细行id」对应）。创建成功后修改只走 `workflow.editLoad/editPrepare/editApply`，禁止重复创建。详见 `[invoice-issuing-workflow.md](references/invoice-issuing-workflow.md)`。
-- **开票没有兜底链路（0.1.27 起）**：CLI 已移除 `invoice.issuing.make.prepare/apply`、`invoice.issuing.qys.prepare`、`invoice.issuing.result`，**不存在"直接开票/存待开台账"的接口**。用户说"直接开票""不走流程""存待开台账"时，一律走上面的主链路创建开票流程草稿，并向用户说明：开票必须经所选开票流程审批后由流程侧完成；数据不在待开票合同数据里时，提示用户先录入合同商品信息，再按主链路发起。
-- 开票流程的创建/修改依赖同级 `weaver-e10-workflow` 技能；该技能不存在时停止并告知用户需要安装，**不要尝试用其他方式直接开票**。
+- **AI 开票**：`workflow.search`（`weaver-e10-workflow`，固定传 `category="all"`、`workflow=["老客户增值服务合同审批流程","新客户购买合同审批流程","常规二次销售服务合同审批流程"]`、`pageSize=10`；用户点名了客户、公司、地名、合同号或标题关键词时再追加 `requestName`，按流程标题 like 模糊搜索，如 `"鄂尔多斯"`，没点名不传，翻页原样带上，不要把「合同」「开票」当作 `requestName`）-> 把返回的 `data.cards` 原样作为 `cards` 传给 `invoice.issuing.contracts.list`，拿到 `invoiced`、`contractNo`、`customerName`、`invoiceAmount`、`sellerName` -> 只列 `invoiced=false` 的合同，问用户给哪份开票（不替用户选，金额以 CLI 为准不自己累加）-> `invoice.issuing.contract.detail` 取客户 `{id, name}` 和「合同正文及附件」每个文件的 `docId`、`name` -> `sellerName` 含「亘岩」用 `契约锁合同收款发票开具及快递申请(100003460000001852)`，其他用 `合同收款发票开具及快递申请(100003460000000214)` -> **必须先问用户「预计收款时间」**（`yyyy-MM-dd`，不猜、不留空，用户没给就不往下走），连同日期向用户确认一次 -> `workflow.createForm`（不传 `userQuestion`）-> `workflow.createRequest`（`action` 固定 `"draft"`，**不提交**），`data.main` 只填合同审批流程 `{id,name}`、合同客户 `{id,name}`、合同文本 `{id,name}`（`id` 用 `docId`，`name` 用文件名；多个文件传数组，不要传 `contractDocIds` 逗号串或纯数字 id）、预计收款时间，契约锁流程再填合同号 `contractNo`（另一张表的合同号是浏览按钮字段，写不进去，靠联动带出）-> 原样粘贴 `finalMarkdown`。创建成功后修改只走 `workflow.editLoad/editPrepare/editApply`，禁止重复创建。详见 `[invoice-issuing-workflow.md](references/invoice-issuing-workflow.md)`。
+- 合同流程查询与开票申请草稿依赖同级 `weaver-e10-workflow` 技能；该技能不存在时停止并告知用户需要安装，不要用其他方式创建开票申请。
 
 ## 执行原则（减少误路由、误重试和无效消耗）
 
@@ -146,10 +138,10 @@ cliHelp: "weaver-work-cli invoice --help"
 
 - 当前 CLI 会把完整 JSON envelope 写 stdout；Agent 回复时不要原样贴完整 JSON
 - **输出超过阈值（默认 24KB）时 CLI 会把完整结果暂存成 ref**：stdout 只剩预览 + `refId`，`operations` 之类的长数组会被截断。此时**不要**把预览当成完整结果解析，一律用 `weaver-work-cli refs get <refId> <JSON路径>`（如 `operations[2].outputViews` / `operations[0].name`）按需取字段。`refs show <refId>` 只对"小结果"可用：`invoice schema` 实测 231662 字节，`refs show` 会被直接拒绝并回显「结果太大，不能安全地一次显示」。
-- **查询票夹时优先加 `--format markdown`（要展示给人看）或 `--view summary`（要喂给下游代码）**，一次调用即可得到可读清单，不要为此现写解析脚本；需要精确字段用 `--fields number,detailUrl`；旧版 CLI 用 `references/invoice-summarize.py` 兜底。**拿到 markdown 输出后要作为消息正文直接输出，不要用代码围栏包裹**（包上就退化成纯文本，号码链接失效）。完整规则见 `[invoice-output-view.md](references/invoice-output-view.md)`
+- **查询票夹时优先加 `--view summary`**（详情用 `--view detail`），一次调用即可得到语义字段，不要为此现写解析脚本；需要精确字段用 `--fields number,detailUrl`；旧版 CLI 用 `references/invoice-summarize.py` 兜底。按字段拼好的 markdown 表格直接写在消息正文里，不要用代码围栏包裹（包上就退化成纯文本，号码链接失效）。完整规则见 `[invoice-output-view.md](references/invoice-output-view.md)`
 - **发票号码必须附带可点击的超链接**：CLI 返回的列表项和详情中已包含 `detailUrl` 字段（格式为 `{baseUrl}/sp/inc/incDetail?fid=<fid>`）。Agent 向用户展示发票时，发票号码必须用 markdown 链接格式 `[发票号码](detailUrl)` 展示，让用户点击即可打开发票详情页。如果同时有发票代码，代码也附带同一链接。示例：`[00188205](https://e10.example.com/sp/inc/incDetail?fid=751293486469988353)`
 - 列表最多先展示最相关的前 10 条，包含 `fid`、代码/号码（带超链接）、购销方、金额、日期、查验/报销状态和附件摘要
-- 需要全量统计时，按 `start_pos` 分页读取并累计必要字段；说明已读取页数、命中数和是否还有更多
+- 需要全量统计时，按 `start_pos` 分页读取并累计必要字段；`start_pos` 每次加 `page_size`，有没有下一页只看 `hasMore`（列表已剔除全额红冲票，本页条数可能不满 `page_size`）；说明已读取页数、命中数和是否还有更多
 - OCR、详情或调试用完整响应过长时，优先落本地文件并向用户提供摘要和文件路径
 
 ### 2) 已知对象时直达动作
@@ -163,13 +155,13 @@ cliHelp: "weaver-work-cli invoice --help"
 - 失败后先看进程退出码、`error.type`、`error.subtype` 和 `error.message`
 - **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个 operation**
 - 写请求已经发出后，遇到结果不确定必须停止；不要把 `.apply` 当成可重试读操作
-- **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试**。
-- 认证失败后先读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`：
-  - 已有 XiaoE 会话的 `session_expired` 已由 CLI 底层自动换票并重放一次；若错误最终仍返回，Agent 只反馈并停止，不执行任何登录命令、其他登录 Skill 或原业务命令。
-  - 仅首次无会话或明确的 `auth not found` 才由 Agent 复用任务开始时的宿主判定。
-  - 首次认证明确为 XiaoE 时，执行一次 `weaver-work-cli auth xiaoe`；返回 `authentication/xiaoe_credential_unavailable` 时停止，不回退浏览器登录。
-  - 首次认证且非 XiaoE 时不得执行 `auth xiaoe`；取得用户确认的真实 E10 登录域名后，执行 `weaver-work-cli auth login --base-url "<用户确认的 E10 登录域名>" --agent_type "<当前智能体名称>"`。环境不能完成本机浏览器回调时停止并反馈。
-  - 显式登录后读操作可重新执行；写操作不得复用旧 continuation，必须重新 prepare 并重新确认。已返回 `partial/write_uncertain` 时先只读回查，禁止直接重放写入。
+- 错误为 `validation/operation_retired` 时，说明调用的是已下线的旧 operation（如 `invoice.reim.flow.create.*`、`invoice.issuing.qys.list`）：按 `error.details.replacement` 改走新链路，并读 `error.details.reference` 指向的文档，不要换名字重试旧接口；完整清单见 `invoice schema` 的 `retiredOperations`
+- **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：不要盲目重试、不要换域名重试、不要用示例占位域名登录**。先判断 CLI 是否已经自动处理：
+  - **小e 环境（进程内存在任意 `XIAOE_*`，含 `XIAOE_CLIENT_TYPE=client|cloud`）**：登录缺失与过期都由 CLI 底层在公共请求层静默换取并原样重放 1 次，Agent 不执行任何登录命令——包括 `weaver-work-cli auth xiaoe`——也不重跑原业务命令，**也不在思考或回复里复述登录、换票、重登、会话恢复过程**。仍返回 `session_expired` 或 `authentication/xiaoe_credential_unavailable` 时，用一句话告知「小e 当前登录态不可用，请在小e 中重新登录后重试」并停止，不回退浏览器登录。
+  - **非小e 环境**才读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`，并按其中流程处理：
+    - 仅首次无会话或明确的 `auth not found`，才由 Agent 复用任务开始时的宿主判定。
+    - 首次认证且非 XiaoE 时不得执行 `auth xiaoe`；取得用户确认的真实 E10 登录域名后，执行 `weaver-work-cli auth login --base-url "<用户确认的 E10 登录域名>" --agent_type "<当前智能体名称>"`。环境不能完成本机浏览器回调时停止并反馈。
+- 显式登录后读操作可重新执行；写操作不得复用旧 continuation，必须重新 prepare 并重新确认。已返回 `partial/write_uncertain` 时先只读回查，禁止直接重放写入。
 - 登录类命令必须带 timeout 限时（上限 300 秒 / 5 分钟，后台运行 + 限时观察）：输出一旦出现 `Open browser login`、`Waiting for E10 authorization callback` 或 `Could not open browser automatically`，即判定已降级到浏览器 OAuth，立即终止该命令并反馈，不得继续等待。登录失败不自动重试。
 - 需要浏览器登录时必须携带发起方标识 `--agent_type "<当前智能体名称>"`（授权确认页展示用；宿主无法确认名称时才可省略，交由 CLI 从环境变量推断）。
 
@@ -222,7 +214,7 @@ weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pa
 ## 不在本 skill 范围
 
 - 禁止加载原始 `weaver-e10-yepiaotong` Skill 代替 CLI。
-- 已有 CLI 封装的能力（list/get/upload/OCR/import/add/update/delete/issuing/reim）禁止 curl、fetch、浏览器自动化或直接访问 E10 `/api/inc/*`，必须通过 CLI。
+- 已有 CLI 封装的能力（list/get/upload/OCR/import/add/update/delete/issuing/reim）禁止 curl、fetch、浏览器自动化或直接访问 E10 `/api/inc/*`、`/api/workflow/*`、`/api/ebuilder/*` 等接口，必须通过 CLI。
 - 当前修正源资料未提供客户档案查询或红字发票红冲接口，`invoice.customer.*` 与 `invoice.red.*` 不属于可用 operation；遇到这类请求时读取 `[invoice-disabled-capabilities.md](references/invoice-disabled-capabilities.md)` 并说明当前 CLI 不支持绕过调用。
 - 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
 - 禁止读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。

package/skills/weaver-e10-yepiaotong/references/invoice-agent-entry.md

@@ -6,13 +6,16 @@
 
 ## 准备命令
 
+直接用一条不依赖登录态的只读命令确认可用：
+
 ```text
-weaver-work-cli --version
-weaver-work-cli doctor --e10
 weaver-work-cli invoice schema
 ```
 
-如未登录，按共享规则读取 `../../weaver-e10-shared/references/e10-auth-and-session.md` 后处理。
+- **小e 环境（进程内存在任意 `XIAOE_*`，含 `XIAOE_CLIENT_TYPE=client|cloud`）**：不要执行 `weaver-work-cli --version` 或 `doctor --e10`，版本更新与登录由小e 客户端和 CLI 会话层托管；业务命令缺少会话时会自动换取登录信息并继续执行，已有会话失效时静默恢复并重放 1 次。
+- **非小e 环境**首次使用才执行 `weaver-work-cli --version` 与 `doctor --e10`。
+
+仅在认证最终失败（`authentication` / `session_expired` / `xiaoe_credential_unavailable`）时，才按共享规则读取 `../../weaver-e10-shared/references/e10-auth-and-session.md`。
 
 ## 固定入口
 

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

@@ -10,24 +10,27 @@
 | --- | --- |
 | `invoice.get` | 优先用 `fid`；没有 `fid` 时可用 `number` 查询 |
 
-## 要展示给用户时：`--format markdown`（首选）
+## 要展示给用户时：`--view detail`（首选）
+
+macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli invoice get --fid 12345 --format markdown
-weaver-work-cli invoice get --number 26342000002783695141 --format markdown
+weaver-work-cli --json invoice get --fid 12345 --view detail
+weaver-work-cli --json invoice get --number 26342000002783695141 --view detail
 ```
 
-用户直接给发票号码时，**不必先查列表**：`invoice get --number <号码> --format markdown` 可一次拿到同样的标头 + 字段表（已实测 0.1.20 可用）。
-
-直接得到「标头 + 字段表」的 markdown：标头是 `**[发票号码](详情链接)** · 票种`（**号码本身即可点击**，直达 E10 发票详情页，不再单列 `[打开详情]` 行），字段表首两行固定为 `发票号码`（同一链接）与 `发票代码` —— 票面标识必须在「项目」列里可核对、可复制；数电票（全电发票）没有发票代码，如实显示 `—`，不要伪造。其后依次是开票日期、不含税金额、税额、价税合计、购销方、费用说明、开票人、查验标记、报销挂单、附件。**不要**再自己拼这些行；贴给用户时把这整段作为消息正文直接输出，不要用代码围栏包裹（包上会退化成纯文本，号码链接失效）。
-
-需要给下游代码读时用 `--view detail`：语义字段平表（`data.items[]`），比 summary 多出 `attachments`（附件清单）、`expenseNote`（费用说明）、`issuer`（开票人）、`checkState`（查验标记，`0`=未做过查验登记，**与票面 `valid` 不是一个口径，不要混读**）。
+Windows PowerShell：
 
-```bash
+```powershell
 weaver-work-cli --json invoice get --fid 12345 --view detail
+weaver-work-cli --json invoice get --number 26342000002783695141 --view detail
 ```
 
-`--view detail` 只对 `invoice.get` 生效；`--format markdown` 与 `--json`、`--fields` 互斥（返回 `validation/input_conflict`）。
+用户直接给发票号码时，**不必先查列表**，用 `--number` 一次取到详情。
+
+`--view detail` 返回语义字段平表（`data.items[]`），包含 summary 的全部字段（含 `ext` 里的 `expenseNote` 费用说明、`city`、`province`、`comment` 备注、`from` / `to`、`stationGetOn` / `stationGetOff`），再多出 `attachments`（附件清单）、`issuer`（开票人）、`checkState`（查验标记，`0`=未做过查验登记，**与票面 `valid` 不是一个口径，不要混读**）。`--view detail` 只对 `invoice.get` 生效，与 `--fields` 互斥（返回 `validation/input_conflict`）。
+
+展示时拼成「标头 + 字段表」，直接写在消息正文里（不要包代码围栏，否则链接失效）：标头是 `**[发票号码](detailUrl)** · 票种`（号码本身即可点击，不再单列「打开详情」行）；字段表首两行固定为「发票号码」（同一链接）与「发票代码」，数电票（全电发票）没有发票代码时如实写 `—`，不要伪造；其后依次是开票日期、不含税金额、税额、价税合计、销方、购方、费用说明、消费内容、城市、省份、行程、备注、开票人、查验标记、报销挂单、附件。
 
 ## 示例
 

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

@@ -40,6 +40,8 @@ weaver-work-cli --json invoice run invoice.enterprise.list --input-json '{"page_
 
 返回 `items`、`total`、`totalAmount`、`totalAmountExcludingTax`、`hasMore` 和 `scope="enterprise"`。每条 item 包含 `detailUrl`（如 `https://xxx/sp/inc/incDetail?fid=<fid>`）。
 
+与个人票夹一样，`items` 已剔除全额红冲票，本页条数可能少于 `page_size`；`total` / `totalAmount` / `totalAmountExcludingTax` 是服务端汇总，仍含红冲票。分页时 `start_pos` 按 `page_size` 递增，是否还有下一页只看 `hasMore`。
+
 向用户展示发票列表时，**发票号码必须用 markdown 链接格式** `[号码](detailUrl)` 展示，让用户点击直接打开发票详情页。
 
 ## 注意