weaver-work-cli 0.1.21 → 0.1.23

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

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { meetingConfirmationError, meetingPartialError, meetingValidationError } from '../../errors.js';
 import { meetingSuccess, SCHEMA_ID } from '../types.js';
-import { assertDateTimeMinute, toIdString } from '../shared.js';
+import { assertDateTimeMinute, assertDateTimeSecond, toIdString } from '../shared.js';
 import { isWriteKind } from './catalog.js';
 /** EB（eBuilder formdata）通用路径前缀（资料核实）。 */
 export const EB_BASE = '/api/ebuilder/form/formdata/v2';
@@ -44,15 +44,15 @@ function stableStringify(value) {
     }
     return JSON.stringify(value ?? null);
 }
-function fingerprint(value) {
+export function fingerprint(value) {
     return createHash('sha256').update(stableStringify(value)).digest('hex').slice(0, 32);
 }
-function requireConfirm(args, action) {
+export function requireConfirm(args, action) {
     if (args.confirm !== true) {
         throw meetingConfirmationError(action, { hint: '重新调用时传入 confirm=true 与 prepare 返回的 continuation' });
     }
 }
-async function verifyLease(args, action, env) {
+export async function verifyLease(args, action, env) {
     const lease = await env.continuation.verify(args.continuation, action);
     const session = await env.host.getSession();
     if (lease.baseUrl !== session.baseUrl || lease.profile !== session.profile || lease.userId !== session.userId) {
@@ -71,19 +71,31 @@ function isNetworkError(error) {
  * 该缺陷曾导致 CLI 的 EB 读操作全线失败，并连带使 `meeting.env.detect` 的 EB 冒烟失败、
  * 环境被误判为 standard 版。
  */
-export function queryBody(userId) {
-    return { datajson: { mainTable: {}, header: { operator: userId } } };
+export function queryBody(userId, page) {
+    return {
+        datajson: {
+            mainTable: {},
+            // ⚠️ 分页必须放在 body 的 pageInfo 里（值为字符串）：只放 URL query 时 EB 会忽略，
+            // 恒定返回首页 10 条（2026-09-21 真机暴露：pageSize=60 仍只回 10 条）。
+            ...(page ? { pageInfo: { pageNo: String(page.pageNo), pageSize: String(page.pageSize) } } : {}),
+            header: { operator: userId },
+        },
+    };
 }
 /** 详情接口 body（getFormDataByPk）：顶层 mainTable 传 id。 */
 function detailBody(userId, id) {
     return { datajson: { mainTable: { id }, header: { operator: userId } } };
 }
-/** 写操作 body：datas 数组包裹 mainTable（漏用 datas 会报 datas 节点未找到）。 */
-function writeBody(userId, mainTable) {
+/** 写操作 body：datas 数组包裹 mainTable（+ 明细节点）；漏用 datas 会报 datas 节点未找到。 */
+export function writeBody(userId, payload) {
+    const datas = { mainTable: payload.mainTable, ...payload.details };
+    const operationinfo = { printCost: false, asyncPostProcess: false, asyncMark: false };
+    if (Object.keys(payload.operateType).length > 0)
+        operationinfo.operateType = payload.operateType;
     return {
         datajson: {
-            operationinfo: { printCost: false, asyncPostProcess: false, asyncMark: false },
-            datas: [{ mainTable }],
+            operationinfo,
+            datas: [datas],
             header: { operator: userId },
         },
     };
@@ -159,7 +171,14 @@ function buildReadOperation(endpoint) {
                     body: detailBody(session.userId, id),
                     acceptBusiness,
                 });
-                const data = response?.datajson?.mainTable ?? response?.datajson ?? response;
+                // EB 的 getFormDataByPk 与 list 一致，把数据放在 `datajson.datas[].mainTable`。
+                // 早期实现直接返回整个 datajson → data 变成 `{datas,status}`（2026-09-21 真机发现）。
+                const { rows } = extractEbRows(response);
+                const data = rows[0]?.mainTable ?? response?.datajson?.mainTable ?? null;
+                if (data === undefined || data === null) {
+                    // 不存在的 id 必须明确报「未找到」，否则调用方会拿着空对象继续往下走。
+                    throw meetingValidationError('not_found', `${endpoint.interfacePk} 未找到 id=${id} 的数据（可能已被删除，或当前账号无权限）`, { id, interfacePk: endpoint.interfacePk });
+                }
                 return meetingSuccess(endpoint.operation, { id, data }, endpoint.notes ? { meta: { notes: endpoint.notes } } : {});
             }
             const query = {};
@@ -199,21 +218,75 @@ function buildReadOperation(endpoint) {
                 path,
                 operation: endpoint.operation,
                 query: { ...query, pageNo, pageSize },
-                body: queryBody(session.userId),
+                // 分页同时进 body.pageInfo：EB 只认 body 里的 pageInfo，仅放 URL query 会被忽略。
+                body: queryBody(session.userId, { pageNo, pageSize }),
                 acceptBusiness,
             });
             const { rows, total: listTotal } = extractEbRows(response);
+            // count 接口与实际行数不一致时（本租户 `query_mt_topic_count` 恒返回 0，而 list 有数据），
+            // 以"实际取到的行数"为下限，避免出现 total=0 却有数据的自相矛盾结果。
+            const resolvedTotal = total ?? listTotal ?? rows.length;
+            // 结果后处理（如决议任务进度 / 签到回执出席汇总）：只**增**一个字段，原始 rows 原样返回。
+            // 统一注入 `page`（本页 + 总数），避免各实现把"当页行数"误当成总数（2026-09-22 踩到：
+            // 签到全量 261 条、pageSize=200 时，summary 里写的 total 只有 200）。
+            const pageMeta = {
+                pageNo,
+                pageSize,
+                pageCount: rows.length,
+                total: Math.max(resolvedTotal, rows.length),
+            };
+            const summarized = endpoint.summarizeRows
+                ? endpoint.summarizeRows(rows, {
+                    pageCount: rows.length,
+                    total: pageMeta.total,
+                    pageNo,
+                    pageSize,
+                })
+                : undefined;
+            const progress = summarized === undefined
+                ? undefined
+                : summarized !== null && typeof summarized === 'object'
+                    ? { ...summarized, page: pageMeta }
+                    : { value: summarized, page: pageMeta };
             return meetingSuccess(endpoint.operation, {
-                total: total ?? listTotal ?? rows.length,
+                total: Math.max(resolvedTotal, rows.length),
                 pageNo,
                 pageSize,
                 count: rows.length,
+                ...(progress ? { progress } : {}),
                 rows,
                 filters: query,
             }, endpoint.notes ? { meta: { notes: endpoint.notes } } : {});
         },
     };
 }
+/**
+ * 主键是否走 URL query。
+ *
+ * 2026-09-21 真机实测：`update_meeting_sign_info` **只**把主键放在 body(`datas[].mainTable.id`) 时，
+ * 服务端报「主键传入不能为空」—— 该接口的主键需**通过 URL 传递**。
+ * 因此对声明了 `pkQueryParam` 的接口，把主键**同时**放进 query（body 仍保留 id，满足文档「id 必填」）。
+ */
+function writePkQuery(endpoint, payload) {
+    // delete 一律把主键放 URL：真机实测 `delete_roomusage` 只在 body 传 id 会报「主键传入不能为空」
+    // （与 `update_meeting_sign_info` 同因）；update 按接口的 pkQueryParam 声明。
+    // 多带一个 `?id=` 对已支持 body 主键的接口无害（`room.delete` / `update_room` 均已实测通过）。
+    const param = endpoint.pkQueryParam ?? (endpoint.kind === 'delete' ? 'id' : undefined);
+    if (!param)
+        return undefined;
+    const value = payload.mainTable.id;
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    return { [param]: value };
+}
+/** 预览用的完整路径（带主键 query）。 */
+function pathWithPk(endpoint, basePath, payload) {
+    const query = writePkQuery(endpoint, payload);
+    if (!query)
+        return basePath;
+    const search = new URLSearchParams(Object.entries(query).map(([key, item]) => [key, String(item)])).toString();
+    return `${basePath}?${search}`;
+}
 /** 计算小时差（支持小数，如 1.5），用于 create_meeting 的 mt_hours。 */
 function diffHours(begin, end) {
     const parse = (text) => {
@@ -230,38 +303,108 @@ function diffHours(begin, end) {
     const hours = (to - from) / 3_600_000;
     return hours > 0 ? Math.round(hours * 100) / 100 : undefined;
 }
-/** 写操作字段归一化：白名单过滤 + 日期格式校验 + 必填校验 + 会议建会特化默认值。 */
-function normalizeEbWrite(endpoint, args, userId) {
-    const fields = endpoint.kind === 'delete' ? ['id'] : endpoint.fields ?? [];
+/** 单条明细行归一化：白名单过滤 + 日期校验 + 逐行必填校验。 */
+function normalizeDetailRow(spec, row, index) {
+    if (!row || typeof row !== 'object' || Array.isArray(row)) {
+        throw meetingValidationError('invalid_detail_row', `${spec.node}[${index}] 必须是对象`, { node: spec.node, index });
+    }
+    const source = row;
     const out = {};
+    for (const field of spec.fields) {
+        const value = source[field];
+        if (value === undefined || value === null)
+            continue;
+        const isDateField = (spec.dateFields ?? []).includes(field) || (spec.secondDateFields ?? []).includes(field);
+        // 日期字段的**显式清空**：传纯空白 ⇒ 落库为空串。
+        // 必要性（2026-09-21 真机）：`finish_date` 是**服务端必填**，把已填日期改回"未完成"时必须传它；
+        // 而空串在下面会被跳过 ⇒ 服务端报「存为未填写的必填字段: finish_date」（页面生成的未完成记录同样是空值）。
+        if (isDateField && typeof value === 'string' && value.trim() === '') {
+            out[field] = '';
+            continue;
+        }
+        if (value === '')
+            continue;
+        out[field] = (spec.dateFields ?? []).includes(field)
+            ? assertDateTimeMinute(value, `${spec.node}[${index}].${field}`)
+            : (spec.secondDateFields ?? []).includes(field)
+                ? assertDateTimeSecond(value, `${spec.node}[${index}].${field}`)
+                : value;
+    }
+    // 枚举校验：EB 对非法枚举值常不报错（或静默忽略），入口拦下并给出可选值最省排查成本。
+    for (const [field, allowed] of Object.entries(spec.enumFields ?? {})) {
+        const value = out[field];
+        if (value === undefined)
+            continue;
+        if (!allowed.includes(String(value))) {
+            throw meetingValidationError('invalid_enum', `${spec.node} 第 ${index + 1} 条 ${field} 取值非法：${String(value)}（可选：${allowed.join(' / ')}）`, { node: spec.node, index, field, value: String(value), allowed });
+        }
+    }
+    const missing = (spec.requiredFields ?? []).filter((field) => out[field] === undefined);
+    if (missing.length > 0) {
+        throw meetingValidationError('missing_required_field', `${spec.node} 第 ${index + 1} 条缺少必填字段：${missing.join(', ')}`, { node: spec.node, index, missing });
+    }
+    return out;
+}
+/**
+ * 写操作字段归一化：白名单过滤 + 日期格式校验 + 必填校验 + 会议建会特化默认值 + 明细行归一化。
+ *
+ * 明细缺失/行数不足的报错要**指名到底哪个节点、第几条、缺哪个字段** —— 决议一次可能几十条明细，
+ * 只报“缺少必填字段”会让调用方无从下手。
+ */
+export function normalizeEbWrite(endpoint, args, userId) {
+    const fields = endpoint.kind === 'delete' ? ['id'] : endpoint.fields ?? [];
+    const mainTable = {};
     for (const field of fields) {
         const value = args[field];
         if (value === undefined || value === null || value === '')
             continue;
         if ((endpoint.dateFields ?? []).includes(field)) {
-            out[field] = assertDateTimeMinute(value, field);
+            mainTable[field] = assertDateTimeMinute(value, field);
+        }
+        else if ((endpoint.secondDateFields ?? []).includes(field)) {
+            mainTable[field] = assertDateTimeSecond(value, field);
         }
         else {
-            out[field] = value;
+            mainTable[field] = value;
         }
     }
     if (endpoint.interfacePk === 'create_meeting') {
-        if (out.caller === undefined)
-            out.caller = userId;
-        if (out.contacter === undefined)
-            out.contacter = userId;
-        const hours = typeof out.begin_datetime === 'string' && typeof out.end_datetime === 'string'
-            ? diffHours(out.begin_datetime, out.end_datetime)
+        if (mainTable.caller === undefined)
+            mainTable.caller = userId;
+        if (mainTable.contacter === undefined)
+            mainTable.contacter = userId;
+        const hours = typeof mainTable.begin_datetime === 'string' && typeof mainTable.end_datetime === 'string'
+            ? diffHours(mainTable.begin_datetime, mainTable.end_datetime)
             : undefined;
         if (hours !== undefined)
-            out.mt_hours = hours;
+            mainTable.mt_hours = hours;
     }
     const required = endpoint.kind === 'delete' ? ['id'] : endpoint.requiredFields ?? [];
-    const missing = required.filter((field) => out[field] === undefined);
+    const missing = required.filter((field) => mainTable[field] === undefined);
     if (missing.length > 0) {
         throw meetingValidationError('missing_required_field', `缺少必填字段：${missing.join(', ')}`, { missing });
     }
-    return out;
+    const details = {};
+    for (const spec of endpoint.details ?? []) {
+        const raw = args[spec.node];
+        const minRows = spec.minRows ?? 0;
+        if (raw === undefined || raw === null) {
+            if (minRows > 0) {
+                throw meetingValidationError('missing_required_field', `缺少必填明细：${spec.node} 至少 ${minRows} 条${spec.purpose ? `（${spec.purpose}）` : ''}`, { node: spec.node, minRows });
+            }
+            continue;
+        }
+        if (!Array.isArray(raw)) {
+            throw meetingValidationError('invalid_detail', `${spec.node} 必须是数组，每个元素为一条明细对象`, { node: spec.node });
+        }
+        const rows = raw.map((row, index) => normalizeDetailRow(spec, row, index));
+        if (rows.length < minRows) {
+            throw meetingValidationError('missing_required_field', `${spec.node} 至少 ${minRows} 条明细（当前 ${rows.length} 条）`, { node: spec.node, minRows, actual: rows.length });
+        }
+        if (rows.length > 0)
+            details[spec.node] = rows;
+    }
+    return { mainTable, details, operateType: {} };
 }
 function buildWriteInputSchema(endpoint, includeConfirm) {
     const properties = {};
@@ -275,21 +418,53 @@ function buildWriteInputSchema(endpoint, includeConfirm) {
     else {
         for (const field of endpoint.fields ?? []) {
             const isDate = (endpoint.dateFields ?? []).includes(field);
+            const isSecondDate = (endpoint.secondDateFields ?? []).includes(field);
             const required = (endpoint.requiredFields ?? []).includes(field);
             properties[field] = isDate
                 ? { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$', description: `${field}（yyyy-MM-dd HH:mm，不带秒）` }
-                : { type: 'string', description: `${field}${required ? '（必填）' : ''}` };
+                : isSecondDate
+                    ? { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$', description: `${field}（yyyy-MM-dd HH:mm:ss，带秒）` }
+                    : { type: 'string', description: `${field}${required ? '（必填）' : ''}` };
+        }
+        for (const spec of endpoint.details ?? []) {
+            const requiredFields = spec.requiredFields ?? [];
+            properties[spec.node] = {
+                type: 'array',
+                description: `${spec.purpose ?? `${spec.node} 明细`}；每条字段：${spec.fields.join(', ')}`
+                    + `${requiredFields.length > 0 ? `；每条必填：${requiredFields.join(', ')}` : ''}`
+                    + `${(spec.minRows ?? 0) > 0 ? `；最少 ${spec.minRows} 条` : ''}`,
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: Object.fromEntries(spec.fields.map((field) => [
+                        field,
+                        (spec.dateFields ?? []).includes(field)
+                            ? { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$', description: `${field}（yyyy-MM-dd HH:mm）` }
+                            : (spec.secondDateFields ?? []).includes(field)
+                                ? { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$', description: `${field}（yyyy-MM-dd HH:mm:ss，带秒）` }
+                                : { type: 'string', description: `${field}${requiredFields.includes(field) ? '（必填）' : ''}` },
+                    ])),
+                    required: requiredFields,
+                },
+            };
         }
     }
-    const requiredBase = endpoint.kind === 'delete' ? ['id'] : endpoint.requiredFields ?? [];
+    const requiredBase = endpoint.kind === 'delete'
+        ? ['id']
+        : [
+            ...(endpoint.requiredFields ?? []),
+            ...(endpoint.details ?? []).filter((spec) => (spec.minRows ?? 0) > 0).map((spec) => spec.node),
+        ];
     return {
         type: 'object',
         additionalProperties: false,
         properties,
-        required: includeConfirm ? ['confirm', 'continuation', ...requiredBase] : requiredBase,
+        // apply（includeConfirm=true）只要求确认票据：业务字段已在 prepare 时写入 continuation 快照，
+        // 由 apply 从快照取用（properties 仍保留业务字段，允许调用方冗余传入）。
+        required: includeConfirm ? ['confirm', 'continuation'] : requiredBase,
     };
 }
-function buildWriteOperations(endpoint, preflight) {
+function buildWriteOperations(endpoint, preflight, afterWrite) {
     const prepareName = `${endpoint.operation}.prepare`;
     const applyName = `${endpoint.operation}.apply`;
     const writeOp = EB_WRITE_OP[endpoint.kind];
@@ -325,7 +500,7 @@ function buildWriteOperations(endpoint, preflight) {
                     interfacePk: endpoint.interfacePk,
                     kind: endpoint.kind,
                     body: payload,
-                    path,
+                    path: pathWithPk(endpoint, path, payload),
                     notes: endpoint.notes ?? [],
                 },
                 continuation: token,
@@ -347,17 +522,22 @@ function buildWriteOperations(endpoint, preflight) {
             requireConfirm(args, applyName);
             const lease = await verifyLease(args, applyName, env);
             const session = await env.host.getSession();
-            const payload = normalizeEbWrite(endpoint, args, session.userId);
+            // payload **以 continuation 内的快照为准**：apply 的入参只有 confirm + continuation，
+            // 用 args 重新归一化会必然缺字段（2026-09-21 真机实测：回执更新 apply 报 missing_required_field）。
+            // 与 meeting.eb.sign.mark / decision.publish 的独立实现保持一致。
+            const payload = lease.payload;
             if (lease.fingerprint !== fingerprint(payload)) {
                 // 带上两侧快照：`target_changed` 否则无从判断到底哪个字段变了（排查成本极高）。
                 throw meetingValidationError('target_changed', '提交内容与 prepare 时的快照不一致，请重新执行 prepare', { expected: lease.payload, actual: payload });
             }
+            const pkQuery = writePkQuery(endpoint, payload);
             let response;
             try {
                 response = await env.host.request({
                     method: 'POST',
                     path,
                     operation: applyName,
+                    ...(pkQuery ? { query: pkQuery } : {}),
                     body: writeBody(session.userId, payload),
                     acceptBusiness,
                 });
@@ -373,10 +553,15 @@ function buildWriteOperations(endpoint, preflight) {
             if (dj.status === false) {
                 throw meetingValidationError('eb_write_not_applied', `${endpoint.interfacePk} 返回 status=false，服务端未生效，请核对字段与权限后重试`);
             }
+            const rawIds = dj.dataIds ?? dj.ids;
+            const dataIds = (Array.isArray(rawIds) ? rawIds : []).map((item) => String(item));
+            // 附加写入（当前仅建会：补建 占用 / 回执 / 签到）。主写入已成功，钩子内部不抛错。
+            const association = afterWrite ? await afterWrite({ endpoint, payload, dataIds, env }) : undefined;
             return meetingSuccess(applyName, {
                 status: 'COMPLETE',
                 interfacePk: endpoint.interfacePk,
-                dataIds: dj.dataIds ?? dj.ids ?? undefined,
+                dataIds: rawIds ?? undefined,
+                ...(association ? { association } : {}),
                 result: response,
             });
         },
@@ -385,5 +570,7 @@ function buildWriteOperations(endpoint, preflight) {
 }
 /** 把声明式目录转换为可注册的 operation 列表（读=1 个，写=prepare+apply 2 个）。 */
 export function buildEbOperations(endpoints, options = {}) {
-    return endpoints.flatMap((endpoint) => (isWriteKind(endpoint.kind) ? buildWriteOperations(endpoint, options.preflight) : [buildReadOperation(endpoint)]));
+    return endpoints.flatMap((endpoint) => (isWriteKind(endpoint.kind)
+        ? buildWriteOperations(endpoint, options.preflight, options.afterWrite)
+        : [buildReadOperation(endpoint)]));
 }

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

@@ -1,6 +1,8 @@
 import { EB_ENDPOINTS } from './catalog.js';
 import { buildEbOperations } from './factory.js';
 import { ebMeetingWritePreflight, meetingEbConflictOperations } from './conflict.js';
+import { meetingEbDecisionOperations } from './decision.js';
+import { ebMeetingAssociation } from './association.js';
 /**
  * 会议 EB 版（eBuilder）operations。
  *
@@ -15,8 +17,23 @@ import { ebMeetingWritePreflight, meetingEbConflictOperations } from './conflict
  *   仅提醒只给 warnings、检测失败视为冲突）；
  * - `meetingEbConflictOperations` 另提供「只查不建」的 `meeting.eb.conflict.room` /
  *   `meeting.eb.conflict.member`（后者为 2 次请求方案，无 N+1）。
+ *
+ * 会议决议（2026-09-21 新增）：
+ * - catalog 新增 7 个 endpoint（决议概述 4 + 决议任务 2 + 会议标记 1），其中
+ *   `create_mt_decision` / `update_mt_decision_task` 带 detail1 明细（见 catalog 的 details 声明）；
+ * - `meetingEbDecisionOperations` 提供语义化入口：`meeting.eb.decision.publish`（写决议 + 写回会议，
+ *   一步到位，避免漏掉"把会议标记为已决议"）与 `meeting.eb.sign.mark`（补签走 update，防止误建记录）。
+ *
+ * 建会关联数据补建（2026-09-21 新增）：
+ * - `ebMeetingAssociation` 挂到 apply 之后：`create_meeting` 只写会议主表，**不会**生成
+ *   占用 / 回执 / 签到，而这三样是会议室冲突检测、参会人冲突检测与补签的硬依赖，故由 CLI 补齐
+ *   （见 association.ts：主写入已成功，补建失败只回报 warnings，不中断）。
  */
 export const meetingEbOperations = [
-    ...buildEbOperations(EB_ENDPOINTS, { preflight: ebMeetingWritePreflight }),
+    ...buildEbOperations(EB_ENDPOINTS, {
+        preflight: ebMeetingWritePreflight,
+        afterWrite: ebMeetingAssociation,
+    }),
     ...meetingEbConflictOperations,
+    ...meetingEbDecisionOperations,
 ];

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

@@ -0,0 +1,212 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { meetingStateDir } from '../env.js';
+/**
+ * 会议「打开链接」口径（与 standalone 版 meeting-link.mjs 对齐）：
+ *
+ * - **EB 版**：`{baseUrl}/sp/ebdfpage/card/0/{objid}/{dataid}`（`card` 后的 `0` 恒为 0）。
+ *   `objid` **不是**固定值，也不是 formId —— 必须按表 tag 用 getObjsByTag 解析，且随环境变化，
+ *   因此按 `baseUrl|tenantKey` 长期缓存（`<stateDir>/meeting/obj-ids.json`）。
+ * - **标准版**：会议详情 `/sp/meeting/meetingSingle?meetingId=`；会议室 / 会议类型**没有单页**。
+ *
+ * ⚠️ 长 id 精度：appId / objid 都是 15 位以上整数，超 2^53 会被 JSON.parse 舍入；
+ * 会议 host 已开启 `bigIntStrings`，此处只做字符串提取，**禁止**自行 Number() 转换。
+ */
+/** 会议 EB 各表单 tag（源码 MeetingEbFormTagEnum + 全仓调用核实）。 */
+export const MEETING_EB_TAGS = {
+    meeting: 'uf_mt_detail',
+    room: 'uf_mt_room_base',
+    roomType: 'uf_mt_room_type',
+    roomUsage: 'uf_mt_room_usage',
+    setting: 'uf_mt_base_set',
+    mtType: 'uf_mt_type',
+    sign: 'uf_mt_sign',
+    receipt: 'uf_mt_receipt_member',
+    topic: 'uf_mt_topic',
+    minutes: 'uf_mt_minutes',
+};
+/** 会议 EB 应用 tag（getAppIdsByTag 的入参）。 */
+export const MEETING_EB_APP_TAG = 'meetingEb_wsd';
+const APP_TAG_PATH = '/api/meetingEb/form/getAppIdsByTag';
+const OBJS_BY_TAG_PATH = '/api/meetingEb/form/getObjsByTag';
+/** 标准版没有单页地址的对象（standalone 口径：只输出数据，不附链接）。 */
+export const STANDARD_NO_PAGE_TYPES = ['room', 'mtType'];
+function cacheFile(ctx) {
+    return resolve(meetingStateDir(ctx), 'obj-ids.json');
+}
+function emptyCache() {
+    return { schemaVersion: 1, environments: {} };
+}
+async function readObjCache(ctx) {
+    const file = cacheFile(ctx);
+    if (!existsSync(file))
+        return emptyCache();
+    try {
+        const parsed = JSON.parse(await readFile(file, 'utf8'));
+        if (!parsed || typeof parsed !== 'object' || !parsed.environments)
+            return emptyCache();
+        return parsed;
+    }
+    catch {
+        return emptyCache();
+    }
+}
+/** objid 缓存写入失败只降级为 warning（下次重新解析即可），不阻断链接生成。 */
+async function writeObjCache(ctx, envKey, entry) {
+    try {
+        const file = cacheFile(ctx);
+        await mkdir(resolve(file, '..'), { recursive: true });
+        const cache = await readObjCache(ctx);
+        cache.environments[envKey] = entry;
+        await writeFile(file, JSON.stringify(cache, null, 2), 'utf8');
+        return undefined;
+    }
+    catch (error) {
+        return `objid 缓存写入失败（不影响本次链接）：${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+/** 从任意形态（数字/字符串/数组/对象）中提取第一个长数字 id。 */
+export function firstLongId(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const found = firstLongId(item);
+            if (found)
+                return found;
+        }
+        return undefined;
+    }
+    if (typeof value === 'object') {
+        const record = value;
+        for (const key of ['id', 'appId', 'objId', 'idobjId', 'value', 'data', 'result']) {
+            if (record[key] !== undefined) {
+                const found = firstLongId(record[key]);
+                if (found)
+                    return found;
+            }
+        }
+        return undefined;
+    }
+    const text = String(value).trim();
+    const match = /\d{15,}/u.exec(text) ?? /^\d+$/u.exec(text);
+    return match ? match[0] : undefined;
+}
+/** 从 getObjsByTag 响应里挑出目标 tag 的表对象（优先 tableName 非空项，对齐 CommonUtils.getFormObjInfo）。 */
+export function pickEbObj(value) {
+    const raw = value && typeof value === 'object' && !Array.isArray(value)
+        ? value.data ?? value
+        : value;
+    const list = Array.isArray(raw) ? raw : [];
+    const candidates = list.filter((item) => Boolean(item) && typeof item === 'object');
+    const obj = candidates.find((item) => String(item.tableName ?? '').trim() !== '') ?? candidates[0];
+    if (!obj)
+        return undefined;
+    const id = obj.id ?? obj.objId;
+    if (id === undefined || id === null || String(id).trim() === '')
+        return undefined;
+    return {
+        objId: String(id),
+        tableName: String(obj.tableName ?? ''),
+        showName: String(obj.showName ?? obj.objName ?? obj.name ?? ''),
+    };
+}
+async function fetchAppId(host, warnings) {
+    try {
+        const response = await host.request({
+            method: 'POST',
+            path: APP_TAG_PATH,
+            operation: 'meeting.link',
+            body: { tag: MEETING_EB_APP_TAG },
+            // getAppIdsByTag 的响应是裸数字数组/`{data:[...]}`，没有 code/status 语义，
+            // 默认 isBusinessSuccess 会把它判成业务失败 ⇒ 必须放宽业务判定，自行提取。
+            acceptBusiness: () => true,
+        });
+        const appId = firstLongId(response);
+        if (!appId)
+            warnings.push('会议 EB 应用 id 解析失败（getAppIdsByTag 未返回 appId），无法生成 EB 链接');
+        return appId ?? null;
+    }
+    catch (error) {
+        warnings.push(`会议 EB 应用 id 解析失败：${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+async function fetchObj(host, appId, tag) {
+    const response = await host.request({
+        method: 'POST',
+        path: OBJS_BY_TAG_PATH,
+        operation: 'meeting.link',
+        body: { appId, tag },
+        acceptBusiness: () => true,
+    });
+    return pickEbObj(response);
+}
+/**
+ * 解析会议 EB 各表 tag → objid（按 `baseUrl|tenantKey` 长期缓存）。
+ * 解析失败只写入 warnings 并把对应 tag 留空，由调用方降级为「不附链接」，不抛错。
+ */
+export async function resolveMeetingEbObjs(host, ctx, options = { tags: [] }) {
+    const session = await host.getSession();
+    const envKey = `${session.baseUrl}|${session.tenantKey}`;
+    const warnings = [];
+    const cache = await readObjCache(ctx);
+    const entry = cache.environments[envKey];
+    let appId = entry?.appId ?? null;
+    const objs = { ...(entry?.objs ?? {}) };
+    const uniqueTags = [...new Set(options.tags.filter((tag) => tag && tag.trim() !== ''))];
+    const forced = options.refresh === true;
+    const missing = forced ? uniqueTags : uniqueTags.filter((tag) => !objs[tag]?.objId);
+    // 缓存命中且无需刷新时直接用缓存。
+    // 注意：条件不要抽成 `const needAppId = ...` 再判断 —— TS 的「别名条件收窄」会把 appId
+    // 窄化成 string，导致后面重新赋值 appId（string|null）报 TS2322。
+    if (forced === false && appId !== null && missing.length === 0 && uniqueTags.length > 0) {
+        return { appId, objs, fromCache: true, warnings };
+    }
+    if (forced === true)
+        appId = null;
+    if (appId === null)
+        appId = await fetchAppId(host, warnings);
+    if (appId === null)
+        return { appId: null, objs, fromCache: false, warnings };
+    for (const tag of missing) {
+        try {
+            const obj = await fetchObj(host, appId, tag);
+            if (obj)
+                objs[tag] = obj;
+            else
+                warnings.push(`tag=${tag} 未解析到 objid，该对象不附链接`);
+        }
+        catch (error) {
+            warnings.push(`tag=${tag} 解析 objid 失败：${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    const cacheWarning = await writeObjCache(ctx, envKey, {
+        appId,
+        objs,
+        updatedAt: new Date().toISOString(),
+    });
+    if (cacheWarning)
+        warnings.push(cacheWarning);
+    return { appId, objs, fromCache: false, warnings };
+}
+/** EB 卡片页路径：`/sp/ebdfpage/card/0/{objid}/{dataid}`（`0` 恒为 0）。 */
+export function buildEbCardPath(objId, dataId) {
+    return `/sp/ebdfpage/card/0/${encodeURIComponent(objId)}/${encodeURIComponent(dataId)}`;
+}
+/** 标准版会议详情路径：`/sp/meeting/meetingSingle?meetingId={id}`。 */
+export function buildStandardMeetingPath(meetingId) {
+    return `/sp/meeting/meetingSingle?meetingId=${encodeURIComponent(meetingId)}`;
+}
+/** 拼接绝对地址（baseUrl 结尾斜杠归一化）。 */
+export function meetingAbsoluteUrl(baseUrl, path) {
+    if (!path)
+        return null;
+    const root = baseUrl.replace(/\/+$/u, '');
+    return `${root}${path.startsWith('/') ? path : `/${path}`}`;
+}
+/** 生成 Markdown 内联链接（url 为空时返回 undefined，调用方只输出名称）。 */
+export function meetingMarkdownLink(name, url) {
+    return url ? `[${name}](${url})` : undefined;
+}