weaver-work-cli 0.1.28 → 0.1.31

package/skills/weaver-e10-jinchengda/references/contract-clause-library-crud.md

@@ -0,0 +1,111 @@
+# 条款库 CRUD（分类 / 条款 / 条款组）
+
+## 强制鉴权门（不可跳过）
+
+`GET /api/ebd/contract/component/checkPermissionV2?moduleFlag=termComponent`
+
+- 放行依据**只有** `data.checkPermission === true`。
+- `hasLicense` / `privateDeploy` / `isRelease` 是环境信息，不作为放行依据。
+- 未放行时 CLI 返回 `policy/clause_no_permission`（退出码 6），并**在发起任何条款库接口之前**中止。
+- 本模块所有条款库 operation（含查询类）都会先过这道门，每个 CLI 进程各查一次。
+
+## operation 一览
+
+| operation | 方法 | 路径 | 说明 |
+|---|---|---|---|
+| `contract.clause.permission` | GET | `/component/checkPermissionV2` | 显式鉴权并返回能力信息 |
+| `contract.clause.types` | GET | `/tree/queryAllCluseType` | 分类类型（`clauseType` 取值） |
+| `contract.clause.check` | GET | `/clauseinfo/checkData` | 判重，**只传 `clauseName` + `belongId`** |
+| `contract.clause.browser` | POST | `/clauseinfo/common/browser/data/clauseInfoBrowser` | 按名称检索条款拿 id（条款组要用） |
+| `contract.clause.subcompany` | POST→GET | `/api/hrm/common/browser/data/subcompany` → `/api/hrm/common/getOrgTree` | 检索分部（500 自动降级） |
+| `contract.clause.category.create/update/delete.prepare/apply` | POST | `/tree/save`、`/tree/update`、`/tree/deletebyid` | 分类写操作 |
+| `contract.clause.create/update/delete.prepare/apply` | POST | `/clauseinfo/save`、`/update`、`/deletebyid` | 条款写操作 |
+| `contract.clause.group.create/update/delete.prepare/apply` | POST | `/clausegroup/save`、`/update`、`/deletebyid` | 条款组写操作 |
+
+所有写操作都是 `prepare → apply`：`prepare` 返回脱敏 `preview` 与 `continuation`（10 分钟有效），`apply` 必须带 `continuation` 与 `confirm: true`。
+
+## 必填字段与已知陷阱
+
+### 分类（tree）
+
+- **不要传 `clauseType`**（文档有误，传了会 500）。
+- `levelNum` 从 0 起：顶层 `parentId=0` 时固定 `levelNum="0"`；子分类必须显式传 `levelNum`（父级 +1）。
+- **删除会级联**：即使分类下仍有条款也会直接删掉并级联删除条款。`prepare` 会先查该分类下条款数量并在 `precheck.warning` 中提示。
+
+### 条款（clauseinfo）
+
+- `clauseNum` **必传**：漏传服务端不报错、直接存空编号（静默失败）。CLI 在前置校验拦截，回读时再校验一次编号是否真的落库。
+- `clauseVersion`（如 `V1.0`）与 `clauseGroup`（无所属组传 `"-1"`）**必传**，缺失服务端 500。
+- `contractType` 与 `contractTypeName` **必须成对**：只传 id 会让页面合同类型名缺失。
+- 判重依据是**名称 `clauseName`**，不是编号或内容；`checkData` 缺 `belongId` 会静默返回「不存在」，CLI 已强制两个参数。
+- 部分环境 `getListPage` 只接受 GET；CLI 回读统一用 GET。
+
+### 条款组（clausegroup）
+
+- `clauseContent` **必传**：逗号分隔的条款 id（先用 `contract.clause.browser` 取 id）。
+- `belongSub` **必传字符串**：未指定分部时传空字符串 `""`，缺失服务端 500。
+- `contractType` / `contractTypeName` 同样成对。
+- `checkData` 结果不可信（存在的组名也返回「不存在」），CLI 只用 `getListPage` 比对，不调用该判重接口。
+- `save` 报 500 **不等于未写入**：CLI 会把 500 当作失败，但请在排查后隔一段时间用 list 复核。
+
+## 处理链
+
+新增条款：
+
+1. `contract.clause.tree` 取分类 `belongId`；`contract.clause.types` 取 `clauseType` 候选（仅展示，不提交）。
+2. `contract.clause.check`（`clauseName` + `belongId`）确认不重名。
+3. 需要合同类型时先 `contract.type.tree` 取 id 与名称。
+4. `contract.clause.create.prepare` -> 向用户展示 `preview` -> `contract.clause.create.apply`。
+5. 读 `readback` 的 `clauseNum` 确认编号已落库。
+
+新增条款组：
+
+1. `contract.clause.browser` 按名称检索条款，命中多条必须让用户选。
+2. 需要分部时 `contract.clause.subcompany`；不需要则 `belongSub: ""`。
+3. `contract.clause.group.create.prepare` -> `apply` -> 回读 `getListPage`。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.clause.permission
+weaver-work-cli --json contract run contract.clause.check --input-json '{"clauseName":"验收条款","belongId":"1312751458535100769"}'
+weaver-work-cli --json contract run contract.clause.create.prepare --input-json '{"clauseName":"验收条款","clauseNum":"TK002","clauseContent":"乙方应于交付后5个工作日内完成验收。","belongId":"1312751458535100769","clauseVersion":"V1.0","clauseGroup":"-1"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.clause.permission
+weaver-work-cli --json contract run contract.clause.check --input-json '{"clauseName":"验收条款","belongId":"1312751458535100769"}'
+weaver-work-cli --json contract run contract.clause.create.prepare --input-json '{"clauseName":"验收条款","clauseNum":"TK002","clauseContent":"乙方应于交付后5个工作日内完成验收。","belongId":"1312751458535100769","clauseVersion":"V1.0","clauseGroup":"-1"}'
+```
+
+## 成功判据与复核
+
+- 业务成功：`code = 200`（或 `0`）且 `status !== false`、`fail !== true`。
+- **假成功普遍存在**：删除对不存在的 id 也会返回成功。CLI 在 `apply` 后强制回读：
+  - 条款按 `clauseName` + `belongId` 查 `getListPage`
+  - 条款组按 `clauseName` 查 `getListPage`
+  - 分类查 `tree/queryList`
+- 回读不通过一律返回 `partial/write_uncertain`（退出码 11），禁止自动重试。
+
+## 页面
+
+每次条款库操作后打开 `{baseUrl}/sp/contract/terms-library?tab=1` 供用户确认（查询类也要打开）。
+
+## 错误处理
+
+| 现象 | 处理 |
+|---|---|
+| `clause_no_permission` | 立即中止，告知「暂无权限访问条款库」，不重试、不换接口 |
+| `input_invalid`（clauseNum） | 补齐条款编号，不要依赖服务端默认 |
+| `clause_group_required` | 补 `clauseGroup`，无组传 `"-1"` |
+| `contract_type_pair_required` | 同时补 `contractType` 与 `contractTypeName` |
+| `belong_sub_required` | 补 `belongSub`，不分部传 `""` |
+| `clause_already_exists` | 同名条款已存在，提示用户改名或改为修改已有条款 |
+| `category_not_found` | 分类已不存在，重新拉树确认 |
+| 500（save/update） | 核对必填字段；带齐仍 500 可能是系统侧故障，隔一段时间 list 复核 |
+| `partial/write_uncertain` | 停止，用 list 复核，不自动重放写请求 |
+| `session_expired` | 停止并按共享规则重新登录 |

package/skills/weaver-e10-jinchengda/references/contract-clause-recommender.md

@@ -1,20 +1,5 @@
 # 条款查询与推荐
 
-## 请求头 / 认证
-
-本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
-
-| 请求头 | 值 |
-|--------|-----|
-| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
-| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
-| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
-
-业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
-
-
-用途：按标签、分类或关键词查找合同条款，供用户挑选。五个 operation 全部为 `read`。
-
 ## operation 与接口
 
 | operation | 方法 | 路径 | 关键输入 |

package/skills/weaver-e10-jinchengda/references/contract-clause-reference-save.md

@@ -1,18 +1,5 @@
 # 条款引用：查询与写入（本模块唯一条款写操作）
 
-## 请求头 / 认证
-
-本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
-
-| 请求头 | 值 |
-|--------|-----|
-| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
-| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
-| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
-
-业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
-
-
 ## 查询：`contract.clause.reference.get`
 
 - 方法/路径：`POST /api/ebd/contract/clauseReference/selectData`

package/skills/weaver-e10-jinchengda/references/contract-credit-page.md

@@ -0,0 +1,50 @@
+# 企业资信查询（仅打开资信页）
+
+## operation
+
+| operation | 方法 | 关键输入 | 风险 |
+|---|---|---|---|
+| `contract.credit.page` | 无请求 | `names[]`（1~20 个企业全称） | read |
+
+## 主体名称规则
+
+- 必须使用**营业执照全称**；简称查不到。
+- 用户直接给出时，先判断是否像全称（含"有限公司/股份有限公司/集团"等）；不像就先问。
+- 从合同文件中抽取的主体，**必须先让用户确认全称**再查。
+- CLI 对少于 4 个字符的名称直接拒绝（`name_not_full`）。
+
+## URL 规则（硬约束）
+
+```text
+{baseUrl}/sp/contract/business/credit?name[0]={encodeURIComponent(名称1)}&name[1]={encodeURIComponent(名称2)}
+```
+
+- `name[N]` 索引从 **0** 开始。
+- **只对参数值做一次 `encodeURIComponent`**；`name[0]` 的方括号、`?`、`&`、`=` 保持字面。
+- 不要把整个 URL 再编码一次。
+
+## 处理链
+
+1. 确认主体全称。
+2. `contract.credit.page` 返回 `url` 与 `page`（`title: 资信查询`、`activate: true`、`width: 1000`）。
+3. 原样交给 `browsertool`。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.credit.page --input-json '{"names":["测试科技有限公司"]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.credit.page --input-json '{"names":["测试科技有限公司"]}'
+```
+
+## 边界
+
+- 不返回工商数据本身，也不做企业变更、企业监控。
+- 用户问"这家公司有没有诉讼/被执行/股权结构"时，说明当前只有资信页面入口，数据需在页面内查看。
+- `contract.credit.query` / `contract.credit.change` / `contract.credit.monitor` 在 `withheldOperations` 中，源资料缺少接口契约，**不要尝试用其它接口替代**。

package/skills/weaver-e10-jinchengda/references/contract-disabled-capabilities.md

@@ -4,7 +4,7 @@
 
 | 能力 | 源资料状态 | 处理方式 |
 |---|---|---|
-| `contract.credit.query`（相对方工商资信查询，CM-018） | `references/enterprise-credit/api-enterprise-credit.md` 只有 9 行索引，指向的 `api-credit-info.md`、`api-enterprise-change.md`、`api-monitor-config.md` 三个子文档在源资料中不存在 | 告知用户当前不可用；如确需使用，请先提供完整的接口文档 |
+| `contract.credit.query`（相对方工商资信**数据**查询） | 源资料 `references/enterprise-credit.md` 只描述「确认主体全称 → 拼资信页地址 → 打开页面」，没有任何工商数据接口的路径、方法、参数与响应结构 | 已提供页面入口 `contract.credit.page`；用户要数据明细时，说明需在打开的资信页内查看，或请用户补齐接口文档 |
 | `contract.credit.change`（企业变更查询） | 同上，接口文档缺失 | 同上 |
 | `contract.credit.monitor`（企业监控开启/修改） | 同上；且属于写操作，缺少确认与回查契约 | 同上；不得在未拿到契约前实现写操作 |
 | `contract.workflow.withdraw`（撤回/退回流程） | 源资料只提到"除非调用撤回/退回接口"，未给出路径、方法和参数 | 告知用户当前不可用；如需撤回请到 E10 前台操作 |
@@ -18,7 +18,9 @@
 ## 其它边界
 
 - 12 类合同审批流程（销售、采购、协议、变更、解除、关闭、开票、收款、付款、履约计划、进度提报、供应商准入）共用同一组接口；流程差异体现在运行时解析出的 `workflowId` 与表单字段，而不是不同的接口路径。
-- 企业资信与合同审批是两条互不相干的链：不要把"查一下某公司资信"路由到 `contract.request.*`。
+- 企业资信与合同审批是两条互不相干的链：不要把"查一下某公司资信"路由到 `contract.request.*`；资信能力目前只有页面入口 `contract.credit.page`。
+- 合同审查、文档比对、模板推荐同样是**独立链**：它们不上流程，不要串到 `contract.request.*`。
+- 合同审查报告 / 比对报告的文件生成（Markdown/HTML/Office）不在 CLI 范围，由 Agent 基于 `contract.review.export` / `contract.compare.diff` 的结构化结果在工作区生成。
 - 提交审批后流程不可撤回（撤回接口未实现），执行前必须让用户清楚这一点。
 
 ## 注意

package/skills/weaver-e10-jinchengda/references/contract-doc-compare.md

@@ -0,0 +1,74 @@
+# 合同文档比对
+
+## operation 与接口
+
+| operation | 方法 | 路径 | 关键输入 | 风险 |
+|---|---|---|---|---|
+| `contract.compare.upload` | POST ×2 | `/api/file/preUploadCheck` → `/api/file/module/upload` | `paths[]`（1~2 个，基准在前） | read-with-upload |
+| `contract.compare.search` | POST | `/api/doc/documents/list` | `keyword`、`pageNo`、`pageSize` | read |
+| `contract.compare.versions` | POST | `/api/file/base/upload/findVersionList` | `fileId`、`docId?`、`pageNo` | read |
+| `contract.compare.page` | — | 无请求，直接拼页面地址 | `baseFileId`/`baseFileName`/`compareFileId`/`compareFileName` | read |
+| `contract.compare.diff` | POST | `/api/ebd/contract/ai/getCompareRes` | `baseFileId`、`compareFileId` | read |
+
+上传 `module` 固定 `docCompared`（**不能**用 `ebContract` 或 `workflow`）。
+
+## 获取文件的三条途径
+
+- **A 上传本地文件**：`contract.compare.upload` 一次传 1~2 个文件，返回 `files[]` 的 `fileId` + `name`。
+- **B 检索系统内文件**：`contract.compare.search` 按名称检索。返回的 `documents[].id` 是**文档 ID，不是 fileId**，不能直接填进比对页；需再取文件信息或让用户确认。
+- **C 历史版本**：`contract.compare.versions` 取某文件的版本列表（`pageSize` 固定 100），选一个版本作为另一方。
+
+## 处理链
+
+1. 先确定 baseFile，再提示用户给 compareFile，两个都齐了才打开页面。
+2. `contract.compare.page` 返回 `url`，原样交给 `browsertool`，带 `"width": 1000`。
+3. 用户明确说"导出/生成比对报告/把差异结果给我"时，才调 `contract.compare.diff`。
+
+## URL 规则（硬约束）
+
+```text
+{baseUrl}/sp/contract/business/doc-compare?baseFileId=...&baseFileName=...&compareFileId=...&compareFileName=...&options[ignoreImages]=0&options[ignoreSpace]=1&options[ignorePageHeader]=0&options[ignorePunctuation]=1&options[conversionAngle]=0&options[conversionStyle]=0&options[conversionSpecialSymbols]=0&options[ignoreMark]=1&options[ignoreWatermark]=1&options[ignoreSeal]=1
+```
+
+`options` 固定默认值（用户未特别说明不要改）：忽略图片 0、忽略空格 1、忽略页眉页脚 0、忽略标点 1、全半角 0、繁简 0、特殊符号 0、忽略批注 1、忽略水印 1、忽略印章 1。
+
+- 不做整体编码，中文文件名与 `[]` 保持原样。
+
+## 差异结果
+
+`contract.compare.diff` 请求体两个字段都是**数组**，即使只有一个文件也不能传字符串：
+
+```json
+{ "baseFileIds": ["9000"], "compareFileIds": ["9001"] }
+```
+
+返回 `data.result`（`getCompareRes` 原始响应）。CLI 只返回结构化数据；需要 HTML 比对报告时由 Agent 基于结果生成，不要伪造差异。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.compare.upload --input-json '{"paths":["D:/contracts/原版.docx","D:/contracts/修订版.docx"]}'
+weaver-work-cli --json contract run contract.compare.search --input-json '{"keyword":"销售合同","pageNo":1,"pageSize":20}'
+weaver-work-cli --json contract run contract.compare.versions --input-json '{"fileId":"9001"}'
+weaver-work-cli --json contract run contract.compare.page --input-json '{"baseFileId":"9000","baseFileName":"原版.docx","compareFileId":"9001","compareFileName":"修订版.docx"}'
+weaver-work-cli --json contract run contract.compare.diff --input-json '{"baseFileId":"9000","compareFileId":"9001"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.compare.upload --input-json '{"paths":["/data/contracts/原版.docx","/data/contracts/修订版.docx"]}'
+weaver-work-cli --json contract run contract.compare.page --input-json '{"baseFileId":"9000","baseFileName":"原版.docx","compareFileId":"9001","compareFileName":"修订版.docx"}'
+```
+
+## 错误处理
+
+| 现象 | 处理 |
+|---|---|
+| `paths_too_many` | 一次最多 2 个文件 |
+| `upload_no_fileid` | 上传未完成，不要打开比对页 |
+| 检索命中多条 | **必须**展示候选（名称 + 目录 + 更新时间）请用户选，禁止自动取第一条 |
+| 把文档 ID 当 fileId | 比对页会打不开；回到途径 B 重新确认 `fileId` |
+| `session_expired` | 停止并按共享规则重新登录 |

package/skills/weaver-e10-jinchengda/references/contract-flow-launch.md

@@ -0,0 +1,84 @@
+# 发起合同流程（打开流程页 / 带文件自动回填）
+
+## 四个流程（必须由用户指定）
+
+| `flow` | 流程名 | workflowId | 上传 fieldId |
+|---|---|---|---|
+| `契约锁` | 契约锁合同审批流程 | `100003460000002066` | `100003720000025579` |
+| `新客户` | 新客户购买合同审批流程 | `1269716062340284522` | `1269716066559755048` |
+| `老客户增值` | 老客户增值合同审批流程 | `1283761429944369334` | `100003720000039590` |
+| `常规二次销售` | 常规二次销售合同审批流程 | `1283761687634100307` | `100003720000029309` |
+
+这些是**业务常量**（不是环境占位符）。用户未指定时必须先问，**不能替用户选择**；只有唯一模糊命中（如"常规二次"）才自动收敛。
+
+## operation 与接口
+
+| operation | 方法 | 路径 | 关键输入 | 风险 |
+|---|---|---|---|---|
+| `contract.flow.page` | — | 无请求，直接拼页面地址 | `flow` | read |
+| `contract.flow.launch` | POST ×3 | `/api/workflow/core/flowPage/loadBaseParam` → `/api/file/preUploadCheck` → `/api/file/module/upload` | `flow`、`path` | read-with-upload |
+
+## 处理链
+
+场景 A：用户只要打开流程页
+
+1. `contract.flow.page` 拿 `url`。
+2. 原样交给 `browsertool`，带 `"width": 1000`。
+
+场景 B：用户给了合同文件（**已提供文件不得二次询问**）
+
+1. `contract.flow.launch` 先调 `loadBaseParam`（`isCreate:1`，body 含 `workflowId`、`isMobile:0`）。
+2. 从 `requestInfo.requestId` 取 `requestId`；取不到就**在提交上传前**停止（`request_id_missing`），避免文件挂到错误流程。
+3. 上传 `module=workflow`，附加固定字段：
+
+| 字段 | 值 |
+|---|---|
+| `authModule` | `workflow` |
+| `source` | `form` |
+| `fieldId` | 该流程的 fieldId |
+| `sourceRefId` / `refId` | 同一个 `requestId` |
+| `folderId` | `300` |
+
+4. 返回带 `fileId` + `automaticFormFilling=true` 的流程页地址。
+
+## URL 规则
+
+```text
+{baseUrl}/sp/workflow/flowpage/create/{workflowId}?workflowId={workflowId}&isCreate=1
+{baseUrl}/sp/workflow/flowpage/create/{workflowId}?workflowId={workflowId}&isCreate=1&fileId={fileId}&automaticFormFilling=true
+```
+
+- 不做整体编码，中文与 `[]` 保持原样。
+- 不带 `fileId` 时**不要**加 `automaticFormFilling`。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.flow.page --input-json '{"flow":"新客户"}'
+weaver-work-cli --json contract run contract.flow.launch --input-json '{"flow":"契约锁","path":"D:/contracts/合同.docx"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.flow.page --input-json '{"flow":"新客户"}'
+weaver-work-cli --json contract run contract.flow.launch --input-json '{"flow":"契约锁","path":"/data/contracts/合同.docx"}'
+```
+
+## 与 `contract.request.*` 的分工
+
+- 本文件的 `contract.flow.*` 是**打开页面 / 带文件预填**，不创建流程实例、不保存表单、不提交审批。
+- 需要走完整审批链（创建 → 保存 → 提交 → 催办）时，按 [`contract-request-write.md`](contract-request-write.md) 使用 `contract.request.*` 的 `prepare → apply`。
+- 不要把"打开了流程页"报告成"流程已发起"。
+
+## 错误处理
+
+| 现象 | 处理 |
+|---|---|
+| `flow_unknown` | 列出四个 `flow` 取值请用户选择，不要猜 |
+| `request_id_missing` | 停止，检查流程是否启用、登录态是否有效 |
+| `file_type_unsupported` | 只接受 `.doc` / `.docx` |
+| `upload_no_fileid` | 上传未完成，不要拼 URL 打开页面 |
+| `session_expired` | 停止并按共享规则重新登录 |

package/skills/weaver-e10-jinchengda/references/contract-performance-query.md

@@ -0,0 +1,29 @@
+# 业绩核算：六菜单链接 + 来源台账只读查询
+
+对应 operation：`contract.performance.*`（8 个）。
+
+## 两条链路
+
+1. **过滤链接（不发起网络请求）**：`performance.link` / `performance.fields` / `performance.source.entry` 只做本地构造，六菜单（直销合同、直销业绩、合同收款、项目验收、渠道订单、渠道订单-商务）由内置 catalog 驱动。
+2. **实际数据（HTTP）**：`performance.menu.search` -> `performance.list.init`（校验 objId）-> `performance.list.filters` -> `performance.list.query`（getListDatas + getListDataCount 全页）。
+
+## 硬规则（与源资料对齐，违反即错）
+
+- `origin` 必须是完整 http/https 域名（与合同办公同一 baseUrl），不含 `{baseUrl}` 占位符。
+- **人员 / 枚举 / 数值条件一律进 `needs_ui`**：由用户在页面检索、选择、填写后搜索，AI 不代操作，也不控制浏览器。
+- **组合页（合同收款）不透传筛选 query**：`link` 只出入口地址，全部条件进 `needs_ui`；实际收款查询走 `performance.receipt.query`（底层 List，精确 eq）。
+- URL 参数名和值分别编码一次；`urlPageTitle` 的 `+` 必须是 `%2B`；ID 全程字符串。
+- `searchPermittedEbMenus` 请求体是**关键词字符串数组**，不是对象。
+- `listId` 每次查询前用 `list.init` 解析真实运行上下文并校验 `objId`；总数取 `getListDataCount` 的 `data.total`，不能用 getListDatas 里的 total。
+- 达到 `maxPages` 仍有剩余时结果带 `truncated: true` 与警告：缩小范围重查，不把部分结果当全量。
+- 前轮合同年份不自动变为收款年份；收款附加条件必须来自用户本轮明确要求。
+- 401/登录失效：停止并重新登录；403 是权限边界，如实说明并停止，不得靠重新登录绕过。
+
+## 返回结构
+
+`performance.link` 返回 `url` + `browsertool.arguments`（`width: 1000`）+ `filters` + `needs_ui` + `warnings` + `execution`（filtered-link / manual-page-filter）。`needs_ui` 是交给用户的待补填清单，逐项列出字段、比较符和值。
+
+## 边界
+
+- VIEWPORT/NList 分支未实现（customConfig 需平台 LZW 编码）；`pageType=VIEWPORT` 时说明缺口，不猜测组件。
+- 台账查询是只读的；不调用 /api/bs/、不做表单级全量查询、不新增接口。

package/skills/weaver-e10-jinchengda/references/contract-quote-to-contract.md

@@ -0,0 +1,28 @@
+# 报价单转合同（本地 xlsx/docx，零依赖）
+
+对应 operation：`contract.quote.*`（4 个）。xlsx/docx 均为本 CLI 内置 OOXML 读写，无需外部依赖。
+
+## 流程（顺序不可乱）
+
+1. `contract.quote.sheets`：列出 sheet 名，**由用户选择**，禁止自动选（第一个除外）。
+2. `contract.quote.parse`：输出 `meta`（客户/日期/经理/电话）、`totals`（标准价/最终优惠报价+大写）、`sections`（分节明细）、`checks`、`warnings`。
+3. 把 warnings/checks 给用户核对：明细求和≠表内合计、明细总计≠标准价、存在折扣（以最终优惠报价为准）、缺客户名称。
+4. **硬门禁：必须先拿到真实 .docx 合同模板**。取不到模板就停止并请用户提供；禁止把报价单内容直接渲染成一份合同。
+5. 用户确认数据后 `contract.quote.fill`：数据 JSON（可含 `__sections` 追加明细表）+ 模板 -> 输出 docx + filled/unfilled 映射日志（`mapOut`）。
+6. `unfilled` 非空时逐项给用户确认补值后重填；禁止编造任何未提供的值。
+
+## 字段识别（分层打分）
+
+100 别名精确 > 98 去括号精确 > 70~95 别名是标签子串 > 60 标签是别名子串 > 40 字符重合；`大写/小写` 硬约束（含"大写"只归 amount_upper）。表格空值格只认 **≥95** 的精确命中——签名栏（如"甲方（盖章）"85 分）不会自动填，留给用户手填。
+
+## 数值语义（防重复计价）
+
+- 纵向合并：文本列（名称/描述）每行都可继承；**数值列（单价/数量/金额）只归首行**——防止 20 万被重复计成 200 万。
+- 金额缺失时按 单价×数量（数量缺失视为 1）补算；数量 0 或金额 0 的未选购项默认不入合同（`includeZero` 可保留）。
+- 数值 key（amount 等）输出自动千分位；`contract.quote.rmb` 输出人民币大写（支持负数、零头、整）。
+
+## 模板填充行为
+
+- 具名占位符 `{{key}}` / `\${key}` / 【标签】 + 匿名空白（____ / 【】），填值以标签为准。
+- 改写策略：首个 w:t 写入新文本、其余清空；明细追加表自带边框，不依赖模板样式。
+- `detail=none` 跳过明细表追加。

package/skills/weaver-e10-jinchengda/references/contract-request-status.md

@@ -1,25 +1,5 @@
 # 审批状态与签字意见
 
-## 请求头 / 认证
-
-本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
-
-| 请求头 | 值 |
-|--------|-----|
-| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
-| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
-| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
-
-业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
-
-
-用途：查审批进度、查审批意见，以及写操作后的持久化回读。两个 operation 均为 `read`。
-
-| operation | 方法 | 路径 | 输入 |
-|---|---|---|---|
-| `contract.request.status` | GET | `/api/workflow/core/paService/v1/getRequestStatus` | `requestId`（必填）、`userid` 由 CLI 注入 query |
-| `contract.request.log` | GET | `/api/workflow/core/paService/v1/getRequestLog` | `requestId`（必填）、`otherParams`（分页 JSON 串，如 `{"pageSize":10,"pageNumber":1}`） |
-
 ## `flowStatus.code` 枚举（源资料原文）
 
 | code | 含义 |
@@ -40,7 +20,8 @@ Windows PowerShell（复杂入参写 UTF-8 文件后传 `--input`，不要在单
 
 ```powershell
 weaver-work-cli --json contract run contract.request.status --input-json '{"requestId":"67890"}'
-weaver-work-cli --json contract run contract.request.log --input .\request-log.json
+# otherParams 是嵌套 JSON 串，PowerShell 单引号内不能写反斜杠转义，改用 UTF-8 文件
+weaver-work-cli --json contract run contract.request.log --input request-log.json
 ```
 
 macOS/Linux（bash/zsh）：

package/skills/weaver-e10-jinchengda/references/contract-request-write.md

@@ -1,29 +1,5 @@
 # 合同审批流程：创建、保存、提交、催办（写操作）
 
-## 请求头 / 认证
-
-本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
-
-| 请求头 | 值 |
-|--------|-----|
-| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
-| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
-| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
-
-业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
-
-
-四个写操作全部是 `prepare -> apply` 两段，且必须分别报告每一步结果。
-
-| 动作 | prepare | apply | 路径 | 风险 |
-|---|---|---|---|---|
-| 创建流程实例 | `contract.request.create.prepare` | `contract.request.create.apply` | `POST /api/workflow/core/paService/v2/doCreateRequest` | write |
-| 保存表单 | `contract.request.save.prepare` | `contract.request.save.apply` | `POST /api/workflow/core/paService/v1/saveFormData` | write |
-| 提交审批 | `contract.request.submit.prepare` | `contract.request.submit.apply` | `POST /api/workflow/core/paService/v1/submitRequest` | high-impact |
-| 催办 | `contract.request.supervise.prepare` | `contract.request.supervise.apply` | `POST /api/workflow/core/paService/v1/requestSupervise` | high-impact |
-
-用户 ID 由 CLI 从会话注入：前三个接口注入 `userid`，催办接口注入 `userId`（源资料原文如此）。
-
 ## 创建流程实例
 
 - 输入：`workflowId`（必填）、`requestname`、`remark`、`isnextflow`（默认 0）、`isVerifyFormRequired`（默认 false）、`requestLevel`（默认 0）、`formData`、`isNewFormData`、`seniorFormParam`

package/skills/weaver-e10-jinchengda/references/contract-signing-subjects.md

@@ -1,20 +1,5 @@
 # 签约主体：定位与查询
 
-## 请求头 / 认证
-
-本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
-
-| 请求头 | 值 |
-|--------|-----|
-| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
-| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
-| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
-
-业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
-
-
-用途：查询我方、客户方或供应商签约主体。全部为 `read`。
-
 ## 调用链（每步只能用上一步运行时返回的 ID）
 
 ```

package/skills/weaver-e10-jinchengda/references/contract-subject-create.md

@@ -1,22 +1,5 @@
 # 新建签约主体（写操作）
 
-## 请求头 / 认证
-
-本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
-
-| 请求头 | 值 |
-|--------|-----|
-| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
-| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
-| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
-
-业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
-
-
-- operation：`contract.subject.create.prepare` -> `contract.subject.create.apply`
-- 方法/路径：`POST /api/ebuilder/form/dataset/v2/saveFormData`
-- 风险：`read-before-write` / `high-risk-write`
-
 ## 输入
 
 | 字段 | 必填 | 说明 |

package/skills/weaver-e10-jinchengda/references/contract-template-recommend.md

@@ -0,0 +1,70 @@
+# 合同模板 / 范文智能推荐
+
+## 触发场景
+
+- "我要卖一套 e-cology 给某公司，有推荐模板吗"
+- "签一份软件开发合同，100 万，有没有合适范文"
+- "信息化平台建设的采购合同模板推荐"
+
+判定：用户在**找模板/范文**，不是审查具体合同、也不是发起流程。
+
+## operation 与接口
+
+| operation | 方法 | 路径 | 关键输入 | 风险 |
+|---|---|---|---|---|
+| `contract.recommend.doc` | POST | `/api/ebd/contract/file/recommendContractDoc` | `content`（自然语言需求，≤4000 字） | read |
+
+固定业务常量（**禁止替换**）：
+
+| 常量 | 值 |
+|---|---|
+| `textObjId` | `1290191829260230657`（「合同范文管理」对象 ID） |
+
+## 请求与响应
+
+```json
+{ "content": "销售一套 e-cology 协同办公系统，含实施服务，金额 80 万", "textObjId": "1290191829260230657" }
+```
+
+成功判据：`code = 200`、`status = true`、`fail = false`（CLI 已按此判定）。关键取值：
+
+| 字段 | 用途 |
+|---|---|
+| `data.cacheKey` | 打开推荐结果页必带（形如 `contract_doc_recommend:xxx`） |
+| `data.recommendList[]` | 推荐列表，按 `rank` 排序 |
+
+`recommendList` 单项：`rank`、`file_name`、`match_score`、`match_reason`、`matched_fields`、`template_id`、`doc_id`、`file_id`、`classification_id`、`creator`/`updater`、`create_time`/`update_time`，以及 AI 提取标签 `extract_labels`（title / summary / contract_type / risk_level / amount_range / industry / scene / role / payment_terms / key_clauses / jurisdiction / tags）。
+
+CLI 已把上述字段映射成 `recommendations[]`（`fileName`、`matchScore`、`matchReason`、`matchedFields`、`labels.*`）。
+
+## 处理链
+
+1. `contract.recommend.doc` 传整理后的需求描述。
+2. **先用表格向用户展示**：排名 / 文件名 / 匹配分 / 合同类型 / 风险等级 / 匹配理由。
+3. 再打开结果页：`data.url` = `{baseUrl}/sp/contract/business/template-list?recommendKey={cacheKey}`，带 `"width": 1000`。
+4. `status = EMPTY` 表示没有匹配到范文，如实说明，不要编造模板名。
+
+耗时提示：服务端 AI 语义匹配本身需要 **30~40 秒**，CLI 超时设为 180 秒。**慢不是失败，不要重试、不要换接口**。
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json contract run contract.recommend.doc --input-json '{"content":"销售一套协同办公系统，含实施服务，金额80万"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json contract run contract.recommend.doc --input-json '{"content":"销售一套协同办公系统，含实施服务，金额80万"}'
+```
+
+## 错误处理
+
+| 现象 | 处理 |
+|---|---|
+| `recommend_cache_key_missing` | 接口没给 `cacheKey`，无法打开结果页；如实报失败，不要自行拼接 |
+| 超时（`network/timeout`） | 说明服务端匹配慢，询问用户是否再等一轮；不要连续重试 |
+| `code` 非 0/200 或 `status=false` | 按业务错误处理，不重试 |
+| `session_expired` | 停止并按共享规则重新登录 |

package/skills/weaver-e10-jinchengda/references/contract-template-selector.md

@@ -1,20 +1,5 @@
 # 合同类型与模板查询
 
-## 请求头 / 认证
-
-本文件描述的 API 请求通过 `weaver-work-cli` 执行，CLI 从 E10 登录会话自动注入以下凭证头（禁止业务输入携带）：
-
-| 请求头 | 值 |
-|--------|-----|
-| `Cookie` | `<e10-login 返回的完整原始 Cookie 串>`（禁止裁剪/去重/改写） |
-| `eteamsid` | `<e10-login 返回的 ETEAMSID>` |
-| `User-Agent` | `AgentType=<agentType>,IsAgent=true` |
-
-业务输入（`--input-json` / `--input`）**不得包含** `userid`、`userId`、`token`、`cookie`、`eteamsid` 等字段，用户 ID 由 CLI 从会话注入。
-
-
-用途：按合同类型定位可选模板，或对指定模板查看详情。四个 operation 全部为 `read`。
-
 ## operation 与接口
 
 | operation | 方法 | 路径 | 关键输入 |