weaver-work-cli 0.1.25 → 0.1.28

package/dist/shortcuts/invoice/operations/issuing.js

@@ -1,198 +0,0 @@
-import { invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
-import { asNonEmptyString, asObject, assertBusinessSuccess, objectFingerprint, sessionMatches, workflow, } from './shared.js';
-const SELLER_TAX_NO = '9131000070322836XD';
-const SELLER_NAME = '上海泛微网络科技股份有限公司';
-const TAX_RATES = new Set([0, 0.01, 0.03, 0.05, 0.06, 0.09, 0.13]);
-function optionalText(value, name) {
-    if (value === undefined || value === null || value === '')
-        return undefined;
-    return asNonEmptyString(value, name);
-}
-function money(value, name) {
-    if (typeof value === 'number') {
-        if (!Number.isFinite(value) || value < 0)
-            throw invoiceValidationError('input_invalid', `${name} 必须是非负金额`);
-        return value;
-    }
-    if (typeof value !== 'string' || !/^\d+(?:\.\d+)?$/u.test(value)) {
-        throw invoiceValidationError('input_invalid', `${name} 必须是非负金额`);
-    }
-    return value;
-}
-function taxRate(value, name) {
-    const parsed = typeof value === 'number' ? value : Number(value);
-    if (!Number.isFinite(parsed) || !TAX_RATES.has(parsed)) {
-        throw invoiceValidationError('input_invalid', `${name} 必须是合法税率：0、0.01、0.03、0.05、0.06、0.09 或 0.13`);
-    }
-    return typeof value === 'number' ? value : String(value);
-}
-function taxNo(value, name, { required = false } = {}) {
-    const text = optionalText(value, name);
-    if (text === undefined) {
-        if (required)
-            throw invoiceValidationError('input_invalid', `${name} 必填`);
-        return undefined;
-    }
-    if (!/^[0-9A-Z]{15,20}$/u.test(text)) {
-        throw invoiceValidationError('input_invalid', `${name} 必须是 15-20 位数字或大写字母`);
-    }
-    return text;
-}
-function normalizeMode(value) {
-    if (value !== 'issue' && value !== 'ledger') {
-        throw invoiceValidationError('input_invalid', 'mode 必须是 issue 或 ledger');
-    }
-    return value;
-}
-function normalizeDetail(value, index) {
-    const detail = structuredClone(asObject(value, `payload.details[${index}]`));
-    detail.goodsName = asNonEmptyString(detail.goodsName, `payload.details[${index}].goodsName`);
-    detail.taxRate = taxRate(detail.taxRate, `payload.details[${index}].taxRate`);
-    detail.amount = money(detail.amount, `payload.details[${index}].amount`);
-    detail.amountWithTax = money(detail.amountWithTax, `payload.details[${index}].amountWithTax`);
-    if (detail.taxAmount !== undefined)
-        detail.taxAmount = money(detail.taxAmount, `payload.details[${index}].taxAmount`);
-    if (detail.revenueCode !== undefined && !/^\d{4,19}$/u.test(String(detail.revenueCode))) {
-        throw invoiceValidationError('input_invalid', `payload.details[${index}].revenueCode 必须是数字编码`);
-    }
-    for (const key of ['quantity', 'unitPrice', 'unit', 'specification']) {
-        if (detail[key] !== undefined && detail[key] !== null)
-            detail[key] = String(detail[key]);
-    }
-    return detail;
-}
-function normalizeMakeInvoicePayload(rawPayload, mode) {
-    const payload = structuredClone(asObject(rawPayload, 'payload'));
-    const purchaserName = asNonEmptyString(payload.purchaserName, 'payload.purchaserName');
-    const invoiceType = asNonEmptyString(payload.invoiceType, 'payload.invoiceType');
-    if (!['7', '8', '9', '10'].includes(invoiceType)) {
-        throw invoiceValidationError('input_invalid', 'payload.invoiceType 必须是 7、8、9 或 10');
-    }
-    const specialInvoice = invoiceType === '8' || invoiceType === '10';
-    const purchaserTaxNo = taxNo(payload.purchaserTaxNo, 'payload.purchaserTaxNo', { required: specialInvoice });
-    if (!Array.isArray(payload.details) || !payload.details.length) {
-        throw invoiceValidationError('input_invalid', 'payload.details 必须是非空数组');
-    }
-    const details = payload.details.map((item, index) => normalizeDetail(item, index));
-    const normalized = {
-        ...payload,
-        taxNo: SELLER_TAX_NO,
-        sellerName: SELLER_NAME,
-        billingType: payload.billingType || '0',
-        invoiceType,
-        externalDocumentNo: asNonEmptyString(payload.externalDocumentNo, 'payload.externalDocumentNo'),
-        sourceType: payload.sourceType || '4',
-        asyncCallFlag: payload.asyncCallFlag || '1',
-        invoiceMethod: payload.invoiceMethod || '5',
-        taxSign: payload.taxSign || '1',
-        personLogo: payload.personLogo || (purchaserTaxNo ? '0' : '1'),
-        purchaserName,
-        details,
-        totalAmount: money(payload.totalAmount, 'payload.totalAmount'),
-        taxAmount: money(payload.taxAmount, 'payload.taxAmount'),
-        totalAmountWithTax: money(payload.totalAmountWithTax, 'payload.totalAmountWithTax'),
-    };
-    if (purchaserTaxNo !== undefined)
-        normalized.purchaserTaxNo = purchaserTaxNo;
-    for (const key of ['purchaserAddress', 'purchaserTel', 'purchaserBankName', 'purchaserBankAccount', 'remark', 'invoiceDate']) {
-        if (payload[key] !== undefined && payload[key] !== null)
-            normalized[key] = String(payload[key]);
-    }
-    if (mode === 'ledger')
-        normalized.operateType = '5';
-    else
-        delete normalized.operateType;
-    return normalized;
-}
-function makeInvoicePreview(payload, mode) {
-    return {
-        mode,
-        purchaserName: payload.purchaserName,
-        purchaserTaxNo: payload.purchaserTaxNo || '',
-        invoiceType: payload.invoiceType,
-        externalDocumentNo: payload.externalDocumentNo,
-        totalAmount: payload.totalAmount,
-        taxAmount: payload.taxAmount,
-        totalAmountWithTax: payload.totalAmountWithTax,
-        detailCount: Array.isArray(payload.details) ? payload.details.length : 0,
-    };
-}
-export class InvoiceIssuingMakePrepareOperation {
-    name = 'invoice.issuing.make.prepare';
-    async execute(input, { host, continuation }) {
-        const mode = normalizeMode(input.mode);
-        const payload = normalizeMakeInvoicePayload(input.payload, mode);
-        const session = await host.getSession();
-        const preview = makeInvoicePreview(payload, mode);
-        const continuationToken = await continuation.issue({
-            operation: 'invoice.issuing.make.apply',
-            workflow: workflow('invoice.issuing.make', 'AWAITING_CONFIRMATION'),
-            baseUrl: session.baseUrl,
-            profile: session.profile,
-            userId: session.userId,
-            mode,
-            fingerprint: objectFingerprint(payload),
-            preview,
-        });
-        return {
-            status: 'AWAITING_CONFIRMATION',
-            data: {
-                preview,
-                normalizedPayload: payload,
-                continuation: continuationToken,
-                expiresInSeconds: 600,
-                workflow: workflow('invoice.issuing.make', 'AWAITING_CONFIRMATION'),
-            },
-        };
-    }
-}
-export class InvoiceIssuingMakeApplyOperation {
-    name = 'invoice.issuing.make.apply';
-    async execute(input, { host, continuation }) {
-        if (input.confirm !== true)
-            throw invoiceConfirmationError('invoice.issuing.make.apply', { hint: '重新调用时传入 confirm=true' });
-        const lease = await continuation.verify(input.continuation, 'invoice.issuing.make.apply');
-        const mode = normalizeMode(lease.mode);
-        const payload = normalizeMakeInvoicePayload(input.payload, mode);
-        if (typeof lease.fingerprint !== 'string')
-            throw invoiceValidationError('continuation_invalid', '开票 continuation 缺少 payload 指纹');
-        if (objectFingerprint(payload) !== lease.fingerprint)
-            throw invoiceValidationError('target_changed', '开票载荷与确认时不一致，请重新准备');
-        const session = await host.getSession();
-        if (!sessionMatches(lease, session))
-            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备开票');
-        let result;
-        try {
-            result = await host.invoiceRequest({ path: '/api/inc/book/open/makeInvoice', method: 'POST', body: payload, operation: this.name, timeoutMs: 90_000 });
-        }
-        catch (error) {
-            if (isInvoiceNetworkError(error)) {
-                throw invoicePartialError('开票请求发送后连接中断，结果不确定，禁止自动重试', {
-                    preview: lease.preview,
-                    workflow: workflow('invoice.issuing.make', 'EXECUTING'),
-                }, { stage: 'issuing-make' });
-            }
-            throw error;
-        }
-        assertBusinessSuccess(result, 'issuing_make_failed', '开票或存台账失败');
-        const data = result?.data || {};
-        if (!data.serialNo && !data.orderNo && mode === 'issue') {
-            throw invoicePartialError('开票接口返回成功但缺少流水号，结果不确定', {
-                preview: lease.preview,
-                result,
-                workflow: workflow('invoice.issuing.make', 'VERIFYING'),
-            }, { stage: 'issuing-make-response' });
-        }
-        return {
-            status: 'COMPLETE',
-            data: {
-                mode,
-                serialNo: data.serialNo,
-                orderNo: data.orderNo,
-                ledgerOnly: mode === 'ledger',
-                result,
-                workflow: workflow('invoice.issuing.make', 'COMPLETE'),
-            },
-        };
-    }
-}

package/skills/weaver-e10-yepiaotong/references/invoice-issuing-field-rules.md

@@ -1,161 +0,0 @@
-# 开票字段提取规则
-
-## 什么时候读取
-
-AI 需要从用户输入中推断税率、计算金额、校验字段格式，或判断发票类型时读取本文件。
-
----
-
-## 税率推断规则
-
-### 13% — 销售货物、有形动产租赁
-
-| 关键词 | 典型商品 |
-|--------|---------|
-| 货物/商品/材料/配件/零件 | 各类实物商品 |
-| 设备/机器/仪器/电子产品 | 机械设备、电器 |
-| 食品/饮料/酒水/药品 | 食品医药 |
-| 服装/家具/钢材/水泥/建材 | 服装建材 |
-| 动产租赁/设备租赁 | 有形动产经营租赁 |
-
-### 9% — 建筑服务、交通运输、不动产
-
-| 关键词 | 典型服务 |
-|--------|---------|
-| 建筑/施工/装修/安装/工程 | 建筑安装 |
-| 运输/物流/快递/搬运 | 交通运输 |
-| 不动产/房屋/房租/土地 | 不动产 |
-| 农产品/自来水/天然气 | 农产品等 |
-
-### 6% — 现代服务、生活服务
-
-| 关键词 | 典型服务 |
-|--------|---------|
-| 咨询/顾问/策划/技术/研发 | 咨询技术 |
-| 软件/系统/SaaS/信息/数据 | 信息技术 |
-| 设计/广告/营销/培训 | 文化创意 |
-| 餐饮/住宿/旅游/物业 | 生活服务 |
-| 会计/审计/法律/检测 | 鉴证服务 |
-| 金融/保险/代理/中介 | 金融经纪 |
-
-### 3% — 小规模纳税人
-
-用户明确说"3%"或"小规模"时使用。
-
-### 推断优先级
-
-1. 用户明确指定的税率 → 最高优先
-2. 商品名称关键词匹配 → 按上表
-3. 多关键词冲突 → 取最相关（如"建筑材料"→13% 因为是货物销售）
-4. 无法确定 → 展示常见选项让用户选
-
-### 展示格式
-
-```
-根据商品名称"{goods_name}"，AI 推断：
-- 适用税率：{X}%
-其他常见税率：13%（货物）| 9%（建筑/交通）| 6%（服务）| 3%（小规模）
-如税率不正确请告知，否则将按 {X}% 计算。
-```
-
-多个明细行时每行独立推断，一次性展示所有。
-
----
-
-## 金额计算规则
-
-### 已知含税金额
-
-```
-不含税金额 = round(含税金额 / (1 + 税率), 2)
-税额 = 含税金额 - 不含税金额
-```
-
-### 已知不含税金额
-
-```
-税额 = round(不含税金额 × 税率, 2)
-含税金额 = 不含税金额 + 税额
-```
-
-### 单价计算
-
-```
-不含税单价 = round(不含税金额 / 数量, 合理精度)
-```
-
-### 合计
-
-```
-totalAmount = sum(每行 amount)
-taxAmount = sum(每行 taxAmount)
-totalAmountWithTax = sum(每行 amountWithTax)
-```
-
-### 尾差处理
-
-```
-允许尾差 = |amountWithTax - amount - taxAmount| <= 0.06
-```
-
-超出范围提示用户核实。
-
----
-
-## 校验规则
-
-| 规则 | 说明 |
-|------|------|
-| 购方名称必填 | 所有发票类型 |
-| 购方税号 | 专票必填；普票可选；无税号时强制普票 |
-| 税号格式 | 15/18/20位，数字+大写字母。正则：`^[0-9A-Z]{15}$\|^[0-9A-Z]{18}$\|^[0-9A-Z]{20}$` |
-| 明细至少一行 | details 不能为空 |
-| 税率合法性 | 0 / 0.01 / 0.03 / 0.05 / 0.06 / 0.09 / 0.13 |
-| 金额平衡 | amountWithTax = amount + taxAmount（允许尾差 ≤ 0.06） |
-| 合计平衡 | 明细行 amount 之和 = totalAmount |
-
----
-
-## 购方信息提取模式
-
-| 用户表述 | 提取目标 |
-|---------|---------|
-| "给XX公司开票" / "购方XX" | purchaserName |
-| "税号XXXX" / "纳税人识别号XXXX" | purchaserTaxNo |
-| "地址：XX路XX号" | purchaserAddress |
-| "电话XXX" | purchaserTel |
-| "开户行XX银行" | purchaserBankName |
-| "账号XXXX" | purchaserBankAccount |
-
-### 从文档/图片提取
-
-| 位置 | 提取目标 |
-|------|---------|
-| 合同甲方/乙方/购买方 | purchaserName |
-| 统一社会信用代码 | purchaserTaxNo |
-| 联系地址/通讯地址 | purchaserAddress |
-| 联系电话 | purchaserTel |
-| 开户银行 | purchaserBankName |
-| 银行账号 | purchaserBankAccount |
-
----
-
-## 商品明细提取
-
-### 从 Excel 表头匹配
-
-| 表头关键词 | 映射字段 |
-|-----------|---------|
-| 商品名称/品名/项目名称 | goods_name |
-| 规格/规格型号 | specification |
-| 单位/计量单位 | unit |
-| 数量 | quantity |
-| 单价/不含税单价 | unit_price |
-| 金额/不含税金额/含税金额 | amount_raw |
-| 税率 | tax_rate |
-
-### externalDocumentNo 生成规则
-
-用户未提供时自动生成：`AI-{YYYYMMDD}-{HHmmss}-{4位随机}`
-
-用户提供合同号/订单号时优先使用。

package/skills/weaver-e10-yepiaotong/references/invoice-issuing.md

@@ -1,107 +0,0 @@
-# 智能开票与存台账
-
-## 什么时候读取
-
-用户要求开票、开发票、开专票、开普票、填开发票、存台账，或已经给出开票字段并要求提交到业票通时读取本文件。
-
-## Operation
-
-| 阶段 | Operation | 风险 |
-| --- | --- | --- |
-| 准备开票或存台账 | `invoice.issuing.make.prepare` | read-before-write |
-| 确认提交 | `invoice.issuing.make.apply` | high-risk-write |
-
-## 输入要点
-
-`mode` 必填：
-
-- `issue`：正式开票，CLI 会确保 `operateType` 不传。
-- `ledger`：仅存入待开台账，CLI 会固定 `operateType="5"`。
-
-`payload` 是已整理好的 `MakeInvoiceReqDTO`。核心字段至少包括购方名称、发票类型、外部单号、金额合计和一条商品明细。专票或全电纸质专票必须提供购方税号。
-
-### 购方信息补齐
-
-修正后的资料包没有提供客户档案查询 operation。组装 payload 前，Agent 只能从用户输入、附件内容或对话上下文提取购方信息；资料不足时必须追问用户补齐，不要调用 `invoice.customer.*` 或绕过 CLI 查询原始接口。
-
-- 个人普票：`invoiceType="7"`，`personLogo="1"`，无需税号。
-- 企业专票或需要企业抬头时：必须由用户或附件提供购方名称、税号；地址、电话、开户行和账号有明确来源时才填入，没有来源不要编造。
-- 从附件提取购方信息前，必须先提醒用户文件内容可能进入当前大模型上下文，并可能发送到解析服务，等待明确确认后再处理。
-
-销方为 CLI 内置固定值（当前版本固定为销方名称 `上海泛微网络科技股份有限公司`、销方税号 `9131000070322836XD`，非按当前 E10 租户动态解析），Agent 无需也不应自行构造或改写销方字段；CLI 会一并补齐 `billingType="0"`、`sourceType="4"`、`asyncCallFlag="1"`、`invoiceMethod="5"`、`taxSign="1"`。Agent 不要把 Cookie、ETEAMSID、业务 Token 或认证字段放入 payload。
-
-## 命令
-
-简单 payload 可直接传 `--input-json`。
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"8","externalDocumentNo":"AI-EXAMPLE-001","purchaserName":"XX科技有限公司","purchaserTaxNo":"91310000MA1234AB56","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","revenueCode":"3040205","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]}}'
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"8","externalDocumentNo":"AI-EXAMPLE-001","purchaserName":"XX科技有限公司","purchaserTaxNo":"91310000MA1234AB56","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","revenueCode":"3040205","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]}}'
-```
-
-复杂 payload 建议保存为 UTF-8 JSON 文件。
-
-Windows PowerShell：
-
-```powershell
-Set-Content -Encoding utf8 -LiteralPath .\issuing.json -Value @'
-{
-  "mode": "issue",
-  "payload": {
-    "invoiceType": "8",
-    "externalDocumentNo": "AI-EXAMPLE-001",
-    "purchaserName": "XX科技有限公司",
-    "purchaserTaxNo": "91310000MA1234AB56",
-    "totalAmount": 100,
-    "taxAmount": 6,
-    "totalAmountWithTax": 106,
-    "details": [{"goodsName":"信息技术咨询服务","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]
-  }
-}
-'@
-weaver-work-cli --json invoice run invoice.issuing.make.prepare --input .\issuing.json
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-cat > ./issuing.json <<'JSON'
-{
-  "mode": "issue",
-  "payload": {
-    "invoiceType": "8",
-    "externalDocumentNo": "AI-EXAMPLE-001",
-    "purchaserName": "XX科技有限公司",
-    "purchaserTaxNo": "91310000MA1234AB56",
-    "totalAmount": 100,
-    "taxAmount": 6,
-    "totalAmountWithTax": 106,
-    "details": [{"goodsName":"信息技术咨询服务","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]
-  }
-}
-JSON
-weaver-work-cli --json invoice run invoice.issuing.make.prepare --input ./issuing.json
-```
-
-## 确认链
-
-`.prepare` 返回 `preview`、`normalizedPayload`、`continuation` 和 `workflow.state="AWAITING_CONFIRMATION"`。向用户展示发票类型、购方名称、税号、外部单号、明细数量、合计不含税、税额和价税合计；用户明确确认开票或存台账后，再用相同 payload、continuation 和 `confirm=true` 调用 `.apply`。
-
-## 输出处理
-
-`.apply` 成功返回 `mode`、`serialNo`、`orderNo`、`ledgerOnly` 和原始响应。正式开票时说明申请已提交；存台账时说明已保存为待开台账。接口失败时展示业务错误原因，不自动重试。
-
-## 注意
-
-正式开票是高风险且不可逆的业务写入。同一 continuation 只服务一次确认场景；如果用户修改购方、金额、税率或明细，必须重新 prepare。
-
-字段提取、税率推断和金额计算由 Agent 在调用 CLI 前完成。原始税号、金额、名称、编码等值必须逐字符保留；不要为了“补齐位数”或“格式化”改写用户或接口给出的 ID、日期和金额。
-
-如果用户提供 Excel、Word、TXT、图片或截图来提取开票字段，解析前必须先提醒用户：文件内容可能进入当前大模型上下文，并可能发送到解析服务；必须等待明确确认。

package/skills/weaver-e10-yepiaotong/references/reim-fast-path.md

@@ -1,119 +0,0 @@
-# 报销快速路径（0.1.13 新增 operation）
-
-> 三个新 operation 把「查票 → 分类 → 组 payload → prepare」压成两步，人工只保留确认 + apply。
-> 固化映射来自 2026-09-14 / 2026-09-21 两次真实 apply 成功的「总部费用报销」单据，只覆盖该流程。
-
-## 1. `invoice.reim.candidates.list`（read）— 票夹候选分类
-
-自动翻页拉取未报销（sreim=3）发票，并按 `oreim.list_reim` / 红冲状态分成三组，**不再需要手动翻页和逐条剔重**：
-
-macOS/Linux（bash）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"date_begin":"2026-09-14","date_end":"2026-09-21"}'
-```
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.candidates.list --input-json '{"date_begin":"2026-09-14","date_end":"2026-09-21"}'
-```
-
-- 入参（全部可选）：`date_begin`/`date_end`（YYYY-MM-DD，开票日期范围）、`page_size`（10-200，默认 50）、`max_items`（1-500，默认 200，超出截断并产生 warning）、`include_red_reversed`（默认 `false`）。
-- **红冲票默认已过滤**：全额红冲发票（`status=8`）不可报销，默认**不出现在结果里任何一组**，被过滤的张数由 `summary.filteredRedReversedCount` 告知（不会静默丢弃）。需要看红冲票时传 `include_red_reversed: true`，此时它们进 `redReversed` 组。
-- 过滤发生在翻页循环内部：即使某一页全是红冲票也会继续翻页，直到凑够 `max_items` 张**可用**发票或数据取完，因此 `fetched` 只计保留下来的发票数、`total` 仍是接口返回的符合条件的总张数。
-- 输出：`available` / `assigned` / `redReversed` 三组（后一组默认恒为空），每组元素含 `fid`、`number`、`date`、`total`、`buyer`、`payer`、`typeName`、`status`、`valid`、`reimRequests`；`summary` 给出三组的张数与金额合计，外加 `filteredRedReversedCount`；`warnings` 含截断与金额解析告警。
-- **报销范围永远从 `available` 里选**；`assigned` 是已挂单的（重复提交 = 重复报销）。
-- **⚠️ 关于"两次连续查询之间 assigned↔available 翻转"（2026-09-21 已定位，结论：分类是准的，不是误判）**：同一天内观察到 25 张发票从 `assigned` 翻到 `available`，一度被怀疑是 `oreim.list_reim` 缓存滞后。最终用 `workflow.detail` 逐个复核 requestId 后定案：`1313947830149185538`（报销单 2026-09-11）、`1314910388070170941`（2026-09-14）、`1317591500119752761`（当天新建）**均返回"流程已被删除"**，10+15+2 张发票随之释放。⇒ **翻转的根因是报销单被删除，发票真实释放，`candidates.list` 的三分类如实反映了状态变化。**
-  - **因此不要每次报销都对每张入选票再跑一次 `invoice.get` 复核 `oreim.list_reim`** —— 那会让快速路径失去意义。只有在**观察到异常翻转**（或对某张票的归属存疑）时才做核实，正确顺序是：`weaver-work-cli workflow run workflow.detail --input-json '{"requestId":"<id>"}'` 查单据是否还存在（被删的单会明确返回"流程已被删除"）→ 再用 `invoice.get` 看 `oreim.list_reim`。
-  - **已知局限**：`list_reim` 元素只有报销单**名称**（无 requestId、无单号、无单据状态），`reimRequests` 里拿不到能直接喂给 `workflow.detail` 的 id。要核实只能先按名称用 `workflow.search` 找 requestId —— 注意**被删除的单在 `workflow.search` 里搜不到**，这本身就是一个"单可能已被删"的信号，但无法区分"从未存在"与"已被删除"。
-  - 另一个易踩点：`sreim="3"`（未报销）**不会**把挂单中的发票排除掉（实测 13 张挂单票仍出现在 `sreim=3` 的 39 张结果里），所以不能靠 `sreim` 判断是否已挂单，分类必须看 `list_reim`。
-
-## 2. `invoice.reim.template.build`（read）— 固化模板组装 payload
-
-输入发票 ID 列表 + 标题，一条命令产出完整 `payload`（19 个主表字段 + N 行明细）。内部自动完成：取上级（`directSuperior`）→ 解析候选工作流（或用传入 `workflowId`）→ 取表单结构并**按名称定位「费用明细」子表** → 批量取发票详情与行预填。
-
-macOS/Linux（bash）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.template.build --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
-```
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.template.build --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
-```
-
-- 入参：`invoiceIds`（必填，1-100 个，顺序 = 明细行顺序）、`requestName`（必填，≤100 字）；可选 `workflowId`（不传则自动解析唯一候选流程）、`reason`（报销事由，缺省用 requestName）、`relatedCustomerId`、`relatedCustomerName`、`contractNo`（**默认值 `"20260999"`，视为必传**）。
-- **⚠️ `contractNo` 默认填 `"20260999"`，不能省略**：主表 `合同号(100003720000001376)` 只有在入参给了 `contractNo` 时才写进 `payload.main_fields`（不传时该字段**整条缺失**，实测同一票同参数：不传 18 个主表字段，传 `"contractNo":"20260999"` 后 19 个），报销单里它会留空**且 `warnings` 不会提示**，属于静默漏填。
-- **默认值口径与 [`reim-form-fill-rules.md`](reim-form-fill-rules.md) 的主表字段映射表一致**：合同编号 = 固定值 `"20260999"`。**除非用户明确给出别的合同号，否则一律填 `"20260999"`** —— 快速路径也必须遵守这条，不能因为「入参可选」就留空。
-- 用户另有指定时以用户指定为准；用户明确说"不填合同号"时才允许留空。
-- 输出：`payload`（可直接喂给 `flow.create.prepare` / apply）、`preview`、`labels`、`warnings`。
-  - `preview.mainFields[]` / `preview.detailRows[]`：**已把字典类 ID 渲染成「中文(id)」，预览直接展示这两项即可，不必再查名**（详见 `reim-workflow.md` Step 4.7）。
-  - `labels`：`employees` / `subjects` / `currencies` / `customers` / `selectOptions` / `customer` / `detailSubForm` / `workflow` 字典；`labels.unresolved` 为没取到中文名的 ID 清单，非空时如实展示并提醒用户核对。
-  - 相关客户只给名称也行：传 `relatedCustomerName`（不传 ID 时 CLI 反查 ID；ID + 名称同传则不额外请求，仅用于渲染）。
-- 行为细节（与 2026-09 实测口径一致）：
-  - 报销人上级 / 承担人直接上级 = `directSuperior.id`（**不是 allSuperiors[0]**）；承担人所有上级 = allSuperiors 全部 id 逗号拼接。
-  - 费用明细子表优先按名称「费用明细」匹配，兜底按「相关发票」字段结构签名匹配。
-  - 费用说明自动去掉 `*`；科目缺省「日常消费」；币种人民币；报销方式银行（optionValue "7"）。
-  - 发票已挂单 → warning；发票全额红冲（status=8）或金额合计为 0 → **直接报错拒绝组装**。
-  - `relatedCustomerId` 不传会留空并产生 warning（E10 apply 时可能因必填校验失败，非出差场景建议传）。
-- 模板只固化了「总部费用报销」(`100003460000000060`) 的字段映射。若解析到的候选流程不是它，字段映射可能不适用 —— 此时**改走 `reim-workflow.md` 的手工组装路径**。
-
-## 3. `invoice.reim.flow.create.auto-prepare`（read-before-write）— 一站式 prepare
-
-与 `template.build` 相同的入参，组装 payload 后**直接签发 `flow.create.apply` 的 continuation**，一步到 `AWAITING_CONFIRMATION`：
-
-macOS/Linux（bash）：
-
-```bash
-weaver-work-cli --json invoice run invoice.reim.flow.create.auto-prepare --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
-```
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.reim.flow.create.auto-prepare --input-json '{"invoiceIds":["1317524773561163780","1317524747581644831"],"requestName":"烧烤调料及托盘采购报销-龚为明-2026-09-21（共2笔）","relatedCustomerId":"100504500000311504","contractNo":"20260999"}'
-```
-
-输出含 `payload` + `preview` + `labels` + `continuation` + `expiresInSeconds: 600`。**用户确认后**，把 payload 的字段**展开到顶层**（即 `work_flow_id` / `mainFormId` / `request_name` / `main_fields` / `detail_rows` / `need_user_confirm` / `unable_to_fill`），再补 `continuation` 与 `confirm: true`，交给 `invoice.reim.flow.create.apply` 提交。**不要写成 `{"payload": {...}, "continuation": ...}` 的嵌套结构**（`reim-api-reference.md` 第 7 节已明确「不要再包一层通用 payload」）。
-
-## 推荐流程（快速路径）
-
-```
-candidates.list（选 available）
-  → 向用户展示汇总并确认范围
-  → auto-prepare（或 template.build + flow.create.prepare）  ← 必带 relatedCustomerId + contractNo:"20260999"（用户另有指定时用其值）
-  → 展示 preview + warnings（**ID 一律带中文名，见 `reim-workflow.md` Step 4.7**），等用户确认
-  → flow.create.apply（展开 payload 到顶层 + continuation + confirm=true）
-  → 回查验证（candidates.list 或 invoice.list）
-```
-
-人工确认环节不可跳过：apply 是 high-risk-write，金额、抬头、明细、上级必须经过用户核对。
-
-> **apply 入参改用 `--input <path>` 时的解析坑（0.1.18 实测）**：stdout 会在 JSON **之前多出一行** `[weaver-work-cli] 使用 --input <path> 读取 JSON 文件；多步传递请优先用 --input-ref，简单数据请用 --input-json。`。脚本解析必须先定位第一个 `{` 再 `JSON.parse`，直接解析会抛 `Unexpected token 'w'`。
-
-> **continuation 只有 600 秒有效期**：`prepare` / `auto-prepare` 签发后要尽快 `apply`，中间不要插入文档查询、多轮确认或其它耗时命令，否则会返回 `validation/continuation_expired`。遇到过期**重新 `prepare` 后立即 `apply`** 即可（用户已确认过的内容无需重新征询），**不要重放旧 continuation**。
-
-## 快速路径适用判断
-
-Agent 在决定走快速路径还是手工路径时，按以下规则判断：
-
-| 条件 | 走快速路径 | 走手工路径 |
-|------|------------|------------|
-| `workflow.resolve` 返回的 workFlowId = `100003460000000060`（总部费用报销） | ✅ | — |
-| workFlowId 不是 `100003460000000060` | — | ✅ |
-| `template.build` 返回 error 含 `structure_invalid` 或字段映射异常 | — | ✅（自动回退） |
-| 需要逐字段精细控制（如手动指定某行的费用科目） | — | ✅ |
-| 有事前申请需要绑定 | — | ✅（模板不做事前绑定） |
-| 无事前申请 + 总部费用报销流程 | ✅（优先） | — |
-
-> **⚠️ 快速路径的 `template.build` 和 `auto-prepare` 已内置挂单检查**：如果某张发票已挂在其他报销单上，`warnings` 会明确告知"继续组装存在重复报销风险"，Agent 应展示给用户确认。
-
-> **⚠️ 0.1.19 起 `contractNo` 默认值**：CLI 未收到 `contractNo` 入参时自动使用 `"20260999"` 并产生 warning，不再静默缺失。但仍建议显式传入以确保意图明确。
-
-## 与手工路径的关系
-
-- `invoice.reim.requests.list`（事前申请匹配）仍按 `reim-matching-rules.md` 走，模板不做事前申请绑定。
-- 其他流程（出差报销等）或需要逐字段精细控制的场景，仍走 `reim-workflow.md` / `reim-form-fill-rules.md` 的手工组装路径。