weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/ehr/operations/recruit.js

@@ -0,0 +1,803 @@
+import { randomBytes, randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { ehrValidationError } from '../errors.js';
+import { READ, SCHEMA_ID, ehrSuccess, schemaOf, } from './types.js';
+import { compact, normalizePaged, toNumber, toPageQuery, toPositiveInt } from './shared.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 五层运行时解析（迁移自 ehr 技能 _init_env_cache.mjs，真机验证过）
+// getAppIds -> getObjsByTag -> allMenus -> ds/fields -> ds/options
+// 缓存：进程内 memo + 磁盘（缓存根 = E10_SKILL_CACHE_DIR 环境变量优先，
+// 未设置回退 CLI 数据目录 WEAVER_WORK_CLI_HOME（默认用户主目录下 .weaver-work-cli）的
+// env-cache/recruit-ops/<host>_<port>/<appId>.json。与 ehr 技能同构，
+// 设同一 E10_SKILL_CACHE_DIR 即可共享缓存）。菜单名跨版本不同，解析不到必须报错，禁止臆造。
+// ─────────────────────────────────────────────────────────────────────────────
+const RECRUIT_APP_TAG = 'weaver-recruit-service';
+/** 逻辑名 -> objTag（权威映射，与 _init_env_cache.mjs 一致） */
+const RECRUIT_TAGS = {
+    talent_pool: 'uf_rcrt_talent_pool',
+    interview_plan: 'uf_rcrt_interview_plan',
+    interview_detail: 'uf_rcrt_interview_detail',
+    demand_manage: 'uf_rcrt_demand_manage',
+    position_manage: 'uf_rcrt_position_manage',
+    entry_manage: 'uf_rcrt_entry_manage',
+    offer: 'uf_rcrt_offer',
+    offer_sending: 'uf_rcrt_offer_sending',
+    candidate_manage: 'uf_rcrt_candidate_manage',
+    entry_transact: 'uf_rcrt_entry_transact',
+    entry_cancel: 'uf_rcrt_entry_cancel',
+    entry_change: 'uf_rcrt_entry_change',
+    dictionary: 'uf_rcrt_dictionary',
+    biz_config: 'uf_rcrt_biz_config_mapper',
+};
+/** 列表业务名 -> 菜单名关键词（按 ehr 技能 KEYWORDS，跨版本菜单名用 includes 匹配） */
+const LIST_KEYWORDS = {
+    talent: ['人才库', '人才管理'],
+    demand: ['招聘需求', '需求'],
+    position: ['招聘职位', '职位列表', '职位管理'],
+    entry: ['入职管理'],
+    offer: ['录用管理', 'offer管理', 'offer'],
+    interview: ['面试管理'],
+    biz_config: ['业务配置映射表'],
+};
+/** 列表类型 -> 缓存键 + 表单逻辑名（candidate.list 四列表映射，同 recruit-list.mjs TYPES） */
+const LIST_TYPES = {
+    demand: { listKey: 'demand', formType: 'demand_manage', title: '招聘需求' },
+    position: { listKey: 'position', formType: 'position_manage', title: '招聘职位' },
+    entry: { listKey: 'entry', formType: 'entry_manage', title: '入职管理' },
+    offer: { listKey: 'offer', formType: 'offer', title: '录用管理' },
+};
+/** 剔除与展示无关的内部键（同 recruit-list.mjs） */
+const INTERNAL_KEYS = new Set([
+    'id', 'form_data_id', 'form_table_id', 'rowKey', 'ebrecord_rowkey',
+    'isFollow', 'is_flow', 'data_status', 'data_status_value', 'update_time',
+    'formDataId', 'isFollowSearch', 'isShareToMe',
+]);
+/** displayData 显示层的额外 UI/内部字段（同 recruit-list.mjs DISPLAY_UI_KEYS） */
+const DISPLAY_UI_KEYS = new Set([
+    ...INTERNAL_KEYS, 'operate', 'isToDo', 'todoPropSpan', 'flow_status',
+]);
+function randHex32() {
+    return randomUUID().replace(/-/g, '');
+}
+function randHex6() {
+    return randomBytes(3).toString('hex');
+}
+/** 缓存目录：E10_SKILL_CACHE_DIR 优先（与 ehr 技能同语义：根下直接 <host>_<port>）；未设置回退 CLI 数据目录 env-cache/recruit-ops */
+function cacheDirFor(baseUrl) {
+    const url = new URL(baseUrl);
+    const host = url.hostname + (url.port ? `_${url.port}` : '');
+    const envRoot = process.env.E10_SKILL_CACHE_DIR;
+    if (envRoot)
+        return join(envRoot, host);
+    const home = process.env.WEAVER_WORK_CLI_HOME || process.env.WORK_CLI_HOME || resolve(homedir(), '.weaver-work-cli');
+    return join(home, 'env-cache', 'recruit-ops', host);
+}
+/** 内联展示字段解析：门户字段三种形态（数组/对象/字符串 JSON），同 recruit-detail.mjs namesOf */
+function namesOf(field) {
+    if (!field)
+        return null;
+    let arr;
+    if (Array.isArray(field))
+        arr = field;
+    else if (typeof field === 'object')
+        arr = [field];
+    else if (typeof field === 'string') {
+        const text = field.trim();
+        if (!text.startsWith('[') && !text.startsWith('{'))
+            return text || null;
+        try {
+            arr = JSON.parse(text);
+        }
+        catch {
+            return text || null;
+        }
+        if (!Array.isArray(arr))
+            arr = [arr];
+    }
+    else
+        return null;
+    const names = arr
+        .map((item) => (item && typeof item === 'object' ? item.name || item.username || item.text || item.title : null))
+        .filter(Boolean);
+    return names.length ? names.join('、') : null;
+}
+function isPlainId(value) {
+    return value != null && /^\d+$/.test(String(value).trim());
+}
+class RecruitContextError extends Error {
+    subtype;
+    constructor(subtype, message) {
+        super(message);
+        this.subtype = subtype;
+    }
+}
+/** ds/fields 单表单结构拉取（multipart，与 _init_env_cache.mjs fetchFields 等价） */
+async function fetchFormFields(host, appId, objId) {
+    const form = new FormData();
+    form.set('groupId', appId);
+    form.set('sourceId', objId);
+    form.set('sourceType', 'FORM');
+    form.set('detailFieldsGroup', 'true');
+    form.set('enableMerge', 'true');
+    form.set('customParam', '{"terminal":""}');
+    form.set('params', '[]');
+    const response = (await host.request({
+        method: 'POST',
+        path: '/api/ebuilder/common/ds/fields',
+        multipart: form,
+    }));
+    const fmap = {};
+    const omap = {};
+    for (const group of response?.data || []) {
+        for (const field of group?.fields || []) {
+            const config = field?.config || {};
+            const dataKey = config.dataKey || '';
+            const fieldId = String(field?.id || '');
+            if (dataKey && fieldId)
+                fmap[dataKey] = fieldId;
+            if (fieldId && Array.isArray(config.options) && config.options.length) {
+                const map = {};
+                for (const option of config.options) {
+                    if (!option || typeof option !== 'object')
+                        continue;
+                    const name = option.name;
+                    let selectionId = option.selectionId;
+                    if (!selectionId && typeof option.extra === 'string') {
+                        try {
+                            const extra = JSON.parse(option.extra);
+                            selectionId = extra.selectionId || extra.id;
+                        }
+                        catch { /* 坏 extra 回退 */ }
+                    }
+                    if (!selectionId)
+                        selectionId = option.value || option.valueKey || option.id;
+                    if (selectionId && name)
+                        map[String(selectionId)] = name;
+                }
+                if (Object.keys(map).length)
+                    omap[fieldId] = map;
+            }
+        }
+    }
+    return { fmap, omap };
+}
+/** 五层解析主流程（磁盘缓存缺失时执行；每层失败必须报错，禁止臆造） */
+async function resolveRecruitEnv(host, appId) {
+    // L2：tag 解析各表单 objId/formId（顺带 tenantKey）
+    const forms = {};
+    let tenantKey = '';
+    for (const [logic, tag] of Object.entries(RECRUIT_TAGS)) {
+        const response = (await host.request({
+            path: '/api/ebuilder/form/obj/getObjsByTag',
+            query: { appId, tag },
+        }));
+        const entry = Array.isArray(response?.data) && response.data.length ? response.data[0] : null;
+        forms[logic] = {
+            objId: String(entry?.id || ''),
+            formId: String(entry?.formId || ''),
+            objName: entry?.objName || '',
+        };
+        if (!tenantKey && entry?.tenantKey)
+            tenantKey = String(entry.tenantKey);
+    }
+    // L3：allMenus 菜单树 -> SEARCH 列表 + PAGE 页面
+    const menuResponse = (await host.request({
+        path: '/api/cusapp/app/allMenus',
+        query: { isFront: 1, appId, terminalType: 'PC' },
+    }));
+    const flat = [];
+    const walk = (nodes) => {
+        for (const node of nodes || []) {
+            if (node && typeof node === 'object') {
+                flat.push(node);
+                walk(node.children || node.childs);
+            }
+        }
+    };
+    const menuData = menuResponse?.data;
+    walk(typeof menuData === 'object' && menuData ? menuData.cusAppMenus || menuData : menuData);
+    const searchMenus = [];
+    const pages = [];
+    for (const node of flat) {
+        if (node.pageType === 'SEARCH') {
+            searchMenus.push({ menuName: node.menuName, listId: String(node.pageId || ''), cusMenuId: String(node.id || '') });
+        }
+        else if (node.pageType === 'PAGE') {
+            pages.push({ menuName: node.menuName, pageId: String(node.pageId || '') });
+        }
+    }
+    // L4：ds/fields 并行拉全部已解析表单的字段映射 + 选择类字段选项（零额外请求）
+    const fields = {};
+    const fieldOptions = {};
+    const resolvedForms = Object.entries(forms).filter(([, v]) => v.objId);
+    await Promise.all(resolvedForms.map(async ([logic, entry]) => {
+        const { fmap, omap } = await fetchFormFields(host, appId, entry.objId);
+        if (Object.keys(fmap).length)
+            fields[entry.objId] = fmap;
+        if (Object.keys(omap).length)
+            fieldOptions[entry.objId] = omap;
+        void logic;
+    }));
+    // L5：数据字典表全量映射（字典引用类字段如渠道的 optionId 来源）
+    const dictByName = {};
+    const dictRaw = [];
+    const dictMenu = searchMenus.find((m) => (m.menuName || '').trim() === '数据字典') || null;
+    const dictObjId = forms.dictionary?.objId || '';
+    if (dictObjId && dictMenu) {
+        const size = 500;
+        let current = 1;
+        for (;;) {
+            const response = (await host.request({
+                path: `/api/ebuilder/form/list/getListDatas?passid=${dictObjId}&cid=${dictObjId}`,
+                body: {
+                    current, pageSize: size, tableuid: randHex32(),
+                    listId: dictMenu.listId,
+                    searchParamData: { searchType: '3', type: 'and' },
+                    terminal: 'PC', browser: 'Chrome', requiredMatch: 1, mapResult: 1,
+                    recheckQuery: 1, isFollow: 0, isShareToMe: 0, filterCondition: {},
+                    cusMenuId: dictMenu.cusMenuId, urlPageTitle: '数据字典', menuName: '数据字典',
+                },
+                headers: { ebBusinessId: dictMenu.listId },
+            }));
+            const rows = response?.data?.data || [];
+            for (const row of rows) {
+                const name = row.selection_name;
+                const optionId = row.form_data_id;
+                if (name && optionId) {
+                    (dictByName[String(name)] ||= []).push(String(optionId));
+                    dictRaw.push({ selection_name: String(name), option_id: String(optionId), dict_type: row.dict_type, browser_key: row.browser_key });
+                }
+            }
+            if (rows.length < size)
+                break;
+            current += 1;
+        }
+    }
+    // 人才卡片页面 id（L1 业务配置表 config_key=28 前台可查；L2 page/list 兜底，失败不阻塞）+ 泛微自用标记
+    let ebdDetailPageId = '';
+    let selfUse = '0';
+    const bizConfig = forms.biz_config || { objId: '', formId: '', objName: '' };
+    const bizConfigMenu = searchMenus.find((m) => (m.menuName || '').trim() === '业务配置映射表') || null;
+    if (bizConfig.objId && bizConfigMenu) {
+        try {
+            const { fmap } = await fetchFormFields(host, appId, bizConfig.objId);
+            const keyField = fmap.config_key || '';
+            const valueField = fmap.config || '';
+            if (keyField && valueField) {
+                let current = 1;
+                for (;;) {
+                    const response = (await host.request({
+                        path: `/api/ebuilder/form/list/getListDatas?passid=${bizConfig.objId}&cid=${bizConfig.objId}`,
+                        body: {
+                            current, pageSize: 100, tableuid: randHex32(),
+                            listId: bizConfigMenu.listId,
+                            searchParamData: { searchType: '3', type: 'and' },
+                            terminal: 'PC', browser: 'Chrome', requiredMatch: 1, mapResult: 1,
+                            recheckQuery: 1, isFollow: 0, isShareToMe: 0, filterCondition: {},
+                            cusMenuId: bizConfigMenu.cusMenuId, urlPageTitle: '业务配置映射表', menuName: '业务配置映射表',
+                        },
+                        headers: { ebBusinessId: bizConfigMenu.listId },
+                    }));
+                    const rows = response?.data?.data || [];
+                    if (!rows.length)
+                        break;
+                    for (const row of rows) {
+                        if (String(row.config_key || '') === '28' && row.config) {
+                            const match = String(row.config).match(/\/sp\/ebdpage\/view\/(\d+)/);
+                            if (match)
+                                ebdDetailPageId = match[1];
+                        }
+                        if (String(row.config_key || '') === '-9999' && String(row.config) === '1')
+                            selfUse = '1';
+                    }
+                    if (rows.length < 100)
+                        break;
+                    current += 1;
+                }
+            }
+        }
+        catch { /* 配置表权限不足不阻塞，保持空 */ }
+    }
+    if (!ebdDetailPageId) {
+        try {
+            const response = (await host.request({
+                path: '/api/bs/ebuilder/page/list',
+                query: { appid: appId },
+            }));
+            for (const page of (Array.isArray(response?.data) ? response.data : [])) {
+                if ((page?.name || '') === '人才卡片' && page?.type === 'PAGE' && page?.id) {
+                    ebdDetailPageId = String(page.id);
+                    break;
+                }
+            }
+        }
+        catch { /* 后台权限不足不阻塞，保持空 */ }
+    }
+    // ds/options 兼容通道（人才库 recruit_status/channel；字典引用类返回空则跳过）
+    const options = {};
+    for (const [dataKey, logic] of [['recruit_status', 'talent_pool'], ['channel', 'talent_pool']]) {
+        const entry = forms[logic] || { objId: '', formId: '', objName: '' };
+        const fieldId = (fields[entry.objId] || {})[dataKey] || '';
+        if (fieldId && entry.objId) {
+            const response = (await host.request({
+                path: '/api/ebuilder/common/ds/options',
+                query: { fieldName: fieldId, objId: entry.objId, sourceType: 'FORM', groupId: appId },
+            }));
+            if (Array.isArray(response?.data)) {
+                options[dataKey] = {};
+                for (const option of response.data) {
+                    if (option?.id)
+                        options[dataKey][String(option.id)] = option.name;
+                }
+            }
+        }
+    }
+    const lists = {
+        talent: null, demand: null, position: null, entry: null, offer: null,
+        interview: null, dict: dictMenu, biz_config: bizConfigMenu,
+        all_search: searchMenus, pages,
+    };
+    for (const [biz, keywords] of Object.entries(LIST_KEYWORDS)) {
+        for (const menu of searchMenus) {
+            if (keywords.some((keyword) => (menu.menuName || '').includes(keyword))) {
+                lists[biz] = menu;
+                break;
+            }
+        }
+    }
+    return {
+        appId,
+        tenantKey,
+        forms,
+        lists,
+        fields,
+        field_options: fieldOptions,
+        options,
+        dict: { by_name: dictByName, raw: dictRaw },
+        ebdDetailPageId,
+        selfUse,
+    };
+}
+export function createRecruitContextLoader() {
+    const memo = new Map();
+    async function load(host) {
+        const session = await host.getSession();
+        const baseUrl = session.baseUrl.replace(/\/+$/, '');
+        const memoKey = baseUrl;
+        // 磁盘缓存优先：目录内唯一 <appId>.json 直接命中（省安装闸门 1 次 RTT，
+        // 与 ehr 技能播种的缓存共享同一目录结构）。
+        let cached = memo.get(memoKey);
+        if (cached)
+            return cached;
+        let appId = '';
+        let diskCache = null;
+        try {
+            const dir = cacheDirFor(baseUrl);
+            if (existsSync(dir)) {
+                const files = readdirSync(dir).filter((file) => file.endsWith('.json'));
+                if (files.length === 1) {
+                    appId = files[0].replace(/\.json$/, '');
+                    diskCache = JSON.parse(readFileSync(join(dir, files[0]), 'utf8'));
+                }
+            }
+        }
+        catch { /* 缓存读取失败回退闸门链路 */ }
+        if (diskCache) {
+            memo.set(memoKey, diskCache);
+            return diskCache;
+        }
+        // 安装闸门：getAppIds(tag) 取 appId（空=未安装招聘服务，必须明确报错）
+        const gate = (await host.request({
+            path: '/api/bs/ebuilder/app/tags/getAppIds',
+            query: { tag: RECRUIT_APP_TAG },
+        }));
+        const appIds = gate?.data;
+        if (!Array.isArray(appIds) || !appIds.length) {
+            throw new RecruitContextError('recruit_service_not_installed', '当前租户未安装招聘服务（weaver-recruit-service），无法使用招聘能力。请先在 E10 应用市场安装「招聘」应用。');
+        }
+        appId = String(appIds[0]);
+        const resolved = await resolveRecruitEnv(host, appId);
+        // 写磁盘缓存（结构同 ehr 技能 v5，供后续进程/ehr 技能共享）
+        try {
+            const dir = cacheDirFor(baseUrl);
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(join(dir, `${appId}.json`), JSON.stringify({
+                __meta__: {
+                    capturedAt: new Date().toISOString().replace('T', ' ').substring(0, 19),
+                    note: 'recruit-ops 环境参数缓存（weaver-work-cli 运行时解析产物，不含认证字段）',
+                },
+                envKey: `${dir.split(/[\\/]/).pop()}|${appId}`,
+                ...resolved,
+            }, null, 2), 'utf8');
+        }
+        catch { /* 缓存落盘失败不影响本次调用 */ }
+        memo.set(memoKey, resolved);
+        return resolved;
+    }
+    return { load };
+}
+/** EB 列表通用查询体（同 recruit-list.mjs baseBody） */
+function buildListBody(params) {
+    return {
+        current: params.current ?? 1,
+        pageSize: params.pageSize ?? 10,
+        tableuid: randHex32(),
+        listId: params.listId,
+        searchParamData: {
+            searchType: '3',
+            type: 'and',
+            ...(params.conditions && Object.keys(params.conditions).length ? { commonSearchFields: params.conditions } : {}),
+        },
+        terminal: 'PC',
+        browser: 'Chrome',
+        requiredMatch: 1,
+        mapResult: 1,
+        recheckQuery: 1,
+        isFollow: 0,
+        isShareToMe: 0,
+        filterCondition: {},
+        cusMenuId: params.cusMenuId,
+        urlPageTitle: params.title,
+        menuName: params.menuName,
+    };
+}
+/** 列表 + 计数并行；displayData 优先（同 recruit-search/recruit-list 的显示层策略） */
+async function fetchListRows(host, objId, listId, body) {
+    const countBody = { ...body };
+    delete countBody.current;
+    delete countBody.pageSize;
+    const [listResponse, countResponse] = await Promise.all([
+        host.request({
+            path: `/api/ebuilder/form/list/getListDatas?passid=${objId}&cid=${objId}`,
+            body,
+            headers: { ebBusinessId: listId },
+        }),
+        host.request({
+            path: `/api/ebuilder/form/list/getListDataCount?passid=${objId}&cid=${objId}`,
+            body: countBody,
+            headers: { ebBusinessId: listId },
+        }).catch(() => null),
+    ]);
+    const data = normalizePaged(listResponse).data;
+    const rawRows = data?.data || [];
+    const displayRows = data?.displayData;
+    const hasDisplay = Array.isArray(displayRows) && displayRows.length > 0;
+    const rows = hasDisplay ? displayRows : rawRows;
+    const countData = countResponse ? normalizePaged(countResponse).data : null;
+    const total = countData?.total !== undefined ? countData.total : rows.length;
+    return { rows, displayRows: hasDisplay ? displayRows : null, total };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// operations
+// ─────────────────────────────────────────────────────────────────────────────
+const contextResolve = {
+    name: 'ehr.recruit.context.resolve',
+    resource: 'recruit',
+    method: 'context.resolve',
+    action: 'ehr.recruit.context.resolve',
+    summary: '解析招聘模块运行时参数（appId/表单 objId/列表 listId+cusMenuId/字段映射），主要供调试与兜底；业务 operation 会隐式自动解析',
+    capability: 'recruit',
+    risk: READ,
+    inputSchema: schemaOf({}),
+    handler: async (_args, env) => {
+        if (!env.recruitContext) {
+            throw ehrValidationError('recruit_context_unavailable', '招聘上下文加载器未初始化');
+        }
+        const cache = await env.recruitContext.load(env.host);
+        return ehrSuccess('ehr.recruit.context.resolve', {
+            appId: cache.appId,
+            tenantKey: cache.tenantKey || null,
+            forms: cache.forms,
+            lists: cache.lists,
+            ebdDetailPageId: cache.ebdDetailPageId || null,
+            selfUse: cache.selfUse,
+        });
+    },
+};
+const candidateSearch = {
+    name: 'ehr.recruit.candidate.search',
+    resource: 'recruit',
+    method: 'candidate.search',
+    action: 'ehr.recruit.candidate.search',
+    summary: '按姓名/手机号模糊搜索人才库人才；无筛选条件时列出全部人才用于浏览。返回白名单展示字段',
+    capability: 'recruit',
+    risk: READ,
+    inputSchema: schemaOf({
+        name: { type: 'string', description: '姓名模糊匹配' },
+        mobile: { type: 'string', description: '手机号模糊匹配' },
+        current: SCHEMA_ID,
+        pageSize: SCHEMA_ID,
+    }),
+    handler: async (args, env) => {
+        if (!env.recruitContext) {
+            throw ehrValidationError('recruit_context_unavailable', '招聘上下文加载器未初始化');
+        }
+        const cache = await env.recruitContext.load(env.host);
+        const talentList = cache.lists.talent;
+        const talentObjId = cache.forms.talent_pool?.objId;
+        if (!talentList?.listId || !talentObjId) {
+            throw new RecruitContextError('recruit_context_missing', '当前环境未解析到「人才库」菜单或人才库表单，无法搜索人才。请先运行 ehr.recruit.context.resolve 检查环境。');
+        }
+        const fields = cache.fields[talentObjId] || {};
+        const nameField = 'field_' + (fields.candidate_name || fields.name);
+        const mobileField = 'field_' + fields.telephone;
+        const conditions = {};
+        if (args.name)
+            conditions[nameField] = [{ [nameField]: args.name, [`${nameField}_condition_type`]: 'like' }];
+        if (args.mobile)
+            conditions[mobileField] = [{ [mobileField]: args.mobile, [`${mobileField}_condition_type`]: 'like' }];
+        const body = buildListBody({
+            listId: talentList.listId,
+            cusMenuId: talentList.cusMenuId,
+            menuName: talentList.menuName || '人才管理',
+            title: '人才库',
+            current: toPositiveInt(args.current, 'current') ?? 1,
+            pageSize: toNumber(args.pageSize, 'pageSize') ?? 10,
+            conditions,
+        });
+        const { rows, displayRows, total } = await fetchListRows(env.host, talentObjId, talentList.listId, body);
+        // 显示层优先：displayData 已内联人员/字典中文，零额外请求；
+        // 缺失时回退原始层：字典映射 + 纯 ID 经 hrm getEmployeeByIds 批量反查（兜底，行为不变）
+        let creatorNameMap = {};
+        if (!displayRows) {
+            const pureIds = [...new Set(rows
+                    .map((row) => row?.creator)
+                    .filter(isPlainId)
+                    .map((value) => String(value).trim()))];
+            if (pureIds.length) {
+                creatorNameMap = {};
+                for (let index = 0; index < pureIds.length; index += 100) {
+                    const batch = pureIds.slice(index, index + 100);
+                    try {
+                        const response = (await env.host.request({
+                            path: '/api/hrm/common/getEmployeeByIds',
+                            body: { userIdList: batch, externalIdList: [] },
+                            headers: { devtype: '5' },
+                        }));
+                        for (const user of response?.data?.userList || []) {
+                            if (user?.id != null)
+                                creatorNameMap[String(user.id)] = user.name || null;
+                        }
+                    }
+                    catch { /* 单批失败回退裸 ID */ }
+                }
+            }
+        }
+        const statusMap = cache.options?.recruit_status || {};
+        const dictNameMap = {};
+        for (const item of cache.dict?.raw || []) {
+            if (item.option_id && item.selection_name)
+                dictNameMap[item.option_id] = item.selection_name;
+        }
+        const dataRows = rows.map((row) => {
+            let creator = null;
+            if (displayRows) {
+                creator = namesOf(row?.creator);
+            }
+            else if (row?.creator != null) {
+                const raw = String(row.creator).trim();
+                creator = isPlainId(raw) ? (creatorNameMap[raw] || raw) : (namesOf(raw) || raw);
+            }
+            return {
+                talentId: row?.form_data_id || row?.id || null,
+                name: row?.candidate_name || row?.name || null,
+                mobile: row?.telephone || null,
+                channel: dictNameMap[row?.channel] || row?.channel || null,
+                status: statusMap[row?.recruit_status] || row?.recruit_status || null,
+                creator,
+                createTime: row?.create_time || null,
+            };
+        });
+        return ehrSuccess('ehr.recruit.candidate.search', { total, rows: dataRows });
+    },
+};
+const candidateList = {
+    name: 'ehr.recruit.candidate.list',
+    resource: 'recruit',
+    method: 'candidate.list',
+    action: 'ehr.recruit.candidate.list',
+    summary: '查询招聘业务列表（demand 招聘需求 / position 招聘职位 / entry 入职管理 / offer 录用管理），displayData 显示层零翻译输出',
+    capability: 'recruit',
+    risk: READ,
+    inputSchema: schemaOf({
+        type: { type: 'string', enum: ['demand', 'position', 'entry', 'offer'], description: '列表类型' },
+        current: SCHEMA_ID,
+        pageSize: SCHEMA_ID,
+    }, { required: ['type'] }),
+    handler: async (args, env) => {
+        const type = typeof args.type === 'string' ? args.type : '';
+        const listType = LIST_TYPES[type];
+        if (!listType) {
+            throw ehrValidationError('enum_invalid', `type 取值必须是 ${Object.keys(LIST_TYPES).join(' / ')} 之一`);
+        }
+        if (!env.recruitContext) {
+            throw ehrValidationError('recruit_context_unavailable', '招聘上下文加载器未初始化');
+        }
+        const cache = await env.recruitContext.load(env.host);
+        const listParam = cache.lists[listType.listKey];
+        if (!listParam?.listId) {
+            throw new RecruitContextError('recruit_list_unavailable', `当前环境未启用「${listType.title}」功能（未找到对应菜单/列表参数，按能力探测拦截）。`);
+        }
+        const formObjId = cache.forms[listType.formType]?.objId;
+        if (!formObjId) {
+            throw new RecruitContextError('recruit_context_missing', `未解析到「${listType.title}」对应表单，无法查询。`);
+        }
+        const body = buildListBody({
+            listId: listParam.listId,
+            cusMenuId: listParam.cusMenuId,
+            menuName: listParam.menuName || listType.title,
+            title: listType.title,
+            current: toPositiveInt(args.current, 'current') ?? 1,
+            pageSize: toNumber(args.pageSize, 'pageSize') ?? 10,
+        });
+        const { rows, displayRows, total } = await fetchListRows(env.host, formObjId, listParam.listId, body);
+        const outRows = rows.map((row) => {
+            const cleaned = { form_data_id: row?.form_data_id || row?.id };
+            for (const [key, value] of Object.entries(row || {})) {
+                if (displayRows) {
+                    // 显示层：剔除 UI/内部键与动态后缀，门户数组/对象取 name 连接
+                    if (DISPLAY_UI_KEYS.has(key) || key === 'form_data_id')
+                        continue;
+                    if (key.endsWith('Span') || key.endsWith('Action'))
+                        continue;
+                    const text = String(value ?? '');
+                    if (!text)
+                        continue;
+                    if (typeof value === 'object' || (typeof value === 'string' && text.trimStart().startsWith('['))) {
+                        const names = namesOf(value);
+                        cleaned[key] = names != null ? names : text;
+                        continue;
+                    }
+                    cleaned[key] = text;
+                    continue;
+                }
+                // 原始层兜底：只输出可读值（非内部键、非 16+ 位裸大 ID）
+                if (INTERNAL_KEYS.has(key))
+                    continue;
+                const text = String(value ?? '');
+                if (!text)
+                    continue;
+                if (/^\d{16,}$/.test(text))
+                    continue;
+                const names = typeof value === 'object' || (typeof value === 'string' && text.trimStart().startsWith('['))
+                    ? namesOf(value)
+                    : null;
+                cleaned[key] = names != null ? names : text;
+            }
+            return cleaned;
+        });
+        return ehrSuccess('ehr.recruit.candidate.list', {
+            type, total, current: body.current, pageSize: body.pageSize, rows: outRows,
+        });
+    },
+};
+const candidateCard = {
+    name: 'ehr.recruit.candidate.card',
+    resource: 'recruit',
+    method: 'candidate.card',
+    action: 'ehr.recruit.candidate.card',
+    summary: '查看人才详情卡片：权限校验 + 四张卡片（基本信息/应聘进展/面试安排/沟通备注）并行拉取，姓名与字典全部内联解析',
+    capability: 'recruit',
+    risk: READ,
+    inputSchema: schemaOf({ talentId: { oneOf: [{ type: 'integer' }, { type: 'string', pattern: '^\\d+$' }], description: '人才 ID，来自 candidate.search 的 talentId' } }, { required: ['talentId'] }),
+    handler: async (args, env) => {
+        const talentId = args.talentId;
+        if (talentId === undefined || talentId === null || talentId === '') {
+            throw ehrValidationError('talent_id_required', 'talentId 必填');
+        }
+        if (!/^\d+$/.test(String(talentId).trim())) {
+            throw ehrValidationError('talent_id_invalid', 'talentId 必须是数字 ID');
+        }
+        const id = String(talentId).trim();
+        if (!env.recruitContext) {
+            throw ehrValidationError('recruit_context_unavailable', '招聘上下文加载器未初始化');
+        }
+        const cache = await env.recruitContext.load(env.host);
+        const talentListId = cache.lists.talent?.listId || '';
+        const extra = talentListId ? { ebBusinessId: talentListId } : {};
+        // 权限校验与 batchId 并行（两请求无依赖）；权限闸门仍严格前置在四张卡片之前
+        const rk1 = randHex6();
+        const [rightsResponse, prepareResponse] = await Promise.all([
+            env.host.request({
+                path: `/api/recruit/talent/hasRights?formDataId=${id}`,
+                method: 'POST',
+                headers: extra,
+            }),
+            env.host.request({
+                path: `/api/recruit/candidate/getCandidateCardPrepareQuery?talentId=${id}&randomkey_${rk1}=${rk1}`,
+                headers: extra,
+            }),
+        ]);
+        const rights = rightsResponse?.data || [];
+        if (!rights.includes('READ')) {
+            throw ehrValidationError('recruit_rights_denied', '当前账号无该人才详情的 READ 权限，无法查看。');
+        }
+        const batchId = prepareResponse?.data?.batchId;
+        if (!batchId) {
+            throw new RecruitContextError('recruit_batch_id_missing', '未取到 batchId（prepareQuery 返回异常），无法查看详情卡片。');
+        }
+        // 四张卡片并行；pageSize 100 防面试/沟通记录被默认 10 条静默截断
+        const rk2 = randHex6();
+        const v = randHex6();
+        const query = `talentId=${id}&batchId=${batchId}&v=${v}&randomkey_${rk2}=${rk2}`;
+        const cardBody = { talentId: id, batchId, current: 1, pageSize: 100 };
+        const [base, other, interview, remark] = await Promise.all([
+            env.host.request({ path: `/api/recruit/candidate/getCandidateCardBaseInfo?${query}`, headers: extra }),
+            env.host.request({ path: `/api/recruit/candidate/getCandidateCardOtherInfo?${query}`, headers: extra }),
+            env.host.request({ path: '/api/recruit/candidate/getCandidateCardInterviewInfo', body: cardBody, headers: extra }),
+            env.host.request({ path: '/api/recruit/candidate/getCandidateCardRemark', body: cardBody, headers: extra }),
+        ]);
+        const statusMap = cache.options?.recruit_status || {};
+        const talent = base?.data?.talent || {};
+        const currentBatch = other?.data?.currentCandidateBatch || {};
+        const interviewList = interview?.data?.list || [];
+        const remarkList = remark?.data?.list || [];
+        const baseUrl = (await env.host.getSession()).baseUrl.replace(/\/+$/, '');
+        return ehrSuccess('ehr.recruit.candidate.card', {
+            talentId: id,
+            cardLink: cache.ebdDetailPageId
+                // selfUse 缓存值为字符串 "0"/"1"，必须 === '1'（字符串 "0" truthy 会误拼 recruitType）
+                ? `${baseUrl}/sp/ebdpage/view/${cache.ebdDetailPageId}?talentId=${id}${String(cache.selfUse ?? '') === '1' ? '&recruitType=useSelf' : ''}`
+                : null,
+            baseInfo: {
+                name: talent?.hrm?.name,
+                mobile: talent?.telephone,
+                channel: talent?.channel,
+                status: statusMap[base?.data?.recruitStatus] || base?.data?.recruitStatus || null,
+                createTime: talent?.createTime,
+            },
+            position: {
+                position: currentBatch?.position?.name,
+                stage: currentBatch?.currentStageName,
+                stages: (currentBatch?.allStage || []).map((stage) => stage?.stageName).filter(Boolean),
+                archiveStatus: currentBatch?.archiveStatus?.name,
+                employManager: namesOf(currentBatch?.employManager),
+                channel: currentBatch?.channel,
+                candidateManageId: currentBatch?.id || currentBatch?.candidateManageId || null,
+                batchId: currentBatch?.batchId || batchId,
+                positionId: currentBatch?.position?.id || null,
+            },
+            interviews: interviewList.map((item) => ({
+                subject: item?.subject,
+                startTime: item?.startTime || null,
+                endTime: item?.endTime || null,
+                status: namesOf(item?.unionStatus),
+                type: namesOf(item?.interviewType),
+                round: namesOf(item?.interviewSession),
+                interviewer: namesOf(item?.interviewer),
+                arranger: namesOf(item?.creator),
+                updater: namesOf(item?.updater),
+                position: namesOf(item?.positionManageId),
+                feedbacks: (item?.interviewFeedBack || []).map((feedback) => ({
+                    result: feedback?.result?.[0]?.name || null,
+                    comment: feedback?.judgement ? feedback.judgement.replace(/<[^>]+>/g, '').trim() : null,
+                    feedbacker: namesOf(feedback?.updater),
+                    createTime: feedback?.createTime,
+                })),
+            })),
+            remarks: remarkList.map((item) => ({
+                time: item?.contactTime || item?.createTime,
+                creator: item?.creator?.username || item?.creator?.name || null,
+                content: item?.remark,
+            })),
+        });
+    },
+};
+export const recruitOperations = [
+    contextResolve,
+    candidateSearch,
+    candidateList,
+    candidateCard,
+];
+export const RECRUIT_SECOND_PHASE_WITHHELD = [
+    'recruit.candidate.create',
+    'recruit.interview.arrange',
+    'recruit.offer.send',
+    'recruit.entry.process',
+    'recruit.interview.feedback.edit',
+    'recruit.interview.feedback.urge',
+    'recruit.entry.cancel.change',
+];
+export { compact, toPageQuery };