weaver-work-cli 0.1.1 → 0.1.4

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

@@ -0,0 +1,120 @@
+import { archiveValidationError } from '../errors.js';
+/** 原型污染防护：禁止出现在输入对象中的键。 */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+export function asObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw archiveValidationError('input_not_object', '输入必须是 JSON 对象');
+    }
+    return value;
+}
+export function assertNoForbiddenKeys(input) {
+    for (const key of Object.keys(input)) {
+        if (FORBIDDEN_KEYS.has(key)) {
+            throw archiveValidationError('forbidden_key', `输入包含非法字段：${key}`);
+        }
+    }
+}
+/** 移除值为 undefined 的键，避免把空值写进请求体。 */
+export function compact(body) {
+    for (const key of Object.keys(body)) {
+        if (body[key] === undefined)
+            delete body[key];
+    }
+    return body;
+}
+export function pickDefined(value, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (value[key] !== undefined)
+            result[key] = value[key];
+    }
+    return result;
+}
+/** 取出响应中的业务数据。 */
+export function unwrapData(response) {
+    if (!response || typeof response !== 'object')
+        return response;
+    return response.data;
+}
+/**
+ * 取出 ebuilder 自定义接口（getFormDataList / getFormDataByPk）的 datajson 业务体。
+ * 这类接口把业务状态放在 `datajson.status`，数据放在 `datajson.datas`。
+ */
+export function unwrapDatajson(response) {
+    if (!response || typeof response !== 'object')
+        return undefined;
+    const value = response;
+    if (value.datajson && typeof value.datajson === 'object')
+        return value.datajson;
+    const data = value.data;
+    if (data && typeof data === 'object' && data.datajson) {
+        return data.datajson;
+    }
+    return undefined;
+}
+/** 正整数入参（分页页码/条数）。 */
+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 archiveValidationError('number_invalid', `${field} 必须是正整数`);
+    }
+    return parsed;
+}
+/** 非空字符串，供必填提示。 */
+export function requireText(value, field) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw archiveValidationError('field_required', `${field} 必填`);
+    }
+    return value.trim();
+}
+/** 字符串 ID（允许纯数字字符串）。 */
+export function toStringId(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const text = typeof value === 'string' ? value.trim() : String(value);
+    if (!/^\d+$/.test(text))
+        throw archiveValidationError('id_invalid', `${field} 必须是数字 ID`);
+    return text;
+}
+/** 数组内每个元素必须是数字 ID，返回字符串列表（部分接口要求字符串 id）。 */
+export function toStringIdList(value, field) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Array.isArray(value))
+        throw archiveValidationError('id_list_invalid', `${field} 必须是 ID 数组`);
+    return value.map((item, index) => {
+        const text = toStringId(item, `${field}[${index}]`);
+        if (text === undefined)
+            throw archiveValidationError('id_list_invalid', `${field}[${index}] 不能为空`);
+        return text;
+    });
+}
+/** 非空字符串数组。 */
+export function requireStringList(value, field) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw archiveValidationError('list_required', `${field} 必填且至少一项`);
+    }
+    return value.map((item, index) => {
+        if (typeof item !== 'string' || !item.trim()) {
+            throw archiveValidationError('list_invalid', `${field}[${index}] 必须是字符串`);
+        }
+        return item.trim();
+    });
+}
+/** 校验数组内每个元素都在枚举内。 */
+export function assertEnum(value, allowed, field) {
+    const text = typeof value === 'string' ? value : String(value);
+    if (!allowed.includes(text)) {
+        throw archiveValidationError('enum_invalid', `${field} 取值必须是 ${allowed.join(' / ')} 之一`);
+    }
+    return text;
+}
+/** 安全布尔。 */
+export function requireBoolean(value, field) {
+    if (typeof value !== 'boolean') {
+        throw archiveValidationError('boolean_invalid', `${field} 必须是布尔值`);
+    }
+    return value;
+}

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

@@ -0,0 +1,23 @@
+export const READ = 'read';
+export const WRITE = 'write';
+export function archiveSuccess(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_INTEGER_POSITIVE = { type: 'integer', minimum: 1 };
+export const SCHEMA_DATE = { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' };
+export const SCHEMA_ID = { oneOf: [{ type: 'integer' }, { type: 'string', pattern: '^\\d+$' }] };
+export const SCHEMA_ID_LIST = { type: 'array', items: SCHEMA_ID };
+export const SCHEMA_STRING_LIST = { type: 'array', items: { type: 'string' } };

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

@@ -0,0 +1,182 @@
+import { createHash } from 'node:crypto';
+import { stat } from 'node:fs/promises';
+import { basename, resolve } from 'node:path';
+import { readFile } from 'node:fs/promises';
+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 UPLOAD_APPLY = 'archive.upload.prelib.apply';
+const MAX_UPLOAD_BYTES = 200 * 1024 * 1024;
+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);
+}
+/** treeId 未提供时，从预归档树中取唯一的电子文件库节点。 */
+async function resolveDefaultTreeId(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.filter(isEfileLibNode);
+    if (nodes.length === 0) {
+        throw archiveValidationError('tree_id_required', '未找到电子文件库节点，请显式传入 treeId');
+    }
+    if (nodes.length > 1) {
+        throw archiveValidationError('tree_id_ambiguous', `存在多个电子文件库节点（${nodes.map((item) => item.id).join('、')}），请显式传入 treeId`);
+    }
+    return String(nodes[0].id);
+}
+const uploadPrepare = {
+    name: 'archive.upload.prelib.prepare',
+    resource: 'upload',
+    method: 'prelib',
+    action: 'archive.upload.prelib.prepare',
+    summary: '预归档上传预检：校验本地文件与目标全宗/电子文件库节点，并生成确认票据（不上传）',
+    capability: 'archive',
+    risk: READ,
+    inputSchema: schemaOf({
+        file: { type: 'string', description: '本地文件路径' },
+        fondsId: { type: 'string', pattern: '^\\d+$', description: '目标全宗 ID（archive.fonds.list 返回的 id）' },
+        treeId: { type: 'string', description: '可选，电子文件库节点 id；不传时取唯一的电子文件库节点' },
+    }, { required: ['file', 'fondsId'], description: '预归档上传预检' }),
+    handler: async (args, env) => {
+        const filePath = typeof args.file === 'string' && args.file.trim() ? resolve(args.file.trim()) : '';
+        if (!filePath)
+            throw archiveValidationError('file_required', 'file 必填（本地文件路径）');
+        const fondsId = String(args.fondsId ?? '').trim();
+        if (!/^\d+$/.test(fondsId))
+            throw archiveValidationError('fonds_id_invalid', 'fondsId 必填且为数字 ID');
+        let info;
+        try {
+            info = await stat(filePath);
+        }
+        catch {
+            throw archiveValidationError('file_unreadable', `无法读取本地文件：${filePath}`);
+        }
+        if (!info.isFile())
+            throw archiveValidationError('file_invalid', `不是文件：${filePath}`);
+        if (info.size === 0)
+            throw archiveValidationError('file_empty', `文件为空：${filePath}`);
+        if (info.size > MAX_UPLOAD_BYTES) {
+            throw archiveValidationError('file_too_large', `文件超过 ${MAX_UPLOAD_BYTES} 字节上限：${filePath}`);
+        }
+        const treeId = args.treeId === undefined || args.treeId === null || args.treeId === ''
+            ? await resolveDefaultTreeId(env.host)
+            : String(args.treeId);
+        const { continuation, expiresInMs } = await issueLease(env, UPLOAD_APPLY, {
+            file: filePath,
+            fileName: basename(filePath),
+            size: info.size,
+            fondsId,
+            treeId,
+        });
+        return archiveSuccess('archive.upload.prelib.prepare', {
+            preview: {
+                file: filePath,
+                fileName: basename(filePath),
+                size: info.size,
+                fondsId,
+                treeId,
+            },
+            hint: '确认后调用 archive.upload.prelib.apply（CLI：archive upload apply --continuation <token> --yes）',
+            continuation,
+        }, { requiresConfirmation: true, expiresInMs });
+    },
+};
+const uploadApply = {
+    name: UPLOAD_APPLY,
+    resource: 'upload',
+    method: 'prelib',
+    action: UPLOAD_APPLY,
+    summary: '预归档上传（写操作）：preUploadCheck → module/upload → saveFile，把本地文件存入预归档电子文件库',
+    capability: 'archive',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: schemaOf({
+        continuation: { type: 'string', description: 'prepare 返回的确认票据' },
+        confirm: { type: 'boolean', description: '必须为 true（CLI --yes）' },
+        fondsId: { type: 'string', description: '可选回传，用于与 prepare 快照比对' },
+    }, { required: ['continuation', 'confirm'], description: '预归档上传' }),
+    handler: async (args, env) => {
+        const lease = await verifyLease(args, UPLOAD_APPLY, env);
+        const filePath = String(lease.file ?? '');
+        const fileName = String(lease.fileName ?? basename(filePath));
+        const fondsId = String(lease.fondsId ?? '');
+        const treeId = String(lease.treeId ?? '');
+        if (!filePath || !fondsId || !treeId) {
+            throw archiveValidationError('continuation_payload_invalid', '确认票据缺少 file / fondsId / treeId');
+        }
+        assertLeaseTarget(lease, args, ['fondsId'], UPLOAD_APPLY);
+        const content = await readFile(filePath);
+        if (content.length === 0)
+            throw archiveValidationError('file_empty', `文件为空：${filePath}`);
+        const md5 = createHash('md5').update(content).digest('hex');
+        const lastModified = Date.now();
+        const checkForm = new FormData();
+        checkForm.append('module', 'archive');
+        checkForm.append('name', fileName);
+        checkForm.append('size', String(content.length));
+        checkForm.append('MD5', md5);
+        checkForm.append('lastModified', String(lastModified));
+        checkForm.append('lastModifiedDate', String(lastModified));
+        checkForm.append('compressImg', 'false');
+        const check = await env.host.request({
+            method: 'POST',
+            path: '/api/file/preUploadCheck',
+            multipart: checkForm,
+        });
+        const checkData = (unwrapData(check) ?? {});
+        if (checkData.permissionType?.upload === false) {
+            throw archiveValidationError('upload_forbidden', '当前账号没有上传权限');
+        }
+        const uploadForm = new FormData();
+        uploadForm.append('module', 'archive');
+        uploadForm.append('name', fileName);
+        uploadForm.append('size', String(content.length));
+        uploadForm.append('MD5', md5);
+        uploadForm.append('lastModified', String(lastModified));
+        uploadForm.append('lastModifiedDate', String(lastModified));
+        uploadForm.append('compressImg', 'false');
+        uploadForm.append('file', new Blob([content], { type: 'application/octet-stream' }), fileName);
+        const uploaded = await env.host.request({
+            method: 'POST',
+            path: '/api/file/module/upload',
+            multipart: uploadForm,
+        });
+        const uploadData = (unwrapData(uploaded) ?? {});
+        const fileId = String(uploadData.fileid ?? '');
+        if (!fileId)
+            throw archiveValidationError('upload_failed', '文件上传失败，未取到 fileid');
+        await env.host.request({
+            method: 'POST',
+            path: '/api/archive/core/intelligent/saveFile',
+            body: {
+                docIds: fileId,
+                docNames: String(uploadData.name ?? fileName),
+                treeId,
+                fonds_code: fondsId,
+                logFlag: 'preLib',
+            },
+        });
+        return archiveSuccess(UPLOAD_APPLY, {
+            saved: true,
+            fileId,
+            docId: String(uploadData.docId ?? ''),
+            fileName: String(uploadData.name ?? fileName),
+            size: Number(uploadData.size ?? content.length),
+            treeId,
+            fondsId,
+            md5,
+        }, { wrote: true });
+    },
+};
+export const uploadOperations = [uploadPrepare, uploadApply];

package/dist/shortcuts/archive/operations.js

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

package/dist/shortcuts/archive/render/search-format.js

@@ -0,0 +1,276 @@
+import { toSearchRowView, withBaseUrl } from './search-view.js';
+function escapeHtml(value) {
+    return String(value)
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/** 行字段是否齐全（能拼出可打开链接）。 */
+function hasLink(view) {
+    return Boolean(view.id && view.formId);
+}
+function describeDate(view) {
+    return view.dateLabel && view.dateValue ? `${view.dateLabel}：${view.dateValue}` : '';
+}
+function textMetaItems(view) {
+    const parts = [];
+    parts.push(`全宗：${view.fonds || '-'}`);
+    parts.push(`分类：${view.category || '-'}`);
+    const datePart = describeDate(view);
+    if (datePart)
+        parts.push(datePart);
+    return parts;
+}
+/** 单行文本：`1. 【原文】 题名` */
+function textTitleLine(index, view) {
+    return `${index}. 【${view.level || '未分类'}】 ${view.title || '(无题名)'}`;
+}
+/** 单行摘要：`全宗：x    分类：y    文件形成时间：z` */
+function textMetaLine(view) {
+    return textMetaItems(view).join('    ');
+}
+function pageLabel(meta) {
+    if (!meta)
+        return '';
+    const pageNo = Number(meta.pageNo);
+    const totalPage = Number(meta.totalPage);
+    const bits = [];
+    if (meta.total !== undefined)
+        bits.push(`命中 ${meta.total} 条`);
+    if (!Number.isNaN(pageNo))
+        bits.push(`第 ${pageNo + 1} 页`);
+    if (!Number.isNaN(totalPage) && totalPage > 0)
+        bits.push(`共 ${totalPage} 页`);
+    return bits.join(' · ');
+}
+/** 取原行命中高亮原文（含 <em>），无则回退已剥标签的展示摘要。 */
+function highlightSourceOf(raw, view) {
+    const direct = String(raw.highLightContent ?? raw.content ?? '').trim();
+    return direct || view.highlight;
+}
+const EMPH_OPEN = '\u0001';
+const EMPH_CLOSE = '\u0002';
+function segmentsOfHighlight(value) {
+    // 先合并被拆开的高亮字：<em>会</em><em>计</em> -> <em>会计</em>，避免输出 **会****计**
+    const source = String(value ?? '')
+        .replace(/<\/em>\s*<em>/gi, '')
+        .replace(/<em>([\s\S]*?)<\/em>/gi, (_all, inner) => `${EMPH_OPEN}${inner}${EMPH_CLOSE}`)
+        .replace(/<[^>]+>/g, ' ');
+    const segments = [];
+    let buffer = '';
+    let inEm = false;
+    const flush = () => {
+        const text = buffer
+            .replace(/&nbsp;/g, ' ')
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#0*39;/g, "'")
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (text)
+            segments.push({ em: inEm, text });
+        buffer = '';
+    };
+    for (const char of source) {
+        if (char === EMPH_OPEN) {
+            flush();
+            inEm = true;
+            continue;
+        }
+        if (char === EMPH_CLOSE) {
+            flush();
+            inEm = false;
+            continue;
+        }
+        buffer += char;
+    }
+    flush();
+    return segments;
+}
+/** Markdown 高亮：`<em>词</em>` -> `**词**`，同时压行到 max 且不切断强调标记。 */
+function markdownHighlight(value, max = 200) {
+    const segments = segmentsOfHighlight(value);
+    let out = '';
+    let remaining = max;
+    let truncated = false;
+    const isWordChar = (char) => Boolean(char && /[\w\u3400-\u9fff]/.test(char));
+    for (let i = 0; i < segments.length; i += 1) {
+        const segment = segments[i];
+        if (remaining <= 0) {
+            truncated = true;
+            break;
+        }
+        if (segment.em) {
+            const overhead = '**__**'.length - 2;
+            const bodyMax = Math.max(1, remaining - overhead);
+            const body = segment.text.slice(0, bodyMax);
+            if (body.length < segment.text.length)
+                truncated = true;
+            // Markdown 强调两侧需与字面词隔开才能被识别，补一个空格保护
+            const leadPad = isWordChar(out.slice(-1)) ? ' ' : '';
+            const tailPad = isWordChar(segments[i + 1]?.text[0]) ? ' ' : '';
+            out += `${leadPad}**${body}**${tailPad}`;
+            remaining -= overhead + body.length + leadPad.length + tailPad.length;
+        }
+        else {
+            const take = Math.min(segment.text.length, remaining);
+            out += segment.text.slice(0, take);
+            remaining -= take;
+            if (take < segment.text.length) {
+                truncated = true;
+                break;
+            }
+        }
+    }
+    return (truncated ? `${out.replace(/…$/, '')}…` : out).trim();
+}
+/** HTML 高亮：`<em>词</em>` -> `<mark>词</mark>`，其余内容转义。 */
+function htmlHighlight(value, max = 300) {
+    const segments = segmentsOfHighlight(value);
+    let out = '';
+    let remaining = max;
+    let truncated = false;
+    for (const segment of segments) {
+        if (remaining <= 0) {
+            truncated = true;
+            break;
+        }
+        if (segment.em) {
+            const overhead = '<mark>__</mark>'.length - 2;
+            const bodyMax = Math.max(1, remaining - overhead);
+            const body = segment.text.slice(0, bodyMax);
+            if (body.length < segment.text.length)
+                truncated = true;
+            out += `<mark>${escapeHtml(body)}</mark>`;
+            remaining -= overhead + body.length;
+        }
+        else {
+            const take = Math.min(segment.text.length, remaining);
+            out += escapeHtml(segment.text.slice(0, take));
+            remaining -= take;
+            if (take < segment.text.length) {
+                truncated = true;
+                break;
+            }
+        }
+    }
+    return truncated ? `${out.replace(/…$/, '')}…` : out;
+}
+/* ------------------------------------------------------------------ *
+ * 三段式纯文本（终端 / 精简场景）
+ * ------------------------------------------------------------------ */
+export function formatSearchText(rows, meta = undefined) {
+    const views = rows.map((row) => toSearchRowView(row));
+    const keyword = String(meta?.keyword ?? '').trim();
+    const headerBits = [];
+    if (keyword)
+        headerBits.push(`「${keyword}」检索`);
+    const pages = pageLabel(meta);
+    if (pages)
+        headerBits.push(pages);
+    const lines = [];
+    if (headerBits.length)
+        lines.push(headerBits.join(' | '));
+    if (lines.length)
+        lines.push('='.repeat(60));
+    views.forEach((view, index) => {
+        lines.push(textTitleLine(index + 1, view));
+        if (view.highlight)
+            lines.push(`   ${view.highlight}`);
+        lines.push(`   ${textMetaLine(view)}`);
+        if (index < views.length - 1)
+            lines.push('');
+    });
+    return lines.join('\n');
+}
+/* ------------------------------------------------------------------ *
+ * 对话内 Markdown 卡片：标题可点击、命中词加粗高亮，直接粘贴进回复。
+ * 版式（每条固定三段，段落之间用空行分隔，保证任意 Markdown 渲染下都分列显示）：
+ *   1. **【原文】** [题名](http://host/sp/custom/archive/archiveView?...)        ← 第一段
+ *
+ *      命中正文摘要（**高亮词**，压行 ~200 字）                              ← 第二段
+ *
+ *      全宗：xxx　分类：xxx　文件形成时间：2026-01-23                      ← 第三段
+ * 注意：三段间必须空行，单换行在 Markdown 是软换行会被折叠成空格。
+ * ------------------------------------------------------------------ */
+export function formatSearchCard(rows, options = {}) {
+    const baseUrl = String(options.baseUrl ?? '').trim().replace(/\/+$/, '');
+    const items = rows.map((row) => {
+        const raw = row;
+        const view = toSearchRowView(raw);
+        return { raw, view: view.viewPath && baseUrl ? withBaseUrl(view, baseUrl) : view };
+    });
+    const blocks = [];
+    items.forEach(({ raw, view }, index) => {
+        const url = view.viewUrl || view.viewPath || '';
+        const titleLink = url
+            ? `[${view.title || '(无题名)'}](${url})`
+            : view.title || '(无题名)';
+        const parts = [];
+        parts.push(`${index + 1}. **【${view.level || '未分类'}】** ${titleLink}`);
+        const highlight = markdownHighlight(highlightSourceOf(raw, view));
+        if (highlight) {
+            parts.push('');
+            parts.push(highlight);
+        }
+        parts.push('');
+        parts.push(textMetaItems(view).join('　'));
+        blocks.push(parts.join('\n'));
+    });
+    return blocks.join('\n\n');
+}
+/* ------------------------------------------------------------------ *
+ * HTML 卡片：标题可点击、命中词 <mark> 高亮。
+ * ------------------------------------------------------------------ */
+export function formatSearchHtml(rows, options = {}) {
+    const baseUrl = String(options.baseUrl ?? '').trim().replace(/\/+$/, '');
+    const items = rows.map((row) => {
+        const raw = row;
+        const view = toSearchRowView(raw);
+        return { raw, view: hasLink(view) && baseUrl ? withBaseUrl(view, baseUrl) : view };
+    });
+    const keyword = String(options.keyword ?? '').trim();
+    const heading = options.heading ?? (keyword ? `「${keyword}」档案检索结果` : '档案检索结果');
+    const cards = items
+        .map(({ raw, view }, index) => {
+        const linkHref = view.viewUrl || view.viewPath;
+        const titleEl = linkHref
+            ? `<a class="tlink" href="${escapeHtml(linkHref)}" target="_blank" title="打开档案视图">${escapeHtml(view.title || '(无题名)')}</a>`
+            : `<span class="tlink plain">${escapeHtml(view.title || '(无题名)')}</span>`;
+        const highlight = htmlHighlight(highlightSourceOf(raw, view));
+        return `<article class="card">
+  <div class="trow"><span class="idx">${index + 1}.</span><span class="lvl">${escapeHtml(view.level || '未分类')}</span>${titleEl}</div>
+  ${highlight ? `<p class="hl">${highlight}</p>` : ''}
+  <div class="meta"><span>全宗：${escapeHtml(view.fonds || '-')}</span><span>分类：${escapeHtml(view.category || '-')}</span>${view.dateLabel && view.dateValue ? `<span>${escapeHtml(describeDate(view))}</span>` : ''}</div>
+</article>`;
+    })
+        .join('\n');
+    const pages = pageLabel(options);
+    return `<!DOCTYPE html>
+<html lang="zh-CN"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${escapeHtml(heading)}</title><style>
+*{box-sizing:border-box;margin:0;padding:0}
+body{font:14px/1.7 -apple-system,"PingFang SC","Microsoft YaHei",sans-serif;background:#f0f2f5;color:#1f2d3d;padding:28px}
+.wrap{max-width:980px;margin:0 auto}
+h1{font-size:20px;margin-bottom:4px}
+.sub{color:#64748b;font-size:13px;margin-bottom:18px}
+.card{background:#fff;border:1px solid #e2e8f0;border-radius:10px;padding:14px 18px;margin-bottom:12px;box-shadow:0 1px 2px rgba(0,0,0,.04)}
+.trow{display:flex;align-items:baseline;gap:10px;flex-wrap:wrap}
+.idx{color:#94a3b8;font-weight:600}
+.lvl{flex:none;background:#eef4ff;color:#2563eb;border:1px solid #bfdbfe;border-radius:4px;padding:0 8px;font-size:12px}
+.tlink{font-size:15px;font-weight:600;color:#0f2c5c;text-decoration:none;word-break:break-all}
+.tlink:hover{color:#1d6ae5;text-decoration:underline}
+.tlink.plain{cursor:default}
+.hl{margin:8px 0 6px;color:#475569;display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden;font-size:13px}
+.hl mark{background:#ffe58f;color:#7c2d12;padding:0 2px;border-radius:3px;font-weight:600}
+.meta{display:flex;gap:22px;color:#334155;font-size:13px;border-top:1px dashed #e2e8f0;padding-top:8px;flex-wrap:wrap}
+.meta span:first-child{color:#0f766e}
+</style></head><body><div class="wrap">
+<h1>${escapeHtml(heading)}</h1>
+${pages ? `<div class="sub">${escapeHtml(pages)} · 点击题名打开档案视图</div>` : ''}
+${cards}
+</div></body></html>`;
+}