weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/archive/operations/flow-url.js

@@ -0,0 +1,240 @@
+import { archiveValidationError } from '../errors.js';
+import { READ, WRITE, archiveSuccess, schemaOf, } from './types.js';
+import { unwrapData } from './shared.js';
+import { assertLeaseTarget, issueLease, verifyLease } from './confirm.js';
+const BORROW_CAR_APPLY = 'archive.flow.borrow-car.apply';
+const SEARCH_APPLY = 'archive.flow.search.apply';
+const RENEW_APPLY = 'archive.flow.renew.apply';
+const ARC_ID_PATTERN = /^\d+_\d+$/;
+const NUMERIC_PATTERN = /^\d+$/;
+function requireArcIds(value, field) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw archiveValidationError('arc_ids_required', `${field} 必填且至少一项`);
+    }
+    return value.map((item, index) => {
+        const text = String(item ?? '').trim();
+        if (!ARC_ID_PATTERN.test(text)) {
+            throw archiveValidationError('arc_id_invalid', `${field}[${index}] 必须是 {档案ID}_{表单ID} 格式`);
+        }
+        return text;
+    });
+}
+function requireIdList(value, field) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw archiveValidationError('id_list_required', `${field} 必填且至少一项`);
+    }
+    return value.map((item, index) => {
+        const text = String(item ?? '').trim();
+        if (!NUMERIC_PATTERN.test(text)) {
+            throw archiveValidationError('id_list_invalid', `${field}[${index}] 必须是数字 ID`);
+        }
+        return text;
+    });
+}
+/** 借阅流程绑定检查：data 为空表示未绑定。 */
+async function fetchWorkflowId(host) {
+    const response = await host.request({
+        method: 'GET',
+        path: '/api/archive/core/archiveSet/getSetValue',
+        query: { keyname: 'borrow_flow_check' },
+    });
+    const workflowId = String(unwrapData(response) ?? '').trim();
+    if (!workflowId) {
+        throw archiveValidationError('borrow_flow_unbound', '未绑定借阅流程，请联系管理员在档案设置中绑定借阅流程后再发起借阅');
+    }
+    return workflowId;
+}
+async function addCache(host, value, logFlag) {
+    const body = { key: 'arcActionIds', value, time: '86400' };
+    if (logFlag)
+        body.logFlag = logFlag;
+    const response = await host.request({ method: 'POST', path: '/api/archive/core/form/addCache', body });
+    const data = (unwrapData(response) ?? {});
+    const index = String(data.index ?? '').trim();
+    if (!index) {
+        throw archiveValidationError('cache_index_missing', '参数缓存失败，未取到缓存索引');
+    }
+    return index;
+}
+function buildFlowUrl(baseUrl, workflowId, params) {
+    const root = baseUrl.replace(/\/+$/, '');
+    const search = new URLSearchParams(params).toString();
+    return `${root}/sp/workflow/flowpage/fullCreate/${workflowId}?${search}`;
+}
+function flowResult(action, baseUrl, workflowId, params, extra = {}) {
+    return archiveSuccess(action, {
+        ...extra,
+        workflowId,
+        url: buildFlowUrl(baseUrl, workflowId, params),
+        params,
+        hint: 'CLI 不自动打开浏览器，请在浏览器中打开该 URL 完成后续填写与提交',
+    }, { wrote: true });
+}
+const flowBorrowCarPrepare = {
+    name: 'archive.flow.borrow-car.prepare',
+    resource: 'flow',
+    method: 'borrow-car',
+    action: 'archive.flow.borrow-car.prepare',
+    summary: '从借阅车发起借阅：检查流程绑定并生成确认票据（不写数据）',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({
+        arcIds: { type: 'array', items: { type: 'string' }, description: '档案标识数组，元素为 {档案ID}_{表单ID}' },
+        carIds: { type: 'array', items: { type: 'string' }, description: '借阅车记录 ID 数组，与 arcIds 一一对应' },
+    }, { required: ['arcIds', 'carIds'], description: '从借阅车发起借阅' }),
+    handler: async (args, env) => {
+        const arcIds = requireArcIds(args.arcIds, 'arcIds');
+        const carIds = requireIdList(args.carIds, 'carIds');
+        if (arcIds.length !== carIds.length) {
+            throw archiveValidationError('id_count_mismatch', 'arcIds 与 carIds 数量必须一致');
+        }
+        const workflowId = await fetchWorkflowId(env.host);
+        const { continuation, expiresInMs } = await issueLease(env, BORROW_CAR_APPLY, { workflowId, arcIds, carIds });
+        return archiveSuccess('archive.flow.borrow-car.prepare', {
+            preview: { workflowId, count: arcIds.length, arcIds, carIds },
+            hint: '确认后调用 archive.flow.borrow-car.apply（CLI：archive flow borrow-car-apply --continuation <token> --yes）',
+            continuation,
+        }, { requiresConfirmation: true, expiresInMs });
+    },
+};
+const flowBorrowCarApply = {
+    name: BORROW_CAR_APPLY,
+    resource: 'flow',
+    method: 'borrow-car',
+    action: BORROW_CAR_APPLY,
+    summary: '从借阅车发起借阅（写操作）：缓存档案与借阅车参数，返回借阅流程创建页 URL',
+    capability: 'archive',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: schemaOf({
+        continuation: { type: 'string', description: 'prepare 返回的确认票据' },
+        confirm: { type: 'boolean', description: '必须为 true（CLI --yes）' },
+    }, { required: ['continuation', 'confirm'], description: '从借阅车发起借阅' }),
+    handler: async (args, env) => {
+        const lease = await verifyLease(args, BORROW_CAR_APPLY, env);
+        const workflowId = String(lease.workflowId ?? '');
+        const arcIds = Array.isArray(lease.arcIds) ? lease.arcIds.map(String) : [];
+        const carIds = Array.isArray(lease.carIds) ? lease.carIds.map(String) : [];
+        if (!workflowId || arcIds.length === 0 || arcIds.length !== carIds.length) {
+            throw archiveValidationError('continuation_payload_invalid', '确认票据缺少 workflowId / arcIds / carIds');
+        }
+        const arcIndex = await addCache(env.host, arcIds.join(','), 'borrowCart');
+        const carIndex = await addCache(env.host, carIds.join(','), 'borrowCart');
+        const session = await env.host.getSession();
+        return flowResult(BORROW_CAR_APPLY, session.baseUrl, workflowId, {
+            workflowId,
+            isCreate: '1',
+            isAddIdentify: '1',
+            isBorrow: '1',
+            arcDataId: `arcCache_${arcIndex}`,
+            arcBorrowCarIds: `arcCache_${carIndex}`,
+        }, { mode: 'borrowCar', count: arcIds.length, caches: { arcDataId: arcIndex, arcBorrowCarIds: carIndex } });
+    },
+};
+const flowSearchPrepare = {
+    name: 'archive.flow.search.prepare',
+    resource: 'flow',
+    method: 'search',
+    action: 'archive.flow.search.prepare',
+    summary: '从全文检索结果直接发起借阅：检查流程绑定并生成确认票据（不写数据）',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({ arcIds: { type: 'array', items: { type: 'string' }, description: '档案标识数组，元素为 {档案ID}_{表单ID}' } }, { required: ['arcIds'], description: '从检索结果发起借阅' }),
+    handler: async (args, env) => {
+        const arcIds = requireArcIds(args.arcIds, 'arcIds');
+        const workflowId = await fetchWorkflowId(env.host);
+        const { continuation, expiresInMs } = await issueLease(env, SEARCH_APPLY, { workflowId, arcIds });
+        return archiveSuccess('archive.flow.search.prepare', {
+            preview: { workflowId, count: arcIds.length, arcIds },
+            hint: '确认后调用 archive.flow.search.apply（CLI：archive flow search-apply --continuation <token> --yes）',
+            continuation,
+        }, { requiresConfirmation: true, expiresInMs });
+    },
+};
+const flowSearchApply = {
+    name: SEARCH_APPLY,
+    resource: 'flow',
+    method: 'search',
+    action: SEARCH_APPLY,
+    summary: '从全文检索结果直接发起借阅（写操作）：只缓存档案参数，返回借阅流程创建页 URL',
+    capability: 'archive',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: schemaOf({
+        continuation: { type: 'string', description: 'prepare 返回的确认票据' },
+        confirm: { type: 'boolean', description: '必须为 true（CLI --yes）' },
+    }, { required: ['continuation', 'confirm'], description: '从检索结果发起借阅' }),
+    handler: async (args, env) => {
+        const lease = await verifyLease(args, SEARCH_APPLY, env);
+        const workflowId = String(lease.workflowId ?? '');
+        const arcIds = Array.isArray(lease.arcIds) ? lease.arcIds.map(String) : [];
+        if (!workflowId || arcIds.length === 0) {
+            throw archiveValidationError('continuation_payload_invalid', '确认票据缺少 workflowId / arcIds');
+        }
+        const arcIndex = await addCache(env.host, arcIds.join(','));
+        const session = await env.host.getSession();
+        return flowResult(SEARCH_APPLY, session.baseUrl, workflowId, {
+            workflowId,
+            isCreate: '1',
+            isAddIdentify: '1',
+            isBorrow: '1',
+            arcDataId: `arcCache_${arcIndex}`,
+        }, { mode: 'search', count: arcIds.length, caches: { arcDataId: arcIndex } });
+    },
+};
+const flowRenewPrepare = {
+    name: 'archive.flow.renew.prepare',
+    resource: 'flow',
+    method: 'renew',
+    action: 'archive.flow.renew.prepare',
+    summary: '借阅单续借：检查流程绑定并生成确认票据（不写数据）',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({ dataId: { type: 'string', pattern: '^\\d+$', description: '借阅单主表数据 ID' } }, { required: ['dataId'], description: '借阅单续借' }),
+    handler: async (args, env) => {
+        const dataId = String(args.dataId ?? '').trim();
+        if (!NUMERIC_PATTERN.test(dataId)) {
+            throw archiveValidationError('data_id_invalid', 'dataId 必填且为数字 ID');
+        }
+        const workflowId = await fetchWorkflowId(env.host);
+        const { continuation, expiresInMs } = await issueLease(env, RENEW_APPLY, { workflowId, dataId });
+        return archiveSuccess('archive.flow.renew.prepare', {
+            preview: { workflowId, dataId },
+            hint: '确认后调用 archive.flow.renew.apply（CLI：archive flow renew-apply --continuation <token> --yes）',
+            continuation,
+        }, { requiresConfirmation: true, expiresInMs });
+    },
+};
+const flowRenewApply = {
+    name: RENEW_APPLY,
+    resource: 'flow',
+    method: 'renew',
+    action: RENEW_APPLY,
+    summary: '借阅单续借（写操作）：返回续借流程创建页 URL（不调用 addCache）',
+    capability: 'archive',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: schemaOf({
+        continuation: { type: 'string', description: 'prepare 返回的确认票据' },
+        confirm: { type: 'boolean', description: '必须为 true（CLI --yes）' },
+    }, { required: ['continuation', 'confirm'], description: '借阅单续借' }),
+    handler: async (args, env) => {
+        const lease = await verifyLease(args, RENEW_APPLY, env);
+        const workflowId = String(lease.workflowId ?? '');
+        const dataId = String(lease.dataId ?? '').trim();
+        if (!workflowId || !NUMERIC_PATTERN.test(dataId)) {
+            throw archiveValidationError('continuation_payload_invalid', '确认票据缺少 workflowId / dataId');
+        }
+        assertLeaseTarget(lease, args, ['dataId'], RENEW_APPLY);
+        const session = await env.host.getSession();
+        return flowResult(RENEW_APPLY, session.baseUrl, workflowId, { workflowId, isCreate: '1', arcDataId: dataId, isReNew: '1' }, { mode: 'renew', dataId });
+    },
+};
+export const flowUrlOperations = [
+    flowBorrowCarPrepare,
+    flowBorrowCarApply,
+    flowSearchPrepare,
+    flowSearchApply,
+    flowRenewPrepare,
+    flowRenewApply,
+];

package/dist/shortcuts/archive/operations/fonds.js

@@ -0,0 +1,95 @@
+import { archiveValidationError } from '../errors.js';
+import { READ, archiveSuccess, schemaOf, } from './types.js';
+import { assertEnum, compact, unwrapData } from './shared.js';
+/**
+ * 档案库（收集库/管理库）全宗列表。getFonds 返回的全宗 id 同时是
+ * getTree(fondsId)、上传 saveFile(fonds_code) 等后续链路的前置输入，
+ * 因此必须暴露出来供 Agent 复用。
+ */
+const fondsList = {
+    name: 'archive.fonds.list',
+    resource: 'fonds',
+    method: 'list',
+    action: 'archive.fonds.list',
+    summary: '获取当前账号有权限的全宗列表（收集库/管理库）；全宗 ID 供 getTree、预归档上传等后续链路复用',
+    capability: 'fonds',
+    risk: READ,
+    inputSchema: schemaOf({
+        menuSign: { type: 'string', enum: ['collectLib', 'manageLib'], description: '收集库/管理库，默认 collectLib' },
+        needControl: { type: 'boolean', description: '是否按当前用户权限过滤全宗，默认 true' },
+    }, { description: '查询档案全宗列表' }),
+    handler: async (args, { host }) => {
+        const menuSign = assertEnum(args.menuSign ?? 'collectLib', ['collectLib', 'manageLib'], 'menuSign');
+        const needControl = args.needControl === undefined ? true : Boolean(args.needControl);
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/archive/core/archivetree/getFonds',
+            body: compact({
+                treeType: '1',
+                menuSign,
+                needControl,
+                extraData: false,
+                extraSign: '0',
+                logFlag: menuSign,
+            }),
+        });
+        const data = unwrapData(response);
+        const rows = Array.isArray(data) ? data : [];
+        return archiveSuccess('archive.fonds.list', rows.map((item) => ({
+            id: item.id,
+            fonds_name: item.fonds_name,
+            fonds_code: item.fonds_code,
+            easy_name: item.easy_name ?? '',
+            classification: item.classification,
+            is_use: item.is_use,
+            fonds_parent: item.fonds_parent,
+            own_company: item.own_company,
+        })), { count: rows.length, menuSign });
+    },
+};
+/** 预归档电子文件库节点筛选：id 下划线前后一致（appId_metaId 或 appId_appId）。 */
+function isEfileLibNode(item) {
+    const id = typeof item?.id === 'string' ? item.id : '';
+    if (!id || !id.includes('_'))
+        return false;
+    const [left, right] = id.split('_');
+    return Boolean(left && left === right);
+}
+/**
+ * 预归档树（getTree treeType=4）。主要目的是从返回节点中筛选出电子文件库节点
+ * （id 格式 {appId}_{metaId}/{appId}_{appId}），其 id 即 saveFile 的 treeId。
+ */
+const prelibTree = {
+    name: 'archive.prelib.tree',
+    resource: 'prelib',
+    method: 'tree',
+    action: 'archive.prelib.tree',
+    summary: '获取当前账号的预归档树节点，并识别电子文件库节点（id 形如 {appId}_{appId}）；电子文件库节点 id 即预归档上传 saveFile 的 treeId',
+    capability: 'fonds',
+    risk: READ,
+    inputSchema: schemaOf({}, { description: '查询预归档树（默认按当前用户权限）' }),
+    handler: async (_args, { host }) => {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/archive/core/archivetree/getTree',
+            body: {
+                treeType: '4',
+                menuSign: 'preLib',
+                logFlag: 'preLib',
+                needControl: true,
+                needSysn: true,
+            },
+        });
+        const data = unwrapData(response);
+        if (!Array.isArray(data)) {
+            throw archiveValidationError('tree_invalid', 'getTree 返回异常：data 不是数组');
+        }
+        const nodes = data;
+        const efileLibraries = nodes.filter(isEfileLibNode).map((item) => ({ id: item.id, content: item.content }));
+        return archiveSuccess('archive.prelib.tree', efileLibraries, {
+            count: efileLibraries.length,
+            hint: '节点 id 下划线前后一致即为电子文件库 treeId，用于预归档上传',
+        });
+    },
+};
+export const fondsOperations = [fondsList, prelibTree];

package/dist/shortcuts/archive/operations/getPageUrl.js

@@ -0,0 +1,137 @@
+import { randomBytes } from 'node:crypto';
+import { archiveValidationError } from '../errors.js';
+import { unwrapData } from './shared.js';
+/**
+ * 借阅车 / 借阅单列表的 ebuilder 回退链路。
+ *
+ * 优先链路是自定义接口（getFormDataList/myBorrowCar、getFormDataList/myBorrowList），
+ * 自定义接口不可用时才走这里：
+ *   1. getPageUrl（一条请求拿到 appId + 默认视图 ID）
+ *   2. getPageUrl 不可用才回退 getAppIds → getObjsByTag → getViewlist
+ *   3. getListDatas（passid/cid = 表单对象 ID，listId = 视图 ID）
+ */
+export const ARCHIVE_APP_TAG = 'archive_wsd';
+export const BORROW_CAR_TAG = 'uf_arc_borrow_car';
+export const BORROWING_TAG = 'uf_arc_borrowing';
+function asRecordArray(value) {
+    return Array.isArray(value) ? value.filter((item) => item && typeof item === 'object') : [];
+}
+function firstText(value) {
+    if (typeof value === 'string')
+        return value.trim();
+    if (typeof value === 'number')
+        return String(value);
+    return '';
+}
+async function fetchAppId(host) {
+    const response = await host.request({
+        method: 'GET',
+        path: '/api/bs/ebuilder/app/tags/getAppIds',
+        query: { tag: ARCHIVE_APP_TAG },
+    });
+    const data = unwrapData(response);
+    const first = Array.isArray(data) ? data[0] : undefined;
+    const appId = firstText(first && typeof first === 'object' ? first.id : first);
+    if (!appId)
+        throw archiveValidationError('app_id_missing', `未取到档案应用 ID（tag=${ARCHIVE_APP_TAG}）`);
+    return appId;
+}
+async function fetchObjId(host, tag, appId) {
+    const response = await host.request({
+        method: 'GET',
+        path: '/api/ebuilder/form/obj/getObjsByTag',
+        query: { tag, appId },
+    });
+    const data = unwrapData(response);
+    const first = Array.isArray(data) ? data[0] : undefined;
+    const objId = firstText(first && typeof first === 'object' ? first.id : undefined);
+    if (!objId)
+        throw archiveValidationError('form_obj_missing', `未取到表单对象 ID（tag=${tag}）`);
+    return objId;
+}
+function viewIdFromUrl(url) {
+    if (typeof url !== 'string')
+        return undefined;
+    const matched = url.match(/\/(\d+)\s*$/u);
+    return matched?.[1];
+}
+async function fetchViewId(host, objId, appId, viewMode) {
+    const response = await host.request({
+        method: 'GET',
+        path: `/api/ebuilder/form/fs/viewlist/getViewlist/${objId}`,
+        query: { apid: appId, tpaid: objId },
+    });
+    const data = unwrapData(response);
+    const views = asRecordArray(data?.tableView?.detail);
+    if (views.length === 0)
+        throw archiveValidationError('view_missing', '未取到列表视图配置');
+    if (viewMode === 'myBorrow') {
+        const matched = views.find((view) => String(view.name ?? '') === '我的借阅');
+        if (!matched)
+            throw archiveValidationError('view_missing', '未找到「我的借阅」视图，无法回退查询借阅单列表');
+        return firstText(matched.id);
+    }
+    const defaultView = views.find((view) => String(view.isDefault ?? '') === '1') ?? views[0];
+    return firstText(defaultView.id);
+}
+export async function resolveArchiveListTarget(host, options) {
+    const viewMode = options.viewMode ?? 'default';
+    let appId = '';
+    let viewId;
+    try {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/archive/core/form/getPageUrl',
+            query: { terminalType: 'pc', type: '1', sign: options.sign },
+        });
+        const data = unwrapData(response);
+        appId = firstText(data?.appId);
+        viewId = viewIdFromUrl(data?.url);
+    }
+    catch {
+        // getPageUrl 不可用时回退三步链路
+    }
+    if (!appId)
+        appId = await fetchAppId(host);
+    const objId = await fetchObjId(host, options.sign, appId);
+    if (!viewId) {
+        return { appId, objId, viewId: await fetchViewId(host, objId, appId, viewMode), viewSource: 'getViewlist' };
+    }
+    return { appId, objId, viewId, viewSource: 'getPageUrl' };
+}
+export async function fetchArchiveListDatas(host, target, pageNo, logFlag) {
+    const current = Number.isInteger(pageNo) && pageNo > 0 ? pageNo : 1;
+    const body = {
+        current,
+        listId: target.viewId,
+        searchParamData: { searchType: '2', type: 'and', commonSearchFields: {}, groupFields: {} },
+        requiredMatch: 1,
+        tableuid: randomBytes(16).toString('hex'),
+        mapResult: '1',
+        recheckQuery: '1',
+        isFollow: 0,
+        isShareToMe: 0,
+        filterCondition: {},
+        browser: 'Chrome',
+    };
+    if (logFlag)
+        body.logFlag = logFlag;
+    const response = await host.request({
+        method: 'POST',
+        path: '/api/ebuilder/form/list/getListDatas',
+        query: { passid: target.objId, cid: target.objId },
+        body,
+    });
+    const data = unwrapData(response);
+    const pageSize = data?.pageSize === undefined ? undefined : Number(data.pageSize);
+    const total = data?.total === undefined ? undefined : Number(data.total);
+    return {
+        columns: asRecordArray(data?.columns),
+        rows: asRecordArray(data?.data),
+        displayRows: asRecordArray(data?.displayData),
+        pageNo: Number(data?.current ?? current),
+        ...(pageSize === undefined ? {} : { pageSize }),
+        // getPageUrl 视图下 total 可能为 0，但 data 数组仍有完整数据，因此只作参考
+        ...(total === undefined ? {} : { total }),
+    };
+}

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

@@ -0,0 +1,43 @@
+import { archiveValidationError } from '../errors.js';
+import { fondsOperations } from './fonds.js';
+import { archiveInfoOperations } from './archive-info.js';
+import { searchOperations } from './search.js';
+import { borrowCarOperations } from './borrow-car.js';
+import { borrowListOperations } from './borrow-list.js';
+import { downloadOperations } from './download.js';
+import { flowUrlOperations } from './flow-url.js';
+import { uploadOperations } from './upload.js';
+function buildRegistry() {
+    const registry = new Map();
+    const definitions = [
+        ...fondsOperations,
+        ...archiveInfoOperations,
+        ...searchOperations,
+        ...borrowCarOperations,
+        ...borrowListOperations,
+        ...downloadOperations,
+        ...flowUrlOperations,
+        ...uploadOperations,
+    ];
+    for (const definition of definitions) {
+        if (registry.has(definition.name)) {
+            throw new Error(`duplicate archive operation: ${definition.name}`);
+        }
+        registry.set(definition.name, definition);
+    }
+    return registry;
+}
+const archiveOperationRegistry = buildRegistry();
+export function archiveOperationDefinitions() {
+    return [...archiveOperationRegistry.values()];
+}
+export function getArchiveOperation(operation) {
+    const definition = archiveOperationRegistry.get(operation);
+    if (!definition) {
+        throw archiveValidationError('operation_unknown', `文书定档案不支持操作：${operation}`);
+    }
+    return definition;
+}
+export function hasArchiveOperation(operation) {
+    return archiveOperationRegistry.has(operation);
+}

package/dist/shortcuts/archive/operations/search.js

@@ -0,0 +1,88 @@
+import { archiveValidationError } from '../errors.js';
+import { toSearchRowView } from '../render/search-view.js';
+import { READ, archiveSuccess, schemaOf, } from './types.js';
+import { requireText, unwrapData } from './shared.js';
+const EBDATA_PREFIX = 'EBDATA_OBJID';
+function parseFormId(module) {
+    const text = typeof module === 'string' ? module : '';
+    if (!text.startsWith(EBDATA_PREFIX))
+        return undefined;
+    const id = text.slice(EBDATA_PREFIX.length);
+    return /^\d+$/.test(id) ? id : undefined;
+}
+/**
+ * 档案全文检索（可借档案）。搜索结果行中的 dataId（id）与 formId（module 去前缀）
+ * 是「加入借阅车/发起借阅」的输入，Agent 应按行复用，不要要求用户背诵内部 ID。
+ */
+const searchRun = {
+    name: 'archive.search.run',
+    resource: 'search',
+    method: 'run',
+    action: 'archive.search.run',
+    summary: '按关键词全文检索档案（可借档案列表），支持分页；每行除原始字段外会附带 level/fonds/category/dateLabel/dateValue/viewPath 展示字段，结果行的 id 与 formId 用于加入借阅车、发起借阅或拼接 archiveView 链接',
+    capability: 'search',
+    risk: READ,
+    inputSchema: schemaOf({
+        key: { type: 'string', minLength: 1, description: '搜索关键词（必填）' },
+        pageNo: { type: 'integer', minimum: 0, description: '页码，从 0 开始，默认 0' },
+        pageSize: { type: 'integer', minimum: 1, maximum: 100, description: '每页条数，默认 10' },
+        type1: { type: 'string', description: '检索范围一级分类，缺省 0=全部范围' },
+        type2: { type: 'string', description: '检索范围二级分类，缺省 0=全部范围' },
+    }, { required: ['key'], description: '全文检索档案（缺省在全部范围内检索）' }),
+    handler: async (args, { host }) => {
+        const key = requireText(args.key, 'key');
+        const pageNo = args.pageNo === undefined ? 0 : Number(args.pageNo);
+        const pageSize = args.pageSize === undefined ? 10 : Number(args.pageSize);
+        // 检索范围不传时按「全部」处理（type1/type2=0），否则全文检索会 0 命中。
+        const body = { key, pageNo, pageSize, type1: '0', type2: '0' };
+        if (args.type1 !== undefined)
+            body.type1 = String(args.type1);
+        if (args.type2 !== undefined)
+            body.type2 = String(args.type2);
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/archive/core/fullSearch/searchByModule',
+            body,
+        });
+        const data = unwrapData(response);
+        if (!data || typeof data !== 'object') {
+            throw archiveValidationError('search_invalid', '全文检索返回异常：data 缺失');
+        }
+        const result = data;
+        const rows = Array.isArray(result.archiveResult) ? result.archiveResult : [];
+        return archiveSuccess('archive.search.run', rows.map((item) => {
+            const row = {
+                id: item.id,
+                formId: parseFormId(item.module) ?? parseFormId(item.showModule) ?? undefined,
+                title: String(item.title ?? ''),
+                content: item.content ?? '',
+                highLightContent: item.highLightContent ?? '',
+                module: item.module,
+                footInfo: item.footInfo,
+                headList: item.archiveMess?.headList ?? [],
+                footList: item.archiveMess?.footList ?? [],
+                createTime: item.createTime ?? '',
+            };
+            // 派生标准展示字段：层级/全宗/分类/日期/可打开链接（原字段保留不动）。
+            const view = toSearchRowView(row);
+            return {
+                ...row,
+                ...(row.title ? {} : view.title ? { title: view.title } : {}),
+                level: view.level,
+                fonds: view.fonds,
+                category: view.category,
+                dateLabel: view.dateLabel,
+                dateValue: view.dateValue,
+                viewPath: view.viewPath,
+            };
+        }), {
+            pageNo: result.pageNo ?? pageNo,
+            pageSize: result.pageSize ?? pageSize,
+            total: result.total ?? 0,
+            totalPage: result.totalPage ?? 0,
+            hasNext: Boolean(result.hasNext),
+            keyword: result.keyword ?? key,
+        });
+    },
+};
+export const searchOperations = [searchRun];