weaver-work-cli 0.1.24 → 0.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weaver-work-cli",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "面向泛微工作工具链的可扩展 TypeScript CLI 基础框架（E10 业票通等能力）",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,6 +44,10 @@
     "@napi-rs/keyring": "^1.3.0",
     "commander": "^13.0.0"
   },
+  "bundleDependencies": [
+    "@napi-rs/keyring",
+    "commander"
+  ],
   "devDependencies": {
     "@types/node": "^22.0.0",
     "tsx": "^4.19.0",

package/skill-template/business-info.json

@@ -454,5 +454,21 @@
     "审批进度",
     "审批意见",
     "今承达"
+  ],
+  "weaver-e10-archive-oa": [
+    "档案定位",
+    "合同号定位",
+    "泛微合同",
+    "契约锁",
+    "商务合同查询",
+    "合同查询",
+    "借阅车",
+    "加入借阅车",
+    "发起借阅",
+    "案例",
+    "契约锁案例",
+    "合同借阅",
+    "档案记录",
+    "合同编号"
   ]
 }

package/skill-template/domains/archive-oa.md

@@ -0,0 +1,19 @@
+本业务域为「泛微商务合同档案查询」：E10 档案定位与 OA 商务合同借阅。入口 `SKILL.md` 按飞书 `lark-approval` 风格组织：CRITICAL 共享前置、路由优先级、逐 operation 命令表、处理链、执行原则、写操作失败决策树和「不在范围」。具体用法拆到 `references/`：
+
+- `archive-locate.md`：按合同号定位档案（`htbh` 必须放 body 顶层）。
+- `contract-search.md`：泛微商务合同查询与可搜索字段配置（`commonSearchFields` 构造规则）。
+- `qys-contract-search.md`：契约锁协作采纳（案例）合同查询（默认只查已归档）。
+- `borrow-car.md`：借阅车列表；加入借阅车是临时铺垫操作，`prepare -> apply` **免用户确认、直接执行**。
+- `borrow-flow.md`：发起借阅的职责边界（用户在浏览器登录后自己操作）与给用户的指引。
+- `disabled-capabilities.md`：接口未收录与必须由用户在界面完成的操作边界。
+
+Agent 调优重点：
+
+- `weaver-work-cli archive-oa schema` 是 operation 合约第一信息源。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段；**禁止向用户索要后台应用凭据**（如 OpenESB 的 appKey / corpid / appSecret），交互中不暴露此类概念。
+- 泛微商务合同与契约锁协作采纳是两套独立应用：`passid` / `listId` / `esbActionIds` / `objId` 与流程页 `fb` 均不同，禁止交叉混用。
+- 合同行 ID（`data[*].id`）与档案记录 ID 只作为后续 operation 入参，不展示给最终用户。
+- 列表结果**只查 `pageNo=1`、禁止翻页**（不得请求 `pageNo≥2`，不循环翻页累加），单次最多展示 20 条；需要更多数据时提示用户缩小筛选条件，不得翻页获取。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用；**加入借阅车每次最多 6 条，且免用户确认**（临时铺垫操作，只为后续发起借阅做准备，不产生最终业务结果，直接 prepare → apply 后事后回报）。发起借阅不在 CLI 能力内，由用户在界面完成。
+- 发起借阅用 `archive-oa.borrow.start.url` 生成流程页 URL（`fullCreate/<flowId>?fb=<fb>&data=<JSON>`，只读、无需后台凭据）：优先用系统默认浏览器直接打开，打不开时原样输出完整 URL 让用户手动打开；表单填写与提交由用户完成，不代填、不代提交。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。

package/skill-template/domains/yepiaotong.md

@@ -13,7 +13,7 @@
 - `invoice-add.md`：手工新增发票的 `prepare -> apply` 写入协议。
 - `invoice-update.md`：编辑发票的 `prepare -> apply` 写入协议。
 - `invoice-delete.md`：删除发票的 `prepare -> apply` 写入协议。
-- `invoice-reim.md`：发票报销自动填单的查询、组装和报销单创建/更新确认链。
+- `invoice-reim.md`：发票报销自动填单的数据准备；报销单创建/修改调用 `weaver-e10-workflow` 的 `workflow.createForm` / `workflow.createRequest` / `workflow.edit*`。
 - `invoice-issuing.md`：智能开票或存台账的开票 payload 确认链。
 - `invoice-disabled-capabilities.md`：共享、转让、标签等暂未暴露能力的处理边界。
 
@@ -23,7 +23,7 @@ Agent 调优重点：
 - 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段。
 - 写操作只接受 CLI 生成的 continuation，不手工构造或复用。
 - `validate=false` 只能说明跳过查验，不能描述为查验通过。
-- 报销单创建、报销单更新、开票和存台账必须先展示结构化 JSON 摘要并取得明确确认；报销单创建字段在 operation 顶层逐项传入，不包通用 `payload`。
+- 报销单创建、报销单修改、开票和存台账必须先展示摘要并取得明确确认；报销单按 `workflow.createRequest` 的 `{main, details}` 结构组装 `data`。
 - 开票前从用户输入、附件或对话上下文提取购方字段；当前资料包没有客户档案查询 operation，资料不足时追问用户补齐。
 - 当前资料包没有红字发票红冲接口，`invoice.red.*` 不属于可用 operation。
 - 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。

package/skills/weaver-e10-archive-oa/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: weaver-e10-archive-oa
+display_name: 泛微商务合同档案查询
+display_name_en: Weaver Business Contract Archive Query
+description: "泛微 E10 档案定位与 OA 商务合同借阅：按合同号定位档案；泛微商务合同与契约锁（案例）商务合同的查询、加入借阅车、借阅车列表、发起借阅。出现「借阅合同」「泛微」「契约锁」「借阅车」等说法时按本技能执行。"
+description_zh: "泛微 E10 档案定位与 OA 商务合同借阅。按合同号在档案系统定位档案记录；泛微商务合同与契约锁协作采纳（案例）商务合同各自的查询、加入借阅车、查看借阅车、发起借阅全链路。**出现「借阅合同」「泛微」「契约锁」「借阅车」等说法时直接按本技能执行。** 系统地址与登录态由当前 E10 profile 提供，技能不内置默认地址。"
+description_en: "Weaver E10 archive locating and OA business contract borrowing: locate archive records by contract number, and query/add-to-cart/list-cart/borrow for Weaver and Qiyuesuo business contracts. Trigger this skill whenever the request mentions borrowing contracts, Weaver (泛微), Qiyuesuo (契约锁), or the borrow cart. The system address and session come from the active E10 profile; no default address is built in."
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+dependencies:
+  - weaver-e10-shared
+cliHelp: "weaver-work-cli archive-oa --help"
+---
+
+## 触发条件
+
+用户出现以下任一说法时，**直接按本技能执行**：
+
+- **「借阅合同」**——含「合同借阅」「发起借阅」「借阅车」「加入借阅车」等同类表述。
+- **「泛微」**——指泛微商务合同／泛微借阅链路；同一句话里出现「契约锁」时，走本技能的 `archive-oa.qys.*` 分支。
+
+命中即进入本技能：先按共享规则确认登录态，再按下方路由表选 operation。不要因为句子里没有「档案」字样就改走其它技能，也不要把「泛微」误当成厂商名而跳过。
+
+**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`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
+**`--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 数据。
+
+### 登录与请求头凭证契约
+
+本 Skill 是 CLI 型技能，不自行发起 HTTP 请求：认证与会话**统一由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系托管**，禁止自建或绕过登录流程。
+
+请求头三件套（Cookie 完整原始串 / `eteamsid` / `User-Agent`）由 `weaver-work-cli` 统一注入，唯一权威声明见 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md) 的「请求头契约」章节。
+
+接口请求头（由 CLI 注入，Agent 不手写）：
+
+```text
+Cookie: <登录返回的完整原始 Cookie 串>   # 禁止裁剪、去重或改写
+eteamsid: <登录返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+Agent 不得自行拼接、改写或向用户索取上述凭证（禁止要求用户贴 Cookie / ETEAMSID / token），也不得直接 `curl` / `fetch` E10 接口。
+
+所有命令通过 `weaver-work-cli --json archive-oa run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli archive-oa schema` 是 operation、字段和风险等级的合约来源。
+
+命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、文件删除、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
+
+涉及合同附件、图片、本地文件、借阅原文或文件上传的操作，执行前必须提醒用户：文件内容可能被上传到 E10 系统或文件服务器，也可能下载到本地磁盘，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
+
+# 泛微商务合同档案查询
+
+## 适用场景（触发条件）
+
+出现以下任一意图时使用本技能：
+
+- 按合同号查档案 / 合同号定位档案 / 查档案记录。
+- 查泛微商务合同 / 商务合同列表 / 合同查询（合同号、签约方、合同名称、合同类型、签订日期、合同金额、合同专项模块）。
+- 查契约锁合同 / 案例查询 / 案例台账 / 契约锁协作采纳。
+- 合同加入借阅车 / 查看合同借阅车 / 借阅车列表。
+- 发起借阅 / 从借阅车发起合同借阅 / 合同借阅流程。
+
+不在本技能范围内：非合同的档案业务（如文书定档案的全宗、全文检索、借阅单与原文下载）、通用工作流，以及其它 E10 业务对象。
+
+## 路由优先级（先判断业务对象，再选 operation）
+
+只要用户的核心对象是**合同号定位档案、泛微商务合同、契约锁协作采纳（案例）合同、合同借阅车或合同借阅流程**，就优先使用 `weaver-e10-archive-oa`。
+
+**判定规则：** 泛微商务合同与契约锁协作采纳是两套独立应用，参数值不同，禁止交叉混用。用户只说「查合同 / 商务合同」而未指明来源时，**必须先确认是泛微还是契约锁（案例）**，不要默认其中一套。
+
+## 选哪个命令
+
+| 想做什么 | 命令 | 按需读取 reference |
+| --- | --- | --- |
+| 查看可用 operation、字段和风险等级 | `archive-oa schema` | — |
+| 按合同号定位档案 | `archive-oa run archive-oa.archive.locate` | [`archive-locate.md`](references/archive-locate.md) |
+| 查泛微商务合同 / 字段配置 | `archive-oa run archive-oa.contract.list` / `archive-oa.contract.fields` | [`contract-search.md`](references/contract-search.md) |
+| 查契约锁（案例）合同 | `archive-oa run archive-oa.qys.contract.list` | [`qys-contract-search.md`](references/qys-contract-search.md) |
+| 加入借阅车 / 看借阅车 | `archive-oa run archive-oa.borrow-car.add.prepare` → `.apply` / `archive-oa.borrow-car.list` | [`borrow-car.md`](references/borrow-car.md) |
+| 发起借阅（**生成流程页 URL 并打开浏览器**） | `archive-oa run archive-oa.borrow.start.url` / 契约锁 `archive-oa.qys.borrow.start.url`（或 `archive-oa borrow start-url [--source qys]`） | [`borrow-flow.md`](references/borrow-flow.md) |
+| 其余未收录能力 | 不在范围 | [`disabled-capabilities.md`](references/disabled-capabilities.md) |
+
+契约锁链路把 operation 前缀换成 `archive-oa.qys.*`（借阅车 `archive-oa.qys.borrow-car.*`、发起借阅 `archive-oa.qys.borrow.start.url`）。两套的流程页 URL 规则相同，`fb` 取借阅车记录自身的值（泛微 `0`、契约锁 `1`），禁止手工指定；契约锁客户名称字段是 `qymc`，泛微是 `htmc`。
+
+## 典型处理链
+
+### 档案定位
+
+```text
+archive-oa.archive.locate（合同号 → 档案记录）
+  → 命中：rows[].{id,title,contractNo}
+  → 未命中：rows 为空，提示未找到对应档案，不擅自猜测
+```
+
+拿到档案记录 `id` 后的操作/利用记录查询**尚未收录**，不要伪造该能力。
+
+### 泛微商务合同借阅
+
+```text
+archive-oa.contract.list（可选先 archive-oa.contract.fields 确认字段）
+  → 静默缓存合同行 data[*].id 供加入借阅车复用
+  → archive-oa.borrow-car.add.prepare（≤6 条）→ 直接 .apply（临时铺垫操作，免确认）
+  → archive-oa.borrow-car.list 查看借阅车
+  → archive-oa.borrow.start.url（≤6 条）→ 得到流程创建页 URL
+     （fullCreate/100003460000002090?fb=<fb>&data=[{hth,htmc,yfhd,fph}]）
+  → 优先用系统默认浏览器打开该 URL；无图形环境或无权限时原样输出 URL 让用户手动打开
+  → 表单填写与提交由用户在浏览器完成（不代填、不代提交、不索要后台应用凭据）
+```
+
+### 契约锁（案例）链路
+
+```text
+archive-oa.qys.contract.list（默认只查「处理进度=已归档」）
+  → archive-oa.qys.borrow-car.add.prepare → .apply
+  → archive-oa.qys.borrow-car.list
+  → archive-oa.qys.borrow.start.url → 流程页 URL（fb 取记录值，通常 1）
+  → 优先打开浏览器；打不开则原样输出 URL
+```
+
+## 命令入口
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli archive-oa schema
+weaver-work-cli --json archive-oa run archive-oa.contract.list --input-json '{"pageNo":1}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli archive-oa schema
+weaver-work-cli --json archive-oa run archive-oa.contract.list --input-json '{"pageNo":1}'
+```
+
+复杂或多行 JSON 先写入 UTF-8 文件再用 `--input <path>`；不要在同一条命令里同时传 `--input` 和 `--input-json`。
+
+## 执行原则
+
+1. **静默缓存 ID，不展示给用户**：合同行 `data[*].id`、档案记录 `id` 只作为后续 operation 入参，回复用户时只用合同号、合同名称、签约方、题名等有含义内容。
+2. **两套参数勿混用**：泛微 `passid/listId/esbActionIds/objId` 与契约锁完全不同；发起借阅流程页 `fb` 泛微为 `0`、契约锁为 `1`。
+3. **每次最多 6 条**：加入借阅车与发起借阅的上限都是 6，超限先提示用户缩减。
+4. **写操作必须走 `prepare → apply`**：`prepare` 只做校验与回查（不写数据），再执行 `.apply`（`confirm: true`），CLI 用 `--yes`；`continuation` 只在 `prepare` 之后签发，禁止手工构造或复用。**加入借阅车是临时铺垫操作**（只为后续发起借阅做准备，本身不产生最终业务结果），**免用户确认**：Agent 直接 prepare → apply，事后简要回报即可，不要为此停下来询问。
+5. **发起借阅 = 生成流程页 URL 并打开浏览器**：用 `archive-oa.borrow.start.url` 生成 `fullCreate/<flowId>?fb=<fb>&data=<JSON>`（只读，不写数据、不触发流程、不需要后台凭据），**优先用系统默认浏览器直接打开**；无法打开时**原样输出完整 URL** 让用户手动打开。表单填写与提交由用户在浏览器完成，不代填、不代提交；不得调用已下线的 `borrow.start.prepare` / `.apply`。
+6. **结果为 `partial/write_uncertain` 时停止**，不自动重放写请求；`failNum > 0` 时按部分成功向用户说明。
+7. **禁止向用户索要后台应用凭据**（如 OpenESB 的 `appKey` / `corpid` / `appSecret`）：交互流程不暴露这类概念，用户只需在浏览器自己操作；任何情况下不得猜测、内置或代填此类凭据。
+8. **系统地址来自当前 E10 profile**（`weaver-work-cli auth status`），未登录时按共享规则让用户登录，禁止猜测或拼接接口地址。
+9. **输出样式、条数上限与禁止翻页**：列表类结果默认用 Markdown 表格（第一列「序号」从 1 递增，分隔行用 `| :---: |` 居中），不要用 JSON 原文或编号堆叠代替。**只查第 1 页（`pageNo=1`），禁止翻页**——不得请求 `pageNo≥2` 的任何页，也不做循环翻页累加（合同列表常达上千条，翻页极慢且刷屏）；单次最多展示 20 条。数据不足或需要更多时，提示用户**缩小筛选条件**（签订日期 / 客户类型 / 签约方关键词），不得通过翻页获取更多。
+
+## 不在范围
+
+- 档案操作/利用记录（借阅、下载、浏览日志）查询。
+- 契约锁合同的搜索字段配置接口。
+- 借阅车记录的移除、编辑，以及借阅流程的提交（流程提交必须由用户在浏览器完成）。
+
+禁用边界与替代动作见 [`disabled-capabilities.md`](references/disabled-capabilities.md)。

package/skills/weaver-e10-archive-oa/references/archive-locate.md

@@ -0,0 +1,49 @@
+# 按合同号定位档案
+
+`archive-oa.archive.locate`：按合同号在档案系统定位档案记录，返回档案记录 ID / 题名 / 合同号。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive-oa run archive-oa.archive.locate --input-json '{"contractNo":"PLACEHOLDER_CONTRACT_NO"}'
+weaver-work-cli archive-oa locate --contract-no "PLACEHOLDER_CONTRACT_NO"
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive-oa run archive-oa.archive.locate --input-json '{"contractNo":"PLACEHOLDER_CONTRACT_NO"}'
+weaver-work-cli archive-oa locate --contract-no "PLACEHOLDER_CONTRACT_NO"
+```
+
+## 输入
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `contractNo` | string | 是 | 合同号，对应接口顶层 `htbh` |
+| `pageNo` | integer | 否 | 页码，从 1 开始，缺省 1 |
+
+## 接口契约要点
+
+- 请求：`POST /api/ebuilder/form/formdata/v2/getFormDataList/getArcIdByContractNo`。
+- 合同号**必须放在 body 顶层 `htbh`**；放进 `datajson.mainTable` 会被忽略并返回整表默认列表（发现结果里混入无关档案时按此排查）。
+- 响应取 `datajson.datas[*].mainTable.{id, folder_title, hth}`；未命中时 `datas` 为空数组，业务状态仍为 `true`。
+
+## 输出处理
+
+- `rows[].id`：档案记录 ID，静默缓存供后续 operation 使用，**不要展示给最终用户**。
+- `rows[].title` / `rows[].contractNo`：题名与合同号，可展示。
+- `matched=false` 时提示未找到对应档案，不擅自改用其它合同号或改查其它链路。
+- 命中多条时最多展示前 20 条；定位结果不做翻页。
+
+## 失败处理
+
+| 场景 | 处理 |
+| --- | --- |
+| `authentication` / `session_expired` | 停止，按共享规则让用户重新登录后再继续 |
+| 接口未发布（`datajson.status=false`、`接口标识不存在`） | 提示联系管理员发布 `getArcIdByContractNo`，不切换到其它接口 |
+| `contractNo` 为空 | 先向用户要合同号，不要猜测 |
+
+档案操作/利用记录（借阅、下载、浏览日志）接口尚未收录，拿到 `id` 后不要声称可以查询这些记录。

package/skills/weaver-e10-archive-oa/references/borrow-car.md

@@ -0,0 +1,76 @@
+# 合同借阅车：列表与加入
+
+- `archive-oa.borrow-car.list` / `archive-oa.qys.borrow-car.list`：查看借阅车。
+- `archive-oa.borrow-car.add.prepare` → `archive-oa.borrow-car.add.apply`：加入借阅车（写操作）。
+- `archive-oa.qys.borrow-car.add.prepare` → `archive-oa.qys.borrow-car.add.apply`：契约锁加入借阅车（写操作）。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli archive-oa borrow-car list
+weaver-work-cli archive-oa borrow-car add-prepare --data-ids "PLACEHOLDER_ID_1,PLACEHOLDER_ID_2"
+weaver-work-cli archive-oa borrow-car add-apply --continuation "<prepare 返回的 continuation>" --yes
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli archive-oa borrow-car list
+weaver-work-cli archive-oa borrow-car add-prepare --data-ids "PLACEHOLDER_ID_1,PLACEHOLDER_ID_2"
+weaver-work-cli archive-oa borrow-car add-apply --continuation "<prepare 返回的 continuation>" --yes
+```
+
+契约锁链路加 `--source qys`（`add-prepare` / `add-apply` / `list` 均支持）。
+
+## 输入
+
+| operation | 输入 | 说明 |
+| --- | --- | --- |
+| `.borrow-car.list` | `pageNo`（缺省 1） | 分页查看借阅车 |
+| `.borrow-car.add.prepare` | `dataIds`（字符串数组，≤6） | 合同数据行 ID，来自合同查询 `rows[].id` |
+| `.borrow-car.add.apply` | `continuation`、`confirm` | continuation 来自 prepare；`confirm` 必须为 `true` |
+
+## 两套链路的固定项（各自独立，禁止交叉）
+
+| 固定项 | 泛微商务合同 | 契约锁协作采纳 |
+| --- | --- | --- |
+| 列表 operation | `archive-oa.borrow-car.list` | `archive-oa.qys.borrow-car.list` |
+| 加入 operation | `archive-oa.borrow-car.add.prepare` → `.apply` | `archive-oa.qys.borrow-car.add.prepare` → `.apply` |
+| `dataIds` 来源 | `archive-oa.contract.list` 的 `rows[].id` | `archive-oa.qys.contract.list` 的 `rows[].id` |
+| 合同号字段 | `hth`（泛微） | `hth`（契约锁，同名不同源） |
+| 单次条数上限 | 6 | 6 |
+| 展示列 | 按 `borrow-car.list` 返回字段原样展示 | 按 `qys.borrow-car.list` 返回字段原样展示 |
+
+`dataIds` 只能取对应链路自己 `contract.list` 的 `rows[].id`：**不得把泛微行 ID 传给契约锁加入借阅车**（反之亦然），也不得用合同号代替行 ID。
+
+## 加入借阅车直接执行（免确认）
+
+加入借阅车是**临时中间操作**：只为后续发起借阅做铺垫，本身不产生最终业务结果（真正的借阅要在界面发起并提交）。因此**不要求用户确认**，Agent 直接连跑 `prepare` → `apply`，减少来回交互：
+
+1. `prepare` 只做校验与回查（查一次借阅车现状），**不写数据**；返回值里 `preview.count` 是待加入条数，`preview.borrowCarBefore` 是加入前借阅车条数。
+2. **直接执行 `apply`**（带 `continuation` 且 `confirm: true`，CLI `--yes`），**不停下来等用户确认**。
+3. 执行后简要回报：加入了几条、借阅车现有条数，并提醒用户在界面勾选对应记录发起借阅。
+4. `failNum > 0` 时按部分成功向用户说明成功条数与失败 ID，不自动重放。
+
+## 失败处理
+
+| 场景 | 处理 |
+| --- | --- |
+| `id_list_too_many` | 超过 6 条，提示用户缩减后重试 |
+| `id_list_invalid` | ID 必须是数字，检查是否误传了合同号或整行对象 |
+| `confirmation` / `continuation_required` | 缺少 continuation 或票据失效，重新走 prepare → apply（免确认） |
+| `continuation_context_mismatch` | 环境或登录账号变了，重新执行 prepare |
+| `partial` / `write_uncertain` | 停止，向用户说明部分成功，不自动重放 |
+
+## 输出处理
+
+- **展示列固定为 6 列**（取自 `borrow-car.list` 的 `meta.columns`）：合同号 `hth`、签约客户 `htmc`、分部 `fb`（`0` = 泛微、`1` = 契约锁）、`daxtbs`、发票号 `fph`、银行回单 `yhhd`（接口未返回该字段时显示 `—`）。**不展示「操作」列**（界面上的「删除」按钮属界面动作，CLI 不提供删除能力）。
+- 其余返回字段（`id`、`form_data_id`、`form_table_id`、`ebrecord_rowkey`、`rowKey`、`name`、`create_time`、`update_time`、`data_status`、`data_status_value`、`is_flow`、`isFollow`）**不展示**；`id` 只作 `dataIds` 入参。
+- 加入借阅车成功后，**直接重新查询并展示当前借阅车列表**，不必再问用户要不要看。
+- 两套链路展示列**不得混用**：契约锁以 `archive-oa.qys.borrow-car.list` 的 `meta.columns` 为准。
+- **禁止翻页**：只查 `pageNo=1`，不请求后续页；单次最多展示 20 条，超过时说明总数。
+- 结果默认用 Markdown 表格输出（第一列「序号」从 1 递增，分隔行 `| :---: |` 居中）。
+
+借阅车记录的移除与编辑能力尚未收录，见 `references/disabled-capabilities.md`。

package/skills/weaver-e10-archive-oa/references/borrow-flow.md

@@ -0,0 +1,53 @@
+# 发起借阅（生成流程创建页 URL）
+
+界面的「确认发起」本质是打开一个前端流程页，地址规则（源码依据：借阅车「确认发起」按钮脚本）：
+
+```text
+/sp/workflow/flowpage/fullCreate/100003460000002090?fb=<fb>&data=<JSON>
+```
+
+- `fb`：取所选借阅车记录的 `fb` 字段（`0` = 泛微、`1` = 契约锁），即界面「分部」列。
+- `data`：`JSON.stringify([{hth, htmc, yfhd, fph}, ...])`；`hth` 合同号、`htmc` 签约客户、`yfhd` 银行回单、`fph` 发票号，取不到时为空串。
+- 该地址**只是前端页面 URL**：不写数据、不触发流程、不需要任何后台应用凭据。
+
+## 用 operation 生成 URL
+
+macOS/Linux：
+
+```bash
+weaver-work-cli --json archive-oa borrow start-url --contract-nos "20260116087,20260116055,20260116002"
+```
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive-oa borrow start-url --contract-nos "20260116087,20260116055,20260116002"
+```
+
+等价的 operation 写法（macOS/Linux）：
+
+```bash
+weaver-work-cli --json archive-oa run archive-oa.borrow.start.url --input-json '{"contractNos":["20260116087"]}'
+```
+
+返回 `url` / `flowId` / `fb` / `items` / `borrowCarCount`。
+
+- 传 `contractNos`：只取这些合同号对应的借阅车记录（≤6 条）；不在借阅车里的合同号直接报 `contract_not_in_borrow_car`，不要伪造。
+- 不传 `contractNos`：使用整页借阅车记录（≤6 条），与界面「不勾选直接确认发起」一致。
+
+## 打开方式
+
+1. **优先用系统默认浏览器直接打开**返回的 `url`：macOS `open "<url>"`、Windows `start "" "<url>"`、Linux `xdg-open "<url>"`。
+2. 若终端无图形环境、命令被拒绝或打开失败：**原样输出完整 URL**，让用户手动复制到浏览器打开。不要截断、不要改写、不要省略参数。
+3. 只读跳转无需征求许可；但**不得**替用户填写或提交流程表单。
+
+## 边界
+
+- **禁止向用户索要任何后台应用凭据**（`appKey` / `corpid` / `appSecret` 等），交互中不暴露这类概念。
+- **不要调用**已下线的 `archive-oa.borrow.start.prepare` / `.apply`（含 `qys` 变体）。
+- 不要声称「已发起借阅」「借阅已提交」：URL 打开后流程表单由用户在浏览器确认并提交。
+- 不代登录、不代点界面、不代提交。
+- 一次最多 6 条；超出时让用户缩小范围，不要自动拆批。
+- 两套链路各自有独立的 operation：泛微 `archive-oa.borrow.start.url`、契约锁 `archive-oa.qys.borrow.start.url`（CLI：`borrow start-url --source qys`）。两者共用同一流程 ID，`fb` 取借阅车记录自身的值（泛微通常 `0`、契约锁通常 `1`），**禁止手工指定 `fb`**。
+- 契约锁借阅车记录的客户名称字段是 `qymc`（泛微是 `htmc`），生成时已做兼容；契约锁借阅车为空时直接报 `borrow_car_empty`，提示先加入借阅车。
+- 契约锁流程页对 `data` 结构的接受度尚未逐一实测；若页面打开后未带出数据，如实告知用户，不要伪造成功。

package/skills/weaver-e10-archive-oa/references/contract-search.md

@@ -0,0 +1,63 @@
+# 泛微商务合同查询与搜索字段
+
+- `archive-oa.contract.list`：查询泛微商务合同列表。
+- `archive-oa.contract.fields`：查询可搜索字段配置（构造搜索条件时用）。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli archive-oa contract fields
+weaver-work-cli --json archive-oa run archive-oa.contract.list --input-json '{"pageNo":1,"fields":[{"field":"hth","value":"PLACEHOLDER_CONTRACT_NO"}]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli archive-oa contract fields
+weaver-work-cli --json archive-oa run archive-oa.contract.list --input-json '{"pageNo":1,"fields":[{"field":"hth","value":"PLACEHOLDER_CONTRACT_NO"}]}'
+```
+
+## 输入（`archive-oa.contract.list`）
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `pageNo` | integer | 否 | 页码，从 1 开始，缺省 1 |
+| `fields` | array | 否 | 搜索条件数组，元素 `{ field, conditionType, value }` |
+| `matchType` | string | 否 | `and`（默认）或 `or`；源资料约定默认「且」 |
+
+`conditionType` 取值：
+
+| 取值 | value 形态 | 用途 |
+| --- | --- | --- |
+| `like`（缺省） | 字符串 | 模糊匹配，如合同号、客户名称、合同类型 |
+| `between` | `{min,max}` 或 `[起,止]` | 金额区间（`htzje`，单位元、字符串数字）、日期区间（`qdrq` / `ysrq`） |
+| `in` | 数组 | 复选框多选，如 `sfxc`、`hsgs` |
+| `inC` | 数组 | 浏览按钮/下拉多选，如 `zxfa`（合同专项模块）、`tjry`（提交人） |
+
+常用字段：`hth`（合同号）、`khmc`（签约方）、`zzyhmc`（最终客户名称）、`htmc`（合同名称）、`htlx`（合同类型）、`qdrq`（签订日期）、`ysrq`（验收日期）、`htzje`（合同总金额）、`zxfa`（合同专项模块）。字段名不确定时先跑 `archive-oa.contract.fields`。
+
+### 合同专项模块（`zxfa`）
+
+用 `inC` + 对象数组，不要用 `like` 或字符串：文书定-档案管理、齐业成-费控管理等专项模块按浏览按钮取值传入。
+
+## 输出处理
+
+- 行数据在 `rows`（`data[*]`），列定义在 `meta.columns`（`title` ↔ `dataIndex`）。
+- `rows[].id` 是合同数据行的内部 ID，**静默缓存**供 `archive-oa.borrow-car.add.prepare` 的 `dataIds` 使用，不展示给最终用户。
+- **展示列固定为 11 列**（与系统列表页一致，其余字段一律不展示）：合同号 `hth`、签约方 `khmc`、最终客户名称 `zzyhmc`、合同名称 `htmc`、提交人 `tjry`（数组取 `name`，多人用「、」连接）、合同类型 `htlx`、签订日期 `qdrq`、验收日期 `ysrq`、产品版本号 `cpbbh`（数组取 `name`）、是否有发票 `sfyfp`（数组取 `name`，值即「有」/「没有」）、是否有回单 `someyhhd`（扁平字符串，**空值按「没有」展示**）。
+- 后三列（`cpbbh` / `sfyfp` / `someyhhd`）**仅泛微商务合同返回**；契约锁协作采纳不返回这三个字段，契约锁仍按其固定 8 列展示，不得套用泛微这 3 列。
+- **其余字段（`byx`、`daxtbs`、`ebrecord_rowkey`、`form_data_id`、`id`、`isFollow`、`sfyhd`、`somefph`、`unique_key`、`ysd`、`zbgg`、`zbtzs`）一律不展示**，即使接口返回了也不要追加到表格里；`id` 等内部标识只作 `dataIds` 入参使用。
+- 响应 `total=0` 但 `rows` 非空属于正常现象，不要据此判定为无数据。
+- **禁止翻页**：只查询 `pageNo=1`，**不得请求 `pageNo≥2`**、不做循环翻页累加；单次最多展示 20 条。命中超过 20 条时说明总数，并提示用户缩小筛选条件（签订日期 / 客户类型 / 签约方关键词），**不得通过翻页获取更多数据**。
+- 结果默认用 Markdown 表格输出（第一列「序号」从 1 递增，分隔行 `| :---: |` 居中）。
+
+## 失败处理
+
+| 场景 | 处理 |
+| --- | --- |
+| `authentication` / `session_expired` | 停止并让用户重新登录 |
+| `enum_invalid`（`matchType` 非法） | 改为 `and` / `or` |
+| `search_value_invalid` | 检查 `between` 是否为 `{min,max}` 或二元数组、`in`/`inC` 是否为数组 |
+| 字段不存在导致查不到数据 | 用 `archive-oa.contract.fields` 核对字段名后重试，不要猜测字段 |

package/skills/weaver-e10-archive-oa/references/disabled-capabilities.md

@@ -0,0 +1,29 @@
+# 禁用边界（接口未收录 / 未暴露）
+
+以下能力**没有**对应的 operation：接口来源资料未收录，或属于必须由用户在系统界面完成的操作。遇到这些诉求时：
+
+1. 不要伪造 operation、不要改调用其它接口来「凑」能力；
+2. 明确告知用户该能力当前不可用及原因；
+3. 给出替代动作（见下表）。
+
+## 未收录的接口
+
+| 诉求 | 现状 | 替代动作 |
+| --- | --- | --- |
+| 查询档案的操作/利用记录（借阅、下载、浏览日志） | 接口未收录 | 用 `archive-oa.archive.locate` 拿到档案记录 ID 后，告知记录查询暂不可用，请到系统界面查看 |
+| 契约锁合同的搜索字段配置（`showFilters`） | 接口未收录 | 参考泛微 `archive-oa.contract.fields` 的字段规则，并与用户确认字段内部名后再查询 |
+
+## 必须由用户在界面完成的操作
+
+| 诉求 | 原因 | 替代动作 |
+| --- | --- | --- |
+| 提交借阅流程表单 | 表单填写与提交必须由用户在浏览器完成 | Agent 用 `archive-oa.borrow.start.url` 生成流程页 URL 并打开（或输出 URL），不代填、不代提交 |
+| 移除 / 编辑借阅车记录 | 未提供对应接口 | 提示用户在系统界面的借阅车中操作 |
+
+## 通用禁止项
+
+- 禁止直接 `curl` / `fetch` / 浏览器自动化访问 E10 接口，所有请求必须经 `weaver-work-cli archive-oa`。
+- 禁止在业务入参中传入 Cookie、ETEAMSID、Token、账号密码或内部控制字段。
+- 禁止手工构造或复用 `continuation`；写操作只用 `prepare` 返回的票据。
+- 禁止把泛微与契约锁的 `passid` / `listId` / `esbActionIds` / `objId` / `fb` 交叉混用。
+- 结果为 `partial` / `write_uncertain` 时停止，不自动重放写请求。

package/skills/weaver-e10-archive-oa/references/qys-contract-search.md

@@ -0,0 +1,47 @@
+# 契约锁协作采纳（案例）合同查询
+
+`archive-oa.qys.contract.list`：查询契约锁协作采纳（用户常称「案例」）的合同列表。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive-oa run archive-oa.qys.contract.list --input-json '{"pageNo":1}'
+weaver-work-cli archive-oa qys list
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive-oa run archive-oa.qys.contract.list --input-json '{"pageNo":1}'
+weaver-work-cli archive-oa qys list
+```
+
+## 输入
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `pageNo` | integer | 否 | 页码，从 1 开始，缺省 1 |
+| `fields` | array | 否 | 搜索条件数组，元素 `{ field, conditionType, value }` |
+| `matchType` | string | 否 | `and`（默认）或 `or` |
+| `archivedOnly` | boolean | 否 | 默认 `true`：附加 `cljd=已归档`（处理进度=已归档）过滤；传 `false` 可查询全部进度 |
+
+契约锁与泛微是两套独立应用，`passid` / `listId` / `cusMenuId` 各不相同；搜索字段配置接口（`showFilters`）源资料未收录，字段名不确定时**先用泛微 `archive-oa.contract.fields` 的字段规则参考，并提示用户确认**。
+
+## 输出处理
+
+- 行数据在 `rows`，列定义见 `meta.columns`。
+- `rows[].id` 静默缓存供 `archive-oa.qys.borrow-car.add.prepare` 的 `dataIds` 使用，不展示给最终用户。
+- `archivedOnly` 为 `true` 而结果为空时，提示可改为 `false` 查询全部处理进度，不要直接判定为无数据。
+- **展示列固定为 8 列**（与契约锁列表页一致，其余字段一律不展示）：合同号 `hth`、企业名称 `qymc`、最终客户名称 `zzyhmc`、签订日期 `qyrq`、产品名称 `cpmc`、客户所在省份 `khszsf`、区域 `tjrbm`、所属行业 `szxy`。**契约锁与泛微字段名不同**（签订日期是 `qyrq` 而非 `qdrq`），不要套用泛微字段名；契约锁搜索字段配置（`showFilters`）源资料未收录，筛选字段名不确定时先向用户确认。
+- **禁止翻页**：只查询 `pageNo=1`，**不得请求 `pageNo≥2`**、不做循环翻页累加；单次最多展示 20 条。命中超过 20 条时说明总数，并提示用户缩小筛选条件，**不得通过翻页获取更多数据**。
+- 结果默认用 Markdown 表格输出（第一列「序号」从 1 递增，分隔行 `| :---: |` 居中）。
+
+## 失败处理
+
+| 场景 | 处理 |
+| --- | --- |
+| `authentication` / `session_expired` | 停止并让用户重新登录 |
+| 字段名不确定 | 先向用户确认字段内部名，不猜测 |
+| 用户说「案例」 | 走本链路；用户说「商务合同」而未指明来源时，先确认泛微还是契约锁 |