weaver-work-cli 0.1.2 → 0.1.5

package/docs/fna.md

@@ -0,0 +1,72 @@
+# 齐业成费控中心（FNA）CLI
+
+对应 `src/shortcuts/fna`，把泛微齐业成 FNA 费控中心 11 个源接口固化为 13 个 operation（预算 2 / 费用中心 3 / 借款管理 4 / 发票核销 4，其中提醒还款与催票为 prepare/apply 写链）。源资料：`/Users/zhufangyuan/Desktop/weaver-e10-qiyecheng`（指纹见 `skills/weaver-e10-qiyecheng/references/source-manifest.json`）。
+
+## 公共前置
+
+- 认证、profile、HTTP client 由 `src/internal/e10` 托管；业务 host 只适配 `/api/fna/` 与 `/api/app/fna/` 路径（`src/shortcuts/fna/host.ts` 的 `assertPath` 白名单）。
+- 成功判定统一走 WeaResult（`success` 或 `status` 布尔 / `code==200`）；费用中心 AI 查询用 `success`，预算/借款/核销用 `status`。
+- JSON 输出与错误 envelope、退出码遵循共享规则；写操作不满足确认条件返回 `confirmation.required`（exit 10），请求发出后结果不确定返回 `partial/write_uncertain`（exit 11）。
+
+## Agent 入口
+
+面向 Agent 时先读 `skills/weaver-e10-qiyecheng/SKILL.md`，再按入口路由读取 `references/`（catalog/budget/expense-center/loan-management/invoice-writeoff）。
+
+## Operation 目录
+
+| Operation | 风险 | 固定规则与要点 |
+|---|---|---|
+| `fna.budget.application.detail` | read | GET `preApplication/getApplicationDetail`；`requestId` 必填 |
+| `fna.budget.execute.list` | read | POST `execute/getExecuteListByAi`；`current`/`pageSize` 必填；`templateId` 空仅返回表头 |
+| `fna.expense.reimbursed.sum` | read | POST `expense/center/getSumReimbursedAmountByAi`；body 可空 |
+| `fna.expense.loan.sum` | read | POST `expense/center/getSumLoanAmountByAi`；只认数字 ID；空 data 自动重试 2 次；已知仅统计首条记录缺陷 |
+| `fna.expense.prepay.writeoff.sum` | read | POST `expense/center/selectPrepayWriteOffAmountBySkill`；body 可空 |
+| `fna.loan.main.page` | read | POST `loanManagementMenu/mainPage` |
+| `fna.loan.main.list` | read | POST `loanManagementMenu/mainPageList`；`current`/`pageSize`/`menuCode`/`permissionSetCode` 必填 |
+| `fna.loan.remind.repay.prepare` | write | 校验 displayData 行并预览，不发送 |
+| `fna.loan.remind.repay.apply` | write | 需 `confirm:true` + continuation；行指纹与 prepare 一致 |
+| `fna.invoice.writeoff.summary` | read | POST `inv/financial/writeOffPageTab` |
+| `fna.invoice.writeoff.list` | read | POST `inv/financial/writeOffList`；`current`/`pageSize` 必填 |
+| `fna.invoice.writeoff.callticket.prepare` | write | 校验 requestids 并预览，不发送 |
+| `fna.invoice.writeoff.callticket.apply` | write | 需 `confirm:true` + continuation；指纹与 prepare 一致 |
+
+完整 schema（inputSchema/required/enum）以 `weaver-work-cli fna schema` 为准。`withheldOperations` 记录了未实现的按钮能力（确认已还、核销明细）与 ID 解析边界。
+
+## 常用命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json fna run fna.budget.application.detail --input-json '{"requestId":"1001"}'
+weaver-work-cli --json fna run fna.expense.reimbursed.sum --input-json '{"startDate":"2026-01-01","endDate":"2026-08-31"}'
+weaver-work-cli --json fna run fna.loan.main.list --input-json '{"current":1,"pageSize":20,"menuCode":"fesx_fna_borrowingManagement","permissionSetCode":"fesx_fna_borrowingManagement.default"}'
+weaver-work-cli --json fna run fna.invoice.writeoff.list --input-json '{"current":1,"pageSize":20,"invoiceStatus":"unarrivedTicket"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json fna run fna.budget.application.detail --input-json '{"requestId":"1001"}'
+weaver-work-cli --json fna run fna.expense.reimbursed.sum --input-json '{"startDate":"2026-01-01","endDate":"2026-08-31"}'
+weaver-work-cli --json fna run fna.loan.main.list --input-json '{"current":1,"pageSize":20,"menuCode":"fesx_fna_borrowingManagement","permissionSetCode":"fesx_fna_borrowingManagement.default"}'
+weaver-work-cli --json fna run fna.invoice.writeoff.list --input-json '{"current":1,"pageSize":20,"invoiceStatus":"unarrivedTicket"}'
+```
+
+写操作（提醒还款示例）：先用 `fna.loan.main.list` 取行 → 存 UTF-8 JSON 文件 → prepare → 向用户展示预览并取得明确确认 → apply（`--input` 传同一文件，apply 文件加 `confirm:true` 与 continuation）。Windows 用 `C:\path\to\loan-rows.json`、macOS/Linux 用 `/tmp/loan-rows.json`。
+
+## 口径与已知缺陷
+
+- 金额单位元：`data` 原始精度字符串、`displayData` 格式化；费用中心借款/预付核销接口金额实测可能返回字符串或数字。
+- 借款 `getSumLoanAmountByAi` 仅统计首条借款记录（for 循环内 return），汇报需注明口径。
+- 日期口径：报销按明细费用日期、借款按流程创建时间、预付核销按核销记录创建时间。
+- `menuCode`/`permissionSetCode` 环境相关，示例值需与环境核对。
+- 超 2^53 的 requestId 无法用 JS 数字精确表达，保留字符串并提示人工核验（真实环境 ID 一般在安全整数内，已按数字发送）。
+
+## 验证
+
+```text
+weaver-work-cli fna schema
+weaver-work-cli --json fna run fna.budget.application.detail --input-json '{"requestId":"<占位>"}'
+```
+
+对应测试：`test/business/fna-operations.test.ts`、`test/business/fna-host.test.ts`；layout 约束见 `test/skills/layout.test.ts`。

package/docs/hrm.md

@@ -0,0 +1,89 @@
+# 组织管理（hrm）
+
+`hrm` 是 E10 组织管理的聚合命令，覆盖**员工（employee）**、**组织（org）**、**岗位（position）** 三个业务域，全部为只读查询。
+
+```text
+weaver-work-cli hrm --help
+weaver-work-cli hrm schema
+weaver-work-cli --json hrm run <operation> --input -
+```
+
+`schema` 是能力清单的唯一事实来源，包含每个 operation 的 `inputSchema`、`risk`，以及禁用清单 `withheldOperations`（代理商查询 `hrm.employee.dls`）。
+
+## 实现位置
+
+| 路径 | 职责 |
+| --- | --- |
+| `src/shortcuts/hrm/index.ts` | 命令注册与 JSON envelope |
+| `src/shortcuts/hrm/manifest.ts` | `schema` 契约与禁用边界声明 |
+| `src/shortcuts/hrm/host.ts` | E10 会话桥接、HRM 页面上下文 Referer、JSON 请求、响应归一化 |
+| `src/shortcuts/hrm/operations/` | 按业务域拆分的 operation 实现（employee / org / position） |
+| `src/shortcuts/hrm/operations/registry.ts` | operation 注册表与去重校验 |
+
+## 认证
+
+复用 `src/internal/e10` 的 E10 会话（`requireE10Session`），请求自动携带 `Cookie`、`eteamsid` 与 `X-Requested-With: XMLHttpRequest`。业务代码不接触认证目录。
+
+请求路径强制以 `/api/` 开头，并拒绝绝对路径、跨域 URL 与路径逃逸。
+
+HRM 接口必须携带页面上下文 `Referer`（默认 `<baseUrl>/hrm/main`），否则网关长时间无响应；组织卡片与岗位卡片详情由 operation 覆盖为 `/sp/hrm/orgCard/{id}`、`/sp/hrm/positionCard/{id}`。
+
+## 跨模块约定
+
+三个业务域统一走 E10 HRM 内部浏览/详情接口，响应统一 `WeaResult` 契约，由 `host.ts` 与 `operations/shared.ts` 归一化：
+
+**响应成功判定**：统一 `code=200`。`403`（接口开关未开启）抛 `api/permission_denied`，其余业务失败抛 `api/business_error`。
+
+**数据行位置**：
+
+| 接口类型 | 行字段 | 总数 |
+| --- | --- | --- |
+| 员工浏览 `employee.query` | `data.data` | `count/resource` 的 `data.total`（`data/resource` 的 `data.count` 恒为 0） |
+| 下属查询 `subordinate.mine` | `data.data` | `count/resource` 的 `data.total` |
+| 组织浏览 `org.query` | `data.data` | `data.total` |
+| 岗位浏览 `position.query` | `data.data` | `data.total` |
+| 岗位批量 `position.list` | `data.data` | `data.total` |
+| 批量人员 `employee.batch` | `data.userList` | 行数 |
+| 下属按 id `subordinate.by-id` | `data.page.result` | `data.page.totalCount` |
+
+**详情接口**（`employee.detail`/`org.detail`/`position.detail`）返回单对象，CLI 附 `link`。
+
+**长整型 id 一律按字符串传递**；**手机号已脱敏**（3 位前缀 + `****` + 末 4 位）。
+
+## 详情页卡片链接
+
+查询命中后，回答中一律用 `[名称](link)` 形式输出每个命中实体（`link` 由 CLI 在每行提供）：
+
+| 卡片 | link 路径 | 来源 operation |
+| --- | --- | --- |
+| 人员卡片 | `/sp/hrm/profileInfo/{id}` | `employee.query`/`employee.batch`/`subordinate.*`/`employee.detail` |
+| 组织卡片 | `/sp/hrm/orgCard/{id}` | `org.query`/`org.detail` |
+| 岗位卡片 | `/sp/hrm/positionCard/{id}` | `position.query`/`position.detail`/`position.list` |
+
+## 调用示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json hrm run hrm.employee.query --input-json '{"keyword":"张三"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+printf '%s\n' '{"keyword":"张三"}' | weaver-work-cli --json hrm run hrm.employee.query --input -
+```
+
+## 禁用边界
+
+`withheldOperations` 中声明的能力不实现，也不要绕过：
+
+- **代理商查询**（`hrm.employee.dls`）：`containsDls=true` 仅泛微自用系统域名支持（自用域名白名单），客户/其他环境禁止触发。
+
+## 测试
+
+```text
+node --test --import tsx "test/business/hrm-operations.test.ts" "test/business/hrm-host.test.ts" "test/business/hrm-command.test.ts"
+```
+
+覆盖 manifest/registry 一致性、请求形状断言、收敛条件与全量拉取拦截、响应归一化、Referer 注入与路径白名单、错误形状。

package/docs/invoice.md

@@ -1,17 +1,17 @@
 # 业票通发票管理 CLI
 
-来源目录：`weaver-e10-yepiaotong`，内容版本 `1.1.0`。本模块把接口文档中可安全自动化的能力封装为 `weaver-work-cli invoice` 命令，供 AI Agent 通过结构化 JSON 调用。
+来源目录：`weaver-e10-yepiaotong`，内容版本 `3.0.0`。本模块把接口文档中可安全自动化的能力封装为 `weaver-work-cli invoice` 命令，供 AI Agent 通过结构化 JSON 调用。
 
 源码位于 `src/shortcuts/invoice`。命令注册、operation manifest 和业务执行逻辑分离；具体执行逻辑在 `src/shortcuts/invoice/operations` 中按 operation class 维护。
 
-面向 Agent 的说明位于 `skills/weaver-work-cli-invoice`。入口 `SKILL.md` 只负责共享规则和 reference 路由；具体细节拆在 `skills/weaver-work-cli-invoice/references/`，与飞书 CLI 的业务 Skill 组织方式保持一致。
+面向 Agent 的说明位于 `skills/weaver-e10-yepiaotong`。入口 `SKILL.md` 只负责共享规则和 reference 路由；具体细节拆在 `skills/weaver-e10-yepiaotong/references/`，与飞书 CLI 的业务 Skill 组织方式保持一致。
 
 ## 公共前置
 
 先通过 E10 鉴权模块登录：
 
-```bash
-weaver-work-cli auth login --base-url "https://weapp.xxx.cn"
+```text
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn" --agent_type "<当前智能体名称>"
 weaver-work-cli auth status --no-check
 ```
 
@@ -27,9 +27,18 @@ Agent 不得在业务 JSON 中传 `access_token`、`app_key`、`app_secret`、Co
 
 优先使用 `invoice run <operation>`：
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli invoice schema
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
 weaver-work-cli invoice schema
-echo '{"page_size":10,"start_pos":0}' | weaver-work-cli --json invoice run invoice.list --input -
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
 ```
 
 成功和失败都使用 JSON envelope。成功写 stdout；失败写 stderr，并设置非 0 退出码。
@@ -51,35 +60,67 @@ echo '{"page_size":10,"start_pos":0}' | weaver-work-cli --json invoice run invoi
 | `invoice.update.prepare/apply` | 高风险写 | 基于完整详情修改白名单字段，保留附件并回查 |
 | `invoice.download` | 本地文件写 | 先校验 `fileId` 属于目标 `fid`，拒绝覆盖 |
 | `invoice.delete.prepare/apply` | 高风险写 | 固定软删除 `flag=0`，确认后执行并回查 |
-
-共享、转让和标签暂不暴露给 Agent：原始文档未给出稳定的接收人 `appid/cid/uid` 解析来源、标签关系查询和写后回查契约。
+| `invoice.browse-field.data` | 只读 | 基于详情接口生成流程表单发票浏览按钮 JSON |
+| `invoice.reim.file-ocr.preview` | 文件识别预览 | 对 E10 fileId 调用报销场景的发票识别接口，只保留成功项 |
+| `invoice.reim.requests.list` | 只读 | 查询事前申请流程列表，默认 `pageNo=1`、`pageSize=20` |
+| `invoice.reim.workflow.resolve` | 只读 | 根据事前申请 ID 获取报销工作流；无事前申请时传空数组 |
+| `invoice.reim.form.structure` | 只读 | 获取报销流程表单字段结构 |
+| `invoice.reim.row-info` | 只读 | 使用 urlencoded 请求获取单张发票明细行预填信息 |
+| `invoice.reim.employee-superiors` | 只读 | 获取当前人员和上级信息 |
+| `invoice.reim.field.search` | 只读 | 搜索表单关联字段值，用于用户修正或出差客户确认 |
+| `invoice.reim.flow.create.prepare/apply` | 高风险写 | continuation 绑定已组装报销单 payload；确认后调用 `createFlowNew` |
+| `invoice.reim.flow.update.prepare/apply` | 高风险写 | continuation 绑定更新 payload；确认后调用 `updateFlow` |
+| `invoice.issuing.make.prepare/apply` | 高风险写 | 固定销方信息，确认后调用 `makeInvoice` 开票或存台账 |
+
+共享、转让和标签仍暂不暴露给 Agent：新版源资料给出了提交接口，但还缺少稳定的接收人 `appid/cid/uid` 解析来源、标签关系查询和写后回查契约。
 
 ## 常用命令
 
-```bash
-weaver-work-cli --json invoice list --input -
-weaver-work-cli --json invoice enterprise list --input -
-weaver-work-cli --json invoice get --fid <fid>
+```text
+weaver-work-cli --json invoice list --input-json '{"page_size":10,"start_pos":0}'
+weaver-work-cli --json invoice enterprise list --input-json '{"page_size":10,"start_pos":0}'
+weaver-work-cli --json invoice get --fid INVOICE_FID
 weaver-work-cli --json invoice upload --file ./invoice.pdf
 weaver-work-cli --json invoice ocr preview --file ./invoice.pdf
-weaver-work-cli --json invoice validate preview --fid <fid> --scope personal
-weaver-work-cli --json invoice download --fid <fid> --file-id <fileId> --output ./invoice.pdf
+weaver-work-cli --json invoice validate preview --fid INVOICE_FID --scope personal
+weaver-work-cli --json invoice download --fid INVOICE_FID --file-id FILE_ID --output ./invoice.pdf
+weaver-work-cli --json invoice run invoice.browse-field.data --input-json '{"fid":"INVOICE_FID"}'
+weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20}'
 ```
 
 写操作必须先 prepare，再 apply：
 
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.ocr.preview --input-json '{"file":"./invoice.pdf"}'
+
+weaver-work-cli --json invoice import prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true}'
+
+weaver-work-cli --json invoice import apply --input-json '{"file":"./invoice.pdf","continuation":"PREPARE_CONTINUATION","confirm":true}'
+
+weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input .\reim-create.json
+
+weaver-work-cli --json invoice run invoice.issuing.make.prepare --input .\issuing.json
+```
+
+macOS/Linux（bash/zsh）：
+
 ```bash
-echo '{"file":"./invoice.pdf"}' \
-  | weaver-work-cli --json invoice run invoice.ocr.preview --input -
+weaver-work-cli --json invoice run invoice.ocr.preview --input-json '{"file":"./invoice.pdf"}'
+
+weaver-work-cli --json invoice import prepare --input-json '{"file":"./invoice.pdf","validate":true,"syncToOa":true}'
 
-echo '{"file":"./invoice.pdf","validate":true,"syncToOa":true}' \
-  | weaver-work-cli --json invoice import prepare --input -
+weaver-work-cli --json invoice import apply --input-json '{"file":"./invoice.pdf","continuation":"PREPARE_CONTINUATION","confirm":true}'
 
-echo '{"file":"./invoice.pdf","continuation":"<prepare返回值>","confirm":true}' \
-  | weaver-work-cli --json invoice import apply --input -
+weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
+
+weaver-work-cli --json invoice run invoice.issuing.make.prepare --input ./issuing.json
 ```
 
-导入本地发票文件时，面向 Agent 的正常链路是先 `invoice.ocr.preview`，再 `invoice.import.prepare` 使用 `validate=true`、`syncToOa=true`。只有用户明确要求跳过查验或离线导入时才传 `validate=false`；`validate=false` 表示跳过查验，不能描述为“查验通过”。写操作出现网络中断、部分成功或回查失败时，CLI 返回 `partial/write_uncertain`，Agent 禁止自动重复提交。
+导入本地发票文件时，面向 Agent 的正常链路是先 `invoice.ocr.preview`，再 `invoice.import.prepare` 使用 `validate=true`、`syncToOa=true`。只有用户明确要求跳过查验或离线导入时才传 `validate=false`；`validate=false` 表示跳过查验，不能描述为“查验通过”。
+
+报销单创建和开票/存台账只接受 Agent 已组装好的 payload。CLI 不负责猜测事前申请匹配、出差客户或税率；这些规则在 Skill reference 中指导 Agent 组装和展示预览。写操作出现网络中断、部分成功、缺少回执 ID 或回查失败时，CLI 返回 `partial/write_uncertain`，Agent 禁止自动重复提交。
 
 ## 编辑白名单
 

package/docs/jiuchuanhui.md

@@ -0,0 +1,131 @@
+# 九氚汇营销管理 CLI
+
+来源目录：`weaver-e10-jiuchuanhui`，内容版本 `1.1.1`。本模块把接口文档中可安全自动化的能力封装为 `weaver-work-cli jiuchuanhui` 命令，供 AI Agent 通过结构化 JSON 调用。
+
+源码位于 `src/shortcuts/jiuchuanhui`。命令注册、operation manifest 和业务执行逻辑分离；具体执行逻辑在 `src/shortcuts/jiuchuanhui/operations` 中按 operation class 维护。
+
+面向 Agent 的说明位于 `skills/weaver-e10-jiuchuanhui`。入口 `SKILL.md` 只负责共享规则和 reference 路由；具体细节拆在 `skills/weaver-e10-jiuchuanhui/references/`，与飞书 CLI 的业务 Skill 组织方式保持一致。
+
+## 公共前置
+
+先通过 E10 鉴权模块登录：
+
+```text
+weaver-work-cli auth login --base-url "https://jchdemo.e-cology.cn" --agent_type "<当前智能体名称>"
+weaver-work-cli auth status --no-check
+```
+
+每个九氚汇业务请求由 CLI 托管：
+
+1. 读取当前 `weaver-work-cli auth` Profile 的 E10 会话。
+2. 根据 operation 的 body mode 组装请求体（ESB 动作流 / eBuilder datajson）。
+3. 自动携带 Cookie、ETEAMSID、User-Agent，业务输入中禁止再传这些 key。
+
+Agent 不得在业务 JSON 中传 Cookie、ETEAMSID、Token 或内部控制字段；CLI 会拒绝这些 key。
+
+## Agent 入口
+
+优先使用 `jiuchuanhui run <operation>`：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli jiuchuanhui schema
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.search --input-json '{"customer_name":"小康","mine":"","all":"-1","customerSea":"-1","pageNo":1,"pageSize":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli jiuchuanhui schema
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.search --input-json '{"customer_name":"小康","mine":"","all":"-1","customerSea":"-1","pageNo":1,"pageSize":10}'
+```
+
+成功和失败都使用 JSON envelope。成功写 stdout；失败写 stderr，并设置非 0 退出码。
+
+当前输出层是完整 JSON 直接写 stdout，不提供飞书 CLI 的 `--jq`、`--format table/ndjson` 或通用 `--page-all`。Agent 使用时应默认小页读取和摘要渲染：列表先 `pageNo=1`、`pageSize=10`，按 `pageNo` 继续；回复只展示关键字段和数量，超长详情 JSON 落本地文件后给路径。
+
+## Operation 目录
+
+| Operation 组 | 风险 | 固定规则 |
+| --- | --- | --- |
+| `jiuchuanhui.app.discovery` / `form.discovery` / `ds.fields` / `field.options` / `rest.cfg.detail` / `config.id.by.pk` / `file.preview` / `get-rest-cfg-detail` | 只读 | 发现与配置；`file.preview` 需先确认文件内容 |
+| `jiuchuanhui.customer.create.prepare/apply` | 高风险写 | 创建前必须查重；`detail2` 同步创建联系人 |
+| `jiuchuanhui.customer.get` / `search` / `type/status/industry.search` / `open-sea.search` / `duplicate.check` | 只读 | 搜索必须显式传 `mine`/`all`/`customerSea`；`count:true` 并行取总数 |
+| `jiuchuanhui.customer.update/transfer/open-sea.release/open-sea.claim/contact-record.create/contact-record.batch` 的 prepare/apply | 高风险写 | 转移/释放/领取需确认唯一性与影响 |
+| `jiuchuanhui.contact.create/update` prepare/apply | 高风险写 | 联系人随客户创建时勿重复调用 |
+| `jiuchuanhui.contact.get` / `by-entity.search` | 只读 | 只给姓名先查候选再让用户选择 |
+| `jiuchuanhui.sale.create/update` prepare/apply | 高风险写 | 按配置 `data_key` 组装 |
+| `jiuchuanhui.sale.get` / `search` / `stage.search` / `process.search` / `lose-reason.search` / `rival.search` | 只读 | 阶段/原因选项供写操作取 ID |
+| `jiuchuanhui.sale.win/lose/invalid/pause/restart/manager-change/link-contacts/contact-record.create` 的 prepare/apply | 高风险写 | 赢单/输单/无效不可逆；输单先取原因；转移与负责人变更共用 |
+| `jiuchuanhui.clue.create/update/status-change/to-customer/contact-record.create` 的 prepare/apply | 高风险写 | 状态变更是覆盖型；转新客户走 `customer.create` 传 `source_module_id` |
+| `jiuchuanhui.clue.get` / `search` / `pool.search` | 只读 | 线索池列表 |
+| `jiuchuanhui.contact-plan.create/complete` prepare/apply | 高风险写 | `type` 与关联字段联动 |
+| `jiuchuanhui.entity.contact-records.list` / `contact-records.by-person-time.list` | 只读 | 联系记录查询 |
+| `jiuchuanhui.entity.id.by-name` / `user.id.by-name` / `user.current-profile` / `entity.permission.judge` / `company.business-profile.query` / `field.info.by-ids` / `browser-option.search` | 只读 | 通用辅助；行政区划也走 `entity.id.by-name` |
+
+缓存初始化（`cache.init`）与商机阶段推进（`stage-advance`）不暴露为 CLI operation：前者是 Agent 侧本地状态维护，后者依赖缓存阶段配置做映射，属于 Skill 编排层职责。
+
+## 常用命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.get --input-json '{"id":"100001"}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.search --input-json '{"pageNo":1,"pageSize":10,"count":true}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.user.id.by-name --input-json '{"mainTable":{"userName":"魏思雨"}}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.duplicate.check --input-json '{"mainTable":{"customerName":"示例科技有限公司"}}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.get --input-json '{"id":"100001"}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.search --input-json '{"pageNo":1,"pageSize":10,"count":true}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.user.id.by-name --input-json '{"mainTable":{"userName":"魏思雨"}}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.duplicate.check --input-json '{"mainTable":{"customerName":"示例科技有限公司"}}'
+```
+
+写操作必须先 prepare，再 apply：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.create.prepare --input .\customer-create.json
+
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.create.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.prepare --input-json '{"saleId":"200001"}'
+
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.create.prepare --input ./customer-create.json
+
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.customer.create.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.prepare --input-json '{"saleId":"200001"}'
+
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 写操作确认链
+
+- `prepare` 只预览和生成 continuation（HMAC 签名，绑定当前登录上下文与参数）。
+- 向用户摘要目标、差异、风险和 continuation 绑定含义。
+- 用户明确确认后才调用 `apply`（`confirm:true` + 有效 continuation）。
+- `apply` 不可盲目重试；遇到 `partial/write_uncertain` 先停止，再做一次只读回查（如 `customer.get`/`sale.get`/`clue.get`）。
+
+写操作出现网络中断、部分成功、缺少回执 ID 或回查失败时，CLI 返回 `partial/write_uncertain`，Agent 禁止自动重复提交。
+
+## 业务规则摘要
+
+- 选项字段（Select/RadioBox/CheckBox）必须先取选项 ID 再传值；`RelateBrowser` 字段通过 `browser-option.search` 查对应类型选项。
+- 行政区划传逗号分隔全路径 ID（`country,province,city,district`），传细粒度自动填充粗粒度。
+- 客户搜索必须显式传 `mine`/`all`/`customerSea` 三个 key（一个 `""` 其余 `-1`），没有 `scope` 快捷参数。
+- 列表、卡片及详情中的关联事项名称渲染为可点击链接 `https://{baseUrl}/sp/ebdfpage/card/0/{objId}/{dataId}`。
+- 新建客户前先查重；客户在公海时提醒可领取。
+- 线索转新客户走客户创建且传 `source_module_id=<clueId>`，成功后不再额外修改线索。

package/docs/meeting.md

@@ -0,0 +1,48 @@
+# meeting：E10 会议管理（标准版）
+
+## 模块来源
+
+由 `weaver-e10-skill-maker` 按 standalone 会议 Skill（weaver-e10-meeting v2.4.2）的接口契约生成，v1 覆盖**标准版（Java REST）**能力；EB 版（eBuilder formdata）链路列入禁用边界，待后续版本。
+
+## 命令结构
+
+```text
+weaver-work-cli meeting schema                       # 输出 operation manifest
+weaver-work-cli meeting run <operation> --input-json '<json>'
+weaver-work-cli meeting today                        # 今天会议（meeting.list 薄包装）
+```
+
+## operation 表
+
+| operation | 风险 | 说明 |
+| --- | --- | --- |
+| `meeting.env.detect` | read | EB/标准模式探测（EB 冒烟优先，失败回退标准） |
+| `meeting.calendar.base` | read | 建会前置判断（onlyFlowCreate/工作流配置） |
+| `meeting.list` | read | 会议列表（空 body 拉全量 + `filterDate` 客户端过滤） |
+| `meeting.detail.field` | read | 会议详情表单结构与 options |
+| `meeting.room.list` | read | 会议室列表（带时间范围返回 `disabled` 占用判断） |
+| `meeting.room.usage` | read | 会议室占用视图（bywhat 2=月 3=周 4=日） |
+| `meeting.type.list` | read | 会议类型列表（可选 count） |
+| `meeting.conflict.room` | read | 会议室冲突（cansub 语义） |
+| `meeting.conflict.member` | read | 参会人员冲突 |
+| `meeting.conflict.roomAttribute` | read | 会议室属性冲突 |
+| `meeting.create.prepare` | read-before-write | 归一化 + 建会路径检查 + 强制冲突检测 + continuation |
+| `meeting.create.apply` | high-risk-write | `operateMeetingByType SUBMIT`（需 confirm + continuation） |
+| `meeting.receipt.list` | read | 回执列表（isMobile 托管默认 false） |
+| `meeting.receipt.update.prepare` | read-before-write | 回查回执记录 id + 预览 |
+| `meeting.receipt.update.apply` | high-risk-write | 回执更新（需 confirm + continuation） |
+| `meeting.sign.list` | read | 签到记录 + 已签/未签统计 |
+
+## 关键契约（源资料实测坑位）
+
+- 新建会议 `operateType=SUBMIT` + `id:""` → 正常状态；`ADD` 只生成草稿，勿用。
+- 冲突处理看接口返回 `cansub`：false=禁止提交（直接拒绝）；true=仅提醒（建议换时间/地点）；检测失败视为冲突。**绝不提供"强制新建"选项**。
+- 周期会议 `finishAt` 必填（仅 1=次数 / 2=日期，禁止 0）；`repeatDesc` 由 CLI 自动拼接。
+- 回执更新必须传回执记录 `id`（prepare 自动按 `memberId` 回查）；`attendStatus` 0/1/2。
+- 超 2^53 的 id 一律字符串传递。
+
+## 已知限制（withheld）
+
+- EB 版业务链路（create_meeting/三件套/议题/纪要/报表）未实现。
+- `onlyFlowCreate=1`、周期会议工作流需要 workflow 集成，`create.prepare` 会主动拒绝。
+- 签到二维码（getQrCode 入参未确认）、签到写、会议室/类型管理、会议变更/取消/结束未实现。