weaver-work-cli 0.1.1 → 0.1.4

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

@@ -0,0 +1,52 @@
+# 借阅车
+
+## 什么时候读取
+
+用户要查看借阅车、要把检索结果加入借阅车时读取本文件。加入借阅车是**免确认写操作**，直接调用即可，不需要高风险确认链。
+
+## Operation
+
+| 想做什么 | Operation | 必填输入 |
+| --- | --- | --- |
+| 查看列表 | `archive.borrow-car.list` | 可选 `pageNo`（默认 1）、`pageSize`（默认 10） |
+| 加入借阅车（免确认） | `archive.borrow-car.add` | `formAndIds`（`[{ formId, ids: [...] }]`） |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.borrow-car.list --input-json '{"pageNo":1,"pageSize":10}'
+
+weaver-work-cli --json archive run archive.borrow-car.add --input-json '{"formAndIds":[{"formId":"1190991330335571989","ids":["1252600626189156465"]}]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.borrow-car.list --input-json '{"pageNo":1,"pageSize":10}'
+
+weaver-work-cli --json archive run archive.borrow-car.add --input-json '{"formAndIds":[{"formId":"1190991330335571989","ids":["1252600626189156465"]}]}'
+```
+
+## 结果展示（默认样式限定：表格）
+
+借阅车列表给用户时**一律用 Markdown 表格渲染**，不要用卡片、普通编号列表或 JSON：
+
+| 序号 | 题名 | 类型 | 分类 | 形成日期 |
+| :---: | :---: | :---: | :---: | :---: |
+| 1 | …（超长省略） | 电子原文 | 销售合同 | 2025-06-27 |
+
+- 列取 `title` / `className` / `categoryNames` / `fileDate` 等可读字段，最多先给 10 条；不要把 `dataId`、`arcDangan` 等内部 ID 作为展示列。
+- 表格样式：所有列（表头与内容）居中显示。
+- 无值列留空或用 `-`；题名过长时截断。
+
+## 列表字段
+
+- 首选自定义接口，返回 `title`（题名）、`categoryNames`（分类）、`className`（类型）、`archivalCode`（档号）等可读字段，以及 `dataId`、`arcDangan`（`{档案ID}_{表单ID}`）供后续操作复用。
+- 自定义接口未发布时 CLI 自动回退 ebuilder 链路，行内提供 `fields`/`display`，可读字段更少；此时不要向用户解释内部链路差异，直接按可读字段展示。
+- 列表展示不依赖全宗信息，不要把全宗字段作为展示列；全宗只在预归档上传时需要查询。
+
+## 注意
+
+- `archive.borrow-car.add` 是**低风险写操作，不需要 prepare / apply / 用户确认链**；用户表达“加入借阅车/加入车/收藏”意图后直接提交，执行完用 `archive.borrow-car.list` 复核即可。
+- `formAndIds` 必须按 `formId` 分组且 `ids` 非空；同表单的多个档案合并到同一组，不要一条一组地重复提交。
+- 加入借阅车是写操作，出现网络中断或结果不确定时按 `partial/write_uncertain` 决策树处理，不要自动重放。

package/skills/weaver-e10-wenshuding/references/archive-borrow-list.md

@@ -0,0 +1,52 @@
+# 借阅单
+
+## 什么时候读取
+
+用户要查看自己的借阅单、要看借阅单明细、要为下载或续借准备参数时读取本文件。
+
+## Operation
+
+| Operation | 必填输入 | 说明 |
+| --- | --- | --- |
+| `archive.borrow-list.list` | 可选 `pageNo`（默认 1）、`pageSize`（默认 10） | 借阅单列表，含 `dataId`、`workflowId`、借阅/归还时间、状态与是否超期 |
+| `archive.borrow-list.detail` | `dataId` | 借阅单详情，含明细的原文借阅方式与可下载判定 |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.borrow-list.list --input-json '{"pageNo":1,"pageSize":10}'
+
+weaver-work-cli --json archive run archive.borrow-list.detail --input-json '{"dataId":"1302806508947652629"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.borrow-list.list --input-json '{"pageNo":1,"pageSize":10}'
+
+weaver-work-cli --json archive run archive.borrow-list.detail --input-json '{"dataId":"1302806508947652629"}'
+```
+
+## 结果展示（默认样式限定：表格）
+
+借阅单列表给用户时**一律用 Markdown 表格渲染**，不要用卡片、普通编号列表或 JSON：
+
+| 序号 | 题名 | 借阅时间 | 归还时间 | 归还状态 | 是否超期 |
+| :---: | :---: | :---: | :---: | :---: | :---: |
+| 1 | …（超长省略） | 2026-08-01 | 2026-08-31 | 借阅中 | 否 |
+
+- 列取借阅单返回的可读字段（题名、借阅/归还时间、状态、`expired` 等），最多先给 10 条；不要把 `dataId`、`workflowId` 等内部 ID 作为展示列。
+- 表格样式：所有列（表头与内容）居中显示。
+- 无值列留空或用 `-`；题名过长时截断。
+
+## 字段复用
+
+- `dataId` 是借阅单主表 ID，用于查看详情、下载和续借。
+- `workflowId` 是流程 requestId，下载打包任务需要；CLI 会自动取用，Agent 不需要手工传。
+- 列表行带 `expired`（是否已超期）；详情带 `downloadable`（是否存在可下载电子原文）与 `borrowTypes`。
+
+## 注意
+
+- 列表同样优先自定义接口，未发布时自动回退 ebuilder 链路，回退行提供 `fields`/`display`。
+- 借阅单状态以“借阅时间/归还时间/是否超期/归还状态”等可读字段展示；不要把 `workflowId` 等内部 ID 直接展示给用户。
+- 下载前必须先确认未超期且存在可下载原文，这一步由 `archive.borrow-list.download.prepare` 统一校验，不要跳过。

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

@@ -0,0 +1,22 @@
+# 暂未暴露的能力
+
+## 什么时候读取
+
+用户要求的能力在 `archive schema` 中找不到，或需要用 CLI 直接替代页面操作时读取本文件。
+
+## 当前不暴露的能力
+
+| 能力 | 原因 | 处理建议 |
+| --- | --- | --- |
+| 借阅申请表单提交 | 借阅表单字段结构、必填项与提交契约尚未固化为稳定接口 | 用 `archive.flow.*` 生成流程创建页 URL，让用户在浏览器中完成填写与提交 |
+| 借阅车移除 | 缺少移除接口的请求契约与权限回查方式 | 引导用户在借阅车页面操作 |
+| 借阅单归还/催还 | 缺少归还与催还接口的稳定契约 | 引导用户在借阅单页面操作 |
+| 档案条目新增/编辑 | 档案著录表单字段多且随门类变化 | 引导用户在档案管理页面操作 |
+| 水印/签批件单独处理 | 水印与签批件关系由服务端在打包时处理 | 用 `archive.borrow-list.download.*` 下载整体 zip |
+
+## 处理原则
+
+- 不要用 `archive run` 调用 schema 中不存在的 operation；未知 operation 会返回 `validation/operation_unknown`。
+- 不要绕过 CLI 直接调用 E10 `/api/archive/**`、`/api/ebuilder/**` 或 `/api/file/**` 接口。
+- 不要读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
+- 确认确实缺少能力时，向用户说明当前边界并给出页面操作路径，不要伪造成功结果。

package/skills/weaver-e10-wenshuding/references/archive-download.md

@@ -0,0 +1,48 @@
+# 借阅单原文下载
+
+## 什么时候读取
+
+用户要下载借阅单里的电子原文（zip）时读取本文件。写操作前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
+
+## Operation
+
+| 阶段 | Operation | 必填输入 |
+| --- | --- | --- |
+| 准备下载 | `archive.borrow-list.download.prepare` | `dataId`；可选 `exportType`、`exportStructure`、`groupField`、`documentField`、`output` |
+| 确认下载 | `archive.borrow-list.download.apply` | `continuation`、`confirm=true` |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.borrow-list.download.prepare --input-json '{"dataId":"1302806508947652629"}'
+
+weaver-work-cli --json archive run archive.borrow-list.download.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.borrow-list.download.prepare --input-json '{"dataId":"1302806508947652629"}'
+
+weaver-work-cli --json archive run archive.borrow-list.download.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+分组导出示例（按条目导出，条目分组字段用档号）：
+
+```json
+{"dataId":"1302806508947652629","exportType":"1","exportStructure":"0","groupField":"archival_code","documentField":""}
+```
+
+## 执行过程
+
+1. `.prepare` 校验两项前置条件：未超期、存在可下载电子原文；任一不满足直接报错，不要绕过。
+2. `.apply` 提交异步打包任务，每 2 秒轮询一次进度，完成后取文件 ID 下载 zip。
+3. 默认保存到当前用户的「下载」目录，文件名由服务端返回；已存在同名文件时自动加序号，不覆盖已有文件。
+4. 返回 `savedPath`、`fileName`、`fileId`、`size`；把保存路径告诉用户。
+
+## 注意
+
+- 下载是异步任务，`.apply` 可能持续一段时间；进度只在终端以进度条形式反馈，Agent 不要因为等待就中断并重试。
+- 打包完成前中断会浪费一次服务端任务；中断后如需继续，重新执行 `.prepare` 再 `.apply`。
+- 涉及本地文件写入：下载到的 zip 可能包含敏感档案内容，**必须先提醒用户文件内容会落到本地磁盘并可能进入当前大模型上下文，等待用户明确确认后才执行 `.apply`**。
+- `exportType=0`（直接导出）时其余三个分组字段必须为空；`exportType=1` 时按结构补齐分组字段，字段取值只能取档案基础字段候选。

package/skills/weaver-e10-wenshuding/references/archive-flow.md

@@ -0,0 +1,46 @@
+# 发起借阅与续借
+
+## 什么时候读取
+
+用户要从借阅车发起借阅、要从检索结果直接发起借阅、或要为借阅单续借时读取本文件。写操作前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
+
+## Operation
+
+| 场景 | 准备 | 确认 |
+| --- | --- | --- |
+| 从借阅车发起借阅 | `archive.flow.borrow-car.prepare`（`arcIds`、`carIds`，两者数量必须一致） | `archive.flow.borrow-car.apply` |
+| 从检索结果发起借阅 | `archive.flow.search.prepare`（`arcIds`） | `archive.flow.search.apply` |
+| 借阅单续借 | `archive.flow.renew.prepare`（`dataId`） | `archive.flow.renew.apply` |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.flow.borrow-car.prepare --input-json '{"arcIds":["1252600626189156465_1190991330335571989"],"carIds":["1302754028599656449"]}'
+
+weaver-work-cli --json archive run archive.flow.borrow-car.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+
+weaver-work-cli --json archive run archive.flow.renew.prepare --input-json '{"dataId":"1302806508947652629"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.flow.borrow-car.prepare --input-json '{"arcIds":["1252600626189156465_1190991330335571989"],"carIds":["1302754028599656449"]}'
+
+weaver-work-cli --json archive run archive.flow.borrow-car.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+
+weaver-work-cli --json archive run archive.flow.renew.prepare --input-json '{"dataId":"1302806508947652629"}'
+```
+
+## 参数来源
+
+- `arcIds`：档案标识数组，元素为 `{档案ID}_{表单ID}`。从借阅车取 `arcDangan[*].id`，从检索结果取 `id` + `formId` 拼接。
+- `carIds`：借阅车记录 ID 数组，取借阅车行的 `dataId`，与 `arcIds` 一一对应。
+- 续借只用 `dataId`（借阅单主表 ID），不需要缓存参数。
+
+## 注意
+
+- `.prepare` 会检查是否绑定借阅流程；未绑定时返回 `validation/borrow_flow_unbound`，应提示联系管理员在档案设置中绑定借阅流程，不要重试。
+- `.apply` 返回的是**流程创建页 URL**，CLI 不自动打开浏览器。Agent 拿到 URL 后**默认用系统默认浏览器打开**供用户填写提交（macOS `open`，Windows `start`），除非用户明确要求“在 IDE 内置浏览器打开”；不要声称“已发起借阅申请”。
+- 从借阅车发起会缓存档案与借阅车两组参数（两次缓存写入），从检索结果发起只缓存档案，续借不缓存。
+- URL 中的缓存参数由服务端生成，Agent 不要手工拼接或改写 URL。

package/skills/weaver-e10-wenshuding/references/archive-fonds.md

@@ -0,0 +1,34 @@
+# 全宗与预归档电子文件库节点
+
+## 什么时候读取
+
+需要确定档案所属全宗、需要预归档上传的 `treeId`，或用户提到“全宗/收集库/管理库/预归档库”时读取本文件。
+
+## Operation
+
+| Operation | 必填输入 | 说明 |
+| --- | --- | --- |
+| `archive.fonds.list` | 无；可选 `menuSign`（`collectLib`/`manageLib`，默认 `collectLib`） | 返回全宗 `id`、`fonds_name`、`fonds_code` 等 |
+| `archive.prelib.tree` | 无 | 返回预归档树中识别出的电子文件库节点（`id` 形如 `{appId}_{appId}`） |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.fonds.list --input-json '{"menuSign":"collectLib"}'
+
+weaver-work-cli --json archive run archive.prelib.tree --input-json '{}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.fonds.list --input-json '{"menuSign":"collectLib"}'
+
+weaver-work-cli --json archive run archive.prelib.tree --input-json '{}'
+```
+
+## 注意
+
+- 全宗 `id` 是后续上传（`archive.upload.prelib.prepare` 的 `fondsId`）和档案树查询的输入，必须原样复用，不要用 `fonds_code` 代替。
+- 电子文件库节点 `id` 即上传用的 `treeId`。`archive.prelib.tree` 只返回识别出的电子文件库节点；存在多个时必须让用户明确选择后再传 `treeId`，不要自行猜测。
+- 用户没有说明收集库/管理库时，默认使用 `collectLib`；只有在用户明确提到管理库时才传 `manageLib`。

package/skills/weaver-e10-wenshuding/references/archive-info.md

@@ -0,0 +1,33 @@
+# 档案基本信息
+
+## 什么时候读取
+
+需要查看单条档案的年度/案卷号/起止件号/文件日期/保管期限/密级/库位等基本信息时读取本文件。
+
+## Operation
+
+| Operation | 必填输入 | 说明 |
+| --- | --- | --- |
+| `archive.info.get` | `arcDangan`（`{档案ID}_{表单ID}`）或 `dataId` + `formId` | 返回档案基本信息行 |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.info.get --input-json '{"arcDangan":"1252600626189156465_1190991330335571989"}'
+
+weaver-work-cli --json archive run archive.info.get --input-json '{"dataId":"1252600626189156465","formId":"1190991330335571989"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.info.get --input-json '{"arcDangan":"1252600626189156465_1190991330335571989"}'
+
+weaver-work-cli --json archive run archive.info.get --input-json '{"dataId":"1252600626189156465","formId":"1190991330335571989"}'
+```
+
+## 注意
+
+- `arcDangan` 与 `dataId`+`formId` 二选一即可，两者都在时以 `arcDangan` 为准。
+- `arcDangan` 必须严格是 `{档案ID}_{表单ID}` 的数字 ID 对，格式错误会返回 `validation/arc_id_invalid`，此时不要重试，先修正输入。
+- 返回的库位、密级、保管期限等字段用于向用户说明档案状态；不要把内部字段直接暴露给终端用户。

package/skills/weaver-e10-wenshuding/references/archive-search.md

@@ -0,0 +1,52 @@
+# 全文检索可借档案
+
+## 什么时候读取
+
+用户要按关键词查找档案、要为“加入借阅车/发起借阅”准备档案标识时读取本文件。
+
+## Operation
+
+| Operation | 必填输入 | 说明 |
+| --- | --- | --- |
+| `archive.search.run` | `key`；可选 `pageNo`（从 0 开始，默认 0）、`pageSize`（默认 10）、`type1`、`type2` | 返回命中行的 `id`、`formId`、`title`、`content` 等 |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.search.run --input-json '{"key":"会计凭证","pageNo":0,"pageSize":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.search.run --input-json '{"key":"会计凭证","pageNo":0,"pageSize":10}'
+```
+
+## 结果展示（默认样式限定：卡片视图）
+
+检索命中结果的**默认返回显示样式是「卡片视图」**：标题可点击、每条固定三段（`序号.【类型】 可点击题名` / 命中高亮 / `全宗·分类·日期`）。除用户明确要求 text / html / 表格等其他样式外，一律用本样式，不要退化成普通表格或贴 JSON。直接让 CLI 渲染卡片即可（自动注入当前 baseUrl）：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli archive search --key 会计凭证 --page-size 10 --format card
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli archive search --key 会计凭证 --page-size 10 --format card
+```
+
+`--format` 还支持 `text`（终端纯文本）与 `html`（可 `--output <path>` 落 HTML 文件）；不带 `--format` 时默认输出 JSON envelope，仅供后续 operation 取参数用。
+
+## 结果复用
+
+- 结果行的 `id` 是档案数据 ID，`formId` 是所属表单 ID；两者组合成 `{档案ID}_{表单ID}`，可直接用于 `archive.info.get`、`archive.flow.search.prepare` 的 `arcIds`。
+- 加入借阅车时按 `formId` 分组：`formAndIds: [{ formId, ids: [档案ID...] }]`，同表单的多条档案合并到一组。
+
+## 注意
+
+- 检索结果只用于展示和用户选择；不要把内部 ID 当作最终展示内容，也不要让用户手工背诵 ID。
+- 用户没有要求全量时不要自动翻页到底；先取 `pageSize=10`，按 `pageNo` 继续。
+- 只看摘要不足以判断可借性时，再用 `archive.info.get` 查看档案基本信息。

package/skills/weaver-e10-wenshuding/references/archive-upload.md

@@ -0,0 +1,41 @@
+# 预归档上传
+
+## 什么时候读取
+
+用户要把本地文件上传到预归档电子文件库时读取本文件。写操作前也读取共享高风险协议：`../../weaver-e10-shared/references/high-risk-write.md`。
+
+## Operation
+
+| 阶段 | Operation | 必填输入 |
+| --- | --- | --- |
+| 准备上传 | `archive.upload.prelib.prepare` | `file`、`fondsId`；可选 `treeId` |
+| 确认上传 | `archive.upload.prelib.apply` | `continuation`、`confirm=true` |
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.upload.prelib.prepare --input-json '{"file":"./档案.pdf","fondsId":"1042286256822697531"}'
+
+weaver-work-cli --json archive run archive.upload.prelib.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.upload.prelib.prepare --input-json '{"file":"./档案.pdf","fondsId":"1042286256822697531"}'
+
+weaver-work-cli --json archive run archive.upload.prelib.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 前置参数
+
+- `fondsId` 取 `archive.fonds.list` 返回的全宗 `id`（不是 `fonds_code`）。
+- `treeId` 取 `archive.prelib.tree` 返回的电子文件库节点 `id`；不传时 CLI 自动取唯一节点，存在多个节点会要求显式传入。
+- `file` 是本地文件路径，CLI 会校验存在性、非空和大小上限（200MB）。
+
+## 注意
+
+- 涉及附件、图片、本地文件：执行前必须提醒用户，**文件内容会被上传到 E10 文书定档案系统，并可能进入当前大模型上下文**用于理解和处理；必须等待用户明确确认后才调用 `.apply`。用户仅提供文件路径或文件名不等于同意上传。
+- 目标全宗和电子文件库节点必须明确；`archive.prelib.tree` 返回多个电子文件库节点时，先让用户选择再上传，不要自行猜测。
+- 上传链路为 `preUploadCheck` → `module/upload` → `saveFile`；任一步失败会直接报错，不要自动重放 `.apply`。
+- 默认不覆盖、不删除本地文件；上传成功后返回 `fileId`、`docId`、`fileName`、`treeId`、`fondsId`。