weaver-e9-assistant-cli 1.1.4 → 1.1.11

package/dist/wfcreate.js

@@ -1,4 +1,5 @@
 import { createApiFromProfile } from './client.js';
+import { getCachedWorkflowList, cacheWorkflowList, findWorkflowByNameInCache } from './memory.js';
 const MENU_IDS = '1,12';
 /**
  * 取"新建流程"列表。GET createreq/wfinfo，解析 datas[].wfbeans[]。
@@ -91,12 +92,39 @@ export function buildRequestFormUrl(baseUrl, requestId, workflowId, now = Date.n
 /**
  * 按流程名在"新建流程"列表里查找 id（模糊匹配，返回全部命中项）。
  * 用于"发起 XX 流程"时把名字解析成 workflowid。
+ *
+ * ★ selfId 提供时优先读缓存（1天TTL），省掉 getCreateWfList HTTP 调用。
  */
-export async function findCreateWfByName(cfg, name) {
+export async function findCreateWfByName(cfg, name, selfId) {
+    // 缓存优先
+    if (selfId) {
+        const cached = getCachedWorkflowList(cfg, selfId, '1');
+        if (cached) {
+            const hits = findWorkflowByNameInCache(cached, name);
+            if (hits) return hits;
+            // 缓存命中但没匹配到——可能是新流程，强制刷新
+        }
+    }
+
     const r = await getCreateWfList(cfg, { keyword: name });
     const hits = [];
     for (const c of r.categories)
         for (const w of c.workflows)
             hits.push(w);
+
+    // 写入缓存（全量 categories，后续不同关键词也可复用）
+    if (selfId && r.categories.length > 0) {
+        try {
+            cacheWorkflowList(cfg, selfId, '1', r.categories.map(c => ({
+                id: c.id,
+                name: c.name,
+                workflows: c.workflows.map(w => ({
+                    id: w.id, name: w.name, typeId: w.typeId,
+                    letter: w.letter, spell: w.spell,
+                })),
+            })));
+        } catch { /* 缓存写失败不阻断 */ }
+    }
+
     return hits;
 }

package/dist/wfform.js

@@ -1,9 +1,72 @@
 import { createApiFromProfile } from './client.js';
-import { AuthTokenSession } from './auth-token.js';
 import { fetchCubeTreeBrowserOptions } from './cube.js';
-export const VIEWATTR_LABEL = { 1: '可编辑', 2: '只读', 3: '隐藏' };
+import { getCachedBrowseOptions, cacheBrowseOptions } from './memory.js';
+/**
+ * `viewattr`（loadForm fieldinfomap）取值——**以 E9 前端 bundle `getFieldCurViewAttr` 为准**
+ * （2026-10-21 从 `/spa/workflow/static4form/index.js` 逆向确认）：
+ *   **0=隐藏 / 1=只读 / 2=可编辑 / 3=必填（可编辑）**
+ * 依据：
+ *   - `viewattr>0` 才在模板里（0 = 隐藏/不在模板）；
+ *   - 前端 `fieldViewOnly = (viewattr===1)`；只读场景（isonlyshow=1 / 只读模式 / 明细已存在行）一律强制成 1；
+ *   - 必填校验用 `getFieldCurViewAttr(...) > 1`（即 2/3 才可填），必填范围按 `viewattr===3` 收集。
+ * 历史错误：先记成「1可编辑/2只读/3隐藏」，又改成「1编辑/2必填/3只读」——都把 1/3 弄反了，
+ * 导致可编辑的必填字段（va=3）被误判只读、只读字段（va=1）被放行。
+ */
+export const VIEWATTR_LABEL = { 0: '隐藏', 1: '只读', 2: '可编辑', 3: '必填' };
+
+/**
+ * 纯函数：字段是否禁止填写。返回原因字符串（null=可填）。
+ *
+ * 判据（按优先级）：
+ *   1. 权威权限位（workflow_nodeform 表结构）：
+ *      - `isonlyshow === 1` → 禁止手工编辑（`-1`/`0`/缺失均视为未限制）
+ *      - `isedit === 0`     → 当前节点不可编辑（接口未返回则不拦）
+ *      - `isview === 0`     → 当前节点不可见（接口未返回则不拦）
+ *   2. `viewattr` 的真实映射（以 E9 前端 `getFieldCurViewAttr` 为准）：
+ *      - **0 = 隐藏**（不在模板/发起不展示，如 532 开票公司/税号/实际报销金额）
+ *      - **1 = 只读**（展示但不允许填，如申请人/申请部门等自动带出项）
+ *      - **2 = 可编辑**（允许填，非必填）
+ *      - **3 = 必填（可编辑）**（允许填；前端必填校验按 viewattr===3 收集）
+ *      故 0/1 禁止填写；2/3 放行。
+ * 历史错误：旧实现把 1/3 的含义弄反（曾把 3 当只读），导致 va=3 的可编辑必填字段被误判只读。
+ */
+export function fieldNonEditableReason(fld) {
+    const n = (v) => (v === undefined || v === null || v === '' ? undefined : Number(v));
+    if (n(fld?.isonlyshow) === 1)
+        return '禁止手工编辑';
+    if (n(fld?.isedit) === 0)
+        return '当前节点不可编辑';
+    if (n(fld?.isview) === 0)
+        return '当前节点不可见';
+    const va = n(fld?.viewattr);
+    if (va === 0)
+        return '隐藏';
+    if (va === 1)
+        return '只读';
+    return null; // 2=可编辑、3=必填（可编辑）、缺失=不拦
+}
+/**
+ * 展示用状态文案：区分「可编辑」「默认值自动带出」「禁止填写」。
+ * ⚠️ 带默认值的只读/隐藏字段（服务端 maindata 已有值）应显示「默认=xxx（自动带出，无需填写）」，
+ * 而不是裸「只读」——否则 agent 会把"系统已带出"误报成"用户不能填"（2026-10-21 用户反馈）。
+ * ⚠️ 可编辑字段带默认值时显示「可编辑 · 默认=xxx（可修改）」——默认值只是预填，**仍允许用户覆盖**。
+ */
+export function fieldStatusLabel(fld) {
+    const reason = fieldNonEditableReason(fld);
+    const hasVal = fld?.currentValue !== undefined && fld?.currentValue !== null && String(fld.currentValue) !== '';
+    if (!reason) {
+        // 2=可编辑；3=必填（可编辑）。有默认值时仍允许用户修改。
+        const base = Number(fld?.viewattr) === 3 ? '可编辑（必填）' : '可编辑';
+        return hasVal ? `${base} · 默认=${fld.currentValue}（可修改）` : base;
+    }
+    if (hasVal)
+        return `默认=${fld.currentValue}（自动带出，无需填写）`;
+    return `🚫${reason}`;
+}
+
 export const HTMLTYPE_LABEL = {
-    1: '单行文本', 2: '多行文本', 3: '浏览选择', 4: '附件', 5: '选择框', 6: '复选框', 7: '特殊',
+    // E9 fieldhtmltype：4=复选框（check框），6=附件上传（fileattr）。旧映射把 4/6 写反了。
+    1: '单行文本', 2: '多行文本', 3: '浏览选择', 4: '复选框', 5: '选择框', 6: '附件', 7: '特殊',
 };
 /**
  * 取流程发起表单的字段定义。POST loadForm（aiAgentToken 鉴权）→ 解析 tableInfo。
@@ -23,19 +86,35 @@ export async function describeFormFields(cfg, workflowId) {
         const fmap = ti[key]?.fieldinfomap;
         if (!fmap || typeof fmap !== 'object')
             continue;
+        const maindata = j.maindata ?? {};
         const fields = Object.values(fmap).map((f) => {
             const va = num(f?.viewattr);
             const ht = num(f?.htmltype);
+            const reason = fieldNonEditableReason(f);
+            const id = str(f?.fieldid) ?? key;
+            // 服务端已带出的默认值/当前值（maindata）。只读但有默认值 ≠ "用户不能填"，
+            // 而是"系统自动带出、无需填写"——展示层要区分，避免 agent 误报成只读不可填。
+            const cell = maindata[`field${id}`];
+            const rawVal = cell?.value;
+            const currentValue = (rawVal === undefined || rawVal === null || rawVal === '') ? undefined : String(rawVal);
             return {
-                id: str(f?.fieldid) ?? key,
+                id,
                 label: str(f?.fieldlabel),
                 name: str(f?.fieldname),
+                currentValue,
+                // viewattr：0隐藏 / 1只读 / 2可编辑 / 3必填（参与可编辑性判断，见 fieldNonEditableReason）
                 viewattr: va,
                 viewattrLabel: va != null ? VIEWATTR_LABEL[va] ?? `va=${va}` : undefined,
+                // 字段权限（权威）：isonlyshow=1 禁止手工编辑 / isedit=0 不可编辑 / isview=0 不可见
+                isonlyshow: num(f?.isonlyshow),
+                isedit: num(f?.isedit),
+                isview: num(f?.isview),
+                ismandatory: num(f?.ismandatory),
+                editable: reason == null,
+                nonEditableReason: reason,
                 htmltype: ht,
                 htmltypeLabel: ht != null ? HTMLTYPE_LABEL[ht] ?? `ht=${ht}` : undefined,
                 isdetail: f?.isdetail,
-                isonlyshow: f?.isonlyshow,
                 table: key,
                 raw: f,
             };
@@ -66,6 +145,44 @@ function num(v) {
     const n = Number(v);
     return Number.isFinite(n) ? n : undefined;
 }
+/**
+ * 自定义浏览框 detailtype：161=单选 / 162=多选。
+ * E9 前端 generateFormData 实证：仅这两类会写 field<id>name，
+ * 且多选名称分隔符是 `##~~@@~~##`（与普通浏览框的 `##~~@@##` 不同）。
+ */
+export const CUSTOM_BROWSER_DETAILTYPES = new Set(['161', '162']);
+export function isCustomBrowserField(field) {
+    return Number(field?.htmltype) === 3 && CUSTOM_BROWSER_DETAILTYPES.has(String(field?.detailtype ?? ''));
+}
+/** 自定义浏览框(161/162)用 `##~~@@~~##`，其余沿用 `##~~@@##`。 */
+export function browserNameSeparator(field) {
+    return isCustomBrowserField(field) ? '##~~@@~~##' : '##~~@@##';
+}
+
+/**
+ * 选择框(htmltype=5)：把显示名/值统一规范化为 selectvalue（逗号分隔多选）。
+ * 传显示名但不转值时，服务端回显匹配不到选项 → 下拉框显示为空。
+ * 任一值无法唯一匹配则返回 undefined（调用方保留原值，不猜）。
+ */
+export function normalizeSelectValue(field, value) {
+    const items = field?.raw?.selectattr?.selectitemlist ?? field?.selectattr?.selectitemlist;
+    if (!Array.isArray(items) || items.length === 0)
+        return undefined;
+    const rawValues = String(value ?? '').split(',').map((x) => x.trim()).filter(Boolean);
+    if (rawValues.length === 0)
+        return undefined;
+    const out = [];
+    for (const v of rawValues) {
+        const byValue = items.find((it) => String(it.selectvalue) === v);
+        const sameName = items.filter((it) => String(it.selectname) === v);
+        const hit = byValue ?? (sameName.length === 1 ? sameName[0] : null);
+        if (!hit)
+            return undefined;
+        out.push(String(hit.selectvalue));
+    }
+    return out.join(',');
+}
+
 /**
  * 取自定义浏览框(browser.xxx)的选项（前 N 条）。通用接口（用户抓包确认）：
  *   GET /api/public/browser/data/<detailtype>?pageSize=<N>&current=1&min=1&max=<N>&type=<fielddbtype>&
@@ -73,26 +190,101 @@ function num(v) {
  *   aiAgentToken 鉴权。返回 {total, columns, datas}：每行 id=选项值，显示名=columns 里 showType:1 的列值。
  *
  * detailtype/fielddbtype/formid 等从 loadForm fieldinfomap + params 取。pageSize 默认 10（前 10）。
+ *
+ * ★ 浏览框选项缓存：selfId 提供时优先读缓存（24小时 TTL，比表单结构短——选项变动更频繁），缓存命中省一次 HTTP API。
  */
-export async function getBrowserOptions(cfg, workflowId, fieldId, pageSize = 10) {
-    const f = await describeFormFields(cfg, workflowId);
-    // 字段可能在主表(main)或明细表(detail_<n>)的 fieldinfomap，遍历所有表查找
-    let fm;
-    const ti = f.raw?.tableInfo ?? {};
-    for (const key of Object.keys(ti)) {
-        const m = ti[key]?.fieldinfomap;
-        if (m && m[fieldId]) {
-            fm = m[fieldId];
-            break;
+export async function getBrowserOptions(cfg, workflowId, fieldId, pageSize = 10, selfId, relateValues = {}, formData, metaOverride = null) {
+    // ★ 联动浏览框（browserattr.relateFieldid）：父字段值未填时选项为空，必须等值就绪再取
+    // 例：请假类型(8874) relateFieldid=["8872_0"] → 需带 field8872=<当前用户id> 才有选项
+    // relateValues：调用方已填的字段值映射（fieldId→value），优先；其次看 maindata 服务端带出值。
+    const _relateParentParams = (fm, f) => {
+        const rel = fm?.browserattr?.relateFieldid;
+        const out = {};
+        if (Array.isArray(rel)) {
+            for (const item of rel) {
+                const m = /^(\d+)_(\d+)$/.exec(String(item ?? ''));
+                if (!m)
+                    continue;
+                const parentId = m[1];
+                const rowIdx = Number(m[2]);
+                let val = relateValues[parentId];
+                if ((val === undefined || val === null || val === '') && f.maindata?.[`field${parentId}`]?.value != null)
+                    val = f.maindata[`field${parentId}`].value;
+                if (val === undefined || val === null || String(val) === '')
+                    continue;
+                // 主表行(rowIdx=0)用 field<id>；明细行用 field<id>_<rownum>（与提交体一致）
+                out[rowIdx === 0 ? `field${parentId}` : `field${parentId}_${rowIdx}`] = String(val);
+            }
         }
+        return out;
+    };
+    // ★ 缓存命中：省掉 describeFormFields + API 两次 HTTP（~2.3s + ~1.2s）
+    // ⚠️ 联动浏览框的选项依赖父字段值，不能用普通缓存（父值一变选项就变）——
+    //    凡是调用方传了 relateValues（可能联动），一律跳过缓存读，走全量新取。
+    if (selfId && Object.keys(relateValues).length === 0) {
+        try {
+            const cached = getCachedBrowseOptions(cfg, selfId, workflowId, fieldId);
+            if (cached && cached.length >= pageSize) {
+                return cached.slice(0, pageSize);
+            }
+            if (cached && cached.length > 0) {
+                // 缓存的条数不够（如上次只查了10条，这次要50），走完整流程取更多
+            }
+        } catch { /* 缓存读失败走正常流程 */ }
+    }
+
+    let detailtype;
+    let fielddbtype;
+    let p;
+    let relateParams = {};
+    if (metaOverride) {
+        // 调用方已从 loadForm(iscreate=0) 拿到字段元数据/流程参数：
+        // 跳过 describeFormFields（省一次 HTTP，且处理任务的人未必有“发起”权限）
+        // metaOverride 路径无 fieldinfomap → 无联动父值可注入
+        detailtype = String(metaOverride.detailtype ?? '');
+        fielddbtype = String(metaOverride.fielddbtype ?? '');
+        p = metaOverride.params ?? {};
+    }
+    else {
+        // ★ formData 传入时复用（避免重复 describeFormFields ~2.3s）——调用方 prepareCreateSubmission 已取过。
+        //   缓存来源的 formData 也已由 getStartableFields 重建 raw.tableInfo（rebuildTableInfo），可复用。
+        let f = (formData && formData.raw?.tableInfo) ? formData : await describeFormFields(cfg, workflowId);
+        // 字段可能在主表(main)或明细表(detail_<n>)的 fieldinfomap，遍历所有表查找
+        let fm;
+        const ti = f.raw?.tableInfo ?? {};
+        for (const key of Object.keys(ti)) {
+            const m = ti[key]?.fieldinfomap;
+            if (m && m[fieldId]) {
+                fm = m[fieldId];
+                break;
+            }
+        }
+        if (!fm)
+            throw new Error(`字段 ${fieldId} 不在 fieldinfomap（可能不是浏览框）`);
+        // ⚠️ 联动浏览框：父字段值可能来自服务端 maindata（如"请假类型"联动当前用户）。
+        //   缓存 formData 重建自 tables，maindata 缺失——父值打不进请求 → 联动选项为空。
+        //   此时重新拉一次 loadForm（正确性优先于省这一次 HTTP），仅限联动浏览框 + 选项未命中缓存时。
+        if (f.maindata === undefined && Array.isArray(fm?.browserattr?.relateFieldid)) {
+            const fresh = await describeFormFields(cfg, workflowId);
+            const ti2 = fresh.raw?.tableInfo ?? {};
+            let fm2 = null;
+            for (const key of Object.keys(ti2)) {
+                const m = ti2[key]?.fieldinfomap;
+                if (m && m[fieldId]) { fm2 = m[fieldId]; break; }
+            }
+            if (fm2) {
+                fm = fm2;
+                f = fresh;
+            }
+        }
+        detailtype = String(fm.detailtype ?? '');
+        fielddbtype = String(fm.fielddbtype ?? '');
+        p = f.params ?? {};
+        // ★ 联动浏览框：父字段值（relateValues 或 maindata 服务端带出值）打进请求
+        relateParams = _relateParentParams(fm, f);
     }
-    if (!fm)
-        throw new Error(`字段 ${fieldId} 不在 fieldinfomap（可能不是浏览框）`);
-    const detailtype = String(fm.detailtype ?? '');
-    const fielddbtype = String(fm.fielddbtype ?? '');
     if (!detailtype || !fielddbtype)
         throw new Error(`字段 ${fieldId} 无 detailtype/fielddbtype，非浏览框`);
-    const p = f.params ?? {};
     // ★ cube 树浏览框（detailtype=256）：走递归取树，treeid = fielddbtype
     if (detailtype === '256') {
         const apiW = await createApiFromProfile(cfg);
@@ -105,14 +297,21 @@ export async function getBrowserOptions(cfg, workflowId, fieldId, pageSize = 10)
             wf_isagent: '0', wf_beagenter: '0', wfTestStr: '', wfCreater: String(p.wfCreater ?? '1'),
             disabledConditionCache: 'true', secretLevel: '4', companyId: '1', checkStrictly: 'false',
             treeid: fielddbtype, cube_treeid: fielddbtype, treetype: '256',
+            ...relateParams,
         };
         const items = await fetchCubeTreeBrowserOptions(apiW, base, { pageSize, maxNodes: 300 });
-        return items.map((o) => ({ id: o.id, name: o.name, path: o.path }));
+        const result = items.map((o) => ({ id: o.id, name: o.name, path: o.path }));
+        // ⚠️ 联动字段不写缓存（选项依赖父值，换了父值选项就不同）
+        if (selfId && result.length > 0 && Object.keys(relateParams).length === 0) {
+            try { cacheBrowseOptions(cfg, selfId, workflowId, fieldId, result); } catch { /* 缓存写失败不阻断 */ }
+        }
+        return result;
     }
-    const sess = AuthTokenSession.fromProfile(cfg);
-    const base = cfg.baseUrl.replace(/\/+$/, '');
-    const q = new URLSearchParams({
+    const api = await createApiFromProfile(cfg);
+    const q = {
         pageSize: String(pageSize), current: '1', min: '1', max: String(pageSize),
+        // 文档实证参数：type=fielddbtype（自定义浏览框 161/162 依赖它定位数据源）
+        type: fielddbtype,
         alllevel: '1', virtualtype: '1', status: '8',
         wfid: String(workflowId),
         billid: String(p.billid || p.formid || ''), isbill: String(p.isbill ?? '1'),
@@ -125,51 +324,71 @@ export async function getBrowserOptions(cfg, workflowId, fieldId, pageSize = 10)
         defaultSearch: 'false', secretLevel: '4',
         cmd: 'newly',
         __random__: String(Date.now()),
-    });
-    const r = await fetch(`${base}/api/public/browser/data/${detailtype}?${q.toString()}`, {
-        headers: { aiAgentToken: sess.token, 'X-Requested-With': 'XMLHttpRequest' },
-        signal: AbortSignal.timeout(15000),
-    });
-    const t = await r.text();
-    let j = null;
-    try {
-        j = JSON.parse(t);
-    }
-    catch { /* non-json */ }
-    // 响应可能是数组（HR 等）或树形对象（部门等），统一展平
-    let flatDatas = [];
-    if (Array.isArray(j?.datas)) {
-        flatDatas = j.datas;
-    }
-    else if (j?.datas && typeof j.datas === 'object') {
-        // 树形结构：递归展平 subs，只取可点击的叶子节点（canClick=true 或 type=2）
-        flatDatas = flattenTree(j.datas);
-    }
-    const cols = Array.isArray(j?.columns) ? j.columns : [];
-    // 有 columns 时按旧逻辑解析；无 columns 时（如 HR/部门浏览框）按 name/lastname 解析
-    let nameKey, pkKey;
-    if (cols.length > 0) {
-        const showCol = cols.find((c) => String(c.showType) === '1')
-            ?? cols.find((c) => c.isInputCol === 'true' || c.isInputCol === true)
-            ?? cols.find((c) => /名称|名字|name/i.test(String(c.title ?? '')))
-            ?? cols.find((c) => c.display === 'true' && c.hide !== 'true');
-        nameKey = showCol?.dataIndex ?? 'mc';
-        const pkCol = cols.find((c) => c.isPrimarykey === 'true' || c.isPrimarykey === true);
-        pkKey = pkCol?.dataIndex;
+        ...relateParams,
+    };
+    // ★ 走 E9Api（token 优先、cookie 回退）：裸 fetch 只带 aiAgentToken，
+    //   cookie-only 环境会拿到空数据（e9pc/10.x 手工导入 cookie 的场景）。
+    const path = `/api/public/browser/data/${detailtype}`;
+    const parseBrowserData = (j) => {
+        // 响应可能是数组（HR 等）或树形对象（部门等），统一展平
+        let flatDatas = [];
+        if (Array.isArray(j?.datas)) {
+            flatDatas = j.datas;
+        }
+        else if (j?.datas && typeof j.datas === 'object') {
+            // 树形结构：递归展平 subs，只取可点击的叶子节点（canClick=true 或 type=2）
+            flatDatas = flattenTree(j.datas);
+        }
+        const cols = Array.isArray(j?.columns) ? j.columns : [];
+        // 有 columns 时按旧逻辑解析；无 columns 时（如 HR/部门浏览框）按 name/lastname 解析
+        let nameKey, pkKey;
+        if (cols.length > 0) {
+            const showCol = cols.find((c) => String(c.showType) === '1')
+                ?? cols.find((c) => c.isInputCol === 'true' || c.isInputCol === true)
+                ?? cols.find((c) => /名称|名字|name/i.test(String(c.title ?? '')))
+                ?? cols.find((c) => c.display === 'true' && c.hide !== 'true');
+            nameKey = showCol?.dataIndex ?? 'mc';
+            const pkCol = cols.find((c) => c.isPrimarykey === 'true' || c.isPrimarykey === true);
+            pkKey = pkCol?.dataIndex;
+        }
+        else {
+            // 无 columns：优先 lastname，回退 name；部分浏览框返回 key+showname（如假期类型）
+            const first = flatDatas.length > 0 ? flatDatas[0] : null;
+            if (first && first.key != null && first.showname != null) {
+                pkKey = 'key';
+                nameKey = 'showname';
+            }
+            else {
+                pkKey = null;
+                nameKey = first?.lastname != null ? 'lastname' : 'name';
+            }
+        }
+        return flatDatas
+            // 自定义浏览框(161/162)的主键列是 ids（不是 id）；无 columns 的接口才用 d.id/d.key
+            .filter((d) => d && (d.id != null || d.key != null || (pkKey && d[pkKey] != null)))
+            .map((d) => {
+            const rawPk = pkKey && d[pkKey] != null && String(d[pkKey]) !== '' ? d[pkKey] : (d.id ?? d.key);
+            const pk = String(rawPk);
+            const name = stripHtml(String(d[nameKey] ?? d.mc ?? d.name ?? d.showname ?? rawPk));
+            return { id: pk, name: name || pk };
+        })
+            .filter((o) => o.id);
+    };
+    let result = parseBrowserData((await api.get(path, q))?.json ?? null);
+    // 兼容 token 通道 200 空包（no-op）：cookie 可用时强制 cookie 再取一次
+    if (result.length === 0 && cfg.cookie) {
+        try {
+            result = parseBrowserData((await api.get(path, q, { forceCookie: true }))?.json ?? null);
+        }
+        catch { /* cookie 兜底失败：保持空结果，不阻断 */ }
     }
-    else {
-        // 无 columns：优先 lastname，回退 name
-        nameKey = flatDatas.length > 0 && flatDatas[0].lastname != null ? 'lastname' : 'name';
-        pkKey = null;
+
+    // ★ 缓存浏览框选项：下次同字段查询省掉一次 HTTP（⚠️ 联动字段不写，父值一变选项就变）
+    if (selfId && result.length > 0 && Object.keys(relateParams).length === 0) {
+        try { cacheBrowseOptions(cfg, selfId, workflowId, fieldId, result); } catch { /* 缓存写失败不阻断 */ }
     }
-    return flatDatas
-        .filter((d) => d && d.id != null)
-        .map((d) => {
-        const pk = pkKey && d[pkKey] != null && String(d[pkKey]) !== '' ? String(d[pkKey]) : String(d.id);
-        const name = stripHtml(String(d[nameKey] ?? d.mc ?? d.name ?? d.id));
-        return { id: pk, name: name || String(d.id) };
-    })
-        .filter((o) => o.id);
+
+    return result;
 }
 /** 递归展平树形浏览数据（部门组织架构等），只取可点击节点 */
 function flattenTree(node) {