weaver-work-cli 0.1.40 → 0.1.44

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

@@ -1,7 +1,7 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { createHash } from 'node:crypto';
 import { ehrConfirmationError, ehrPartialError, ehrValidationError, EhrCliError } from '../errors.js';
 import { WRITE, ehrSuccess, schemaOf, } from './types.js';
-const CONTINUATION_TTL_SECONDS = 600;
 function fingerprint(value) {
     return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);
 }
@@ -301,21 +301,28 @@ async function resolveCandidateForWrite(host, cache, talentId) {
         throw ehrValidationError('recruit_batch_id_missing', '未取到 batchId（prepareQuery 返回异常），无法定位候选人应聘批次');
     }
     const v = randomHex6();
-    const otherResponse = (await host.request({
-        path: `/api/recruit/candidate/getCandidateCardOtherInfo?talentId=${talentId}&batchId=${batchId}&v=${v}&randomkey_ab=ab`,
-        headers: extra,
-    }));
-    const batch = otherResponse?.data?.currentCandidateBatch || {};
-    let name = batch?.talent?.name || '';
-    if (!name) {
-        const baseResponse = (await host.request({
+    // otherInfo 必成功（保持原语义）；baseInfo 并行取（姓名兜底 + AI 面试条件必填的邮箱/手机），失败不阻断
+    const [otherResponse, baseResponse] = await Promise.all([
+        host.request({
+            path: `/api/recruit/candidate/getCandidateCardOtherInfo?talentId=${talentId}&batchId=${batchId}&v=${v}&randomkey_ab=ab`,
+            headers: extra,
+        }),
+        host
+            .request({
             path: `/api/recruit/candidate/getCandidateCardBaseInfo?talentId=${talentId}&batchId=${batchId}&v=${v}&randomkey_cd=cd`,
             headers: extra,
-        }));
-        name = baseResponse?.data?.talent?.hrm?.name || '';
-    }
+        })
+            .catch(() => null),
+    ]);
+    const batch = otherResponse?.data?.currentCandidateBatch || {};
+    const talentBase = baseResponse?.data?.talent || {};
+    const name = batch?.talent?.name || talentBase?.hrm?.name || talentBase?.name || '';
+    const email = String(talentBase.email || talentBase.hrm?.email || '').trim();
+    const mobile = String(talentBase.telephone || talentBase.mobile || '').trim();
     return {
         name,
+        email,
+        mobile,
         candidateManageId: batch?.id || batch?.candidateManageId || null,
         positionId: batch?.position?.id || null,
         positionName: batch?.position?.name || null,
@@ -535,6 +542,8 @@ const candidateCreateApply = {
 // 安排面试 operation
 // ---------------------------------------------------------------------------
 const INTERVIEW_TYPES = ['现场面试', '视频面试', '电话面试', 'AI面试'];
+/** AI 面试方案默认值（用户口径：默认「大模型面试」）。若环境无此方案，运行时列出候选让用户选，绝不自动取第一条。 */
+const AI_DEFAULT_PLAN_NAME = '大模型面试';
 const INTERVIEW_DATAKEYS = ['subject', 'start_time', 'end_time', 'interview_type', 'interview_session', 'interviewer',
     'position_manage_id', 'talent_id', 'candidate_manage_id', 'mobile', 'email', 'interview_location', 'notice_mould'];
 function defaultInterviewWindow() {
@@ -544,16 +553,181 @@ function defaultInterviewWindow() {
     const end = new Date(now.getTime() + 60 * 60 * 1000);
     return { start: fmt(now), end: fmt(end) };
 }
+/** 当前登录人（teamsCheck → currentUser.id/username）：面试官未指定时的默认值。
+ *  teamsCheck 响应无 status 字段、不被 isBusinessSuccess 认可，故直连 fetch 绕开业务判定（同 recruit.ts 口径）。 */
+async function resolveCurrentUserForWrite(host) {
+    try {
+        const session = await host.getSession();
+        const baseUrl = String(session?.baseUrl || '');
+        if (!baseUrl)
+            return null;
+        const resp = await fetch(`${baseUrl}/api/baseserver/layout/teamsCheck?clientType=not_xinchuang&client=WEB&domainName=${encodeURIComponent(baseUrl)}`, {
+            method: 'POST',
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                eteamsid: String(session?.eteamsId || ''),
+                cookie: typeof session?.cookieHeader === 'function' ? session.cookieHeader() : '',
+                'user-agent': typeof session?.uaHeader === 'function' ? session.uaHeader() : 'weaver-work-cli',
+                origin: baseUrl,
+            },
+            redirect: 'manual',
+        });
+        const data = await resp.json().catch(() => ({}));
+        const cu = data?.currentUser ?? data?.data?.currentUser ?? null;
+        if (!cu?.id)
+            return null;
+        return { id: String(cu.id), name: String(cu.username || cu.id) };
+    }
+    catch {
+        return null;
+    }
+}
+/** 取表单布局 id（GET 在低基线返 405 → 回退 POST），用于 AI 面试方案的关联字段候选 */
+async function fetchLayoutIdForForm(host, formId) {
+    try {
+        const r = (await host.request({
+            path: `/api/ebuilder/form/form/core/getFormLayout?formId=${encodeURIComponent(formId)}`,
+            method: 'GET',
+        }));
+        const id = r?.data?.formLayout?.id;
+        if (id)
+            return String(id);
+    }
+    catch {
+        // 低基线 GET 405 → POST
+    }
+    try {
+        const r = (await host.request({
+            path: '/api/ebuilder/form/form/core/getFormLayout',
+            method: 'POST',
+            body: { module: 'ebuilderform', formId, terminalType: 'PC' },
+        }));
+        const id = r?.data?.formLayout?.id;
+        if (id)
+            return String(id);
+    }
+    catch {
+        // 布局取不到时回退 formId（页面保存本身也回退 formId）
+    }
+    return formId;
+}
+const DIGITAL_PLAN_NAME_KEYS = ['msfa_name', 'digital_name', 'plan_name', 'scheme_name'];
+/** AI 面试方案（面试数字人）候选：① 关联字段候选接口 → ② 「面试数字人配置」列表兜底。
+ *  🔴 只返回候选，绝不自动取第一条（方案选错=面试由错误的数字人执行）。 */
+async function listDigitalPlansForWrite(host, cache, formId, layoutId, fieldId) {
+    try {
+        const r = (await host.request({
+            path: '/api/ebuilder/form/common/browser/complete/ebuilder',
+            body: {
+                browserMultiple: false,
+                newly: 1,
+                searchValue: '',
+                formParam: JSON.stringify({ formId, layoutId, fieldId, filterItems: [], module: 'ebuilderform', dataDetails: [] }),
+                openScroll: true,
+                controlId: fieldId,
+                businessId: formId,
+                variableMap: {},
+            },
+        }));
+        if (r?.status !== false && r?.data) {
+            const list = r.data.data || [];
+            const items = list
+                .filter((x) => x && x.id)
+                .map((x) => ({ id: String(x.id), name: String(x.name || '').trim() }));
+            if (items.length)
+                return { available: true, items };
+        }
+    }
+    catch {
+        // 回退列表
+    }
+    const menus = (cache.lists?.all_search || []);
+    const menu = menus.find((m) => (m.menuName || '').includes('面试数字人'))
+        || menus.find((m) => (m.menuName || '').includes('数字人配置'));
+    if (!menu?.listId) {
+        return { available: false, items: [], reason: '关联字段候选接口不可用，且当前环境未配置「面试数字人配置」列表菜单' };
+    }
+    let objId = '';
+    try {
+        const r = (await host.request({
+            path: `/api/ebuilder/form/obj/getObjsByTag?appId=${encodeURIComponent(String(cache.appId || ''))}&tag=uf_rcrt_digital_human`,
+            method: 'GET',
+        }));
+        const d = r?.data;
+        if (Array.isArray(d) && d.length)
+            objId = String(d[0]?.id || '');
+    }
+    catch {
+        // 取不到对象 id
+    }
+    if (!objId)
+        return { available: false, items: [], reason: '未能解析「面试数字人配置」对象 id' };
+    const rows = [];
+    for (let cur = 1; cur <= 20; cur++) {
+        const r = (await host.request({
+            path: `/api/ebuilder/form/list/getListDatas?passid=${objId}&cid=${objId}`,
+            body: {
+                current: cur,
+                pageSize: 100,
+                tableuid: randomHex32(),
+                listId: menu.listId,
+                searchParamData: { searchType: '3', type: 'and' },
+                terminal: 'PC',
+                browser: 'Chrome',
+                requiredMatch: 1,
+                mapResult: 1,
+                recheckQuery: 1,
+                isFollow: 0,
+                isShareToMe: 0,
+                filterCondition: {},
+                cusMenuId: menu.cusMenuId,
+                urlPageTitle: menu.menuName,
+                menuName: menu.menuName,
+            },
+            headers: { ebBusinessId: String(menu.listId) },
+        }));
+        const page = r?.data?.data || [];
+        rows.push(...page);
+        if (page.length < 100)
+            break;
+    }
+    const items = rows
+        .map((x) => {
+        const nk = DIGITAL_PLAN_NAME_KEYS.find((k) => String(x[k] || '').trim());
+        return { id: String(x.form_data_id || x.id || ''), name: String(nk ? x[nk] : '').trim() };
+    })
+        .filter((x) => x.id);
+    if (!items.length)
+        return { available: false, items: [], reason: '「面试数字人配置」暂无可选方案' };
+    return { available: true, items };
+}
+/** 方案匹配：id 全等 → 名称全等 → 名称包含（唯一才算命中，否则回歧义列表） */
+function pickDigitalPlanForWrite(items, key) {
+    const k = String(key || '').trim();
+    if (!k)
+        return { plan: null, ambiguous: [] };
+    const byId = items.filter((x) => x.id === k);
+    if (byId.length === 1)
+        return { plan: byId[0], ambiguous: [] };
+    const byExact = items.filter((x) => x.name === k);
+    if (byExact.length === 1)
+        return { plan: byExact[0], ambiguous: [] };
+    const byLike = items.filter((x) => x.name.includes(k));
+    if (byLike.length === 1)
+        return { plan: byLike[0], ambiguous: [] };
+    return { plan: null, ambiguous: byLike };
+}
 async function buildInterviewPlan(env, cache, args) {
     const host = env.host;
     const talentId = requiredString(args, 'talentId', 'talent_id_required', '人才 ID');
     if (!/^\d+$/.test(talentId))
         throw ehrValidationError('talent_id_invalid', 'talentId 必须是数字 ID');
-    const interviewer = requiredString(args, 'interviewer', 'interviewer_required', '面试官姓名');
     const type = typeof args.type === 'string' && args.type.trim() ? args.type.trim() : '现场面试';
     if (!INTERVIEW_TYPES.includes(type)) {
         throw ehrValidationError('enum_invalid', `type（面试方式）取值必须是 ${INTERVIEW_TYPES.join(' / ')} 之一`);
     }
+    const isAI = type === 'AI面试';
     const session = typeof args.session === 'string' && args.session.trim() ? args.session.trim() : '初试';
     const candidate = await resolveCandidateForWrite(host, cache, talentId);
     const positionId = args.positionId ? String(args.positionId) : candidate.positionId;
@@ -582,9 +756,63 @@ async function buildInterviewPlan(env, cache, args) {
     if (!sessionOptionId) {
         throw ehrValidationError('enum_invalid', `面试轮次「${session}」不在枚举中（${Object.keys(sessionMap).join(' / ')}）`);
     }
-    const interviewerId = await resolvePersonId(host, fieldIdOf('interviewer'), interviewer);
-    if (!interviewerId) {
-        throw ehrValidationError('interviewer_not_found', `面试官「${interviewer}」解析不到 userId（browser/complete/resource 无匹配）`);
+    // 面试官：显式指定 → 按名解析；未指定 → 默认当前登录人（少问一次，与页面待办默认口径一致）
+    const interviewerInput = typeof args.interviewer === 'string' ? args.interviewer.trim() : '';
+    let interviewerId = null;
+    let interviewer = interviewerInput;
+    if (interviewerInput) {
+        interviewerId = await resolvePersonId(host, fieldIdOf('interviewer'), interviewerInput);
+        if (!interviewerId) {
+            throw ehrValidationError('interviewer_not_found', `面试官「${interviewerInput}」解析不到 userId（browser/complete/resource 无匹配）`);
+        }
+    }
+    else {
+        const me = await resolveCurrentUserForWrite(host);
+        if (!me) {
+            throw ehrValidationError('interviewer_unresolved', '未指定面试官，且无法解析当前登录人（teamsCheck 失败）；请用 interviewer 参数指定');
+        }
+        // 🔴 teamsCheck 的 currentUser.id 与人员字段 optionId 语义未必相同（实测两者 id 不同），
+        // 故用与显式指定完全相同的解析通道（browser/complete/resource）把姓名换成 userId。
+        interviewerId = await resolvePersonId(host, fieldIdOf('interviewer'), me.name);
+        if (!interviewerId) {
+            throw ehrValidationError('interviewer_unresolved', `未指定面试官，当前登录人「${me.name}」在人员字段中解析不到；请用 interviewer 参数指定`);
+        }
+        interviewer = me.name;
+    }
+    // AI 面试：方案（digital_id）与邮箱都是条件必填，不填保存必失败
+    let aiPlan = null;
+    let aiPlans = [];
+    let email = String(args.email || '').trim() || candidate.email;
+    const mobile = candidate.mobile;
+    if (isAI) {
+        const digitalFid = fieldIdOf('digital_id');
+        if (!digitalFid) {
+            throw ehrValidationError('recruit_field_missing', '面试计划表单缺少「AI面试方案」字段（digital_id），无法安排 AI 面试');
+        }
+        const layoutId = await fetchLayoutIdForForm(host, formId);
+        const plans = await listDigitalPlansForWrite(host, cache, formId, layoutId, digitalFid);
+        aiPlans = plans.items;
+        if (!plans.available) {
+            throw ehrValidationError('ai_plan_unavailable', `AI 面试必须选择「AI面试方案」，但${plans.reason || '暂无可选方案'}；请先在该环境维护「面试数字人配置」`);
+        }
+        // 默认「大模型面试」（用户口径）；环境无此方案时列出候选，绝不自动取第一条
+        const wanted = typeof args.aiPlan === 'string' && args.aiPlan.trim() ? args.aiPlan.trim() : AI_DEFAULT_PLAN_NAME;
+        const picked = pickDigitalPlanForWrite(aiPlans, wanted);
+        if (picked.plan) {
+            aiPlan = picked.plan;
+        }
+        else if (picked.ambiguous.length > 1) {
+            throw ehrValidationError('ai_plan_ambiguous', `AI面试方案「${wanted}」命中多个：${picked.ambiguous.map((x) => x.name).join('、')}，请用 aiPlan 指明具体方案`, { candidates: picked.ambiguous });
+        }
+        else {
+            throw ehrValidationError('ai_plan_not_found', `未找到 AI面试方案「${wanted}」，请用 aiPlan 从候选中指定（候选：${aiPlans.map((x) => x.name).join('、')}）`, { candidates: aiPlans });
+        }
+        if (!email) {
+            throw ehrValidationError('email_required', 'AI 面试要求填写候选人邮箱：人才资料里没有邮箱，请用 email 参数提供');
+        }
+        if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+            throw ehrValidationError('email_invalid', `候选人邮箱格式不正确：${email}`);
+        }
     }
     const window = defaultInterviewWindow();
     const start = typeof args.startTime === 'string' && args.startTime.trim() ? args.startTime.trim() : window.start;
@@ -603,6 +831,9 @@ async function buildInterviewPlan(env, cache, args) {
         { formField: { id: fieldIdOf('position_manage_id') }, dataOptions: [{ optionId: positionId, content: candidate.positionName }] },
         { formField: { id: fieldIdOf('talent_id') }, dataOptions: [{ optionId: talentId, content: candidate.name }] },
         { formField: { id: fieldIdOf('candidate_manage_id') }, dataOptions: [{ optionId: candidate.candidateManageId, content: candidate.candidateManageId }] },
+        ...(mobile ? [{ formField: { id: fieldIdOf('mobile') }, content: mobile }] : []),
+        ...(email ? [{ formField: { id: fieldIdOf('email') }, content: email }] : []),
+        ...(aiPlan ? [{ formField: { id: fieldIdOf('digital_id') }, dataOptions: [{ optionId: aiPlan.id, content: aiPlan.name }] }] : []),
     ];
     return {
         formId, objId, dataDetails,
@@ -610,12 +841,19 @@ async function buildInterviewPlan(env, cache, args) {
         positionName: candidate.positionName,
         interviewTime: `${start} ~ ${end}`,
         interviewer,
+        email: email || undefined,
+        mobile: mobile || undefined,
+        isAIInterview: isAI,
+        aiPlan,
+        aiPlans: isAI ? aiPlans : undefined,
     };
 }
 const interviewArrangeSchema = {
     talentId: { type: 'string', pattern: '^\\d+$', description: '人才 ID（candidate.search 返回的 talentId）' },
-    interviewer: { type: 'string', description: '面试官姓名（须可解析为系统人员）' },
+    interviewer: { type: 'string', description: '面试官姓名（可选；不填默认当前登录人）' },
     type: { type: 'string', enum: [...INTERVIEW_TYPES], description: '面试方式，默认现场面试' },
+    aiPlan: { type: 'string', description: 'AI 面试方案（方案名或 id；type=AI面试 时生效，默认「大模型面试」）' },
+    email: { type: 'string', description: '候选人邮箱（AI 面试必填；不填则取人才资料里的邮箱）' },
     session: { type: 'string', description: '面试轮次（如 初试/复试），默认初试；须在枚举内' },
     positionId: { type: 'string', description: '应聘职位 ID；不填时从人才当前应聘批次继承' },
     startTime: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$', description: '开始时间 YYYY-MM-DD HH:mm，默认当前时间' },
@@ -631,7 +869,7 @@ const interviewArrangePrepare = {
     capability: 'recruit',
     risk: WRITE,
     requiresConfirmation: true,
-    inputSchema: schemaOf({ ...interviewArrangeSchema }, { required: ['talentId', 'interviewer'] }),
+    inputSchema: schemaOf({ ...interviewArrangeSchema }, { required: ['talentId'] }),
     handler: async (args, env) => {
         const cache = await requireRecruitCache(env);
         const plan = await buildInterviewPlan(env, cache, args);
@@ -656,6 +894,13 @@ const interviewArrangePrepare = {
                 session: args.session || '初试',
                 time: plan.interviewTime,
                 interviewer: plan.interviewer,
+                ...(plan.isAIInterview
+                    ? {
+                        aiPlan: plan.aiPlan ? `${plan.aiPlan.name}（id=${plan.aiPlan.id}）` : '(未指定)',
+                        email: plan.email || '(缺失)',
+                        mobile: plan.mobile || '(人才资料无手机号)',
+                    }
+                    : {}),
                 notify: notify ? '将触发「新建日程」面试通知动作流（外部通知）' : '面试通知默认不触发',
             },
             willSubmit: { formId: plan.formId, objId: plan.objId, dataDetails: plan.dataDetails },

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

@@ -15,6 +15,8 @@ import { compact, normalizePaged, toNumber, toPageQuery, toPositiveInt } from '.
 // ─────────────────────────────────────────────────────────────────────────────
 const RECRUIT_APP_TAG = 'weaver-recruit-service';
 /** 逻辑名 -> objTag（权威映射，与 _init_env_cache.mjs 一致） */
+/** 环境缓存结构版本：新增/变更解析字段（如 2026-11-04 补 candidate 应聘者列表）时 +1，旧缓存自动失效重建。 */
+const RECRUIT_CACHE_VERSION = 1;
 const RECRUIT_TAGS = {
     talent_pool: 'uf_rcrt_talent_pool',
     interview_plan: 'uf_rcrt_interview_plan',
@@ -38,7 +40,8 @@ const LIST_KEYWORDS = {
     position: ['招聘职位', '职位列表', '职位管理'],
     entry: ['入职管理'],
     offer: ['录用管理', 'offer管理', 'offer'],
-    interview: ['面试管理'],
+    interview: ['面试管理', '面试安排列表', '面试安排'],
+    candidate: ['应聘者', '候选人', '应聘批次', '应聘管理'],
     biz_config: ['业务配置映射表'],
 };
 /** 列表类型 -> 缓存键 + 表单逻辑名（candidate.list 四列表映射，同 recruit-list.mjs TYPES） */
@@ -47,6 +50,8 @@ export const LIST_TYPES = {
     position: { listKey: 'position', formType: 'position_manage', title: '招聘职位' },
     entry: { listKey: 'entry', formType: 'entry_manage', title: '入职管理' },
     offer: { listKey: 'offer', formType: 'offer', title: '录用管理' },
+    interview: { listKey: 'interview', formType: 'interview_plan', title: '面试管理' },
+    candidate: { listKey: 'candidate', formType: 'candidate_manage', title: '应聘者' },
 };
 /** 剔除与展示无关的内部键（同 recruit-list.mjs） */
 const INTERNAL_KEYS = new Set([
@@ -336,7 +341,7 @@ async function resolveRecruitEnv(host, appId) {
     }
     const lists = {
         talent: null, demand: null, position: null, entry: null, offer: null,
-        interview: null, dict: dictMenu, biz_config: bizConfigMenu,
+        interview: null, candidate: null, dict: dictMenu, biz_config: bizConfigMenu,
         all_search: searchMenus, pages,
     };
     for (const [biz, keywords] of Object.entries(LIST_KEYWORDS)) {
@@ -384,7 +389,7 @@ export function createRecruitContextLoader() {
             }
         }
         catch { /* 缓存读取失败回退闸门链路 */ }
-        if (diskCache) {
+        if (diskCache && diskCache.cacheVersion === RECRUIT_CACHE_VERSION) {
             memo.set(memoKey, diskCache);
             return diskCache;
         }
@@ -409,6 +414,7 @@ export function createRecruitContextLoader() {
                     note: 'recruit-ops 环境参数缓存（weaver-work-cli 运行时解析产物，不含认证字段）',
                 },
                 envKey: `${dir.split(/[\\/]/).pop()}|${appId}`,
+                cacheVersion: RECRUIT_CACHE_VERSION,
                 ...resolved,
             }, null, 2), 'utf8');
         }
@@ -627,7 +633,7 @@ const candidateList = {
     capability: 'recruit',
     risk: READ,
     inputSchema: schemaOf({
-        type: { type: 'string', enum: ['demand', 'position', 'entry', 'offer'], description: '列表类型' },
+        type: { type: 'string', enum: ['demand', 'position', 'entry', 'offer', 'interview', 'candidate'], description: '列表类型' },
         current: SCHEMA_ID,
         pageSize: SCHEMA_ID,
     }, { required: ['type'] }),

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

@@ -244,3 +244,50 @@ export function assertEnumArray(value, allowed, field) {
         throw ehrValidationError('enum_invalid', `${field} 必须是数组`);
     return value.map((item) => assertEnum(item, allowed, field));
 }
+/**
+ * EHR 页面路由表（**集中一处，禁止各 operation 自行拼写**）。
+ * 来源：weaver-interface/business-apis/ehr/references/attend-appeal-save.md、
+ * hr-all-module.md（2026-11-04 真实环境取证）。
+ * 🔴 未取证的路由不在此表、不得臆造；某环境打不开时以实际地址为准并反馈维护者。
+ */
+export const EHR_PAGES = {
+    /** 考勤异常/申诉页面（创建的申诉在此可查） */
+    attendAbnormal: '/sp/attend/abnormal',
+    /** 在职员工名册（原通讯录） */
+    hrEmployeeManager: '/sp/hrm/hr/employeeManager',
+    /** 生日名单 */
+    hrBirthdayList: '/sp/hrm/hr/birthday/list',
+    /** 人员状态变更记录 */
+    hrPersonalStateChange: '/sp/hrm/hr/personalStateChange/record',
+    /** 时点员工名册 */
+    hrTpReportTp: '/sp/hrm/hr/tpReport/tp',
+    /** 历史曾在职名册 */
+    hrTpReportHw: '/sp/hrm/hr/tpReport/hw',
+    /** 离职员工名册 */
+    hrTpReportDismiss: '/sp/hrm/hr/tpReport/dismiss',
+    /** 人员流动分析表 */
+    hrTpReportTurn: '/sp/hrm/hr/tpReport/turn',
+    /** 基本状况分析 */
+    hrReportBasePerson: '/sp/hrm/hr/reportForm/basePerson',
+    /** 部门人数统计 */
+    hrReportDeptPerson: '/sp/hrm/hr/reportForm/deptPerson',
+    /** 岗位人数统计 */
+    hrReportPosiPerson: '/sp/hrm/hr/reportForm/posiPerson',
+    /** 职务状况统计 */
+    hrReportJobPerson: '/sp/hrm/hr/reportForm/jobPerson',
+};
+/** 拼接 EHR 页面地址（去尾斜杠；path 必须来自 EHR_PAGES）。 */
+export function ehrPageUrl(baseUrl, path) {
+    return String(baseUrl || '').replace(/\/+$/, '') + path;
+}
+/** 人员详情卡片地址模板：替换 {人员id} 即为可点击地址（该接口无独立文档，查询到人员 id 后即附）。 */
+export function hrProfileUrl(baseUrl, employeeId) {
+    return String(baseUrl || '').replace(/\/+$/, '') + '/sp/hrm/profileInfo/' + encodeURIComponent(String(employeeId));
+}
+/** 日期加减（YYYY-MM-DD，UTC 语义，避免时区跨天）。 */
+export function addDays(date, delta) {
+    const [y, m, d] = String(date).split('-').map(Number);
+    const t = new Date(Date.UTC(y, m - 1, d + delta));
+    const f = (n) => String(n).padStart(2, '0');
+    return `${t.getUTCFullYear()}-${f(t.getUTCMonth() + 1)}-${f(t.getUTCDate())}`;
+}

package/dist/shortcuts/esb/continuation.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS } from '../../core/continuation-ttl.js';
 import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -35,7 +36,7 @@ function signature(payload, key) {
 }
 export function createEsbContinuationSigner(ctx) {
     return {
-        async issue(payload, ttlMs = 10 * 60_000) {
+        async issue(payload, ttlMs = CONTINUATION_TTL_MS) {
             const issuedAt = Date.now();
             const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
             const sig = signature(body, await loadKey(ctx));

package/dist/shortcuts/esb/index.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { reportPlatformError } from '../../core/error-codes.js';
 import { createEsbContinuationSigner } from './continuation.js';
 import { createEsbHost } from './host.js';
 import { esbManifest } from './manifest.js';
@@ -85,6 +86,7 @@ async function executeAndPrint(ctx, operation, input) {
         ctx.output.write(successEnvelope(operation, result), { json: true });
     }
     catch (error) {
+        reportPlatformError(error);
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }

package/dist/shortcuts/esb/operations/trigger.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { esbSuccess } from './types.js';
 import { esbValidationError } from '../errors.js';
 import { isEsbFlowUnavailable } from '../host.js';
@@ -51,7 +52,7 @@ export const esbTriggerHandlers = {
             requestPreview: payload,
             templateFields,
             continuation: token,
-            expiresInSeconds: 600,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
         }, { status: 'PREPARED' }, warnings);
     },
     'esb.trigger.apply': async (input, { host, continuation }) => {

package/dist/shortcuts/fna/continuation.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS } from '../../core/continuation-ttl.js';
 import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -35,7 +36,7 @@ function signature(payload, key) {
 }
 export function createFnaContinuationSigner(ctx) {
     return {
-        async issue(payload, ttlMs = 10 * 60_000) {
+        async issue(payload, ttlMs = CONTINUATION_TTL_MS) {
             const issuedAt = Date.now();
             const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
             const sig = signature(body, await loadKey(ctx));

package/dist/shortcuts/fna/index.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { reportPlatformError } from '../../core/error-codes.js';
 import { createFnaContinuationSigner } from './continuation.js';
 import { createFnaHost } from './host.js';
 import { fnaManifest } from './manifest.js';
@@ -84,6 +85,7 @@ async function executeAndPrint(ctx, operation, input) {
         ctx.output.write(successEnvelope(operation, result), { json: true });
     }
     catch (error) {
+        reportPlatformError(error);
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }

package/dist/shortcuts/fna/operations/invoice-writeoff.js

@@ -1,7 +1,7 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { fnaPartialError, fnaValidationError, isFnaNetworkError } from '../errors.js';
 import { fnaSuccess, READ, schemaOf, SCHEMA_INTEGER_POSITIVE, WRITE } from './types.js';
 import { compact, fingerprint, normalizeWeaTable, requireConfirm, requireRequestIds, toPositiveInt, unwrapData, verifyLease } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 /** 发票核销公开字段（InvWriteOffSearchVo 非分页部分）。 */
 const WRITE_OFF_FILTER_FIELDS = {
     invoiceStatus: {

package/dist/shortcuts/fna/operations/loan.js

@@ -1,7 +1,7 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { fnaPartialError, fnaValidationError, isFnaNetworkError } from '../errors.js';
 import { fnaSuccess, READ, schemaOf, SCHEMA_INTEGER_POSITIVE, SCHEMA_STRING_NONEMPTY, WRITE } from './types.js';
 import { compact, fingerprint, normalizeWeaTable, requireConfirm, requireRemindRows, summarizeRemindRows, toPositiveInt, unwrapData, verifyLease } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 const LOAN_MENU_FIELDS = {
     menuCode: { ...SCHEMA_STRING_NONEMPTY, description: '菜单编码，如 fesx_fna_borrowingManagement（与环境核对）' },
     permissionSetCode: { ...SCHEMA_STRING_NONEMPTY, description: '权限集编码，如 fesx_fna_borrowingManagement.default（与环境核对）' },

package/dist/shortcuts/hrm/index.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { reportPlatformError } from '../../core/error-codes.js';
 import { createHrmHost } from './host.js';
 import { hrmManifest } from './manifest.js';
 import { executeHrmOperation } from './operations.js';
@@ -129,6 +130,7 @@ async function executeAndPrint(ctx, operation, input) {
         ctx.output.write(successEnvelope(operation, result), { json: true });
     }
     catch (error) {
+        reportPlatformError(error);
         console.error(JSON.stringify(failureEnvelope(error), null, 2));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }