weaver-work-cli 0.1.29 → 0.1.31

package/dist/shortcuts/contract/operations/review.js

@@ -0,0 +1,83 @@
+import { contractValidationError } from '../errors.js';
+import { reviewPageUrl } from './page.js';
+import { requireNonEmptyString } from './shared.js';
+import { assertContractDocument, uploadFile } from './upload.js';
+/** 固定 AI 审查助手 ID，只用于导出审查记录接口，不要拼到审查页地址上。 */
+export const AI_REVIEW_ASSISTANT_ID = '1326842382967570463';
+const MAX_FILES = 10;
+const SCLX_PATTERN = /^[1-3](?:,[1-3]){0,2}$/u;
+function normalizeSclx(value) {
+    if (value === undefined || value === null || value === '')
+        return '1,2,3';
+    if (typeof value !== 'string' || !SCLX_PATTERN.test(value)) {
+        throw contractValidationError('sclx_invalid', 'sclx 只能是 "1"、"2"、"3" 或它们的逗号组合（如 "1,2,3"）');
+    }
+    return value;
+}
+function collectRecords(value) {
+    const data = value?.data;
+    if (Array.isArray(data))
+        return data;
+    if (data && typeof data === 'object') {
+        const arrays = Object.values(data).filter(Array.isArray);
+        if (arrays.length)
+            return arrays.flat();
+        return Object.keys(data).length ? [data] : [];
+    }
+    return [];
+}
+export const contractReviewOperations = [
+    {
+        name: 'contract.review.upload',
+        async execute(input, { host }) {
+            const paths = input.paths;
+            if (!Array.isArray(paths) || paths.length === 0) {
+                throw contractValidationError('paths_required', 'paths 必须是非空的本地合同文件路径数组');
+            }
+            if (paths.length > MAX_FILES) {
+                throw contractValidationError('paths_too_many', `一次最多上传 ${MAX_FILES} 份合同`);
+            }
+            const files = [];
+            for (const rawPath of paths) {
+                const path = requireNonEmptyString(rawPath, 'paths[]', 1000);
+                assertContractDocument(path);
+                files.push(await uploadFile(host, { path, module: 'ebContract' }));
+            }
+            const session = await host.getSession();
+            return {
+                status: 'COMPLETE',
+                data: {
+                    files,
+                    url: reviewPageUrl(session.baseUrl, files),
+                    page: { width: 1000 },
+                    note: '把 url 原样放进 browsertool 的 arguments.url，并带 width: 1000；不要做整体编码',
+                },
+            };
+        },
+    },
+    {
+        name: 'contract.review.export',
+        async execute(input, { host }) {
+            const fileId = requireNonEmptyString(input.fileId, 'fileId', 64);
+            const sclx = normalizeSclx(input.sclx);
+            const value = await host.contractRequest({
+                method: 'POST',
+                path: '/api/ebd/contract/ai/getAiReviewRecord',
+                body: { sclx, fileId, ai_id: AI_REVIEW_ASSISTANT_ID },
+                timeoutMs: 120_000,
+            });
+            const records = collectRecords(value);
+            return {
+                status: records.length ? 'COMPLETE' : 'EMPTY',
+                data: {
+                    fileId,
+                    sclx,
+                    aiId: AI_REVIEW_ASSISTANT_ID,
+                    hasContent: records.length > 0,
+                    records,
+                    raw: value,
+                },
+            };
+        },
+    },
+];

package/dist/shortcuts/contract/operations/shared.js

@@ -70,6 +70,43 @@ function canonicalJson(value) {
 export function objectFingerprint(value) {
     return createHash('sha256').update(canonicalJson(value)).digest('hex');
 }
+/**
+ * 写入指纹只覆盖业务字段。
+ * 默认指纹会把 continuation / confirm 一起算进去，导致 apply 必然 target_changed。
+ */
+export function fingerprintFields(fields) {
+    return (input) => objectFingerprint(Object.fromEntries(fields.map((field) => [field, input[field] ?? null])));
+}
+/** 服务端要求 JSON 字符串的字段（pzxx / element_mxb / contract_rule_source / config 等）：对象转字符串，字符串校验可解析。 */
+export function toJsonString(value, name) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {
+            throw contractValidationError('json_invalid', `${name} 必须是 JSON 对象/数组的字符串`);
+        }
+        try {
+            JSON.parse(trimmed);
+        }
+        catch {
+            throw contractValidationError('json_invalid', `${name} 必须是可解析的 JSON 字符串`);
+        }
+        return trimmed;
+    }
+    if (value === undefined || value === null || typeof value !== 'object') {
+        throw contractValidationError('input_invalid', `${name} 必须是对象/数组或其 JSON 字符串`);
+    }
+    return JSON.stringify(value);
+}
+/** 逗号分隔字符串或字符串数组，统一成正整数 id 列表。 */
+export function idList(value, name) {
+    const raw = Array.isArray(value)
+        ? value
+        : typeof value === 'string' ? value.split(',') : undefined;
+    if (!raw || raw.length === 0) {
+        throw contractValidationError('input_invalid', `${name} 至少包含一个 id`);
+    }
+    return raw.map((item) => requireId(String(item).trim(), name));
+}
 export function sessionMatches(lease, session) {
     return lease.baseUrl === session.baseUrl && lease.profile === session.profile && lease.userId === session.userId;
 }

package/dist/shortcuts/contract/operations/upload.js

@@ -0,0 +1,108 @@
+import { createHash } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { basename, resolve } from 'node:path';
+import { contractPolicyError, contractValidationError } from '../errors.js';
+const MAX_FILE_BYTES = 200 * 1024 * 1024;
+const DEFAULT_UPLOAD_TIMEOUT_MS = 120_000;
+const DOC_EXTENSIONS = new Set(['.doc', '.docx']);
+function text(value) {
+    if (typeof value === 'string' && value.trim())
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+function pickFileId(payload) {
+    return text(payload.fileid)
+        ?? text(payload.fileId)
+        ?? text(payload.uploadModuleDto?.fileid)
+        ?? text(payload.uploadModuleDto?.fileId);
+}
+/**
+ * 两段式文件上传：preUploadCheck 预检（命中秒传直接返回 fileId）→ module/upload 实传。
+ * 成功判据是拿到非空 fileId，HTTP 200 不算成功。
+ */
+export async function uploadFile(host, options) {
+    const absolutePath = resolve(options.path);
+    const info = await stat(absolutePath).catch(() => null);
+    if (!info || !info.isFile()) {
+        throw contractValidationError('file_not_found', `文件不存在或不是普通文件：${options.path}`);
+    }
+    if (info.size === 0) {
+        throw contractValidationError('file_empty', `文件内容为空：${options.path}`);
+    }
+    if (info.size > MAX_FILE_BYTES) {
+        throw contractValidationError('file_too_large', `文件超过 ${MAX_FILE_BYTES / 1024 / 1024}MB 上限：${options.path}`);
+    }
+    const name = basename(absolutePath);
+    const buffer = await readFile(absolutePath);
+    const md5 = createHash('md5').update(buffer).digest('hex');
+    const modified = String(Math.trunc(info.mtimeMs));
+    const form = {
+        compressImg: 'false',
+        module: options.module,
+        ...(options.module === 'ebContract' ? { createDoc: 'true' } : {}),
+        ...(options.extraFields ?? {}),
+        size: String(buffer.length),
+        name,
+        MD5: md5,
+        lastModified: modified,
+        lastModifiedDate: modified,
+    };
+    const query = options.query ?? (options.module === 'ebContract' ? {} : { sf_request_type: 'ajax' });
+    const timeoutMs = options.timeoutMs ?? DEFAULT_UPLOAD_TIMEOUT_MS;
+    const precheck = await host.contractRequest({
+        method: 'POST',
+        path: '/api/file/preUploadCheck',
+        query,
+        form,
+        timeoutMs,
+    });
+    const precheckData = (precheck?.data ?? {});
+    const secondUploadId = pickFileId(precheckData);
+    if (secondUploadId) {
+        return {
+            fileId: secondUploadId,
+            docId: text(precheckData.docId) ?? text(precheckData.uploadModuleDto?.docId),
+            name: text(precheckData.name) ?? text(precheckData.uploadModuleDto?.name) ?? name,
+            size: buffer.length,
+            md5,
+        };
+    }
+    const preUploadId = text(precheckData.preUploadId);
+    const uploadType = text(precheckData.uploadType) ?? 'common';
+    if (!preUploadId) {
+        throw contractPolicyError('upload_precheck_failed', '上传预检未返回 preUploadId，也没有秒传 fileId；请核对 module、fieldId 与登录态', { path: '/api/file/preUploadCheck', module: options.module });
+    }
+    if (uploadType === 'chunk') {
+        throw contractPolicyError('upload_chunk_unsupported', '服务端要求分片上传（uploadType=chunk），当前 CLI 尚未实现分片链路，请改用较小文件或补充分片接口契约', { module: options.module, chunkSize: precheckData.chunkDto?.chunkSize });
+    }
+    const uploaded = await host.contractRequest({
+        method: 'POST',
+        path: '/api/file/module/upload',
+        query,
+        form: { ...form, preUploadId, uploadType },
+        file: { path: absolutePath, filename: name },
+        timeoutMs,
+    });
+    const uploadData = (uploaded?.data ?? {});
+    const fileId = pickFileId(uploadData);
+    if (!fileId) {
+        throw contractPolicyError('upload_no_fileid', '上传接口未返回 fileId，上传未完成；请核对登录态、module 与文件本体是否随请求发送', { module: options.module });
+    }
+    return {
+        fileId,
+        docId: text(uploadData.docId) ?? text(uploadData.uploadModuleDto?.docId),
+        name: text(uploadData.name) ?? name,
+        size: buffer.length,
+        md5,
+    };
+}
+export function assertContractDocument(path) {
+    const lower = path.toLowerCase();
+    const dot = lower.lastIndexOf('.');
+    const ext = dot >= 0 ? lower.slice(dot) : '';
+    if (!DOC_EXTENSIONS.has(ext)) {
+        throw contractValidationError('file_type_unsupported', `合同智能审查与流程发起仅支持 .doc/.docx：${path}`);
+    }
+}

package/dist/shortcuts/contract/operations/write.js

@@ -22,9 +22,10 @@ export class ContractWritePrepareOperation {
         const session = await host.getSession();
         const preview = this.spec.preview(input);
         const baseName = baseNameOf(this.name);
+        const resolvedPath = this.spec.pathOf ? this.spec.pathOf(input) : this.spec.path;
         const continuationToken = await continuation.issue({
             operation: this.applyName,
-            path: this.spec.path,
+            path: resolvedPath,
             baseUrl: session.baseUrl,
             profile: session.profile,
             userId: session.userId,
@@ -75,7 +76,7 @@ export class ContractWriteApplyOperation {
         try {
             result = await host.contractRequest({
                 method: this.spec.method,
-                path: this.spec.path,
+                path: this.spec.pathOf ? this.spec.pathOf(input) : this.spec.path,
                 body,
                 ...(this.spec.userIdField ? { userIdField: this.spec.userIdField } : {}),
             });

package/dist/shortcuts/index.js

@@ -1,42 +1,142 @@
-import { caizhilianShortcut } from './caizhilian/index.js';
-import { projectShortcut } from './project/index.js';
-import { blogShortcut } from './blog/index.js';
-import { archiveShortcut } from './archive/index.js';
-import { archiveOaShortcut } from './archive-oa/index.js';
-import { calendarShortcut } from './calendar/index.js';
-import { ehrShortcut } from './ehr/index.js';
-import { esbShortcut } from './esb/index.js';
-import { fnaShortcut } from './fna/index.js';
-import { hrmShortcut } from './hrm/index.js';
-import { invoiceShortcut } from './invoice/index.js';
-import { mailShortcut } from './mail/index.js';
-import { meetingShortcut } from './meeting/index.js';
-import { okrShortcut } from './okr/index.js';
-import { planShortcut } from './plan/index.js';
-import { jiuchuanhuiShortcut } from './jiuchuanhui/index.js';
-import { assetShortcut } from './asset/index.js';
-import { ebuilderFormShortcut } from './ebuilder-form/index.js';
-import { imShortcut } from './im/index.js';
-import { workflowShortcut } from './workflow/index.js';
+function lazyShortcut(definition) {
+    return {
+        name: definition.name,
+        description: definition.description,
+        category: 'shortcut',
+        load: definition.load,
+        register({ program }) {
+            const placeholder = program.command(definition.name).description(definition.description);
+            // 占位的唯一职责是"接住 argv"：子命令、未知选项、多余参数一律放行，不做任何校验。
+            placeholder.allowUnknownOption(true);
+            placeholder.allowExcessArguments(true);
+            // `-h` 也要放行到重放那一步，否则这里会打出"占位命令"的空帮助（只有 5 个 IO 选项），
+            // 而不是真实命令树的帮助。
+            placeholder.helpOption(false);
+            placeholder.action(async () => {
+                const { dispatchLazyShortcut } = await import('../cmd/lazy-dispatch.js');
+                await dispatchLazyShortcut(definition, shortcutMetadata());
+            });
+        },
+    };
+}
+/**
+ * 全部 shortcut 的**元数据清单**（不含实现）。
+ *
+ * 顺序即 `commands list` / 顶层 `--help` 的展示顺序，与改造前**完全一致**，不要随手调换。
+ */
 export const builtinShortcuts = [
-    invoiceShortcut,
-    ehrShortcut,
-    archiveShortcut,
-    archiveOaShortcut,
-    calendarShortcut,
-    fnaShortcut,
-    hrmShortcut,
-    mailShortcut,
-    meetingShortcut,
-    okrShortcut,
-    planShortcut,
-    esbShortcut,
-    ebuilderFormShortcut,
-    jiuchuanhuiShortcut,
-    assetShortcut,
-    imShortcut,
-    projectShortcut,
-    workflowShortcut,
-    blogShortcut,
-    caizhilianShortcut
+    lazyShortcut({
+        name: 'invoice',
+        description: 'E10 业票通发票管理 CLI',
+        load: async () => (await import('./invoice/index.js')).invoiceShortcut,
+    }),
+    lazyShortcut({
+        name: 'ehr',
+        description: '泛微E10聚才林（人事/出勤/薪酬）CLI',
+        load: async () => (await import('./ehr/index.js')).ehrShortcut,
+    }),
+    lazyShortcut({
+        name: 'archive',
+        description: 'E10 文书定档案管理 CLI',
+        load: async () => (await import('./archive/index.js')).archiveShortcut,
+    }),
+    lazyShortcut({
+        name: 'archive-oa',
+        description: 'E10 档案定位与 OA 商务合同借阅 CLI',
+        load: async () => (await import('./archive-oa/index.js')).archiveOaShortcut,
+    }),
+    lazyShortcut({
+        name: 'calendar',
+        description: '泛微E10日程管理 CLI（创建/查询/更新/删除/字典）',
+        load: async () => (await import('./calendar/index.js')).calendarShortcut,
+    }),
+    lazyShortcut({
+        name: 'fna',
+        description: '泛微E10齐业成费控中心（预算/费用中心/借款管理/发票核销）CLI',
+        load: async () => (await import('./fna/index.js')).fnaShortcut,
+    }),
+    lazyShortcut({
+        name: 'hrm',
+        description: '泛微E10组织管理（员工/组织/岗位查询）CLI',
+        load: async () => (await import('./hrm/index.js')).hrmShortcut,
+    }),
+    lazyShortcut({
+        name: 'mail',
+        description: '泛微E10邮件管理 CLI',
+        load: async () => (await import('./mail/index.js')).mailShortcut,
+    }),
+    lazyShortcut({
+        name: 'meeting',
+        description: '泛微E10会议管理 CLI（标准版：查询/冲突/预约/回执/签到）',
+        load: async () => (await import('./meeting/index.js')).meetingShortcut,
+    }),
+    lazyShortcut({
+        name: 'okr',
+        description: '泛微E10 OKR 目标管理 CLI（目标查询/新建/编辑、关键成果、目标对齐、评论）',
+        load: async () => (await import('./okr/index.js')).okrShortcut,
+    }),
+    lazyShortcut({
+        name: 'plan',
+        description: '泛微E10计划报告 CLI（查询/新建/修改/发布/撤回/提交提醒/评论）',
+        load: async () => (await import('./plan/index.js')).planShortcut,
+    }),
+    lazyShortcut({
+        name: 'esb',
+        description: '泛微E10 ESB 中心自定义触发动作流 CLI',
+        load: async () => (await import('./esb/index.js')).esbShortcut,
+    }),
+    lazyShortcut({
+        name: 'ebuilder-form',
+        description: '泛微E10 eBuilder 表单菜单、列表和表单数据 CLI',
+        load: async () => (await import('./ebuilder-form/index.js')).ebuilderFormShortcut,
+    }),
+    lazyShortcut({
+        name: 'jiuchuanhui',
+        description: '泛微E10九氚汇营销管理 CLI（客户/联系人/商机/线索/联系计划/公海）',
+        load: async () => (await import('./jiuchuanhui/index.js')).jiuchuanhuiShortcut,
+    }),
+    lazyShortcut({
+        name: 'asset',
+        description: 'E10 资产管理（资管家）CLI',
+        load: async () => (await import('./asset/index.js')).assetShortcut,
+    }),
+    lazyShortcut({
+        name: 'im',
+        description: '泛微E10易秒办（即时通讯）CLI',
+        load: async () => (await import('./im/index.js')).imShortcut,
+    }),
+    lazyShortcut({
+        name: 'project',
+        description: '泛微E10事井然项目管理 CLI（项目/任务查询与确认写入）',
+        load: async () => (await import('./project/index.js')).projectShortcut,
+    }),
+    lazyShortcut({
+        name: 'workflow',
+        description: '泛微E10流程智能助手 CLI（查询/查看/操作/批量/发起/修改）',
+        load: async () => (await import('./workflow/index.js')).workflowShortcut,
+    }),
+    lazyShortcut({
+        name: 'blog',
+        description: '泛微E10工作日报 CLI（查询/发布/编辑/评论/点赞/提醒/导出）',
+        load: async () => (await import('./blog/index.js')).blogShortcut,
+    }),
+    lazyShortcut({
+        name: 'caizhilian',
+        description: '泛微E10采知连（文档中心）CLI',
+        load: async () => (await import('./caizhilian/index.js')).caizhilianShortcut,
+    }),
 ];
+/** 全部 shortcut 的 CLI 元数据（不触发任何实现模块加载）。 */
+export function shortcutMetadata() {
+    return builtinShortcuts;
+}
+/** 按需加载：只 import 名字命中的那几个。 */
+export async function loadShortcuts(names) {
+    const wanted = new Set(names);
+    const hits = builtinShortcuts.filter((shortcut) => wanted.has(shortcut.name));
+    return Promise.all(hits.map((shortcut) => shortcut.load()));
+}
+/** 全量加载（只在"argv 里那个名字既不是内建命令、也不是已知 shortcut"时兜底用）。 */
+export async function loadAllShortcuts() {
+    return Promise.all(builtinShortcuts.map((shortcut) => shortcut.load()));
+}

package/dist/shortcuts/invoice/manifest.js

@@ -24,6 +24,15 @@ function epochDateProperty(label) {
         description: `${label}。可传 YYYY-MM-DD（按东八区零点换算）或秒级时间戳。`,
     };
 }
+function epochEndDateProperty(label) {
+    return {
+        oneOf: [
+            { type: 'integer', minimum: 0 },
+            { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+        ],
+        description: `${label}。可传 YYYY-MM-DD（按东八区当天 23:59:59 换算）或秒级时间戳。`,
+    };
+}
 const listProperties = {
     page_size: { type: 'integer', minimum: 1, maximum: 200 },
     start_pos: { type: 'integer', minimum: 0 },
@@ -36,6 +45,8 @@ const listProperties = {
     date_end: epochDateProperty('开票日期止（含）'),
     create_tm_begin: epochDateProperty('创建时间起（含）'),
     create_tm_end: epochDateProperty('创建时间止（含）'),
+    consumption_tm_begin: epochDateProperty('消费日期起（含）'),
+    consumption_tm_end: epochEndDateProperty('消费日期止（含）'),
     payer_company: { type: 'string' },
     buyer_company: { type: 'string' },
     payer_taxno: { type: 'string' },
@@ -478,14 +489,11 @@ const requestListDataSchema = arrayOf(objectSchema({
     requestid: { type: 'string' },
     workflowid: { type: 'string' },
     requestname: { type: 'string' },
-    requestnametitle: { type: 'string' },
     flowStatus: { type: 'integer' },
     creatorId: { type: 'string' },
     creatorName: { type: 'string' },
-    creatorDepartmentId: { type: 'string' },
-    nodeid: { type: 'string' },
     createTime: { type: 'string' },
-}, ['requestid', 'workflowid', 'requestname'], true));
+}, ['requestid', 'workflowid', 'requestname']));
 const workflowResolveDataSchema = objectSchema({
     requestWorkflowMap: objectSchema({}, [], objectSchema({
         workFlowId: { type: 'string' },
@@ -532,11 +540,12 @@ const employeeSuperiorsDataSchema = objectSchema({
     currentEmployee: employeeSchema,
     allSuperiors: arrayOf(employeeSchema),
 }, ['currentEmployee', 'allSuperiors'], true);
-const fieldSearchDataSchema = arrayOf(objectSchema({
+const fieldSearchItemSchema = objectSchema({
     id: { type: 'string' },
     name: { type: 'string' },
     value: { type: 'string' },
-}, ['id', 'name'], true));
+}, ['id', 'name'], true);
+const fieldSearchItemsSchema = arrayOf(fieldSearchItemSchema);
 const flowPreviewOutputSchema = objectSchema({
     requestName: { type: 'string' },
     workflowId: { type: 'string' },
@@ -987,16 +996,20 @@ export const invoiceOperations = [
     {
         name: 'invoice.reim.requests.list',
         risk: 'read',
-        fixed: { path: '/api/inc/book/getRequestListByTabId', defaultPageNo: 1, defaultPageSize: 20 },
+        fixed: { path: '/api/inc/book/getRequestListByTabId', defaultPageNo: 1, defaultPageSize: 100, defaultCusCreateDateEnd: 'passedOrShanghaiToday+1' },
         inputSchema: {
             type: 'object',
             additionalProperties: false,
             properties: {
                 pageNo: { type: 'integer', minimum: 1, maximum: 10000, default: 1 },
-                pageSize: { type: 'integer', minimum: 1, maximum: 200, default: 20 },
+                pageSize: { type: 'integer', minimum: 1, maximum: 200, default: 100, description: '每页条数。不传时默认 100。' },
                 requestname: { type: 'string', minLength: 1 },
                 cusCreateDateStart: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
-                cusCreateDateEnd: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+                cusCreateDateEnd: {
+                    type: 'string',
+                    pattern: '^\\d{4}-\\d{2}-\\d{2}$',
+                    description: '发起日期结束（YYYY-MM-DD）。不传时按东八区当天 + 1 天填入；传入时按该日期再 + 1 天后发给接口。调用方传业务结束日本身，不要自己再加 1 天。',
+                },
             },
         },
         outputSchema: resultEnvelopeOutput(requestListDataSchema),
@@ -1086,7 +1099,7 @@ export const invoiceOperations = [
     {
         name: 'invoice.reim.field.search',
         risk: 'read',
-        fixed: { path: '/api/government/formStructure/fieldRelateSearch', formModeType: 'wf', defaultNodeId: '100004140000000271' },
+        fixed: { path: '/api/government/formStructure/fieldRelateSearch', method: 'GET', formModeType: 'wf', defaultNodeId: '100004140000000271' },
         inputSchema: {
             type: 'object',
             additionalProperties: false,
@@ -1098,7 +1111,15 @@ export const invoiceOperations = [
             },
             required: ['keywords', 'fieldId', 'workflowId'],
         },
-        outputSchema: resultEnvelopeOutput(fieldSearchDataSchema),
+        outputSchema: objectSchema({
+            result: rawObject,
+            data: fieldSearchItemsSchema,
+            keywords: { type: 'string' },
+            match: { type: 'string', enum: ['unique', 'multiple', 'none'] },
+            items: fieldSearchItemsSchema,
+            selected: { anyOf: [fieldSearchItemSchema, { type: 'null' }] },
+            workflow: workflowSchema,
+        }, ['result', 'data', 'keywords', 'match', 'items', 'workflow']),
     },
     {
         name: 'invoice.reim.flow.create.prepare',
@@ -1166,6 +1187,8 @@ export const invoiceOperations = [
             properties: {
                 date_begin: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$', description: '开票日期起（YYYY-MM-DD，含）。' },
                 date_end: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$', description: '开票日期止（YYYY-MM-DD，含）。' },
+                consumption_tm_begin: epochDateProperty('消费日期起（含）'),
+                consumption_tm_end: epochEndDateProperty('消费日期止（含）'),
                 page_size: { type: 'integer', minimum: 10, maximum: 200, default: 50, description: '单页条数。' },
                 max_items: { type: 'integer', minimum: 1, maximum: 500, default: 200, description: '最多拉取条数（不含被过滤的红冲票），超出截断并产生 warning。' },
                 include_red_reversed: { type: 'boolean', default: false, description: '是否在结果中保留全额红冲（status=8）发票。默认 false —— 报销场景直接过滤掉，过滤张数由 summary.filteredRedReversedCount 告知，不会静默丢失。' },

package/dist/shortcuts/invoice/operations/reim-auto.js

@@ -592,9 +592,14 @@ export class InvoiceReimCandidatesListOperation {
         const includeRedReversed = input.include_red_reversed === true;
         const dateBegin = optionalEpochSeconds(input.date_begin, 'date_begin');
         const dateEnd = optionalEpochSeconds(input.date_end, 'date_end');
+        const consumptionBegin = optionalEpochSeconds(input.consumption_tm_begin, 'consumption_tm_begin');
+        const consumptionEnd = optionalEpochSeconds(input.consumption_tm_end, 'consumption_tm_end', { endOfDay: true });
         if (dateBegin !== undefined && dateEnd !== undefined && dateBegin > dateEnd) {
             throw invoiceValidationError('input_invalid', 'date_begin 不能晚于 date_end');
         }
+        if (consumptionBegin !== undefined && consumptionEnd !== undefined && consumptionBegin > consumptionEnd) {
+            throw invoiceValidationError('input_invalid', 'consumption_tm_begin 不能晚于 consumption_tm_end');
+        }
         const warnings = [];
         const kept = [];
         let total = 0;
@@ -616,6 +621,10 @@ export class InvoiceReimCandidatesListOperation {
                 body.date_begin = dateBegin;
             if (dateEnd !== undefined)
                 body.date_end = dateEnd;
+            if (consumptionBegin !== undefined)
+                body.consumption_tm_begin = consumptionBegin;
+            if (consumptionEnd !== undefined)
+                body.consumption_tm_end = consumptionEnd;
             const result = await host.invoiceRequest({ path: '/api/inc/sync', method: 'POST', body, operation: this.name });
             total = Number(result?.total ?? 0);
             const infos = Array.isArray(result?.infos) ? result.infos : [];