weaver-work-cli 0.1.2 → 0.1.5

package/skills/weaver-e10-qiyecheng/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: weaver-e10-qiyecheng
+display_name: 泛微齐业成费控
+display_name_en: Weaver Qiyecheng FNA
+description: 泛微齐业成费控中心（预算查询/费用中心/借款管理/发票核销）的 E10 查询与提醒写操作能力，通过 weaver-work-cli fna 命令执行。
+description_zh: 泛微齐业成费控中心助手：事前申请单预算详情、预算执行报表、报销/借款/预付核销金额、全公司借款汇总与列表、提醒还款、发票核销金额与列表、催票。所有能力通过 weaver-work-cli fna 命令执行，提醒还款与催票为写操作，必须先 prepare 预览并经用户明确确认后 apply。
+description_en: Expense, budget and loan assistant for Weaver Qiyecheng FNA. Queries pre-application budget details, budget execution reports, reimbursed/loan/prepay amounts, company-wide loan summary and list, invoice write-off summary and list. Sends repayment reminders and invoice call-tickets through the weaver-work-cli fna command with a prepare/apply confirmation chain.
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+cliHelp: "weaver-work-cli fna --help"
+---
+
+# weaver-work-cli 齐业成费控（FNA）Skill
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+
+所有调用统一走 `weaver-work-cli fna ...`，禁止绕过 CLI 直接 curl/fetch E10 接口，禁止读取、复制、打印或解析 Cookie、ETEAMSID、Token 或 `~/.e10-cli` 等认证目录；登录诊断只允许 `weaver-work-cli auth root/status/profile list/profile current`、`weaver-work-cli doctor --e10` 和业务命令 JSON 错误。
+
+## 能力范围
+
+| 能力 | 说明 | 身份 |
+|---|---|---|
+| 预算查询 | 事前申请单预算详情、预算执行报表（只读） | 登录即可（接口公开） |
+| 费用中心 | 报销金额合计、借款金额分段、预付核销金额（只读） | 登录即可（默认当前登录人） |
+| 借款管理 | 全公司待还/还款中汇总、全员借款单列表（只读）；提醒还款（写） | 管理员 |
+| 发票核销财务 | 金额 tab 汇总、核销列表（只读）；催票（写） | 财务/管理员 |
+
+## 路由优先级
+
+先判断用户意图归属哪个模块，再选择 operation；一个意图只选最匹配的一个接口，目标不明确先提问收窄，不自动切换近义接口。**只有借款/发票核销模块涉及提醒类写操作，先 `prepare` 出预览并请用户明确确认，再 `apply`；禁止未确认自动执行。**
+
+- 「这个事前申请单预算还剩多少」「某 requestId 的预算情况」→ `fna.budget.application.detail`
+- 「预算执行报表」「某模板/部门/期间预算执行情况」→ `fna.budget.execute.list`
+- 「我/某人某段时间报销了多少」→ `fna.expense.reimbursed.sum`
+- 「还有多少借款没还」「各状态借款金额/笔数」→ `fna.expense.loan.sum`
+- 「预付核销进度」「未到账多少」→ `fna.expense.prepay.writeoff.sum`
+- 「全公司待还款/还款中多少钱」→ `fna.loan.main.page`
+- 「列出借款单」「谁还欠多少」→ `fna.loan.main.list`
+- 「提醒某人/批量提醒还款」→ `fna.loan.remind.repay.prepare` → 确认 → `fna.loan.remind.repay.apply`
+- 「发票核销未核销/核销中多少」→ `fna.invoice.writeoff.summary`
+- 「列出发票核销单」→ `fna.invoice.writeoff.list`
+- 「催票/批量催票」→ `fna.invoice.writeoff.callticket.prepare` → 确认 → `fna.invoice.writeoff.callticket.apply`
+
+## Operation 表（以 `weaver-work-cli fna schema` 为准）
+
+| 操作 | 风险 | 说明 |
+|---|---|---|
+| `fna.budget.application.detail` | read | GET 事前申请单预算详情（requestId 必填） |
+| `fna.budget.execute.list` | read | POST 预算执行报表（current/pageSize 必填） |
+| `fna.expense.reimbursed.sum` | read | 报销金额合计（body 可为空） |
+| `fna.expense.loan.sum` | read | 借款金额分段汇总（已知缺陷：仅统计首条借款记录；瞬时空响应自动重试） |
+| `fna.expense.prepay.writeoff.sum` | read | 预付核销金额汇总 |
+| `fna.loan.main.page` | read | 借款首页汇总（dhk/hkz） |
+| `fna.loan.main.list` | read | 借款首页列表（menuCode/permissionSetCode 必填） |
+| `fna.loan.remind.repay.prepare` | write | 提醒还款预览（不发送） |
+| `fna.loan.remind.repay.apply` | write | 提醒还款（confirm+continuation） |
+| `fna.invoice.writeoff.summary` | read | 发票核销金额 tab |
+| `fna.invoice.writeoff.list` | read | 发票核销列表 |
+| `fna.invoice.writeoff.callticket.prepare` | write | 催票预览（不发送） |
+| `fna.invoice.writeoff.callticket.apply` | write | 催票（confirm+continuation） |
+
+## 前置依赖与口径约定
+
+- **ID 解析不在本 Skill**：姓名→`employeeId`、流程名→`workflowId` 依赖人员/流程解析接口，源资料未提供；用户只给姓名/流程名时先索要数字 ID，禁止编造 ID 或接口。
+- `menuCode`/`permissionSetCode` 环境相关（借款 `fesx_fna_borrowingManagement(.default)`、核销 `inv_write_off_financial(.default)`），不确定时先与用户核对实际值。
+- 金额双套口径：`data` 原始精度字符串（计算）、`displayData` 格式化（展示/回传）；金额单位为元。
+- 费用中心日期口径不同：报销按明细费用日期、借款按流程创建时间、预付核销按核销记录创建时间。
+- 借款费用中心接口 requestId/employeeId/workflowId 只认**数字**（字符串会静默返回空）；超 2^53 的巨型 ID 保留字符串并提示人工核验。
+
+## 执行原则
+
+1. 业务输入只描述业务对象与意图；认证与接口地址全部由 CLI 托管。
+2. 列表/详情可能返回大响应：只保留回答所需字段，给摘要与总数，不原样粘贴超长 JSON。
+3. 金额/比率为字符串时转数值使用（比率需去 `%`）。
+4. 借款金额查询已知实现缺陷：对外汇报注明「可能仅反映首条记录口径」。
+5. 写操作（remindRepay/callTicket）失败决策树：`partial` / `write_uncertain` / 登录失效 / 网络中断 → **立即停止，禁止自动重试**，做一次只读回查（`fna.loan.main.list` / `fna.invoice.writeoff.list`）后向用户汇报；若返回 `confirmation.required`，说明缺少明确确认，先 prepare 再确认后 apply。
+6. 金额结论口径存疑时（如借款缺陷、瞬时空响应）先说明不确定性；`total=0` 或空列表提示「暂无记录」，不得伪造成功。
+
+## References
+
+| 需要 | 读取 |
+|---|---|
+| 接口目录与按模块路由 | [references/catalog.md](references/catalog.md) |
+| 预算：事前申请单预算详情 / 预算执行报表 | [references/budget.md](references/budget.md) |
+| 费用中心：报销 / 借款 / 预付核销 | [references/expense-center.md](references/expense-center.md) |
+| 借款管理：汇总 / 列表 / 提醒还款（prepare→apply） | [references/loan-management.md](references/loan-management.md) |
+| 发票核销：金额 tab / 列表 / 催票（prepare→apply） | [references/invoice-writeoff.md](references/invoice-writeoff.md) |
+| 源资料指纹与更新检测 | [references/source-manifest.json](references/source-manifest.json) |
+
+## 命令示例
+
+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.loan.sum --input-json '{"employeeId":12345,"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"}'
+```
+
+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.loan.sum --input-json '{"employeeId":12345,"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"}'
+```
+
+## 附件与文件安全
+
+本 Skill 的 11 个接口均为查询/提醒类，**不涉及附件、图片或文件上传解析**。若后续扩展接口涉及附件或文件内容解析，必须先向用户说明「附件内容可能会发送到当前大模型服务处理，可能进入大模型上下文」，并在用户明确确认后才能处理；不得把用户仅提供路径或文件名视为同意解析或上传。
+
+## 不在本 Skill 范围
+
+- 借款「确认已还 confirmRepay」、核销明细等页面按钮能力（源资料未提供接口）→ 见 `weaver-work-cli fna schema` 的 `withheldOperations`，不得编造 operation 或直连接口。
+- 姓名/流程名 → ID 的解析、创建借款单/预付单/事前申请单等需联动工作流的写流程（未提供接口依据）。
+- 其它模块（发票票夹、人事、流程待办）请路由到对应 Skill，不在此重复实现。

package/skills/weaver-e10-qiyecheng/product.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "product": "weaver-work-cli",
+  "productVersion": "0.1.2",
+  "packageName": "weaver-work-cli",
+  "command": "weaver-work-cli",
+  "nodeEngine": ">=18"
+}

package/skills/weaver-e10-qiyecheng/references/budget.md

@@ -0,0 +1,65 @@
+# 预算查询
+
+## 何时使用
+
+用户问「事前申请单预算还剩多少」「某 requestId 的预算/报销情况」→ 事前申请单预算详情；问「预算执行报表」「某模板/部门/期间预算执行情况」→ 预算执行报表。两者都是只读查询，无写副作用。
+
+## 事前申请单预算详情（fna.budget.application.detail）
+
+### 输入要点
+
+- `requestId` 必填：事前申请单 ID（数字），用户只给申请名称/事由时先向其索要 requestId，不要自行拼 ID 解析接口。
+- 预算口径：预算总额 = 已报销 + 报销中 + 剩余可用 + 已释放；若不等，提示数据可能未刷新或存在并发在途变更。
+
+### 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json fna run fna.budget.application.detail --input-json '{"requestId":"1001"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json fna run fna.budget.application.detail --input-json '{"requestId":"1001"}'
+```
+
+### 输出处理
+
+返回归一化对象：`requestId`/`requestName`/`createPerson`/`createTime` + `budget{totalAmount,reimbursedFee,reimbursingFee,remainingBudget,releasedBudgetAmount,isDisplay}`；`meta.rawForm` 为原始 WeaForm。汇报时展示申请名称、发起时间、预算总额与剩余可用预算即可，不必粘贴整份表单。
+
+## 预算执行报表（fna.budget.execute.list）
+
+### 输入要点
+
+- `current`/`pageSize` 必填（正整数）；`templateId` 预算模板 ID，为空只返回表头（正常行为，不是错误）。
+- `formDatas`（可选）：维度/期间筛选。**嵌套陷阱**：每个 value 是「单元素数组包裹同名 key 数组」的二层嵌套；`periodName` 传金额列名 `budget_amount1`~`budget_amount12`（对应 1~12 月）；维度成员传 `[{"dimenMem1":[{"id":"...","name":"..."}]}]`，维度 key 由模板 `corrColumn` 决定，不要臆造。
+- `type`：`and`/`or`；`ignoreReportPower` 仅内部/管理员场景，默认不传。
+
+### 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json fna run fna.budget.execute.list --input-json '{"current":1,"pageSize":100,"templateId":"1192927724873392129","formDatas":{"periodName":[{"periodName":["budget_amount1"]}]}}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json fna run fna.budget.execute.list --input-json '{"current":1,"pageSize":100,"templateId":"1192927724873392129","formDatas":{"periodName":[{"periodName":["budget_amount1"]}]}}'
+```
+
+### 输出处理
+
+返回 `{total,current,pageSize,hasMore,periodFlag,columns,rows,totals}`。汇总问题（预算总额/已报销/剩余可用/执行率）优先读 `totals` 中 `budget_sumAmount` 前缀的合计字段（字符串，转数值、比率去 `%`）；明细看 `rows`。
+
+### 注意
+
+- `templateId` 为空仅返回表头，需提示用户传入正确的模板 ID。
+- 字段列与维度 key 因模板而异，本 Skill 不臆造，必要时请用户提供模板维度配置。
+
+## 失败处理
+
+`code!=200`/`status!=true` → 停止并按错误 envelope 汇报，不切换到其它近义接口重试。

package/skills/weaver-e10-qiyecheng/references/catalog.md

@@ -0,0 +1,56 @@
+# FNA 齐业成费控接口目录
+
+对应 `weaver-work-cli fna` 的 13 个 operation，覆盖源资料四大模块 11 个接口（预算 2 / 费用中心 3 / 借款管理 3 / 发票核销 3，其中提醒还款与催票拆为 prepare/apply 两个操作）。完整接口路径与认证由 weaver-work-cli 托管，Agent 只写业务 JSON。
+
+## 一、预算查询（budget，2 个）
+
+| 用户意图 | operation | 说明 |
+|---|---|---|
+| 「这个事前申请单预算还剩多少」「某 requestId 的预算情况」 | `fna.budget.application.detail` | GET 详情，requestId 必填，返回预算总额/已报销/报销中/剩余可用/已释放 |
+| 「预算执行报表」「某模板/部门/期间预算执行情况」 | `fna.budget.execute.list` | POST 报表，current/pageSize 必填，templateId 为空仅返回表头 |
+
+- 均为公开 AI 接口（`publicPermission=true`），只读无写副作用。
+- 预算执行报表期间筛选 `periodName` 传**金额列名**（`budget_amount1`~`budget_amount12`），维度 key（`dimenMem1` 等）随模板 `corrColumn` 变化；`formDatas` 每个 value 是「单元素数组包裹同名 key 数组」的二层嵌套，拼错层级会筛选失效而不是报错。
+- 汇总口径优先读响应 `totals`（customParameters）中 `budget_sumAmount` 前缀字段，金额/比率为字符串。
+
+## 二、费用中心（expense，3 个）
+
+| 用户意图 | operation |
+|---|---|
+| 「我/某人报销了多少」「某时间段报销金额合计」 | `fna.expense.reimbursed.sum` |
+| 「还有多少借款没还」「各状态借款金额/笔数」 | `fna.expense.loan.sum` |
+| 「预付核销进度」「未到账多少」 | `fna.expense.prepay.writeoff.sum` |
+
+- 共用 `SumAmountByAiVo`（employeeId/startDate/endDate/workflowId/requestId），**body 可为空**，不传按当前登录人。
+- 报销口径：明细状态 `status=1`（审批完成）的 `reimburse_amount` 合计 = 已报销金额；无数据返回 `0.0`。
+- ⚠️ 借款接口缺陷：仅统计首条借款记录（对外汇报注明）；且首次/冷启动可能瞬时空响应（缺 data 键），CLI 自动重试最多 2 次。
+- 借款接口 requestId 等必须传数字；预付核销接口日期按核销记录创建时间、employeeId 匹配预付单创建人。
+
+## 三、借款管理（loan，管理员）
+
+| 用户意图 | operation | 风险 |
+|---|---|---|
+| 「全公司待还款/还款中多少钱」 | `fna.loan.main.page` | read |
+| 「列出借款单」「谁还欠多少」 | `fna.loan.main.list` | read |
+| 「提醒某人/批量提醒还款」 | `fna.loan.remind.repay.prepare` / `.apply` | **write** |
+
+- `mainPageList` 必填 `current`/`pageSize`/`menuCode`/`permissionSetCode`（示例 `fesx_fna_borrowingManagement`，需与环境核对）。
+- 数据流：`fna.loan.main.list` 返回 `rows`（displayData 行，含 id/workflowId/jkrPersonName/dhkAmount）→ 原样回传 `fna.loan.remind.repay.prepare` → 用户确认 → `apply`。
+- 金额：`data` 原始精度、`displayData` 已格式化；`createTime` 在 displayData 为 `yyyy-MM-dd HH:mm:ss`。
+
+## 四、发票核销财务（invoice-writeoff，财务/管理员）
+
+| 用户意图 | operation | 风险 |
+|---|---|---|
+| 「发票核销未核销/核销中多少」 | `fna.invoice.writeoff.summary` | read |
+| 「列出发票核销单」「谁还有多少没核销」 | `fna.invoice.writeoff.list` | read |
+| 「催票/批量催票」 | `fna.invoice.writeoff.callticket.prepare` / `.apply` | **write** |
+
+- `invoiceStatus` 过滤：`unWritten`/`unarrivedTicket`/`dealing`/`callTicket`；`menuCode`/`permissionSetCode` 示例 `inv_write_off_financial(.default)`。
+- 数据流：`fna.invoice.writeoff.list` 返回行 `requestId`（= `id`）→ 组装 `requestids` 传给 `callticket.prepare` → 用户确认 → `apply`。
+
+## 通用约定
+
+- 失败时按错误 envelope 的 `type/subtype` 处理：`confirmation.required` 缺确认；`partial.write_uncertain` 不确定结果立即停止并回查，禁止自动重试。
+- 无记录时输出 `total=0`/空 `rows` 或 `segments:null`，提示「暂无记录」，不得伪造成功。
+- 全部金额字段单位为元。

package/skills/weaver-e10-qiyecheng/references/expense-center.md

@@ -0,0 +1,51 @@
+# 费用中心（报销 / 借款 / 预付核销）
+
+## 何时使用
+
+三个查询共用 `SumAmountByAiVo`，**body 可为空**（默认当前登录人）。每个意图只选一个接口，不要自动切换近义接口。
+
+| 用户意图 | operation |
+|---|---|
+| 「我/某人某时间段报销了多少」「这笔报销流程报销了多少钱」 | `fna.expense.reimbursed.sum` |
+| 「还有多少借款没还」「各状态借款金额/笔数」 | `fna.expense.loan.sum` |
+| 「预付核销进度」「未到账多少」 | `fna.expense.prepay.writeoff.sum` |
+
+## 输入要点
+
+- `employeeId`/`workflowId`/`requestId` 都是数字 ID（借款接口只认数字，字符串会静默返回空 data）；用户给姓名/流程名时先请其提供数字 ID。
+- `startDate`/`endDate` 格式 `YYYY-MM-DD`，必须成对提供；**日期口径不同**：报销按明细费用日期、借款按流程创建时间、预付核销按核销记录创建时间。
+- 人员口径差异：报销按明细归属人、预付核销按预付单创建人匹配。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json fna run fna.expense.reimbursed.sum --input-json '{"employeeId":12345,"startDate":"2026-01-01","endDate":"2026-08-31"}'
+weaver-work-cli --json fna run fna.expense.loan.sum --input-json '{"requestId":1304980982180151297}'
+weaver-work-cli --json fna run fna.expense.prepay.writeoff.sum --input-json '{}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json fna run fna.expense.reimbursed.sum --input-json '{"employeeId":12345,"startDate":"2026-01-01","endDate":"2026-08-31"}'
+weaver-work-cli --json fna run fna.expense.loan.sum --input-json '{"requestId":1304980982180151297}'
+weaver-work-cli --json fna run fna.expense.prepay.writeoff.sum --input-json '{}'
+```
+
+## 输出处理
+
+- 报销：`data.amount`（元）；无数据返回 `0.0`。
+- 借款：`data.segments` 为 `{dhk,hkz,yhk,jk}` 四段 `{amount,count,costType}`；`segments:null` 表示暂无借款记录；以 key 判断状态，不依赖 costType 文案（可能是文案或状态码）。
+- 预付核销：`paymentAmount`/`writeOffing`/`writeOffed`/`noArrivedAmount`（未到账 = 预付 − 已到账 − 已核销），无数据兜底 0。
+
+## 注意（口径与缺陷）
+
+- **借款查询实现缺陷**：`getSumLoanAmountByAi` 只统计首条借款记录（for 循环内 return），对外汇报注明「可能仅反映首条记录口径，待开发修复」，不作权威结论。
+- **借款瞬时空响应**：首次/冷启动偶发 `code:200` 但整个 `data` 缺失，CLI 已自动重试最多 2 次；若仍为空按「暂无借款记录」处理并提示可稍后重试，不要误判为确定无记录。
+- 报销无数据是 `0.0`、借款无数据是 `null`、预付核销兜底 `0`，三者空值语义不同。
+
+## 失败处理
+
+`code!=200`/`success!=true` → 停止并向用户说明查询失败，建议稍后重试或联系管理员；不自行拼装其它接口路径重试。

package/skills/weaver-e10-qiyecheng/references/invoice-writeoff.md

@@ -0,0 +1,57 @@
+# 发票核销（财务/管理员）
+
+## 何时使用
+
+财务/管理员视角的发票核销：看金额分布 → 金额 tab 汇总；看明细/谁还有多少没核销 → 核销列表；对未到票的预付流程发催票 → **写操作**，先 prepare 再 apply。`writeOffList`/`callTicket` 需财务/管理员登录，`writeOffPageTab` 公开权限（仍需登录态定租户）。
+
+| 用户意图 | operation | 风险 |
+|---|---|---|
+| 「发票核销还有多少没核销」「核销中/部分核销多少」 | `fna.invoice.writeoff.summary` | read |
+| 「列出所有发票核销单」「谁还有多少没核销」 | `fna.invoice.writeoff.list` | read |
+| 「催一下这几笔预付的票」「批量催票」 | `fna.invoice.writeoff.callticket.prepare` / `.apply` | **write** |
+
+## 输入要点
+
+- `fna.invoice.writeoff.list` 必填 `current`/`pageSize`；筛选 `invoiceStatus`：`unWritten`(未核销)/`unarrivedTicket`(未到票)/`dealing`(核销中)/`callTicket`(催票)。
+- `menuCode`/`permissionSetCode` 示例 `inv_write_off_financial` / `inv_write_off_financial.default`，需与环境核对。
+- 常用金额列（rows 内）：`totalAmount`(总金额)/`arrivedAmount`(已核销)/`verificationAmount`(核销中)/`notArrivedAmount`(未核销)，均为格式化字符串；`requestId` = `id`（催票回传用）。
+- `total=0`、rows 为空 → 提示「暂无发票核销记录」。
+
+## 数据流：催票（写操作）
+
+1. `fna.invoice.writeoff.list`（可用 `invoiceStatus=unarrivedTicket` 或 `callTicket` 过滤）取目标预付流程行。
+2. 提取行的 `requestId` 组装 `requestids` 数组（1~200 条，必须来自列表真实返回，禁止凭空构造）。
+3. `fna.invoice.writeoff.callticket.prepare` 入参 `{"requestids":[...]}` → 返回预览（条数 + 前 20 个 ID）+ continuation：**向用户展示目标流程（建议连同列表行的申请名称/未核销金额一起展示），取得明确确认**。
+4. 确认后 `fna.invoice.writeoff.callticket.apply` 入参 `requestids` + `confirm:true` + `continuation`。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json fna run fna.invoice.writeoff.summary --input-json '{"invoiceStatus":"unWritten","menuCode":"inv_write_off_financial","permissionSetCode":"inv_write_off_financial.default"}'
+weaver-work-cli --json fna run fna.invoice.writeoff.list --input-json '{"current":1,"pageSize":20,"invoiceStatus":"unarrivedTicket"}'
+weaver-work-cli --json fna run fna.invoice.writeoff.callticket.prepare --input-json '{"requestids":["1305356190451253248","1304611911414513664"]}'
+weaver-work-cli --json fna run fna.invoice.writeoff.callticket.apply --input-json '{"requestids":["1305356190451253248","1304611911414513664"],"confirm":true,"continuation":"PASTE_TOKEN_FROM_PREPARE"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json fna run fna.invoice.writeoff.summary --input-json '{"invoiceStatus":"unWritten","menuCode":"inv_write_off_financial","permissionSetCode":"inv_write_off_financial.default"}'
+weaver-work-cli --json fna run fna.invoice.writeoff.list --input-json '{"current":1,"pageSize":20,"invoiceStatus":"unarrivedTicket"}'
+weaver-work-cli --json fna run fna.invoice.writeoff.callticket.prepare --input-json '{"requestids":["1305356190451253248","1304611911414513664"]}'
+weaver-work-cli --json fna run fna.invoice.writeoff.callticket.apply --input-json '{"requestids":["1305356190451253248","1304611911414513664"],"confirm":true,"continuation":"PASTE_TOKEN_FROM_PREPARE"}'
+```
+
+## 写操作失败决策树
+
+- `confirmation.required` → 用户尚未确认：展示 prepare 预览后带 `confirm:true` 重新 apply。
+- `target_changed` / `continuation_expired` / `context_mismatch` → 与 prepare 快照不一致或已过期：重新 prepare。
+- `partial.write_uncertain` / `network.*` → **立即停止，禁止自动重试**；用 `fna.invoice.writeoff.list`（`invoiceStatus=callTicket`）回查是否已催票，向用户说明。
+- `business_error` → 停止并按 msg 修正（如 requestids 含非法流程）。
+
+## 注意
+
+- callTicket 只发送催票通知，不改变核销金额状态；核销明细等按钮能力未实现（见 schema `withheldOperations`）。
+- 翻页时保持 `invoiceStatus`/`menuCode`/`permissionSetCode` 等筛选条件。

package/skills/weaver-e10-qiyecheng/references/loan-management.md

@@ -0,0 +1,59 @@
+# 借款管理（管理员）
+
+## 何时使用
+
+管理员视角的借款大盘：看全公司待还/还款中汇总 → 首页汇总；看明细/谁还欠多少 → 首页列表；向借款人发还款提醒 → **写操作**，先 prepare 再 apply。借款模块需要管理员身份登录。
+
+| 用户意图 | operation | 风险 |
+|---|---|---|
+| 「全公司待还款/还款中多少钱」「借款大盘」 | `fna.loan.main.page` | read |
+| 「列出所有借款单」「谁还欠多少」 | `fna.loan.main.list` | read |
+| 「提醒某人/批量提醒还款」 | `fna.loan.remind.repay.prepare` / `.apply` | **write** |
+
+## 输入要点
+
+- `fna.loan.main.list` 必填：`current`/`pageSize`（正整数）+ `menuCode`/`permissionSetCode`。借款菜单示例 `fesx_fna_borrowingManagement` / `fesx_fna_borrowingManagement.default`，**实际值需与用户环境借款管理菜单一致**，不确定先向用户核对。
+- 分页：`current` 递增直到 `hasMore=false`；页面默认分页大小 `pageSizeFromPageUid`（如 20）。
+- 金额两套：`rows`（displayData）金额已格式化、`createTime` 已转字符串，**展示与回传都用 rows**；不要用原始精度列。
+- 若 `total=0` 且 rows 为空 → 提示「暂无借款记录」。
+
+## 数据流：提醒还款（写操作）
+
+1. `fna.loan.main.list` 取目标借款单 → `rows` 中选中行（含 `id`/`workflowId`/`jkrPersonName`/`dhkAmount`）。
+2. `fna.loan.remind.repay.prepare`，入参 `data` = 选中 displayData 行数组（1~200 条，原样回传不裁剪）。
+3. prepare 返回 `{status:'AWAITING_CONFIRMATION', preview:{count,borrowers,totalDhkAmount,ids}, continuation}`：**向用户展示条数、借款人、剩余待还合计，取得明确确认**。
+4. 用户确认后 `fna.loan.remind.repay.apply`，入参 `data`（与 prepare 相同的行）+ `confirm:true` + `continuation`（10 分钟内有效）。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json fna run fna.loan.main.page --input-json '{"menuCode":"fesx_fna_borrowingManagement","permissionSetCode":"fesx_fna_borrowingManagement.default"}'
+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.loan.remind.repay.prepare --input 'C:\path\to\loan-rows.json'
+weaver-work-cli --json fna run fna.loan.remind.repay.apply --input 'C:\path\to\loan-apply.json'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json fna run fna.loan.main.page --input-json '{"menuCode":"fesx_fna_borrowingManagement","permissionSetCode":"fesx_fna_borrowingManagement.default"}'
+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.loan.remind.repay.prepare --input /tmp/loan-rows.json
+weaver-work-cli --json fna run fna.loan.remind.repay.apply --input /tmp/loan-apply.json
+```
+
+复杂多行 JSON（displayData 行对象字段多）建议写入 UTF-8 JSON 文件后走 `--input <path>`。
+
+## 写操作失败决策树
+
+- `confirmation.required`（exit 10）→ 用户尚未明确确认：先向用户展示 prepare 预览，确认后带 `confirm:true` 重新 apply。
+- `target_changed` / `continuation_expired` / `context_mismatch` → 目标或会话与 prepare 不一致：重新执行 prepare 后再 apply。
+- `partial.write_uncertain` / `network.*`（请求已发出结果不确定）→ **立即停止，禁止自动重试**；用 `fna.loan.main.list` 回查该借款人是否收到提醒，向用户说明并让其决定是否重新发起。
+- `business_error`（如「请选择提醒还款记录!」）→ 停止并按 msg 提示修正入参。
+
+## 注意
+
+- remindRepay 只发送提醒，不改变借款/还款金额；「确认已还 confirmRepay」等按钮能力未实现（见 schema `withheldOperations`），不得编造接口。
+- prepare/apply 之间不得切换租户或账号；行集合必须与 prepare 快照一致。