weaver-work-cli 0.1.2 → 0.1.5

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

@@ -0,0 +1,184 @@
+---
+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, confirmed invoice issuing, and red invoice management."
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+cliHelp: "weaver-work-cli invoice --help"
+---
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+认证和登录态只能按共享规则通过 `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、字段和风险等级的合约来源。
+命令示例、提示词和临时说明必须同时兼容 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/查验服务，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
+
+## 路由优先级（先判断是不是业票通发票，再选 operation）
+
+业票通发票不是通用 E10 对象。**只要用户的核心对象是业票通发票、个人/企业票夹、发票 OCR、发票查验或发票附件，就优先使用 `weaver-e10-yepiaotong`。**
+
+### 明确归 `weaver-e10-yepiaotong` 的高优先级语义
+
+出现以下任一语义时，优先走本 Skill：
+
+- 业票通 / 发票 / 票夹 / 个人票夹 / 企业票夹 / 发票详情 / 发票浏览按钮
+- 发票上传 / OCR 识别 / 查验预览 / 附件下载
+- 导入发票 / 新增发票 / 编辑发票 / 删除发票
+- 发票报销 / 自动填单 / 事前申请报销 / 报销单创建或更新
+- 开票 / 开专票 / 开普票 / 存台账 / 智能开票
+- 红冲 / 冲红 / 开红票 / 红字发票 / 红字确认单 / 红冲确认
+- `fid` / `fileId` / 发票号码 / 发票代码 / 查验状态 / 报销状态
+
+**判定规则：** 只要最终动作是对业票通发票做查询、查看、上传、OCR、查验预览、下载、导入、新增、编辑、删除、流程表单发票字段、发票报销填单、开票/存台账或红冲，就归 `weaver-e10-yepiaotong`。只有当用户处理的是非发票类 E10 业务、通用工作流或尚未封装的业票通能力时，才不使用本 Skill。
+
+## 选哪个命令
+
+### 票夹管理（CLI 命令）
+
+| 想做什么 | 命令 | 按需读取 reference |
+|---|---|---|
+| 查看可用 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) |
+| 按 `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) |
+| 查验预览，不回写查验结果 | `invoice run invoice.validate.preview` | [`invoice-validation-preview.md`](references/invoice-validation-preview.md) |
+| 下载发票附件 | `invoice run invoice.download` | [`invoice-download.md`](references/invoice-download.md) |
+| 准备/确认导入发票文件 | `invoice run invoice.import.prepare/apply` | [`invoice-import.md`](references/invoice-import.md) |
+| 准备/确认手工新增发票 | `invoice run invoice.add.prepare/apply` | [`invoice-add.md`](references/invoice-add.md) |
+| 准备/确认编辑发票 | `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) |
+| 报销完整工作流编排、行为准则 | AI 内部 | [`reim-workflow.md`](references/reim-workflow.md) |
+| 报销 CLI operation 入参与返回值 | AI 内部 | [`reim-api-reference.md`](references/reim-api-reference.md) |
+| 发票与事前申请匹配规则 | AI 内部 | [`reim-matching-rules.md`](references/reim-matching-rules.md) |
+| 费用科目自动匹配规则 | AI 内部 | [`reim-expense-subject-rules.md`](references/reim-expense-subject-rules.md) |
+| 报销表单字段填充与 JSON 组装规则 | AI 内部 | [`reim-form-fill-rules.md`](references/reim-form-fill-rules.md) |
+| 报销端到端示例 | 参考 | [`reim-examples.md`](references/reim-examples.md) |
+| 智能开票或存入待开台账 | `invoice run invoice.issuing.make.prepare/apply` | [`invoice-issuing.md`](references/invoice-issuing.md) |
+| 共享、转让、标签或 schema 未列出的能力 | 无可用命令 | [`invoice-disabled-capabilities.md`](references/invoice-disabled-capabilities.md) |
+
+### 红字发票 / 红冲（直接 API 调用）
+
+> 红冲能力通过发票 Token + E10 API 直接调用，CLI 尚未封装。
+> 需要 E10 上下文的 `BASE_URL` 和 `eteamsId`；发票 Token 由 `getToken` 接口获取。
+
+| 想做什么 | 调用方式 | 按需读取 reference |
+|---|---|---|
+| **红冲申请（全额/部分）** | `POST redConfirmationApply` | [`invoice-red.md`](references/invoice-red.md) |
+| **查询可红冲蓝票** | `POST queryAvailableBlueInfo` | [`invoice-red.md`](references/invoice-red.md) |
+| **查询红字确认单列表** | `POST queryRedConfirmationList` | [`invoice-red.md`](references/invoice-red.md) |
+| **查询红字确认单明细** | `POST queryRedConfirmationDetail` | [`invoice-red.md`](references/invoice-red.md) |
+| **红冲确认/拒绝/撤销** | `POST redConfirmationConfirm` | [`invoice-red.md`](references/invoice-red.md) |
+| 开票字段提取规则、税率推断、金额计算 | AI 内部 | [`invoice-issuing-field-rules.md`](references/invoice-issuing-field-rules.md) |
+| 开票/红冲端到端示例 | 参考 | [`invoice-issuing-examples.md`](references/invoice-issuing-examples.md) |
+
+处理链：
+
+- 查票夹/详情：`invoice.list` 或 `invoice.enterprise.list` -> 必要时 `invoice.get`
+- OCR 识别预览：`invoice.ocr.preview`；如果先上传，可复用 `invoice.upload` 返回的 `upload`
+- 导入文件：先 `invoice.ocr.preview` 预览票面识别结果；用户确认导入后，默认用 `invoice.import.prepare` 且传 `validate=true`、`syncToOa=true` -> 用户确认 -> `invoice.import.apply` -> 按返回 `fid` 回查/报告。只有用户明确要求“跳过查验/不同步 OA”时，才使用 `validate=false` 或 `syncToOa=false`。
+- 手工新增：`invoice.add.prepare` -> 用户确认 -> `invoice.add.apply`
+- 编辑发票：`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.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.employee-superiors` 组装 payload（匹配规则见 [`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)）-> `invoice.reim.flow.create.prepare` -> 用户确认 -> `invoice.reim.flow.create.apply`。创建成功后修改只能用 `invoice.reim.flow.update.prepare/apply`。
+- 智能开票：Agent 先提取并校验开票字段、税率和金额 -> `invoice.issuing.make.prepare` -> 用户确认开票或存台账 -> `invoice.issuing.make.apply`。
+- **红冲申请**：获取蓝字发票号 -> `queryAvailableBlueInfo` -> 展示蓝票 -> 确认方式+原因 -> 预览 -> `redConfirmationApply`
+- **红冲确认**：`queryRedConfirmationList` -> 选择 -> `queryRedConfirmationDetail` -> 确认 -> `redConfirmationConfirm`
+
+## 执行原则（减少误路由、误重试和无效消耗）
+
+### 1) 先拿最小必要信息，再执行
+
+- 只是查票夹时，优先直接用 `invoice.list` 或 `invoice.enterprise.list`
+- 列表默认先取小页，优先 `page_size=10`；用户没有要求全量时不要自动翻完整票夹
+- 查询个人/企业票夹时，用户没有明确要求“全部发票/已报销/报销中/不可报销”就不要传 `sreim`；CLI 默认 `sreim="3"`，只查未报销发票
+- 查询个人/企业票夹时，用户没有明确要求“凭证”就不要传 `bill_type`；CLI 默认 `bill_type=0`，只查发票
+- 用户已经给出 `fid` 时，不要先查列表再过滤，直接用 `invoice.get` 或对应 prepare
+- 只有需要附件归属、可编辑/可删除状态或完整票面时，才补 `invoice.get`
+
+### 1.5) 大结果只摘要给用户
+
+- 当前 CLI 会把完整 JSON envelope 写 stdout；Agent 回复时不要原样贴完整 JSON
+- 列表最多先展示最相关的前 10 条，包含 `fid`、代码/号码、购销方、金额、日期、查验/报销状态和附件摘要
+- 需要全量统计时，按 `start_pos` 分页读取并累计必要字段；说明已读取页数、命中数和是否还有更多
+- OCR、详情或调试用完整响应过长时，优先落本地文件并向用户提供摘要和文件路径
+
+### 2) 已知对象时直达动作
+
+- 已拿到 `fid`、`fileId`、本地文件路径或完整 `info` 时，优先调用对应 operation
+- 同一轮里如果已有足够的新鲜查询结果，不要重复查询同一票夹或同一详情
+- 不要默认走 `list -> filter -> get -> prepare -> apply` 全链路；对象已明确时应压缩步骤
+
+### 3) 错误语义驱动，而不是盲目重试
+
+- 失败后先看进程退出码、`error.type`、`error.subtype` 和 `error.message`
+- **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个 operation**
+- 写请求已经发出后，遇到结果不确定必须停止；不要把 `.apply` 当成可重试读操作
+- **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试**。先读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`，按其中流程用宿主提问/弹框让用户输入 E10 登录域名或选择已有 profile，完成登录后再继续原操作。
+
+### 4) 附件、图片和文件解析确认
+
+- 执行 `invoice.upload`、`invoice.ocr.preview`、`invoice.import.prepare/apply`、`invoice.reim.file-ocr.preview`，或任何会读取本地发票文件、上传远程 URL 文件、解析图片/PDF/OFD/XML、复用已上传 `upload` 对象、从附件提取开票字段的步骤前，必须先提醒用户文件内容可能进入大模型上下文，也可能发送到 E10 业票通或 OCR/查验服务。
+- 用户未明确确认前，不要运行上传、OCR、解析、导入或复用已上传文件对象的命令。
+
+## 写操作失败处理：`partial/write_uncertain` 决策树
+
+当导入 / 新增 / 编辑 / 删除等写操作返回 `partial/write_uncertain`，或提示网络中断、部分成功、回查失败、回查字段不一致时，按下面规则处理：
+
+1. **先停止盲目重试**，不要连续重复提交相同 `.apply`
+2. 优先从以下角度解释：
+   - 写请求可能已经到达服务端，但连接在结果确认前中断
+   - 服务端可能只处理了部分发票
+   - 写接口已返回成功，但详情回查失败或与预期不一致
+   - continuation、目标文件、目标发票或登录上下文可能已经变化
+3. 如需确认，只补 **一次** 只读查询（例如 `invoice.get` 或列表查询），不要陷入 query/write 循环
+4. 最终给用户明确结论、已知 `workflow.state`、成功/失败项和下一步人工确认建议，而不是继续无意义重试
+
+**特别注意：** 对导入、删除和编辑场景更要严格执行上述规则；这些场景最容易因重复提交造成重复入账、误删或覆盖用户刚修改的数据。
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli invoice schema
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
+weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"12345"}'
+weaver-work-cli --json invoice run invoice.ocr.preview --input-json '{"file":"./invoice.pdf"}'
+weaver-work-cli --json invoice run invoice.import.prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true}'
+weaver-work-cli --json invoice run invoice.import.apply --input-json '{"file":"./invoice.pdf","continuation":"PREPARE_CONTINUATION","confirm":true}'
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid":"12345"}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20}'
+weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"7","externalDocumentNo":"AI-EXAMPLE-001","purchaserName":"示例个人","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6}]}}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli invoice schema
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
+weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"12345"}'
+weaver-work-cli --json invoice run invoice.ocr.preview --input-json '{"file":"./invoice.pdf"}'
+weaver-work-cli --json invoice run invoice.import.prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true}'
+weaver-work-cli --json invoice run invoice.import.apply --input-json '{"file":"./invoice.pdf","continuation":"PREPARE_CONTINUATION","confirm":true}'
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid":"12345"}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20}'
+weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"7","externalDocumentNo":"AI-EXAMPLE-001","purchaserName":"示例个人","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6}]}}'
+```
+## 不在本 skill 范围
+
+- 禁止加载原始 `weaver-e10-yepiaotong` Skill 代替 CLI。
+- 已有 CLI 封装的能力（list/get/upload/OCR/import/add/update/delete/issuing/reim）禁止 curl、fetch、浏览器自动化或直接访问 E10 `/api/inc/*`，必须通过 CLI。
+- **红冲能力**可以直接调用 E10 API（`getToken`、`queryAvailableBlueInfo`、`redConfirmationApply`、`redConfirmationConfirm`、`queryRedConfirmationList`、`queryRedConfirmationDetail`），因为 CLI 尚未封装红冲 operation。调用时使用发票 Token（非 CLI 内部 Token）。
+- 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
+- 禁止读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
+- 共享、转让和标签当前未纳入 CLI manifest；新版源资料已给出提交接口，但仍需要补稳定接收人/标签 ID 来源、写后回查和测试后再开放。
+- 非发票类 E10 能力、通用流程编排、非业票通表单/审批/组织等业务不由本 Skill 承载。

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-add.md

@@ -2,7 +2,7 @@
 
 ## 什么时候读取
 
-用户要手工录入一张发票，且已经提供或可以整理出完整 `info` 对象时读取本文件。开始前也读取共享高风险协议：`../../weaver-work-cli-shared/references/high-risk-write.md`。
+用户要手工录入一张发票，且已经提供或可以整理出完整 `info` 对象时读取本文件。开始前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
 
 ## Operation
 

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-agent-entry.md

@@ -6,35 +6,42 @@
 
 ## 准备命令
 
-```bash
+```text
 weaver-work-cli --version
 weaver-work-cli doctor --e10
 weaver-work-cli invoice schema
 ```
 
-如未登录，按共享规则读取 `../../weaver-work-cli-shared/references/e10-auth-and-session.md` 后处理。
+如未登录，按共享规则读取 `../../weaver-e10-shared/references/e10-auth-and-session.md` 后处理。
 
 ## 固定入口
 
 Agent 优先调用统一 operation 入口：
 
-```bash
-weaver-work-cli --json invoice run <operation> --input -
+```text
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
+```
+
+简单 JSON 通过 `--input-json` 传入，复杂或多行 JSON 使用 UTF-8 文件和 `--input <path>`；只有确认当前 shell 能稳定传管道时才使用 `--input -`。按环境选择示例：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
 ```
 
-JSON 通过 stdin 传入，避免 shell 转义和路径注入问题：
+macOS/Linux（bash/zsh）：
 
 ```bash
-printf '%s\n' '{"page_size":10,"start_pos":0}' \
-  | weaver-work-cli --json invoice run invoice.list --input -
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
 ```
 
 `weaver-work-cli invoice schema` 是可用 operation、输入字段、固定参数和风险等级的第一信息源。不要用未出现在 schema 中的 operation，也不要把原始 `weaver-e10-yepiaotong` reference 当作可直接调用的 CLI 合约。
 
 ## 输出处理
 
-成功结果在 stdout，失败结果在 stderr。判断规则读取共享 reference：`../../weaver-work-cli-shared/references/json-output-contract.md`。
+成功结果在 stdout，失败结果在 stderr。判断规则读取共享 reference：`../../weaver-e10-shared/references/json-output-contract.md`。
 
 列表、详情、OCR 或回查结果可能很长时，不要把 stdout 的完整 envelope 直接展示给用户。默认 `page_size=10` 小页读取；只渲染发票识别和决策所需字段，例如 `fid`、代码/号码、购销方、金额、日期、查验/报销状态、附件数量/文件名。需要更多结果时按 `start_pos` 分页继续；需要保留完整原始 JSON 时落本地文件并返回路径。
 
-高风险写入读取共享 reference：`../../weaver-work-cli-shared/references/high-risk-write.md`。
+高风险写入读取共享 reference：`../../weaver-e10-shared/references/high-risk-write.md`。

package/skills/weaver-e10-yepiaotong/references/invoice-browse-field-data.md

@@ -0,0 +1,204 @@
+# 发票浏览按钮字段数据
+
+## 什么时候读取
+
+用户要把业票通发票填入 E10 流程表单的发票浏览按钮控件，或要求"生成发票字段结构化数据""流程填单发票对象数据"时读取本文件。
+
+## Operation
+
+| Operation | 风险 | 输入 |
+| --- | --- | --- |
+| `invoice.browse-field.data` | read | `fid`、`fids` 或已取得的 `detail` 响应三选一 |
+
+## 业务用途
+
+E10 流程填单时，发票字段使用浏览按钮控件，填值必须传入包含完整票面信息的 JSON 对象，不能传简单文本。CLI 根据 `fid` 自动完成详情查询和 JSON 转换。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid":"12345"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid":"12345"}'
+```
+
+多张发票：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["12345","67890"]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fids":["12345","67890"]}'
+```
+
+## 目标 JSON 结构
+
+下表定义每个发票对象的字段。`D` 代指发票详情响应中的 `infos[].info`。
+
+| 键 | 类型 | 来源 | 说明 |
+|---|---|---|---|
+| `optionId` / `id` / `fid` | string | `D.fid` | 三者取相同值，发票唯一标识。 |
+| `type` | integer | `D.comm_info.pro.type` | 票种编码。 |
+| `typeName` | string | `D.comm_info.pro.cname`；缺失时按 `type` 查[票种名称表](#票种编码与名称) | 票种中文名称。 |
+| `number` | string | `D.number` | 发票号码。 |
+| `code` | string | `D.code` | 发票代码；无代码票种取空串。 |
+| `content` / `name` | string | `"{typeName}-{number}"` 拼接 | 显示用摘要，两者取相同值。 |
+| `total` | string | `D.comm_info.price.total` | 价税合计，单位元。 |
+| `ttax` | string | `D.ext` → `ttax` | 票面税额。 |
+| `seller` | string | `D.comm_info.payer.company` | 销售方名称。 |
+| `sellerId` | string | `D.comm_info.payer.tcode` | 销售方税号。 |
+| `buyer` | string | `D.comm_info.buyer.company` | 购买方名称。 |
+| `buyerId` | string | `D.comm_info.buyer.tcode` | 购买方税号。 |
+| `incDate` | string | `D.comm_info.pro.date` | 开票日期 `yyyy-MM-dd`。 |
+| `incDateTimestamp` | integer | `incDate` 转 UTC+8 零时毫秒时间戳 | 空时取 `0`。 |
+| `validStatus` | string | `D.comm_info.pro.valid` 查[查验状态表](#查验状态) | 查验状态文本。 |
+| `source` | string | `D.modify_info.source` 查[录入来源表](#录入来源) | 录入来源文本。 |
+| `invoiceStatus` | integer | `D.comm_info.pro.status` | 发票状态；`0` 正常。 |
+| `del` | integer | `D.modify_info.del` | 删除状态；`0` 正常。 |
+| `currency` / `currencyName` | string | `D.currency` / `D.currencyName` | 默认 `"CNY"` / `"人民币"`。 |
+| `taxRate` | string | `D.ext` → `taxRate` 或 `products[0].taxRate` | 税率，如 `"13.000"`。 |
+| `consumeContent` | string | `D.ext` → `products` 各项 `productName` 拼接 | 消费内容。 |
+| `fylx` | string | `D.fylx` | 费用类型 ID；缺失取 `"0"`。 |
+| `inputDate` | string | `D.modify_info.createDate` | 录入日期 `yyyy-MM-dd HH:mm:ss`。 |
+| `incTotal` | integer | 固定 `0` | 预留字段。 |
+| `reimingMoney` | string | `D.comm_info.price.reimingMoney` | 报销中金额；缺失取空串。 |
+| `reimedMoney` | string | `D.comm_info.price.reimedMoney` | 已报销金额；缺失取空串。 |
+| `notReimMoney` | string | `total - reimedMoney - reimingMoney` | 无报销数据时等于 `total`。 |
+| `reimDate` | string | 报销日期 | 缺失取空串。 |
+| `reimProcess` | string | 报销流程 ID | 缺失取空串。 |
+
+缺失字段统一按类型填充：字符串用空串 `""`，数值用 `0`。
+
+## 枚举映射表
+
+### 票种编码与名称
+
+优先使用详情响应中的 `cname`。仅当 `cname` 缺失时按以下表查找。
+
+| `type` | `typeName` |
+|---:|---|
+| 1 | 增值税专用发票 |
+| 2 | 增值税普通发票 |
+| 3 | 增值税电子普通发票 |
+| 4 | 卷式发票 |
+| 5 | 通行费增值税电子普通发票 |
+| 6 | 机动车销售统一发票 |
+| 7 | 定额发票 |
+| 8 | 客运汽车票 |
+| 9 | 航空运输电子客票行程单 |
+| 10 | 火车票 |
+| 11 | 出租车票 |
+| 12 | 其他 |
+| 13 | 汽车通行费发票 |
+| 14 | 船票 |
+| 22 | 二手车销售统一发票 |
+| 28 | 增值税电子专用发票 |
+| 32 | 电子发票（增值税专用发票） |
+| 33 | 电子发票（普通发票） |
+| 47 | 医疗收费票据 |
+| 48 | 财政非税收入统一票据 |
+| 49 | 海关进口增值税专用缴款书 |
+| 50 | 电子发票服务平台纸质普票 |
+| 52 | 完税凭证 |
+| 53 | 国际小票 |
+| 54 | 银行回单 |
+| 56 | 代扣代缴税收缴款凭证 |
+
+未匹配的 `type` 使用 `"未知票种"`。
+
+### 查验状态
+
+| `valid` | `validStatus` |
+|---:|---|
+| 0 | 未查验 |
+| 1 | 有效已查验 |
+| 2 | 有效未查验 |
+| 3 | 查验失败 |
+| 4 | 发票无效 |
+| 5 | 票面校验不一致 |
+
+### 录入来源
+
+| `source` | 文本 |
+|---:|---|
+| 1 | 微信 |
+| 2 | 支付宝 |
+| 4 | 邮箱 |
+| 5 | 拍照 |
+| 6 | 扫码 |
+| 7 | 手动 |
+| 9 | 查验录入 |
+| 10 | 企业微信 |
+| 11 | 公众号 |
+| 12 | 企业台账 |
+| 13 | 文件 |
+| 14 | Excel |
+| 15 | 短信 |
+| 16 | 链接录入 |
+
+未匹配的 `source` 使用空串。
+
+## 输出示例
+
+```json
+{
+  "optionId": "1307869223054704650",
+  "id": "1307869223054704650",
+  "fid": "1307869223054704650",
+  "type": 32,
+  "typeName": "电子发票（增值税专用发票）",
+  "number": "26932000001429154341",
+  "code": "",
+  "content": "电子发票（增值税专用发票）-26932000001429154341",
+  "name": "电子发票（增值税专用发票）-26932000001429154341",
+  "total": "368269.14",
+  "ttax": "42367.25",
+  "seller": "宁波市北仑亮峰精密机械制造有限公司",
+  "sellerId": "91330206744967935K",
+  "buyer": "宁波海伯集团有限公司",
+  "buyerId": "913302041443146316",
+  "incDate": "2026-08-25",
+  "incDateTimestamp": 1787587200000,
+  "validStatus": "有效已查验",
+  "source": "邮箱",
+  "invoiceStatus": 0,
+  "del": 0,
+  "currency": "CNY",
+  "currencyName": "人民币",
+  "taxRate": "13.000",
+  "consumeContent": "*金属制品*主齿轮",
+  "fylx": "0",
+  "inputDate": "2026-08-26 10:40:33",
+  "incTotal": 0,
+  "reimingMoney": "",
+  "reimedMoney": "",
+  "notReimMoney": "368269.14",
+  "reimDate": "",
+  "reimProcess": ""
+}
+```
+
+## 输出处理
+
+成功时 `data.items` 是浏览按钮可用对象数组。如果批量详情中有部分发票失败，operation 返回 `meta.status="PARTIAL"`，成功项仍在 `data.items`，失败项在 `data.errors`。Agent 回复用户时只展示成功数量、失败数量和关键发票字段；不要粘贴完整大 JSON。
+
+## 边界与错误处理
+
+- 详情查询固定 `mask=0`、`userFlag=1`、`isDelFlag=1`。
+- `ext` 为 JSON 字符串，解析失败时 `ttax`、`taxRate`、`consumeContent` 取空串，不中断记录生成。
+- 批量 fid 中部分查询失败时，成功项正常输出，失败项出现在 `errors` 数组中。
+
+## 注意
+
+该 operation 由 CLI 封装，Agent 只需调用 `invoice.browse-field.data` 或 `invoice.get`，不能直接 `curl` E10 接口，也不需要运行旧源码里的 Python 脚本。

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-delete.md

@@ -2,7 +2,7 @@
 
 ## 什么时候读取
 
-用户要删除已有发票时读取本文件。开始前也读取共享高风险协议：`../../weaver-work-cli-shared/references/high-risk-write.md`。
+用户要删除已有发票时读取本文件。开始前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
 
 ## Operation
 

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-detail.md

@@ -12,17 +12,25 @@
 
 ## 示例
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"12345"}'
+
+weaver-work-cli --json invoice run invoice.get --input-json '{"number":"00188205"}'
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
-printf '%s\n' '{"fid":"12345"}' \
-  | weaver-work-cli --json invoice run invoice.get --input -
+weaver-work-cli --json invoice run invoice.get --input-json '{"fid":"12345"}'
 
-printf '%s\n' '{"number":"00188205"}' \
-  | weaver-work-cli --json invoice run invoice.get --input -
+weaver-work-cli --json invoice run invoice.get --input-json '{"number":"00188205"}'
 ```
 
 ## 返回
 
-`invoice.get` 返回服务端详情响应本身。常见字段包括 `infos[].info.fid`、`code`、`number`、`comm_info.pro`、`comm_info.price`、`comm_info.buyer`、`comm_info.payer`、`flist` 和 `modify_info`。
+`invoice.get` 返回服务端详情响应本身。常见字段包括 `infos[].info.fid`、`code`、`number`、`comm_info.pro`、`comm_info.price`、`comm_info.buyer`、`comm_info.payer`、`flist` 和 `modify_info`。交通类发票还可从 `infos[].info.from` / `infos[].info.to`（或 `ext.passengersService`）取出发地和目的地。
 
 ## 注意
 

package/skills/weaver-e10-yepiaotong/references/invoice-disabled-capabilities.md

@@ -0,0 +1,28 @@
+# 暂不暴露的能力
+
+## 什么时候读取
+
+用户要求共享发票、转让发票、打标签、移除标签，或要求调用 `weaver-work-cli invoice schema` 中不存在的业票通接口时读取本文件。
+
+## 当前不暴露
+
+以下新版源资料中已有接口路径和请求体，但当前没有纳入 `weaver-work-cli invoice` manifest，Agent 不能绕过 CLI 直接调用：
+
+- 共享发票：`POST /api/inc/shareUsers`
+- 转让发票：`POST /api/inc/transferFpyUser`
+- 标记发票：`POST /api/my/tag/common/batchAddEntityTag`
+- 移除、替换或覆盖标签
+
+## 原因
+
+这些能力缺少稳定的 Agent 合约：
+
+- 共享和转让需要接收人的稳定 `appid/cid/uid` 解析来源，当前 invoice CLI 还没有组织/人员查询 operation
+- 共享需要共享关系或接收人可见性回查契约，不能只凭 HTTP 200 宣称成功
+- 转让会改变发票持有人，缺少接收人侧归属回查契约；当前登录人可能在成功后失去可见性，不能据此单独证明新归属
+- 标签缺少标签定义查询、当前标签关系查询和移除/替换语义
+- 写操作后的读回验证边界不完整
+
+## Agent 行为
+
+遇到这类请求时，明确说明当前 CLI 未暴露该 operation，不能通过 `curl`、`fetch`、浏览器自动化或原始 E10 `/api/inc/*` 绕过。可以建议先补对应的人员/标签查询能力、`prepare -> apply`、写后回查和测试，再开放给 Agent。

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-download.md

@@ -12,9 +12,16 @@
 
 ## 示例
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.download --input-json '{"fid":"12345","fileId":"67890","output":"./invoice-12345.pdf"}'
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
-printf '%s\n' '{"fid":"12345","fileId":"67890","output":"./invoice-12345.pdf"}' \
-  | weaver-work-cli --json invoice run invoice.download --input -
+weaver-work-cli --json invoice run invoice.download --input-json '{"fid":"12345","fileId":"67890","output":"./invoice-12345.pdf"}'
 ```
 
 ## 注意

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-enterprise-list.md

@@ -20,12 +20,20 @@
 
 ## 示例
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.enterprise.list --input-json '{"page_size":10,"start_pos":0,"buyer_company":"泛微"}'
+
+weaver-work-cli --json invoice run invoice.enterprise.list --input-json '{"page_size":10,"start_pos":0,"sreim":"2"}'
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
-printf '%s\n' '{"page_size":10,"start_pos":0,"buyer_company":"泛微"}' \
-  | weaver-work-cli --json invoice run invoice.enterprise.list --input -
+weaver-work-cli --json invoice run invoice.enterprise.list --input-json '{"page_size":10,"start_pos":0,"buyer_company":"泛微"}'
 
-printf '%s\n' '{"page_size":10,"start_pos":0,"sreim":"2"}' \
-  | weaver-work-cli --json invoice run invoice.enterprise.list --input -
+weaver-work-cli --json invoice run invoice.enterprise.list --input-json '{"page_size":10,"start_pos":0,"sreim":"2"}'
 ```
 
 ## 返回

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-file-upload.md

@@ -18,9 +18,16 @@
 
 ## 示例
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.upload --input-json '{"file":"./invoice.pdf"}'
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
-printf '%s\n' '{"file":"./invoice.pdf"}' \
-  | weaver-work-cli --json invoice run invoice.upload --input -
+weaver-work-cli --json invoice run invoice.upload --input-json '{"file":"./invoice.pdf"}'
 ```
 
 ## 返回

package/skills/{weaver-work-cli-invoice → weaver-e10-yepiaotong}/references/invoice-import.md

@@ -2,7 +2,7 @@
 
 ## 什么时候读取
 
-用户要把本地发票文件导入票夹时读取本文件。开始前也读取共享高风险协议：`../../weaver-work-cli-shared/references/high-risk-write.md`。
+用户要把本地发票文件导入票夹时读取本文件。开始前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
 
 ## Operation
 
@@ -14,15 +14,24 @@
 
 ## 示例
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.ocr.preview --input-json '{"file":"./invoice.pdf"}'
+
+weaver-work-cli --json invoice run invoice.import.prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true}'
+
+weaver-work-cli --json invoice run invoice.import.apply --input-json '{"file":"./invoice.pdf","continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
-printf '%s\n' '{"file":"./invoice.pdf"}' \
-  | weaver-work-cli --json invoice run invoice.ocr.preview --input -
+weaver-work-cli --json invoice run invoice.ocr.preview --input-json '{"file":"./invoice.pdf"}'
 
-printf '%s\n' '{"file":"./invoice.pdf","validate":true,"syncToOa":true}' \
-  | weaver-work-cli --json invoice run invoice.import.prepare --input -
+weaver-work-cli --json invoice run invoice.import.prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true}'
 
-printf '%s\n' '{"file":"./invoice.pdf","continuation":"<prepare返回值>","confirm":true}' \
-  | weaver-work-cli --json invoice run invoice.import.apply --input -
+weaver-work-cli --json invoice run invoice.import.apply --input-json '{"file":"./invoice.pdf","continuation":"PREPARE_CONTINUATION","confirm":true}'
 ```
 
 ## 注意