weaver-work-cli 0.1.40 → 0.1.42

package/dist/shortcuts/recruit-stage/shared.js

@@ -0,0 +1,608 @@
+/**
+ * recruit-stage 共享写操作库（自技能版 scripts/write-op.mjs 1:1 移植）。
+ *
+ * 封装 EB 写操作公共能力：表单/布局解析、saveFormData、runEsb、按钮配置解析
+ * （getFormButtons/getListButtons）。全部运行时解析，不写死 esbActionIds/表单 id；
+ * 认证由 CLI 宿主注入（host.request），环境上下文经 recruit-stage/context.ts 加载。
+ *
+ * 与脚本版的机制差异（其余逻辑逐行对应）：
+ * - 请求层：脚本版 request({path,body,...}) → host.request({path,body,...})；
+ *   401 判定/续期由 CLI 运行时统一处理；响应大整数已被 parseJsonPreservingBigInts
+ *   加引号保精度（脚本版"从原文提取 formDataIds"的兜底不再需要，但保留兼容读取）。
+ * - 环境缓存：脚本版 ensureEnvCache（<appId>.json）→ 复用 ehr 模块 RecruitContextLoader
+ *   （同构五层解析，磁盘缓存目录一致，可直接命中脚本版播种的缓存）。
+ */
+import { randomUUID } from 'node:crypto';
+import { rsFail } from './errors.js';
+export function randHex32() {
+    return randomUUID().replace(/-/g, '');
+}
+// 表单 objId（tag 解析，缓存优先）
+export function objIdOf(cache, key) {
+    const fo = cache.forms[key];
+    if (!fo?.objId)
+        throw rsFail('环境缓存缺少表单 ' + key + ' 的 objId（该表单可能未启用）');
+    return String(fo.objId);
+}
+export function formIdOf(cache, key) {
+    const fo = cache.forms[key];
+    if (!fo?.formId)
+        return objIdOf(cache, key);
+    return String(fo.formId);
+}
+// 表单布局完整数据：GET 优先，失败回退 POST（部分版本需 POST + module 参数，缺 module 会 500）
+// 进程内 memo：同 formId 同进程只拉一次（getFormLayout/getFormLayoutMeta 共享）；失败即剔除可重试
+const __layoutMemo = new Map();
+function fetchLayoutData(host, formId) {
+    if (!__layoutMemo.has(formId)) {
+        const p = fetchLayoutDataRaw(host, formId).catch((e) => { __layoutMemo.delete(formId); throw e; });
+        __layoutMemo.set(formId, p);
+    }
+    return __layoutMemo.get(formId);
+}
+async function fetchLayoutDataRaw(host, formId) {
+    try {
+        const r = await host.request({ path: '/api/ebuilder/form/form/core/getFormLayout?formId=' + formId, method: 'GET' });
+        if (r?.data)
+            return r.data;
+    }
+    catch { /* 回退 POST */ }
+    try {
+        const r = await host.request({
+            path: '/api/ebuilder/form/form/core/getFormLayout',
+            method: 'POST',
+            body: { module: 'ebuilderform', formId, terminalType: 'PC' },
+        });
+        if (r?.data)
+            return r.data;
+    }
+    catch { /* ignore */ }
+    return null;
+}
+// 表单布局 id：布局数据 formLayout.id；失败回退 formId
+export async function getFormLayout(host, formId) {
+    const d = await fetchLayoutData(host, formId);
+    return d?.formLayout?.id || d?.id || formId;
+}
+// 表单布局完整元数据：viewRelateConfig（字段级 required/readOnly）+ viewLinkages（条件必填/显隐）
+export async function getFormLayoutMeta(host, formId) {
+    return fetchLayoutData(host, formId);
+}
+// 表单类 esb 按钮解析：POST getFormButtons(body objId[, layoutId]) → 扁平 actions[]（带 _btn=按钮名）
+export async function getFormButtons(host, objId, layoutId) {
+    const body = {
+        layoutType: 'formLayout', objId, dataId: '', formDataId: '',
+        type: '1', fromRecycle: false, otherOperator: '', objectAppId: '',
+        browser: 'Chrome', isTamper: '0',
+    };
+    if (layoutId)
+        body.layoutId = layoutId;
+    const r = await host.request({ path: '/api/ebuilder/form/data/getFormButtons', body });
+    const btns = r?.data?.buttons || r?.data || [];
+    const actions = [];
+    for (const b of btns) {
+        for (const a of b?.actions || []) {
+            actions.push({ ...a, _btn: b.name, _buttonKey: b.buttonKey, _buttonId: b.id, _buttonOrder: b.showOrder });
+        }
+    }
+    return actions;
+}
+// 取「保存」按钮下的**已启用**动作链（按 showOrder 升序）——页面点「保存」时依次执行的就是这一串。
+// 跨环境自适应：按钮 id / 动作 id / 动作数量 / 名称均运行时解析，不写死。
+// enable=0 的动作页面不会执行（实测：人才表单 7 条动作里 3 条为禁用态），一律排除。
+export function pickSaveButtonActions(actions, { includeDisabled = false } = {}) {
+    const all = actions || [];
+    let own = all.filter((a) => a._buttonKey === 'save');
+    if (!own.length) {
+        const names = new Set(all.filter((a) => a.actionType === 'system' && a._btn).map((a) => a._btn));
+        own = all.filter((a) => a._btn && names.has(a._btn));
+    }
+    const sorted = [...own].sort((x, y) => (x.showOrder ?? 0) - (y.showOrder ?? 0));
+    if (includeDisabled)
+        return sorted;
+    return sorted.filter((a) => a.enable === undefined || a.enable === null || Number(a.enable) !== 0);
+}
+// 列表类 esb 按钮解析（催评）：GET getListButtons/{listId}?passid → buttons[].actions[]
+export async function getListButtons(host, listId, passid) {
+    const r = await host.request({ path: '/api/ebuilder/form/list/getListButtons/' + listId + '?passid=' + passid, method: 'GET' });
+    const btns = r?.data?.buttons || r?.data || [];
+    const actions = [];
+    for (const b of btns)
+        for (const a of b?.actions || [])
+            actions.push({ ...a, _btn: b.name });
+    return actions;
+}
+// 从 actions 里挑 actionType=esb 且名称匹配（含关键词、排除词）的按钮 id
+export function pickEsb(actions, include, exclude = []) {
+    const match = (name) => {
+        if (!name)
+            return false;
+        if (exclude.some((e) => name.includes(e)))
+            return false;
+        return include.some((i) => name.includes(i));
+    };
+    for (const a of actions) {
+        if (a.actionType === 'esb' && match(a.name || a._btn || a.text))
+            return a.id;
+    }
+    return null;
+}
+// saveFormData：新建（rightType 0）或更新（rightType 2，带 formDataId/updateTimeStamp）
+export async function saveFormData(host, opts) {
+    const { appId, formId, objId, name, dataDetails, rightType = '0', formDataId, updateTimeStamp, layoutId, extraCustomParam = {} } = opts;
+    const finalLayout = layoutId || await getFormLayout(host, formId);
+    const customParam = {
+        objId, name: name || '', firstDataName: name || '',
+        isFlowEnd: false, otherOperator: '', dataStatus: 'submit', rightType,
+        appId, ...extraCustomParam,
+    };
+    const formData = {
+        module: 'ebuilderform', client: 'pc', dataStatus: 'submit',
+        form: { id: formId }, formLayout: { id: finalLayout },
+    };
+    if (formDataId)
+        formData.id = formDataId;
+    if (updateTimeStamp)
+        formData.updateTimeStamp = updateTimeStamp;
+    if (dataDetails)
+        formData.dataDetails = dataDetails;
+    const r = await host.request({
+        path: '/api/ebuilder/form/form/core/saveFormData?formId=' + formId,
+        body: { module: 'ebuilderform', appId, customParam, formData },
+    });
+    if (!r?.status && r?.code !== 200) {
+        throw rsFail('saveFormData 失败: ' + (r?.msg || JSON.stringify(r).slice(0, 200)));
+    }
+    return String(r?.data?.id);
+}
+// ── 招聘业务查重（页面新建人才时用的就是它）──────────────────────────────
+// 页面代码块逻辑：手机号 → POST getCandidateByPhone → data.candidateId 有值即「已绑定人才」。
+// 注意 candidateId 是**应聘批次 id**（= batchNo），不是 talentId；两者都返回。未命中时 data = {}。
+export async function getCandidateByPhone(host, phone) {
+    const r = await host.request({ path: '/api/recruit/candidate/getCandidateByPhone', method: 'POST', body: { phone: String(phone) } });
+    const d = r?.data || {};
+    return {
+        talentId: d.talentId ? String(d.talentId) : '',
+        candidateId: d.candidateId ? String(d.candidateId) : '',
+        batchNo: d.batchNo ? String(d.batchNo) : '',
+    };
+}
+// 人才查看页（页面代码块弹窗跳转地址，recruitType=useSelf 表示租户人才库）
+export function buildTalentViewUrl(baseUrl, candidateId) {
+    return `${baseUrl}/sp/recruit/talentView?batchId=${candidateId}&recruitType=useSelf`;
+}
+// 人才类链接的自用系统追加参数：环境缓存 selfUse（config_key=-9999）='1' → 追加 &recruitType=useSelf。
+// 仅人才类链接需要；职位/面试等非人才链接不需要。
+export function talentLinkExtra(cache) {
+    return String(cache && cache.selfUse) === '1' ? '&recruitType=useSelf' : '';
+}
+// ── 唯一性校验（页面新建/编辑时调用的查重接口）────────────────────────────────
+// 返回 formDataIds = 已存在记录 id 列表；含已软删除记录（平台仍视为占用，会拦新建）。
+// CLI 运行时已对 16+ 位整数保精度（字符串形态），此处仍保留正则兜底提取以兼容极端情况。
+export async function checkUnique(host, opts) {
+    const { objId, fieldId, value, dataId } = opts;
+    const dataDetail = { content: String(value), formField: { id: String(fieldId) } };
+    const customParam = { objId: String(objId) };
+    if (dataId) {
+        dataDetail.formData = { id: String(dataId) };
+        customParam.dataId = String(dataId);
+    }
+    const r = await host.request({
+        path: '/api/ebuilder/form/form/core/checkUnique', method: 'POST',
+        body: { dataDetail, module: 'ebuilderform', customParam },
+    });
+    const d = r?.data || {};
+    let ids = [];
+    const rawList = d.formDataIds;
+    if (Array.isArray(rawList))
+        ids = rawList.map((x) => String(x)).filter((x) => /^\d{10,}$/.test(x));
+    if (!ids.length) {
+        // 兜底：宿主未保精度时从原文提取（与脚本版同构）
+        const text = typeof r?.__raw === 'string' ? r.__raw : '';
+        const m = text.match(/"formDataIds"\s*:\s*\[([^\]]*)\]/);
+        if (m)
+            ids = m[1].match(/\d{10,}/g) || [];
+    }
+    return { unique: d.unique !== false, formDataIds: [...new Set(ids)] };
+}
+// ── OpenAPI 数据集接口（唯一支持明细表的写入通道）────────────────────────────
+// `form/core/saveFormData` 的 dataDetails 不接收 DetailTable（实测 9 种结构全被忽略），
+// 明细表只能走 /api/ebuilder/form/dataset/v2/saveFormData（detail1..detailN）。
+// 主表 ↔ 明细节点映射：{mainTable: mainObjId, detail1: subFormId, ...}
+// 明细编号顺序 ≠ 布局顺序，必须运行时解析。
+export async function getTableMapping(host, objId) {
+    const r = await host.request({ path: '/api/ebuilder/form/dataset/v1/getTableMapping?objId=' + encodeURIComponent(objId), method: 'GET' });
+    const d = r?.data;
+    if (!d || !d.mainTable)
+        throw rsFail('getTableMapping 未返回映射（objId=' + objId + '）：' + JSON.stringify(r).slice(0, 200));
+    return d;
+}
+// 反向映射：subFormId → detailN
+export function invertTableMapping(mapping) {
+    const out = {};
+    for (const [node, tableId] of Object.entries(mapping || {})) {
+        if (node === 'mainTable')
+            continue;
+        out[String(tableId)] = node;
+    }
+    return out;
+}
+// OpenAPI 新增（主表 + 明细一次写入）。键必须用 config.dataKey（name 可能等于 id，会被静默忽略）。
+export async function datasetSaveFormData(host, opts) {
+    const { objId, mainTable, details, doAction = false, fieldNoFindIgnore = true } = opts;
+    const record = { mainTable };
+    for (const [node, rows] of Object.entries(details || {})) {
+        if (Array.isArray(rows) && rows.length)
+            record[node] = rows;
+    }
+    const r = await host.request({
+        path: '/api/ebuilder/form/dataset/v2/saveFormData',
+        method: 'POST',
+        body: {
+            datajson: {
+                datas: [record],
+                header: { objId },
+                operationinfo: {
+                    fieldNoFindIgnore: fieldNoFindIgnore ? 'true' : 'false',
+                    doAction: doAction ? 'true' : 'false',
+                },
+            },
+        },
+    });
+    const dj = r?.data?.datajson || {};
+    const code = r?.message?.code;
+    const ok = (code === undefined || String(code) === '0') && dj.status !== false;
+    if (!ok) {
+        // 业务失败信息在 data.datajson.message（如平台查重），外层 message.msg 恒为 success
+        throw rsFail('dataset saveFormData 失败：' + (dj.message || r?.message?.msg || JSON.stringify(r).slice(0, 300)));
+    }
+    const ids = Array.isArray(dj.dataIds) ? dj.dataIds.map(String) : [];
+    if (!ids.length)
+        throw rsFail('dataset saveFormData 未返回 dataIds：' + JSON.stringify(r).slice(0, 300));
+    return { dataId: ids[0], dataIds: ids };
+}
+// OpenAPI 修改（支持明细覆盖：operateType={detailN:'cover'}）
+export async function datasetUpdateFormData(host, opts) {
+    const { objId, dataId, mainTable, details, coverDetails = [] } = opts;
+    const record = { mainTable: { id: String(dataId), ...(mainTable || {}) } };
+    const operateType = {};
+    for (const [node, rows] of Object.entries(details || {})) {
+        if (!Array.isArray(rows))
+            continue;
+        record[node] = rows;
+        if (coverDetails.includes(node))
+            operateType[node] = 'cover';
+    }
+    const operationinfo = { updateType: 'ids', fieldNoFindIgnore: 'true', needAdd: 'false', doAction: 'false' };
+    if (Object.keys(operateType).length)
+        operationinfo.operateType = operateType;
+    const r = await host.request({
+        path: '/api/ebuilder/form/dataset/v2/updateFormData',
+        method: 'POST',
+        body: { datajson: { datas: [record], header: { objId }, operationinfo } },
+    });
+    const dj = r?.data?.datajson || {};
+    const ok = (r?.message?.code === undefined || String(r?.message?.code) === '0') && dj.status !== false;
+    if (!ok)
+        throw rsFail('dataset updateFormData 失败：' + (dj.message || r?.message?.msg || JSON.stringify(r).slice(0, 300)));
+    return { dataIds: (dj.dataIds || []).map(String) };
+}
+// runEsb：触发动作流（dataIds = 目标记录 id；esbActionIds = 按钮配置解析）
+export async function runEsb(host, opts) {
+    const r = await host.request({
+        path: '/api/ebuilder/form/esb/runEsb?objId=' + opts.objId,
+        body: { dataIds: opts.dataIds, esbActionIds: opts.esbActionIds, objId: opts.objId },
+    });
+    return r?.data || {};
+}
+// 通用：执行「保存」按钮配置里的 esb 动作流。没有配 esb 时返回空数组（不报错）。
+export async function runSaveButtonEsbActions(host, opts) {
+    const { objId, formId, dataId } = opts;
+    const layoutId = await getFormLayout(host, formId);
+    const acts = pickSaveButtonActions(await getFormButtons(host, objId, layoutId));
+    const done = [];
+    for (const a of acts) {
+        if (a.actionType !== 'esb')
+            continue;
+        const r = await runEsb(host, { objId, dataIds: dataId, esbActionIds: a.id });
+        const ok = r?.status !== false;
+        done.push({ order: a.showOrder, name: a.name, ok, msg: r?.successMsg || r?.failMsg || '' });
+        if (!ok)
+            throw rsFail('「保存」后续动作「' + (a.name || a.id) + '」执行失败：' + (r?.failMsg || '未知原因'));
+    }
+    return done;
+}
+/**
+ * 当前登录用户（跨环境取法：teamsCheck 返回 currentUser）。
+ * 用途：人员型字段的"默认 = 当前人"（招聘负责人/用人经理/面试官），
+ * 避免用"人员候选列表第一条"当默认（可能是任意人）。
+ */
+export async function resolveCurrentUser(host) {
+    try {
+        const r = await host.request({ path: '/api/baseserver/layout/teamsCheck', method: 'POST', body: {} });
+        const cu = (r && (r.currentUser || (r.data && r.data.currentUser))) || null;
+        return cu && cu.id ? { id: String(cu.id), name: cu.username || String(cu.id) } : null;
+    }
+    catch {
+        return null;
+    }
+}
+// 人员名称 → userId（门户字段 browser/complete/resource）
+export async function resolvePersonId(host, fieldId, keyword) {
+    const r = await host.request({
+        path: '/api/ebuilder/form/common/browser/complete/resource',
+        body: { formParam: { fieldId, searchValue: keyword }, 'formParam.fieldId': fieldId, 'formParam.searchValue': keyword },
+    });
+    const list = r?.data?.data || r?.data || [];
+    return list[0]?.id || list[0]?.value || null;
+}
+// ds/options 运行时解析枚举（面试方式/轮次/状态等）：name → optionId
+export async function getDsOptions(host, objId, fieldId, groupId) {
+    const r = await host.request({
+        path: '/api/ebuilder/common/ds/options?fieldName=' + fieldId + '&objId=' + objId + '&sourceType=FORM&groupId=' + groupId,
+        method: 'GET',
+    });
+    const list = r?.data || [];
+    const map = {};
+    for (const x of list)
+        map[x.name] = x.id;
+    return map;
+}
+// 环境缓存 field_options（{optionId: 名称}）反转成 getDsOptions 同款 {名称: optionId}；未覆盖返回 null 由调用方回源
+export function cachedDsMap(cache, objId, fieldKey) {
+    const fidv = (cache.fields[objId] || {})[fieldKey];
+    const opts = fidv && cache.field_options?.[objId] && cache.field_options[objId][fidv];
+    if (!opts || !Object.keys(opts).length)
+        return null;
+    const map = {};
+    for (const [id, name] of Object.entries(opts))
+        map[name] = id;
+    return map;
+}
+/* ============ 按钮动作智能解析（数据页按钮 → 粗定位 → 精核验 → 动作拆解） ============ */
+// 数据页按钮：POST getFormButtons（type=2，带 dataId）→ 返回按钮数组（含 actions）
+export async function getFormButtonsForData(host, objId, formId, dataId, layoutId) {
+    const body = {
+        layoutType: 'formLayout', objId, dataId, formDataId: dataId,
+        type: '2', fromRecycle: false, otherOperator: '', objectAppId: '',
+        browser: 'Chrome', isTamper: '0',
+    };
+    if (layoutId)
+        body.layoutId = layoutId;
+    const r = await host.request({ path: '/api/ebuilder/form/data/getFormButtons', body });
+    const data = r?.data;
+    const btns = Array.isArray(data) ? data : (data?.buttons || []);
+    return btns;
+}
+// 粗定位：找「带保存动作」的按钮（actionType=system 或 buttonKey=editSave）
+export function findSubmitButton(btns) {
+    for (const b of btns || []) {
+        const acts = b?.actions || [];
+        if (acts.some((a) => a.actionType === 'system') || b?.buttonKey === 'editSave')
+            return b;
+    }
+    return null;
+}
+// 从 jsCode 的 ecode（内联 JS）静态提取后端 API 调用（url/method/data 参数名）
+export function extractJsRequests(ecode) {
+    if (!ecode)
+        return [];
+    const calls = [];
+    const re = /(?:weappUtils\.request|\$\.ajax|axios\.\w+|fetch)\s*\(\s*\{[\s\S]*?\}/g;
+    let m;
+    while ((m = re.exec(ecode))) {
+        const block = m[0];
+        const url = (block.match(/url\s*:\s*["']([^"']+)["']/) || [])[1];
+        if (!url)
+            continue;
+        const method = (block.match(/method\s*:\s*["']([^"']+)["']/) || [])[1] || 'post';
+        const data = {};
+        const dm = block.match(/data\s*:\s*\{([\s\S]*?)\}/);
+        if (dm) {
+            for (const kv of dm[1].split(',')) {
+                const kk = kv.match(/["']?([A-Za-z_][A-Za-z0-9_]*)["']?\s*:/);
+                if (kk)
+                    data[kk[1]] = kv.split(':').slice(1).join(':').trim().slice(0, 60);
+            }
+        }
+        calls.push({ url, method, data });
+    }
+    return calls;
+}
+// 精核验：分析按钮全部 actions → { system, esbIds, jsCalls, names }
+export function analyzeButtonActions(btn) {
+    const acts = btn?.actions || [];
+    const esbIds = acts.filter((a) => a.actionType === 'esb').map((a) => String(a.id));
+    const jsCalls = [];
+    for (const a of acts) {
+        if (a.actionType === 'jsCode' && a.ecode)
+            jsCalls.push(...extractJsRequests(a.ecode));
+    }
+    return {
+        system: acts.some((a) => a.actionType === 'system'),
+        esbIds,
+        jsCalls,
+        names: acts.map((a) => (a.actionType === 'jsCode' ? `jsCode(${a.name})` : `${a.actionType}(${a.name})`)),
+    };
+}
+// 取数据页表单记录（含 updateTimeStamp 乐观锁 + dataDetails 全字段）
+export async function getFormDataRecord(host, formId, dataId, objId, layoutId) {
+    const r = await host.request({
+        path: '/api/ebuilder/form/form/core/getFormDataAndLayout?formId=' + formId + '&dataId=' + dataId,
+        method: 'POST',
+        body: {
+            terminalType: 'PC', dataId, formId, module: 'ebuilderform', newLayout: true,
+            cacheUid: '', layoutMultiId: '', dataCrossLayout: false, permissionId: '',
+            allReadOnly: false, initialDatas: [], dynamicData: false, cost: false,
+            ...(layoutId ? { layoutId } : {}),
+            customParam: { objId },
+        },
+    });
+    const fd = r?.data?.formData || {};
+    const fl = r?.data?.formLayout || {};
+    return { id: fd.id, updateTimeStamp: fd.updateTimeStamp, dataDetails: fd.dataDetails || [], formLayoutId: fl.id };
+}
+// dataDetails 转换：getFormDataAndLayout 返回 {fieldId, dataOptions|dataText} → saveFormData 提交形态
+export function toSubmitDetails(details) {
+    const out = [];
+    for (const x of details || []) {
+        const fid = x.fieldId || x.formField?.id;
+        if (!fid)
+            continue;
+        const o = { formField: { id: fid } };
+        if (x.dataOptions)
+            o.dataOptions = x.dataOptions;
+        if (x.dataText)
+            o.dataText = x.dataText;
+        if (x.value !== undefined)
+            o.dataText = { content: String(x.value) };
+        if (!o.dataOptions && !o.dataText)
+            continue;
+        out.push(o);
+    }
+    return out;
+}
+/**
+ * 跨环境菜单解析（同一功能在不同环境叫法不同）。
+ * 匹配顺序：① 精确名 ② 包含名；均可叠加 filter 校验。
+ * 未命中返回 null —— 调用方应视为「该环境无此菜单」并提示，不得臆造 URL。
+ */
+export function findMenuNode(menus, aliases, filter) {
+    const list = Array.isArray(menus) ? menus : [];
+    const nameOf = (m) => String((m && m.menuName) || '').trim();
+    const ok = (m) => (typeof filter === 'function' ? !!filter(m) : true);
+    for (const a of aliases || []) {
+        const hit = list.find((m) => nameOf(m) === a && ok(m));
+        if (hit)
+            return hit;
+    }
+    for (const a of aliases || []) {
+        const hit = list.find((m) => nameOf(m).includes(a) && ok(m));
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+/**
+ * 由表单布局元数据推导「当前取值下必填、但未提供且无默认值」的字段（纯函数）。
+ * - 静态必填：viewRelateConfig[].required
+ * - 条件必填：viewLinkages[] 中条件只涉及「面试方式」一维时，命中当前取值则 required 生效
+ * - 排除 defaultDetails 里带默认值的字段
+ *
+ * 枚举改名/换 id 的兼容（实测坑）：
+ *   ① 条件 optionId 在当前枚举里 → 严格按当前枚举名比较；
+ *   ② 条件 optionId 不在当前枚举 → 按条件文本去括号后比较（AI面试(数字人) → AI面试）。
+ */
+export function computeRequiredHint(opts) {
+    const { meta, fields, typeName, typeOptionId, typeOptions, dataDetails } = opts;
+    const rev = {};
+    for (const [dk, fid] of Object.entries(fields || {}))
+        rev[String(fid)] = dk;
+    const nm = (fid) => rev[String(fid)] || String(fid);
+    const curName = (id) => (typeOptions || {})[String(id)] || '';
+    const norm = (s) => String(s || '').replace(/[（(][^)）]*[)）]/g, '').trim();
+    const matchTypeCondition = (cd) => {
+        if (!cd)
+            return false;
+        let optId = '';
+        let optText = '';
+        try {
+            const sj = JSON.parse(cd.sourceContent || '{}');
+            const o = (sj.dataOptions || [])[0];
+            if (o) {
+                optId = String(o.optionId || '');
+                optText = String(o.content || '');
+            }
+            if (!optText)
+                optText = String(sj.content || '');
+        }
+        catch { /* ignore */ }
+        const actual = curName(optId);
+        let eq;
+        if (actual) {
+            eq = actual === typeName;
+        }
+        else {
+            eq = !/[（(]/.test(String(typeName || '')) && norm(optText) === norm(typeName);
+        }
+        if (cd.detailSymbol === 'UN_EQUAL')
+            return !eq;
+        if (cd.detailSymbol === 'IN') {
+            const names = optText.split(',').map((s) => norm(s));
+            return names.includes(norm(typeName)) || Boolean(typeOptionId && optId === String(typeOptionId));
+        }
+        return eq;
+    };
+    const required = new Set();
+    for (const x of meta?.viewRelateConfig || []) {
+        if (x.required)
+            required.add(nm(x.fieldId));
+    }
+    const typeFid = String((fields || {}).interview_type || '');
+    for (const lk of meta?.viewLinkages || []) {
+        const details = (lk.condition || {}).conditionDetails || [];
+        if (!details.length)
+            continue;
+        let hit = true;
+        for (const cd of details) {
+            if (!typeFid || String(cd.targetId) !== typeFid) {
+                hit = false;
+                break;
+            }
+            if (!matchTypeCondition(cd)) {
+                hit = false;
+                break;
+            }
+        }
+        if (!hit)
+            continue;
+        for (const ld of lk.linkageDetails || []) {
+            if (ld.linkageProp === 'required') {
+                for (const v of String(ld.linkageValue || '').split(','))
+                    if (v.trim())
+                        required.add(nm(v.trim()));
+            }
+        }
+    }
+    const filled = new Set((dataDetails || []).map((d) => nm((d.formField || {}).id)));
+    const defaults = new Set((meta?.defaultDetails || []).map((x) => nm(x.fieldId)));
+    const defaultValues = {};
+    for (const x of meta?.defaultDetails || []) {
+        const dk = nm(x.fieldId);
+        const o = (x.dataOptions || [])[0];
+        defaultValues[dk] = o
+            ? { optionId: String(o.optionId || ''), content: o.content || '' }
+            : { optionId: '', content: x.content || '' };
+    }
+    let missing = [...required].filter((k) => !filled.has(k) && !defaults.has(k));
+    // 业务裁定（2026-10-21 用户确认）：「AI面试」= 数字人面试；「AI面试(小程序)」才是试卷+渠道形态。
+    // 对「AI面试」显式剔除这两项（required 原样保留以反映配置事实，只避免误报缺失）。
+    const DIGITAL_EXCLUDE = ['interview_paper_id', 'send_channel'];
+    const isDigitalHuman = String(typeName || '').trim() === 'AI面试';
+    let excludedByBusiness = [];
+    if (isDigitalHuman) {
+        excludedByBusiness = missing.filter((k) => DIGITAL_EXCLUDE.includes(k));
+        missing = missing.filter((k) => !DIGITAL_EXCLUDE.includes(k));
+    }
+    return { available: true, required: [...required], missing, hasDefault: [...defaults], defaultValues, excludedByBusiness };
+}
+/**
+ * EB 记录「卡片单页」URL：{baseUrl}/sp/ebdfpage/card/0/{objId}/{dataId}
+ * objId 来自环境缓存（跨环境不同，不得写死）；dataId = saveFormData 返回的记录 id。
+ */
+export function buildCardUrl(baseUrl, objId, dataId) {
+    if (!baseUrl || !objId || !dataId)
+        return null;
+    return String(baseUrl).replace(/\/+$/, '') + '/sp/ebdfpage/card/0/' + objId + '/' + dataId;
+}
+/**
+ * 「列表 + 滑出该记录卡片」组合地址（2026-10-21 实测可用，简化版无需
+ * EbdfListToCardKey/targetConditionId——它们是页面会话态/已存条件 id，运行时组不出来也不需要）：
+ *   {base}/sp/ebdfpage/list/{listId}/card/0/{objId}/{dataId}/{listId}?id={dataId}&openSource=field&openSourceId={dataId}&openSourceAppId={appId}
+ */
+export function buildListLocateUrl(baseUrl, appId, listId, objId, dataId) {
+    if (!baseUrl || !listId || !objId || !dataId)
+        return null;
+    const base = String(baseUrl).replace(/\/+$/, '');
+    return `${base}/sp/ebdfpage/list/${listId}/card/0/${objId}/${dataId}/${listId}?id=${dataId}&openSource=field&openSourceId=${dataId}&openSourceAppId=${appId}`;
+}

package/dist/shortcuts/workflow/operations/todoSmartConvert/detailFieldRules.js

@@ -89,14 +89,16 @@ export function pickInternalMessageContentField(fields) {
  *
  * `留言内容` 为空 ⇒ 返回空数组：这是「表单没有业务内容」，不是「只有发起人」。
  */
-export function pickInternalMessageFieldPairs(fields, basicInfo = {}) {
+export function pickInternalMessageFieldPairs(fields, basicInfo = {}, 
+/** 兜底发起人（2026-11-03：汇总链路已不再保留 basic，改由列表行的 createrName 传入） */
+fallbackCreatorName) {
     const content = pickInternalMessageContentField(fields);
     const contentValue = String(content?.value ?? '').trim();
     if (!contentValue)
         return [];
     const name = normalizeDetailFieldName(content?.fieldName) || INTERNAL_MESSAGE_CONTENT_LABEL;
     const pairs = [{ fieldName: name, value: contentValue }];
-    const creatorName = String(basicInfo.creatorName ?? '').trim();
+    const creatorName = String(basicInfo.creatorName ?? fallbackCreatorName ?? '').trim();
     if (creatorName)
         pairs.push({ fieldName: INTERNAL_MESSAGE_INITIATOR_LABEL, value: creatorName });
     const createdAt = String(basicInfo.createdAt ?? '').trim();

package/dist/shortcuts/workflow/operations/todoSmartConvert/summaryCache.js

@@ -125,16 +125,20 @@ export function promptTagOf(prompt) {
 /**
  * 缓存条目是否与当前口径/素材匹配。
  *
- * **失效条件（2026-11-02 用户定稿）：只由 `requestSummaryPrompt`（default.json / 用户意图）调整触发**——
- *  - `pk`：双方都存在时才比对；**条目缺 pk = 旧口径条目，兼容命中**（无法证明口径变过就不作废）；
+ * **失效条件：由 `requestSummaryPrompt`（default.json / 用户意图）调整触发**——
+ *  - `pk`：**严格比对**（2026-11-04 修正）。调用方只要传了 pk，条目缺 pk 或 pk 不等 ⇒ 一律失效重写。
+ *    旧口径（`entry.pk !== undefined` 才比对）等于「改 requestSummaryPrompt 对老条目永远不生效」：
+ *    条目是用旧口径写的，缺 pk 只能说明「口径未知」，不能证明「口径没变」。
+ *    空口径（`pk === ''`）会照常落库，因此「改空 / 改回非空」同样能触发失效，且空口径组不会抖动。
  *  - `maxChars`：双方都存在时才比对，且调用方只在用户**显式**传字数时才传入
  *    （`summary.ts` 的 `explicitMaxCharsFor`）——规则/默认字数变化不作废历史摘要；
  *    用户显式要求「10 字以内」时仍会重写（2026-10-22 实测踩坑的保护保留）；
  *  - `dv`：详情素材特征值仍比对——素材升级 / 排除清单调整后旧摘要缺信息（如安全工单缺行号），
- *    不能继续命中；条目缺 dv = 旧条目，兼容命中。
+ *    不能继续命中；条目缺 dv = 旧条目，兼容命中（素材侧无法核验，属另一条口径，未随本次收紧）。
  */
 function entryMatches(entry, maxChars, pk, dv) {
-    if (pk !== undefined && entry.pk !== undefined && entry.pk !== pk)
+    // 调用方不传 pk（undefined）= 不做口径判定（保持对旧调用点的兼容）；传了就必须逐字符相等。
+    if (pk !== undefined && entry.pk !== pk)
         return false;
     if (maxChars !== undefined && entry.maxChars !== undefined && entry.maxChars !== maxChars)
         return false;
@@ -151,7 +155,9 @@ function normalizeSummaryEntry(raw) {
     if (typeof entry.cachedAt !== 'number' || !Number.isFinite(entry.cachedAt))
         return null;
     const maxChars = typeof entry.maxChars === "number" && Number.isFinite(entry.maxChars) ? entry.maxChars : undefined;
-    const pk = typeof entry.pk === 'string' && entry.pk !== '' ? entry.pk : undefined;
+    // 空串是有效口径（该组本来就没配 requestSummaryPrompt）：保留下来，
+    // 否则「空口径条目」会被当成「缺 pk 的旧条目」，收紧后每次都 miss。
+    const pk = typeof entry.pk === 'string' ? entry.pk : undefined;
     const dv = typeof entry.dv === 'string' && entry.dv !== '' ? entry.dv : undefined;
     return {
         summary: entry.summary,
@@ -236,7 +242,8 @@ export async function openSummaryCache(ctx) {
                 summary: text,
                 cachedAt: Date.now(),
                 ...(maxChars === undefined ? {} : { maxChars }),
-                ...(pk === undefined || pk === '' ? {} : { pk }),
+                // 空串同样落库（见 entryMatches 注释）：空口径与「缺 pk」必须能区分开。
+                ...(pk === undefined ? {} : { pk }),
                 ...(dv === undefined || dv === '' ? {} : { dv }),
             });
             dirty = true;