weaver-work-cli 0.1.29 → 0.1.32

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 | 方法 | 路径 | 关键输入 |

package/skills/weaver-e10-jinchengda/references/contract-workflow-discovery.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 从会话注入。
-
-
-用途：把"流程名称""字段名称""选项名称"等人类语义，解析成运行时可用的 `workflowId`、`fieldId`、`optionId`。全部为 `read`。
-
 ## operation 与接口
 
 | operation | 方法 | 路径 | 关键输入 |