weaver-work-cli 0.1.0

package/dist/shortcuts/invoice/manifest.js

@@ -0,0 +1,288 @@
+const listProperties = {
+    page_size: { type: 'integer', minimum: 1, maximum: 200 },
+    start_pos: { type: 'integer', minimum: 0 },
+    req_type: { type: 'integer', enum: [0, 1, 7, 8] },
+    mask: { type: 'integer', minimum: 0 },
+    mext: { type: 'integer', minimum: 0 },
+    content: { type: 'string' },
+    types: { type: 'array', items: { type: 'integer' } },
+    date_begin: { type: 'integer', minimum: 0 },
+    date_end: { type: 'integer', minimum: 0 },
+    create_tm_begin: { type: 'integer', minimum: 0 },
+    create_tm_end: { type: 'integer', minimum: 0 },
+    payer_company: { type: 'string' },
+    buyer_company: { type: 'string' },
+    payer_taxno: { type: 'string' },
+    buyer_taxno: { type: 'string' },
+    code: { type: 'string' },
+    number: { type: 'string' },
+    total_begin: { type: 'string', pattern: '^\\d+(\\.\\d{1,2})?$' },
+    total_end: { type: 'string', pattern: '^\\d+(\\.\\d{1,2})?$' },
+    attribute: { type: 'integer', enum: [0, 1, 2] },
+    sreim: {
+        type: 'integer',
+        enum: [0, 1, 2, 3, 4],
+        default: 3,
+        description: '报销状态：0=全部发票，1=发票报销中，2=报销完成，3=未报销发票，4=不可报销',
+    },
+    valids: { type: 'array', items: { type: 'integer', enum: [0, 1, 2, 3, 4, 5] } },
+    sources: { type: 'array', items: { type: 'integer' } },
+    is_lian: { type: 'integer', enum: [0, 1, 2] },
+    is_modify: { type: 'integer', enum: [0, 1, 2] },
+    tag_ids: { type: 'array', items: { type: 'integer' } },
+    tag_condition_type: { type: 'integer', enum: [0, 1] },
+    sorts: {
+        type: 'array',
+        items: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                sort_type: { type: 'integer', enum: [0, 1, 2, 5, 8, 9, 10] },
+                sort: { type: 'integer', enum: [0, 1] },
+            },
+            required: ['sort_type', 'sort'],
+        },
+    },
+    bill_type: { type: 'integer' },
+};
+export const invoiceOperations = [
+    {
+        name: 'invoice.list',
+        risk: 'read',
+        scope: 'personal',
+        fixed: { flag: 0, defaultSreim: 3 },
+        inputSchema: { type: 'object', additionalProperties: false, properties: listProperties },
+    },
+    {
+        name: 'invoice.enterprise.list',
+        risk: 'read',
+        scope: 'enterprise',
+        fixed: { flag: 6, defaultSreim: 3 },
+        inputSchema: { type: 'object', additionalProperties: false, properties: listProperties },
+    },
+    {
+        name: 'invoice.get',
+        risk: 'read',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                fid: { type: 'string', pattern: '^[1-9]\\d*$' },
+                number: { type: 'string', minLength: 1 },
+            },
+            oneOf: [{ required: ['fid'] }, { required: ['number'] }],
+        },
+    },
+    {
+        name: 'invoice.upload',
+        risk: 'external-artifact',
+        fixed: { ocr: 1 },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                file: { type: 'string', minLength: 1 },
+                url: { type: 'string', format: 'uri' },
+            },
+            oneOf: [{ required: ['file'] }, { required: ['url'] }],
+        },
+    },
+    {
+        name: 'invoice.ocr.preview',
+        risk: 'read-with-upload',
+        fixed: { flag: 13, is_save: 1, is_sync: 1, operate_type: 0 },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                file: { type: 'string', minLength: 1 },
+                url: { type: 'string', format: 'uri' },
+                upload: { type: 'object' },
+                is_save: { const: 1 },
+            },
+            oneOf: [{ required: ['file'] }, { required: ['url'] }, { required: ['upload'] }],
+        },
+    },
+    {
+        name: 'invoice.validate.preview',
+        risk: 'external-read',
+        fixed: { flag: 100, is_save: 1, needLog: false },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                fid: { type: 'string', pattern: '^[1-9]\\d*$' },
+                scope: { type: 'string', enum: ['personal', 'enterprise'] },
+            },
+            required: ['fid', 'scope'],
+        },
+    },
+    {
+        name: 'invoice.import.prepare',
+        risk: 'read-before-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                file: { type: 'string', minLength: 1 },
+                validate: { type: 'boolean' },
+                syncToOa: { type: 'boolean' },
+            },
+            required: ['file', 'validate', 'syncToOa'],
+        },
+    },
+    {
+        name: 'invoice.import.apply',
+        risk: 'high-risk-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                file: { type: 'string', minLength: 1 },
+                continuation: { type: 'string', minLength: 1 },
+                confirm: { const: true },
+            },
+            required: ['file', 'continuation', 'confirm'],
+        },
+    },
+    {
+        name: 'invoice.add.prepare',
+        risk: 'read-before-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                info: { type: 'object' },
+                scope: { type: 'string', enum: ['personal', 'enterprise'] },
+            },
+            required: ['info', 'scope'],
+        },
+    },
+    {
+        name: 'invoice.add.apply',
+        risk: 'high-risk-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                info: { type: 'object' },
+                continuation: { type: 'string', minLength: 1 },
+                confirm: { const: true },
+            },
+            required: ['info', 'continuation', 'confirm'],
+        },
+    },
+    {
+        name: 'invoice.update.prepare',
+        risk: 'read-before-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                fid: { type: 'string', pattern: '^[1-9]\\d*$' },
+                scope: { type: 'string', enum: ['personal', 'enterprise'] },
+                changes: {
+                    type: 'object',
+                    minProperties: 1,
+                    additionalProperties: false,
+                    properties: {
+                        code: { type: 'string', maxLength: 500 },
+                        number: { type: 'string', minLength: 1, maxLength: 500 },
+                        'comm_info.pro.date': { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+                        'comm_info.price.amount': { type: 'string', pattern: '^\\d+(\\.\\d{1,2})?$' },
+                        'comm_info.price.total': { type: 'string', pattern: '^\\d+(\\.\\d{1,2})?$' },
+                        'comm_info.price.dtax': { type: 'string', pattern: '^\\d+(\\.\\d{1,2})?$' },
+                        'comm_info.buyer.company': { type: 'string', maxLength: 500 },
+                        'comm_info.buyer.tcode': { type: 'string', maxLength: 500 },
+                        'comm_info.payer.company': { type: 'string', maxLength: 500 },
+                        'comm_info.payer.tcode': { type: 'string', maxLength: 500 },
+                        fylx: { type: 'string', maxLength: 500 },
+                        currency: { type: 'string', maxLength: 500 },
+                        currencyName: { type: 'string', maxLength: 500 },
+                    },
+                },
+            },
+            required: ['fid', 'scope', 'changes'],
+        },
+    },
+    {
+        name: 'invoice.update.apply',
+        risk: 'high-risk-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                continuation: { type: 'string', minLength: 1 },
+                confirm: { const: true },
+            },
+            required: ['continuation', 'confirm'],
+        },
+    },
+    {
+        name: 'invoice.download',
+        risk: 'local-file-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                fid: { type: 'string', pattern: '^[1-9]\\d*$' },
+                fileId: { type: 'string', pattern: '^[1-9]\\d*$' },
+                output: { type: 'string', minLength: 1 },
+            },
+            required: ['fid', 'fileId', 'output'],
+        },
+    },
+    {
+        name: 'invoice.delete.prepare',
+        risk: 'read-before-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                fid: { type: 'string', pattern: '^[1-9]\\d*$' },
+                scope: { type: 'string', enum: ['personal', 'enterprise'] },
+            },
+            required: ['fid'],
+        },
+    },
+    {
+        name: 'invoice.delete.apply',
+        risk: 'high-risk-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                continuation: { type: 'string', minLength: 1 },
+                confirm: { const: true },
+            },
+            required: ['continuation', 'confirm'],
+        },
+    },
+];
+export const invoiceManifest = {
+    schemaVersion: 1,
+    name: 'invoice',
+    title: '泛微E10业票通发票管理',
+    version: '0.1.0',
+    host: 'e10-invoice',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-yepiaotong',
+    operations: invoiceOperations,
+    withheldOperations: [
+        {
+            name: 'invoice.share',
+            reason: '缺少接收人 appid/cid/uid 的稳定解析来源和共享关系回查契约。',
+        },
+        {
+            name: 'invoice.transfer',
+            reason: '缺少接收人归属回查契约，转让会改变发票持有人，暂不让 Agent 猜测。',
+        },
+        {
+            name: 'invoice.tag',
+            reason: '缺少标签定义来源、当前关系查询和移除/替换语义。',
+        },
+    ],
+};
+export function hasInvoiceOperation(operation) {
+    return invoiceOperations.some((item) => item.name === operation);
+}

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

@@ -0,0 +1,106 @@
+import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
+import { addPreview, asPositiveString, assertNotDuplicate, detailInfo, getDetail, identityFingerprint, normalizeAddInfo, normalizeScope, objectFingerprint, operateType, preview, reqBase, sessionMatches, workflow, } from './shared.js';
+export class InvoiceAddPrepareOperation {
+    name = 'invoice.add.prepare';
+    async execute(input, { host, continuation }) {
+        const scope = normalizeScope(input.scope);
+        const info = normalizeAddInfo(input.info);
+        await assertNotDuplicate(info, host);
+        const session = await host.getSession();
+        const continuationToken = await continuation.issue({
+            operation: 'invoice.add.apply',
+            workflow: workflow('invoice.add', 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            scope,
+            fingerprint: objectFingerprint(info),
+            identity: identityFingerprint(info),
+            preview: addPreview(info, scope),
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview: addPreview(info, scope),
+                normalizedInfo: info,
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: workflow('invoice.add', 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}
+export class InvoiceAddApplyOperation {
+    name = 'invoice.add.apply';
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true)
+            throw invoiceConfirmationError('invoice.add.apply', { hint: '重新调用时传入 confirm=true' });
+        const lease = await continuation.verify(input.continuation, 'invoice.add.apply');
+        if (!lease.scope || typeof lease.fingerprint !== 'string' || typeof lease.identity !== 'string') {
+            throw invoiceValidationError('continuation_invalid', '新增 continuation 缺少有效上下文或发票指纹');
+        }
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session))
+            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备新增');
+        const info = normalizeAddInfo(input.info);
+        if (objectFingerprint(info) !== lease.fingerprint)
+            throw invoiceValidationError('target_changed', '待新增发票内容与确认时不一致，请重新准备新增');
+        await assertNotDuplicate(info, host);
+        let added;
+        try {
+            added = await host.invoiceRequest({
+                path: '/api/inc/add',
+                method: 'POST',
+                body: { infos: [info], operate_type: operateType(lease.scope), req_base: reqBase() },
+            });
+        }
+        catch (error) {
+            if (isInvoiceNetworkError(error)) {
+                throw invoicePartialError('新增请求发送后连接中断，结果不确定，禁止自动重试', {
+                    preview: lease.preview,
+                    workflow: workflow('invoice.add', 'EXECUTING'),
+                }, { stage: 'add' });
+            }
+            throw error;
+        }
+        const item = added?.infos?.[0];
+        if (!item) {
+            throw invoicePartialError('新增接口返回成功但缺少单张结果，结果不确定', {
+                preview: lease.preview,
+                result: added,
+                workflow: workflow('invoice.add', 'EXECUTING'),
+            }, { stage: 'add-response' });
+        }
+        if (item?.ret?.ret !== 0 || !item.info) {
+            throw new InvoiceCliError('api', 'add_item_failed', item?.ret?.message || '新增发票失败', {
+                code: item?.ret?.ret,
+                details: { result: item },
+                exitCode: 1,
+            });
+        }
+        const fid = asPositiveString(String(item.info.fid || item.info.id), '新增结果 fid');
+        let savedInfo;
+        try {
+            savedInfo = detailInfo(await getDetail({ fid }, host));
+        }
+        catch {
+            throw invoicePartialError('新增接口已返回成功，但详情回查失败，结果不确定', {
+                fid,
+                result: added,
+                workflow: workflow('invoice.add', 'VERIFYING'),
+            }, { stage: 'readback' });
+        }
+        if (identityFingerprint(savedInfo) !== lease.identity) {
+            throw invoicePartialError('新增后回查的票面身份字段不一致', {
+                fid,
+                result: added,
+                detail: preview(savedInfo),
+                workflow: workflow('invoice.add', 'VERIFYING'),
+            }, { stage: 'readback' });
+        }
+        return {
+            status: 'COMPLETE',
+            data: { fid, scope: lease.scope, saved: true, verified: true, info: savedInfo, result: added, workflow: workflow('invoice.add', 'COMPLETE') },
+        };
+    }
+}

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

@@ -0,0 +1,92 @@
+import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
+import { detailFingerprint, detailInfo, getDetail, normalizeScope, operateType, preview, reqBase, sessionMatches, workflow, } from './shared.js';
+export class InvoiceDeletePrepareOperation {
+    name = 'invoice.delete.prepare';
+    async execute(input, { host, continuation }) {
+        const scope = normalizeScope(input.scope || 'personal');
+        const result = await getDetail(input, host);
+        const info = detailInfo(result);
+        const item = preview(info);
+        const session = await host.getSession();
+        const continuationToken = await continuation.issue({
+            operation: 'invoice.delete.apply',
+            workflow: workflow('invoice.delete', 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            scope,
+            fid: item.fid,
+            fingerprint: detailFingerprint(info),
+            preview: item,
+        });
+        return { status: 'AWAITING_CONFIRMATION', data: { preview: item, continuation: continuationToken, expiresInSeconds: 600, workflow: workflow('invoice.delete', 'AWAITING_CONFIRMATION') } };
+    }
+}
+export class InvoiceDeleteApplyOperation {
+    name = 'invoice.delete.apply';
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true)
+            throw invoiceConfirmationError('invoice.delete.apply', { hint: '重新调用时传入 confirm=true' });
+        const lease = await continuation.verify(input.continuation, 'invoice.delete.apply');
+        if (typeof lease.fid !== 'string' || typeof lease.fingerprint !== 'string') {
+            throw invoiceValidationError('continuation_invalid', '删除 continuation 缺少有效目标或状态快照');
+        }
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session))
+            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备删除');
+        const info = detailInfo(await getDetail({ fid: lease.fid }, host));
+        if (detailFingerprint(info) !== lease.fingerprint)
+            throw invoiceValidationError('target_changed', '发票在确认后发生变化，请重新准备删除');
+        const p = info.comm_info?.pro || {};
+        if ((p.sreim ?? 0) !== 0 || (p.status ?? 0) !== 0 || (info.modify_info?.del ?? 0) !== 0) {
+            throw invoiceValidationError('invoice_not_deletable', '发票当前状态不允许删除', { status: preview(info) });
+        }
+        let deleted;
+        try {
+            deleted = await host.invoiceRequest({
+                path: '/api/inc/del',
+                method: 'POST',
+                body: { ids: [lease.fid], operate_type: operateType(lease.scope || 'personal'), flag: 0, req_base: reqBase() },
+            });
+        }
+        catch (error) {
+            if (isInvoiceNetworkError(error)) {
+                throw invoicePartialError('删除请求发送后连接中断，结果不确定，禁止自动重试', {
+                    attempted: [lease.fid],
+                    workflow: workflow('invoice.delete', 'EXECUTING'),
+                }, { stage: 'delete' });
+            }
+            throw error;
+        }
+        const failed = Array.isArray(deleted.fails) ? deleted.fails : [];
+        if (failed.length > 0) {
+            throw invoicePartialError('发票删除部分失败，结果不确定时禁止自动重试', {
+                attempted: [lease.fid],
+                failed,
+                workflow: workflow('invoice.delete', 'EXECUTING'),
+            }, { stage: 'delete' });
+        }
+        let verified = false;
+        try {
+            const after = await getDetail({ fid: lease.fid }, host);
+            verified = !after?.infos?.some((candidate) => candidate?.ret?.ret === 0 && candidate.info);
+        }
+        catch (error) {
+            if (error instanceof InvoiceCliError && error.type === 'api')
+                verified = true;
+            else {
+                throw invoicePartialError('删除接口已返回成功，但回查失败，结果不确定', {
+                    attempted: [lease.fid],
+                    workflow: workflow('invoice.delete', 'VERIFYING'),
+                }, { stage: 'readback' });
+            }
+        }
+        if (!verified) {
+            throw invoicePartialError('删除接口已返回成功，但回查仍发现发票，结果不确定', {
+                attempted: [lease.fid],
+                workflow: workflow('invoice.delete', 'VERIFYING'),
+            }, { stage: 'readback' });
+        }
+        return { status: 'COMPLETE', data: { deleted: [lease.fid], verified: true, result: deleted, workflow: workflow('invoice.delete', 'COMPLETE') } };
+    }
+}

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

@@ -0,0 +1,16 @@
+import { invoiceValidationError } from '../errors.js';
+import { asPositiveString, associatedFileIds, detailInfo, getDetail, resolveDownloadOutput, writeDownload, } from './shared.js';
+export class InvoiceDownloadOperation {
+    name = 'invoice.download';
+    async execute(input, { host }) {
+        const fid = asPositiveString(input.fid, 'fid');
+        const fileId = asPositiveString(input.fileId, 'fileId');
+        const info = detailInfo(await getDetail({ fid }, host));
+        if (!associatedFileIds(info).has(fileId))
+            throw invoiceValidationError('file_not_associated', 'fileId 不属于目标发票，拒绝下载');
+        const output = await resolveDownloadOutput(input.output);
+        const downloaded = await host.invoiceDownload({ id: fileId, fid, needLog: false });
+        await writeDownload(output, downloaded.content);
+        return { status: 'COMPLETE', data: { fid, fileId, output, size: downloaded.content.length, contentType: downloaded.contentType } };
+    }
+}

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

@@ -0,0 +1,7 @@
+import { getDetail } from './shared.js';
+export class InvoiceGetOperation {
+    name = 'invoice.get';
+    async execute(input, { host }) {
+        return { status: 'COMPLETE', data: await getDetail(input, host) };
+    }
+}

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

@@ -0,0 +1,128 @@
+import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
+import { asPositiveString, detailInfo, getDetail, importFile, importOptions, preview, sessionMatches, workflow, } from './shared.js';
+export class InvoiceImportPrepareOperation {
+    name = 'invoice.import.prepare';
+    async execute(input, { host, continuation }) {
+        const options = importOptions(input);
+        const prepared = await importFile(input);
+        const session = await host.getSession();
+        const filePreview = {
+            name: prepared.file.name,
+            size: prepared.size,
+            sha256: prepared.sha256,
+            validate: options.validate,
+            validationSkipped: !options.validate,
+            syncToOa: options.syncToOa,
+            targetScope: 'personal',
+        };
+        const continuationToken = await continuation.issue({
+            operation: 'invoice.import.apply',
+            workflow: workflow('invoice.import', 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            sha256: prepared.sha256,
+            options,
+            preview: filePreview,
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview: filePreview,
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: workflow('invoice.import', 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}
+export class InvoiceImportApplyOperation {
+    name = 'invoice.import.apply';
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true)
+            throw invoiceConfirmationError('invoice.import.apply', { hint: '重新调用时传入 confirm=true' });
+        const lease = await continuation.verify(input.continuation, 'invoice.import.apply');
+        if (!lease.options || typeof lease.options.validate !== 'boolean' || typeof lease.options.syncToOa !== 'boolean' || typeof lease.sha256 !== 'string') {
+            throw invoiceValidationError('continuation_invalid', '导入 continuation 缺少有效文件指纹或选项');
+        }
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session))
+            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备导入');
+        const prepared = await importFile(input);
+        if (prepared.sha256 !== lease.sha256)
+            throw invoiceValidationError('target_changed', '导入文件与确认时不一致，请重新准备导入');
+        const fields = { allSuccess: lease.options.validate ? '0' : '1' };
+        if (!lease.options.validate)
+            fields.filedMap = JSON.stringify({ isToOa: lease.options.syncToOa ? '1' : '0' });
+        let result;
+        try {
+            result = await host.invoiceMultipartRequest({
+                path: '/api/app/inc/biz/addInvoiceByFile',
+                fields,
+                file: prepared.file,
+                timeoutMs: 90_000,
+            });
+        }
+        catch (error) {
+            if (isInvoiceNetworkError(error)) {
+                throw invoicePartialError('导入请求发送后连接中断，结果不确定，禁止自动重试', {
+                    preview: lease.preview,
+                    workflow: workflow('invoice.import', 'EXECUTING'),
+                }, { stage: 'import' });
+            }
+            throw error;
+        }
+        const items = Array.isArray(result?.infos) ? result.infos : [];
+        if (!items.length) {
+            throw invoicePartialError('导入接口返回成功但没有逐张结果，结果不确定', {
+                preview: lease.preview,
+                result,
+                workflow: workflow('invoice.import', 'EXECUTING'),
+            }, { stage: 'import-response' });
+        }
+        const succeeded = items.filter((item) => item?.ret?.ret === 0 && (item.info?.fid || item.info?.id));
+        const failed = items.filter((item) => item?.ret?.ret !== 0 || !(item.info?.fid || item.info?.id));
+        if (!succeeded.length) {
+            throw new InvoiceCliError('api', 'import_failed', failed[0]?.ret?.message || '文件导入没有成功发票', {
+                code: failed[0]?.ret?.ret,
+                details: { failed },
+                exitCode: 1,
+            });
+        }
+        const verified = [];
+        for (const item of succeeded) {
+            const fid = asPositiveString(String(item.info.fid || item.info.id), '导入结果 fid');
+            try {
+                const info = detailInfo(await getDetail({ fid }, host));
+                verified.push({ fid, info });
+            }
+            catch {
+                throw invoicePartialError('导入已返回成功，但详情回查失败，结果不确定', {
+                    fids: succeeded.map((candidate) => String(candidate.info?.fid || candidate.info?.id)),
+                    result,
+                    workflow: workflow('invoice.import', 'VERIFYING'),
+                }, { stage: 'readback' });
+            }
+        }
+        if (failed.length) {
+            throw invoicePartialError('文件导入部分成功，禁止自动重试整个文件', {
+                succeeded: verified.map((item) => ({ fid: item.fid, preview: preview(item.info) })),
+                failed,
+                result,
+                workflow: workflow('invoice.import', 'VERIFYING'),
+            }, { stage: 'import-items' });
+        }
+        return {
+            status: 'COMPLETE',
+            data: {
+                imported: verified.map((item) => ({ fid: item.fid, preview: preview(item.info) })),
+                validationRequested: lease.options.validate,
+                validationSkipped: !lease.options.validate,
+                syncToOa: lease.options.syncToOa,
+                verified: true,
+                result,
+                workflow: workflow('invoice.import', 'COMPLETE'),
+            },
+        };
+    }
+}

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

@@ -0,0 +1,12 @@
+import { listInvoices } from './shared.js';
+export class InvoiceListOperation {
+    name;
+    flag;
+    constructor(name, flag) {
+        this.name = name;
+        this.flag = flag;
+    }
+    execute(input, { host }) {
+        return listInvoices(input, host, this.flag);
+    }
+}