weaver-work-cli 0.1.25 → 0.1.26

package/dist/shortcuts/archive-oa/operations/borrow-url.js

@@ -0,0 +1,108 @@
+import { BORROW_FLOW_ID, MAX_BORROW_ITEMS } from '../constants.js';
+import { archiveOaValidationError } from '../errors.js';
+import { normalizeListResult } from './shared.js';
+import { READ, archiveOaSuccess, schemaOf, } from './types.js';
+const CONTRACT_LIST_PATH = '/api/ebuilder/form/list/getListDatas';
+/**
+ * 构造「发起借阅」流程创建页 URL。
+ *
+ * 与界面「确认发起」完全一致：`/sp/workflow/flowpage/fullCreate/<flowId>?fb=<fb>&data=<JSON>`。
+ * 只生成前端可打开的地址，不写数据、不触发流程，也不需要任何后台应用凭据。
+ */
+export function buildBorrowStartUrl(baseUrl, fb, items) {
+    const root = baseUrl.replace(/\/+$/, '');
+    const data = encodeURIComponent(JSON.stringify(items));
+    return `${root}/sp/workflow/flowpage/fullCreate/${BORROW_FLOW_ID}?fb=${fb}&data=${data}`;
+}
+function toItem(row) {
+    return {
+        hth: String(row?.hth ?? ''),
+        /** 泛微用 htmc，契约锁用 qymc，二者取其一，缺失为空串。 */
+        htmc: String(row?.htmc ?? row?.qymc ?? ''),
+        yfhd: String(row?.yfhd ?? row?.yhhd ?? ''),
+        fph: String(row?.fph ?? ''),
+    };
+}
+export function createBorrowStartUrlOperation(profile) {
+    const name = profile.source === 'qys'
+        ? 'archive-oa.qys.borrow.start.url'
+        : 'archive-oa.borrow.start.url';
+    const listName = profile.source === 'qys' ? 'archive-oa.qys.borrow-car.list' : 'archive-oa.borrow-car.list';
+    return {
+        name,
+        resource: 'borrow',
+        method: 'start-url',
+        action: name,
+        summary: '按借阅车记录构造「发起借阅」流程创建页 URL（只读：不写数据、不触发流程、不需要后台应用凭据）',
+        capability: 'borrowCar',
+        risk: READ,
+        inputSchema: schemaOf({
+            contractNos: {
+                type: 'array',
+                items: { type: 'string' },
+                maxItems: MAX_BORROW_ITEMS,
+                description: `要借阅的合同号（取自借阅车），最多 ${MAX_BORROW_ITEMS} 个；不传表示使用整页借阅车记录`,
+            },
+        }, { description: '构造发起借阅流程创建页 URL' }),
+        handler: async (args, env) => {
+            const session = await env.host.getSession();
+            const response = await env.host.request({
+                method: 'POST',
+                path: CONTRACT_LIST_PATH,
+                operation: listName,
+                query: { passid: profile.passId, cid: profile.passId, sf_request_type: 'ajax' },
+                body: {
+                    current: 1,
+                    requiredMatch: 1,
+                    mapResult: '1',
+                    recheckQuery: '1',
+                    cusMenuId: profile.cusMenuId,
+                    urlPageTitle: profile.urlPageTitle,
+                    searchParamData: {
+                        searchType: '2',
+                        type: 'and',
+                        commonSearchFields: {},
+                        groupFields: {},
+                    },
+                    listId: profile.listId,
+                    isFollow: 0,
+                    isShareToMe: 0,
+                    filterCondition: {},
+                    browser: 'Chrome',
+                },
+            });
+            const { rows, meta } = normalizeListResult(listName, response, profile.source);
+            const requested = Array.isArray(args.contractNos)
+                ? args.contractNos.map((value) => String(value).trim()).filter(Boolean)
+                : [];
+            let picked = rows;
+            if (requested.length > 0) {
+                if (requested.length > MAX_BORROW_ITEMS) {
+                    throw archiveOaValidationError('too_many_items', `一次最多借阅 ${MAX_BORROW_ITEMS} 条，当前传入 ${requested.length} 条`);
+                }
+                picked = rows.filter((row) => requested.includes(String(row?.hth ?? '')));
+                const missing = requested.filter((no) => !picked.some((row) => String(row?.hth ?? '') === no));
+                if (missing.length > 0) {
+                    throw archiveOaValidationError('contract_not_in_borrow_car', `借阅车中不存在这些合同号：${missing.join('、')}`, { missing });
+                }
+            }
+            if (picked.length === 0) {
+                throw archiveOaValidationError('borrow_car_empty', '借阅车为空，请先把合同加入借阅车');
+            }
+            if (picked.length > MAX_BORROW_ITEMS) {
+                throw archiveOaValidationError('too_many_items', `借阅车可发起条数最多 ${MAX_BORROW_ITEMS} 条，当前 ${picked.length} 条，请指定合同号`);
+            }
+            const fb = String(picked[0]?.fb ?? '0');
+            const items = picked.map(toItem);
+            const url = buildBorrowStartUrl(session.baseUrl, fb, items);
+            return archiveOaSuccess(name, {
+                url,
+                flowId: BORROW_FLOW_ID,
+                fb,
+                items,
+                borrowCarCount: rows.length,
+                columns: meta.columns,
+            }, { opensBrowser: false, count: items.length });
+        },
+    };
+}

package/dist/shortcuts/archive-oa/operations/confirm.js

@@ -0,0 +1,48 @@
+import { archiveOaConfirmationError, archiveOaValidationError } from '../errors.js';
+/** apply 类写操作必须显式确认。 */
+export function requireConfirm(args, action) {
+    if (args.confirm !== true) {
+        throw archiveOaConfirmationError(action, {
+            hint: `执行 ${action} 必须显式确认：传入 confirm=true（CLI 用 --yes）`,
+        });
+    }
+}
+/**
+ * prepare 阶段签发 continuation。
+ * 环境指纹（baseUrl + 登录账号）写进票据，apply 时校验，避免跨环境/跨账号复用。
+ */
+export async function issueLease(env, action, payload, ttlMs = 10 * 60_000) {
+    const session = await env.host.getSession();
+    const continuation = await env.continuation.issue({
+        operation: action,
+        baseUrl: session.baseUrl,
+        userId: session.userId,
+        ...payload,
+    }, ttlMs);
+    return { continuation, expiresInMs: ttlMs };
+}
+/** apply 阶段校验确认 + continuation，返回 prepare 时写入的快照。 */
+export async function verifyLease(args, action, env) {
+    requireConfirm(args, action);
+    if (typeof args.continuation !== 'string' || !args.continuation.trim()) {
+        throw archiveOaValidationError('continuation_required', `${action} 必须传入 prepare 返回的 continuation`);
+    }
+    const lease = await env.continuation.verify(args.continuation.trim(), action);
+    const session = await env.host.getSession();
+    if (lease.baseUrl !== session.baseUrl || lease.userId !== session.userId) {
+        throw archiveOaValidationError('continuation_context_mismatch', '确认上下文已变化（环境或登录账号不同），请重新执行 prepare');
+    }
+    return lease;
+}
+/** 校验 apply 入参与 prepare 快照一致，避免目标漂移。 */
+export function assertLeaseTarget(lease, args, keys, action) {
+    for (const key of keys) {
+        if (args[key] === undefined || args[key] === null || args[key] === '')
+            continue;
+        const expected = String(lease[key] ?? '');
+        const actual = Array.isArray(args[key]) ? args[key].map(String).join(',') : String(args[key]);
+        if (expected !== actual) {
+            throw archiveOaValidationError('continuation_target_changed', `${action} 的参数 ${key} 与 prepare 时不一致，请重新执行 prepare`);
+        }
+    }
+}

package/dist/shortcuts/archive-oa/operations/contract.js

@@ -0,0 +1,120 @@
+import { QYS_CONTRACT, QYS_DEFAULT_ARCHIVED_FIELD, QYS_DEFAULT_ARCHIVED_VALUE, WEAVER_CONTRACT, } from '../constants.js';
+import { READ, archiveOaSuccess, schemaOf, SCHEMA_PAGE_NO, SCHEMA_SEARCH_FIELDS, } from './types.js';
+import { assertEnum, buildCommonSearchFields, normalizeListResult, positiveInt, unwrapData } from './shared.js';
+const CONTRACT_LIST_PATH = '/api/ebuilder/form/list/getListDatas';
+function filterPath(profile) {
+    return `/api/ebuilder/form/listFilter/showFilters/${profile.listId}`;
+}
+function operationName(profile, action) {
+    return profile.source === 'qys'
+        ? `archive-oa.qys.contract.${action}`
+        : `archive-oa.contract.${action}`;
+}
+/** getListDatas 的固定请求体（分页与视图参数）。 */
+function listBody(profile, pageNo, commonSearchFields, matchType) {
+    return {
+        current: pageNo,
+        requiredMatch: 1,
+        mapResult: '1',
+        recheckQuery: '1',
+        cusMenuId: profile.cusMenuId,
+        urlPageTitle: profile.urlPageTitle,
+        searchParamData: {
+            searchType: '2',
+            type: matchType,
+            commonSearchFields,
+            groupFields: {},
+        },
+        listId: profile.listId,
+        isFollow: 0,
+        isShareToMe: 0,
+        filterCondition: {},
+        browser: 'Chrome',
+    };
+}
+/** 搜索字段配置（showFilters）：只有源资料收录了该辅助接口才生成。 */
+function makeFieldsOperation(profile) {
+    const name = operationName(profile, 'fields');
+    return {
+        name,
+        resource: 'contract',
+        method: 'fields',
+        action: name,
+        summary: `查询${profile.source === 'qys' ? '契约锁' : '泛微'}商务合同可搜索字段配置（构造 commonSearchFields 用）`,
+        capability: 'contract-search',
+        risk: READ,
+        inputSchema: schemaOf({}, { description: '查询合同搜索字段配置，无需入参' }),
+        handler: async (_args, env) => {
+            const response = await env.host.request({
+                method: 'GET',
+                path: filterPath(profile),
+                operation: name,
+                query: { passid: profile.passId, sf_request_type: 'ajax' },
+            });
+            const data = (unwrapData(response) ?? {});
+            const fields = Array.isArray(data.fields)
+                ? data.fields
+                : Array.isArray(data)
+                    ? data
+                    : [];
+            return archiveOaSuccess(name, { fields }, { source: profile.source, listId: profile.listId, count: Array.isArray(fields) ? fields.length : 0 });
+        },
+    };
+}
+/** 商务合同列表查询。 */
+function makeListOperation(profile) {
+    const name = operationName(profile, 'list');
+    const isQys = profile.source === 'qys';
+    return {
+        name,
+        resource: 'contract',
+        method: 'list',
+        action: name,
+        summary: `查询${isQys ? '契约锁协作采纳（案例）' : '泛微'}商务合同列表`,
+        capability: 'contract-search',
+        risk: READ,
+        inputSchema: schemaOf({
+            pageNo: { ...SCHEMA_PAGE_NO, description: '页码，从 1 开始，缺省 1' },
+            fields: SCHEMA_SEARCH_FIELDS,
+            matchType: {
+                type: 'string',
+                enum: ['and', 'or'],
+                description: '多条件组合方式，缺省 and（源资料约定默认「且」）',
+            },
+            ...(isQys
+                ? {
+                    archivedOnly: {
+                        type: 'boolean',
+                        description: `默认 true：附加 ${QYS_DEFAULT_ARCHIVED_FIELD}=${QYS_DEFAULT_ARCHIVED_VALUE}（处理进度=已归档）过滤`,
+                    },
+                }
+                : {}),
+        }, { description: `查询${isQys ? '契约锁' : '泛微'}商务合同列表` }),
+        handler: async (args, env) => {
+            const pageNo = positiveInt(args.pageNo, 'pageNo', 1);
+            const matchType = args.matchType === undefined ? 'and' : assertEnum(args.matchType, ['and', 'or'], 'matchType');
+            const extra = [];
+            const archivedOnly = args.archivedOnly === undefined ? true : args.archivedOnly;
+            if (isQys && archivedOnly === true) {
+                extra.push({
+                    field: QYS_DEFAULT_ARCHIVED_FIELD,
+                    conditionType: 'like',
+                    value: QYS_DEFAULT_ARCHIVED_VALUE,
+                });
+            }
+            const commonSearchFields = buildCommonSearchFields(args.fields, extra);
+            const response = await env.host.request({
+                method: 'POST',
+                path: CONTRACT_LIST_PATH,
+                operation: name,
+                query: { passid: profile.passId, cid: profile.passId, sf_request_type: 'ajax' },
+                body: listBody(profile, pageNo, commonSearchFields, matchType),
+            });
+            const { rows, meta } = normalizeListResult(name, response, profile.source);
+            return archiveOaSuccess(name, { rows, searchFields: commonSearchFields }, { ...meta, pageNo, archivedOnly: isQys ? archivedOnly : undefined });
+        },
+    };
+}
+export const weaverContractFieldsOperation = makeFieldsOperation(WEAVER_CONTRACT);
+export const weaverContractListOperation = makeListOperation(WEAVER_CONTRACT);
+export const qysContractListOperation = makeListOperation(QYS_CONTRACT);

package/dist/shortcuts/archive-oa/operations/locate.js

@@ -0,0 +1,50 @@
+import { ARCHIVE_LOCATE_PATH } from '../constants.js';
+import { READ, archiveOaSuccess, schemaOf, SCHEMA_PAGE_NO, } from './types.js';
+import { positiveInt, requireText } from './shared.js';
+export const ARCHIVE_LOCATE = 'archive-oa.archive.locate';
+/**
+ * 按合同号定位档案。
+ *
+ * 接口契约要点（源资料实测）：合同号必须放在 body 顶层 `htbh`；
+ * 放进 `datajson.mainTable` 会被忽略并返回整表默认列表。
+ */
+export const archiveLocateOperation = {
+    name: ARCHIVE_LOCATE,
+    resource: 'archive',
+    method: 'locate',
+    action: ARCHIVE_LOCATE,
+    summary: '按合同号定位档案：返回档案记录 ID / 题名 / 合同号',
+    capability: 'archive-locate',
+    risk: READ,
+    inputSchema: schemaOf({
+        contractNo: { type: 'string', minLength: 1, description: '合同号（对应接口顶层 htbh）' },
+        pageNo: { ...SCHEMA_PAGE_NO, description: '页码，从 1 开始，缺省 1' },
+    }, { required: ['contractNo'], description: '按合同号定位档案' }),
+    handler: async (args, env) => {
+        const contractNo = requireText(args.contractNo, 'contractNo');
+        const pageNo = positiveInt(args.pageNo, 'pageNo', 1);
+        const response = await env.host.request({
+            method: 'POST',
+            path: ARCHIVE_LOCATE_PATH,
+            operation: ARCHIVE_LOCATE,
+            body: {
+                htbh: contractNo,
+                datajson: {
+                    mainTable: {},
+                    pageInfo: { pageNo: String(pageNo) },
+                },
+            },
+        });
+        const datajson = (response?.datajson ?? {});
+        const datas = Array.isArray(datajson.datas) ? datajson.datas : [];
+        const rows = datas.map((item) => {
+            const mainTable = (item?.mainTable ?? {});
+            return {
+                id: String(mainTable.id ?? '').trim(),
+                title: String(mainTable.folder_title ?? '').trim(),
+                contractNo: String(mainTable.hth ?? contractNo).trim(),
+            };
+        });
+        return archiveOaSuccess(ARCHIVE_LOCATE, { rows, matched: rows.length > 0 }, { count: rows.length, contractNo, pageNo });
+    },
+};

package/dist/shortcuts/archive-oa/operations/registry.js

@@ -0,0 +1,40 @@
+import { QYS_BORROW_CAR, QYS_ESB_ADD, WEAVER_BORROW_CAR, WEAVER_ESB_ADD } from '../constants.js';
+import { archiveOaValidationError } from '../errors.js';
+import { createBorrowCarOperations } from './borrow-car.js';
+import { createBorrowStartUrlOperation } from './borrow-url.js';
+import { qysContractListOperation, weaverContractFieldsOperation, weaverContractListOperation, } from './contract.js';
+import { archiveLocateOperation } from './locate.js';
+function buildRegistry() {
+    const registry = new Map();
+    const definitions = [
+        archiveLocateOperation,
+        weaverContractFieldsOperation,
+        weaverContractListOperation,
+        qysContractListOperation,
+        ...createBorrowCarOperations(WEAVER_BORROW_CAR, WEAVER_ESB_ADD),
+        ...createBorrowCarOperations(QYS_BORROW_CAR, QYS_ESB_ADD),
+        createBorrowStartUrlOperation(WEAVER_BORROW_CAR),
+        createBorrowStartUrlOperation(QYS_BORROW_CAR),
+    ];
+    for (const definition of definitions) {
+        if (registry.has(definition.name)) {
+            throw new Error(`duplicate archive-oa operation: ${definition.name}`);
+        }
+        registry.set(definition.name, definition);
+    }
+    return registry;
+}
+const archiveOaOperationRegistry = buildRegistry();
+export function archiveOaOperationDefinitions() {
+    return [...archiveOaOperationRegistry.values()];
+}
+export function getArchiveOaOperation(operation) {
+    const definition = archiveOaOperationRegistry.get(operation);
+    if (!definition) {
+        throw archiveOaValidationError('operation_unknown', `archive-oa 不支持操作：${operation}`);
+    }
+    return definition;
+}
+export function hasArchiveOaOperation(operation) {
+    return archiveOaOperationRegistry.has(operation);
+}

package/dist/shortcuts/archive-oa/operations/shared.js

@@ -0,0 +1,181 @@
+import { MAX_BORROW_ITEMS } from '../constants.js';
+import { archiveOaValidationError } from '../errors.js';
+/** 原型污染防护：禁止出现在输入对象中的键。 */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+const CONDITION_TYPES = new Set(['like', 'between', 'in', 'inC']);
+export function asObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw archiveOaValidationError('input_not_object', '输入必须是 JSON 对象');
+    }
+    return value;
+}
+export function assertNoForbiddenKeys(input) {
+    for (const key of Object.keys(input)) {
+        if (FORBIDDEN_KEYS.has(key)) {
+            throw archiveOaValidationError('forbidden_key', `输入包含非法字段：${key}`);
+        }
+    }
+}
+/** 取出响应中的业务数据。 */
+export function unwrapData(response) {
+    if (!response || typeof response !== 'object')
+        return response;
+    return response.data;
+}
+/** 正整数入参（页码）。 */
+export function positiveInt(value, field, fallback) {
+    if (value === undefined || value === null || value === '')
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw archiveOaValidationError('number_invalid', `${field} 必须是正整数`);
+    }
+    return parsed;
+}
+/** 非空字符串。 */
+export function requireText(value, field) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw archiveOaValidationError('field_required', `${field} 必填`);
+    }
+    return value.trim();
+}
+/** 安全布尔。 */
+export function requireBoolean(value, field) {
+    if (typeof value !== 'boolean') {
+        throw archiveOaValidationError('boolean_invalid', `${field} 必须是布尔值`);
+    }
+    return value;
+}
+/** 校验枚举。 */
+export function assertEnum(value, allowed, field) {
+    const text = typeof value === 'string' ? value : String(value);
+    if (!allowed.includes(text)) {
+        throw archiveOaValidationError('enum_invalid', `${field} 取值必须是 ${allowed.join(' / ')} 之一`);
+    }
+    return text;
+}
+/** 数字 ID 数组（合同数据行 id / 借阅车记录 id）。 */
+export function requireIdList(value, field, max = MAX_BORROW_ITEMS) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw archiveOaValidationError('id_list_required', `${field} 必填且至少一项`);
+    }
+    if (value.length > max) {
+        throw archiveOaValidationError('id_list_too_many', `${field} 最多 ${max} 条，当前 ${value.length} 条`);
+    }
+    const seen = new Set();
+    return value.map((item, index) => {
+        const text = typeof item === 'string' ? item.trim() : String(item ?? '').trim();
+        if (!/^\d+$/.test(text)) {
+            throw archiveOaValidationError('id_list_invalid', `${field}[${index}] 必须是数字 ID`);
+        }
+        if (seen.has(text)) {
+            throw archiveOaValidationError('id_list_duplicated', `${field}[${index}] 重复：${text}`);
+        }
+        seen.add(text);
+        return text;
+    });
+}
+/** 合同号数组（发起借阅的 hth）。 */
+export function requireContractNoList(value, field, max = MAX_BORROW_ITEMS) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw archiveOaValidationError('contract_no_required', `${field} 必填且至少一项`);
+    }
+    if (value.length > max) {
+        throw archiveOaValidationError('contract_no_too_many', `${field} 最多 ${max} 个，当前 ${value.length} 个`);
+    }
+    return value.map((item, index) => {
+        if (typeof item !== 'string' || !item.trim()) {
+            throw archiveOaValidationError('contract_no_invalid', `${field}[${index}] 必须是非空合同号`);
+        }
+        const text = item.trim();
+        if (/[,\s]/.test(text)) {
+            throw archiveOaValidationError('contract_no_invalid', `${field}[${index}] 不能包含逗号或空白`);
+        }
+        return text;
+    });
+}
+/**
+ * 组装 getListDatas 的 commonSearchFields。
+ *
+ * 契约：`{ "<field>": [{ "<field>_condition_type": "<type>", "<field>": <value> }] }`。
+ * between 的值既支持 `{min,max}` 也支持 `[起,止]`；in / inC 的值必须是数组。
+ */
+export function buildCommonSearchFields(fields, extra = []) {
+    const result = {};
+    const items = [...extra];
+    if (fields !== undefined && fields !== null) {
+        if (!Array.isArray(fields)) {
+            throw archiveOaValidationError('search_fields_invalid', 'fields 必须是数组');
+        }
+        for (const [index, raw] of fields.entries()) {
+            if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+                throw archiveOaValidationError('search_fields_invalid', `fields[${index}] 必须是对象`);
+            }
+            const item = raw;
+            const field = requireText(item.field, `fields[${index}].field`);
+            const conditionType = item.conditionType === undefined || item.conditionType === null
+                ? 'like'
+                : String(item.conditionType);
+            if (!CONDITION_TYPES.has(conditionType)) {
+                throw archiveOaValidationError('search_condition_invalid', `fields[${index}].conditionType 必须是 like / between / in / inC 之一`);
+            }
+            if (item.value === undefined || item.value === null) {
+                throw archiveOaValidationError('search_value_required', `fields[${index}].value 必填`);
+            }
+            items.push({ field, conditionType, value: item.value });
+        }
+    }
+    for (const item of items) {
+        const value = normalizeConditionValue(item.conditionType, item.value, item.field);
+        result[item.field] = [{ [`${item.field}_condition_type`]: item.conditionType, [item.field]: value }];
+    }
+    return result;
+}
+function normalizeConditionValue(conditionType, value, field) {
+    if (conditionType === 'between') {
+        if (Array.isArray(value)) {
+            if (value.length !== 2) {
+                throw archiveOaValidationError('search_value_invalid', `${field} 的 between 条件需要两个值`);
+            }
+            return { min: String(value[0]), max: String(value[1]) };
+        }
+        if (value && typeof value === 'object') {
+            const range = value;
+            if (range.min === undefined || range.max === undefined) {
+                throw archiveOaValidationError('search_value_invalid', `${field} 的 between 条件需要 min / max`);
+            }
+            return { min: String(range.min), max: String(range.max) };
+        }
+        throw archiveOaValidationError('search_value_invalid', `${field} 的 between 条件必须是 {min,max} 或 [起,止]`);
+    }
+    if (conditionType === 'in' || conditionType === 'inC') {
+        if (!Array.isArray(value)) {
+            throw archiveOaValidationError('search_value_invalid', `${field} 的 ${conditionType} 条件必须是数组`);
+        }
+        return value;
+    }
+    return value;
+}
+/** 从 getListDatas 响应里提取行与列，并对内部 ID 做静默缓存（不回显给模型以外的地方）。 */
+export function normalizeListResult(action, response, source) {
+    const data = (unwrapData(response) ?? {});
+    const rows = Array.isArray(data.data) ? data.data : [];
+    const columns = Array.isArray(data.columns)
+        ? data.columns.map((column) => ({
+            title: String(column?.title ?? ''),
+            dataIndex: String(column?.dataIndex ?? ''),
+        }))
+        : [];
+    return {
+        rows,
+        meta: {
+            source,
+            count: rows.length,
+            current: data.current ?? undefined,
+            pageSize: data.pageSize ?? undefined,
+            /** 接口可能返回 total=0 但 data 非空，属于正常现象，不做无数据判定。 */
+            total: data.total ?? undefined,
+            columns,
+        },
+    };
+}

package/dist/shortcuts/archive-oa/operations/types.js

@@ -0,0 +1,45 @@
+export const READ = 'read';
+export const READ_BEFORE_WRITE = 'read-before-write';
+export const HIGH_RISK_WRITE = 'high-risk-write';
+export function archiveOaSuccess(action, data, meta) {
+    const payload = { ok: true, action, data };
+    if (meta && Object.keys(meta).length > 0)
+        payload.meta = meta;
+    return payload;
+}
+/** 构造「对象类型 + 严格禁止额外字段」的 JSON Schema。 */
+export function schemaOf(properties, options = {}) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        ...(options.required?.length ? { required: options.required } : {}),
+        ...(options.description ? { description: options.description } : {}),
+    };
+}
+export const SCHEMA_PAGE_NO = { type: 'integer', minimum: 1 };
+export const SCHEMA_ID_STRING = { type: 'string', pattern: '^\\d+$' };
+export const SCHEMA_ID_LIST = { type: 'array', items: SCHEMA_ID_STRING, minItems: 1 };
+export const SCHEMA_CONTRACT_NO_LIST = {
+    type: 'array',
+    items: { type: 'string', minLength: 1 },
+    minItems: 1,
+};
+export const SCHEMA_SEARCH_FIELDS = {
+    type: 'array',
+    description: '搜索条件数组，元素为 { field, conditionType, value }',
+    items: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['field', 'value'],
+        properties: {
+            field: { type: 'string', minLength: 1, description: '字段内部名，如 hth / khmc / htzje / zxfa' },
+            conditionType: {
+                type: 'string',
+                enum: ['like', 'between', 'in', 'inC'],
+                description: '条件类型，缺省 like；between 用 {min,max} 或 [起,止]；in/inC 用数组',
+            },
+            value: { description: '条件值：like 为字符串，between 为对象或二元数组，in/inC 为数组' },
+        },
+    },
+};

package/dist/shortcuts/archive-oa/operations.js

@@ -0,0 +1,13 @@
+import { getArchiveOaOperation } from './operations/registry.js';
+import { asObject, assertNoForbiddenKeys } from './operations/shared.js';
+/**
+ * 执行一个 archive-oa 操作。操作定义（入参 schema、风险等级、是否必须确认）
+ * 全部来自 operations/registry，CLI 侧只负责校验输入形状。
+ */
+export async function executeArchiveOaOperation(operation, rawInput, env) {
+    const definition = getArchiveOaOperation(operation);
+    const input = asObject(rawInput);
+    assertNoForbiddenKeys(input);
+    return definition.handler(input, { ctx: env.ctx, host: env.host, continuation: env.continuation });
+}
+export { archiveOaOperationDefinitions, getArchiveOaOperation, hasArchiveOaOperation } from './operations/registry.js';

package/dist/shortcuts/index.js

@@ -2,6 +2,7 @@ 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';
@@ -21,6 +22,7 @@ export const builtinShortcuts = [
     invoiceShortcut,
     ehrShortcut,
     archiveShortcut,
+    archiveOaShortcut,
     calendarShortcut,
     fnaShortcut,
     hrmShortcut,

package/dist/shortcuts/invoice/host.js

@@ -229,7 +229,7 @@ export function createInvoiceHost(ctx, dependencies = {}) {
         return handleBusinessResponse(value, () => invoiceRequest(request, false), canRetryExpiredToken && Boolean(token));
     }
     async function invoiceMultipartRequest(request, canRetryExpiredToken = true) {
-        const { method = 'POST', path, query, fields = {}, file, operation, needsInvoiceToken = true, timeoutMs = 30_000, } = request;
+        const { method = 'POST', path, query, fields = {}, file, headers, operation, needsInvoiceToken = true, timeoutMs = 30_000, } = request;
         if (!file && !Object.values(fields).some((value) => value !== undefined && value !== null && value !== '')) {
             throw invoiceValidationError('input_invalid', 'multipart 请求需要文件、URL 或表单字段');
         }
@@ -251,6 +251,7 @@ export function createInvoiceHost(ctx, dependencies = {}) {
             method,
             path,
             query,
+            headers,
             formData: form,
             timeoutMs,
             trustedHeaders: trustedInvoiceHeaders(token),