weaver-work-cli 0.1.7 → 0.1.20

package/dist/shortcuts/invoice/manifest.js

@@ -1,3 +1,29 @@
+import { DETAIL_ITEM_FIELDS, OUTPUT_VIEWS, SUMMARY_ITEM_FIELDS } from './projection.js';
+import { OUTPUT_FORMATS } from './markdown.js';
+function objectSchema(properties, required = [], additionalProperties = false) {
+    return {
+        type: 'object',
+        additionalProperties,
+        properties,
+        ...(required.length ? { required } : {}),
+    };
+}
+function arrayOf(items, options = {}) {
+    return { type: 'array', items, ...options };
+}
+/**
+ * 时间筛选字段既接受秒级 epoch（E10 `/api/inc/sync` 的原生格式），也接受 `YYYY-MM-DD`（按东八区零点换算）。
+ * 两种写法由 `shared.ts` 的 `epochSeconds()` 归一，因此契约必须同时声明，否则 schema 与实现不一致。
+ */
+function epochDateProperty(label) {
+    return {
+        oneOf: [
+            { type: 'integer', minimum: 0 },
+            { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+        ],
+        description: `${label}。可传 YYYY-MM-DD（按东八区零点换算）或秒级时间戳。`,
+    };
+}
 const listProperties = {
     page_size: { type: 'integer', minimum: 1, maximum: 200 },
     start_pos: { type: 'integer', minimum: 0 },
@@ -6,10 +32,10 @@ const listProperties = {
     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 },
+    date_begin: epochDateProperty('开票日期起（含）'),
+    date_end: epochDateProperty('开票日期止（含）'),
+    create_tm_begin: epochDateProperty('创建时间起（含）'),
+    create_tm_end: epochDateProperty('创建时间止（含）'),
     payer_company: { type: 'string' },
     buyer_company: { type: 'string' },
     payer_taxno: { type: 'string' },
@@ -142,6 +168,511 @@ const reimFlowUpdateProperties = {
     need_user_confirm: { type: 'array', items: reimNeedUserConfirm, description: '需用户确认的字段。' },
     unable_to_fill: { type: 'array', items: reimUnableToFill, description: '无法自动填写的字段。' },
 };
+const rawValue = { description: '服务端原始字段，类型随接口返回而定。' };
+const rawObject = objectSchema({}, [], true);
+const rawArray = arrayOf(rawObject);
+const stringOrNumber = { type: ['string', 'number'] };
+const workflowSchema = objectSchema({
+    workflow: { type: 'string' },
+    version: { type: 'integer', const: 1 },
+    state: { type: 'string' },
+}, ['workflow', 'version', 'state']);
+const retSchema = objectSchema({
+    ret: { type: 'integer' },
+    message: { type: 'string' },
+    lang: { type: 'string' },
+}, ['ret'], true);
+const responseBaseSchema = objectSchema({
+    ret: { type: 'integer' },
+    message: { type: 'string' },
+    code: { type: 'integer' },
+    lang: { type: 'string' },
+}, [], true);
+const invoicePartySchema = objectSchema({
+    company: { type: 'string' },
+    tcode: { type: 'string' },
+}, [], true);
+const invoiceInfoSchema = objectSchema({
+    id: { type: 'string' },
+    fid: { type: 'string' },
+    code: { type: 'string' },
+    number: { type: 'string' },
+    comm_info: objectSchema({
+        pro: objectSchema({
+            type: { type: 'integer' },
+            cname: { type: 'string' },
+            date: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+            valid: { type: 'integer', enum: [0, 1, 2, 3, 4, 5] },
+            sreim: { type: 'integer', enum: [0, 1, 2, 3, 4] },
+            status: { type: 'integer', enum: [0, 1, 2, 3, 4, 5, 7, 8] },
+        }, [], true),
+        price: objectSchema({
+            amount: { type: 'string' },
+            total: { type: 'string' },
+            dtax: { type: 'string' },
+            reimingMoney: { type: 'string' },
+            reimedMoney: { type: 'string' },
+        }, [], true),
+        buyer: invoicePartySchema,
+        payer: invoicePartySchema,
+    }, [], true),
+    modify_info: objectSchema({
+        source: { type: 'integer' },
+        fileType: { type: 'string', enum: ['1', '2', '3', '4', '5', '6'] },
+        del: { type: 'integer' },
+        createDate: { type: 'string' },
+        modifyDate: { type: 'string' },
+    }, [], true),
+    flist: arrayOf(objectSchema({
+        id: { type: 'string' },
+        fileId: { type: 'string' },
+        name: { type: 'string' },
+        type: { type: 'string' },
+    }, [], true)),
+    ext: {
+        type: 'string',
+        description: 'JSON 字符串形式的票种扩展信息；解析后可包含 ttax、products 等字段。',
+    },
+    currency: { type: 'string' },
+    currencyName: { type: 'string' },
+    fylx: { type: 'string' },
+}, [], true);
+const invoiceResultItemSchema = objectSchema({
+    info: invoiceInfoSchema,
+    ret: retSchema,
+}, ['info', 'ret'], true);
+const invoiceDetailOutputSchema = objectSchema({
+    infos: arrayOf(invoiceResultItemSchema),
+    res_base: responseBaseSchema,
+}, ['infos', 'res_base'], true);
+const invoicePreviewSchema = objectSchema({
+    fid: { type: 'string' },
+    code: { type: 'string' },
+    number: { type: 'string' },
+    date: { type: 'string' },
+    total: { type: 'string' },
+    buyer: { type: 'string' },
+    payer: { type: 'string' },
+    valid: { type: 'integer' },
+    reimbursement: { type: 'integer' },
+    status: { type: 'integer' },
+}, ['fid', 'code', 'number', 'date', 'total', 'buyer', 'payer']);
+const addPreviewSchema = objectSchema({
+    ...invoicePreviewSchema.properties,
+    type: { type: 'integer' },
+    scope: { type: 'string', enum: ['personal', 'enterprise'] },
+}, ['fid', 'number', 'type', 'scope']);
+const uploadSchema = objectSchema({
+    id: { type: 'string' },
+    ids: arrayOf({ type: 'string' }),
+    fileType: { type: 'string', enum: ['pdf', 'ofd', 'xml', 'png', 'jpg', 'jpeg'] },
+    fileName: { type: 'string' },
+    totalPages: { type: 'integer', minimum: 1 },
+    hasFanWei: { type: 'boolean' },
+    ocrMap: { type: 'string' },
+    fail: { const: false },
+}, ['id', 'ids', 'fileType', 'totalPages', 'hasFanWei', 'fail']);
+const browseFieldItemSchema = objectSchema({
+    optionId: { type: 'string' },
+    id: { type: 'string' },
+    fid: { type: 'string' },
+    type: { type: 'integer' },
+    typeName: { type: 'string' },
+    number: { type: 'string' },
+    code: { type: 'string' },
+    content: { type: 'string' },
+    name: { type: 'string' },
+    total: { type: 'string' },
+    ttax: { type: 'string' },
+    seller: { type: 'string' },
+    sellerId: { type: 'string' },
+    buyer: { type: 'string' },
+    buyerId: { type: 'string' },
+    incDate: { type: 'string' },
+    incDateTimestamp: { type: 'integer' },
+    validStatus: { type: 'string' },
+    source: { type: 'string' },
+    invoiceStatus: { type: 'integer' },
+    del: { type: 'integer' },
+    currency: { type: 'string' },
+    currencyName: { type: 'string' },
+    taxRate: { type: 'string' },
+    consumeContent: { type: 'string' },
+    fylx: { type: 'string' },
+    inputDate: { type: 'string' },
+    incTotal: { type: 'number' },
+    reimingMoney: { type: 'string' },
+    reimedMoney: { type: 'string' },
+    notReimMoney: { type: 'string' },
+    reimDate: { type: 'string' },
+    reimProcess: { type: 'string' },
+}, ['optionId', 'id', 'fid', 'type', 'typeName', 'number', 'content', 'name', 'total']);
+const browseFieldErrorSchema = objectSchema({
+    fid: { type: 'string' },
+    ret: { type: 'integer' },
+    message: { type: 'string' },
+}, ['ret', 'message']);
+const continuationSchema = { type: 'string', minLength: 1 };
+const continuationPreviewOutput = (previewSchema, extra = {}) => objectSchema({
+    preview: previewSchema,
+    continuation: continuationSchema,
+    expiresInSeconds: { type: 'integer', minimum: 1 },
+    workflow: workflowSchema,
+    ...extra,
+}, ['preview', 'continuation', 'expiresInSeconds', 'workflow']);
+const resultEnvelopeOutput = (dataSchema = rawValue) => objectSchema({
+    result: rawObject,
+    data: dataSchema,
+    workflow: workflowSchema,
+}, ['result', 'data', 'workflow']);
+const listOutputSchema = objectSchema({
+    items: arrayOf(invoiceInfoSchema),
+    total: { type: 'integer' },
+    totalAmount: { type: 'string' },
+    totalAmountExcludingTax: { type: 'string' },
+    hasMore: { type: 'boolean' },
+    scope: { type: 'string', enum: ['personal', 'enterprise'] },
+}, ['items', 'total', 'totalAmount', 'totalAmountExcludingTax', 'hasMore', 'scope']);
+/**
+ * 列表类 operation 支持 `--view summary`：把 40+ 字段的原始发票裁成语义平表，
+ * 调用方一次调用就能读到清单，不必再写脚本解析完整 envelope。
+ */
+const summaryOutputView = {
+    name: 'summary',
+    description: '语义化平表，省略空值字段；列表级汇总在前、items 在后，并附 itemCount。用 CLI 的 --view summary 启用。',
+    itemFields: SUMMARY_ITEM_FIELDS,
+};
+const detailOutputView = {
+    name: 'detail',
+    description: '单张发票的语义详情：summary 字段，外加 attachments（附件清单）、expenseNote（费用说明）、issuer（开票人）、checkState（查验标记，0=未查验，与票面 valid 不是一个口径）。用 CLI 的 --view detail 启用。',
+    itemFields: DETAIL_ITEM_FIELDS,
+};
+const uploadOutputSchema = objectSchema({
+    upload: uploadSchema,
+    workflow: workflowSchema,
+}, ['upload', 'workflow']);
+const ocrPreviewOutputSchema = objectSchema({
+    saved: { const: false },
+    verified: { const: false },
+    upload: uploadSchema,
+    invoices: arrayOf(invoiceResultItemSchema),
+    results: rawArray,
+    workflow: workflowSchema,
+}, ['saved', 'verified', 'upload', 'invoices', 'results', 'workflow']);
+const validationPreviewOutputSchema = objectSchema({
+    preview: objectSchema({
+        ...invoicePreviewSchema.properties,
+        targetFid: { type: 'string' },
+        resultFid: { type: 'string' },
+        scope: { type: 'string', enum: ['personal', 'enterprise'] },
+        validation: { type: 'integer' },
+        invoiceStatus: { type: 'integer' },
+        saved: { const: false },
+    }, ['fid', 'targetFid', 'resultFid', 'scope', 'saved']),
+    info: invoiceInfoSchema,
+    saved: { const: false },
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['preview', 'info', 'saved', 'result', 'workflow']);
+const validationItemSchema = objectSchema({
+    ...invoicePreviewSchema.properties,
+    targetFid: { type: 'string' },
+    resultFid: { type: 'string' },
+    scope: { type: 'string', enum: ['personal', 'enterprise'] },
+    validation: { type: 'integer' },
+    invoiceStatus: { type: 'integer' },
+    saved: { const: false },
+}, ['fid', 'scope', 'saved']);
+const uploadAndValidateOutputSchema = objectSchema({
+    upload: uploadSchema,
+    ocrCount: { type: 'integer', minimum: 0 },
+    invoices: arrayOf(invoiceResultItemSchema),
+    validations: arrayOf(validationItemSchema),
+    validationErrors: arrayOf(objectSchema({ fid: { type: ['string', 'null'] }, error: { type: 'string' } }, ['error'])),
+    results: rawArray,
+    workflow: workflowSchema,
+}, ['upload', 'ocrCount', 'invoices', 'validations', 'validationErrors', 'results', 'workflow']);
+const importPreviewSchema = objectSchema({
+    source: { type: 'string', enum: ['file', 'url'] },
+    name: { type: 'string' },
+    size: { type: 'integer', minimum: 0 },
+    sha256: { type: 'string' },
+    url: { type: 'string' },
+    validate: { type: 'boolean' },
+    validationSkipped: { type: 'boolean' },
+    syncToOa: { type: 'boolean' },
+    fieldKey: { type: 'string' },
+    filedMap: rawObject,
+    targetScope: { type: 'string', enum: ['personal'] },
+}, ['source', 'validate', 'validationSkipped', 'syncToOa', 'targetScope']);
+const importCompleteOutputSchema = objectSchema({
+    imported: arrayOf(objectSchema({
+        fid: { type: 'string' },
+        preview: invoicePreviewSchema,
+    }, ['fid', 'preview'])),
+    validationRequested: { type: 'boolean' },
+    validationSkipped: { type: 'boolean' },
+    syncToOa: { type: 'boolean' },
+    verified: { const: true },
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['imported', 'validationRequested', 'validationSkipped', 'syncToOa', 'verified', 'result', 'workflow']);
+const addPrepareOutputSchema = continuationPreviewOutput(addPreviewSchema, { normalizedInfo: invoiceInfoSchema });
+const addApplyOutputSchema = objectSchema({
+    fid: { type: 'string' },
+    scope: { type: 'string', enum: ['personal', 'enterprise'] },
+    saved: { const: true },
+    verified: { const: true },
+    info: invoiceInfoSchema,
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['fid', 'scope', 'saved', 'verified', 'info', 'result', 'workflow']);
+const changePreviewSchema = objectSchema({
+    field: { type: 'string' },
+    from: rawValue,
+    to: rawValue,
+}, ['field', 'to']);
+const updatePrepareOutputSchema = objectSchema({
+    invoice: invoicePreviewSchema,
+    changes: arrayOf(changePreviewSchema),
+    continuation: continuationSchema,
+    expiresInSeconds: { type: 'integer', minimum: 1 },
+    workflow: workflowSchema,
+}, ['invoice', 'changes', 'continuation', 'expiresInSeconds', 'workflow']);
+const updateApplyOutputSchema = objectSchema({
+    fid: { type: 'string' },
+    scope: { type: 'string', enum: ['personal', 'enterprise'] },
+    updated: { const: true },
+    verified: { const: true },
+    changes: arrayOf(changePreviewSchema),
+    info: invoiceInfoSchema,
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['fid', 'scope', 'updated', 'verified', 'changes', 'info', 'result', 'workflow']);
+const deleteApplyOutputSchema = objectSchema({
+    deleted: arrayOf({ type: 'string' }),
+    verified: { const: true },
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['deleted', 'verified', 'result', 'workflow']);
+const downloadOutputSchema = objectSchema({
+    fid: { type: 'string' },
+    fileId: { type: 'string' },
+    output: { type: 'string' },
+    size: { type: 'integer', minimum: 0 },
+    contentType: { type: 'string' },
+}, ['fid', 'fileId', 'output', 'size', 'contentType']);
+const reimFileOcrItemSchema = objectSchema({
+    status: { type: 'string' },
+    invoiceId: { type: 'string' },
+    fid: { type: 'string' },
+    info: invoiceInfoSchema,
+    errorMsg: { type: 'string' },
+}, [], true);
+const reimFileOcrOutputSchema = objectSchema({
+    items: arrayOf(reimFileOcrItemSchema),
+    failed: arrayOf(reimFileOcrItemSchema),
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['items', 'failed', 'result', 'workflow']);
+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));
+const workflowResolveDataSchema = objectSchema({
+    requestWorkflowMap: objectSchema({}, [], objectSchema({
+        workFlowId: { type: 'string' },
+        workFlowName: { type: 'string' },
+    }, ['workFlowId', 'workFlowName'])),
+    candidateWorkflows: arrayOf(objectSchema({
+        workFlowId: { type: 'string' },
+        workFlowName: { type: 'string' },
+    }, ['workFlowId', 'workFlowName'])),
+}, [], true);
+const reimFieldOptionSchema = objectSchema({
+    optionId: { type: 'string' },
+    optionName: { type: 'string' },
+    optionValue: { type: 'string' },
+}, [], true);
+const reimFormFieldSchema = objectSchema({
+    fieldId: { type: 'string' },
+    fieldName: { type: 'string' },
+    fieldType: { type: 'string' },
+    single: { type: 'boolean' },
+    marked: { type: 'boolean' },
+    options: arrayOf(reimFieldOptionSchema),
+}, ['fieldId', 'fieldName', 'fieldType'], true);
+const formStructureDataSchema = objectSchema({
+    mainFormId: { type: 'string' },
+    mainFields: arrayOf(reimFormFieldSchema),
+    subTables: arrayOf(objectSchema({
+        subFormId: { type: 'string' },
+        subFormName: { type: 'string' },
+        subFields: arrayOf(reimFormFieldSchema),
+    }, ['subFormId', 'subFields'], true)),
+}, ['mainFormId', 'mainFields', 'subTables'], true);
+const rowInfoDataSchema = objectSchema({
+    date: { type: 'string' },
+    fysm: { type: 'string' },
+    itinerary: { type: 'string' },
+    subjectId: { type: 'string' },
+}, [], true);
+const employeeSchema = objectSchema({
+    id: { type: 'string' },
+    name: { type: 'string' },
+}, ['id', 'name'], true);
+const employeeSuperiorsDataSchema = objectSchema({
+    currentEmployee: employeeSchema,
+    allSuperiors: arrayOf(employeeSchema),
+}, ['currentEmployee', 'allSuperiors'], true);
+const fieldSearchDataSchema = arrayOf(objectSchema({
+    id: { type: 'string' },
+    name: { type: 'string' },
+    value: { type: 'string' },
+}, ['id', 'name'], true));
+const flowPreviewOutputSchema = objectSchema({
+    requestName: { type: 'string' },
+    workflowId: { type: 'string' },
+    mainFormId: { type: 'string' },
+    mainFieldCount: { type: 'integer' },
+    detailRowCount: { type: 'integer' },
+}, ['requestName', 'workflowId', 'mainFormId', 'mainFieldCount', 'detailRowCount']);
+const flowUpdatePreviewOutputSchema = objectSchema({
+    requestId: { type: 'string' },
+    mainFormId: { type: 'string' },
+    mainFieldCount: { type: 'integer' },
+    detailRowCount: { type: 'integer' },
+    deleteDetailRowCount: { type: 'integer' },
+}, ['requestId', 'mainFormId', 'mainFieldCount', 'detailRowCount', 'deleteDetailRowCount']);
+const flowCreateApplyOutputSchema = objectSchema({
+    requestId: { type: 'string' },
+    requestName: { type: 'string' },
+    viewUrl: { type: 'string', format: 'uri' },
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['requestId', 'requestName', 'viewUrl', 'result', 'workflow']);
+const flowUpdateApplyOutputSchema = objectSchema({
+    requestId: { type: 'string' },
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['requestId', 'result', 'workflow']);
+const reimCandidateItemSchema = objectSchema({
+    fid: { type: 'string' },
+    number: { type: 'string' },
+    date: { type: 'string' },
+    total: { type: 'string' },
+    buyer: { type: 'string' },
+    payer: { type: 'string' },
+    typeName: { type: 'string' },
+    status: { type: 'integer' },
+    valid: { type: 'integer' },
+    reimRequests: arrayOf({ type: 'string' }),
+}, ['fid', 'number', 'total'], true);
+const reimCandidatesOutputSchema = objectSchema({
+    total: { type: 'integer' },
+    fetched: { type: 'integer' },
+    hasMore: { type: 'boolean' },
+    available: arrayOf(reimCandidateItemSchema),
+    assigned: arrayOf(reimCandidateItemSchema),
+    redReversed: arrayOf(reimCandidateItemSchema),
+    summary: objectSchema({
+        availableCount: { type: 'integer' },
+        assignedCount: { type: 'integer' },
+        redReversedCount: { type: 'integer' },
+        availableAmount: { type: 'string' },
+        assignedAmount: { type: 'string' },
+        redReversedAmount: { type: 'string' },
+        filteredRedReversedCount: { type: 'integer' },
+    }, ['availableCount', 'assignedCount', 'redReversedCount', 'availableAmount', 'assignedAmount', 'redReversedAmount', 'filteredRedReversedCount']),
+    warnings: arrayOf({ type: 'string' }),
+    workflow: workflowSchema,
+}, ['total', 'fetched', 'hasMore', 'available', 'assigned', 'redReversed', 'summary', 'warnings', 'workflow']);
+const reimTemplateInputProperties = {
+    invoiceIds: { type: 'array', minItems: 1, maxItems: 100, items: positiveId, description: '用于报销的发票 fid 列表，将作为明细行顺序。' },
+    requestName: { type: 'string', minLength: 1, maxLength: 100, description: '报销单标题。' },
+    workflowId: { ...positiveId, description: `目标报销流程工作流 ID。不传时自动解析唯一候选；当前模板固化映射对应的流程为 ${'100003460000000060'}（总部费用报销）。` },
+    reason: { type: 'string', maxLength: 500, description: '报销事由，缺省使用 requestName。' },
+    relatedCustomerId: { ...positiveId, description: '相关客户 ID（非出差场景）。缺省留空并产生 warning。' },
+    relatedCustomerName: { type: 'string', minLength: 1, maxLength: 200, description: '相关客户名称。只传名称时会反查 ID；与 relatedCustomerId 同时传时只用于渲染预览中文名，不额外请求。' },
+    contractNo: { type: 'string', minLength: 1, maxLength: 100, description: '合同号。未传入时默认使用 "20260999"，不再留空。' },
+};
+const reimPreviewLabeledFieldSchema = objectSchema({
+    fieldId: { type: 'string' },
+    fieldName: { type: 'string' },
+    value: { type: 'string' },
+    optionValue: { type: 'string' },
+    text: { type: 'string', description: '已渲染的「中文(id)」文本，可直接展示。' },
+});
+const reimPreviewLabeledRowSchema = objectSchema({
+    dataIndex: { type: 'integer' },
+    invoiceId: { type: 'string' },
+    invoiceNumber: { type: 'string' },
+    amount: { type: 'string' },
+    expenseNote: { type: 'string' },
+    subject: { type: 'string', description: '费用科目，已渲染成「中文(id)」。' },
+    currency: { type: 'string', description: '币种，已渲染成「中文(id)」。' },
+});
+const reimTemplatePreviewSchema = objectSchema({
+    ...flowPreviewOutputSchema.properties,
+    totalAmount: { type: 'string' },
+    invoiceCount: { type: 'integer' },
+    mainFields: arrayOf(reimPreviewLabeledFieldSchema, { description: '主表字段的可读渲染，字典类 ID 已带中文名。' }),
+    detailRows: arrayOf(reimPreviewLabeledRowSchema, { description: '明细行的可读渲染，科目/币种已带中文名。' }),
+    unresolvedLabels: arrayOf({ type: 'string' }, { description: '未能取到中文名的 ID 清单。' }),
+}, ['requestName', 'workflowId', 'mainFormId', 'mainFieldCount', 'detailRowCount', 'totalAmount', 'invoiceCount', 'mainFields', 'detailRows', 'unresolvedLabels']);
+const reimTemplatePayloadSchema = objectSchema(reimFlowCreateProperties, [...reimFlowCreateRequired]);
+const reimLabelsSchema = objectSchema({
+    workflow: objectSchema({ id: { type: 'string' }, name: { type: 'string' } }),
+    mainFormId: { type: 'string' },
+    detailSubForm: objectSchema({ id: { type: 'string' }, name: { type: 'string' } }),
+    employees: { type: 'object', additionalProperties: { type: 'string' } },
+    subjects: { type: 'object', additionalProperties: { type: 'string' } },
+    currencies: { type: 'object', additionalProperties: { type: 'string' } },
+    customers: { type: 'object', additionalProperties: { type: 'string' } },
+    selectOptions: { type: 'object', additionalProperties: { type: 'object', additionalProperties: { type: 'string' } } },
+    customer: { type: ['object', 'null'], additionalProperties: true },
+    unresolved: arrayOf({ type: 'string' }),
+}, ['workflow', 'employees', 'subjects', 'currencies', 'customers', 'selectOptions', 'unresolved']);
+const reimTemplateBuildOutputSchema = objectSchema({
+    payload: reimTemplatePayloadSchema,
+    preview: reimTemplatePreviewSchema,
+    labels: reimLabelsSchema,
+    warnings: arrayOf({ type: 'string' }),
+    workflow: workflowSchema,
+}, ['payload', 'preview', 'labels', 'warnings', 'workflow']);
+const reimAutoPrepareOutputSchema = continuationPreviewOutput(reimTemplatePreviewSchema, {
+    payload: reimTemplatePayloadSchema,
+    labels: reimLabelsSchema,
+    warnings: arrayOf({ type: 'string' }),
+});
+const makeInvoicePreviewSchema = objectSchema({
+    mode: { type: 'string', enum: ['issue', 'ledger'] },
+    purchaserName: { type: 'string' },
+    purchaserTaxNo: { type: 'string' },
+    invoiceType: { type: 'string', enum: ['7', '8', '9', '10'] },
+    externalDocumentNo: { type: 'string' },
+    totalAmount: stringOrNumber,
+    taxAmount: stringOrNumber,
+    totalAmountWithTax: stringOrNumber,
+    detailCount: { type: 'integer' },
+}, ['mode', 'purchaserName', 'invoiceType', 'externalDocumentNo', 'totalAmount', 'taxAmount', 'totalAmountWithTax', 'detailCount']);
+const issuingPrepareOutputSchema = continuationPreviewOutput(makeInvoicePreviewSchema, { normalizedPayload: requestPayload });
+const issuingApplyOutputSchema = objectSchema({
+    mode: { type: 'string', enum: ['issue', 'ledger'] },
+    serialNo: { type: 'string' },
+    orderNo: { type: 'string' },
+    ledgerOnly: { type: 'boolean' },
+    result: rawObject,
+    workflow: workflowSchema,
+}, ['mode', 'ledgerOnly', 'result', 'workflow']);
 export const invoiceOperations = [
     {
         name: 'invoice.list',
@@ -149,6 +680,8 @@ export const invoiceOperations = [
         scope: 'personal',
         fixed: { flag: 0, defaultSreim: '3', defaultBillType: 0 },
         inputSchema: { type: 'object', additionalProperties: false, properties: listProperties },
+        outputSchema: listOutputSchema,
+        outputViews: [summaryOutputView],
     },
     {
         name: 'invoice.enterprise.list',
@@ -156,6 +689,8 @@ export const invoiceOperations = [
         scope: 'enterprise',
         fixed: { flag: 6, defaultSreim: '3', defaultBillType: 0 },
         inputSchema: { type: 'object', additionalProperties: false, properties: listProperties },
+        outputSchema: listOutputSchema,
+        outputViews: [summaryOutputView],
     },
     {
         name: 'invoice.get',
@@ -169,6 +704,8 @@ export const invoiceOperations = [
             },
             oneOf: [{ required: ['fid'] }, { required: ['number'] }],
         },
+        outputSchema: invoiceDetailOutputSchema,
+        outputViews: [detailOutputView],
     },
     {
         name: 'invoice.upload',
@@ -183,6 +720,7 @@ export const invoiceOperations = [
             },
             oneOf: [{ required: ['file'] }, { required: ['url'] }],
         },
+        outputSchema: uploadOutputSchema,
     },
     {
         name: 'invoice.ocr.preview',
@@ -199,6 +737,7 @@ export const invoiceOperations = [
             },
             oneOf: [{ required: ['file'] }, { required: ['url'] }, { required: ['upload'] }],
         },
+        outputSchema: ocrPreviewOutputSchema,
     },
     {
         name: 'invoice.validate.preview',
@@ -213,6 +752,24 @@ export const invoiceOperations = [
             },
             required: ['fid', 'scope'],
         },
+        outputSchema: validationPreviewOutputSchema,
+    },
+    {
+        name: 'invoice.upload-and-validate',
+        risk: 'read-with-upload',
+        fixed: { ocr: 1, flag: 100, is_save: 1, needLog: true },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                file: { type: 'string', minLength: 1 },
+                url: { type: 'string', format: 'uri' },
+                scope: { type: 'string', enum: ['personal', 'enterprise'] },
+            },
+            required: ['scope'],
+            oneOf: [{ required: ['file'] }, { required: ['url'] }],
+        },
+        outputSchema: uploadAndValidateOutputSchema,
     },
     {
         name: 'invoice.import.prepare',
@@ -238,6 +795,7 @@ export const invoiceOperations = [
             required: ['validate', 'syncToOa'],
             oneOf: [{ required: ['file'] }, { required: ['url'] }],
         },
+        outputSchema: continuationPreviewOutput(importPreviewSchema),
     },
     {
         name: 'invoice.import.apply',
@@ -259,6 +817,7 @@ export const invoiceOperations = [
             required: ['continuation', 'confirm'],
             oneOf: [{ required: ['file'] }, { required: ['url'] }],
         },
+        outputSchema: importCompleteOutputSchema,
     },
     {
         name: 'invoice.add.prepare',
@@ -272,6 +831,7 @@ export const invoiceOperations = [
             },
             required: ['info', 'scope'],
         },
+        outputSchema: addPrepareOutputSchema,
     },
     {
         name: 'invoice.add.apply',
@@ -286,6 +846,7 @@ export const invoiceOperations = [
             },
             required: ['info', 'continuation', 'confirm'],
         },
+        outputSchema: addApplyOutputSchema,
     },
     {
         name: 'invoice.update.prepare',
@@ -319,6 +880,7 @@ export const invoiceOperations = [
             },
             required: ['fid', 'scope', 'changes'],
         },
+        outputSchema: updatePrepareOutputSchema,
     },
     {
         name: 'invoice.update.apply',
@@ -332,6 +894,7 @@ export const invoiceOperations = [
             },
             required: ['continuation', 'confirm'],
         },
+        outputSchema: updateApplyOutputSchema,
     },
     {
         name: 'invoice.download',
@@ -346,6 +909,7 @@ export const invoiceOperations = [
             },
             required: ['fid', 'fileId', 'output'],
         },
+        outputSchema: downloadOutputSchema,
     },
     {
         name: 'invoice.delete.prepare',
@@ -359,6 +923,7 @@ export const invoiceOperations = [
             },
             required: ['fid'],
         },
+        outputSchema: continuationPreviewOutput(invoicePreviewSchema),
     },
     {
         name: 'invoice.delete.apply',
@@ -372,6 +937,7 @@ export const invoiceOperations = [
             },
             required: ['continuation', 'confirm'],
         },
+        outputSchema: deleteApplyOutputSchema,
     },
     {
         name: 'invoice.browse-field.data',
@@ -387,6 +953,11 @@ export const invoiceOperations = [
             },
             oneOf: [{ required: ['fid'] }, { required: ['fids'] }, { required: ['detail'] }],
         },
+        outputSchema: objectSchema({
+            items: arrayOf(browseFieldItemSchema),
+            errors: arrayOf(browseFieldErrorSchema),
+            workflow: workflowSchema,
+        }, ['items', 'errors', 'workflow']),
     },
     {
         name: 'invoice.reim.file-ocr.preview',
@@ -401,6 +972,7 @@ export const invoiceOperations = [
             },
             oneOf: [{ required: ['fileId'] }, { required: ['fileIds'] }],
         },
+        outputSchema: reimFileOcrOutputSchema,
     },
     {
         name: 'invoice.reim.requests.list',
@@ -417,6 +989,7 @@ export const invoiceOperations = [
                 cusCreateDateEnd: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
             },
         },
+        outputSchema: resultEnvelopeOutput(requestListDataSchema),
     },
     {
         name: 'invoice.reim.workflow.resolve',
@@ -429,6 +1002,7 @@ export const invoiceOperations = [
                 requestIds: { type: 'array', maxItems: 100, items: positiveId, default: [] },
             },
         },
+        outputSchema: resultEnvelopeOutput(workflowResolveDataSchema),
     },
     {
         name: 'invoice.reim.form.structure',
@@ -443,6 +1017,7 @@ export const invoiceOperations = [
             },
             required: ['workflowId'],
         },
+        outputSchema: resultEnvelopeOutput(formStructureDataSchema),
     },
     {
         name: 'invoice.reim.row-info',
@@ -458,6 +1033,34 @@ export const invoiceOperations = [
             },
             required: ['invoiceId'],
         },
+        outputSchema: resultEnvelopeOutput(rowInfoDataSchema),
+    },
+    {
+        name: 'invoice.reim.row-info-batch',
+        risk: 'read',
+        fixed: { path: '/api/secondev/fna/expense/dataInfo/getRowInfo', sf_request_type: 'fetch', concurrency: 4 },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                invoiceIds: positiveIdArray,
+                requestid: { type: 'string' },
+                cdzt: positiveId,
+            },
+            required: ['invoiceIds'],
+        },
+        outputSchema: objectSchema({
+            results: arrayOf(objectSchema({
+                invoiceId: { type: 'string' },
+                status: { type: 'string', enum: ['success', 'fail'] },
+                data: rowInfoDataSchema,
+                error: { type: 'string' },
+            }, ['invoiceId', 'status'])),
+            succeeded: { type: 'integer' },
+            failed: { type: 'integer' },
+            total: { type: 'integer' },
+            workflow: workflowSchema,
+        }, ['results', 'succeeded', 'failed', 'total', 'workflow']),
     },
     {
         name: 'invoice.reim.employee-superiors',
@@ -468,6 +1071,7 @@ export const invoiceOperations = [
             additionalProperties: false,
             properties: {},
         },
+        outputSchema: resultEnvelopeOutput(employeeSuperiorsDataSchema),
     },
     {
         name: 'invoice.reim.field.search',
@@ -484,6 +1088,7 @@ export const invoiceOperations = [
             },
             required: ['keywords', 'fieldId', 'workflowId'],
         },
+        outputSchema: resultEnvelopeOutput(fieldSearchDataSchema),
     },
     {
         name: 'invoice.reim.flow.create.prepare',
@@ -495,6 +1100,7 @@ export const invoiceOperations = [
             properties: reimFlowCreateProperties,
             required: reimFlowCreateRequired,
         },
+        outputSchema: continuationPreviewOutput(flowPreviewOutputSchema),
     },
     {
         name: 'invoice.reim.flow.create.apply',
@@ -509,6 +1115,7 @@ export const invoiceOperations = [
             },
             required: [...reimFlowCreateRequired, 'continuation', 'confirm'],
         },
+        outputSchema: flowCreateApplyOutputSchema,
     },
     {
         name: 'invoice.reim.flow.update.prepare',
@@ -521,6 +1128,7 @@ export const invoiceOperations = [
             required: ['requestId', 'mainFormId'],
             anyOf: [{ required: ['main_fields'] }, { required: ['detail_rows'] }, { required: ['deleteDetailRows'] }],
         },
+        outputSchema: continuationPreviewOutput(flowUpdatePreviewOutputSchema),
     },
     {
         name: 'invoice.reim.flow.update.apply',
@@ -536,6 +1144,46 @@ export const invoiceOperations = [
             required: ['requestId', 'mainFormId', 'continuation', 'confirm'],
             anyOf: [{ required: ['main_fields'] }, { required: ['detail_rows'] }, { required: ['deleteDetailRows'] }],
         },
+        outputSchema: flowUpdateApplyOutputSchema,
+    },
+    {
+        name: 'invoice.reim.candidates.list',
+        risk: 'read',
+        fixed: { path: '/api/inc/sync', sreim: '3', billType: 0 },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            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，含）。' },
+                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 告知，不会静默丢失。' },
+            },
+        },
+        outputSchema: reimCandidatesOutputSchema,
+    },
+    {
+        name: 'invoice.reim.template.build',
+        risk: 'read',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: reimTemplateInputProperties,
+            required: ['invoiceIds', 'requestName'],
+        },
+        outputSchema: reimTemplateBuildOutputSchema,
+    },
+    {
+        name: 'invoice.reim.flow.create.auto-prepare',
+        risk: 'read-before-write',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: reimTemplateInputProperties,
+            required: ['invoiceIds', 'requestName'],
+        },
+        outputSchema: reimAutoPrepareOutputSchema,
     },
     {
         name: 'invoice.issuing.make.prepare',
@@ -554,6 +1202,7 @@ export const invoiceOperations = [
             },
             required: ['mode', 'payload'],
         },
+        outputSchema: issuingPrepareOutputSchema,
     },
     {
         name: 'invoice.issuing.make.apply',
@@ -568,6 +1217,7 @@ export const invoiceOperations = [
             },
             required: ['payload', 'continuation', 'confirm'],
         },
+        outputSchema: issuingApplyOutputSchema,
     },
 ];
 export const invoiceManifest = {
@@ -578,6 +1228,26 @@ export const invoiceManifest = {
     host: 'e10-invoice',
     status: 'builtin',
     sourceSkill: 'weaver-e10-yepiaotong',
+    /**
+     * CLI 侧的输出投影参数。它们不属于任何 operation 的 inputSchema（不参与请求体），
+     * 而是裁剪返回的 envelope.data，用于替代"调用方自己写脚本解析完整 JSON"。
+     */
+    projectionOptions: {
+        '--view': {
+            values: OUTPUT_VIEWS,
+            default: 'full',
+            description: `输出视图。full=完整包络；summary=${SUMMARY_ITEM_FIELDS.length} 个语义字段的平表，仅 invoice.list / invoice.enterprise.list 支持；detail=${DETAIL_ITEM_FIELDS.length} 个字段的单张发票详情（含附件、费用说明、查验标记），仅 invoice.get 支持。`,
+        },
+        '--format': {
+            values: OUTPUT_FORMATS,
+            default: 'json',
+            description: '输出格式。json=标准 envelope（默认，供程序消费）；markdown=人读渲染（票夹列表/发票详情两类模板，内置列顺序与单位），仅 invoice.list / invoice.enterprise.list / invoice.get 支持，且与 --json、--fields 互斥。markdown 档自带字段口径（list→summary、get→detail），不必再传 --view。',
+        },
+        '--fields': {
+            description: '逗号分隔的点路径列表，按原结构投影，例如 --fields number,detailUrl。所有 operation 可用；未命中的路径会出现在 meta.projection.missingFields 里。⚠️ 不要用裸 total 取金额：发票顶层 total 是 E10 的独立字段（实测恒为 0），价税合计在 comm_info.price.total，不含税金额在 comm_info.price.amount。',
+        },
+        note: '--view 与 --fields 互斥；--format markdown 与 --json/--fields 互斥。投影只影响输出，不改变任何请求参数；meta.projection 会说明本次裁剪结果。',
+    },
     operations: invoiceOperations,
     withheldOperations: [
         {