weaver-work-cli 0.1.38 → 0.1.40

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

@@ -0,0 +1,99 @@
+import { EB_BASE, ebBusinessSuccess, extractEbRows, queryBody } from './factory.js';
+import { readCache, writeCache, cacheScopeSuffix } from './cache.js';
+/** 占用缓存 TTL：太长会放行别人刚订的房间，太短失去缓存意义 —— 5 分钟 + 提交即作废。 */
+const USAGE_TTL_MS = 5 * 60 * 1000;
+const MAX_PAGES = 10;
+const PAGE_SIZE = 200;
+/** 取 'yyyy-MM-dd HH:mm' 的日期部分。 */
+export function dayOf(datetime) {
+    return String(datetime ?? '').trim().slice(0, 10);
+}
+/**
+ * 时间重叠判定：占用开始 < 我的结束 且 占用结束 > 我的开始。
+ * 字符串直接比较成立的前提是 'yyyy-MM-dd HH:mm' 定宽格式（EB 出参即如此）。
+ */
+export function usageOverlaps(row, begin, end) {
+    return row.start < end && row.end > begin;
+}
+/** 从全天占用里筛出「某会议室在某时段」的占用记录（可排除自身会议）。 */
+export function filterUsages(rows, options) {
+    return rows.filter((row) => {
+        if (options.roomId && row.roomId !== options.roomId)
+            return false;
+        if (options.excludeMtId && row.mtId && row.mtId === options.excludeMtId)
+            return false;
+        return usageOverlaps(row, options.begin, options.end);
+    });
+}
+/** 从全天占用算出「某时段被占用的会议室 id 集合」（替代按时段的 query_roomusage_list）。 */
+export function busyRoomIds(rows, begin, end) {
+    const ids = new Set();
+    for (const row of rows) {
+        if (row.roomId && usageOverlaps(row, begin, end))
+            ids.add(row.roomId);
+    }
+    return ids;
+}
+function usageKey(scope, day) {
+    return `usage-v1-${scope}-${day}`;
+}
+/**
+ * 加载某天的全部会议室占用（缓存优先）。
+ * 返回 rows 供本地过滤；fromCache=true 表示没打网络（调用方可用于提示/计时）。
+ */
+export async function loadDayUsages(env, day, options = {}) {
+    const scope = await cacheScopeSuffix(env);
+    const key = usageKey(scope, day);
+    if (options.refresh !== true) {
+        const cached = await readCache(env, key, { ttlMs: USAGE_TTL_MS });
+        if (cached) {
+            return { rows: cached.data, fromCache: true, ageMs: cached.ageMs, requests: 0 };
+        }
+    }
+    const session = await env.host.getSession();
+    const rows = [];
+    let requests = 0;
+    for (let pageNo = 1; pageNo <= MAX_PAGES; pageNo += 1) {
+        const response = await env.host.request({
+            method: 'POST',
+            path: `${EB_BASE}/getFormDataList/query_roomusage_list`,
+            operation: 'meeting.eb.roomUsage.list',
+            // 与 fetchBusyRoomIds 同一套算子语义：enddatetime lt 当天末尾、begindatetime gt 当天开头
+            query: { enddatetime: `${day} 23:59`, begindatetime: `${day} 00:00` },
+            body: queryBody(session.userId, { pageNo, pageSize: PAGE_SIZE }),
+            acceptBusiness: ebBusinessSuccess,
+        });
+        requests += 1;
+        const { rows: pageRows } = extractEbRows(response);
+        for (const row of pageRows) {
+            const main = row?.mainTable ?? row ?? {};
+            const roomId = String(main.address ?? main.room_id ?? '').trim();
+            const start = String(main.startdate ?? '').trim();
+            const end = String(main.enddate ?? '').trim();
+            if (roomId && start && end) {
+                rows.push({ roomId, mtId: String(main.mt_id ?? '').trim(), start, end });
+            }
+        }
+        if (pageRows.length < PAGE_SIZE)
+            break;
+    }
+    await writeCache(env, key, rows);
+    return { rows, fromCache: false, ageMs: 0, requests };
+}
+/** 作废某天的占用缓存（提交成功后必须调，否则 5 分钟内新订的房间会被旧台账掩盖）。 */
+export async function invalidateDayUsages(env, day) {
+    const scope = await cacheScopeSuffix(env);
+    await clearCache(env, usageKey(scope, day));
+}
+/** 直接删缓存文件（写空记录会把"刚被订满"伪装成"全天空闲"，必须真删）。 */
+async function clearCache(env, key) {
+    try {
+        const { rm } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        const { meetingStateDir } = await import('../env.js');
+        await rm(join(meetingStateDir(env.ctx), 'cache', `${key}.json`), { force: true });
+    }
+    catch {
+        // 删失败不影响业务：TTL 5 分钟兜底
+    }
+}

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

@@ -23,9 +23,24 @@
  */
 import { meetingValidationError } from '../errors.js';
 import { meetingSuccess } from './types.js';
-/** ESB 动作流 id 的**内置默认值**（参考租户配置）。换租户请用入参 `flowGenerateMinutes` / `flowGenerateDocument` 覆盖。 */
-const FLOW_GENERATE_MINUTES = '1325287772302863633';
-const FLOW_GENERATE_DOCUMENT = '1325287772302863628';
+/**
+ * ESB 动作流标识：本租户 EB 后台的 **primary_key**（32 位十六进制）。
+ *
+ * ⛔ 触发时必须走「唯一值触发」入参 `uniqueIndent`：
+ * `esbFlowId` 只认 19 位数字 id，传 GUID 服务端直接报
+ * `can not cast to long, value : 7204…`（查模板）或 `{"code":400,"msg":"系统错误"}`（触发）。
+ * 2026-11-03 实测：同一组 id 用 `uniqueIndent` 触发，`resultCode=200 执行成功`。
+ *
+ * 换租户请用入参 `flowGenerateMinutes` / `flowGenerateDocument` 覆盖。
+ */
+const FLOW_GENERATE_MINUTES = '7204936B2ACC4B12A1CECD1DAB60DD97';
+const FLOW_GENERATE_DOCUMENT = '1F638AE31BC746C28A1D9DCF26D91037';
+/** ESB「解析纪要文档/音频附件」（primary_key）。附件解析入口，当前由后台解析任务触发，此处仅登记备查。 */
+const FLOW_PARSE_ATTACHMENT = 'AD8EE1B345FD4570AE1D0882FD1B5927';
+/** ESB「获取解析纪要音频结果」（primary_key）。音视频附件提取完成后由调用方按需触发。 */
+const FLOW_AUDIO_RESULT = '1DB38C10699A47E89DD7CEFDAA76B8A1';
+/** 智能纪要页面 id（租户级，没有接口能查；反查不到时用它兜底）。 */
+const DEFAULT_AI_MINUTE_PAGE = '1250830691712172036';
 function textOf(value) {
     return value === undefined || value === null ? '' : String(value);
 }
@@ -285,14 +300,14 @@ const meetingMinuteFromGroupChat = {
             },
             flowGenerateMinutes: {
                 type: 'string',
-                pattern: '^\\d+$',
-                description: 'ESB「根据解析文本生成智能纪要文本」流程 id。省略时用内置默认值；**换租户必须覆盖**'
-                    + '（流程 id 是租户级配置，各环境不同）',
+                pattern: '^(\\d+|[0-9A-Fa-f]{32})$',
+                description: 'ESB「根据解析文本生成智能纪要文本」的 id。可传 19 位数字 id 或 32 位十六进制 primary_key'
+                    + '（GUID 会自动走唯一值触发 uniqueIndent）。省略时用内置默认值；换租户必须覆盖',
             },
             flowGenerateDocument: {
                 type: 'string',
-                pattern: '^\\d+$',
-                description: 'ESB「保存解析并生成文档」流程 id。省略时用内置默认值；换租户必须覆盖',
+                pattern: '^(\\d+|[0-9A-Fa-f]{32})$',
+                description: 'ESB「保存解析并生成文档」的 id，支持数字 id 或 32 位 primary_key；省略时用内置默认值',
             },
         },
         required: ['mt_id'],
@@ -472,7 +487,8 @@ const meetingMinuteFromGroupChat = {
                 // 反查失败不影响主流程
             }
             if (!aiPageId) {
-                warnings.push('未取到 mt_minutes_ai_page（可传 aiPageId）；ESB 解析该字段可能必填，缺它会失败');
+                aiPageId = DEFAULT_AI_MINUTE_PAGE;
+                warnings.push(`未从已有纪要取到 mt_minutes_ai_page，已用本租户默认值 ${DEFAULT_AI_MINUTE_PAGE}`);
             }
         }
         // ⑥ 建纪要并写原文
@@ -512,6 +528,7 @@ const meetingMinuteFromGroupChat = {
             pipeline,
             aiPageId: aiPageId || null,
         };
+        let documentIdFromFlow = '';
         if (pipeline === 'text') {
             result.timings = { ...timings, total: Date.now() - startedAt };
             return meetingSuccess('meeting.minute.fromGroupChat', result, warnings.length > 0 ? { warnings } : undefined);
@@ -534,7 +551,11 @@ const meetingMinuteFromGroupChat = {
             const prepareOp = getEsbOperation('esb.trigger.prepare');
             const applyOp = getEsbOperation('esb.trigger.apply');
             const trigger = async (flowId, mainTable) => {
-                const pre = await prepareOp.handler({ employeeId, esbFlowId: flowId, customParams: { mainTable } }, esbEnv);
+                // 数字 id → 普通触发 esbFlowId；32 位十六进制 primary_key → 唯一值触发 uniqueIndent
+                const target = /^\d+$/.test(flowId)
+                    ? { esbFlowId: flowId }
+                    : { uniqueIndent: flowId };
+                const pre = await prepareOp.handler({ employeeId, ...target, customParams: { mainTable } }, esbEnv);
                 return applyOp.handler({ continuation: pre?.data?.continuation, confirm: true }, esbEnv);
             };
             try {
@@ -554,7 +575,9 @@ const meetingMinuteFromGroupChat = {
                 }
                 else {
                     try {
-                        await trigger(flowDocument, { parse_content: parseContent, mt_minute_id: minuteId });
+                        const docResult = await trigger(flowDocument, { parse_content: parseContent, mt_minute_id: minuteId });
+                        // 628 的返回里带 `customData.mainTable.wdID`（文档 id）；回读为空时用它兜底
+                        documentIdFromFlow = textOf(docResult?.data?.actionData?.responseData?.customData?.mainTable?.wdID);
                         mark('esbDocument', stepDocStart);
                     }
                     catch (error) {
@@ -568,7 +591,7 @@ const meetingMinuteFromGroupChat = {
         const row = final?.data?.data ?? {};
         result.finalStatus = textOf(row.minutes_status);
         result.parseContentLength = textOf(row.parse_content).length;
-        result.documentId = textOf(row.mt_minutes) || null;
+        result.documentId = textOf(row.mt_minutes) || documentIdFromFlow || null;
         result.timings = { ...timings, total: Date.now() - startedAt };
         return meetingSuccess('meeting.minute.fromGroupChat', result, warnings.length > 0 ? { warnings } : undefined);
     },

package/dist/shortcuts/workflow/host.js

@@ -2,6 +2,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { requireE10Session } from '../../internal/e10/context.js';
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10AuthenticationRequired } from '../../internal/e10/auth-recovery.js';
 import { workflowApiError, workflowAuthError, workflowNetworkError } from './errors.js';
 const DEFAULT_TIMEOUT_MS = 30_000;
 /**
@@ -81,6 +82,8 @@ export function isAtustRedirect(status, value) {
 export function isLoginExpired(value, httpStatus) {
     if (httpStatus === 401 || httpStatus === 403)
         return true;
+    if (isE10AuthenticationRequired({ status: httpStatus ?? 200, value }))
+        return true;
     if (isAtustRedirect(httpStatus, value))
         return true;
     const joined = payloadTexts(value).join('\n').toLowerCase();

package/dist/shortcuts/workflow/index.js

@@ -215,7 +215,7 @@ export const workflowShortcut = {
             const user = readUserIntents({ ctx: ctx });
             ctx.output.write({
                 dir: loaded.dir,
-                defaultFile: join(loaded.dir, 'default.json'),
+                defaultFile: loaded.dir ? join(loaded.dir, 'default.json') : null,
                 userIntentFile: user.file,
                 userIntentExists: user.exists,
                 userIntentError: user.error,

package/dist/shortcuts/workflow/operations/form.js

@@ -34,8 +34,16 @@ import { buildChatSceneInput, formatLocalNow, requestFormFill } from './chatscen
 const TEXTAREA_COMPONENTS = new Set(['textarea', 'richtext', 'editor', 'html', 'htmltext']);
 const SELECT_COMPONENTS = new Set(['select', 'selectmultiple', 'radiobox', 'checkbox', 'radio', 'multiselect']);
 const BROWSER_COMPONENTS = new Set([
-    'employee', 'department', 'subcompany', 'jobtitle', 'job', 'relatebrowser',
-    'browser', 'workflow', 'ebuilder', 'customer', 'project',
+    // 人员 / 组织类
+    'employee', 'department', 'subcompany', 'jobtitle', 'job',
+    'employeeorganization', 'employeeshare', 'employeeauthshare', 'odocreceivecomponent',
+    // 关联类型（设计器「表单组件 / 关联类型」面板）
+    'ebuilder', 'mainline', 'project', 'task', 'document', 'workflow', 'formcomponent',
+    'customer', 'customercomponent', 'cluecomponent', 'ordercomponent', 'contactcomponent',
+    'productioncomponent', 'contractcomponent', 'activitycomponent', 'competitorcomponent',
+    'kpiflowcomponent', 'workreportcomponent', 'attendcomponent', 'agendacomponent', 'chancecomponent',
+    'relatebrowser', 'relateodoc', 'relatetag', 'relateintegrate', 'modulecomponent', 'paas',
+    'quotecomponent', 'drivingrecord', 'browser',
 ]);
 const NON_INPUT_COMPONENTS = new Set([
     'paragraph', 'label', 'divider', 'option', 'detailtable', 'group', 'layout', 'internaltitle', 'multilingualtag',
@@ -43,6 +51,19 @@ const NON_INPUT_COMPONENTS = new Set([
 const READONLY_COMPONENTS = new Set([
     'dividingline', 'paragraph', 'slidercomponent', 'button', 'subtablecontrol', 'mobileinteraction',
 ]);
+/**
+ * 发票（`EinvoiceComponent`）/ 附件（`FileComponent`）字段也按浏览按钮口径对待。
+ *
+ * 这两个组件不在 `BROWSER_COMPONENTS` 里、也没有 `browserType`，所以 `extractFields`
+ * 算出的 `isBrowser` 是 false —— 但它们的值同样是**对象 id**（发票 id / 附件 fileid），
+ * 与浏览按钮的记录 id 同性质。凡按 `isBrowser` 分流的场合（出参 `isBrowser` 标记、
+ * 小e URL 参数的 `##` 前缀）都要用本判定把这两个组件补上。**只做对外口径补齐，
+ * 不改 `extractFields` 的 `isBrowser` 计算**——那会影响值解析/联动等内部分支，超出本判据的职责。
+ */
+function isBrowserLikeComponentKey(componentKey) {
+    const normalized = String(componentKey ?? '').toLowerCase();
+    return normalized === 'einvoicecomponent' || normalized === 'filecomponent';
+}
 /** 系统字段键：流程标题/紧急程度/密级；流程编号 REQUESTMARK 忽略不校验。 */
 const SYSTEM_FIELD_KEYS = {
     REQUEST_NAMEL: '流程标题',
@@ -593,14 +614,7 @@ function extractFields(layoutData, requiredMap, disableEditMap, displayMap) {
         // （Python 的 `bool({})` 为 False）——直接照抄 Python 的 `bool(browser_type)` 会让**每个字段**
         // 都被判成浏览按钮字段，文本/富文本字段随之走 name→ID 解析并报 BROWSER NOT_FOUND，
         // 内容永远写不进去（2026-09-16「内部留言」留言内容字段实证）。必须判"非空对象"。
-        // 组件名有两种写法：eBuilder 表单里常带 `Component` 后缀（`CustomerComponent` /
-        // `EmployeeComponent`），标准流程表单里是不带的（`customer` / `employee`）。
-        // ⛔ 只认前者会漏判：2026-10-31 会议申请流程的「参会客户」是 `CustomerComponent`，
-        // 被当成普通文本字段 ⇒ 提交 `[{id,name}]` 报「文本字段只接受字符串、数字或布尔值」。
-        const componentBase = normalized.replace(/component$/, '');
-        const isBrowser = Object.keys(browserType).length > 0
-            || BROWSER_COMPONENTS.has(normalized)
-            || BROWSER_COMPONENTS.has(componentBase);
+        const isBrowser = Object.keys(browserType).length > 0 || BROWSER_COMPONENTS.has(normalized);
         const isSelect = SELECT_COMPONENTS.has(normalized) || options.length > 0;
         result.push({
             id: fieldId,
@@ -2147,31 +2161,6 @@ async function buildCreateFormData(workflowId, env, options = {}) {
             continue;
         visibleFields.push(f);
     }
-    /**
-     * 明细表**整表被判不可见**时的显式告警（2026-10-31）。
-     *
-     * 场景：明细表被摆在了页面网格的**隐藏行 / 隐藏列**上（`pageLayouts[0].config.workbook.Sheet1.rows[n].visible=false`），
-     * 于是它的列字段全部被 `hiddenCellIds` 过滤掉。此前是**静默丢弃** —— 模型只看到"表单里没有这张明细表"，
-     * 分不清「表单确实没配」和「配了但摆在隐藏行上」，只能回一句"没有这张表"，用户无从下手。
-     * 这里按 subFormId 汇总，整表字段全灭的才告警（部分列隐藏属正常设计）。
-     */
-    const hiddenBySubform = new Map();
-    for (const f of fields) {
-        const fid = String(f.id ?? '');
-        const sid = String(f.subFormId ?? '').trim();
-        if (!sid || !hiddenCellIds.has(fid))
-            continue;
-        hiddenBySubform.set(sid, (hiddenBySubform.get(sid) || 0) + 1);
-    }
-    const survivingSubforms = new Set(visibleFields.map((f) => String(f.subFormId ?? '').trim()).filter(Boolean));
-    const invisibleSubformWarnings = [];
-    for (const [sid, count] of hiddenBySubform) {
-        if (survivingSubforms.has(sid))
-            continue;
-        invisibleSubformWarnings.push(`明细表 ${sid} 的 ${count} 个字段全部被判为「不可见」（该明细表所在的行/列在表单布局里是隐藏的），`
-            + '因此没有出现在字段清单里。要么在表单设计器里把明细表挪到可见行，要么取消隐藏它所在的行/列，然后重新载入表单。');
-    }
-    let layoutWarning = invisibleSubformWarnings.length ? invisibleSubformWarnings.join('；') : null;
     const defaults = normalizeDefaults(layoutData.defaultDetails);
     // 计算必填/可编辑/明细必填（按默认值 + onLoadForm 联动）
     const systemFieldValues = _normalizeSystemFieldValues(layoutData.businessOperatorObj);
@@ -2236,52 +2225,6 @@ async function buildCreateFormData(workflowId, env, options = {}) {
         }
     }
     const folderOptionValues = _mainValueMap(defaults);
-    /**
-     * 「条件显示」的明细表（2026-10-31，会议申请流程「参会客户明细」实证）
-     *
-     * 表单可以给明细表配**显示联动**：触发字段有值时 `show`、为空时 `hideLine`。
-     * 会议申请流程的「参会客户明细」（subFormId `1332370499762806784`）就是这样 ——
-     * 触发字段是「参会客户」(`crm_members`)，空着时整表隐藏。
-     *
-     * 旧行为把它与「明细表被摆在隐藏行」一视同仁 ⇒ 整表字段从 `fields` 里消失，
-     * 建会链路既解析不到明细表也写不进明细，模型只能回「表单里没有这张表」。
-     * 现在：布局上确实存在、且有成对 `show` 规则的表，按**条件可见**处理 ——
-     * 字段照常下发（标 `conditional: true`），并在 `layoutWarning` 里说明触发字段。
-     */
-    const conditionalHiddenSubforms = new Set();
-    const conditionalMainFields = new Set();
-    const conditionalHints = collectDetailShowLinkages(layoutData.viewLinkages, fields);
-    /**
-     * 主表字段同理：「参会客户」(`crm_members`) 自己也有成对的 `show` / `hideLine` 规则
-     * （空值时连自己都隐藏）。若不这样处理，建会链路的 `crm_members` 永远映射不到字段。
-     */
-    const fieldShowIds = collectFieldShowLinkageIds(layoutData.viewLinkages);
-    for (const fid of Array.from(mainHidden)) {
-        if (!fieldShowIds.has(fid))
-            continue;
-        if (hiddenCellIds.has(fid))
-            continue;
-        const target = visibleFields.find((f) => String(f.id ?? '') === fid);
-        if (!target)
-            continue;
-        conditionalMainFields.add(fid);
-        mainHidden.delete(fid);
-        invisibleSubformWarnings.push(`字段「${target.name}」(${fid}) 因显示联动隐藏（该字段本身是触发字段），已照常下发并标 conditional: true`);
-    }
-    for (const sid of Array.from(hiddenSubforms)) {
-        const hint = conditionalHints.get(sid);
-        if (!hint)
-            continue;
-        const usable = visibleFields.some((f) => String(f.subFormId ?? '') === sid && !hiddenCellIds.has(String(f.id ?? '')));
-        if (!usable)
-            continue;
-        conditionalHiddenSubforms.add(sid);
-        hiddenSubforms.delete(sid);
-        invisibleSubformWarnings.push(`明细表 ${sid}${hint.tableName ? `（${hint.tableName}）` : ''} 因显示联动隐藏，触发字段：`
-            + `${hint.triggerNames.join('、') || hint.triggerIds.join('、')}。`
-            + '该表字段已照常下发（标 conditional: true），把触发字段填上后表单里就会显示；不要回「表单里没有这张明细表」。');
-    }
-    layoutWarning = invisibleSubformWarnings.length ? invisibleSubformWarnings.join('；') : null;
     for (const field of visibleFields) {
         const fieldId = String(field.id ?? '');
         const subFormId = String(field.subFormId ?? '');
@@ -2381,11 +2324,6 @@ async function buildCreateFormData(workflowId, env, options = {}) {
         else if (slimSubFormId) {
             item.subFormId = slimSubFormId;
         }
-        // 条件可见的明细表（见 conditionalHiddenSubforms 注释）：字段可用，但当前触发字段没值时表单里不显示。
-        if (slimSubFormId && conditionalHiddenSubforms.has(slimSubFormId))
-            item.conditional = true;
-        if (!slimSubFormId && conditionalMainFields.has(String(field.id ?? '')))
-            item.conditional = true;
         item.componentKey = field.componentKey;
         // 表单初始化时就有的值（OA 预填 + onLoadForm 联动带出）——有才出现该键；**没有默认值的字段不带**。
         // CLI 拼 `data` 时会自动并入，模型**不必显式传**；用户本次明确改写了它才按用户说的覆盖（见
@@ -2404,6 +2342,9 @@ async function buildCreateFormData(workflowId, env, options = {}) {
             if (field[key])
                 item[key] = field[key];
         }
+        // 发票 / 附件字段的值也是对象 id，对外同样标 `isBrowser`（见 isBrowserLikeComponentKey 说明）
+        if (!item.isBrowser && isBrowserLikeComponentKey(field.componentKey))
+            item.isBrowser = true;
         if (String(field.componentKey ?? '').toLowerCase() === 'employeescope')
             item.isEmployeeScope = true;
         if (String(field.componentKey ?? '').toLowerCase() === 'einvoicecomponent')
@@ -2544,8 +2485,6 @@ async function buildCreateFormData(workflowId, env, options = {}) {
             },
             systemFieldWarning: minorWarning,
             requiredInfoWarning: requiredInfoWarningText(context),
-            // 明细表整表不可见时的告警（见 layoutWarning 注释）：有值时**不要**回"表单里没有这张明细表"。
-            layoutWarning,
             // 原 Python 把完整 context 落盘；此处通过 continuation 承载，返回结构保持文档契约。
             continuation: token,
         },
@@ -4047,74 +3986,6 @@ function mergeLinkageDetails(merged, linkageDetails) {
 function emptyLinkageVisibility() {
     return [new Set(), {}, {}, {}];
 }
-/**
- * 收集主表字段的 `show` 联动字段 id（`linkageObj=field` 且 `linkageProp=show`）。
- * 这类字段的隐藏是**条件性**的，按条件可见处理，见 `buildCreateFormData` 的 `conditionalMainFields`。
- */
-export function collectFieldShowLinkageIds(linkages) {
-    const out = new Set();
-    if (!Array.isArray(linkages))
-        return out;
-    for (const rule of linkages) {
-        const details = Array.isArray(rule?.linkageDetails) ? rule.linkageDetails : [];
-        for (const detail of details) {
-            if (!detail || typeof detail !== 'object')
-                continue;
-            if (String(detail.linkageObj ?? '') !== 'field')
-                continue;
-            if (String(detail.linkageProp ?? '') !== 'show')
-                continue;
-            const fid = String(detail.linkageValue ?? '').trim();
-            if (fid)
-                out.add(fid);
-        }
-    }
-    return out;
-}
-/**
- * 收集「明细表的显示联动」——`linkageObj=detail` 且 `linkageProp=show` 的规则。
- *
- * 用途见 `buildCreateFormData` 里 `conditionalHiddenSubforms` 的注释：配了 `show` 规则的明细表
- * 是**条件可见**（另有配套的 `hideLine` 规则），不能因为当期条件不成立就把整表字段丢掉。
- * 返回 `subFormId → { triggerIds, triggerNames, tableName }`，triggerNames 供告警文本直接引用。
- */
-export function collectDetailShowLinkages(linkages, fields) {
-    const out = new Map();
-    if (!Array.isArray(linkages))
-        return out;
-    const list = Array.isArray(fields) ? fields : [];
-    const nameOf = (id) => {
-        for (const f of list) {
-            if (String(f?.id ?? '') === id)
-                return String(f?.name ?? id);
-        }
-        return id;
-    };
-    for (const rule of linkages) {
-        const details = Array.isArray(rule?.linkageDetails) ? rule.linkageDetails : [];
-        for (const detail of details) {
-            if (!detail || typeof detail !== 'object')
-                continue;
-            if (String(detail.linkageObj ?? '') !== 'detail')
-                continue;
-            if (String(detail.linkageProp ?? '') !== 'show')
-                continue;
-            const sid = String(detail.linkageValue ?? '').trim();
-            if (!sid)
-                continue;
-            const conds = Array.isArray(rule?.condition?.conditionDetails) ? rule.condition.conditionDetails : [];
-            const triggerIds = conds
-                .map((c) => String(c?.targetId ?? '').trim())
-                .filter(Boolean);
-            out.set(sid, {
-                triggerIds,
-                triggerNames: triggerIds.map(nameOf),
-                tableName: nameOf(sid) === sid ? '' : nameOf(sid),
-            });
-        }
-    }
-    return out;
-}
 function computeLinkageVisibility(linkages, entries, defaults, linkageDetails, systemFieldValues, fields) {
     const hiddenSubforms = new Set();
     const rowHidden = {};
@@ -4879,8 +4750,19 @@ const XIAOE_FILL_FORM_SDK_OPTIONS = {
  */
 const XIAOE_INITIAL_VALUES_MULTI_SEPARATOR = ',';
 const XIAOE_INITIAL_VALUES_ROW_SEPARATOR = ';';
+/**
+ * 浏览按钮字段的值是**对象 id** 时加的前缀（2026-11-02 用户裁定）。
+ *
+ * 口径：`isBrowser === true` 的字段值来自 `[{id, name}]` 里的 `id`，落进 `customParams` / `src`
+ * 时写成 `##<id>`，让页面能区分「这是记录 id」与「这是用户手打的名称」；而**名称不拼前缀**
+ * （非浏览字段的值本来就是字符串，原样透传）。
+ *
+ * 多值逐个判定，所以 `##<id>,<名称>` 是合法形态（同一字段里既有解析出的 id、又有原样名称）。
+ * 明细多行同口径：`##<id>;<名称>`。
+ */
+const XIAOE_BROWSER_ID_PREFIX = '##';
 /** 单个标量 → URL 传参里的那一段文本。对象按「id 优先」取标识（附件取到的就是 fileid）。 */
-function xiaoEUrlParamScalar(value) {
+function xiaoEUrlParamScalar(value, prefixBrowserId = false) {
     if (value === null || value === undefined)
         return '';
     if (typeof value === 'object') {
@@ -4893,24 +4775,26 @@ function xiaoEUrlParamScalar(value) {
             if (picked === null || picked === undefined)
                 continue;
             const text = String(picked).trim();
-            if (text)
-                return text;
+            if (!text)
+                continue;
+            // 浏览按钮字段：这一段的来源是对象 id（不是用户给的名称），按 2026-11-02 口径加 `##`。
+            return prefixBrowserId ? `${XIAOE_BROWSER_ID_PREFIX}${text}` : text;
         }
         return '';
     }
     return String(value).trim();
 }
 /** 单个字段的值 → URL 传参里的那一段文本（数组按「同字段多值」用 `,` 连接）。 */
-function xiaoEUrlParamValue(value) {
+function xiaoEUrlParamValue(value, prefixBrowserId = false) {
     if (value === null || value === undefined)
         return '';
     if (Array.isArray(value)) {
         return value
-            .map((item) => xiaoEUrlParamScalar(item))
+            .map((item) => xiaoEUrlParamScalar(item, prefixBrowserId))
             .filter(Boolean)
             .join(XIAOE_INITIAL_VALUES_MULTI_SEPARATOR);
     }
-    return xiaoEUrlParamScalar(value);
+    return xiaoEUrlParamScalar(value, prefixBrowserId);
 }
 /**
  * `params.customParams` 里**字段值**那一份 = `{字段id: 值}`（用户裁定用**字段 id**，不用数据 key）；
@@ -4921,6 +4805,11 @@ function xiaoEUrlParamValue(value) {
  *
  * 明细字段（`preview` 里带 `dataIndex`）按**行号升序**取值、用 `;` 连接；主表字段就是它自己的值。
  * 值为空（没解析出内容）的字段整个省略，不生成空参数。
+ *
+ * **浏览按钮字段的值加 `##` 前缀**（2026-11-02 用户裁定，见 `XIAOE_BROWSER_ID_PREFIX`）：这类字段解析
+ * 出来的每一段都是对象 id，写成 `##<id>`；名称（非浏览字段的字符串）原样不加。多值/多行逐个判定，
+ * 因此 `##<id>,<名称>`、`##<id>;<名称>` 都是合法形态。`src` 末尾的字段参数与这里同源，一起带上。
+ * 发票 / 附件字段按 `isBrowserLikeComponentKey` 一并算浏览按钮口径（值同为对象 id，2026-11-03 用户裁定）。
  */
 /**
  * 小e 档交给浏览器页面的字段值：只留**可见且可编辑**的那些（2026-10-21 用户裁定）。
@@ -4963,15 +4852,25 @@ function editablePreviewForXiaoE(preview, fields, visibility) {
     }
     return kept;
 }
-function xiaoECustomParams(preview) {
+function xiaoECustomParams(preview, fields) {
     const ordered = [];
     const mainValues = new Map();
     const detailValues = new Map();
+    // 「这个字段是不是浏览按钮」决定要不要给对象 id 拼 `##`（2026-11-02 用户裁定）——
+    // 判据取 `extractFields` 算好的 `isBrowser`，与值解析走的是同一份结论，不在这里二次推断；
+    // 发票 / 附件字段不在 BROWSER_COMPONENTS（isBrowser 为 false），但其值同样是对象 id，
+    // 用 isBrowserLikeComponentKey 一并补上（2026-11-03 用户裁定）。
+    const browserFieldIds = new Set();
+    for (const field of toArray(fields)) {
+        const id = String(field?.id ?? '').trim();
+        if (id && (field?.isBrowser || isBrowserLikeComponentKey(field?.componentKey)))
+            browserFieldIds.add(id);
+    }
     for (const item of toArray(preview)) {
         const fieldId = String(item?.fieldId ?? '').trim();
         if (!fieldId)
             continue;
-        const text = xiaoEUrlParamValue(item?.value);
+        const text = xiaoEUrlParamValue(item?.value, browserFieldIds.has(fieldId));
         if (!text)
             continue;
         const isDetail = item?.dataIndex !== undefined && item?.dataIndex !== null;
@@ -5220,12 +5119,7 @@ async function runCreateRequest(args, env, options = {}) {
      * （`buildCreateFormData`，那边的联动结果要用来算字段的必填 / 可编辑清单）；这里两者都不跑 ——
      * 本档既不做必填判定、也不发写请求。非小e 环境行为不变。
      */
-    // ⛔ 2026-10-31 真机回归：调用方可以显式要求「小e 环境也走服务端提交」（meeting 建会直提用）。
-    // 起因：小e 的浏览器填单页只给**文本类**字段赋值，浏览按钮（参会人员 / 参会客户）传过去整段是空 ——
-    // 用户看到的就是"填了但表单里这两个字段没有值"。服务端提交这条路上这些字段走标准 JSON，
-    // 能完整落库，所以建会这类「字段必须完整」的场景应走直提，浏览器填单只留给需要人工核对/补填的场合。
-    const forceServerSubmit = args.forceServerSubmit === true;
-    const isXiaoE = forceServerSubmit ? false : hasXiaoEEnv(env.ctx.env, env.ctx.getGlobalOptions?.());
+    const isXiaoE = hasXiaoEEnv(env.ctx.env, env.ctx.getGlobalOptions?.());
     const linkageDetails = isXiaoE
         ? []
         : await runFieldLinkage(env, linkageContextFromPayload(context), entries, null, merged, false, context.defaults || []);
@@ -5392,7 +5286,7 @@ async function runCreateRequest(args, env, options = {}) {
                 baseUrl: xiaoEBaseUrl,
                 title: String(context.workflow?.name ?? ''),
                 workflowId: String(context.workflow?.id ?? context.runtime?.workflow_id ?? ''),
-                customParams: xiaoECustomParams(fillPreview),
+                customParams: xiaoECustomParams(fillPreview, fields),
             }),
         });
     }