weaver-work-cli 0.1.40 → 0.1.42

package/dist/shortcuts/meeting/operations/eb/room-recommend.js

@@ -66,11 +66,15 @@ function normalizeRoom(row) {
         place: toText(main.place).trim(),
         equipments: toText(main.equipments).trim(),
         mrType: toText(main.mr_type).trim(),
+        // ⛔ 2026-11-04 真机发现：以前没映射 room_desc，`roomDesc` 永远是 undefined，
+        // 于是「带客户优先接待类」里**按描述文案判定**那一半从来没生效过（只有名称含「接待」的能命中）。
+        // 例：广州会议室四 的描述「用来接待重要来宾…」明明写着，却被当普通房间。
+        roomDesc: toText(main.room_desc).trim(),
     };
 }
 /** 全量会议室：优先缓存（24h），`refresh:true` 强制重拉。 */
 export async function loadRooms(env, options = {}) {
-    const key = `rooms-v2-${await cacheScopeSuffix(env)}`;
+    const key = `rooms-v3-${await cacheScopeSuffix(env)}`;
     const warnings = [];
     if (!options.refresh) {
         const cached = await readCache(env, key, { ttlMs: ROOMS_TTL_MS });
@@ -124,10 +128,19 @@ export async function loadFrequentRooms(env, options = {}) {
     try {
         const { getMeetingOperation } = await import('../registry.js');
         const listOp = getMeetingOperation('meeting.eb.meeting.list');
-        for (let pageNo = 1; pageNo <= 5; pageNo += 1) {
-            const page = await listOp.handler({ creator: userId, begindatetime: sinceText, pageNo, pageSize: PAGE_SIZE }, env);
+        // ⛔ 2026-11-04 实测：会议列表接口**每页固定 10 条**（pageSize=200 也无效），
+        // 以前只扫 5 页 = 最近 50 场，而用户 180 天有 130+ 场 —— 统计被截断，
+        // 结果全被最近的测试会议带偏（「测试会议室1」排第一就是这么来的）。
+        // 现在按返回的 total 翻到底（封顶 40 页 / 400 场，避免异常数据打爆）。
+        let seen = 0;
+        let total = 0;
+        for (let pageNo = 1; pageNo <= 40; pageNo += 1) {
+            const page = await listOp.handler({ creator: userId, begindatetime: sinceText, pageNo, pageSize: 200 }, env);
             requests += 1;
             const rows = (page?.data?.rows ?? []);
+            if (rows.length === 0)
+                break;
+            total = Number(page?.data?.total ?? total) || total;
             for (const row of rows) {
                 const main = row?.mainTable ?? row ?? {};
                 const name = toText(main.address).trim();
@@ -135,7 +148,8 @@ export async function loadFrequentRooms(env, options = {}) {
                     continue;
                 counts.set(name, (counts.get(name) ?? 0) + 1);
             }
-            if (rows.length < PAGE_SIZE)
+            seen += rows.length;
+            if (total > 0 && seen >= total)
                 break;
         }
     }
@@ -200,6 +214,10 @@ export async function recommendRooms(env, input) {
     });
     const memberCount = input.memberCount && input.memberCount > 0 ? input.memberCount : null;
     const requirement = input.requirement ?? {};
+    // 兼容顶层 hasCustomer（建会链路以前就是传顶层，打分却只读 requirement.hasCustomer，
+    // 导致「带客户优先接待类」从来没生效过 —— 2026-11-04 用户实测 3 个候选全是普通会议室）。
+    if (input.hasCustomer === true)
+        requirement.hasCustomer = true;
     const usable = roomData.rooms.filter((room) => room.status === '0');
     let busyCount = 0;
     const candidates = [];
@@ -258,14 +276,16 @@ export async function recommendRooms(env, input) {
             reasons.push(`设备含「${requirement.equipmentsKeyword}」`);
             score += 10;
         }
-        // 带客户时优先接待类：会议室描述（room_desc）或名称里带「接待/招待/客户/商务/贵宾」的加分。
-        // 描述原文会一起返回，用户能自己判断为什么推这间。
+        // 带客户时优先接待类：会议室描述（room_desc）或名称里带「接待/招待/贵宾/商务」的加分。
+        // ⛔ 不要把「客户」单独当关键词：`e-message（建议客户培训）` 这种培训室会被误判成接待类，
+        // 直接加 35 分排到第一（2026-11-04 真机实测）。真正的接待房名称/描述里一定带「接待」。
         if (requirement.hasCustomer === true) {
-            const hostText = `${room.roomDesc ?? ''} ${room.name}`;
-            const hostHit = hostText.match(/(接待|招待|客户|商务|贵宾|vip|VIP)/u);
+            const desc = String(room.roomDesc ?? '').trim();
+            const nameHit = room.name.match(/(接待|招待|贵宾|商务|vip)/iu);
+            const descHit = desc.match(/(接待|招待|贵宾|商务|vip)/iu);
+            const hostHit = nameHit ?? descHit;
             if (hostHit) {
-                const desc = String(room.roomDesc ?? '').trim();
-                reasons.push(`带客户优先：${desc !== '' ? `描述含「${desc.slice(0, 30)}」` : `名称含「${hostHit[1]}」`}`);
+                reasons.push(`带客户优先：${descHit ? `描述含「${desc.slice(0, 30)}」` : `名称含「${hostHit[1]}」`}`);
                 score += 35;
             }
         }
@@ -390,6 +410,8 @@ export const ebRoomRecommendOperation = {
                 ...(args.mrType ? { mrType: String(args.mrType) } : {}),
                 ...(args.roomAttr ? { roomAttr: String(args.roomAttr) } : {}),
                 ...(args.equipmentsKeyword ? { equipmentsKeyword: String(args.equipmentsKeyword) } : {}),
+                // 2026-11-04 修：以前漏了它 —— 用户传了 hasCustomer，打分却读 requirement.hasCustomer，永远 false
+                ...(args.hasCustomer === true ? { hasCustomer: true } : {}),
             },
             ...(args.topN !== undefined ? { topN: Number(args.topN) } : {}),
             ...(args.refresh === true ? { refreshRooms: true, refreshFrequent: true } : {}),
@@ -417,7 +439,7 @@ export async function rememberFrequentRoom(env, roomId) {
     if (!id)
         return false;
     const scope = await cacheScopeSuffix(env);
-    const roomsCached = await readCache(env, `rooms-v2-${scope}`, { ttlMs: ROOMS_TTL_MS });
+    const roomsCached = await readCache(env, `rooms-v3-${scope}`, { ttlMs: ROOMS_TTL_MS });
     const name = roomsCached?.data?.find((room) => room.id === id)?.name ?? '';
     if (!name)
         return false;

package/dist/shortcuts/project/operations/read.js

@@ -1,15 +1,9 @@
 import { assertDatajsonSuccess, assertWeaverSuccess, } from '../host.js';
 import { projectValidationError } from '../errors.js';
 import { SCHEMA_FILTERS, SCHEMA_FIELDS, SCHEMA_ID_STRING, SCHEMA_PAGE_NO, SCHEMA_PAGE_SIZE, projectSuccess, schemaOf, } from './types.js';
-import { compactFilters, idString, operatorId, positiveInt, queryText, } from './shared.js';
+import { buildCardUrl, compactFilters, idString, operatorId, positiveInt, queryText, resolveObjectId, } from './shared.js';
 const APP_TAG = 'weaver-project-eb';
-const DEFAULT_OBJ_IDS = { task: '1020270486210527232', project: '1020275562853482532' };
 const MIN_VERSION = [20, 6, 11];
-function buildCardUrl(baseUrl, objId, dataId) {
-    if (!baseUrl || !objId || !dataId || /[\s/\\?#]/u.test(dataId))
-        return null;
-    return `${baseUrl.replace(/\/+$/u, '')}/sp/ebdfpage/card/0/${objId}/${dataId}`;
-}
 const CURRENT_USER_FILTERS = new Set([
     'manager',
     'participant',
@@ -114,7 +108,7 @@ async function decorateDetailUrls(host, operation, datajson) {
     if (targets.length === 0)
         return datajson;
     try {
-        const objId = await getObject(host, operationTable(operation));
+        const objId = await resolveObjectId(host, operationTable(operation));
         const session = await host.getSession();
         for (const row of targets) {
             const url = buildCardUrl(session.baseUrl, objId, String(row.id));
@@ -161,19 +155,6 @@ async function getAppId(host) {
         throw new Error('当前环境未安装事井然项目管理应用');
     return appId;
 }
-async function getObject(host, value) {
-    const response = await host.request({
-        method: 'GET',
-        path: '/api/ebproject/backendConsole/getCurrentObjId',
-        query: { objId: DEFAULT_OBJ_IDS[value] },
-        operation: 'project.object.id',
-    });
-    assertWeaverSuccess(response, 'project.object.id');
-    const object = String(response?.data ?? '');
-    if (!object)
-        throw new Error('接口未返回当前环境对象 ID');
-    return object;
-}
 async function datajsonRequest(host, operation, path, payload, query) {
     const response = await host.request({
         method: 'POST',
@@ -383,7 +364,7 @@ export const projectReadOperations = [
         inputSchema: schemaOf({ table: { type: 'string', enum: ['task', 'project'] } }, { required: ['table'] }),
         handler: async (args, { host }) => {
             const value = table(args.table);
-            return projectSuccess('project.object.id', { table: value, objId: await getObject(host, value) });
+            return projectSuccess('project.object.id', { table: value, objId: await resolveObjectId(host, value) });
         },
     },
     {
@@ -417,7 +398,7 @@ export const projectReadOperations = [
         handler: async (args, { host }) => {
             const value = table(args.table);
             const groupId = args.groupId ? String(args.groupId) : await getAppId(host);
-            const sourceId = args.sourceId ? String(args.sourceId) : await getObject(host, value);
+            const sourceId = args.sourceId ? String(args.sourceId) : await resolveObjectId(host, value);
             const response = await host.request({
                 method: 'POST',
                 path: '/api/ebuilder/common/ds/fields',
@@ -456,7 +437,7 @@ export const projectReadOperations = [
         handler: async (args, { host }) => {
             const value = table(args.table);
             const groupId = args.groupId ? String(args.groupId) : await getAppId(host);
-            const sourceId = args.sourceId ? String(args.sourceId) : await getObject(host, value);
+            const sourceId = args.sourceId ? String(args.sourceId) : await resolveObjectId(host, value);
             const response = await host.request({
                 method: 'GET',
                 path: '/api/ebuilder/common/ds/options',
@@ -549,4 +530,4 @@ export const projectReadOperations = [
     hrmOperation('project.department.resolve', '/api/hrm/common/browser/data/department', 'organization', '按名称精确或模糊解析部门 ID'),
     hrmOperation('project.subcompany.resolve', '/api/hrm/common/browser/data/subcompany', 'organization', '按名称精确或模糊解析分部 ID'),
 ];
-export { getAppId, getObject, SCHEMA_FIELDS };
+export { getAppId, resolveObjectId as getObject, SCHEMA_FIELDS };

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

@@ -1,4 +1,5 @@
 import { projectValidationError } from '../errors.js';
+import { assertWeaverSuccess } from '../host.js';
 export function asObject(value, field = 'input') {
     if (!value || typeof value !== 'object' || Array.isArray(value)) {
         throw projectValidationError('field_invalid', `${field} 必须是 JSON 对象`);
@@ -66,3 +67,24 @@ export function stableFingerprint(value) {
     }
     return `${text.length}:${hash.toString(16)}`;
 }
+export const DEFAULT_OBJ_IDS = { task: '1020270486210527232', project: '1020275562853482532' };
+/** 详情卡片地址：`{baseUrl}/sp/ebdfpage/card/0/{objId}/{dataId}`。参数不全或 dataId 含分隔符时返回 null。 */
+export function buildCardUrl(baseUrl, objId, dataId) {
+    if (!baseUrl || !objId || !dataId || /[\s/\\?#]/u.test(dataId))
+        return null;
+    return `${baseUrl.replace(/\/+$/u, '')}/sp/ebdfpage/card/0/${objId}/${dataId}`;
+}
+/** 解析当前环境下的表单对象 ID（列表/详情/新建共用）。 */
+export async function resolveObjectId(host, value) {
+    const response = await host.request({
+        method: 'GET',
+        path: '/api/ebproject/backendConsole/getCurrentObjId',
+        query: { objId: DEFAULT_OBJ_IDS[value] },
+        operation: 'project.object.id',
+    });
+    assertWeaverSuccess(response, 'project.object.id');
+    const object = String(response?.data ?? '');
+    if (!object)
+        throw new Error('接口未返回当前环境对象 ID');
+    return object;
+}

package/dist/shortcuts/project/operations/write.js

@@ -1,7 +1,7 @@
 import { projectPartialError, projectValidationError } from '../errors.js';
 import { assertDatajsonSuccess } from '../host.js';
 import { SCHEMA_CONFIRM, SCHEMA_CONTINUATION, SCHEMA_FIELDS, SCHEMA_ID_STRING, SCHEMA_RECORDS, projectSuccess, schemaOf, } from './types.js';
-import { asObject, idString, operatorId, stableFingerprint } from './shared.js';
+import { asObject, buildCardUrl, idString, operatorId, resolveObjectId, stableFingerprint } from './shared.js';
 const WRITE_TARGETS = {
     taskCreate: { entity: 'task', action: 'create', listPath: '', detailPath: '/api/ebuilder/form/formdata/v2/getFormDataByPk/queryTaskDetail', writePath: '/api/ebuilder/form/formdata/v2/saveFormData/createTask' },
     taskUpdate: { entity: 'task', action: 'update', listPath: '', detailPath: '/api/ebuilder/form/formdata/v2/getFormDataByPk/queryTaskDetail', writePath: '/api/ebuilder/form/formdata/v2/updateFormData/updateTask' },
@@ -62,6 +62,31 @@ async function sendWrite(host, operation, path, datajsonObject) {
     assertDatajsonSuccess(response, operation);
     return response?.datajson ?? null;
 }
+/**
+ * 新建成功后，把返回的 dataIds 映射成详情页地址，供展示层把记录名称渲染为可点击链接。
+ * 链接解析失败不影响创建结果（写入已成功），只附带 detail_url_warning。
+ */
+async function decorateCreatedRecords(host, entity, data) {
+    if (!data || typeof data !== 'object')
+        return data;
+    const value = data;
+    const ids = Array.isArray(value.dataIds)
+        ? value.dataIds.map((item) => String(item)).filter((item) => item !== '')
+        : [];
+    if (ids.length === 0)
+        return data;
+    try {
+        const [objId, session] = await Promise.all([resolveObjectId(host, entity), host.getSession()]);
+        const urls = ids.map((id) => buildCardUrl(session.baseUrl, objId, id));
+        return urls.some((url) => url !== null) ? { ...value, detail_urls: urls } : data;
+    }
+    catch (error) {
+        return {
+            ...value,
+            detail_url_warning: `详情链接暂不可用：${error instanceof Error ? error.message : String(error)}；创建已成功，不要因此重试。`,
+        };
+    }
+}
 async function verifySession(env, continuation) {
     if (continuation.userId !== await operatorId(env.host)) {
         throw projectValidationError('continuation_mismatch', 'continuation 与当前登录会话不匹配');
@@ -119,7 +144,8 @@ function createOperations(namePrefix, target) {
                 await verifySession(env, continuation);
                 const datajson = asObject(continuation.datajson, 'continuation.datajson');
                 const response = await sendWrite(env.host, applyName, target.writePath, datajson);
-                return projectSuccess(applyName, response, { targetType: target.entity, writeAction: 'create' });
+                const data = await decorateCreatedRecords(env.host, target.entity, response);
+                return projectSuccess(applyName, data, { targetType: target.entity, writeAction: 'create' });
             },
         },
     ];

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

@@ -0,0 +1,119 @@
+import { join, resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { createRecruitContextLoader, } from '../ehr/operations/recruit.js';
+import { rsFail } from './errors.js';
+const flowMemo = new Map();
+const digitalMenuMemo = new Map();
+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);
+}
+/**
+ * 磁盘缓存兼容：脚本版（recruit-stage 技能）播种的缓存里若已带 defaultRecruitFlow /
+ * lists.digital_human，直接复用（同环境免请求）；CLI 侧则运行时解析一次并 memo。
+ */
+async function readLegacyCacheExtra(baseUrl) {
+    try {
+        const dir = cacheDirFor(baseUrl);
+        if (!existsSync(dir))
+            return { defaultRecruitFlow: null, digitalHumanMenu: null };
+        const files = (await import('node:fs/promises')).readdir(dir);
+        const jsonFiles = (await files).filter((f) => f.endsWith('.json'));
+        if (jsonFiles.length !== 1)
+            return { defaultRecruitFlow: null, digitalHumanMenu: null };
+        const raw = JSON.parse(await readFile(join(dir, jsonFiles[0]), 'utf8'));
+        const flow = raw?.defaultRecruitFlow && raw.defaultRecruitFlow.id
+            ? { id: String(raw.defaultRecruitFlow.id), name: String(raw.defaultRecruitFlow.name || '') }
+            : null;
+        const dh = raw?.lists?.digital_human?.listId
+            ? {
+                menuName: String(raw.lists.digital_human.menuName || '面试数字人配置'),
+                listId: String(raw.lists.digital_human.listId),
+                cusMenuId: String(raw.lists.digital_human.cusMenuId || ''),
+            }
+            : null;
+        return { defaultRecruitFlow: flow, digitalHumanMenu: dh };
+    }
+    catch {
+        return { defaultRecruitFlow: null, digitalHumanMenu: null };
+    }
+}
+/** 默认招聘流程解析：招聘设置/流程列表中「默认启用」的那条（运行时解析，跨环境不写死）。 */
+async function resolveDefaultRecruitFlow(host, baseUrl, appId) {
+    const memoKey = baseUrl;
+    if (flowMemo.has(memoKey))
+        return flowMemo.get(memoKey) ?? null;
+    const legacy = await readLegacyCacheExtra(baseUrl);
+    if (legacy.defaultRecruitFlow) {
+        flowMemo.set(memoKey, legacy.defaultRecruitFlow);
+        return legacy.defaultRecruitFlow;
+    }
+    let result = null;
+    try {
+        // 招聘流程配置（ hire structures ）：优先业务配置通道；接口不可用或为空时保持 null（由摘要标注"未解析到默认流程"）
+        const r = await host.request({
+            path: '/api/recruit/position/recruitFlow/list',
+            method: 'POST',
+            body: { appId, current: 1, pageSize: 50 },
+            operation: 'context.defaultRecruitFlow',
+        });
+        const rows = r?.data?.list || r?.data?.rows || r?.data || [];
+        const list = Array.isArray(rows) ? rows : [];
+        const enabled = list.find((x) => x && (x.isDefault === true || Number(x.isDefault) === 1 || x.default_flow === '1'))
+            || list.find((x) => x && x.id);
+        if (enabled?.id) {
+            result = { id: String(enabled.id), name: String(enabled.name || enabled.flow_name || '') };
+        }
+    }
+    catch { /* 接口形态不符/未开放：保持 null，不阻塞建职位 */ }
+    flowMemo.set(memoKey, result);
+    return result;
+}
+async function resolveDigitalHumanMenu(host, baseUrl, cache) {
+    const memoKey = baseUrl;
+    if (digitalMenuMemo.has(memoKey))
+        return digitalMenuMemo.get(memoKey) ?? null;
+    const legacy = await readLegacyCacheExtra(baseUrl);
+    if (legacy.digitalHumanMenu) {
+        digitalMenuMemo.set(memoKey, legacy.digitalHumanMenu);
+        return legacy.digitalHumanMenu;
+    }
+    // 从 all_search 菜单里按别名找（跨基线菜单名不同：面试数字人配置/数字人配置）
+    const allSearch = (cache.lists?.all_search || []);
+    const candidates = allSearch.filter((m) => m.listId);
+    let hit = (candidates.find((m) => (m.menuName || '').includes('面试数字人'))
+        || candidates.find((m) => (m.menuName || '').includes('数字人配置'))) ?? null;
+    digitalMenuMemo.set(memoKey, hit);
+    return hit;
+}
+const loaders = new Map();
+export function createRecruitStageContext() {
+    return async (host) => {
+        const loaderKey = 'shared';
+        if (!loaders.has(loaderKey))
+            loaders.set(loaderKey, createRecruitContextLoader());
+        const cache = await loaders.get(loaderKey).load(host);
+        const baseUrl = (await host.getSession()).baseUrl.replace(/\/+$/, '');
+        const [defaultRecruitFlow, digitalHumanMenu] = await Promise.all([
+            resolveDefaultRecruitFlow(host, baseUrl, cache.appId),
+            resolveDigitalHumanMenu(host, baseUrl, cache),
+        ]);
+        return { ...cache, defaultRecruitFlow, digitalHumanMenu };
+    };
+}
+/** 供 operation 内直接取上下文的辅助（失败统一转 rs 错误）。 */
+export async function loadContext(host) {
+    try {
+        return await createRecruitStageContext()(host);
+    }
+    catch (e) {
+        throw rsFail(e?.message || '招聘环境上下文解析失败', { stage: 'context' });
+    }
+}

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

@@ -0,0 +1,73 @@
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { rsValidationError } from './errors.js';
+function stateRoot(ctx) {
+    const configured = ctx?.config?.path();
+    if (configured)
+        return resolve(configured, '..');
+    return process.env.WEAVER_WORK_CLI_HOME || process.env.WORK_CLI_HOME || resolve(homedir(), '.weaver-work-cli');
+}
+async function loadKey(ctx) {
+    const keysDir = resolve(stateRoot(ctx), 'keys');
+    const filename = resolve(keysDir, 'recruit-stage-continuation.key');
+    await mkdir(keysDir, { recursive: true, mode: 0o700 });
+    if (existsSync(filename))
+        return readFile(filename);
+    const key = randomBytes(32);
+    try {
+        await writeFile(filename, key, { flag: 'wx', mode: 0o600 });
+        if (process.platform !== 'win32')
+            await chmod(filename, 0o600).catch(() => undefined);
+        return key;
+    }
+    catch {
+        return readFile(filename);
+    }
+}
+function encode(value) {
+    return Buffer.from(JSON.stringify(value)).toString('base64url');
+}
+function signature(payload, key) {
+    return createHmac('sha256', key).update(payload).digest('base64url');
+}
+export function createRecruitStageContinuationSigner(ctx) {
+    return {
+        async issue(payload, ttlMs = 10 * 60_000) {
+            const issuedAt = Date.now();
+            const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
+            const sig = signature(body, await loadKey(ctx));
+            return `${body}.${sig}`;
+        },
+        async verify(token, expectedOperation) {
+            if (typeof token !== 'string' || !token.includes('.')) {
+                throw rsValidationError('continuation_invalid', 'continuation 无效');
+            }
+            const [body, provided] = token.split('.');
+            const expected = signature(body, await loadKey(ctx));
+            const valid = provided.length === expected.length
+                && timingSafeEqual(Buffer.from(provided), Buffer.from(expected));
+            if (!valid)
+                throw rsValidationError('continuation_invalid', 'continuation 签名校验失败');
+            let payload;
+            try {
+                payload = JSON.parse(Buffer.from(body, 'base64url').toString('utf8'));
+            }
+            catch {
+                throw rsValidationError('continuation_invalid', 'continuation 载荷解析失败');
+            }
+            if (!payload || typeof payload !== 'object') {
+                throw rsValidationError('continuation_invalid', 'continuation 载荷必须是对象');
+            }
+            if (typeof payload.expiresAt === 'number' && Date.now() > payload.expiresAt) {
+                throw rsValidationError('continuation_expired', 'continuation 已过期，请重新 prepare');
+            }
+            if (payload.operation && String(payload.operation) !== String(expectedOperation)) {
+                throw rsValidationError('continuation_operation_mismatch', `continuation 属于操作 ${String(payload.operation)}，不能用于 ${expectedOperation}`);
+            }
+            return payload;
+        },
+    };
+}

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

@@ -0,0 +1,65 @@
+import { CliError, ExitCode } from '../../core/errors.js';
+/**
+ * recruit-stage 模块错误类型。
+ * 形态与 ehr 模块一致（type/subtype/details/partialData），
+ * 前缀 rs 避免与 ehr 的错误类型混淆。
+ */
+export class RecruitStageCliError extends CliError {
+    type;
+    subtype;
+    code;
+    retryable;
+    stage;
+    details;
+    partialData;
+    constructor(type, subtype, message, options = {}) {
+        super(message, options.exitCode ?? ExitCode.InternalError);
+        this.name = 'RecruitStageCliError';
+        this.type = type;
+        this.subtype = subtype;
+        this.code = options.code;
+        this.retryable = options.retryable ?? false;
+        this.stage = options.stage;
+        this.details = options.details;
+        this.partialData = options.partialData;
+    }
+}
+export function rsValidationError(subtype, message, details) {
+    return new RecruitStageCliError('validation', subtype, message, {
+        details,
+        exitCode: ExitCode.UsageError,
+    });
+}
+export function rsAuthError(subtype, message, details) {
+    return new RecruitStageCliError('authentication', subtype, message, {
+        details,
+        exitCode: ExitCode.AuthError,
+    });
+}
+export function rsNetworkError(subtype, message, options = {}) {
+    return new RecruitStageCliError('network', subtype, message, {
+        ...options,
+        retryable: options.retryable ?? true,
+        exitCode: ExitCode.NetworkError,
+    });
+}
+export function rsConfirmationError(action, details) {
+    return new RecruitStageCliError('confirmation', 'required', '该操作需要明确确认', {
+        details: { action, ...details },
+        exitCode: ExitCode.ConfirmationRequired,
+    });
+}
+/** 业务失败（对应脚本版 throw new Error(...) 的主通道）。 */
+export function rsFail(message, details) {
+    return new RecruitStageCliError('api', 'business_error', message, {
+        details,
+        exitCode: ExitCode.GeneralError,
+    });
+}
+export function rsPartialError(message, partialData, details) {
+    return new RecruitStageCliError('partial', 'write_uncertain', message, {
+        details,
+        partialData,
+        exitCode: ExitCode.Partial,
+    });
+}

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

@@ -0,0 +1,109 @@
+import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js';
+import { requireE10Session } from '../../internal/e10/context.js';
+import { getActiveProfile } from '../../internal/e10/auth/session.js';
+import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10SessionExpiredResponse } from '../../internal/e10/auth-recovery.js';
+import { rsAuthError, rsNetworkError, RecruitStageCliError, rsValidationError } from './errors.js';
+function inferProfile(ctx) {
+    const options = ctx.getGlobalOptions();
+    return options.profile || getActiveProfile();
+}
+export function assertPath(requestPath) {
+    if (typeof requestPath !== 'string' || !requestPath.startsWith('/') || requestPath.startsWith('//')) {
+        throw rsValidationError('path_invalid', '请求路径必须是相对绝对路径');
+    }
+    if (/^https?:/i.test(requestPath) || /[\r\n]/.test(requestPath) || requestPath.includes('/../')) {
+        throw rsValidationError('path_invalid', '请求路径不允许跨域或路径逃逸');
+    }
+    if (!requestPath.startsWith('/api/')) {
+        throw rsValidationError('path_not_allowed', '只能调用 /api/ 路径');
+    }
+}
+/**
+ * 与 ehr host 的刻意差异：**不做全局 isBusinessSuccess 强判定**。
+ * 原因：EB 表单引擎各接口响应契约不一（getListDatas 返回 {data:{...}} 未必带 status/success/code），
+ * 脚本版（write-op/e10-request.mjs）也只在 saveFormData 等个别接口做业务判定——
+ * 业务成功判定留给各 operation 按接口语义自行处理，宿主只判 HTTP 状态与会话失效。
+ */
+export function createRecruitStageHost(ctx, dependencies = {}) {
+    let e10Session = null;
+    let sessionContext = null;
+    const requireSession = dependencies.requireSession
+        || ((innerCtx) => requireE10Session(innerCtx, { skipProfileEnrichment: true }));
+    async function ensureSession() {
+        if (!e10Session) {
+            e10Session = await requireSession(ctx);
+            sessionContext = {
+                baseUrl: e10Session.getBaseUrl(),
+                profile: inferProfile(ctx),
+                userId: e10Session.userId,
+                tenantKey: e10Session.tenantKey,
+                eteamsId: e10Session.eteamsId,
+            };
+        }
+        return e10Session;
+    }
+    async function getSession() {
+        await ensureSession();
+        return sessionContext;
+    }
+    async function runtime() {
+        return createE10RequestRuntime(ctx, await ensureSession(), {
+            interceptors: dependencies.interceptors,
+            fetch: dependencies.fetch,
+        });
+    }
+    async function request(request) {
+        const { method, path, query, body, operation, multipart, headers: extraHeaders = {}, timeoutMs = 30_000, } = request;
+        assertPath(path);
+        const resolvedMethod = method || (body === undefined && multipart === undefined ? 'GET' : 'POST');
+        let response;
+        try {
+            response = await (await runtime()).requestJson({
+                module: 'recruit-stage',
+                operation,
+                method: resolvedMethod,
+                path,
+                query,
+                body: multipart === undefined ? body : undefined,
+                formData: multipart,
+                headers: { 'X-Requested-With': 'XMLHttpRequest', ...extraHeaders },
+                timeoutMs,
+            });
+        }
+        catch (error) {
+            if (error instanceof E10ApiError && error.type === 'network') {
+                throw rsNetworkError(error.subtype, error.message, {
+                    retryable: error.retryable,
+                    details: error.details,
+                });
+            }
+            throw error;
+        }
+        if (isE10SessionExpiredResponse(response)) {
+            throw rsAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, { httpStatus: response.status });
+        }
+        if (response.parseError) {
+            if (response.status < 200 || response.status >= 300) {
+                throw new RecruitStageCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                    code: response.status,
+                    details: { status: response.status },
+                    exitCode: 1,
+                });
+            }
+            throw rsNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, { retryable: false });
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new RecruitStageCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                code: response.status,
+                details: { status: response.status, message: response.value?.msg },
+                exitCode: 1,
+            });
+        }
+        // 注意：运行时对响应做了 parseJsonPreservingBigInts（16+ 位整数加引号保精度），
+        // 业务代码拿到的 18 位 id 已是字符串形态——脚本版「从原文提取 formDataIds 防丢精度」的
+        // 特殊处理在 CLI 侧不再需要。
+        return response.value;
+    }
+    return { request, getSession };
+}