weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/archive/operations/borrow-car.js

@@ -0,0 +1,146 @@
+import { ArchiveCliError } from '../errors.js';
+import { archiveValidationError } from '../errors.js';
+import { READ, WRITE, archiveSuccess, schemaOf, } from './types.js';
+import { positiveInt, toStringId, toStringIdList, unwrapDatajson } from './shared.js';
+import { BORROW_CAR_TAG, fetchArchiveListDatas, resolveArchiveListTarget } from './getPageUrl.js';
+const CAR_ADD = 'archive.borrow-car.add';
+function namesOf(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map((item) => (item && typeof item === 'object' ? String(item.name ?? '') : ''))
+        .filter((name) => name !== '');
+}
+function normalizeBorrowCarRow(mainTable, index) {
+    const row = (mainTable && typeof mainTable === 'object' ? mainTable : {});
+    const arcDangan = Array.isArray(row.arc_dangan)
+        ? row.arc_dangan
+            .filter((item) => item && typeof item === 'object')
+            .map((item) => ({ name: String(item.name ?? ''), id: String(item.id ?? '') }))
+        : [];
+    return {
+        index: index + 1,
+        dataId: String(row.id ?? ''),
+        title: String(row.folder_title ?? ''),
+        className: String(row.class_name ?? ''),
+        archivalCode: String(row.archival_code ?? ''),
+        fondsCode: String(row.fonds_code ?? ''),
+        categoryNames: namesOf(row.category_code),
+        fileDate: String(row.file_date ?? ''),
+        retentionPeriod: String(row.retention_period ?? ''),
+        state: String(row.state ?? ''),
+        arcDangan,
+    };
+}
+/** 首选自定义接口 myBorrowCar；接口未发布/报错时返回 null，由调用方回退。 */
+async function listByCustomApi(host, operator, pageNo, pageSize) {
+    try {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/ebuilder/form/formdata/v2/getFormDataList/myBorrowCar',
+            body: {
+                datajson: {
+                    mainTable: {},
+                    pageInfo: { pageNo: String(pageNo), pageSize: String(pageSize) },
+                    header: { operator },
+                },
+            },
+        });
+        const box = unwrapDatajson(response);
+        const datas = Array.isArray(box?.datas) ? box.datas : [];
+        const rows = datas.map((item, index) => normalizeBorrowCarRow(item && typeof item === 'object' ? item.mainTable : undefined, index));
+        return { count: rows.length, rows };
+    }
+    catch (error) {
+        // 接口未发布 / 报错 / 返回业务失败：交给回退链路
+        if (error instanceof ArchiveCliError && error.type === 'api')
+            return null;
+        throw error;
+    }
+}
+const borrowCarList = {
+    name: 'archive.borrow-car.list',
+    resource: 'borrow-car',
+    method: 'list',
+    action: 'archive.borrow-car.list',
+    summary: '查询当前用户的借阅车列表；优先自定义接口 myBorrowCar，不可用时回退 ebuilder 列表链路（getPageUrl → getListDatas）',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({
+        pageNo: { type: 'integer', minimum: 1, description: '页码，默认 1' },
+        pageSize: { type: 'integer', minimum: 1, description: '每页条数，默认 10' },
+    }),
+    handler: async (args, { host }) => {
+        const pageNo = positiveInt(args.pageNo, 'pageNo', 1);
+        const pageSize = positiveInt(args.pageSize, 'pageSize', 10);
+        const session = await host.getSession();
+        const custom = await listByCustomApi(host, session.userId, pageNo, pageSize);
+        if (custom) {
+            return archiveSuccess('archive.borrow-car.list', { source: 'myBorrowCar', pageNo, pageSize, count: custom.count, rows: custom.rows }, { source: 'myBorrowCar' });
+        }
+        const target = await resolveArchiveListTarget(host, { sign: BORROW_CAR_TAG, viewMode: 'default' });
+        const page = await fetchArchiveListDatas(host, target, pageNo, 'borrowCart');
+        const rows = page.rows.map((row, index) => ({
+            index: index + 1,
+            dataId: String(row.id ?? ''),
+            fields: row,
+            ...(page.displayRows[index] ? { display: page.displayRows[index] } : {}),
+        }));
+        return archiveSuccess('archive.borrow-car.list', { source: 'ebuilder', pageNo: page.pageNo, count: rows.length, rows }, { source: 'ebuilder', viewSource: target.viewSource });
+    },
+};
+/** 加入借阅车入参：按表单分组的档案 ID。 */
+function parseFormAndIds(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw archiveValidationError('form_and_ids_required', 'formAndIds 必填且至少一组');
+    }
+    return value.map((item, index) => {
+        if (!item || typeof item !== 'object') {
+            throw archiveValidationError('form_and_ids_invalid', `formAndIds[${index}] 必须是对象`);
+        }
+        const group = item;
+        const formId = toStringId(group.formId, `formAndIds[${index}].formId`);
+        const ids = toStringIdList(group.ids, `formAndIds[${index}].ids`);
+        if (!formId)
+            throw archiveValidationError('form_id_required', `formAndIds[${index}].formId 必填`);
+        if (!ids || ids.length === 0)
+            throw archiveValidationError('ids_required', `formAndIds[${index}].ids 至少一项`);
+        return { formId, ids };
+    });
+}
+/**
+ * 加入借阅车：低风险写操作，直接执行，不需要 prepare / apply 确认链。
+ * 全宗等字段仅预归档上传需要，加入借阅车只依赖档案 ID（{档案ID}_{表单ID}）与所属表单。
+ */
+const borrowCarAdd = {
+    name: CAR_ADD,
+    resource: 'borrow-car',
+    method: 'add',
+    action: CAR_ADD,
+    summary: '加入借阅车（写操作，无需确认）：把档案直接加入当前用户借阅车',
+    capability: 'archive',
+    risk: WRITE,
+    inputSchema: schemaOf({
+        formAndIds: {
+            type: 'array',
+            minItems: 1,
+            description: '按表单分组：[{ formId, ids: [档案ID...] }]',
+            items: {
+                type: 'object',
+                properties: { formId: { type: 'string' }, ids: { type: 'array', items: { type: 'string' } } },
+                required: ['formId', 'ids'],
+            },
+        },
+    }, { required: ['formAndIds'], description: '加入借阅车' }),
+    handler: async (args, env) => {
+        const formAndIds = parseFormAndIds(args.formAndIds);
+        const response = await env.host.request({
+            method: 'POST',
+            path: '/api/archive/core/borrow/addBorrowCar',
+            body: { formAndIds, logFlag: 'archiveSet' },
+        });
+        const total = formAndIds.reduce((sum, group) => sum + group.ids.length, 0);
+        return archiveSuccess(CAR_ADD, { accepted: true, groups: formAndIds.length, total, message: response ?? '已加入借阅车' }, { wrote: true });
+    },
+};
+export const borrowCarOperations = [borrowCarList, borrowCarAdd];

package/dist/shortcuts/archive/operations/borrow-list.js

@@ -0,0 +1,200 @@
+import { ArchiveCliError, archiveValidationError } from '../errors.js';
+import { READ, archiveSuccess, schemaOf, } from './types.js';
+import { positiveInt, unwrapDatajson } from './shared.js';
+import { BORROWING_TAG, fetchArchiveListDatas, resolveArchiveListTarget } from './getPageUrl.js';
+/** 兼容「纯 ID 字符串」与「对象数组」两种字段形态（列表接口两者都会出现）。 */
+function textOrName(value) {
+    if (Array.isArray(value)) {
+        const first = value.find((item) => item !== undefined && item !== null);
+        if (first === undefined)
+            return '';
+        if (first && typeof first === 'object') {
+            const record = first;
+            return String(record.name ?? record.id ?? '');
+        }
+        return String(first);
+    }
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'object') {
+        const record = value;
+        return String(record.name ?? record.id ?? '');
+    }
+    return String(value);
+}
+/** 取 ID：对象数组取首元素 id，字符串形态直接返回（借阅单详情的 workflow_id 是纯字符串）。 */
+function idOf(value) {
+    if (Array.isArray(value)) {
+        const first = value.find((item) => item !== undefined && item !== null);
+        if (first === undefined)
+            return '';
+        if (first && typeof first === 'object')
+            return String(first.id ?? '');
+        return String(first);
+    }
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'object')
+        return String(value.id ?? '');
+    return String(value);
+}
+/** 对象数组统一转成 { name, id }，字符串形态返回空数组。 */
+function entriesOf(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((item) => item && typeof item === 'object')
+        .map((item) => {
+        const record = item;
+        return { name: String(record.name ?? ''), id: String(record.id ?? '') };
+    });
+}
+function parseDateTime(value) {
+    const text = typeof value === 'string' ? value.trim() : '';
+    if (!text)
+        return undefined;
+    const normalized = text.includes('T') ? text : text.replace(' ', 'T');
+    const parsed = Date.parse(normalized);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+/** 借阅单是否已超期（无归还时间时不判定）。 */
+function isExpired(returnDateTime, now = Date.now()) {
+    const due = parseDateTime(returnDateTime);
+    return due === undefined ? false : now > due;
+}
+function normalizeBorrowListRow(mainTable, index) {
+    const row = (mainTable && typeof mainTable === 'object' ? mainTable : {});
+    return {
+        index: index + 1,
+        dataId: String(row.id ?? ''),
+        name: String(row.name ?? ''),
+        borrowDateTime: String(row.borrow_date_time ?? ''),
+        returnDateTime: String(row.return_date_time ?? ''),
+        reason: String(row.reason ?? ''),
+        backStatus: String(row.back_status ?? ''),
+        returnStatus: String(row.return_status ?? ''),
+        waterMark: String(row.water_mark ?? ''),
+        workflowId: idOf(row.workflow_id),
+        workflowName: Array.isArray(row.workflow_id) ? textOrName(row.workflow_id) : '',
+        borrowPerson: textOrName(row.borrow_person),
+        state: String(row.data_status ?? ''),
+        createTime: String(row.create_time ?? ''),
+        updateTime: String(row.update_time ?? ''),
+        expired: isExpired(row.return_date_time),
+    };
+}
+async function listByCustomApi(host, operator, pageNo, pageSize) {
+    try {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/ebuilder/form/formdata/v2/getFormDataList/myBorrowList',
+            body: {
+                datajson: {
+                    mainTable: {},
+                    pageInfo: { pageNo: String(pageNo), pageSize: String(pageSize) },
+                    header: { operator },
+                },
+            },
+        });
+        const box = unwrapDatajson(response);
+        const datas = Array.isArray(box?.datas) ? box.datas : [];
+        const rows = datas.map((item, index) => normalizeBorrowListRow(item && typeof item === 'object' ? item.mainTable : undefined, index));
+        return { count: rows.length, rows };
+    }
+    catch (error) {
+        if (error instanceof ArchiveCliError && error.type === 'api')
+            return null;
+        throw error;
+    }
+}
+const borrowListList = {
+    name: 'archive.borrow-list.list',
+    resource: 'borrow-list',
+    method: 'list',
+    action: 'archive.borrow-list.list',
+    summary: '查询当前用户的借阅单列表；优先自定义接口 myBorrowList，不可用时回退「我的借阅」视图链路',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({
+        pageNo: { type: 'integer', minimum: 1, description: '页码，默认 1' },
+        pageSize: { type: 'integer', minimum: 1, description: '每页条数，默认 10' },
+    }),
+    handler: async (args, { host }) => {
+        const pageNo = positiveInt(args.pageNo, 'pageNo', 1);
+        const pageSize = positiveInt(args.pageSize, 'pageSize', 10);
+        const session = await host.getSession();
+        const custom = await listByCustomApi(host, session.userId, pageNo, pageSize);
+        if (custom) {
+            return archiveSuccess('archive.borrow-list.list', { source: 'myBorrowList', pageNo, pageSize, count: custom.count, rows: custom.rows }, { source: 'myBorrowList' });
+        }
+        const target = await resolveArchiveListTarget(host, { sign: BORROWING_TAG, viewMode: 'myBorrow' });
+        const page = await fetchArchiveListDatas(host, target, pageNo);
+        const rows = page.rows.map((row, index) => ({
+            index: index + 1,
+            dataId: String(row.id ?? ''),
+            fields: row,
+            ...(page.displayRows[index] ? { display: page.displayRows[index] } : {}),
+        }));
+        return archiveSuccess('archive.borrow-list.list', { source: 'ebuilder', pageNo: page.pageNo, count: rows.length, rows }, { source: 'ebuilder', viewSource: target.viewSource });
+    },
+};
+/** 借阅单详情（myBorrowDetail），下载前的两项前置校验也基于本接口。 */
+export async function fetchBorrowDetail(host, operator, dataId) {
+    const response = await host.request({
+        method: 'POST',
+        path: '/api/ebuilder/form/formdata/v2/getFormDataByPk/myBorrowDetail',
+        body: { datajson: { mainTable: { id: dataId }, header: { operator } } },
+    });
+    const box = unwrapDatajson(response);
+    const datas = Array.isArray(box?.datas) ? box.datas : [];
+    if (datas.length === 0) {
+        throw archiveValidationError('borrow_not_found', `未找到借阅单（dataId=${dataId}）`);
+    }
+    const record = (datas[0] && typeof datas[0] === 'object' ? datas[0] : {});
+    const mainTable = (record.mainTable && typeof record.mainTable === 'object' ? record.mainTable : {});
+    const details = (Array.isArray(record.detail1) ? record.detail1 : []).map((item) => {
+        const detail = (item && typeof item === 'object' ? item : {});
+        return {
+            id: String(detail.id ?? ''),
+            arcDangan: entriesOf(detail.arc_dangan),
+            archivalCode: String(detail.archival_code ?? ''),
+            fondsCode: String(detail.fonds_code ?? ''),
+            fileDate: String(detail.file_date ?? ''),
+            borrowTypes: entriesOf(detail.borrow_type),
+        };
+    });
+    return {
+        dataId: String(mainTable.id ?? dataId),
+        name: String(mainTable.name ?? ''),
+        borrowDateTime: String(mainTable.borrow_date_time ?? ''),
+        returnDateTime: String(mainTable.return_date_time ?? ''),
+        reason: String(mainTable.reason ?? ''),
+        waterMark: String(mainTable.water_mark ?? ''),
+        workflowId: idOf(mainTable.workflow_id),
+        borrowPerson: textOrName(mainTable.borrow_person),
+        state: String(mainTable.data_status ?? ''),
+        expired: isExpired(mainTable.return_date_time),
+        downloadable: details.some((detail) => detail.borrowTypes.some((type) => type.id === '2')),
+        details,
+    };
+}
+const borrowListDetail = {
+    name: 'archive.borrow-list.detail',
+    resource: 'borrow-list',
+    method: 'detail',
+    action: 'archive.borrow-list.detail',
+    summary: '查看借阅单详情（含借阅明细与原文借阅方式），下载前的前置校验也依赖本接口',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({ dataId: { type: 'string', pattern: '^\\d+$', description: '借阅单主表数据 ID' } }, { required: ['dataId'], description: '借阅单详情' }),
+    handler: async (args, { host }) => {
+        const dataId = args.dataId;
+        if (dataId === undefined || dataId === null || !/^\d+$/.test(String(dataId))) {
+            throw archiveValidationError('data_id_invalid', 'dataId 必填且为数字 ID');
+        }
+        const session = await host.getSession();
+        const detail = await fetchBorrowDetail(host, session.userId, String(dataId));
+        return archiveSuccess('archive.borrow-list.detail', detail, { count: detail.details.length });
+    },
+};
+export const borrowListOperations = [borrowListList, borrowListDetail];

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

@@ -0,0 +1,46 @@
+import { archiveConfirmationError, archiveValidationError } from '../errors.js';
+/** apply 类写操作必须显式确认。 */
+export function requireConfirm(args, action) {
+    if (args.confirm !== true) {
+        throw archiveConfirmationError(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 archiveValidationError('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 archiveValidationError('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;
+        if (String(lease[key] ?? '') !== String(args[key])) {
+            throw archiveValidationError('continuation_target_changed', `${action} 的参数 ${key} 与 prepare 时不一致，请重新执行 prepare`);
+        }
+    }
+}

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

@@ -0,0 +1,238 @@
+import { existsSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, dirname, extname, resolve } from 'node:path';
+import { archiveValidationError, ArchiveCliError } from '../errors.js';
+import { READ, WRITE, archiveSuccess, schemaOf, } from './types.js';
+import { unwrapData } from './shared.js';
+import { assertLeaseTarget, issueLease, verifyLease } from './confirm.js';
+import { fetchBorrowDetail } from './borrow-list.js';
+const DOWNLOAD_APPLY = 'archive.borrow-list.download.apply';
+const EXPORT_TYPES = ['0', '1'];
+const EXPORT_STRUCTURES = ['', '0', '1', '2'];
+const GROUP_FIELDS = [
+    'archival_code',
+    'folder_title',
+    'fonds_code',
+    'arc_class_code',
+    'category_code',
+    'month',
+    'year',
+    'retention_period',
+    'security_classificat',
+    'owner_user',
+    'owner_dept',
+    'owner_company',
+];
+const POLL_INTERVAL_MS = 2_000;
+const POLL_MAX_ATTEMPTS = 150;
+function sleep(ms) {
+    return new Promise((done) => {
+        setTimeout(done, ms);
+    });
+}
+function optionalText(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    if (typeof value !== 'string') {
+        throw archiveValidationError('field_invalid', `${field} 必须是字符串`);
+    }
+    return value;
+}
+function parseExportParams(args) {
+    const exportType = args.exportType === undefined || args.exportType === null || args.exportType === ''
+        ? '0'
+        : String(args.exportType);
+    if (!EXPORT_TYPES.includes(exportType)) {
+        throw archiveValidationError('export_type_invalid', 'exportType 只能是 0（直接导出）或 1（分组导出）');
+    }
+    const exportStructure = optionalText(args.exportStructure, 'exportStructure') ?? '';
+    const groupField = optionalText(args.groupField, 'groupField') ?? '';
+    const documentField = optionalText(args.documentField, 'documentField') ?? '';
+    if (!EXPORT_STRUCTURES.includes(exportStructure)) {
+        throw archiveValidationError('export_structure_invalid', 'exportStructure 只能是空、0、1、2');
+    }
+    if (exportType === '0' && (exportStructure !== '' || groupField !== '' || documentField !== '')) {
+        throw archiveValidationError('export_params_conflict', '直接导出（exportType=0）时其余三个分组字段必须为空');
+    }
+    if (exportType === '1') {
+        if (exportStructure === '') {
+            throw archiveValidationError('export_structure_required', '分组导出（exportType=1）时 exportStructure 必填');
+        }
+        if (exportStructure === '0' && !groupField) {
+            throw archiveValidationError('group_field_required', '按条目导出时 groupField 必填');
+        }
+        if (exportStructure === '1' && !documentField) {
+            throw archiveValidationError('document_field_required', '按原文导出时 documentField 必填');
+        }
+        if (exportStructure === '2' && (!groupField || !documentField)) {
+            throw archiveValidationError('group_fields_required', '按条目+原文导出时 groupField 与 documentField 均必填');
+        }
+        for (const [field, value] of [['groupField', groupField], ['documentField', documentField]]) {
+            if (value && !GROUP_FIELDS.includes(value)) {
+                throw archiveValidationError('group_field_invalid', `${field} 取值不在档案基础字段候选内`);
+            }
+        }
+    }
+    return { exportType, exportStructure, groupField, documentField };
+}
+/** 下载前校验：未超期 + 有可下载原文。 */
+async function assertDownloadable(host, operator, dataId) {
+    const detail = await fetchBorrowDetail(host, operator, dataId);
+    if (detail.expired) {
+        throw archiveValidationError('borrow_expired', '借阅已过期，无权限下载！');
+    }
+    if (!detail.downloadable) {
+        throw archiveValidationError('borrow_no_downloadable', '该借阅单没有可下载的电子原文，无权限下载！');
+    }
+    if (!detail.workflowId) {
+        throw archiveValidationError('workflow_id_missing', '借阅单缺少流程 requestId（workflow_id），无法打包下载');
+    }
+    return { workflowId: detail.workflowId, returnDateTime: detail.returnDateTime };
+}
+function defaultDownloadDir() {
+    return resolve(homedir(), 'Downloads');
+}
+/** 目标路径：默认落到用户「下载」目录，已存在时自动加序号避免覆盖。 */
+function resolveOutputPath(fileName, output) {
+    const safeName = basename(String(fileName || '').replace(/[\\/]/g, '_')) || 'borrow.zip';
+    const target = output && String(output).trim() ? resolve(String(output)) : resolve(defaultDownloadDir(), safeName);
+    let candidate = target;
+    if (existsSync(candidate)) {
+        const ext = extname(safeName);
+        const stem = ext ? safeName.slice(0, -ext.length) : safeName;
+        for (let index = 1; index < 1000; index += 1) {
+            candidate = resolve(dirname(target), `${stem} (${index})${ext}`);
+            if (!existsSync(candidate))
+                break;
+        }
+    }
+    return candidate;
+}
+const downloadPrepare = {
+    name: 'archive.borrow-list.download.prepare',
+    resource: 'borrow-list',
+    method: 'download',
+    action: 'archive.borrow-list.download.prepare',
+    summary: '下载借阅单原文前的预检：校验未超期且存在可下载原文，并生成确认票据',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({
+        dataId: { type: 'string', pattern: '^\\d+$', description: '借阅单主表数据 ID' },
+        exportType: { type: 'string', description: '0=直接导出（默认），1=分组导出' },
+        exportStructure: { type: 'string', description: '分组导出结构：0 按条目 / 1 按原文 / 2 按条目+原文' },
+        groupField: { type: 'string', description: '条目分组字段 ID' },
+        documentField: { type: 'string', description: '原文分组字段 ID' },
+        output: { type: 'string', description: '可选，zip 落盘路径；默认保存到用户「下载」目录' },
+    }, { required: ['dataId'], description: '借阅单下载预检' }),
+    handler: async (args, env) => {
+        const dataId = args.dataId;
+        if (dataId === undefined || dataId === null || !/^\d+$/.test(String(dataId))) {
+            throw archiveValidationError('data_id_invalid', 'dataId 必填且为数字 ID');
+        }
+        const exportParams = parseExportParams(args);
+        const session = await env.host.getSession();
+        const { workflowId, returnDateTime } = await assertDownloadable(env.host, session.userId, String(dataId));
+        const output = optionalText(args.output, 'output');
+        const { continuation, expiresInMs } = await issueLease(env, DOWNLOAD_APPLY, {
+            dataId: String(dataId),
+            requestId: workflowId,
+            exportParams,
+            ...(output ? { output } : {}),
+        });
+        return archiveSuccess('archive.borrow-list.download.prepare', {
+            preview: {
+                dataId: String(dataId),
+                requestId: workflowId,
+                returnDateTime,
+                ...exportParams,
+                ...(output ? { output } : { outputDir: defaultDownloadDir() }),
+            },
+            hint: '确认后调用 archive.borrow-list.download.apply（CLI：archive borrow-list download-apply --continuation <token> --yes）',
+            continuation,
+        }, { requiresConfirmation: true, expiresInMs });
+    },
+};
+async function pollExport(host, bizId) {
+    const query = { moduleName: 'archive', functionName: 'downloadBorrowZip', bizId, flag: 'export' };
+    for (let attempt = 0; attempt < POLL_MAX_ATTEMPTS; attempt += 1) {
+        await sleep(POLL_INTERVAL_MS);
+        const response = await host.request({ method: 'GET', path: '/api/ebatch/getImportOrExportRate', query });
+        const percent = Number(unwrapData(response));
+        if (process.stderr.isTTY) {
+            const value = Number.isFinite(percent) ? Math.max(0, Math.min(100, Math.round(percent))) : 0;
+            process.stderr.write(`\r${'#'.repeat(Math.floor(value / 2))} ${value}%`);
+        }
+        if (Number.isFinite(percent) && percent >= 100)
+            break;
+    }
+    if (process.stderr.isTTY)
+        process.stderr.write('\n');
+    const response = await host.request({ method: 'GET', path: '/api/ebatch/getImportOrExportRateNum', query });
+    const data = (unwrapData(response) ?? {});
+    if (!data.fileId || data.status !== true) {
+        throw new ArchiveCliError('api', 'export_not_ready', '借阅单打包未完成，请稍后重试', {
+            details: { bizId, ...(data.fileName ? { fileName: data.fileName } : {}) },
+            exitCode: 1,
+        });
+    }
+    return data;
+}
+const downloadApply = {
+    name: DOWNLOAD_APPLY,
+    resource: 'borrow-list',
+    method: 'download',
+    action: DOWNLOAD_APPLY,
+    summary: '下载借阅单原文（写操作）：提交异步打包任务 → 轮询进度 → 下载 zip 并落盘',
+    capability: 'archive',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: schemaOf({
+        continuation: { type: 'string', description: 'prepare 返回的确认票据' },
+        confirm: { type: 'boolean', description: '必须为 true（CLI --yes）' },
+        dataId: { type: 'string', description: '可选回传，用于与 prepare 快照比对' },
+    }, { required: ['continuation', 'confirm'], description: '下载借阅单原文' }),
+    handler: async (args, env) => {
+        const lease = await verifyLease(args, DOWNLOAD_APPLY, env);
+        const dataId = String(lease.dataId ?? '');
+        const requestId = String(lease.requestId ?? '');
+        if (!dataId || !requestId) {
+            throw archiveValidationError('continuation_payload_invalid', '确认票据缺少 dataId / requestId');
+        }
+        assertLeaseTarget(lease, args, ['dataId'], DOWNLOAD_APPLY);
+        const exportParams = (lease.exportParams ?? {});
+        const session = await env.host.getSession();
+        await assertDownloadable(env.host, session.userId, dataId);
+        const submit = await env.host.request({
+            method: 'POST',
+            path: '/api/archive/core/borrow/batchDownloadBorrowZip',
+            body: {
+                dataId,
+                requestId,
+                exportType: String(exportParams.exportType ?? '0'),
+                exportStructure: String(exportParams.exportStructure ?? ''),
+                groupField: String(exportParams.groupField ?? ''),
+                documentField: String(exportParams.documentField ?? ''),
+            },
+        });
+        const submitData = (unwrapData(submit) ?? {});
+        const bizId = String(submitData.bizId ?? '');
+        if (!bizId) {
+            throw new ArchiveCliError('api', 'export_submit_failed', '提交借阅单打包任务失败', { exitCode: 1 });
+        }
+        const rate = await pollExport(env.host, bizId);
+        const fileId = String(rate.fileId ?? '');
+        const fileName = String(rate.fileName ?? submitData.fileName ?? `borrow-${dataId}.zip`);
+        const binary = await env.host.requestBinary({
+            method: 'GET',
+            path: `/api/file/remotedownload/${fileId}/token/true`,
+            query: { authModule: 'ebatch' },
+        });
+        const output = typeof lease.output === 'string' && lease.output ? lease.output : undefined;
+        const target = resolveOutputPath(fileName, output);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, binary.content, { flag: 'wx', mode: 0o600 });
+        return archiveSuccess(DOWNLOAD_APPLY, { savedPath: target, fileName: basename(target), fileId, bizId, size: binary.content.length }, { wrote: true, contentType: binary.contentType });
+    },
+};
+export const downloadOperations = [downloadPrepare, downloadApply];