weaver-work-cli 0.1.5 → 0.1.7

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

@@ -0,0 +1,117 @@
+# 单条流程共享（workflow.sharePrepare / workflow.shareApply）
+
+## 什么时候读取
+
+用户要把**单条**流程共享给人员 / 部门 / 分部 / 群组 / 角色 / 岗位 / 所有人（"把这条流程共享给 X / 让 X 也能看这条流程"）时读取本文件。批量共享见 `workflow-batch.md`。
+
+## Operation
+
+| Operation | 风险 | 固定规则 |
+| --- | --- | --- |
+| `workflow.sharePrepare` | read-before-write | 解析共享对象名称转 ID、取安全级别默认值，不写入；产出 continuation |
+| `workflow.shareApply` | high-risk-write | 提交流程共享（addRequestShare2）；必须 `confirm: true` + continuation |
+
+## 确认链
+
+1. `sharePrepare` → 向用户摘要目标 `requestId` / 共享对象解析结果 / 安全级别范围 / 风险。
+2. 等用户**明确确认**。
+3. `shareApply` 带 `confirm: true` 与 `continuation`（**无需重复传 shareObjects / 安全级别，continuation 已携带**）。
+4. 返回 `partial/write_uncertain` 时**立即停止**，先只读回查，**不自动重放**。
+
+## 输入
+
+- `requestId`（数字或仅数字字符串）或 `group` + `index` 定位流程；`requestId` 必须来自查询索引，模型不能自己编。
+- `shareObjects`：共享对象 JSON 数组字符串，每项 `{"type": <类型>, "name": <名称>}`；`all` 不需要 `name`。
+- `minSeclevel`：最小安全级别（与默认值取大），仅用户明确要求限制时传。
+- `maxSeclevel`：最大安全级别（与默认值取小），仅用户明确要求限制时传。
+- `continuation`（仅 Apply）：Prepare 返回的短句柄（形如 `wc-1a2b3c4d5e6f7a8b`），载荷由 CLI 托管在本机状态目录；原样回传，禁止解析、手工构造 / 修改 / 复用。
+- `confirm`（仅 Apply）：固定为 `true`。
+
+## 共享对象类型
+
+| type | 共享对象 | name 说明 |
+| --- | --- | --- |
+| `user` | 人员 | 必填，姓名自动转 ID |
+| `dept` | 部门 | 必填，部门名自动转 ID |
+| `subcompany` | 分部 | 必填，分部名自动转 ID |
+| `group` | 群组 | 必填，群组名自动转 ID |
+| `role` | 角色 | 必填，角色名自动转 ID |
+| `position` | 岗位 | 必填，岗位名自动转 ID |
+| `all` | 所有人 | 不需要 name，直接 `{"type":"all"}` |
+
+名称自动转 ID；`name` 也支持 `"名称(ID)"`（如 `"张三(1001)"`）：此时**直接采用括号里的 ID、不再搜名称**，多命中澄清后按该形式回传即可。多命中返回候选列表让用户确认，禁止静默全选（不允许把同名多人全部设为共享对象）；0 命中报错提示核对名称。
+
+## 示例
+
+### 共享给一个人 + 一个部门 + 所有人
+
+Windows PowerShell：
+
+```powershell
+Set-Content -Encoding utf8 -LiteralPath .\share.json -Value @'
+{
+  "requestId": "1307945196792242242",
+  "shareObjects": ["{\"type\":\"user\",\"name\":\"张三\"}","{\"type\":\"dept\",\"name\":\"产品研发中心\"}","{\"type\":\"all\"}"]
+}
+'@
+weaver-work-cli --json workflow run workflow.sharePrepare --input .\share.json
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+cat > ./share.json <<'JSON'
+{
+  "requestId": "1307945196792242242",
+  "shareObjects": ["{\"type\":\"user\",\"name\":\"张三\"}","{\"type\":\"dept\",\"name\":\"产品研发中心\"}","{\"type\":\"all\"}"]
+}
+JSON
+weaver-work-cli --json workflow run workflow.sharePrepare --input ./share.json
+```
+
+确认后提交：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.shareApply --input-json '{"confirm":true,"continuation":"<sharePrepare 返回的句柄，形如 wc-1a2b3c4d5e6f7a8b>"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.shareApply --input-json '{"confirm":true,"continuation":"<sharePrepare 返回的句柄，形如 wc-1a2b3c4d5e6f7a8b>"}'
+```
+
+### 按列表序号定位 + 限制安全级别范围
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.sharePrepare --input-json '{"index":3,"shareObjects":["{\"type\":\"user\",\"name\":\"张三\"}"],"minSeclevel":"1","maxSeclevel":"3"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.sharePrepare --input-json '{"index":3,"shareObjects":["{\"type\":\"user\",\"name\":\"张三\"}"],"minSeclevel":"1","maxSeclevel":"3"}'
+```
+
+## 返回
+
+- `sharePrepare` 返回共享对象解析结果、安全级别默认值与 `continuation`；不写入。
+- `shareApply` 透传 addRequestShare2 响应：`{code, status, msg, fail, data: [{sourceId, result, msg}, ...]}`（单条 data 数组 1 个元素，`result=true/false` 表示是否共享成功，`msg` 含原因）；或返回 `partial/write_uncertain`。
+- 按退出码 / `error.type` / `error.subtype` / `error.message` 判断成败，不盲目重试。
+
+## 注意
+
+- 这不是 `workflow.operatePrepare` 的参数（operate 无共享动作）。
+- `requestId` 必须来自查询索引；`shareObjects` 名称多命中必须澄清，禁止静默全选。
+- `continuation` 是 CLI 托管的短句柄（形如 `wc-1a2b3c4d5e6f7a8b`），Agent 只原样回传，禁止解析、手工构造 / 修改 / 复用；`confirm` 必须且只能为 `true`。
+- Apply 被重复执行、且上一次已经成功时，返回 `ok:true` + `data.status = "ALREADY_APPLIED"`（含 `previousResult`；若上一次是"服务端已成功回执、只是没来得及写回结果"，还会给出 `requestId`）——**这不是失败**，本次没有重复写入，按上一次结果汇报即可，不要重跑 Prepare。
+- Apply 报 `validation/continuation_busy` 时，说明句柄正被另一次执行占用、**上一次还没发出任何写入**：**稍后原样重试同一条命令**即可，不必重跑 Prepare、也不要换句柄。
+- Apply 报 `validation/continuation_consumed` 时，说明占用该句柄的那次执行停在无法判定的旧状态：先只读核对目标流程是否已生效，确认没生效才重跑 Prepare。
+- 安全级别范围仅在用户明确要求限制时传 `minSeclevel` / `maxSeclevel`。
+- 写操作遇登录失效 / 超时 / 断连返回 `partial/write_uncertain`，**禁止自动重放**，先只读回查确认状态，不得重复提交。
+- 同一操作连续 2 次失败必须停止。
+- 不写任何凭据（Cookie / ETEAMSID / Token / 操作员标识由 CLI 托管）。

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

@@ -0,0 +1,189 @@
+# 流程查看（detail / summary / open / requestLog / pageOpen）
+
+## 什么时候读取
+
+用户要查看某条流程的完整详情、生成业务摘要、打开流程，或查看签字意见/流转日志，或打开常用/动态 OA 页面时读取本文件。
+
+## Operation
+
+| Operation | 固定规则 |
+| --- | --- |
+| `workflow.detail` | 优先用 `requestId`；列表序号定位用 `index`（分组场景加 `group`）。固定以"用户主动查看"语义调用（标记已读）。只读，无需 confirm。 |
+| `workflow.summary` | 优先用 `requestId`；生成业务摘要上下文，**不标记已读**。`summaryFields` 默认 12。只读，无需 confirm。 |
+| `workflow.open` | 优先用 `requestId`；生成打开动作（URL + clientAction）。`openMode` 默认 `auto`、`noOpen` 默认 false。只读，无需 confirm。 |
+| `workflow.requestLog` | **必带 `requestId`**；按页查询签字意见/流转日志。`current` 默认 1、`pageSize` 默认 10（最大 50）。只读，无需 confirm。 |
+| `workflow.pageOpen` | **必带 `page`**；动态页 `create` 配 `workflowId`、`view` 配 `requestId`。`openMode` 默认 `auto`、`noOpen` 默认 false。只读，无需 confirm。 |
+
+## 输入 —— 定位方式（requestId 与 index 二选一）
+
+- `requestId`：流程请求 ID（整数或纯数字字符串）。用户已给出 ID 时直接用，不要先查列表再过滤。
+- `index`：基于当前会话最近一次查询结果的序号（从 1 开始）。
+- `group`：分组标识（`urgent`/`overdue`/`batch`/`pending`），**仅分组场景必填**——低版本模式（OA < `10.0.9909.01`）通用待办分组展示时每个分组序号独立从 1 开始，必须同时传 `group` + `index`。
+- 只传 `index` 不传 `group` 会定位到其他分组的同序号流程。
+
+**智能分组模式（OA ≥ `10.0.9909.01`）查询不产生分组，定位时只传 `index`，不传 `group`。**
+
+## 输入 —— 各 operation 字段
+
+| Operation | 关键字段 | 说明 |
+| --- | --- | --- |
+| `workflow.detail` | `requestId` / `index` / `group` | `requestLogCurrent`（签字意见当前页，默认 1）、`requestLogPageSize`（每页条数，默认 10，最大 50） |
+| `workflow.summary` | `requestId` / `index` / `group` | `summaryFields`（摘要关注字段数，默认 12） |
+| `workflow.open` | `requestId` / `index` / `group` | `openMode`（`auto`/`localBrowser`/`clientAction`/`url`，默认 `auto`）、`noOpen`（默认 false） |
+| `workflow.requestLog` | `requestId`（必填） | `current`（默认 1）、`pageSize`（默认 10，最大 50） |
+| `workflow.pageOpen` | `page`（必填） | `workflowId`（create 页）、`requestId`（view 页）、`openMode`、`noOpen` |
+
+### pageOpen 页面 key（page）
+
+| key | 页面 | 额外必填 |
+| --- | --- | --- |
+| `center` | 流程首页 | — |
+| `todo` | 待办列表 | — |
+| `done` | 已办列表 | — |
+| `mine` | 我发起的 | — |
+| `share` | 共享 | — |
+| `attention` | 关注 | — |
+| `draft` | 草稿 | — |
+| `subordinates` | 下属待办 | — |
+| `all` | 全部 | — |
+| `newflow` | 提交申请/可发起流程页 | — |
+| `monitor` | 流程监控 | — |
+| `create` | 发起流程 | `workflowId` |
+| `view` | 流程详情 | `requestId` |
+
+> `pageOpen` 的地址由 CLI 按内置地址表生成，**不要自行拼接 OA URL**（不要手动拼 baseUrl + 路径）——只传 `page`，动态页再配 `workflowId`/`requestId`。
+
+## 详情输出规则（按用户问法选择）
+
+**A. 用户要看完整详情**（"打开这条／看完整详情／详情是啥"）→ 直接原样输出 `renderMarkdown` 全部三部分（基础信息 + 表单内容 + 签字意见）。不要输出 HTML 面板、不要输出 Markdown 表格、不要拆多个卡片。字段值必须原样展示，长文本保留换行，链接字段用超链接渲染。
+
+**B. 用户对流程具体内容提问**（"审批人发表了什么意见／某字段是什么／为什么退回了／流程走到哪了"）→ **不要原样输出完整详情**（三段堆出来对内容提问是噪音）。从 `renderMarkdown` / 返回数据里提取用户问的相关部分，用一段话直接回答；只引用相关的签字意见段、字段值或基础信息片段。后续用户明确要"看完整详情／打开流程"才输出完整 `renderMarkdown`。
+
+签字意见每条三行（不论 A/B 场景，提取签字意见时按此格式组织）：
+
+1. 操作人、操作方式、操作时间。
+2. 接收人员。
+3. 签字意见。
+
+详情规则补充：
+
+- 标题用流程请求标题，不单独展示"流程名称"字段；`workflowName` 只能叫"工作流名称"，默认不展示。
+- 第一条分隔线只能在基础信息区之后；标题下方不要加横线。
+- 表单字段值必须原样展示，不能摘要、改写、删减字段值中自带的"需求概述："等文字。
+- 字段有 `valueHtml`/`links` 时优先渲染为超链接；长文本字段全宽展示，保留原文换行。
+- 只有签字意见 `hasMore=true` 才显示下一页提示。
+- 详情面板后不要输出固定建议列表或"如果想进一步操作"类尾巴。
+
+## 摘要规则
+
+模型基于返回的摘要上下文提炼业务摘要，**不默认展示完整详情**。摘要先一句话概括业务事项，再列 4–7 条要点；不要体现发起人/申请人姓名，不要只复述标题，不要编造。流程状态和当前节点只在用户明确询问或确实影响业务判断时补充。
+
+## 示例
+
+### 按 requestId 查看详情
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.detail --input-json '{"requestId":"1307945196792242242"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.detail --input-json '{"requestId":"1307945196792242242"}'
+```
+
+### 分组场景按序号查看（待处理组第 3 条，低版本模式）
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.detail --input-json '{"group":"pending","index":3}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.detail --input-json '{"group":"pending","index":3}'
+```
+
+### 生成业务摘要
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.summary --input-json '{"requestId":"1307945196792242242"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.summary --input-json '{"requestId":"1307945196792242242"}'
+```
+
+### 打开流程
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.open --input-json '{"requestId":"1307945196792242242"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.open --input-json '{"requestId":"1307945196792242242"}'
+```
+
+### 查询签字意见（第 2 页）
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.requestLog --input-json '{"requestId":"1307945196792242242","current":2}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.requestLog --input-json '{"requestId":"1307945196792242242","current":2}'
+```
+
+### 打开常用 OA 页面
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json workflow run workflow.pageOpen --input-json '{"page":"todo"}'
+weaver-work-cli --json workflow run workflow.pageOpen --input-json '{"page":"create","workflowId":"100003460000000060"}'
+weaver-work-cli --json workflow run workflow.pageOpen --input-json '{"page":"view","requestId":"1307945196792242242"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json workflow run workflow.pageOpen --input-json '{"page":"todo"}'
+weaver-work-cli --json workflow run workflow.pageOpen --input-json '{"page":"create","workflowId":"100003460000000060"}'
+weaver-work-cli --json workflow run workflow.pageOpen --input-json '{"page":"view","requestId":"1307945196792242242"}'
+```
+
+## 返回
+
+| Operation | 关键返回字段 | 渲染说明 |
+| --- | --- | --- |
+| `workflow.detail` | `renderMarkdown`（基础信息 + 表单内容 + 签字意见） | 直接原样输出，不改成 HTML/表格/多卡片；字段值原样展示，长文本保留换行，链接字段渲染为超链接 |
+| `workflow.summary` | 业务摘要上下文 | 一句话概括业务事项 + 4–7 条要点；默认不体现发起人姓名 |
+| `workflow.open` | `opened`、`requiresHostAction`、URL/clientAction | 仅 `opened=true` 才说已打开；`requiresHostAction=true` 时说明已生成宿主打开动作，等待客户端执行 |
+| `workflow.requestLog` | 签字意见数组（操作人/方式/时间、接收人、签字意见）、`hasMore` | 每条三行组织；仅 `hasMore=true` 才提示下一页 |
+| `workflow.pageOpen` | `opened`、`requiresHostAction`、URL | 同 `open`；动态页按 `page` 生成对应地址 |
+
+## 注意
+
+- **禁止事项**：不要把详情/摘要/打开结果改写、压缩或重排成自己的话；`renderMarkdown`/`finalMarkdown` 必须一字不改原样呈现。详情面板后不要加固定建议尾巴。
+- **摘要不标记已读**：`workflow.summary` 不改变流程未读状态；`workflow.detail` 会标记已读（用户主动查看语义），按需选择。
+- **定位纪律**：用户已给 `requestId` 时不要先查列表再过滤；分组场景必须 `group` + `index` 同时传；智能分组模式只传 `index`。
+- **大结果**：详情签字意见按 `requestLogPageSize` 分页，仅 `hasMore=true` 提示下一页；需要原始 JSON 时落本地文件返回路径。
+- **失败/停止**：CLI 失败时在 **stderr** 返回 `ok:false` + `error.type`/`error.subtype`/`error.message`/`error.retryable`（**没有** `success`/`stopReason`/`userMessage` 字段）——`retryable=true` 时最多重试一次，否则原样转述 `error.message` 并停止，不重试、不换接口。入参类错误（如 `locate_required`）按 `error.message` 补齐参数后重试一次。
+- **未登录/登录失效**：按 `weaver-e10-shared` 的 `references/e10-auth-and-session.md` 引导用户登录，登录后重放原请求（读操作可重放）。
+- **凭据禁止**：业务输入里禁止传入 Cookie、ETEAMSID、Token、`header.operator`，这些由 CLI 托管。

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 确认链处理导入、新增、编辑、删除、报销单创建/更新、智能开票/存台账；红字发票红冲申请/查询/确认。"
-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
+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."
+version: 1.0.1
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -13,12 +13,23 @@ requires:
 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`，安装或读取失败时必须停止执行。**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出、超时与重试预算、非交互环境处置和高风险写入规则。若共享规则不存在、CLI 未安装或读取失败，必须先提示用户先补齐 `weaver-work-cli` 与共享 skill；Agent 不能自行安装或继续猜测，补齐方式（npm 源安装 / 本地代码安装）与版本检查一律以共享规则为准，必须先取得用户明确确认后再执行。**
+
 认证和登录态只能按共享规则通过 `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/查验服务，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
 
+# 泛微E10业票通发票管理
+
+## 共享包依赖（发布与安装约束）
+
+本包通过相对路径引用共享规则 `../weaver-e10-shared/`（SKILL.md 与 9 处 references 内联路径，合计 10 处）。这些引用**只有在共享包以同名目录 `weaver-e10-shared` 存在时才可解析**。
+
+- 发布共享规则时，必须使用原 installId **覆盖同名共享包**，不要以新技能名上传并与旧包并存；否则本包引用仍指向旧版共享规则，新版超时、降级识别与非交互处置一行都不会被读取。
+- 若确需改用新的共享包目录名，必须同步全量替换本包 10 处跨包引用并做一次回归验证。
+- Agent 发现引用目标不存在或内容明显过期时，停止执行并提示用户补齐/覆盖同名共享包，不要改写相对路径去适配其它目录名。
+
 ## 路由优先级（先判断是不是业票通发票，再选 operation）
 
 业票通发票不是通用 E10 对象。**只要用户的核心对象是业票通发票、个人/企业票夹、发票 OCR、发票查验或发票附件，就优先使用 `weaver-e10-yepiaotong`。**
@@ -32,10 +43,9 @@ cliHelp: "weaver-work-cli invoice --help"
 - 导入发票 / 新增发票 / 编辑发票 / 删除发票
 - 发票报销 / 自动填单 / 事前申请报销 / 报销单创建或更新
 - 开票 / 开专票 / 开普票 / 存台账 / 智能开票
-- 红冲 / 冲红 / 开红票 / 红字发票 / 红字确认单 / 红冲确认
 - `fid` / `fileId` / 发票号码 / 发票代码 / 查验状态 / 报销状态
 
-**判定规则：** 只要最终动作是对业票通发票做查询、查看、上传、OCR、查验预览、下载、导入、新增、编辑、删除、流程表单发票字段、发票报销填单、开票/存台账或红冲，就归 `weaver-e10-yepiaotong`。只有当用户处理的是非发票类 E10 业务、通用工作流或尚未封装的业票通能力时，才不使用本 Skill。
+**判定规则：** 只要最终动作是对业票通发票做查询、查看、上传、OCR、查验预览、下载、导入、新增、编辑、删除、流程表单发票字段、发票报销填单或开票/存台账，就归 `weaver-e10-yepiaotong`。只有当用户处理的是非发票类 E10 业务、通用工作流或尚未封装的业票通能力时，才不使用本 Skill。
 
 ## 选哪个命令
 
@@ -64,22 +74,9 @@ cliHelp: "weaver-work-cli invoice --help"
 | 报销表单字段填充与 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-issuing-examples.md`](references/invoice-issuing-examples.md) |
+| 共享、转让、标签或 schema 未列出的能力 | 无可用命令 | [`invoice-disabled-capabilities.md`](references/invoice-disabled-capabilities.md) |
 
 处理链：
 
@@ -90,10 +87,8 @@ 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.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`
+- 报销填单（完整工作流见 [`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` 组装报销单 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)）-> `invoice.reim.flow.create.prepare` -> 用户确认 -> `invoice.reim.flow.create.apply`。创建成功后修改只能用 `invoice.reim.flow.update.prepare/apply`。
+- 智能开票：Agent 读取 `invoice-issuing.md` 和 `invoice-issuing-field-rules.md`，从用户输入或附件中提取购方、税号、商品明细、金额和税率；资料不足时追问用户补齐，再执行 `invoice.issuing.make.prepare` -> 用户确认开票或存台账 -> `invoice.issuing.make.apply`。当前资料包没有客户档案查询 operation，不要调用 `invoice.customer.*`。
 
 ## 执行原则（减少误路由、误重试和无效消耗）
 
@@ -124,7 +119,12 @@ 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`，按其中流程用宿主提问/弹框让用户输入 E10 登录域名或选择已有 profile，完成登录后再继续原操作。
+- **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试**。
+- 认证失败后**先判定当前环境是否可交互**（能否向用户提问并等待回答、CLI 与浏览器是否同机、外部浏览器能否回调 `127.0.0.1:19800`）：
+  - **不可交互**（容器 / 沙箱 / CI / 无 GUI / 无人值守）：立即终止，不要调用宿主提问或弹框等待用户输入域名或选择 profile，直接读取并按共享规则 [`../weaver-e10-shared/references/non-interactive-environment.md`](../weaver-e10-shared/references/non-interactive-environment.md) 处置，把完整登录命令交给用户在其本地终端执行。
+  - **可交互**：读取共享规则 [`../weaver-e10-shared/references/e10-auth-and-session.md`](../weaver-e10-shared/references/e10-auth-and-session.md)，用宿主提问/弹框让用户输入 E10 登录域名或选择已有 profile，完成登录后再继续原操作。
+- 登录类命令必须带 timeout 限时（上限 300 秒 / 5 分钟，后台运行 + 限时观察）：输出一旦出现 `Open browser login`、`Waiting for E10 authorization callback` 或 `Could not open browser automatically`，即判定已降级到浏览器 OAuth，立即终止该命令并反馈，不得继续等待。登录失败不自动重试。
+- 需要浏览器登录时必须携带发起方标识 `--agent_type "<当前智能体名称>"`（授权确认页展示用；宿主无法确认名称时才可省略，交由 CLI 从环境变量推断）。
 
 ### 4) 附件、图片和文件解析确认
 
@@ -177,7 +177,7 @@ weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"
 
 - 禁止加载原始 `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）。
+- 当前修正源资料未提供客户档案查询或红字发票红冲接口，`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 数据。
 - 共享、转让和标签当前未纳入 CLI manifest；新版源资料已给出提交接口，但仍需要补稳定接收人/标签 ID 来源、写后回查和测试后再开放。

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

@@ -6,13 +6,18 @@
 
 ## 当前不暴露
 
-以下新版源资料中已有接口路径和请求体，但当前没有纳入 `weaver-work-cli invoice` manifest，Agent 不能绕过 CLI 直接调用：
+以下新版源资料中已有后端能力线索，但当前没有纳入 `weaver-work-cli invoice` manifest，Agent 不能绕过 CLI 直接调用。这里仅保留源资料标识用于转换差异追踪，不构成可执行接口文档：
 
-- 共享发票：`POST /api/inc/shareUsers`
-- 转让发票：`POST /api/inc/transferFpyUser`
-- 标记发票：`POST /api/my/tag/common/batchAddEntityTag`
+- 共享发票：`shareUsers`
+- 转让发票：`transferFpyUser`
+- 标记发票：`batchAddEntityTag`
 - 移除、替换或覆盖标签
 
+修正后的资料包没有提供客户档案查询或红字发票红冲接口定义，因此以下 operation 不属于当前 skill/CLI 能力：
+
+- 客户档案查询：`invoice.customer.*`
+- 红字发票/红冲查询、申请和确认：`invoice.red.*`
+
 ## 原因
 
 这些能力缺少稳定的 Agent 合约：
@@ -22,7 +27,8 @@
 - 转让会改变发票持有人，缺少接收人侧归属回查契约；当前登录人可能在成功后失去可见性，不能据此单独证明新归属
 - 标签缺少标签定义查询、当前标签关系查询和移除/替换语义
 - 写操作后的读回验证边界不完整
+- 客户档案查询、红字发票红冲接口在当前资料包中没有来源文档，不能从旧资料或猜测路径转换
 
 ## Agent 行为
 
-遇到这类请求时，明确说明当前 CLI 未暴露该 operation，不能通过 `curl`、`fetch`、浏览器自动化或原始 E10 `/api/inc/*` 绕过。可以建议先补对应的人员/标签查询能力、`prepare -> apply`、写后回查和测试，再开放给 Agent。
+遇到这类请求时，明确说明当前 CLI 未暴露该 operation，不能通过 `curl`、`fetch`、浏览器自动化或原始 E10 接口绕过。可以建议先补对应的人员/标签查询能力、`prepare -> apply`、写后回查和测试，再开放给 Agent。

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

@@ -2,15 +2,15 @@
 
 ## 什么时候读取
 
-用户要把本地发票文件导入票夹时读取本文件。开始前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
+用户要把本地发票文件或远程发票 URL 导入票夹时读取本文件。开始前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
 
 ## Operation
 
 | 阶段 | Operation | 必填输入 |
 | --- | --- | --- |
-| 识别预览 | `invoice.ocr.preview` | `file` |
-| 准备导入 | `invoice.import.prepare` | `file`、`validate`、`syncToOa` |
-| 确认导入 | `invoice.import.apply` | `file`、`continuation`、`confirm=true` |
+| 识别预览 | `invoice.ocr.preview` | `file` 或 `url` |
+| 准备导入 | `invoice.import.prepare` | `file` 或 `url`，以及 `validate`、`syncToOa` |
+| 确认导入 | `invoice.import.apply` | 与 prepare 相同的 `file` 或 `url`，以及 `continuation`、`confirm=true` |
 
 ## 示例
 
@@ -19,9 +19,11 @@ 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.prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true,"filedMap":{"projectName":"示例项目"}}'
 
-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.import.apply --input-json '{"file":"./invoice.pdf","filedMap":{"projectName":"示例项目"},"continuation":"PREPARE_CONTINUATION","confirm":true}'
+
+weaver-work-cli --json invoice run invoice.import.prepare --input-json '{"url":"https://example.com/invoice.pdf","validate":true,"syncToOa":true}'
 ```
 
 macOS/Linux（bash/zsh）：
@@ -29,9 +31,11 @@ macOS/Linux（bash/zsh）：
 ```bash
 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.prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true,"filedMap":{"projectName":"示例项目"}}'
+
+weaver-work-cli --json invoice run invoice.import.apply --input-json '{"file":"./invoice.pdf","filedMap":{"projectName":"示例项目"},"continuation":"PREPARE_CONTINUATION","confirm":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.import.prepare --input-json '{"url":"https://example.com/invoice.pdf","validate":true,"syncToOa":true}'
 ```
 
 ## 注意
@@ -42,4 +46,6 @@ weaver-work-cli --json invoice run invoice.import.apply --input-json '{"file":".
 
 `validate` 和 `syncToOa` 必须显式传布尔值。默认推荐 `validate=true`、`syncToOa=true`；`validate=true` 分支由服务端固定同步 OA，不能设置 `syncToOa=false`。只有用户明确要求跳过发票查验或离线导入时，才传 `validate=false`；`validate=false` 表示跳过查验，不能描述为“查验通过”。
 
+`fieldKey`/`fieldValue` 可给成功发票设置单个字段，两个参数必须同时提供。`filedMap` 用于批量设置成功发票字段；它在 `inputSchema` 和 `--input-json` 中必须保持 JSON 对象，例如 `"filedMap":{"projectName":"示例项目"}`，不要提前转成字符串。CLI 会在提交 `/api/app/inc/biz/addInvoiceByFile` 的 multipart 表单时再序列化为字符串。
+
 `.prepare` 返回 `preview`、`continuation`、`expiresInSeconds` 和 `workflow.state="AWAITING_CONFIRMATION"`。展示风险后等待用户明确确认，再调用 `.apply`。

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

@@ -1,8 +1,8 @@
-# 开票与红冲端到端示例
+# 开票端到端示例
 
 ## 什么时候读取
 
-需要参考开票或红冲完整对话流程时读取本文件。
+需要参考开票完整对话流程时读取本文件。
 
 ---
 
@@ -33,11 +33,11 @@
 **用户**：开给杭州阿里巴巴，技术服务费5万，不含税
 
 **AI**：
-> 推断税率 6%。需要购方税号吗？如需开专票请提供。
+> 请问是开**个人票（普票，无需税号）**还是**企业专票（需提供税号）**？
 
 **用户**：专票，税号 91330100MA27F4RQ12
 
-→ 金额计算 → 预览 → 确认 → 提交
+→ 推断税率 6% → 金额计算 → 预览 → 确认 → 提交
 
 ---
 
@@ -45,6 +45,11 @@
 
 **用户**：开普票，购方张三，500块钱的餐饮服务，含税
 
+**AI**：
+> 是否确认开**个人普票**？（个人票无需税号）
+
+**用户**：对，开个人票
+
 **AI 推断**：invoiceType="7", personLogo="1"，税率 6%，不含税 471.70，税额 28.30
 
 → 预览 → 确认 → 提交
@@ -79,42 +84,3 @@
 预览后用户回复："**先存台账**"
 
 **AI**：调用 makeInvoice 时添加 `"operateType": "5"` → 展示"已存入待开台账"
-
----
-
-## 示例 7：全额红冲
-
-**用户**：帮我红冲发票 24532000000070468898
-
-**AI**：
-1. queryAvailableBlueInfo 查蓝票
-2. 展示蓝票信息（购方、金额、明细）
-3. 追问：全额/部分？原因？
-
-**用户**：全额红冲，开票有误
-
-4. 展示红冲预览 → 用户确认
-5. redConfirmationApply（isPart="0", redCause="01"）
-6. 展示结果：确认单编号 + 状态
-
----
-
-## 示例 8：部分红冲
-
-**用户**：红冲发票 2453200...899，只冲第 1 行的 3 万
-
-**AI**：查蓝票 → 展示 → 追问原因 → "销售折让"
-
-提交：isPart="1"，detail 传 blueInvoiceLine="1"，amount="30000" → 展示结果
-
----
-
-## 示例 9：查询红冲并确认
-
-**用户**：看看最近有没有待确认的红冲
-
-**AI**：queryRedConfirmationList → 过滤待确认记录 → 展示列表
-
-**用户**：同意第 1 条
-
-**AI**：queryRedConfirmationDetail 展示详情 → 用户确认 → redConfirmationConfirm(confirmType="Y") → 展示结果

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

@@ -20,6 +20,14 @@
 
 `payload` 是已整理好的 `MakeInvoiceReqDTO`。核心字段至少包括购方名称、发票类型、外部单号、金额合计和一条商品明细。专票或全电纸质专票必须提供购方税号。
 
+### 购方信息补齐
+
+修正后的资料包没有提供客户档案查询 operation。组装 payload 前，Agent 只能从用户输入、附件内容或对话上下文提取购方信息；资料不足时必须追问用户补齐，不要调用 `invoice.customer.*` 或绕过 CLI 查询原始接口。
+
+- 个人普票：`invoiceType="7"`，`personLogo="1"`，无需税号。
+- 企业专票或需要企业抬头时：必须由用户或附件提供购方名称、税号；地址、电话、开户行和账号有明确来源时才填入，没有来源不要编造。
+- 从附件提取购方信息前，必须先提醒用户文件内容可能进入当前大模型上下文，并可能发送到解析服务，等待明确确认后再处理。
+
 CLI 会固定销方名称 `上海泛微网络科技股份有限公司`、销方税号 `9131000070322836XD`，并补齐 `billingType="0"`、`sourceType="4"`、`asyncCallFlag="1"`、`invoiceMethod="5"`、`taxSign="1"`。Agent 不要把 Cookie、ETEAMSID、业务 Token 或认证字段放入 payload。
 
 ## 命令