weaver-work-cli 0.1.26 → 0.1.29

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';
-export 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;
-}
-export 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;
-}
-export 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;
-}
-export 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: { invoiceReq: 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-qys-ledger.md

@@ -1,66 +0,0 @@
-# 契约锁开票台账开票
-
-## 什么时候读取
-
-用户要按契约锁合同开票、按合同号开票、从“契约锁合同商品信息”台账开票，或说“把 XX 公司那份合同开了”“开一下合同 20266105541 的票”时读取本文件。用户自己口述购方、金额、明细的开票不走本文件，改读 `invoice-issuing.md`。
-
-## Operation
-
-| 阶段 | Operation | 风险 |
-| --- | --- | --- |
-| 查询待开票台账行 | `invoice.issuing.qys.list` | read |
-| 按台账行组装开票入参并预览 | `invoice.issuing.qys.prepare` | read-before-write |
-| 确认开票或存台账 | `invoice.issuing.make.apply` | high-risk-write |
-| 查询异步开票结果 | `invoice.issuing.result` | read |
-
-## 组装规则（CLI 固化，Agent 不参与计算）
-
-- 一行台账开一张发票，外部单号固定为 `QYS-{formDataId}`。
-- 台账“开票金额”和“商品单价”是**不含税**金额：`taxSign="0"`，税额 = 金额 × 税率（四舍五入到分），价税合计 = 金额 + 税额。
-- 商品名称优先取“开票名称”，为空时取“商品名称”；税率取台账“商品税率”（如 `6.0%` → 0.06）。
-- 发票类型取台账“发票类型”的选项 ID（如全电专票 = `8`）；购方名称、税号、地址、电话、开户行、账号按台账原值透传，空值不填。
-- 销方固定为上海泛微网络科技股份有限公司。
-- 已有发票号码、已关联开票流程、开票中金额大于 0 或已废弃的行，`qys.list` 默认不返回，`qys.prepare` 直接拒绝。
-
-Agent **不得**自行修改预览里的金额、税率、税号或商品名称。用户要改，先让用户去台账改数据，再重新 `qys.prepare`。
-
-## 对话流程
-
-1. 用户给出合同号时传 `contractNo`；给出公司名、合同名等线索时传 `keyword`。调用 `invoice.issuing.qys.list`。
-2. 命中 0 行：告诉用户没有可开票的行；如果用户坚持该合同存在，可加 `includeIssued=true` 再查一次，展示 `blockers` 说明为什么不能开。
-3. 命中多行：列出合同号、合同审批流程名称、购方名称、商品、开票金额（不含税）、税率，让用户选择。不要替用户选。
-4. 用户选定后调用 `invoice.issuing.qys.prepare`，`mode` 默认 `issue`；用户说“先存台账/先不开”时用 `ledger`。
-5. 向用户展示预览：合同号、合同审批流程名称、购方名称、购方税号、发票类型、商品名称、税率、不含税金额、税额、价税合计。`warnings` 非空时逐条列出并询问是否仍然继续。
-6. 用户明确回复“确认开票”或同义确认后，把 `normalizedPayload` 原样作为 `payload`，连同 `continuation`、`confirm=true` 调用 `invoice.issuing.make.apply`。
-7. 正式开票成功后，用 `preview.externalDocumentNo` 调一次 `invoice.issuing.result`：`SUCCESS` 时展示发票号码；`PENDING` 时说明开票中、稍后再查；`FAILED` 时展示 `returnMessage`。不要循环轮询。
-
-## 命令
-
-Windows PowerShell：
-
-```powershell
-weaver-work-cli --json invoice run invoice.issuing.qys.list --input-json '{"keyword":"南昌我爱我家"}'
-weaver-work-cli --json invoice run invoice.issuing.qys.prepare --input-json '{"formDataId":"1328267444527472669","mode":"issue"}'
-weaver-work-cli --json invoice run invoice.issuing.result --input-json '{"externalDocumentNo":"QYS-1328267444527472669"}'
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-weaver-work-cli --json invoice run invoice.issuing.qys.list --input-json '{"keyword":"南昌我爱我家"}'
-weaver-work-cli --json invoice run invoice.issuing.qys.prepare --input-json '{"formDataId":"1328267444527472669","mode":"issue"}'
-weaver-work-cli --json invoice run invoice.issuing.result --input-json '{"externalDocumentNo":"QYS-1328267444527472669"}'
-```
-
-`invoice.issuing.make.apply` 的 `payload` 较长，按 `invoice-issuing.md` 的做法先把 `{"payload":<normalizedPayload>,"continuation":"<continuation>","confirm":true}` 写入 UTF-8 JSON 文件，再用 `--input <path>` 传入。
-
-## 输出处理
-
-- `qys.list` 返回 `items[]`（可读字段 + `issuable` + `blockers`）、`matched`、`truncated`、`scanned`、`scanComplete`。`scanComplete=false` 表示台账超过扫描上限，需提醒用户结果可能不全。
-- `qys.prepare` 返回 `preview`、`warnings`、`ledgerRow`、`normalizedPayload`、`continuation`。只给用户看 `preview` 和 `warnings`，不要贴完整 JSON。
-- `make.apply` 失败或连接中断时按 `invoice-issuing.md` 处理，**禁止自动重试**；同一台账行的外部单号固定，重复提交会被后端识别。
-
-## 注意
-
-- 当前版本开票后不会自动回写台账的发票号码、开票时间等字段；向用户说明需要在台账侧另行处理。
-- 正式开票是不可逆的高风险写入；同一 continuation 只服务一次确认，用户改了台账数据必须重新 `qys.prepare`。

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、图片或截图来提取开票字段，解析前必须先提醒用户：文件内容可能进入当前大模型上下文，并可能发送到解析服务；必须等待明确确认。