weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/archive/host.js

@@ -0,0 +1,197 @@
+import { requireE10Session } from '../../internal/e10/context.js';
+import { getActiveProfile } from '../../internal/e10/auth/session.js';
+import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { ArchiveCliError, archiveAuthError, archiveNetworkError, archiveValidationError, } from './errors.js';
+function inferProfile(ctx) {
+    const options = ctx.getGlobalOptions();
+    return options.profile || getActiveProfile();
+}
+/**
+ * 判断响应是否业务成功。档案核心系统响应契约：
+ * - 大多返回 WeaResult 形态 { code, msg, status, data }
+ * - custom API（ebuilder）返回 { success, data, msg } 或 { code:200, data, msg }
+ * - fullSearch 返回 { status, message, data } / { code:200, data }
+ */
+export function isArchiveBusinessSuccess(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    if (typeof value.success === 'boolean')
+        return value.success;
+    if (typeof value.status === 'boolean')
+        return value.status;
+    // ebuilder 自定义接口（getFormDataList / getFormDataByPk）把业务状态放在 datajson.status
+    if (value.datajson && typeof value.datajson === 'object' && typeof value.datajson.status === 'boolean') {
+        return value.datajson.status;
+    }
+    if (value.code !== undefined && value.code !== null)
+        return Number(value.code) === 200;
+    return false;
+}
+export function archiveBusinessMessage(value) {
+    if (!value || typeof value !== 'object')
+        return '档案核心系统接口返回业务失败';
+    const candidates = [
+        value.msg,
+        value.message,
+        value.errMsg,
+        value.data?.message,
+        value.data?.msg,
+        value.datajson?.msg,
+        value.datajson?.message,
+    ];
+    for (const item of candidates) {
+        if (typeof item === 'string' && item.trim())
+            return item;
+    }
+    return '档案核心系统接口返回业务失败';
+}
+function archiveBusinessCode(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const code = value.code ?? value.status;
+    if (typeof code === 'string' || typeof code === 'number')
+        return code;
+    return undefined;
+}
+export function assertArchivePath(requestPath) {
+    if (typeof requestPath !== 'string' || !requestPath.startsWith('/') || requestPath.startsWith('//')) {
+        throw archiveValidationError('path_invalid', '请求路径必须是相对绝对路径');
+    }
+    if (/^https?:/i.test(requestPath) || /[\r\n]/.test(requestPath) || requestPath.includes('/../')) {
+        throw archiveValidationError('path_invalid', '请求路径不允许跨域或路径逃逸');
+    }
+    if (!requestPath.startsWith('/api/')) {
+        throw archiveValidationError('path_not_allowed', '档案模块只能调用 /api/ 路径');
+    }
+}
+function formBody(form) {
+    if (!form)
+        return undefined;
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(form)) {
+        if (value === undefined || value === null)
+            continue;
+        params.set(key, typeof value === 'string' ? value : JSON.stringify(value));
+    }
+    return params;
+}
+function omitEmptyQueryValues(query) {
+    if (!query)
+        return undefined;
+    return Object.fromEntries(Object.entries(query).filter(([, value]) => value !== ''));
+}
+function mapRuntimeNetworkError(error) {
+    if (error instanceof E10ApiError && error.type === 'network') {
+        throw archiveNetworkError(error.subtype, error.message, {
+            retryable: error.retryable,
+            details: error.details,
+        });
+    }
+    throw error;
+}
+export function createArchiveHost(ctx, dependencies = {}) {
+    let e10Session = null;
+    let sessionContext = null;
+    const requireSession = dependencies.requireSession || requireE10Session;
+    async function ensureSession() {
+        if (!e10Session) {
+            e10Session = await requireSession(ctx);
+            sessionContext = {
+                baseUrl: e10Session.getBaseUrl(),
+                profile: inferProfile(ctx),
+                userId: e10Session.userId,
+                tenantKey: e10Session.tenantKey,
+                eteamsId: e10Session.eteamsId,
+            };
+        }
+        return e10Session;
+    }
+    async function getSession() {
+        await ensureSession();
+        return sessionContext;
+    }
+    async function runtime() {
+        return createE10RequestRuntime(ctx, await ensureSession(), {
+            interceptors: dependencies.interceptors,
+            fetch: dependencies.fetch,
+        });
+    }
+    async function doRequest(request, binary) {
+        const { method, path, query, body, operation, form, multipart, headers: extraHeaders = {}, timeoutMs = 60_000, } = request;
+        assertArchivePath(path);
+        const resolvedMethod = method || (body === undefined && form === undefined && multipart === undefined ? 'GET' : 'POST');
+        const rt = await runtime();
+        const response = binary
+            ? await rt.requestBinary({
+                module: 'archive',
+                operation,
+                method: resolvedMethod,
+                path,
+                query: omitEmptyQueryValues(query),
+                body: multipart === undefined ? body : undefined,
+                form: multipart === undefined && form === undefined ? undefined : formBody(form ?? {}),
+                formData: multipart,
+                headers: { 'X-Requested-With': 'XMLHttpRequest', ...extraHeaders },
+                timeoutMs,
+            })
+            : await rt.requestJson({
+                module: 'archive',
+                operation,
+                method: resolvedMethod,
+                path,
+                query: omitEmptyQueryValues(query),
+                body: multipart === undefined ? body : undefined,
+                form: multipart === undefined && form === undefined ? undefined : formBody(form ?? {}),
+                formData: multipart,
+                headers: { 'X-Requested-With': 'XMLHttpRequest', ...extraHeaders },
+                timeoutMs,
+            });
+        return response;
+    }
+    async function request(request) {
+        const response = await doRequest(request, false).catch((error) => mapRuntimeNetworkError(error));
+        if (response.status === 401 || response.status === 302) {
+            throw archiveAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url <域名> 完成登录', { httpStatus: response.status });
+        }
+        if (response.parseError) {
+            if (response.status < 200 || response.status >= 300) {
+                throw new ArchiveCliError('api', 'http_error', `档案核心系统接口 HTTP ${response.status}`, {
+                    code: response.status,
+                    details: { status: response.status },
+                    exitCode: 1,
+                });
+            }
+            throw archiveNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, { retryable: false });
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new ArchiveCliError('api', 'http_error', `档案核心系统接口 HTTP ${response.status}`, {
+                code: response.status,
+                details: { status: response.status, message: archiveBusinessMessage(response.value) },
+                exitCode: 1,
+            });
+        }
+        if (!isArchiveBusinessSuccess(response.value)) {
+            throw new ArchiveCliError('api', 'business_error', archiveBusinessMessage(response.value), {
+                code: archiveBusinessCode(response.value),
+                details: { code: archiveBusinessCode(response.value), message: archiveBusinessMessage(response.value) },
+                exitCode: 1,
+            });
+        }
+        return response.value;
+    }
+    async function requestBinary(request) {
+        const response = await doRequest(request, true).catch((error) => mapRuntimeNetworkError(error));
+        if (response.status === 401 || response.status === 302) {
+            throw archiveAuthError('session_expired', 'E10 登录态已失效，请先登录', { httpStatus: response.status });
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new ArchiveCliError('api', 'http_error', `档案下载 HTTP ${response.status}`, {
+                code: response.status,
+                details: { status: response.status },
+                exitCode: 1,
+            });
+        }
+        return { status: response.status, contentType: response.contentType, content: response.content };
+    }
+    return { request, requestBinary, getSession };
+}

package/dist/shortcuts/archive/index.js

@@ -0,0 +1,363 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { formatSearchCard, formatSearchHtml, formatSearchText } from './render/search-format.js';
+import { createArchiveContinuationSigner } from './continuation.js';
+import { createArchiveHost } from './host.js';
+import { archiveManifest } from './manifest.js';
+import { executeArchiveOperation } from './operations.js';
+import { archiveValidationError } from './errors.js';
+function asOptions(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+export async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input && opts.inputJson) {
+        throw archiveValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    if (opts.inputJson) {
+        input = parseJsonInput(String(opts.inputJson), '--input-json');
+    }
+    if (opts.input) {
+        let raw;
+        try {
+            raw = opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8');
+        }
+        catch {
+            throw archiveValidationError('input_unreadable', `无法读取 --input：${String(opts.input)}`);
+        }
+        input = parseJsonInput(raw, '--input');
+    }
+    return {
+        ...input,
+        ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== undefined && value !== '')),
+    };
+}
+function parseJsonInput(raw, label) {
+    try {
+        const parsed = JSON.parse(raw.replace(/^\uFEFF/u, ''));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('input must be an object');
+        }
+        return parsed;
+    }
+    catch {
+        throw archiveValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
+    }
+}
+function withJsonInputOptions(command) {
+    command
+        .option('--input <path>', 'JSON input file, or - for stdin')
+        .option('--input-json <json>', 'inline JSON input object');
+    return command;
+}
+function intOption(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : undefined;
+}
+function stringOption(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    return String(value);
+}
+function successEnvelope(result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation: result.action,
+        data: result.data,
+        ...(result.meta ? { meta: result.meta } : {}),
+        warnings: [],
+    };
+}
+function failureEnvelope(error) {
+    const structured = error;
+    return {
+        schemaVersion: 1,
+        ok: false,
+        ...(structured?.partialData === undefined ? {} : { data: structured.partialData }),
+        error: toErrorEnvelope(error),
+    };
+}
+async function executeAndPrint(ctx, operation, input) {
+    try {
+        const result = await executeArchiveOperation(operation, input, {
+            ctx,
+            host: createArchiveHost(ctx),
+            continuation: createArchiveContinuationSigner(ctx),
+        });
+        ctx.output.write(successEnvelope(result), { json: true });
+    }
+    catch (error) {
+        console.error(JSON.stringify(failureEnvelope(error), null, 2));
+        process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+    }
+}
+/** archive search 的 text/html 展示：不再输出 JSON envelope，按展示契约直接打印。 */
+async function executeSearchPrint(ctx, input, format, outputPath) {
+    const env = {
+        ctx,
+        host: createArchiveHost(ctx),
+        continuation: createArchiveContinuationSigner(ctx),
+    };
+    try {
+        const result = await executeArchiveOperation('archive.search.run', input, env);
+        const rows = Array.isArray(result.data) ? result.data : [];
+        const meta = (result.meta ?? {});
+        const baseUrl = (await env.host.getSession()).baseUrl;
+        if (format === 'html') {
+            const html = formatSearchHtml(rows, {
+                baseUrl,
+                keyword: meta.keyword,
+                total: meta.total,
+                pageNo: meta.pageNo,
+                totalPage: meta.totalPage,
+                heading: `「${String(meta.keyword ?? '').trim() || '档案'}」检索结果`,
+            });
+            if (outputPath) {
+                const absolutePath = resolve(outputPath);
+                await writeFile(absolutePath, html, 'utf8');
+                ctx.output.raw(`HTML 已写入：${absolutePath}`);
+                return;
+            }
+            ctx.output.raw(html);
+            return;
+        }
+        if (format === 'card') {
+            ctx.output.raw(formatSearchCard(rows, { baseUrl, ...meta }));
+            return;
+        }
+        ctx.output.raw(formatSearchText(rows, meta));
+    }
+    catch (error) {
+        console.error(JSON.stringify(failureEnvelope(error), null, 2));
+        process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+    }
+}
+export const archiveShortcut = {
+    name: 'archive',
+    description: 'E10 文书定档案管理 CLI',
+    category: 'shortcut',
+    register({ program, action }) {
+        const archive = program.command('archive').description('E10 文书定档案管理');
+        archive.command('schema')
+            .description('Print archive operation manifest for agents')
+            .action(action((ctx) => {
+            ctx.output.write(archiveManifest, { json: true });
+        }));
+        withJsonInputOptions(archive.command('run')
+            .description('Run an archive operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. archive.borrow-car.list'))
+            .action(action(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+        withJsonInputOptions(archive.command('fonds')
+            .description('List fonds of collect/manage library')
+            .option('--menu-sign <sign>', 'collectLib or manageLib, default collectLib'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.fonds.list', await inputFrom(options, {
+                menuSign: stringOption(opts.menuSign),
+            }));
+        }));
+        archive.command('prelib')
+            .description('List pre-archive efile library nodes')
+            .action(action(async (ctx) => {
+            await executeAndPrint(ctx, 'archive.prelib.tree', {});
+        }));
+        withJsonInputOptions(archive.command('search')
+            .description('Full-text search borrowable archives')
+            .option('--key <keyword>', 'search keyword')
+            .option('--page-no <page>', 'page number, starts from 0')
+            .option('--page-size <size>', 'page size')
+            .option('--format <fmt>', 'output format: json (default), text, card (in-chat), html')
+            .option('--output <path>', 'save html output to file (html format only)'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            const input = await inputFrom(options, {
+                key: stringOption(opts.key),
+                pageNo: intOption(opts.pageNo),
+                pageSize: intOption(opts.pageSize),
+            });
+            const format = String(stringOption(opts.format) ?? 'json').toLowerCase();
+            if (format === 'text' || format === 'card' || format === 'html') {
+                await executeSearchPrint(ctx, input, format, stringOption(opts.output));
+                return;
+            }
+            await executeAndPrint(ctx, 'archive.search.run', input);
+        }));
+        withJsonInputOptions(archive.command('info')
+            .description('Get archive basic info by arc id or dataId+formId')
+            .option('--arc-dangan <id>', '{档案ID}_{表单ID}')
+            .option('--data-id <id>', 'archive data id')
+            .option('--form-id <id>', 'archive form id'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.info.get', await inputFrom(options, {
+                arcDangan: stringOption(opts.arcDangan),
+                dataId: stringOption(opts.dataId),
+                formId: stringOption(opts.formId),
+            }));
+        }));
+        const borrowCar = archive.command('borrow-car').description('Borrow car commands');
+        withJsonInputOptions(borrowCar.command('list')
+            .description('List my borrow car entries')
+            .option('--page-no <page>', 'page number, starts from 1')
+            .option('--page-size <size>', 'page size'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.borrow-car.list', await inputFrom(options, {
+                pageNo: intOption(opts.pageNo),
+                pageSize: intOption(opts.pageSize),
+            }));
+        }));
+        withJsonInputOptions(borrowCar.command('add')
+            .description('Add archives to my borrow car directly (no confirmation)'))
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'archive.borrow-car.add', await inputFrom(options));
+        }));
+        const borrowList = archive.command('borrow-list').description('Borrow order commands');
+        withJsonInputOptions(borrowList.command('list')
+            .description('List my borrow orders')
+            .option('--page-no <page>', 'page number, starts from 1')
+            .option('--page-size <size>', 'page size'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.borrow-list.list', await inputFrom(options, {
+                pageNo: intOption(opts.pageNo),
+                pageSize: intOption(opts.pageSize),
+            }));
+        }));
+        withJsonInputOptions(borrowList.command('detail')
+            .description('Get borrow order detail')
+            .option('--data-id <id>', 'borrow order data id'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.borrow-list.detail', await inputFrom(options, {
+                dataId: stringOption(opts.dataId),
+            }));
+        }));
+        withJsonInputOptions(borrowList.command('download-prepare')
+            .description('Prepare downloading borrow order original files')
+            .option('--data-id <id>', 'borrow order data id')
+            .option('--export-type <type>', '0 direct export, 1 grouped export')
+            .option('--export-structure <value>', '0 by entry, 1 by original text, 2 both')
+            .option('--group-field <field>', 'entry group field id')
+            .option('--document-field <field>', 'original text group field id')
+            .option('--output <path>', 'output zip path, default is the user Downloads directory'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.borrow-list.download.prepare', await inputFrom(options, {
+                dataId: stringOption(opts.dataId),
+                exportType: stringOption(opts.exportType),
+                exportStructure: stringOption(opts.exportStructure),
+                groupField: stringOption(opts.groupField),
+                documentField: stringOption(opts.documentField),
+                output: stringOption(opts.output),
+            }));
+        }));
+        withJsonInputOptions(borrowList.command('download-apply')
+            .description('Apply downloading borrow order original files')
+            .option('--data-id <id>', 'optional echo of borrow order data id')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.borrow-list.download.apply', await inputFrom(options, {
+                dataId: stringOption(opts.dataId),
+                continuation: stringOption(opts.continuation),
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const flow = archive.command('flow').description('Borrow workflow URL commands');
+        withJsonInputOptions(flow.command('borrow-car-prepare')
+            .description('Prepare starting a borrow workflow from borrow car'))
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'archive.flow.borrow-car.prepare', await inputFrom(options));
+        }));
+        withJsonInputOptions(flow.command('borrow-car-apply')
+            .description('Apply starting a borrow workflow from borrow car')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.flow.borrow-car.apply', await inputFrom(options, {
+                continuation: stringOption(opts.continuation),
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        withJsonInputOptions(flow.command('search-prepare')
+            .description('Prepare starting a borrow workflow from search results'))
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'archive.flow.search.prepare', await inputFrom(options));
+        }));
+        withJsonInputOptions(flow.command('search-apply')
+            .description('Apply starting a borrow workflow from search results')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.flow.search.apply', await inputFrom(options, {
+                continuation: stringOption(opts.continuation),
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        withJsonInputOptions(flow.command('renew-prepare')
+            .description('Prepare renewing a borrow order')
+            .option('--data-id <id>', 'borrow order data id'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.flow.renew.prepare', await inputFrom(options, {
+                dataId: stringOption(opts.dataId),
+            }));
+        }));
+        withJsonInputOptions(flow.command('renew-apply')
+            .description('Apply renewing a borrow order')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.flow.renew.apply', await inputFrom(options, {
+                continuation: stringOption(opts.continuation),
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const upload = archive.command('upload').description('Pre-archive upload commands');
+        withJsonInputOptions(upload.command('prepare')
+            .description('Prepare uploading a local file to the pre-archive efile library')
+            .option('--file <path>', 'local file path')
+            .option('--fonds-id <id>', 'target fonds id')
+            .option('--tree-id <id>', 'efile library node id, resolved automatically when omitted'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.upload.prelib.prepare', await inputFrom(options, {
+                file: stringOption(opts.file),
+                fondsId: stringOption(opts.fondsId),
+                treeId: stringOption(opts.treeId),
+            }));
+        }));
+        withJsonInputOptions(upload.command('apply')
+            .description('Apply uploading a local file to the pre-archive efile library')
+            .option('--fonds-id <id>', 'optional echo of target fonds id')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation'))
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'archive.upload.prelib.apply', await inputFrom(options, {
+                fondsId: stringOption(opts.fondsId),
+                continuation: stringOption(opts.continuation),
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+    },
+};

package/dist/shortcuts/archive/manifest.js

@@ -0,0 +1,45 @@
+import { archiveOperationDefinitions } from './operations/registry.js';
+/** 对外契约：只暴露操作名 / 资源 / 摘要 / 风险 / 是否需确认 / 入参 schema。 */
+export const archiveOperations = archiveOperationDefinitions().map((definition) => ({
+    name: definition.name,
+    resource: definition.resource,
+    summary: definition.summary,
+    ...(definition.capability ? { capability: definition.capability } : {}),
+    risk: definition.risk,
+    ...(definition.requiresConfirmation ? { requiresConfirmation: true } : {}),
+    inputSchema: definition.inputSchema,
+}));
+export const archiveManifest = {
+    schemaVersion: 1,
+    name: 'archive',
+    title: '泛微E10文书定档案管理',
+    version: '0.1.0',
+    host: 'e10-archive',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-wenshuding',
+    capabilities: ['fonds', 'prelib', 'search', 'borrowCar', 'borrowList', 'flow', 'download', 'upload'],
+    auth: {
+        required: 'e10-session',
+        note: '所有操作都要求已登录 E10（weaver-work-cli auth login --base-url <域名>），未登录时返回 auth_error。',
+    },
+    rules: [
+        '写操作（*.apply）必须先执行同名的 prepare 拿到 continuation，再带 confirm=true 执行 apply；CLI 用 --yes 表示确认。',
+        '借阅单下载为异步任务：apply 会轮询打包进度，完成后把 zip 保存到当前用户的「下载」目录（可用 output 指定路径）。',
+        '发起借阅/续借只返回流程创建页 URL，CLI 不自动打开浏览器，需由用户或上层在浏览器中打开。',
+        '借阅车/借阅单列表优先自定义接口，接口未发布时自动回退 ebuilder 列表链路，回退时行的字段更少（提供 fields/display）。',
+    ],
+    operations: archiveOperations,
+    withheldOperations: [
+        {
+            name: 'archive.borrow.submit',
+            reason: '借阅申请表单的字段结构、必填项与提交契约尚未固化为接口，目前只能通过流程创建页 URL 由用户在浏览器完成。',
+        },
+        {
+            name: 'archive.borrow-car.remove',
+            reason: '缺少借阅车移除接口的请求契约与权限回查方式，暂不开放。',
+        },
+    ],
+};
+export function hasArchiveOperationInManifest(operation) {
+    return archiveOperations.some((item) => item.name === operation);
+}

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

@@ -0,0 +1,55 @@
+import { archiveValidationError } from '../errors.js';
+import { READ, archiveSuccess, schemaOf, } from './types.js';
+import { unwrapData } from './shared.js';
+/** 拆解 `{档案ID}_{表单ID}` 复合标识。 */
+function splitArcId(arcDangan, field) {
+    const text = typeof arcDangan === 'string' ? arcDangan : String(arcDangan ?? '');
+    const [dataId, formId] = text.split('_');
+    if (!dataId || !formId || !/^\d+$/.test(dataId) || !/^\d+$/.test(formId)) {
+        throw archiveValidationError('arc_id_invalid', `${field} 必须是 {档案ID}_{表单ID} 格式的数字 ID 对`);
+    }
+    return { dataId, formId };
+}
+/**
+ * 档案基本信息。输入可以是 arc_dangan（{档案ID}_{表单ID}）或 dataId+formId 组合。
+ */
+const archiveInfoGet = {
+    name: 'archive.info.get',
+    resource: 'info',
+    method: 'get',
+    action: 'archive.info.get',
+    summary: '查看档案条目的基本信息（年度/案卷号/起止件号/文件日期/保管期限/密级/库位等）；输入为档案标识 {档案ID}_{表单ID}（可来自借阅车 arc_dangan）',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({
+        arcDangan: { type: 'string', description: '{档案ID}_{表单ID}，与 dataId+formId 二选一' },
+        dataId: { type: 'string', pattern: '^\\d+$', description: '档案数据 ID（arc_dangan 拆解前半段）' },
+        formId: { type: 'string', pattern: '^\\d+$', description: '档案所属表单 ID（arc_dangan 拆解后半段）' },
+    }, { description: '查询档案基本信息；arcDangan 与 dataId+formId 至少提供一组' }),
+    handler: async (args, { host }) => {
+        let pair;
+        if (args.arcDangan !== undefined) {
+            pair = splitArcId(args.arcDangan, 'arcDangan');
+        }
+        else {
+            const dataId = args.dataId;
+            const formId = args.formId;
+            if (dataId === undefined || dataId === null || dataId === '' || formId === undefined || formId === null || formId === '') {
+                throw archiveValidationError('id_pair_required', 'arcDangan 或 dataId+formId 必填一组');
+            }
+            if (!/^\d+$/.test(String(dataId)) || !/^\d+$/.test(String(formId))) {
+                throw archiveValidationError('id_pair_invalid', 'dataId/formId 必须是数字 ID');
+            }
+            pair = { dataId: String(dataId), formId: String(formId) };
+        }
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/archive/core/borrow/getBorrowDetails',
+            body: { dataId: pair.dataId, formId: pair.formId },
+        });
+        const data = unwrapData(response);
+        const rows = Array.isArray(data) ? data : [];
+        return archiveSuccess('archive.info.get', rows, { count: rows.length });
+    },
+};
+export const archiveInfoOperations = [archiveInfoGet];