weaver-work-cli 0.1.40 → 0.1.44

package/dist/shortcuts/jiuchuanhui/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 { createJiuchuanhuiContinuationSigner } from './continuation.js';
 import { createJiuchuanhuiHost } from './host.js';
 import { jiuchuanhuiManifest } from './manifest.js';
@@ -82,6 +83,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/jiuchuanhui/operations/datajson.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { jiuchuanhuiConfirmationError, jiuchuanhuiPartialError, jiuchuanhuiValidationError, isJiuchuanhuiNetworkError, } from '../errors.js';
 import { asObject, asPositiveString, byIdBody, datasBody, listBody, listRecords, pagingFrom, resultDataIds, sessionMatches, stripForbiddenKeys, workflow, } from './shared.js';
 /**
@@ -32,7 +33,7 @@ export class DatajsonWritePrepareOperation {
             data: {
                 preview,
                 continuation: continuationToken,
-                expiresInSeconds: 600,
+                expiresInSeconds: CONTINUATION_TTL_SECONDS,
                 workflow: workflow(this.applyOperation, 'AWAITING_CONFIRMATION'),
             },
         };

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

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { jiuchuanhuiConfirmationError, jiuchuanhuiPartialError, jiuchuanhuiValidationError, isJiuchuanhuiNetworkError, } from '../errors.js';
 import { asObject, asNonEmptyString, esbBody, esbOutcome, sessionMatches, workflow } from './shared.js';
 /**
@@ -36,7 +37,7 @@ export class EsbWritePrepareOperation {
             data: {
                 preview,
                 continuation: continuationToken,
-                expiresInSeconds: 600,
+                expiresInSeconds: CONTINUATION_TTL_SECONDS,
                 workflow: workflow(this.applyOperation, 'AWAITING_CONFIRMATION'),
             },
         };

package/dist/shortcuts/mail/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 createMailContinuationSigner(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/mail/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 { createMailContinuationSigner } from './continuation.js';
 import { createMailHost } from './host.js';
 import { mailManifest } from './manifest.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/mail/operations/mail-blacklist.js

@@ -1,6 +1,6 @@
+import { CONTINUATION_TTL_MS } from '../../../core/continuation-ttl.js';
 import { mailValidationError } from '../errors.js';
 import { WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
-const CONTINUATION_TTL_MS = 600_000;
 const BLACKLIST_SCHEMA = schemaOf({
     operateType: { type: 'string', description: 'add / delete' },
     mailAddress: SCHEMA_STRING,

package/dist/shortcuts/mail/operations/mail-contacts.js

@@ -1,6 +1,6 @@
+import { CONTINUATION_TTL_MS } from '../../../core/continuation-ttl.js';
 import { mailValidationError } from '../errors.js';
 import { WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
-const CONTINUATION_TTL_MS = 600_000;
 // ---------------------------------------------------------------------------
 // 联系人 新增/编辑（prepare/apply）
 // ---------------------------------------------------------------------------

package/dist/shortcuts/mail/operations/mail-send.js

@@ -1,7 +1,7 @@
+import { CONTINUATION_TTL_MS } from '../../../core/continuation-ttl.js';
 import { randomBytes } from 'node:crypto';
 import { mailValidationError } from '../errors.js';
 import { WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
-const CONTINUATION_TTL_MS = 600_000;
 function b64(s) {
     return Buffer.from(s, 'utf8').toString('base64');
 }

package/dist/shortcuts/mail/operations/mail-sign.js

@@ -1,6 +1,6 @@
+import { CONTINUATION_TTL_MS } from '../../../core/continuation-ttl.js';
 import { mailValidationError } from '../errors.js';
 import { READ, WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
-const CONTINUATION_TTL_MS = 600_000;
 const SIGN_SCHEMA = schemaOf({
     id: SCHEMA_STRING,
     signName: SCHEMA_STRING,

package/dist/shortcuts/mail/operations/mail-template.js

@@ -1,6 +1,6 @@
+import { CONTINUATION_TTL_MS } from '../../../core/continuation-ttl.js';
 import { mailValidationError } from '../errors.js';
 import { WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
-const CONTINUATION_TTL_MS = 600_000;
 const TEMPLATE_SCHEMA = schemaOf({
     id: SCHEMA_STRING,
     templateType: SCHEMA_STRING,

package/dist/shortcuts/meeting/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 createMeetingContinuationSigner(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/meeting/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 { createMeetingContinuationSigner } from './continuation.js';
 import { createMeetingHost } from './host.js';
 import { meetingManifest, OPERATION_INDEX_HINT } from './manifest.js';
@@ -87,6 +88,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/meeting/operations/change.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_DATETIME_MINUTE, SCHEMA_ID } from './types.js';
 import { assertDateTimeMinute, extractRows, mergeSnapshot, toIdCsv, toIdString } from './shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 const LIST_PATH = '/api/meeting/search/getMeetingList';
 function fingerprint(value) {
     return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);

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

@@ -1,8 +1,8 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { createHash } from 'node:crypto';
 import { meetingConflictError, meetingConfirmationError, meetingPartialError, meetingValidationError } from '../errors.js';
 import { meetingSuccess, SCHEMA_DATETIME_MINUTE, SCHEMA_ID } from './types.js';
 import { assertDateTimeMinute, extractConflict, mergeSnapshot, toIdCsv, 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/eb/catalog.js

@@ -276,7 +276,10 @@ export const EB_ENDPOINTS = [
         interfacePk: 'query_roomusage_list',
         countPk: 'query_roomusage_count',
         queryParams: ['mt_id', 'address', 'enddatetime', 'begindatetime'],
-        summary: 'EB 版会议室占用列表（query_roomusage_list + count）',
+        dateFilter: true,
+        paramAliases: { roomId: 'address', room_id: 'address', day: 'date' },
+        summary: 'EB 版会议室占用列表（query_roomusage_list + count）。按日期过滤传 date（yyyy-MM-dd）'
+            + '或 begindatetime/enddatetime；**不传任何时间条件 = 返回全量历史**，不是接口不支持过滤',
     },
     {
         domain: 'roomUsage',

package/dist/shortcuts/meeting/operations/eb/create-flow.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS, CONTINUATION_TTL_SECONDS } from '../../../../core/continuation-ttl.js';
 import { existsSync } from 'node:fs';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
@@ -9,6 +10,7 @@ import { EB_BASE, ebBusinessSuccess, writeBody } from './factory.js';
 import { loadRooms, recommendRooms } from './room-recommend.js';
 import { dayOf, filterUsages, invalidateDayUsages, loadDayUsages } from './usage-cache.js';
 import { pickRememberedFlow, readFlowPick, rememberFlowPick } from './flow-memory.js';
+import { resolveNamesCached } from './person-cache.js';
 /**
  * 通过**流程**新建 EB 会议（`meeting.eb.meeting.create.flow`）。
  *
@@ -75,30 +77,17 @@ async function loadCreateForm(env, workflowId) {
         workflowName: String(wf.name ?? wf.workflowName ?? '').trim() || undefined,
     };
 }
-/** 取员工姓名（hrm.employee.batch，一次批量，失败返回空表不阻塞）。 */
+/**
+ * 取员工姓名（**缓存优先**：命中直接返回，未命中才打 hrm.employee.batch）。
+ *
+ * 2026-11-04 用户要求：一次建会会查 3~5 次同一批人，每次 ~2s，必须缓存。
+ * 缓存位置 `person-v1-<租户>.json`，TTL 24h（见 person-cache.ts）。
+ */
 async function resolveEmployeeNames(env, ids) {
-    const map = new Map();
     const unique = [...new Set(ids.map((id) => String(id).trim()).filter((id) => id !== ''))];
     if (unique.length === 0)
-        return map;
-    try {
-        const { hrmEmployeeOperations } = await import('../../../hrm/operations/employee.js');
-        const batch = hrmEmployeeOperations.find((operation) => operation.name === 'hrm.employee.batch');
-        if (!batch)
-            return map;
-        const result = await batch.handler({ ids: unique }, env);
-        const rows = (result?.data?.rows ?? result?.data?.userList ?? []);
-        for (const row of rows) {
-            const id = String(row.id ?? '').trim();
-            const name = String(row.name ?? '').trim();
-            if (id && name)
-                map.set(id, name);
-        }
-    }
-    catch {
-        // 查不到姓名就退回「以 id 当名称」，工作流多数能按 id 直接命中
-    }
-    return map;
+        return new Map();
+    return resolveNamesCached(env, unique);
 }
 /**
  * 把「员工 id 或姓名」解析成 `{ id, name }`。
@@ -290,6 +279,13 @@ export async function shapeBrowserValues(env, values) {
             readable.address = String(shaped.address);
         }
     }
+    // 邀请函要用「人话版本」的时间（预置函走 readable，之前这里没放，导致预置函时间缺失）
+    if (shaped.begin_datetime !== undefined && String(shaped.begin_datetime).trim() !== '') {
+        readable.begin_datetime = String(shaped.begin_datetime).trim();
+    }
+    if (shaped.end_datetime !== undefined && String(shaped.end_datetime).trim() !== '') {
+        readable.end_datetime = String(shaped.end_datetime).trim();
+    }
     const personFields = ['hrm_members', 'caller', 'contacter'];
     const idPool = [];
     for (const key of personFields) {
@@ -1038,6 +1034,36 @@ export function shouldAutoPickFlow(args) {
         return true;
     return String(process.env.WEAVER_MEETING_FLOW_CHOICE ?? '').trim().toLowerCase() === 'auto';
 }
+/**
+ * 把邀请函 docx 发到会议群（IM 两段式：prepare → apply）。
+ *
+ * ⛔ 只传 file、**不带 txt**：实测「txt + file」同传时服务端只落文本、文件被丢弃
+ * （2026-11-04 用户截图：群里只有一行「会议邀请函：xxx」）。
+ * 失败只记 warning —— 会议和邀请函都已生成，发群失败不该影响建会结果。
+ */
+async function sendInvitationToGroup(env, groupId, filePath, warnings) {
+    const started = Date.now();
+    try {
+        const { buildImEnv } = await import('./group-chat.js');
+        const { getImOperation } = await import('../../../im/operations/registry.js');
+        const imEnv = await buildImEnv(env);
+        const prepared = await getImOperation('im.msg.send.group.prepare').handler({ groupId, file: filePath }, imEnv);
+        const continuation = String(prepared?.data?.continuation ?? '');
+        const applied = continuation
+            ? await getImOperation('im.msg.send.group.apply').handler({ continuation, confirm: true }, imEnv)
+            : null;
+        const ok = applied?.ok === true;
+        if (!ok) {
+            warnings.push(`邀请函没能发到群里（${String(applied?.error?.message ?? prepared?.error?.message ?? '未知原因').slice(0, 150)}）；`
+                + '文件已生成，可手动转发。');
+        }
+        return { ok, ms: Date.now() - started };
+    }
+    catch (error) {
+        warnings.push(`邀请函发群异常（不影响建会）：${String(error?.message ?? error).slice(0, 150)}`);
+        return { ok: false, ms: Date.now() - started };
+    }
+}
 /** 解析要用的建会流程 id：入参优先（可多个），其次固化列表，最后才是应用设置里的 mt_new_wf。 */
 export async function resolveWorkflowId(env, args) {
     const explicitList = normalizeWorkflowIds(args.workflowId);
@@ -1493,9 +1519,16 @@ const ebMeetingCreateFlowPrepare = {
         const roomMemberCount = declaredTotal
             ?? (memberIds.length > 0 ? memberIds.length + (callerInMembers ? 0 : 1) : undefined);
         // 有没有客户：决定要不要优先推接待类会议室（crm_members 可能是数组、"id,id" 或名称）
-        const hasCustomer = Array.isArray(args.crm_members)
+        // 2026-11-04 补：用户只在话里说了「接待某某客户」、没传 crm_members 时，也要识别出来 ——
+        // 否则"带客户优先接待类"这条规则永远不生效（用户实测推荐了 3 间普通会议室）。
+        const crmMentionedInText = detectCrmMentionInText(String(args.mt_name ?? ''), String(args.mt_desc ?? ''), String(args.other_remark ?? ''));
+        // 「接待湖北省政府客户」这种说法不含「客户是/为」句式，上面的正则接不住 —— 再用关键词兜一层。
+        const customerWords = /(接待|招待|客户|贵宾|来访)/u.test(`${String(args.mt_name ?? '')} ${String(args.mt_desc ?? '')} ${String(args.other_remark ?? '')}`);
+        const hasCustomer = (Array.isArray(args.crm_members)
             ? args.crm_members.length > 0
-            : String(args.crm_members ?? '').trim() !== '';
+            : String(args.crm_members ?? '').trim() !== '')
+            || Boolean(crmMentionedInText)
+            || customerWords;
         // 全天占用缓存（2026-11-03 用户方案）：不带 address 条件一次拉当天全部会议室占用（~2s，
         // 5 分钟 TTL），推荐 busy 判定与指定房间的占用检测**共用同一份**；同一天内改时间/换房间
         // 不再打占用接口。提交成功后当天缓存立即作废（见提交成功处）。
@@ -2021,8 +2054,11 @@ const ebMeetingCreateFlowPrepare = {
         })();
         const shaped = await shapeBrowserValues(env, {
             mt_name: args.mt_name,
-            begin_datetime: args.begin_datetime,
-            end_datetime: args.end_datetime,
+            // ⛔ 2026-11-05 修：用户只说「明天下午」时，时间是 CLI 按 time_slot 展开出来的（beginText/endText），
+            // 原始入参 args.begin_datetime 是空的 —— 以前这里直接取 args，表单两个时间字段就空着，
+            // 页面打开后默认成"当前时间"（用户实测：填 11-06 13:00–18:00，表单显示 11-05 17:25）。
+            begin_datetime: beginText || args.begin_datetime,
+            end_datetime: endText || args.end_datetime,
             mt_desc: args.mt_desc,
             address: addressInput,
             customize_address: args.customize_address,
@@ -2123,9 +2159,7 @@ const ebMeetingCreateFlowPrepare = {
                         + '传 crm_detail_mode:"only" 再配 crm_member_details 才覆盖本次自动带入。');
                 }
                 else if (auto.missing.length > 0) {
-                    warnings.push(`已写「参会客户」，但没能自动带出「${auto.missing.join('、')}」的联系人（CRM 里查不到）。`
-                        + '请把已查到的联系人直接告给用户核对；确实没有联系人时问一次姓名+手机号，'
-                        + '再以 crm_member_details:[{"xm":"张三","sjhm":"13800000000"}] 重新 prepare。');
+                    warnings.push(`已写「参会客户」，但没能自动带出「${auto.missing.join('、')}」的联系人（CRM 里没建档联系人）。`);
                 }
             }
         }
@@ -2251,13 +2285,24 @@ const ebMeetingCreateFlowPrepare = {
                 // 建群要素：apply 拿到会议 id 后先建群、再把群 id 回写 imchat_groupid
                 groupChat: {
                     memberIds: groupMemberIds,
-                    beginDatetime: String(shaped.values.begin_datetime ?? ''),
-                    endDatetime: String(shaped.values.end_datetime ?? ''),
-                    address: String(shaped.values.address ?? ''),
+                    // ⛔ 2026-11-04 修：用户只说"明天上午"（time_slot）时，begin_datetime 是 CLI 展开出来的，
+                    // `shaped.values` 里**没有**这个键 —— 直接取会得到空串，群消息里"开始时间/结束时间"就空着。
+                    // 这里统一用展开后的 beginText/endText。
+                    beginDatetime: beginText,
+                    endDatetime: endText,
+                    // ⛔ 2026-11-04 修：shaped.address 在这之前已被解析成 `{id,name}` 对象，
+                    // 直接 String() 会变成 "[object Object]" 打进群消息（用户实测看到的就是这个）。
+                    // 群消息要的是人话名称，这里优先取 name。
+                    address: (() => {
+                        const value = shaped.values.address;
+                        if (value && typeof value === 'object')
+                            return String(value.name ?? value.id ?? '');
+                        return String(value ?? '');
+                    })(),
                 },
             },
             fingerprint: JSON.stringify({ workflowId, main, ...(detailPayload ? { details: detailPayload } : {}) }),
-        }, 10 * 60 * 1000);
+        }, CONTINUATION_TTL_MS);
         return meetingSuccess('meeting.eb.meeting.create.flow.prepare', {
             status: 'AWAITING_CONFIRMATION',
             preview: {
@@ -2285,7 +2330,7 @@ const ebMeetingCreateFlowPrepare = {
                 ...(Object.keys(decisions).length > 0 ? { decisions } : {}),
             },
             continuation,
-            expiresInSeconds: 600,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
         }, warnings.length > 0 ? { warnings } : {});
     },
 };
@@ -2526,6 +2571,16 @@ const ebMeetingCreateFlowApply = {
                         // 落盘失败不影响输出表单；补绑时可改传 requestId
                     }
                 }
+                // 邀请函也要发群（2026-11-04 用户实测：浏览器填单这一档建了群却没收不到邀请函）。
+                // 这里发的是**预置函**（按申请单信息生成，字段可能有【待补充】），审批通过后可用 meetingId 重新生成。
+                const browserWarnings = [];
+                let browserInvitation = pre.invitation;
+                const browserGroupId = String(groupChat?.groupId ?? '').trim();
+                const browserInvitePath = String(pre.invitation?.filePath ?? '').trim();
+                if (browserGroupId && browserInvitePath) {
+                    const sent = await sendInvitationToGroup(env, browserGroupId, browserInvitePath, browserWarnings);
+                    browserInvitation = { ...pre.invitation, sentToGroup: { groupId: browserGroupId, ok: sent.ok } };
+                }
                 return meetingSuccess('meeting.eb.meeting.create.flow.apply', {
                     status: 'BROWSER_FILL',
                     workflowId: payload.workflowId,
@@ -2539,7 +2594,7 @@ const ebMeetingCreateFlowApply = {
                     finalMarkdownHint: '把 finalMarkdown 原样贴在回复最后（从 <browsertool> 到 </browsertool>，不包代码块）；'
                         + '不贴这段＝用户看不到表单，也不能说"表单已打开"。',
                     message: String(submittedData.message ?? ''),
-                    invitation: pre.invitation,
+                    invitation: browserInvitation,
                     ...(groupChat ? { groupChat } : {}),
                     timings: { submitMs: Date.now() - submitStartedAt, invitationMs: pre.ms },
                 }, {
@@ -2554,8 +2609,11 @@ const ebMeetingCreateFlowApply = {
                                 ? [`群聊没建成功（${String(groupChat.error ?? '未知原因')}）：会议照常可以在页面里提交，群需要手工建或稍后重试。`]
                                 : []),
                         `邀请函已按申请单信息**预生成**（预置函，${String(pre.invitation.filePath ?? '见 filePath')}）：`
-                            + '请下载后人工核对、自行发送；流程审批通过、会议生成后可用 mtId 再跑一次 meeting.invitation.render 拿完整字段版本。',
+                            + (browserInvitation.sentToGroup?.ok
+                                ? '已把 docx 发到会议群；字段可能含【待补充】，审批通过、会议生成后可用 mtId 再跑一次 meeting.invitation.render 拿完整版本。'
+                                : '请下载后人工核对、自行发送；流程审批通过、会议生成后可用 mtId 再跑一次 meeting.invitation.render 拿完整字段版本。'),
                         '⛔ 不要因为"没有 requestId / 没有会议 id"重复 apply —— 填单要在那个浏览器页面里点提交。',
+                        ...browserWarnings,
                     ],
                 });
             }
@@ -2712,6 +2770,14 @@ const ebMeetingCreateFlowApply = {
                 + '审批通过、会议生成后可用 mtId 再跑一次 meeting.invitation.render 拿到完整字段版本。'
                 + '⛔ 本 operation 不重复提交流程 —— 不要因为"没有会议 id"就重复 apply。');
         }
+        // 邀请函自动发群（2026-11-04 用户要求）：群已建好 + 邀请函文件已生成 → 把 docx 直接发进群里。
+        const inviteGroupId = String(groupChat?.groupId ?? '').trim();
+        const inviteFilePath = String(invitation?.filePath ?? '').trim();
+        if (inviteGroupId && inviteFilePath) {
+            const sent = await sendInvitationToGroup(env, inviteGroupId, inviteFilePath, warnings);
+            invitation.sentToGroup = { groupId: inviteGroupId, ok: sent.ok };
+            timings.invitationSendMs = sent.ms;
+        }
         return meetingSuccess('meeting.eb.meeting.create.flow.apply', {
             status: 'COMPLETE',
             timings,

package/dist/shortcuts/meeting/operations/eb/decision.js

@@ -14,12 +14,12 @@
  * - `meeting.eb.decision.publish`：写决议（概述 + 明细）→ 自动写回会议为已决议（含部分失败语义）；
  * - `meeting.eb.sign.mark`：按「会议 + 参会人」自动定位签到记录，走 update 补签 / 补签退。
  */
+import { CONTINUATION_TTL_SECONDS } from '../../../../core/continuation-ttl.js';
 import { EB_BASE, ebBusinessSuccess, extractEbRows, fingerprint, normalizeEbWrite, queryBody, requireConfirm, verifyLease, writeBody, } from './factory.js';
 import { EB_ENDPOINTS } from './catalog.js';
 import { meetingSuccess } from '../types.js';
 import { meetingPartialError, meetingValidationError } from '../../errors.js';
 import { toIdString } from '../shared.js';
-const CONTINUATION_TTL_SECONDS = 600;
 const DATE_PATTERN = '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$';
 /** 本地时间的 yyyy-MM-dd HH:mm:ss（EB 的签到/完成时间字段要求带秒）。 */
 function formatSecondNow() {

package/dist/shortcuts/meeting/operations/eb/factory.js

@@ -1,3 +1,4 @@
+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';
@@ -58,7 +59,6 @@ async function buildPersonnelText(env, data) {
     }
     return out;
 }
-const CONTINUATION_TTL_SECONDS = 600;
 /**
  * EB 响应成功判定。
  * EB 的响应体与标准版不同：成功时顶层常为 `{datajson:{...}}`（可能不带 status/code），
@@ -212,6 +212,18 @@ function buildReadInputSchema(endpoint) {
         for (const param of endpoint.queryParams ?? []) {
             properties[param] = { type: 'string', description: `EB 筛选参数（URL 占位符名 ${param}）` };
         }
+        // 便捷日期参数（2026-11-04）：模型最常传的就是 date，别让它因为"没这个参数"去拿全量再下错结论。
+        if (endpoint.dateFilter) {
+            properties.date = {
+                type: 'string',
+                pattern: '^\\d{4}-\\d{2}-\\d{2}$',
+                description: '按日期过滤（yyyy-MM-dd）：等价于 begindatetime=当天 00:00 + enddatetime=当天 23:59。'
+                    + '⛔ 不传 date 且不传起止时间 = 返回**全量历史**（不是接口不支持按日期过滤）',
+            };
+        }
+        for (const [alias, target] of Object.entries(endpoint.paramAliases ?? {})) {
+            properties[alias] = { type: 'string', description: `入参别名，等价于 ${target}` };
+        }
         for (const param of endpoint.mainTableParams ?? []) {
             properties[param] = {
                 type: 'string',
@@ -297,6 +309,27 @@ function buildReadOperation(endpoint) {
                 if (value !== undefined && value !== null && value !== '')
                     query[param] = value;
             }
+            // 别名落地（roomId→address 之类）；只在目标参数没传时生效，不覆盖显式值
+            for (const [alias, target] of Object.entries(endpoint.paramAliases ?? {})) {
+                const value = args[alias];
+                if (value === undefined || value === null || value === '')
+                    continue;
+                if (query[target] === undefined) {
+                    if (target === 'date')
+                        continue; // date 不是 query 参数，下面单独展开
+                    query[target] = value;
+                }
+            }
+            // 便捷日期：date（或别名 day）→ 当天的 begindatetime/enddatetime
+            if (endpoint.dateFilter) {
+                const day = String(args.date ?? args.day ?? '').trim().slice(0, 10);
+                if (/^\d{4}-\d{2}-\d{2}$/.test(day)) {
+                    if (query.begindatetime === undefined)
+                        query.begindatetime = `${day} 00:00`;
+                    if (query.enddatetime === undefined)
+                        query.enddatetime = `${day} 23:59`;
+                }
+            }
             if (endpoint.kind === 'get') {
                 const response = await env.host.request({
                     method: 'POST',

package/dist/shortcuts/meeting/operations/eb/group-chat.js

@@ -33,7 +33,7 @@ async function buildEsbEnv(env) {
     const { createEsbContinuationSigner } = await import('../../../esb/continuation.js');
     return { ctx: env.ctx, host: createEsbHost(env.ctx), continuation: createEsbContinuationSigner(env.ctx) };
 }
-async function buildImEnv(env) {
+export async function buildImEnv(env) {
     const { createImHost } = await import('../../../im/host.js');
     const { createImContinuationSigner } = await import('../../../im/continuation.js');
     return { ctx: env.ctx, host: createImHost(env.ctx), continuation: createImContinuationSigner(env.ctx) };
@@ -203,8 +203,30 @@ async function triggerGroupFlow(env, input, meetingName, memberIds) {
         enddatetime: String(input.endDatetime ?? ''),
         hrmmembers: memberIds.join(','),
     };
-    if (input.address)
-        mainTable.address = input.address;
+    if (input.address) {
+        // ⛔ 2026-11-04 用户反馈：建群动作流把 `address` **原样打进群消息**（「会议地点：100502820000000226」）。
+        // ESB 模板改不了，所以这里先把它解析成会议室名称再传；解析不到才退回原值。
+        // 另外入参可能是 `{id,name}` 对象或被 String() 过的 "[object Object]"，一并兜住。
+        const raw = input.address;
+        let addressText = raw && typeof raw === 'object'
+            ? String(raw.name ?? raw.id ?? '')
+            : String(raw).trim();
+        if (addressText === '[object Object]')
+            addressText = '';
+        if (addressText) {
+            try {
+                const { resolveAddressRoom } = await import('./create-flow.js');
+                const room = await resolveAddressRoom(env, addressText);
+                if (room?.name)
+                    addressText = room.name;
+            }
+            catch {
+                // 台账读不到不影响建群，退回原值
+            }
+        }
+        if (addressText)
+            mainTable.address = addressText;
+    }
     try {
         const { getEsbOperation } = await import('../../../esb/operations/registry.js');
         const esbEnv = await buildEsbEnv(env);

package/dist/shortcuts/meeting/operations/eb/person-cache.js

@@ -0,0 +1,96 @@
+import { readCache, writeCache, cacheScopeSuffix } from './cache.js';
+const PERSON_TTL_MS = 24 * 60 * 60 * 1000;
+const BATCH_MAX = 100;
+function personKey(scope) {
+    return `person-v1-${scope}`;
+}
+/** 读缓存里的全部人员（id → 记录），过期的条目会被丢弃。 */
+async function readAll(env) {
+    const scope = await cacheScopeSuffix(env);
+    const hit = await readCache(env, personKey(scope), { ttlMs: PERSON_TTL_MS * 30 });
+    if (!hit)
+        return {};
+    const now = Date.now();
+    const fresh = {};
+    for (const [id, record] of Object.entries(hit.data ?? {})) {
+        if (record && now - Number(record.savedAt || 0) <= PERSON_TTL_MS)
+            fresh[id] = record;
+    }
+    return fresh;
+}
+async function writeAll(env, all) {
+    const scope = await cacheScopeSuffix(env);
+    await writeCache(env, personKey(scope), all);
+}
+/**
+ * 批量取人员信息（缓存优先，未命中的才打 `hrm.employee.batch`）。
+ * 返回 id → 记录；查不到的人不会出现在结果里。
+ */
+export async function resolvePersonsCached(env, ids, options = {}) {
+    const wanted = [...new Set(ids.map((id) => String(id ?? '').trim()).filter((id) => id !== ''))];
+    const persons = new Map();
+    if (wanted.length === 0)
+        return { persons, requests: 0, fromCache: 0 };
+    const all = options.refresh === true ? {} : await readAll(env);
+    const missing = [];
+    let fromCache = 0;
+    for (const id of wanted) {
+        const hit = all[id];
+        if (hit) {
+            persons.set(id, hit);
+            fromCache += 1;
+        }
+        else
+            missing.push(id);
+    }
+    if (missing.length === 0)
+        return { persons, requests: 0, fromCache };
+    let requests = 0;
+    for (let index = 0; index < missing.length; index += BATCH_MAX) {
+        const chunk = missing.slice(index, index + BATCH_MAX);
+        try {
+            const { hrmEmployeeOperations } = await import('../../../hrm/operations/employee.js');
+            const batch = hrmEmployeeOperations.find((operation) => operation.name === 'hrm.employee.batch');
+            if (!batch)
+                break;
+            const result = await batch.handler({ ids: chunk }, env);
+            requests += 1;
+            const rows = (result?.data?.rows ?? result?.data?.userList ?? []);
+            for (const row of rows) {
+                const id = String(row?.id ?? '').trim();
+                if (!id)
+                    continue;
+                const record = {
+                    id,
+                    name: String(row?.name ?? '').trim(),
+                    ...(row?.department ? { department: String(row.department) } : {}),
+                    ...(row?.departmentId ? { departmentId: String(row.departmentId) } : {}),
+                    ...(row?.subCompany ? { subCompany: String(row.subCompany) } : {}),
+                    ...(row?.position ? { position: String(row.position) } : {}),
+                    ...(row?.mobile ? { mobile: String(row.mobile) } : {}),
+                    ...(row?.jobNum ? { jobNum: String(row.jobNum) } : {}),
+                    ...(row?.imCid ? { imCid: String(row.imCid) } : {}),
+                    savedAt: Date.now(),
+                };
+                persons.set(id, record);
+                all[id] = record;
+            }
+        }
+        catch {
+            // 查失败不影响业务：调用方拿到的是缺项，自行降级
+        }
+    }
+    if (requests > 0)
+        await writeAll(env, all);
+    return { persons, requests, fromCache };
+}
+/** 兼容老用法：只要 id → 姓名。 */
+export async function resolveNamesCached(env, ids) {
+    const { persons } = await resolvePersonsCached(env, ids);
+    const map = new Map();
+    for (const [id, person] of persons) {
+        if (person.name)
+            map.set(id, person.name);
+    }
+    return map;
+}