weaver-work-cli 0.1.40 → 0.1.44

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/meeting/operations/lifecycle.js

@@ -1,8 +1,8 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { createHash } from 'node:crypto';
 import { meetingConfirmationError, meetingPartialError, meetingValidationError } from '../errors.js';
 import { meetingSuccess, SCHEMA_ID } from './types.js';
 import { assertMeetingExists, mergeSnapshot, toIdString } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 function fingerprint(value) {
     return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);
 }

package/dist/shortcuts/meeting/operations/receipts.js

@@ -1,8 +1,8 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { createHash } from 'node:crypto';
 import { meetingPartialError, meetingValidationError } from '../errors.js';
 import { meetingSuccess, SCHEMA_ID } from './types.js';
 import { extractRows, mergeSnapshot, pickBusinessInput, toIdString } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 function fingerprint(value) {
     return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);
 }

package/dist/shortcuts/meeting/operations/signs.js

@@ -1,8 +1,8 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { createHash } from 'node:crypto';
 import { meetingConfirmationError, meetingPartialError, meetingValidationError } from '../errors.js';
 import { meetingSuccess, SCHEMA_ID } from './types.js';
 import { extractRows, mergeSnapshot, pickBusinessInput, toIdString } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 function fingerprint(value) {
     return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);
 }

package/dist/shortcuts/okr/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 createOkrContinuationSigner(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/okr/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 { createOkrContinuationSigner } from './continuation.js';
 import { okrValidationError } from './errors.js';
 import { createOkrHost } from './host.js';
@@ -83,6 +84,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/okr/operations/write.js

@@ -1,9 +1,9 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { okrApiError, okrPartialError, okrValidationError } from '../errors.js';
 import { businessMessage, isDatajsonSuccess, isFlagSuccess } from '../host.js';
 import { buildStandardSaveBody, createDetailUrlResolver, fetchGoalRaw, goalPrincipalId, okrAbsoluteUrl, resolveLink, } from './link.js';
 import { assertLinkSupported, compact, ebPeriodFields, ensureConfirmLease, fingerprint, optionValue, resolvePeriod, toIdString, toPersonIdListText, toPersonIdString, } from './shared.js';
 import { okrSuccess, schemaOf, SCHEMA_DATE, SCHEMA_ID, SCHEMA_ID_LIST_TEXT, SCHEMA_PERSON_ID, SCHEMA_PERIOD_TYPE, SCHEMA_QUARTER, SCHEMA_SCOPE, } from './types.js';
-const CONTINUATION_TTL_SECONDS = 600;
 /** ebuilder 新建目标接口支持的 mainTable 字段（源资料 okr_createGoal 传入字段）。 */
 const EB_CREATE_KEYS = [
     'principal_dept',

package/dist/shortcuts/plan/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 createPlanContinuationSigner(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/plan/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 { createPlanContinuationSigner } from './continuation.js';
 import { planValidationError } from './errors.js';
 import { createPlanHost } from './host.js';
@@ -83,6 +84,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/plan/operations/write.js

@@ -1,9 +1,9 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { isPlanErrorType, planApiError, planPartialError, planValidationError } from '../errors.js';
 import { businessMessage, isDatajsonSuccess, isFlagSuccess, isWeaverCodeSuccess, } from '../host.js';
 import { POST_STATUS_LABELS, SCHEMA_ID, SCHEMA_REPORT_TYPE, planSuccess, schemaOf, } from './types.js';
 import { assertLinkSupported, assertReportType, compact, defaultRemindContent, ensureConfirmLease, fingerprint, resolveSerialNumber, resolveYear, toIdListText, toIdString, } from './shared.js';
 import { buildDetailUrl, lookupReport, resolveLink } from './link.js';
-const CONTINUATION_TTL_SECONDS = 600;
 const REMIND_MESSAGE_EVENT_CODE = 14;
 const BODY_KEYS = ['content', 'summary', 'plans'];
 function textField(value, field) {

package/dist/shortcuts/project/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 createProjectContinuationSigner(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/project/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 { createProjectContinuationSigner } from './continuation.js';
 import { createProjectHost } from './host.js';
 import { projectManifest } from './manifest.js';
@@ -79,6 +80,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/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/reception/constants.js

@@ -0,0 +1,53 @@
+/**
+ * reception 域常量。
+ *
+ * 与环境有关的路径一律不写死在这里：状态目录由 `stateRoot(ctx)` 提供，
+ * 模板与 render.py 由技能包自带、通过参数或快照同目录推导。
+ */
+/** 目标流程名。可用 --workflow 覆盖，用于同租户内的变体流程。 */
+export const DEFAULT_WORKFLOW = '泛微客户参观接待流程';
+/** 状态目录名，落在 `<stateRoot>/reception/` 下，跟 profile 走。 */
+export const STATE_SUBDIR = 'reception';
+/** 产物默认输出目录（宿主不传 --out-dir 时）。 */
+export const DEFAULT_OUT_DIR_WIN = '.reception-cli/out';
+export const DEFAULT_OUT_DIR_POSIX = '/workspace/files';
+/** 后勤 6 项 + 手机号：不给预设选项，一律手动填写。 */
+export const LOGISTICS_FIELDS = ['headcount', 'meetingRoom', 'pickup', 'meal', 'hotel', 'gift'];
+export const LOGISTICS_LABEL = {
+    headcount: '人数',
+    meetingRoom: '会议室',
+    pickup: '接送/用车',
+    meal: '用餐',
+    hotel: '住宿',
+    gift: '伴手礼',
+    mobile: '手机',
+};
+/**
+ * 面板标题。宿主硬约束（实测）：title 严格单行，超长直接截断成「…」。
+ * 只留一句短话，完整样例放 placeholder，口径放 hint（不渲染，仅模型兜底）。
+ */
+export const LOGISTICS_TITLE = '接待细节(人数、具体安排、用餐情况等)';
+/** 输入框灰字：固定字段清单。样例里的手机号会被宿主脱敏成 [[PHONE_001]]，所以不给样例。 */
+export const LOGISTICS_PLACEHOLDER = '客户人数、是否会议、是否接送、是否用餐、是否代订住宿、是否伴手礼、陪同人员手机号';
+/** 模型侧兜底口径。宿主不渲染 hint，切勿并入 title。 */
+export const LOGISTICS_HINT = [
+    '照输入框灰字样例写，逗号或「｜」隔开都行；没定的项直接不写。',
+    '人数：如「10人」',
+    '会议室：总部129 / 总部130 / 总部131，或「不需会议室」',
+    '接送/用车：如「虹桥接机2辆商务车 10:00」或「不用车」',
+    '用餐：公司食堂 / 小餐厅 / 外部餐厅 / 不用餐',
+    '住宿：如「2间大床房住1晚」或「不住」',
+    '伴手礼：如「礼盒每人1份」或「不用」',
+    '手机：11 位，只用于行程单显示接待人联系方式（系统不查员工手机号）',
+].join('\n');
+/** 客户需求面板的固定选项。取值为原文，模型检索案例时直接用它拼检索词。 */
+export const CUSTOMER_NEED_OPTIONS = [
+    '了解泛微产品与政务行业解决方案',
+    '参观总部环境与展厅，了解公司实力',
+    '交流具体项目合作与实施细节',
+    '暂未确定，先进待办',
+];
+/** 快照文件的 kind 标识，用于拒收无关 JSON。 */
+export const SNAPSHOT_KIND = 'reception-fields-snapshot';
+/** python 探测结果的缓存时长（7 天）。 */
+export const PYTHON_CACHE_TTL_MS = 7 * 24 * 3600 * 1000;

package/dist/shortcuts/reception/errors.js

@@ -0,0 +1,54 @@
+import { CliError, ExitCode } from '../../core/errors.js';
+/**
+ * reception 域内结构化错误。
+ *
+ * 约定：
+ * - `type` 用 CLI 规范的分类词（validation / environment / business / authentication）；
+ * - `subtype` 保留接待流程既有的全大写业务码（KNOWN_REQUIRED / RUN_NOT_FOUND 等），
+ *   SKILL.md 与历史排障记录都按这套码检索，改小写会让文档与实现脱节。
+ */
+export class ReceptionCliError extends CliError {
+    type;
+    subtype;
+    retryable;
+    stage;
+    details;
+    constructor(type, subtype, message, options = {}) {
+        super(message, options.exitCode ?? ExitCode.GeneralError);
+        this.name = 'ReceptionCliError';
+        this.type = type;
+        this.subtype = subtype;
+        this.retryable = options.retryable ?? false;
+        this.stage = options.stage;
+        this.details = options.details;
+    }
+}
+/** 入参问题：缺参数、JSON 不合法、校验不过。退出码 2。 */
+export const receptionValidationError = (subtype, message, details) => new ReceptionCliError('validation', subtype, message, {
+    details,
+    exitCode: ExitCode.UsageError,
+});
+/** 环境问题：缺 python、缺快照、渲染脚本找不到。退出码 3。 */
+export const receptionEnvironmentError = (subtype, message, details) => new ReceptionCliError('environment', subtype, message, {
+    details,
+    exitCode: ExitCode.AuthError,
+});
+/** 业务问题：渲染失败、上传失败、run 丢失。退出码 1。 */
+export const receptionBusinessError = (subtype, message, details) => new ReceptionCliError('business', subtype, message, {
+    details,
+    exitCode: ExitCode.GeneralError,
+});
+/**
+ * run 状态缺失。
+ *
+ * 与其它业务错误分开放：调用方（doc）会捕获它走"带 --known 现场重建"的分支，
+ * 因此必须是可识别的类型，不能只是一个 message。
+ */
+export const receptionRunNotFound = (runId, stateDir) => new ReceptionCliError('business', 'RUN_NOT_FOUND', `找不到 run：${runId}`, {
+    exitCode: ExitCode.GeneralError,
+    details: {
+        runId,
+        stateDir,
+        hint: '把 ask 用过的 --known 与 answers 一起带上重跑 doc，CLI 会现场重建 run',
+    },
+});

package/dist/shortcuts/reception/host.js

@@ -0,0 +1,125 @@
+import { getE10Session } from '../../internal/e10/context.js';
+import { E10ApiError, createE10RequestRuntime, } from '../../internal/e10/request-runtime.js';
+import { receptionBusinessError, receptionEnvironmentError } from './errors.js';
+import { UploadProtocolError, uploadToFileService } from './upload.js';
+/** 单次上传的总时限。分片上传是多轮请求，留足 3 分钟。 */
+const UPLOAD_TIMEOUT_MS = 180_000;
+export function createReceptionHost(ctx) {
+    let cached = null;
+    async function resolve() {
+        if (cached)
+            return cached;
+        const e10 = await getE10Session(ctx);
+        if (!e10) {
+            cached = {
+                e10: null,
+                info: {
+                    available: false,
+                    baseUrl: '',
+                    userId: '',
+                    reason: '未取得 E10 会话：附件不会上传，产物按本地文件交付',
+                },
+            };
+            return cached;
+        }
+        cached = {
+            e10,
+            info: { available: true, baseUrl: e10.getBaseUrl(), userId: e10.userId },
+        };
+        return cached;
+    }
+    async function getSession() {
+        return (await resolve()).info;
+    }
+    async function requireRuntime() {
+        const { e10, info } = await resolve();
+        if (!e10) {
+            throw receptionEnvironmentError('NO_SESSION', info.reason || '未取得 E10 会话');
+        }
+        return { runtime: createE10RequestRuntime(ctx, e10), session: info };
+    }
+    /**
+     * 上传一份文件。
+     *
+     * 走 teamsCheck → preUploadCheck → module/upload 三阶段（见 `upload.ts`）。
+     * 旧的 `/api/file/upload` 已废弃，调用只会得到 200 + 空响应，别再回去。
+     */
+    async function uploadFile(filePath, options = {}) {
+        const { e10, info } = await resolve();
+        if (!e10) {
+            return {
+                ok: false,
+                reason: 'NO_SESSION',
+                localPath: filePath,
+                error: info.reason || '无可用会话，已跳过上传（文件已生成，按本地文件交付）',
+            };
+        }
+        const baseUrl = String(info.baseUrl || '').replace(/\/+$/u, '');
+        const runtime = createE10RequestRuntime(ctx, e10);
+        // 默认 document（E10 的文件归属取值）；需要别的归属时用 RECEPTION_UPLOAD_MODULE 覆盖。
+        const module = options.module || process.env.RECEPTION_UPLOAD_MODULE || 'document';
+        try {
+            const uploaded = await uploadToFileService({
+                transport: {
+                    post: (path, formData) => runtime.requestJson({
+                        module: 'reception',
+                        operation: 'reception.upload',
+                        method: 'POST',
+                        path,
+                        formData,
+                        headers: {
+                            langtype: 'zh_CN',
+                            referer: `${baseUrl}/`,
+                        },
+                        timeoutMs: UPLOAD_TIMEOUT_MS,
+                    }),
+                },
+                filePath,
+                module,
+                userId: info.userId ? String(info.userId) : undefined,
+                name: options.name,
+            });
+            return {
+                ok: true,
+                fileid: uploaded.fileid,
+                name: uploaded.name,
+                size: uploaded.size,
+                kind: uploaded.kind,
+                localPath: filePath,
+                previewUrl: `${baseUrl}/sp/file/filePreview/${uploaded.fileid}`,
+            };
+        }
+        catch (error) {
+            if (error instanceof UploadProtocolError) {
+                return {
+                    ok: false,
+                    localPath: filePath,
+                    reason: error.subtype,
+                    error: error.message,
+                    httpStatus: error.httpStatus,
+                    contentType: error.contentType,
+                    detail: error.detail,
+                    hint: `链路 teamsCheck → preUploadCheck → module/upload，module=${module}`,
+                };
+            }
+            if (error instanceof E10ApiError) {
+                return { ok: false, localPath: filePath, reason: 'UPLOAD_NETWORK', error: `网络异常: ${error.message}` };
+            }
+            return {
+                ok: false,
+                localPath: filePath,
+                reason: 'UPLOAD_LOCAL_ERROR',
+                error: `上传异常: ${error.message}`,
+            };
+        }
+    }
+    return { getSession, requireRuntime, uploadFile };
+}
+/** 未登录时不该静默继续的场景，统一用它取 baseUrl 并给出可读错误。 */
+export async function requireBaseUrl(host) {
+    const session = await host.getSession();
+    if (!session.available || !session.baseUrl) {
+        throw receptionBusinessError('BASE_URL_MISSING', '未取得 E10 会话，无法确定环境地址');
+    }
+    return session.baseUrl;
+}