weaver-work-cli 0.1.36 → 0.1.39

package/dist/shortcuts/meeting/operations/eb/crm-search.js

@@ -0,0 +1,478 @@
+import { meetingSuccess, schemaOf } from '../types.js';
+import { meetingValidationError } from '../../errors.js';
+/**
+ * 客户（CRM 主数据）模糊查询（EB 版会议链路用）。
+ *
+ * 数据来源：ESB 动作流 `esbFlowId=904205116264026112`，请求体：
+ *   `{ customParams: { mainTable: { custom_name: "<客户名片段>" } }, esbFlowId }`
+ * 返回 `customData.mainTable = { mc, sjID }`：`sjID`=客户 id，`mc`=客户名称。
+ *
+ * ✅ 入参字段名就是 `custom_name`（2026-10-31 真机定案，**不要再猜 mc/khmc/customerName**）：
+ *   泛微 → {mc:"泛微", sjID:"1331361148057387759"}
+ *   腾讯 → {mc:"深圳市腾讯斐泰科技有限公司", sjID:"1320482515670098010"}
+ *   不存在的客户XYZ → {mc:"", sjID:""}（空行，不是报错）
+ * 之前误判「入参模板为空所以传什么都进不去」的原因：`esb.input-format`（copyCustomData）对这个动作流
+ * 返回 `customParams: null` —— 那是「**没有自定义入参模板 = 透传**」，不是「模板是空对象 = 丢弃入参」。
+ * ⇒ 模板为 null 时照常发参数（默认字段名 `custom_name`）；只有模板明确是 `mainTable: {}` 才判阻塞。
+ *
+ * ⛔ 三个真机事实（写业务逻辑必须按这个来）：
+ * 1. **一次只回 1 条**：该动作流是「按名称模糊匹配并取首个命中」，加 `pageSize`/`rows` 都不改变结果；
+ *    所以"模糊查 10 条"在服务端做不到，`limit` 只是本地上限。返回 1 条 ≠ 库里只有 1 个匹配，
+ *    名称与关键字不完全一致时**必须回问用户确认**，不能拿首个匹配直接写 `crm_members`。
+ * 2. **`hasData` 恒为 0**，命中时也是 0 ⇒ **不能**用它判断"没有这个客户"，判空只看 `mc`/`sjID` 是否为空。
+ * 3. 匹配是「包含」关系：`斐泰` 能命中「深圳市腾讯斐泰科技有限公司」；给全称则 id 稳定。
+ *
+ * 出参解析仍做多形态兼容（动作流改成回列表也不用改代码）：
+ *   customData.mainTable 单条 / mainTable.<list|rows|items|data…> / detail1|detail2…
+ * 每行按 `sjID`（客户 id）与 `mc`（名称）取值，兼容 id/customerId、name/sjmc 等别名。
+ */
+/** 用户指定的客户查询动作流（可在入参里覆盖，换环境时不用改代码）。 */
+const DEFAULT_CRM_FLOW_ID = '904205116264026112';
+/** 该动作流的「客户名称」入参字段（2026-10-31 真机确认，模板为 null 时也用它）。 */
+const DEFAULT_KEYWORD_FIELD = 'custom_name';
+/** 入参里「客户名称」字段的候选名，按优先级挑；模板没配时兜底用 `custom_name`。 */
+const KEYWORD_FIELD_HINTS = [
+    'custom_name', 'mc', 'sjmc', 'khmc', 'customerName', 'customer_name', 'clientName', 'name', 'keyword', 'keywordName', 'searchKey',
+];
+/** 出参里「客户 id」字段的候选名。 */
+const ID_KEYS = ['sjID', 'sjid', 'sj_id', 'sjjId', 'customerId', 'custId', 'clientId', 'id'];
+/** 出参里「客户名称」字段的候选名。 */
+const NAME_KEYS = ['mc', 'sjmc', 'sj_name', 'customerName', 'custName', 'clientName', 'name'];
+/** customData 下可能承载列表的字段名。 */
+const LIST_KEYS = [
+    'detail1', 'detail2', 'detail3', 'detail', 'details', 'detailList',
+    'list', 'rows', 'items', 'data', 'records', 'result', 'customers', 'sjList',
+];
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+function pickFirst(row, keys) {
+    for (const key of keys) {
+        const value = row[key];
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === 'object') {
+            const nested = asRecord(value);
+            if (nested) {
+                const inner = pickFirst(nested, keys) || pickFirst(nested, ['id', 'name']);
+                if (inner)
+                    return inner;
+            }
+            continue;
+        }
+        const text = String(value).trim();
+        if (text !== '')
+            return text;
+    }
+    return '';
+}
+/** 明细行常被包成 `{ mainTable: {...} }`，统一剥一层。 */
+function unwrapRow(value) {
+    const record = asRecord(value);
+    if (!record)
+        return null;
+    const main = asRecord(record.mainTable);
+    return main ?? record;
+}
+/** 从 customData 里挖出所有可能承载客户行的候选数组。 */
+function collectCandidateLists(customData) {
+    const found = [];
+    const main = asRecord(customData.mainTable);
+    if (main) {
+        // ① 单条：mainTable 自己就是一行。即使 mc/sjID 都是空串也放进来，
+        //    让 normalizeCustomers 丢掉后落到「没有匹配到客户」，而不是误报「结构不认识」
+        found.push({ source: 'customData.mainTable', rows: [main] });
+        // ② mainTable 里再套一层列表
+        for (const key of LIST_KEYS) {
+            const value = main[key];
+            if (Array.isArray(value))
+                found.push({ source: `customData.mainTable.${key}`, rows: value });
+        }
+    }
+    // ③ customData 直属列表（detail1 等）
+    for (const key of LIST_KEYS) {
+        const value = customData[key];
+        if (Array.isArray(value))
+            found.push({ source: `customData.${key}`, rows: value });
+    }
+    return found;
+}
+/** 客户行里「联系人明细 / 地址明细」的候选字段名（ESB 动作流输出）。 */
+const CONTACT_LIST_KEYS = ['lxr', 'contacts', 'contactList', 'lxrList'];
+const ADDRESS_LIST_KEYS = ['khdz', 'addresses', 'addressList', 'dz'];
+/**
+ * 联系人字段候选名。第一项是 e-cology 当前客户表单的真机字段 id（2026-10-31 抓取），
+ * 后面的泛化名用于换租户；都取不到时按值的形态猜（见 parseCrmContacts）。
+ */
+const CONTACT_NAME_KEYS = ['field_1173221220888062706', 'xm', 'lxrxm', 'contactName', 'name'];
+const CONTACT_MOBILE_KEYS = ['field_1173221220888062708', 'sjhm', 'mobile', 'phone', 'tel', 'lxrdh'];
+const CONTACT_DEPT_KEYS = ['field_1173221220888062707', 'bm', 'dept', 'department', 'bmmc'];
+const MOBILE_RE = /^[+\d][\d\s-]{6,}$/;
+const DEPT_RE = /(部|科|处|室|中心|事业部|分公司|集团|公司)$/;
+/** 取行里第一个数组型字段（`lxr` / `khdz` 这类明细）。 */
+function pickRawList(row, keys) {
+    for (const key of keys) {
+        if (Array.isArray(row[key]))
+            return row[key];
+    }
+    return undefined;
+}
+/**
+ * 解析 ESB `lxr` 明细 → 联系人数组。
+ *
+ * 真机形状（e-cology，2026-10-31）：
+ * ```json
+ * [{"subForm_1173221220888060716":"477618176453313734",
+ *   "field_1173221220888062706":"利明",       // 姓名
+ *   "field_1173221220888062708":"11111111111", // 手机号
+ *   "field_1173221220888062707":"信息部"}]     // 部门
+ * ```
+ */
+export function parseCrmContacts(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const item of raw) {
+        const row = asRecord(item);
+        if (!row)
+            continue;
+        const entries = Object.entries(row).filter(([key, value]) => !key.startsWith('subForm') && value !== null && value !== undefined && String(value).trim() !== '');
+        if (entries.length === 0)
+            continue;
+        const pick = (keys) => {
+            for (const key of keys) {
+                const hit = entries.find(([k]) => k === key);
+                if (hit)
+                    return String(hit[1]).trim();
+            }
+            return '';
+        };
+        let name = pick(CONTACT_NAME_KEYS);
+        let mobile = pick(CONTACT_MOBILE_KEYS);
+        let dept = pick(CONTACT_DEPT_KEYS);
+        // 兜底：字段 id 换租户会变，按值的形态补空缺（手机号像号码、部门带「部/室/中心」结尾）
+        for (const [, value] of entries) {
+            const text = String(value).trim();
+            if (text === '')
+                continue;
+            if (!mobile && MOBILE_RE.test(text)) {
+                mobile = text;
+                continue;
+            }
+            if (!name && !DEPT_RE.test(text) && !/^\d+$/.test(text)) {
+                name = text;
+                continue;
+            }
+            if (!dept && DEPT_RE.test(text))
+                dept = text;
+        }
+        if (name === '' && mobile === '')
+            continue;
+        // ESB 明细里同一个人常重复出现（同一联系人多条业务记录），按「姓名+手机号」去重
+        const dedupeKey = `${name}|${mobile}`;
+        if (seen.has(dedupeKey))
+            continue;
+        seen.add(dedupeKey);
+        out.push({ name, mobile, ...(dept === '' ? {} : { dept }) });
+    }
+    return out;
+}
+/**
+ * 解析 ESB `khdz` 明细 → 地址字符串数组。
+ *
+ * ⛔ 当前动作流只回明细行 id（`{"subForm_…715":"5756415858274037939"}`），**没有地址文本**，
+ * 所以这里正常返回空数组；`addressHint` 会提示 ESB 侧补地址字段。
+ */
+export function parseCrmAddresses(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        const row = asRecord(item);
+        if (!row)
+            continue;
+        const parts = Object.entries(row)
+            .filter(([key, value]) => !key.startsWith('subForm') && value !== null && value !== undefined
+            && String(value).trim() !== '')
+            .map(([, value]) => String(value).trim());
+        if (parts.length > 0)
+            out.push(parts.join(' '));
+    }
+    return out;
+}
+/** 把任意行数组转成客户数组（去重、丢空行）。 */
+export function normalizeCustomers(rows, limit) {
+    const seen = new Map();
+    for (const raw of rows) {
+        const row = unwrapRow(raw);
+        if (!row)
+            continue;
+        const customerId = pickFirst(row, ID_KEYS);
+        const name = pickFirst(row, NAME_KEYS);
+        // 客户 id 与名称都为空 = 输出模板的占位空行，直接丢
+        if (customerId === '' && name === '')
+            continue;
+        // 有 id 没名字说明动作流没把名称带出来，仍保留（调用方至少能按 id 用）
+        const key = customerId !== '' ? customerId : `name:${name}`;
+        if (seen.has(key))
+            continue;
+        // 联系人与地址是客户行里的明细数组（lxr / khdz），不是客户列表本身 —— 别被 collectCandidateLists 当行用
+        const contacts = parseCrmContacts(pickRawList(row, CONTACT_LIST_KEYS));
+        const addresses = parseCrmAddresses(pickRawList(row, ADDRESS_LIST_KEYS));
+        seen.set(key, {
+            customerId,
+            name,
+            ...(contacts.length > 0 ? { contacts } : {}),
+            ...(addresses.length > 0 ? { addresses } : {}),
+        });
+    }
+    const all = [...seen.values()];
+    const total = all.length;
+    return { items: limit > 0 ? all.slice(0, limit) : all, total };
+}
+/**
+ * 解析 ESB 触发结果 → 客户列表。
+ *
+ * 导出便于单测：动作流输出结构变了只改这里，不用真机验证。
+ */
+export function parseCrmSearchPayload(actionData, options) {
+    const action = asRecord(actionData) ?? {};
+    const responseData = asRecord(action.responseData) ?? {};
+    const customData = asRecord(responseData.customData) ?? {};
+    const rawHasData = action.hasData;
+    const hasData = rawHasData === undefined || rawHasData === null ? null : Number(rawHasData) > 0;
+    const templateFields = options.templateFields ?? [];
+    const base = {
+        keyword: options.keyword,
+        limit: options.limit,
+        total: 0,
+        items: [],
+        truncated: false,
+        source: 'customData',
+        hasData,
+        exact: false,
+        singleBestMatch: false,
+        message: '',
+        templateFields,
+        keywordField: options.keywordField ?? null,
+    };
+    // 只有「模板存在且是空对象」才判阻塞：那种情况下参数会被服务端丢弃，返回什么都不可信
+    if (options.templateBlocked === true) {
+        return {
+            ...base,
+            blocked: 'esb_template_empty',
+            message: '动作流配了「自定义入参模板」但主表字段为空（customParams.mainTable = {}），'
+                + '触发时传入的查询条件会被丢弃，因此查不到客户。'
+                + '需要先在 ESB 设计器里给该动作流补入参（`custom_name` 客户名称）后再查。',
+        };
+    }
+    const lists = collectCandidateLists(customData);
+    const best = lists
+        .map((item) => ({ ...item, normalized: normalizeCustomers(item.rows, options.limit) }))
+        .sort((a, b) => b.normalized.total - a.normalized.total)[0];
+    if (!best) {
+        return {
+            ...base,
+            message: '动作流返回里没有可识别的客户结构（既没有 mainTable 行，也没有 detail/list 之类的列表），'
+                + '请检查动作流的输出模板是否仍输出 sjID/mc',
+        };
+    }
+    if (best.normalized.total === 0) {
+        // ⛔ hasData 恒 0，不能用它下结论；空 mc/sjID 空行才是「没匹配到」
+        return {
+            ...base,
+            source: best.source,
+            message: `按「${options.keyword}」没有匹配到客户（动作流返回空行）`,
+        };
+    }
+    const items = best.normalized.items;
+    const singleBestMatch = best.normalized.total === 1;
+    const exact = singleBestMatch && items[0].name === options.keyword;
+    // 客户地址：动作流配了 khdz 却只回明细行 id 时，说清楚是「输出缺字段」而不是「这个客户没地址」
+    const rawAddress = pickRawList(best.rows[0], ADDRESS_LIST_KEYS);
+    const addressHint = Array.isArray(rawAddress) && rawAddress.length > 0 && (items[0].addresses?.length ?? 0) === 0
+        ? `动作流的「客户地址」（khdz）只回了 ${rawAddress.length} 条明细行 id，没有地址文本 —— `
+            + '需要在 ESB 输出模板里补上地址字段（如 详细地址/省市区），否则邀请函和明细表里拿不到地址。'
+        : undefined;
+    return {
+        ...base,
+        items,
+        total: best.normalized.total,
+        truncated: best.normalized.total > options.limit,
+        source: best.source,
+        exact,
+        singleBestMatch,
+        ...(addressHint ? { addressHint } : {}),
+        message: exact
+            ? `精确命中客户「${items[0].name}」（${items[0].customerId}）`
+            : `按「${options.keyword}」模糊命中 ${best.normalized.total} 个客户`
+                + (singleBestMatch ? '（动作流只回首个匹配）' : '')
+                + (best.normalized.total > options.limit ? `，已按 limit=${options.limit} 截断` : ''),
+    };
+}
+/** 从模板里挑「客户名称」入参字段名。 */
+export function pickKeywordField(templateMainTable) {
+    const keys = Object.keys(templateMainTable ?? {});
+    if (keys.length === 0)
+        return null;
+    for (const hint of KEYWORD_FIELD_HINTS) {
+        const hit = keys.find((key) => key.toLowerCase() === hint.toLowerCase());
+        if (hit)
+            return hit;
+    }
+    // 模板里只有一个客制化字段时，它就是查询条件
+    return keys.length === 1 ? keys[0] : null;
+}
+/** 从模板里挑「每页条数」字段名（有的动作流用 pageSize / limit / rows）。 */
+function pickLimitField(templateMainTable) {
+    const keys = Object.keys(templateMainTable ?? {});
+    const hints = ['pageSize', 'pagesize', 'limit', 'rows', 'size', 'num'];
+    for (const hint of hints) {
+        const hit = keys.find((key) => key.toLowerCase() === hint.toLowerCase());
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+async function runCrmSearchFlow(env, input) {
+    const session = await env.host.getSession();
+    const employeeId = String(input.employeeId ?? session?.userId ?? '').trim();
+    if (!employeeId) {
+        throw meetingValidationError('crm_employee_required', '取不到当前登录用户 id，无法触发 ESB 客户查询');
+    }
+    const { createEsbHost } = await import('../../../esb/host.js');
+    const { createEsbContinuationSigner } = await import('../../../esb/continuation.js');
+    const { getEsbOperation } = await import('../../../esb/operations/registry.js');
+    const esbEnv = {
+        ctx: env.ctx,
+        host: createEsbHost(env.ctx),
+        continuation: createEsbContinuationSigner(env.ctx),
+    };
+    const templateOp = getEsbOperation('esb.input-format');
+    const prepareOp = getEsbOperation('esb.trigger.prepare');
+    const applyOp = getEsbOperation('esb.trigger.apply');
+    // ① 先读模板：只为决定「用哪个入参字段名」。
+    //    customParams=null = 没配模板 = 透传（照常发参数）；mainTable={} 才是「模板空、入参被丢弃」
+    let templateMainTable = null;
+    let customParamsTemplate = null;
+    let templateReadOk = false;
+    try {
+        const template = await templateOp.handler({ applicationId: input.flowId }, esbEnv);
+        customParamsTemplate = asRecord(template?.data?.customParams);
+        templateMainTable = asRecord(customParamsTemplate?.mainTable);
+        templateReadOk = true;
+    }
+    catch {
+        // 读模板失败不阻塞查询，按默认字段名（custom_name）试
+    }
+    const templateFields = Object.keys(templateMainTable ?? {});
+    const templateBlocked = templateReadOk && customParamsTemplate !== null && templateFields.length === 0;
+    const keywordField = pickKeywordField(templateMainTable) ?? DEFAULT_KEYWORD_FIELD;
+    const limitField = pickLimitField(templateMainTable);
+    const mainTable = {};
+    mainTable[keywordField] = input.keyword;
+    if (limitField)
+        mainTable[limitField] = input.limit;
+    const pre = await prepareOp.handler({
+        esbFlowId: input.flowId,
+        employeeId,
+        customParams: { mainTable },
+    }, esbEnv);
+    const applied = await applyOp.handler({ continuation: pre?.data?.continuation, confirm: true }, esbEnv);
+    const actionData = applied?.data?.actionData;
+    const parsed = parseCrmSearchPayload(actionData, {
+        keyword: input.keyword,
+        limit: input.limit,
+        templateFields,
+        keywordField,
+        templateBlocked,
+    });
+    if (actionData && typeof actionData === 'object') {
+        // reminder 是数字枚举，0=无提示；String(0) 非空，别当成提示文案
+        const reminder = actionData.reminder;
+        const reminderText = reminder === undefined || reminder === null ? '' : String(reminder);
+        if (reminderText !== '' && reminderText !== '0')
+            parsed.actionMessage = reminderText;
+    }
+    return { result: parsed, raw: applied?.data };
+}
+const ebCrmSearch = {
+    name: 'meeting.eb.crm.search',
+    resource: 'eb',
+    method: 'meeting.eb.crm.search',
+    action: 'meeting.eb.crm.search',
+    summary: '按客户名称查询 CRM 客户（ESB 动作流 904205116264026112，入参 custom_name，出参 sjID/mc）；'
+        + '动作流一次只回首个匹配，名称不完全一致时须回问用户确认',
+    capability: 'eb.crm',
+    risk: 'read',
+    inputSchema: schemaOf({
+        keyword: {
+            type: 'string',
+            minLength: 1,
+            description: '客户名称，走动作流入参 custom_name（包含匹配）：给全称最稳，片段只回首个匹配',
+        },
+        limit: { type: 'number', description: '返回条数上限，默认 10（当前动作流一次只回 1 条，仅作兼容）' },
+        flowId: { type: 'string', description: '覆盖 ESB 动作流 id（默认 904205116264026112）' },
+        employeeId: { type: 'string', description: '覆盖触发人员 id（默认当前登录用户）' },
+        includeRaw: { type: 'boolean', description: 'true=附带 ESB 原始返回，便于排查输出结构' },
+    }, { required: ['keyword'] }),
+    handler: async (args, env) => {
+        const keyword = String(args.keyword ?? '').trim();
+        if (!keyword) {
+            throw meetingValidationError('crm_keyword_required', 'keyword 不能为空（客户名称关键字）');
+        }
+        const limitRaw = Number(args.limit ?? 10);
+        const limit = Number.isFinite(limitRaw) && limitRaw > 0 ? Math.min(Math.floor(limitRaw), 100) : 10;
+        const { result, raw } = await runCrmSearchFlow(env, {
+            keyword,
+            limit,
+            flowId: String(args.flowId ?? '').trim() || DEFAULT_CRM_FLOW_ID,
+            ...(args.employeeId ? { employeeId: String(args.employeeId) } : {}),
+        });
+        const warnings = [];
+        if (result.blocked === 'esb_template_empty') {
+            warnings.push(result.message);
+            warnings.push('⛔ 不要回复「没有这个客户」：这是动作流入参模板未配置，属于配置问题。');
+        }
+        else if (result.items.length === 0) {
+            warnings.push(`按「${keyword}」没有匹配到客户；可换更短的关键字（去掉地域/后缀），`
+                + '或确认该客户是否已在 CRM 建档（这是「查无」，可以如实回复用户）。');
+        }
+        else if (!result.exact) {
+            warnings.push(`动作流一次只回首个匹配：「${result.items[0].name}」（${result.items[0].customerId}），`
+                + `与「${keyword}」不完全一致。请把**命中全名原样念出来问"是这家吗"**，用户认了再把该 id `
+                + '写进 create.flow.prepare 的 crm_members，不要猜。'
+                + '⛔ 不要问成"填进参会客户字段还是只写进会议内容备注"这种选择题 —— 客户一律要关联客户档案，'
+                + '"只写备注"是明令禁止的做法。');
+        }
+        if (result.items.some((item) => item.name === '')) {
+            warnings.push('有客户只返回了 sjID 没返回 mc（名称），请让动作流输出 mc 字段。');
+        }
+        const firstCustomer = result.items[0];
+        if (firstCustomer) {
+            const contacts = firstCustomer.contacts ?? [];
+            if (contacts.length > 0) {
+                // ⛔ 2026-10-31 用户纠正：有几位就**全带几位**，不要弹「选哪位」的框。
+                //    "该客户有 3 位联系人，本次参会客户联系人选哪位" 这种选择框是多余的 ——
+                //    明细表本来就是多行结构，一人一行全写进去即可；只有用户明确说"只写某某"才覆盖。
+                warnings.push(`该客户有 ${contacts.length} 位联系人：`
+                    + contacts.map((c) => `${c.name}${c.dept ? `（${c.dept}）` : ''} ${c.mobile || '无手机号'}`).join('、')
+                    + '。建会时传 `crm_members` 就会把这**全部联系人自动写成「参会客户明细」行**（一人一行），'
+                    + '⛔ 不要问用户"选哪位"、也不要只带其中一位；'
+                    + '只有用户明确说"只写某某"时才用 '
+                    + 'crm_member_details:[{"xm":"<姓名>","sjhm":"<手机号>","zw":"<部门或职位>"}] 覆盖。');
+            }
+            else {
+                warnings.push('该客户**没有联系人**（动作流未输出 lxr，或该客户没建档联系人）—— 这是唯一需要问联系人的场景。'
+                    + '可以问用户「要不要补一下联系人姓名和手机号（方便的话再给职位）」，'
+                    + '再以 crm_member_details:[{"xm":"张三","sjhm":"13800000000"}] 传给 create.flow.prepare/quick；'
+                    + '用户说"没有"就留空，不要硬编。');
+            }
+            if (result.addressHint)
+                warnings.push(result.addressHint);
+        }
+        return meetingSuccess('meeting.eb.crm.search', { ...result, ...(args.includeRaw === true ? { raw } : {}) }, warnings.length > 0 ? { warnings } : {});
+    },
+};
+export const meetingEbCrmOperations = [ebCrmSearch];

package/dist/shortcuts/meeting/operations/eb/factory.js

@@ -7,6 +7,57 @@ import { isWriteKind } from './catalog.js';
 export const EB_BASE = '/api/ebuilder/form/formdata/v2';
 const EB_READ_OP = { list: 'getFormDataList', detail: 'getFormDataByPk', get: 'getFormDataList' };
 const EB_WRITE_OP = { create: 'saveFormData', update: 'updateFormData', delete: 'deleteFormData' };
+/** 详情里的人员类字段：值可能是员工 id，补一份姓名回显，别让调用方把 id 当成"没填/填错了"。 */
+const PERSONNEL_FIELDS = [
+    'caller', 'contacter', 'mt_creator', 'creator', 'updater',
+    'hrm_members', 'attend_user', 'inviters', 'reporting_user', 'topic_presenter',
+];
+/**
+ * 人员字段 id → 姓名。
+ *
+ * ⛔ 2026-10-31 用户反馈「联系人那一栏显示成一串数字」：detail 接口回的是**原始值**
+ * （页面建的单存 id、工作流建的单存姓名文本），调用方看到 id 就以为字段没填好。
+ * 这里只补一份 `personnelText`（字段名 → 姓名），**不动原字段**，避免破坏既有消费方。
+ */
+async function buildPersonnelText(env, data) {
+    const ids = [];
+    for (const key of PERSONNEL_FIELDS) {
+        const raw = String(data?.[key] ?? '').trim();
+        // 已经是姓名文本（含中文/括号）就不用查；纯数字与逗号才算 id 列表
+        if (raw === '' || !/^[\d,\s]+$/u.test(raw))
+            continue;
+        ids.push(...raw.split(',').map((one) => one.trim()).filter((one) => one !== ''));
+    }
+    if (ids.length === 0)
+        return {};
+    const names = new Map();
+    try {
+        const { hrmEmployeeOperations } = await import('../../../hrm/operations/employee.js');
+        const batch = hrmEmployeeOperations.find((operation) => operation.name === 'hrm.employee.batch');
+        if (batch) {
+            const result = await batch.handler({ ids: [...new Set(ids)] }, env);
+            for (const row of (result?.data?.rows ?? result?.data?.userList ?? [])) {
+                const id = String(row.id ?? '').trim();
+                const name = String(row.name ?? '').trim();
+                if (id && name)
+                    names.set(id, name);
+            }
+        }
+    }
+    catch {
+        return {};
+    }
+    const out = {};
+    for (const key of PERSONNEL_FIELDS) {
+        const raw = String(data?.[key] ?? '').trim();
+        if (raw === '' || !/^[\d,\s]+$/u.test(raw))
+            continue;
+        const mapped = raw.split(',').map((one) => names.get(one.trim()) ?? one.trim()).filter((one) => one !== '');
+        if (mapped.length > 0)
+            out[key] = mapped.join(',');
+    }
+    return out;
+}
 const CONTINUATION_TTL_SECONDS = 600;
 /**
  * EB 响应成功判定。
@@ -230,7 +281,15 @@ function buildReadOperation(endpoint) {
                             detailNodes[key] = value;
                     }
                 }
-                return meetingSuccess(endpoint.operation, { id, data, ...(Object.keys(detailNodes).length > 0 ? { details: detailNodes } : {}) }, endpoint.notes ? { meta: { notes: endpoint.notes } } : {});
+                const personnelText = endpoint.operation.startsWith('meeting.')
+                    ? await buildPersonnelText(env, data)
+                    : {};
+                return meetingSuccess(endpoint.operation, {
+                    id,
+                    data,
+                    ...(Object.keys(personnelText).length > 0 ? { personnelText } : {}),
+                    ...(Object.keys(detailNodes).length > 0 ? { details: detailNodes } : {}),
+                }, endpoint.notes ? { meta: { notes: endpoint.notes } } : {});
             }
             const query = {};
             for (const param of endpoint.queryParams ?? []) {

package/dist/shortcuts/meeting/operations/eb/index.js

@@ -6,6 +6,7 @@ import { ebMeetingAssociation } from './association.js';
 import { ebRoomRecommendOperation, recommendRooms, rememberFrequentRoom } from './room-recommend.js';
 import { meetingValidationError } from '../../errors.js';
 import { meetingEbScheduleOperations } from './schedule.js';
+import { meetingEbCrmOperations } from './crm-search.js';
 import { meetingEbCreateFlowOperations } from './create-flow.js';
 /**
  * 会议 EB 版（eBuilder）operations。
@@ -167,6 +168,7 @@ export const meetingEbOperations = [
     ...meetingEbConflictOperations,
     ...meetingEbDecisionOperations,
     ...meetingEbScheduleOperations,
+    ...meetingEbCrmOperations,
     ...meetingEbCreateFlowOperations,
     ebRoomRecommendOperation,
 ];