weaver-work-cli 0.1.1 → 0.1.4

package/skills/weaver-e10-ziguanjia/references/ziguanjia-repair.md

@@ -0,0 +1,83 @@
+# 资产报修
+
+## 什么时候读取
+
+用户要提交资产报修时读取本文件。流程是：先查询报修候选（只读）→ 展示候选并附 AI 维修建议 → 用户确认目标（复述确认）→ 执行报修（需确认链）。
+
+## Operation
+
+| Operation | 风险 | 说明 |
+| --- | --- | --- |
+| `asset.repair.query` | read-before-write | 查询报修候选，按 `asset_name` 过滤；不写数据、不返回 continuation |
+| `asset.repair.create` | high-risk-write | 执行报修，需 `confirm:true` + `continuation` |
+
+## 输入要点
+
+`asset.repair.query`：`detail1`（按 `asset_name` 过滤的候选列表，每条 `asset_name` 必填）。
+
+`asset.repair.create`：必填 `detail1`（至少一条；每条 `asset_id`、`fault_desc` 必填，`fault_time` 可选但**必须为 `YYYY-MM-DD HH:mm`（强制带时分，纯日期会被创建动作流拒绝）**，用户未说明时由 Agent 取当前时间）。可选 `repail_name`（未给时由 Agent 生成，≤15 字）、`repail_remark`。需 `prepare -> apply`。
+
+## 展示候选与 AI 维修建议（query 之后、create 之前必做）
+
+`asset.repair.query` 返回候选后，**不要直接进入 create**，按顺序完成：
+
+1. **展示候选**：逐条列出资产名称、资产编号、规格型号与数据 ID（数据 ID 仅内部使用，展示用中文字段含义）；多条时必须交由用户挑选，不自行取第一条。
+2. **AI 维修建议**：对每条候选结合用户给出的故障描述，给出简要维修建议（可能原因 / 排查方向 / 处理建议）。该建议由 AI 基于故障描述推理生成，**不是接口返回**，必须明确标注「维修建议由 AI 生成，仅供参考，最终以维修人员判定为准」，不得伪装成系统权威结论；故障描述缺失时说明无法给出针对性建议并请用户补充。**0 条候选时同样要给出维修建议**，并请用户确认资产名称 / 编号是否准确。
+3. **复述确认**：进入 create 前向用户复述——报修资产名称 / 编号、故障描述、故障发生时间（`YYYY-MM-DD HH:mm`）——用户明确确认后再执行 `asset.repair.create` 的 prepare/apply 确认链。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+# 1) 只读查询候选
+weaver-work-cli --json asset run asset.repair.query --input-json '{"detail1":[{"asset_name":"EXAMPLE_ASSET"}]}'
+# 1.5) 展示候选 + AI 维修建议（标注仅供参考）+ 复述确认（Agent 行为，非命令）
+# 2) prepare（返回 continuation）
+weaver-work-cli --json asset run asset.repair.create --input-json '{"detail1":[{"asset_id":"EXAMPLE_ASSET_ID","fault_desc":"EXAMPLE_FAULT","fault_time":"2026-09-07 09:30"}]}'
+# 3) apply（用户确认后）
+weaver-work-cli --json asset run asset.repair.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+# 1) 只读查询候选
+weaver-work-cli --json asset run asset.repair.query --input-json '{"detail1":[{"asset_name":"EXAMPLE_ASSET"}]}'
+# 1.5) 展示候选 + AI 维修建议（标注仅供参考）+ 复述确认（Agent 行为，非命令）
+# 2) prepare（返回 continuation）
+weaver-work-cli --json asset run asset.repair.create --input-json '{"detail1":[{"asset_id":"EXAMPLE_ASSET_ID","fault_desc":"EXAMPLE_FAULT","fault_time":"2026-09-07 09:30"}]}'
+# 3) apply（用户确认后）
+weaver-work-cli --json asset run asset.repair.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 返回
+
+`repair.query` 返回候选：统一含 `resultCode`、`resultMsg`、`mainTable`、`customData`、`responseData`（业务数据在 `mainTable`，等价于 `responseData.customData.mainTable`）。
+
+`repair.create` 成功返回同样的统一结构，关键字段在 **`mainTable`**：
+
+| 业务含义 | 字段 | 用途 |
+| --- | --- | --- |
+| 报修流程 ID | `lcID` | **作为「查看详情」链接（scene=`asset_repail`）的 dataID** |
+| 流程标题 | `lcbt` | 回报给用户；常见为空 |
+| 报修单号 | `repail_no` / `bxdh`（具体 key 以运行时返回为准，不臆造） | 报修单号，回报给用户的关键标识 |
+
+字段名来自源资料实测记录（`references/repair-apply.md`）+ 通用约定（`_common.md`：所有资产域动作流业务值挂在 `actionData.responseData.customData.mainTable`，响应字段 `lcID` / `lcbt` / `lybh` 等）。
+
+建单后按 `asset.viewlink` 的 `asset_repail` 场景拼链接：
+
+```powershell
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_repail","ids":["<上一步返回的 lcID>"]}'
+```
+
+要点：
+- `lcID` / `repail_no` 常在建单时**尚未回填**（单号由流程内流水号在提交后生成）。此时不要判定失败、不要重试建单；可先用 `weaver-e10-workflow` 读回补齐，或如实说明「报修单号生成中、链接暂不可用」。
+- 链接解析失败只说明「链接暂不可用」，**不影响报修单本身**，绝不因此重试 `repair.create`。
+
+## 注意
+
+- `asset_id` 应为已确认的资产数据 ID；先用 `asset.repair.query` 或 `asset.detail` 取得。
+- **维修建议是 Agent 行为，不是命令**：候选展示与 AI 维修建议发生在 `repair.query` 与 `repair.create` 之间，由 Agent 按上文「展示候选与 AI 维修建议」执行，不消耗额外 CLI 调用。
+- `fault_time` 传纯日期（如 `2026-09-07`）会被 schema 拒绝；用户只给日期未给时间时，补成该日某时刻或与用户确认，不要原样传入。
+- 出现 `partial/write_uncertain` 时停止，先做一次只读回查，不要重复提交 apply。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-resolve.md

@@ -0,0 +1,49 @@
+# 名称解析（存放地点 / 资产状态 / 资产类型）
+
+## 什么时候读取
+
+用户给出资产状态、资产类型或存放地点的中文名称，而写操作需要对应 ID 时读取本文件。
+
+## Operation 与字段
+
+| Operation | 名称字段 | 解析得到的 ID 用途 |
+| --- | --- | --- |
+| `asset.resolve.location` | `house_name` | 写入 `location_browse` |
+| `asset.resolve.status` | `status_name` | 写入 `stateid` |
+| `asset.resolve.type` | `type_name` | 写入 `asset_type_browse` |
+
+三个 operation 均为只读，返回 `items`（含 `id` 与 `name`）。解析到 0 条会报 `resolve_not_found`，解析到多条会报 `resolve_ambiguous` 并要求改用 ID。
+
+### 解析规则（源资料 _dict.md）
+
+- **精确优先**：先按名称精确匹配；部分环境名称过滤不生效返回空时，自动回退全量枚举（pageSize 50）后在结果中按名称精确匹配。
+- **模糊兜底**：精确与枚举均无命中时，按 contains 模糊匹配（如用户搜「笔记本」命中正式名「便携式计算机」）；仅命中单条即采用，返回 `matched:"contains"` 并在 `note` 中注明映射到正式名；命中多条报 `resolve_ambiguous` 候选。
+- **资产类型缓存**：`asset.resolve.type` 首次解析某环境会全量拉取 `zgjasset_type_info` 并落到 skill 包之外 `~/.workbuddy/data/weaver-e10-ziguanjia/asset_type_cache_{env}.json`（按环境隔离，24h 过期），之后本地匹配不再打接口；该缓存严禁写入 skill 包内。
+- **已知名称映射**：本环境正式名如「便携式计算机」而非「笔记本电脑」、「液晶显示器」而非「显示器」、「办公椅」而非「椅子」、「办公桌」而非「桌子」，模糊匹配会按正式名解析；0 命中如实告知用户该名称在字典中不存在，不强行创建。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json asset run asset.resolve.type --input-json '{"type_name":"EXAMPLE_TYPE"}'
+weaver-work-cli --json asset run asset.resolve.status --input-json '{"status_name":"EXAMPLE_STATUS"}'
+weaver-work-cli --json asset run asset.resolve.location --input-json '{"house_name":"EXAMPLE_LOCATION"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json asset run asset.resolve.type --input-json '{"type_name":"EXAMPLE_TYPE"}'
+weaver-work-cli --json asset run asset.resolve.status --input-json '{"status_name":"EXAMPLE_STATUS"}'
+weaver-work-cli --json asset run asset.resolve.location --input-json '{"house_name":"EXAMPLE_LOCATION"}'
+```
+
+## 返回
+
+返回 `items`：`[{ "id": "<解析得到的 ID>", "name": "<名称>" }]`。把 `id` 带入后续写操作的 `asset_type_browse` / `stateid` / `location_browse`。
+
+## 注意
+
+- 解析结果 `id` 是字符串，后续写操作必须原样使用，不要重新按名称猜测。
+- 解析到多条时，优先向用户确认用哪一条，或要求用户直接提供 ID，不要随机选取。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-return.md

@@ -0,0 +1,70 @@
+# 资产归还
+
+## 什么时候读取
+
+用户要归还资产时读取本文件。流程是：先查询可归还候选（只读），再执行归还（需确认链）。
+
+## Operation
+
+| Operation | 风险 | 说明 |
+| --- | --- | --- |
+| `asset.return.query` | read-before-write | 查询可归还资产候选，返回候选数据；不写数据、不返回 continuation |
+| `asset.return.create` | high-risk-write | 执行归还，需 `confirm:true` + `continuation` |
+
+## 输入要点
+
+`asset.return.query`：可选 `return_type`（`0`=全部归还，`1`=部分归还）、`detail1`（按 `asset_name` 过滤的候选列表）。
+
+`asset.return.create`：必填 `data_ids`（半角逗号拼接的确认资产数据 ID，来自 `return.query` 的候选）；需 `prepare -> apply`。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+# 1) 只读查询候选
+weaver-work-cli --json asset run asset.return.query --input-json '{"return_type":"0"}'
+# 2) prepare（返回 continuation）
+weaver-work-cli --json asset run asset.return.create --input-json '{"data_ids":"EXAMPLE_DATA_ID_1,EXAMPLE_DATA_ID_2"}'
+# 3) apply（用户确认后）
+weaver-work-cli --json asset run asset.return.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+# 1) 只读查询候选
+weaver-work-cli --json asset run asset.return.query --input-json '{"return_type":"0"}'
+# 2) prepare（返回 continuation）
+weaver-work-cli --json asset run asset.return.create --input-json '{"data_ids":"EXAMPLE_DATA_ID_1,EXAMPLE_DATA_ID_2"}'
+# 3) apply（用户确认后）
+weaver-work-cli --json asset run asset.return.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 返回
+
+`return.query` 返回候选：统一含 `resultCode`、`resultMsg`、`mainTable`、`customData`、`responseData`（业务数据在 `mainTable`，等价于 `responseData.customData.mainTable`）。
+
+`return.create` 成功返回同样的统一结构，关键字段在 **`mainTable`**：
+
+| 业务含义 | 字段 | 用途 |
+| --- | --- | --- |
+| 归还流程 ID | `lcID` | **作为「查看详情」链接（scene=`asset_return`）的 dataID** |
+| 流程标题 | `lcbt` | 回报给用户 |
+| 归还编号 | `ghbh` | 归还单号，回报给用户的关键标识 |
+
+建单后按 `asset.viewlink` 的 `asset_return` 场景拼链接：
+
+```powershell
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_return","ids":["<上一步返回的 lcID>"]}'
+```
+
+要点：
+- `lcID` 可能在建单返回时为回填中（空值），此时不要判定失败、不要重试建单；可先用 `weaver-e10-workflow` 读回补齐，或如实说明「归还单号生成中、链接暂不可用」。
+- 链接解析失败只说明「链接暂不可用」，**不影响归还单本身**，绝不因此重试 `return.create`。
+
+## 注意
+
+- `data_ids` 必须是 `return.query` 返回的候选数据 ID，不要凭空构造。
+- `return.query` 是只读，不带 `confirm` 也不返回 continuation；只有 `return.create` 走确认链。
+- 出现 `partial/write_uncertain` 时停止，先做一次只读回查，不要重复提交 apply。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-update.md

@@ -0,0 +1,45 @@
+# 修改资产
+
+## 什么时候读取
+
+用户要修改已存在资产的字段（名称、状态、管理人、使用人、地点、单价、价值等）时读取本文件。
+
+## Operation
+
+`asset.update`（风险 `high-risk-write`）。必须 `prepare -> apply`：第一次调用不带 `confirm` 返回 continuation 与变更摘要，用户确认后第二次调用带 `confirm:true` 与 `continuation` 执行。
+
+## 输入要点
+
+以 `weaver-work-cli asset schema` 为准。定位目标（三选一）：`id`（资产数据 ID）、`asset_number`、`asset_name`（后两者用于查询定位，命中多条会要求改用 ID）。变更内容放 `changes`，至少包含一个字段：`asset_name`、`stateid`、`admin_istrator`、`resourceid`、`location_browse`、`unit_price`、`value`。
+
+`stateid` / `location_browse` 必须是已解析的 ID。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.update --input-json '{"id":"EXAMPLE_ASSET_ID","changes":{"stateid":"EXAMPLE_STATUS_ID"}}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.update --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.update --input-json '{"id":"EXAMPLE_ASSET_ID","changes":{"stateid":"EXAMPLE_STATUS_ID"}}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.update --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 返回
+
+`apply` 成功返回 `dataIds`、`count` 与目标 `id`。
+
+## 注意
+
+- `changes` 只提交需要变更的字段，不要传空值覆盖其它字段。
+- 不要修改 `id` 等内部控制字段。
+- 出现 `partial/write_uncertain` 时停止，先做一次 `asset.detail` 只读回查，不要重复提交 apply。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-use.md

@@ -0,0 +1,60 @@
+# 资产领用
+
+## 什么时候读取
+
+用户要提交资产领用申请（多条领用明细）时读取本文件。
+
+## Operation
+
+`asset.use`（风险 `high-risk-write`）。必须 `prepare -> apply`：第一次调用不带 `confirm` 返回 continuation 与预览，用户确认后第二次调用带 `confirm:true` 与 `continuation` 执行。
+
+## 输入要点
+
+以 `weaver-work-cli asset schema` 为准。必填：`detail1`（数组，至少一条；每条 `apply_info` 必填，`asset_spec`、`asset_remark`、`asset_type`、`use_count` 可选）。可选：`use_location`（领用后地点 ID，经 `asset.resolve.location` 解析）、`purpose`。
+
+`detail1[].asset_type` 为资产类型 ID。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.use --input-json '{"detail1":[{"apply_info":"EXAMPLE_APPLY_INFO","asset_type":"EXAMPLE_TYPE_ID","use_count":1}],"use_location":"EXAMPLE_LOCATION_ID","purpose":"EXAMPLE_PURPOSE"}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.use --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+# prepare（返回 continuation）
+weaver-work-cli --json asset run asset.use --input-json '{"detail1":[{"apply_info":"EXAMPLE_APPLY_INFO","asset_type":"EXAMPLE_TYPE_ID","use_count":1}],"use_location":"EXAMPLE_LOCATION_ID","purpose":"EXAMPLE_PURPOSE"}'
+# apply（用户确认后）
+weaver-work-cli --json asset run asset.use --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 返回
+
+`apply` 成功返回统一结构：`resultCode`、`resultMsg`、`actionData`、`responseData`、`customData`，以及提到顶层的 **`mainTable`**（= `responseData.customData.mainTable`）。
+
+关键字段在 `mainTable`：
+
+| 业务含义 | 字段 | 用途 |
+| --- | --- | --- |
+| 领用流程 ID | `lcID` | **作为「查看详情」链接（scene=`asset_use`）的 dataID** |
+| 流程标题 | `lcbt` | 回报给用户 |
+| 领用单号 | `lybh`（具体 key 以运行时为准） | 领用单号，回报给用户的关键标识 |
+
+建单后按 `asset.viewlink` 的 `asset_use` 场景拼链接：
+
+```powershell
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_use","ids":["<上一步返回的 lcID>"]}'
+```
+
+单号可能为回填中（空值），此时不要重试建单；链接解析失败只说明「链接暂不可用」，不影响领用单本身。
+
+## 注意
+
+- 不要把中文地点名称作为 `use_location`，先走 `asset.resolve.location`。
+- 出现 `partial/write_uncertain` 时停止，不要重复提交 apply。

package/skills/weaver-e10-ziguanjia/references/ziguanjia-viewlink.md

@@ -0,0 +1,81 @@
+# 查看链接（查看详情）
+
+## 什么时候读取
+
+查询、新建、修改或动作流**已经成功**之后，需要给用户一个可点击的「查看详情」入口时读取本文件。
+
+典型场景：资产列表、资产详情、领用记录、报修记录、采购申请列表、报修 / 归还的候选资产名，以及折旧计提任务。
+
+## 链接形态
+
+| 形态 | 路径模板 | 是否需要解析表单 ID |
+| --- | --- | --- |
+| 卡片链接 | `/sp/ebdfpage/card/0/{表单ID}/{数据ID}` | 需要，经两步 tag 接口实时解析 |
+| 计提任务（viewport） | `/sp/ebdfpage/viewport/1267093228679077888?calc_month={计提年月}` | 不需要，固定页面 |
+
+CLI 同时返回 `path`（去域名路径）和 `url`（用当前登录环境地址拼好的完整链接）。优先直接用 `url`；只有在需要自行拼接域名时才用 `path`。
+
+## 场景与数据来源
+
+| 场景（`scene`） | 表单标识（tag） | 数据 ID 来源 |
+| --- | --- | --- |
+| `asset_info` | `uf_asset_info` | 资产列表 / 详情每条记录的 `id`；新建返回 `dataIds`；报修·归还候选资产的 `id` |
+| `asset_use` | `uf_asset_use` | 领用记录每条 `id`；领用申请动作流返回的 `lcID` |
+| `asset_return` | `uf_asset_return` | 归还申请动作流返回的 `lcID` |
+| `asset_repail` | `uf_asset_repail` | 报修记录每条 `id`；报修申请动作流返回的 `lcID` |
+| `asset_purch_apply` | `uf_asset_purch_apply` | 采购申请记录每条 `id`；采购申请动作流返回的 `lcID` |
+| `depre_task` | 无（viewport 固定页面） | 传 `calc_month`，取自本次计提操作 |
+
+表单 ID 由「应用标签 → 表单标签」两步接口实时解析（`weaver-asset-eb` → 上表 tag），**不写死常量、不跨环境沿用**，同环境内会复用解析结果。
+
+建单类动作流（领用 / 归还 / 报修 / 采购）的流程 ID 直接取自该次建单返回的 **`mainTable.lcID`**：`asset.use` / `return.create` / `repair.create` / `purch` 的成功返回都会把 `mainTable`（含 `lcID`、`lcbt`、以及各自的单号如 `ghbh`）透传到顶层，无需再翻嵌套结构。单号可能为回填中（空值），此时不要重试建单。
+
+## 输入要点
+
+字段以 `weaver-work-cli asset schema` 为准：
+
+- `scene`：必填，取值见上表。
+- `ids`：数据 ID 数组。**一律按字符串传入**（大整数，避免精度丢失）；一次可传多个，逐条生成各自链接。
+- `calc_month`：仅 `depre_task` 场景需要，格式 `YYYY-MM`。
+- `anchor`：可选，覆盖默认锚点文字「查看详情」。
+
+## 示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_info","ids":["EXAMPLE_ASSET_ID","EXAMPLE_ASSET_ID_2"]}'
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_use","ids":["EXAMPLE_USE_ID"]}'
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"depre_task","calc_month":"2026-08"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_info","ids":["EXAMPLE_ASSET_ID","EXAMPLE_ASSET_ID_2"]}'
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"asset_use","ids":["EXAMPLE_USE_ID"]}'
+weaver-work-cli --json asset run asset.viewlink --input-json '{"scene":"depre_task","calc_month":"2026-08"}'
+```
+
+## 返回
+
+- `available` 为 `true` 时，`links` 数组按传入顺序给出每条记录的 `dataId`、`path`、`url`、`anchor`。
+- `available` 为 `false`（状态 `VIEWLINK_UNAVAILABLE`）时 `links` 为空，`warnings` 说明「链接暂不可用」的原因。这**不是失败**，主操作已经成功，照常回报业务结果即可。
+
+## 展示约定
+
+- 以**对话内纯 Markdown 链接**呈现：`[查看详情](url)`。
+- **锚点文字固定为「查看详情」**，严禁加「查看详情：」前缀与冒号，严禁把完整 URL 作为纯文本直接展示。
+- 禁用 widget 内链接与旧版「蓝底白字胶囊按钮」样式。
+- 多条记录**逐条生成各自的链接**，不要只给首条或共用一条。
+- 报修 / 归还的**候选资产名**场景使用变体：锚点即资产名称本身，如 `[笔记本电脑](url)`，传 `anchor` 覆盖。
+- 回报时只展示业务中文名称，不展示内部 key（`lcID`、`lcbt`、`lybh`、`ghbh`、`id` 等仅供拼链接使用）。
+- 单据 / 流程编号尚未回填时，不输出空值行；如实说明「XX 单号生成中」。
+
+## 注意
+
+- **链接是附加信息**：主查询 / 新建 / 修改 / 动作流已经成功后，链接解析失败只如实说明「链接暂不可用」，**绝不因此重试主操作**——重试会重复查询、重复建单、重复改动数据。
+- **不要臆造表单 ID / 数据 ID**：解析不到就不给链接，不允许用相近 ID 或历史 ID 拼一个可能打不开的链接。
+- **大整数精度**：表单 ID 与数据 ID 均为长整型，全程按字符串处理。
+- **数据 ID 只取本次结果**：每条记录的 ID 取自本次操作返回，不复用其他查询或上一单的 ID。
+- 本链接不涉及附件、图片或文件解析，无需附件安全确认。

package/skills/weaver-work-cli-invoice/SKILL.md

@@ -1,103 +0,0 @@
----
-name: weaver-work-cli-invoice
-description: "泛微 E10 业票通发票：查询个人/企业票夹、查看详情、上传/OCR/查验预览/下载附件，并通过 prepare/apply 导入、新增、编辑、删除发票。当用户要处理业票通、发票、票夹、OCR、查验或发票附件时使用。共享、转让、标签当前不在范围。"
-metadata:
-  requires:
-    bins: ["weaver-work-cli"]
-  cliHelp: "weaver-work-cli invoice --help"
----
-
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-work-cli-shared/SKILL.md`](../weaver-work-cli-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。**
-所有命令通过 `weaver-work-cli --json invoice run <operation> --input -` 执行。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli invoice schema` 是 operation、字段和风险等级的合约来源。
-
-## 路由优先级（先判断是不是业票通发票，再选 operation）
-
-业票通发票不是通用 E10 对象。**只要用户的核心对象是业票通发票、个人/企业票夹、发票 OCR、发票查验或发票附件，就优先使用 `weaver-work-cli-invoice`。**
-
-### 明确归 `weaver-work-cli-invoice` 的高优先级语义
-
-出现以下任一语义时，优先走本 Skill：
-
-- 业票通 / 发票 / 票夹 / 个人票夹 / 企业票夹 / 发票详情
-- 发票上传 / OCR 识别 / 查验预览 / 附件下载
-- 导入发票 / 新增发票 / 编辑发票 / 删除发票
-- `fid` / `fileId` / 发票号码 / 发票代码 / 查验状态 / 报销状态
-
-**判定规则：** 只要最终动作是对业票通发票做查询、查看、上传、OCR、查验预览、下载、导入、新增、编辑或删除，就归 `weaver-work-cli-invoice`。只有当用户处理的是非发票类 E10 业务、通用工作流或尚未封装的业票通能力时，才不使用本 Skill。
-
-## 选哪个命令
-| 想做什么 | 命令 | 按需读取 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) |
-| 共享、转让、标签或 schema 未列出的能力 | 无可用命令 | [`invoice-disabled-capabilities.md`](references/invoice-disabled-capabilities.md) |
-
-处理链：
-
-- 查票夹/详情：`invoice.list` 或 `invoice.enterprise.list` -> 必要时 `invoice.get`
-- OCR 识别预览：`invoice.ocr.preview`；如果先上传，可复用 `invoice.upload` 返回的 `upload`
-- 导入文件：`invoice.import.prepare` -> 用户确认 -> `invoice.import.apply` -> 按返回 `fid` 回查/报告
-- 手工新增：`invoice.add.prepare` -> 用户确认 -> `invoice.add.apply`
-- 编辑发票：`invoice.update.prepare` -> 用户确认 -> `invoice.update.apply`
-- 删除发票：`invoice.delete.prepare` -> 用户确认 -> `invoice.delete.apply`
-
-## 执行原则（减少误路由、误重试和无效消耗）
-
-### 1) 先拿最小必要信息，再执行
-
-- 只是查票夹时，优先直接用 `invoice.list` 或 `invoice.enterprise.list`
-- 用户已经给出 `fid` 时，不要先查列表再过滤，直接用 `invoice.get` 或对应 prepare
-- 只有需要附件归属、可编辑/可删除状态或完整票面时，才补 `invoice.get`
-
-### 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-work-cli-shared/references/e10-auth-and-session.md`，按其中流程用宿主提问/弹框让用户输入 E10 登录域名或选择已有 profile，完成登录后再继续原操作。
-
-## 写操作失败处理：`partial/write_uncertain` 决策树
-
-当导入 / 新增 / 编辑 / 删除等写操作返回 `partial/write_uncertain`，或提示网络中断、部分成功、回查失败、回查字段不一致时，按下面规则处理：
-
-1. **先停止盲目重试**，不要连续重复提交相同 `.apply`
-2. 优先从以下角度解释：
-   - 写请求可能已经到达服务端，但连接在结果确认前中断
-   - 服务端可能只处理了部分发票
-   - 写接口已返回成功，但详情回查失败或与预期不一致
-   - continuation、目标文件、目标发票或登录上下文可能已经变化
-3. 如需确认，只补 **一次** 只读查询（例如 `invoice.get` 或列表查询），不要陷入 query/write 循环
-4. 最终给用户明确结论、已知 `workflow.state`、成功/失败项和下一步人工确认建议，而不是继续无意义重试
-
-**特别注意：** 对导入、删除和编辑场景更要严格执行上述规则；这些场景最容易因重复提交造成重复入账、误删或覆盖用户刚修改的数据。
-
-```bash
-weaver-work-cli invoice schema
-printf '%s\n' '{"page_size":10,"start_pos":0}' | weaver-work-cli --json invoice run invoice.list --input -
-printf '%s\n' '{"fid":"12345"}' | weaver-work-cli --json invoice run invoice.get --input -
-printf '%s\n' '{"file":"./invoice.pdf","validate":false,"syncToOa":false}' | weaver-work-cli --json invoice run invoice.import.prepare --input -
-printf '%s\n' '{"file":"./invoice.pdf","continuation":"<prepare返回值>","confirm":true}' | weaver-work-cli --json invoice run invoice.import.apply --input -
-```
-## 不在本 skill 范围
-
-- 禁止加载原始 `weaver-e10-yepiaotong` Skill 代替 CLI。
-- 禁止 curl、fetch、浏览器自动化或直接访问 E10 `/api/inc/*`。
-- 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
-- 共享、转让和标签当前未纳入 CLI manifest；需要先补稳定 ID 来源、输入 schema、prepare/apply、写后回查和测试后再开放。
-- 非发票类 E10 能力、通用流程编排、表单/审批/组织等业务不由本 Skill 承载。

package/skills/weaver-work-cli-invoice/references/invoice-agent-entry.md

@@ -1,38 +0,0 @@
-# Agent 入口与 Schema
-
-## 什么时候读取
-
-使用 `weaver-work-cli invoice` 前、编写自动化调用、选择 operation 或确认字段结构时读取本文件。
-
-## 准备命令
-
-```bash
-weaver-work-cli --version
-weaver-work-cli doctor --e10
-weaver-work-cli invoice schema
-```
-
-如未登录，按共享规则读取 `../../weaver-work-cli-shared/references/e10-auth-and-session.md` 后处理。
-
-## 固定入口
-
-Agent 优先调用统一 operation 入口：
-
-```bash
-weaver-work-cli --json invoice run <operation> --input -
-```
-
-JSON 通过 stdin 传入，避免 shell 转义和路径注入问题：
-
-```bash
-printf '%s\n' '{"page_size":10,"start_pos":0}' \
-  | weaver-work-cli --json invoice run invoice.list --input -
-```
-
-`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`。
-
-高风险写入读取共享 reference：`../../weaver-work-cli-shared/references/high-risk-write.md`。

package/skills/weaver-work-cli-invoice/references/invoice-disabled-capabilities.md

@@ -1,26 +0,0 @@
-# 暂不暴露的能力
-
-## 什么时候读取
-
-用户要求共享发票、转让发票、打标签、移除标签，或要求调用 `weaver-work-cli invoice schema` 中不存在的业票通接口时读取本文件。
-
-## 当前不暴露
-
-以下原始接口文档存在，但当前没有纳入 `weaver-work-cli invoice` manifest，Agent 不能绕过 CLI 直接调用：
-
-- 共享发票
-- 转让发票
-- 标记发票或移除标签
-
-## 原因
-
-这些能力缺少稳定的 Agent 合约：
-
-- 共享和转让需要接收人的稳定 `appid/cid/uid` 解析来源
-- 转让会改变发票持有人，缺少接收人侧归属回查契约
-- 标签缺少标签定义来源、当前标签关系查询和移除/替换语义
-- 写操作后的读回验证边界不完整
-
-## Agent 行为
-
-遇到这类请求时，明确说明当前 CLI 未暴露该 operation，不能通过 `curl`、`fetch`、浏览器自动化或原始 E10 `/api/inc/*` 绕过。可以建议用户先由 CLI 维护者补齐 manifest、输入 schema、prepare/apply、回查和测试后再开放。

package/skills/weaver-work-cli-invoice/references/invoice-download.md

@@ -1,22 +0,0 @@
-# 下载发票附件
-
-## 什么时候读取
-
-用户要把发票附件下载到本地文件，或已经给出 `fid` 和 `fileId` 时读取本文件。
-
-## Operation
-
-| Operation | 固定规则 |
-| --- | --- |
-| `invoice.download` | 先校验 `fileId` 属于目标 `fid`，拒绝覆盖输出文件 |
-
-## 示例
-
-```bash
-printf '%s\n' '{"fid":"12345","fileId":"67890","output":"./invoice-12345.pdf"}' \
-  | weaver-work-cli --json invoice run invoice.download --input -
-```
-
-## 注意
-
-如果用户没有 `fileId`，先用 `invoice.get` 查看详情里的 `flist`。`output` 已存在时 CLI 会失败，不要自动覆盖用户文件。

package/skills/weaver-work-cli-invoice/references/invoice-enterprise-list.md

@@ -1,35 +0,0 @@
-# 查询企业票夹
-
-## 什么时候读取
-
-用户要查询企业票夹、搜索企业范围发票，或按报销状态筛选企业发票时读取本文件。
-
-## Operation
-
-| Operation | 固定规则 |
-| --- | --- |
-| `invoice.enterprise.list` | 固定 `flag=6`；默认 `sreim=3`，只查未报销发票 |
-
-## 输入
-
-列表字段以 `weaver-work-cli invoice schema` 为准，字段语义与个人票夹一致。常用字段包括 `page_size`、`start_pos`、`content`、购销方、日期、金额、票种、查验状态、来源、排序和 `sreim`。
-
-`sreim` 是查询筛选参数：`0` 获取全部发票，`1` 发票报销中，`2` 报销完成，`3` 获取未报销发票，`4` 获取不可报销。省略时 CLI 默认传 `3`。
-
-## 示例
-
-```bash
-printf '%s\n' '{"page_size":10,"start_pos":0,"buyer_company":"泛微"}' \
-  | weaver-work-cli --json invoice run invoice.enterprise.list --input -
-
-printf '%s\n' '{"page_size":10,"start_pos":0,"sreim":2}' \
-  | weaver-work-cli --json invoice run invoice.enterprise.list --input -
-```
-
-## 返回
-
-返回 `items`、`total`、`totalAmount`、`totalAmountExcludingTax`、`hasMore` 和 `scope="enterprise"`。
-
-## 注意
-
-企业票夹权限失败时不要自动降级查询个人票夹，除非用户明确要求改查个人票夹。不要在输入里传 `flag`；CLI 会固定为企业票夹。

package/skills/weaver-work-cli-invoice/references/invoice-import.md

@@ -1,28 +0,0 @@
-# 导入发票文件
-
-## 什么时候读取
-
-用户要把本地发票文件导入票夹时读取本文件。开始前也读取共享高风险协议：`../../weaver-work-cli-shared/references/high-risk-write.md`。
-
-## Operation
-
-| 阶段 | Operation | 必填输入 |
-| --- | --- | --- |
-| 准备导入 | `invoice.import.prepare` | `file`、`validate`、`syncToOa` |
-| 确认导入 | `invoice.import.apply` | `file`、`continuation`、`confirm=true` |
-
-## 示例
-
-```bash
-printf '%s\n' '{"file":"./invoice.pdf","validate":false,"syncToOa":false}' \
-  | weaver-work-cli --json invoice run invoice.import.prepare --input -
-
-printf '%s\n' '{"file":"./invoice.pdf","continuation":"<prepare返回值>","confirm":true}' \
-  | weaver-work-cli --json invoice run invoice.import.apply --input -
-```
-
-## 注意
-
-`validate` 和 `syncToOa` 必须显式传布尔值。`validate=true` 分支由服务端固定同步 OA，不能设置 `syncToOa=false`。`validate=false` 表示跳过查验，不能描述为“查验通过”。
-
-`.prepare` 返回 `preview`、`continuation`、`expiresInSeconds` 和 `workflow.state="AWAITING_CONFIRMATION"`。展示风险后等待用户明确确认，再调用 `.apply`。