weaver-work-cli 0.1.40 → 0.1.44

package/dist/shortcuts/reception/operations/customparams.js

@@ -0,0 +1,74 @@
+/**
+ * customParams 口径：逐行对齐 weaver-work-cli release 的 xiaoEUrlParamValue / buildXiaoECustomParams。
+ *
+ * 关键三条（与旧方案文档相反的地方已按源码纠正）：
+ *   1) 同字段多值用 `,`，明细多行用 `;`；
+ *   2) 标量对象按 id > optionId > fileId > fileid > fid > value 取标识；
+ *   3) 空值字段整个省略，且不进入 fieldAssignKeys。
+ */
+export const MULTI_SEPARATOR = ',';
+export const ROW_SEPARATOR = ';';
+const SCALAR_KEYS = ['id', 'optionId', 'fileId', 'fileid', 'fid', 'value'];
+export function urlParamScalar(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'object') {
+        const record = value;
+        for (const key of SCALAR_KEYS) {
+            const picked = record[key];
+            if (picked === null || picked === undefined)
+                continue;
+            const text = String(picked).trim();
+            if (text)
+                return text;
+        }
+        return '';
+    }
+    return String(value).trim();
+}
+export function urlParamValue(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (Array.isArray(value)) {
+        return value.map((item) => urlParamScalar(item)).filter(Boolean).join(MULTI_SEPARATOR);
+    }
+    return urlParamScalar(value);
+}
+export function buildCustomParams(items = []) {
+    const ordered = [];
+    const main = new Map();
+    const detail = new Map();
+    for (const item of items) {
+        const fieldId = String((item && item.fieldId) || '').trim();
+        if (!fieldId)
+            continue;
+        const text = urlParamValue(item.value);
+        if (!text)
+            continue;
+        const isDetail = item.dataIndex !== undefined && item.dataIndex !== null;
+        if (!isDetail) {
+            if (!main.has(fieldId) && !detail.has(fieldId))
+                ordered.push(fieldId);
+            main.set(fieldId, text);
+            continue;
+        }
+        if (!detail.has(fieldId)) {
+            if (!main.has(fieldId))
+                ordered.push(fieldId);
+            detail.set(fieldId, []);
+        }
+        const index = Number(item.dataIndex);
+        detail.get(fieldId).push({ index: Number.isFinite(index) ? index : 0, text });
+    }
+    const values = {};
+    for (const fieldId of ordered) {
+        const rows = detail.get(fieldId);
+        if (rows && rows.length) {
+            rows.sort((left, right) => left.index - right.index);
+            values[fieldId] = rows.map((row) => row.text).join(ROW_SEPARATOR);
+            continue;
+        }
+        values[fieldId] = main.get(fieldId) ?? '';
+    }
+    return { values, keys: ordered };
+}

package/dist/shortcuts/reception/operations/doc.js

@@ -0,0 +1,238 @@
+import { readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { DEFAULT_WORKFLOW } from '../constants.js';
+import { receptionValidationError } from '../errors.js';
+import { mergeAnswers } from './panels.js';
+import { requirePython, renderBoth, resolveRenderPy } from './render-assets.js';
+import { newRunId, saveRun, tryLoadRun } from './runs.js';
+import { canonical, ensureDir, parseJsonText, sha256, writeJson } from './shared.js';
+/** 案例 + 专家检索结果注入。软依赖：文件没给 / 给空就整段不出，不阻断出单。 */
+function applyCases(data, casesFile) {
+    let raw;
+    try {
+        raw = readFileSync(casesFile, 'utf8');
+    }
+    catch (error) {
+        throw receptionValidationError('CASES_FILE_UNREADABLE', `读不到 --cases-file：${casesFile}`, {
+            path: casesFile,
+            detail: error.message,
+            hint: '检查路径与读权限',
+        });
+    }
+    const parsed = parseJsonText(raw);
+    if (!parsed.ok) {
+        throw receptionValidationError('CASES_INVALID', `--cases-file 不是合法 JSON：${parsed.error}`, {
+            preview: parsed.preview,
+            hasBom: parsed.hasBom,
+            hint: '常见原因：UTF-8 BOM（hasBom:true）、中文引号、尾随逗号；修 JSON 本身，不要换传参方式',
+        });
+    }
+    const payload = parsed.value;
+    const list = Array.isArray(payload) ? payload : (payload.cases || payload.items || []);
+    if (Array.isArray(list) && list.length)
+        data.cases = list;
+    if (payload && !Array.isArray(payload)) {
+        const note = payload.note || payload.casesNote || '';
+        if (note)
+            data.casesNote = String(note);
+        const query = payload.query || payload.casesQuery || '';
+        if (query)
+            data.casesQuery = String(query);
+        // 专家参考：与案例同文件，第二个检索结果
+        const experts = payload.experts || payload.expertItems || [];
+        if (Array.isArray(experts) && experts.length)
+            data.experts = experts;
+        const expertsNote = payload.expertsNote || payload.expertNote || '';
+        if (expertsNote)
+            data.expertsNote = String(expertsNote);
+        const expertsQuery = payload.expertsQuery || payload.expertQuery || '';
+        if (expertsQuery)
+            data.expertsQuery = String(expertsQuery);
+    }
+}
+export async function doc(input, ctx) {
+    const startedAt = Date.now();
+    const runIdArg = String(input.runId || '').trim();
+    const knownArg = input.known || null;
+    let run = runIdArg ? tryLoadRun(ctx.stateDir, runIdArg) : null;
+    let rebuilt = false;
+    if (!run) {
+        if (!knownArg) {
+            if (!runIdArg) {
+                throw receptionValidationError('RUN_ID_MISSING', '缺少 --run-id：正常流程先用 ask 取 runId；run 已失效时改用 --known 现场重建', { hint: 'reception doc --known \'{"customer":"…","visitDate":"…"}\' --answers \'{…}\'' });
+            }
+            // 有 runId 但文件没了，且没给 known：只能让调用方补齐
+            throw receptionValidationError('RUN_NOT_FOUND', `找不到 run：${runIdArg}（可能已过期或换了机器）`, { runId: runIdArg, stateDir: ctx.stateDir, hint: '把 ask 用过的 --known 一起带上重跑本条，CLI 会现场重建 run' });
+        }
+        rebuilt = Boolean(runIdArg);
+        const session = await ctx.host.getSession();
+        run = {
+            // 重建的 run 用新 id：传进来的那个已经不存在了，复用它会让人误以为原 run 还在
+            runId: newRunId(),
+            createdAt: new Date().toISOString(),
+            workflow: input.workflow || DEFAULT_WORKFLOW,
+            outDir: input.outDir || ctx.outDir,
+            base: session.baseUrl,
+            data: { ...knownArg },
+            customer: null,
+            user: null,
+            mode: 'browsertool',
+        };
+    }
+    const answers = input.answers ?? run.answers ?? {};
+    const data = mergeAnswers(run, answers);
+    if (input.casesFile)
+        applyCases(data, input.casesFile);
+    const outDir = input.outDir || run.outDir || ctx.outDir;
+    ensureDir(outDir);
+    const warnings = [];
+    const dataHash = sha256(canonical(data)).slice(0, 32);
+    const dataPath = join(ctx.stateDir, `doc-data-${dataHash.slice(0, 12)}.json`);
+    writeJson(dataPath, data);
+    const python = requirePython(ctx.stateDir);
+    const renderPy = resolveRenderPy(input.renderPy || '', input.snapshot || '');
+    const noUpload = input.noUpload === true;
+    // 会话与渲染并行：渲染约 7s，会话读取基本瞬时，没必要串行等
+    const sessionPromise = noUpload
+        ? Promise.resolve(null)
+        : ctx.host.getSession();
+    const renderPromise = renderBoth({ python, renderPy, dataPath, outDir });
+    const uploadPromise = renderPromise.then(async (rendered) => {
+        if (noUpload)
+            return null;
+        const session = await sessionPromise;
+        if (!session || !session.available) {
+            return { ups: [], uploadMs: 0, base: '', skipped: 'NO_SESSION' };
+        }
+        const uploadStartedAt = Date.now();
+        // 两附件都挂同一个字段：docx（对外行程单）+ md（内部接待方案），按此顺序上传
+        const picks = ['docx', 'md']
+            .map((kind) => ({
+            kind,
+            file: (rendered.result.files || []).find((file) => file.kind === kind),
+        }))
+            .filter((item) => item.file);
+        const ups = [];
+        for (const item of picks) {
+            const result = await ctx.host.uploadFile(item.file.path);
+            ups.push({ kind: item.kind, ...result });
+        }
+        return { ups, uploadMs: Date.now() - uploadStartedAt, base: session.baseUrl };
+    });
+    const [rendered, uploadResult] = await Promise.all([renderPromise, uploadPromise]);
+    const docxMs = rendered.docxMs;
+    const mdMs = rendered.mdMs;
+    let attachment = null;
+    let attachments = [];
+    let uploadMs = null;
+    /** 上传失败时的结构化诊断，直接进返回体：下次失败不用再靠猜。 */
+    let uploadDiagnostics = [];
+    if (uploadResult) {
+        uploadMs = uploadResult.uploadMs;
+        const succeeded = uploadResult.ups.filter((item) => item.ok && item.fileid);
+        const failed = uploadResult.ups.filter((item) => !item.ok);
+        if (succeeded.length) {
+            attachments = succeeded.map((item) => ({
+                fileid: String(item.fileid),
+                name: item.name || '',
+                kind: item.kind,
+            }));
+            attachment = attachments.find((item) => item.kind === 'docx') || attachments[0];
+        }
+        if (failed.length) {
+            // 失败原因必须带够线索：HTTP 状态、content-type、响应片段、下一步提示。
+            // 只写"no fileid in response"等于让人猜，实测排查成本极高。
+            uploadDiagnostics = failed.map((item) => ({
+                kind: item.kind,
+                error: item.reason || item.error || '未知',
+                httpStatus: item.httpStatus ?? null,
+                contentType: item.contentType || null,
+                hint: item.hint || null,
+                responsePreview: item.detail ? String(item.detail).slice(0, 300) : null,
+            }));
+            const reason = uploadDiagnostics
+                .map((item) => {
+                const bits = [`${item.kind}:${item.error}`];
+                if (item.httpStatus)
+                    bits.push(`HTTP ${item.httpStatus}`);
+                if (item.contentType && !/json/i.test(String(item.contentType))) {
+                    bits.push(`content-type=${item.contentType}`);
+                }
+                if (item.responsePreview)
+                    bits.push(`响应片段=${String(item.responsePreview).slice(0, 160)}`);
+                if (item.hint)
+                    bits.push(`提示=${item.hint}`);
+                return bits.join(' | ');
+            })
+                .join('；');
+            warnings.push(`附件上传失败（${reason}）：本地文件已生成（见 data.files），可在页面手动添加`);
+        }
+        if (uploadResult.skipped === 'NO_SESSION') {
+            warnings.push('未取得 E10 会话：附件未上传，产物按本地文件交付');
+        }
+    }
+    else if (noUpload) {
+        warnings.push('已按 --no-upload 跳过上传：页面上需要手动添加附件');
+    }
+    run.answers = answers;
+    run.data = data;
+    run.files = rendered.result.files || [];
+    // 记住快照路径，render 就不必再传一次
+    if (input.snapshot)
+        run.snapshotPath = input.snapshot;
+    if (uploadResult && uploadResult.base)
+        run.base = uploadResult.base;
+    if (attachment)
+        run.attachmentFileid = String(attachment.fileid);
+    if (attachments.length)
+        run.attachmentFileids = attachments;
+    saveRun(ctx.stateDir, run);
+    // 内部参考文档正文：直接带在回包里，让模型在对话中原样贴出。
+    // 否则模型会为了贴全文再单独读一次产物文件，白多一次工具往返；docx 是二进制，永远不要回读。
+    let internalDoc = null;
+    const mdFile = (rendered.result.files || []).find((file) => file.kind === 'md');
+    if (mdFile?.path) {
+        try {
+            internalDoc = {
+                name: basename(mdFile.path),
+                path: mdFile.path,
+                content: readFileSync(mdFile.path, 'utf8'),
+            };
+        }
+        catch {
+            // 读不到就当没生成，技能侧跳过这一段，不影响出件与填单
+            internalDoc = null;
+        }
+    }
+    return {
+        state: 'doc-ready',
+        ok: true,
+        data: {
+            runId: run.runId,
+            rebuilt,
+            files: (rendered.result.files || []).map((file) => ({ kind: file.kind, path: file.path, size: file.size })),
+            internalDoc,
+            attachment,
+            attachments,
+            attachmentPending: attachments.length === 0,
+            uploadDiagnostics,
+            qa: rendered.result.qa || {},
+            verify: rendered.result.verify || {},
+            timings: {
+                docxMs,
+                mdMs,
+                uploadMs,
+                parallelMs: rendered.parallelMs,
+                totalMs: Date.now() - startedAt,
+            },
+        },
+        warnings,
+        next: {
+            command: `weaver-work-cli reception render --run-id ${run.runId}`,
+            reason: '附件 fileid 已写入 run，render 会自动带上',
+        },
+    };
+}
+export const docOperation = {
+    execute: (input, ctx) => doc(input, ctx),
+};

package/dist/shortcuts/reception/operations/docrender.js

@@ -0,0 +1,36 @@
+import { doc } from './doc.js';
+import { render } from './render.js';
+/**
+ * reception.docRender —— 一次调用完成「出文件 + 传附件 + 拼填单参数 + 落 browsertool」。
+ *
+ * 为什么合并：`doc` 与 `render` 之间没有人工确认点，拆两次只会多付一次工具往返
+ * （宿主侧单次 3~5 秒），而 CLI 内部这两步加起来只有几百毫秒。
+ *
+ * 失败语义与分开调用**完全一致**，不因为合并而改变：
+ * - `doc` 失败（快照缺失 / render.py 缺失 / python-docx 缺失）→ 直接返回 doc 的错误，不继续 render；
+ * - 附件上传失败**不算** doc 失败（只进 `warnings` + `uploadDiagnostics`），`customParams` 照常产出；
+ * - `render` 失败 → 返回 render 的错误，此时文件已生成，回包里仍带 `files`。
+ */
+export async function docRender(input, ctx) {
+    const docResult = await doc(input, ctx);
+    if (!docResult.ok)
+        return docResult;
+    const runId = String((docResult.data || {}).runId || input.runId || '');
+    // answers / snapshotPath 已经由 doc 写进 run，这里只传 runId；
+    // sdkRender 属于 render 自己的入参，透传即可。
+    const renderResult = await render({ runId, sdkRender: input.sdkRender }, ctx);
+    return {
+        state: renderResult.state,
+        ok: renderResult.ok,
+        data: {
+            ...docResult.data,
+            ...renderResult.data,
+            runId,
+        },
+        warnings: [...(docResult.warnings || []), ...(renderResult.warnings || [])],
+        next: renderResult.next,
+    };
+}
+export const docRenderOperation = {
+    execute: (input, ctx) => docRender(input, ctx),
+};

package/dist/shortcuts/reception/operations/panels.js

@@ -0,0 +1,179 @@
+import { CUSTOMER_NEED_OPTIONS, LOGISTICS_FIELDS, LOGISTICS_HINT, LOGISTICS_LABEL, LOGISTICS_PLACEHOLDER, LOGISTICS_TITLE, } from '../constants.js';
+/**
+ * 后勤与人数自由文本 → 6 个子项。
+ *
+ * 用户手写格式不可控，这里只做"能认就认"，认不出的子项由调用方按原文进待办，
+ * 绝不追问第二轮。
+ */
+export function parseLogistics(text) {
+    const raw = String(text || '').trim();
+    if (!raw)
+        return {};
+    const out = {};
+    if (/^(暂未确定|待定|都不确定|还没定|都没定)/.test(raw))
+        return out;
+    // 用户没改灰字直接提交：整串都是字段名、且一个数字都没有 → 视为未填，不产脏数据
+    const FIELD_HINTS = ['客户人数', '是否会议', '是否接送', '是否用餐', '是否代订住宿', '是否伴手礼', '陪同人员手机号'];
+    if (!/\d/.test(raw) && FIELD_HINTS.filter((word) => raw.includes(word)).length >= 2)
+        return out;
+    // 手机号：11 位，可能写在这段话的任意位置；单独取出，由 mergeAnswers 挂到接待人身上
+    const mobile = raw.match(/(?<!\d)1[3-9]\d{9}(?!\d)/);
+    if (mobile)
+        out.mobile = mobile[0];
+    // 编号（①②③ / 1） / (1) / 1. / 1、）一律当分隔；换行、句号、顿号也算
+    const segs = raw
+        .replace(/[①②③④⑤⑥⑦⑧⑨]/g, '\n')
+        .replace(/[（(]\s*\d\s*[)）]/g, '\n')
+        .replace(/(^|[\s｜|;；,，。])\d\s*[.)）、]/g, '\n')
+        .replace(/总部\s*(\d{3})/g, '总部$1')
+        .replace(/(\d)\s*[人名位]/g, '$1人')
+        .replace(/(\d)\s*间/g, '$1间')
+        .split(/[\n｜|;；,，。、]+/)
+        .map((item) => item.trim())
+        .filter(Boolean);
+    for (const part of segs) {
+        // 一个片段可能同时含多个子项（如「10人 总部130会议室」），因此逐项独立判断，不 continue
+        if (!out.meetingRoom) {
+            // 兼容「总部131」「131会议室」「总部131会议室」三种写法；
+            // 数字前后不能紧邻数字，否则会从手机号里捞出 131。
+            const room = part.match(/(?:总部\s*)?(?<!\d)(129|130|131)(?!\d)\s*会议室/)
+                || part.match(/总部\s*(?<!\d)(129|130|131)(?!\d)/);
+            if (room)
+                out.meetingRoom = `总部${room[1]}会议室`;
+            else if (/(不需要|不用|无需|没有)会议室/.test(part))
+                out.meetingRoom = '不需会议室';
+            else {
+                const named = part.match(/([\u4e00-\u9fa5]{2,8}会议室)/);
+                if (named)
+                    out.meetingRoom = named[1];
+            }
+        }
+        if (!out.headcount) {
+            const band = part.match(/(5人以内|6-10人|11-20人|20人以上)/);
+            if (band) {
+                out.headcount = band[1] === '5人以内' ? 5 : band[1] === '6-10人' ? 6 : band[1] === '11-20人' ? 11 : 20;
+                out.headcountBand = band[1];
+            }
+            else {
+                const exact = part.match(/(\d{1,3})\s*人/);
+                if (exact)
+                    out.headcount = Number(exact[1]);
+            }
+        }
+        if (!out.meal) {
+            if (/(不用餐|不需要用餐|不吃饭|吃过再来)/.test(part))
+                out.meal = '不用餐';
+            else if (/(午餐|晚餐|中饭|午饭|晚饭|食堂|小餐厅|外部餐厅|餐厅)/.test(part))
+                out.meal = part;
+        }
+        if (!out.hotel) {
+            if (/(无需住宿|不需要住宿|不用住宿|不住|不用订房|当天往返|不需住宿)/.test(part))
+                out.hotel = '无需住宿';
+            else if (/(住宿|订房|间房|住\s*\d*\s*晚|\d+\s*晚)/.test(part))
+                out.hotel = part;
+        }
+        if (!out.pickup) {
+            // 「不用车」「不用接」= 不需要安排车，归一到「客户自行前往」
+            if (/(自行前往|自驾|自己过去|不用接|不需要接|不用车|不需要用车|无需用车|不用派车)/.test(part)) {
+                out.pickup = '客户自行前往';
+            }
+            else if (/(接站|接机|用车|派车|商务车|大巴|司机|接送|高铁)/.test(part)) {
+                out.pickup = part;
+            }
+        }
+        if (!out.gift) {
+            // 兼顾客语序：「不用伴手礼」与「伴手礼不用」都要认
+            if (/(不需要伴手礼|无需伴手礼|不用伴手礼|不送|不用礼品|伴手礼(不用|不需要|免)|礼品(不用|不需要))/.test(part)) {
+                out.gift = '不需要伴手礼';
+            }
+            else if (/(伴手礼|纪念品|礼品|礼盒)/.test(part)) {
+                out.gift = part;
+            }
+        }
+    }
+    return out;
+}
+/** 手机号只挂到第一个陪同（接待人）身上；没有陪同就只存 data.mobile，不编造人员。 */
+export function setCompanionMobile(data, mobile) {
+    const value = String(mobile || '').trim();
+    if (!value)
+        return;
+    const list = Array.isArray(data.companions) ? data.companions.slice() : [];
+    if (list.length) {
+        const first = typeof list[0] === 'string' ? { name: list[0] } : { ...list[0] };
+        first.mobile = value;
+        list[0] = first;
+        data.companions = list;
+    }
+    else {
+        data.mobile = value;
+    }
+}
+/** 合并 run 上下文与 ask_user 的 answers。 */
+export function mergeAnswers(run, answers = {}) {
+    const data = { ...(run.data || {}) };
+    if (answers && typeof answers === 'object') {
+        if (answers.fields && typeof answers.fields === 'object')
+            Object.assign(data, answers.fields);
+        if (answers.customer_need)
+            data.demand = String(answers.customer_need);
+        if (answers.logistics) {
+            const raw = String(answers.logistics).trim();
+            if (raw) {
+                // 原文留存：手动输入格式不可控，解析不到的子项靠它兜底（交付时原样透出，不丢信息）
+                data.logisticsRaw = raw;
+                const parsed = parseLogistics(raw);
+                const mobile = parsed.mobile;
+                delete parsed.mobile;
+                Object.assign(data, parsed);
+                if (mobile)
+                    setCompanionMobile(data, mobile);
+            }
+        }
+        // 兼容旧口径：独立手机号面板传进来的值（新流程已并进 logistics）
+        if (answers.companion_mobile)
+            setCompanionMobile(data, answers.companion_mobile);
+    }
+    return data;
+}
+/**
+ * 面板由 CLI 生成，模型原样传给 ask_user。
+ *
+ * 硬约束（宿主实测）：title 严格单行、超长截断成「…」；placeholder 正常渲染；hint 不渲染。
+ * 因此标题只留一句短话，完整清单放 placeholder，口径放 hint。
+ * 总屏数 ≤ 2（客户需求 1 + 接待细节 1），手机号并入接待细节，不单独出屏。
+ */
+export function buildPanels(data) {
+    const panels = [];
+    if (!data.demand) {
+        panels.push({
+            id: 'customer_need',
+            // 同样受「标题单行」约束：不写 ①②③ 追问清单，只留一句
+            title: '客户需求（选一个，也可自己写）',
+            inputType: 'single',
+            required: false,
+            allowCustomInput: true,
+            options: CUSTOMER_NEED_OPTIONS.map((item) => ({ label: item, value: item })),
+        });
+    }
+    const missing = LOGISTICS_FIELDS.filter((key) => !data[key]);
+    const mobile = ((data.companions || []).find((item) => item && item.mobile) || {}).mobile || '';
+    if (missing.length || !mobile) {
+        const known = LOGISTICS_FIELDS
+            .filter((key) => data[key])
+            .map((key) => `${LOGISTICS_LABEL[key]}：${data[key]}`);
+        if (mobile)
+            known.push(`${LOGISTICS_LABEL.mobile}：${mobile}`);
+        panels.push({
+            id: 'logistics',
+            // 标题严格单行：不拼字段清单、不拼已识别项、不讲规则——拼了必被截断成「…」
+            title: LOGISTICS_TITLE,
+            inputType: 'text',
+            required: false,
+            allowCustomInput: true,
+            hint: known.length ? `已识别：${known.join('；')}\n补没写的就行。\n${LOGISTICS_HINT}` : LOGISTICS_HINT,
+            placeholder: LOGISTICS_PLACEHOLDER,
+        });
+    }
+    return panels;
+}

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

@@ -0,0 +1,26 @@
+import { askOperation } from './ask.js';
+import { docOperation } from './doc.js';
+import { docRenderOperation } from './docrender.js';
+import { renderOperation } from './render.js';
+/**
+ * operation 名 → handler。
+ *
+ * 四个：ask / doc / render 是既有链路，docRender 是「doc + render 一次跑完」的合并入口
+ * （两者之间没有人工确认点，拆两次纯属白付一次工具往返）。
+ * 兜底链路（prepare/build/submit）已随独立 reception CLI 退役：
+ * 真需要写流程时直接调 `weaver-work-cli workflow`，不必在这里再包一层。
+ */
+const REGISTRY = new Map([
+    ['reception.ask', askOperation],
+    ['reception.doc', docOperation],
+    ['reception.docRender', docRenderOperation],
+    ['reception.render', renderOperation],
+]);
+export function getReceptionOperation(name) {
+    const hit = REGISTRY.get(name);
+    if (!hit) {
+        throw new Error(`未知 operation: ${name}（可用：${[...REGISTRY.keys()].join(' / ')}）`);
+    }
+    return hit;
+}
+export const receptionOperationNames = [...REGISTRY.keys()];