weaver-e9-assistant-cli 1.1.4 → 1.1.11

package/dist/wfcodeblock.js

@@ -0,0 +1,761 @@
+/**
+ * 流程表单代码块获取与本地执行模块。
+ *
+ * 背景：E9 代码块是浏览器端 JavaScript（WfForm API），CLI 直调 requestOperation API
+ * 会跳过代码块逻辑，导致 changeFieldValue 补值、registerCheckEvent 校验等丢失。
+ * 本模块在 Node.js 沙箱中模拟 WfForm 环境，执行代码块并收集字段变更。
+ *
+ * 使用：
+ *   import { executeFormCodeBlocks } from './wfcodeblock.js';
+ *   const { mutations, blocked } = await executeFormCodeBlocks(cfg, wfId, values, formData);
+ *   Object.assign(values, mutations.values); // 合并代码块补值
+ */
+
+import { createApiFromProfile } from './client.js';
+import { getCachedFieldMap } from './memory.js';
+import vm from 'node:vm';
+
+// ── WfForm 常量（与 E9 浏览器端一致）────────────────────────────────────
+
+const OPER_SAVE = '1';
+const OPER_SUBMIT = '2';
+const OPER_SUBMITCONFIRM = '3';
+const OPER_REJECT = '4';
+const OPER_REMARK = '5';
+const OPER_INTERVENE = '6';
+const OPER_FORWARD = '7';
+const OPER_TAKEBACK = '8';
+const OPER_DELETE = '9';
+const OPER_ADDROW = '10';
+const OPER_DELROW = '11';
+
+const ACTION_ADDROW = '10';
+const ACTION_DELROW = '11';
+
+// ── 字段标记解析 ──────────────────────────────────────────────────────
+
+/**
+ * 解析 fieldMark（"field123" / "field123_2" / "field110"）。
+ * 返回 { fieldId, rowIndex, fullKey }。
+ *   fullKey — 有明细行号时 = "fieldId_rowIndex"，否则 = fieldId。
+ *   用于 mutations.values / getFieldValue 等场景区分主表和明细行。
+ */
+function parseFieldMark(fieldMark) {
+    if (!fieldMark) return { fieldId: '', rowIndex: -1, fullKey: '' };
+    const raw = String(fieldMark).replace(/^field/i, '');
+    const idx = raw.indexOf('_');
+    if (idx >= 0) {
+        const fieldId = raw.slice(0, idx);
+        const rowIndex = Number(raw.slice(idx + 1)) || 0;
+        return { fieldId, rowIndex, fullKey: `${fieldId}_${rowIndex}` };
+    }
+    return { fieldId: raw, rowIndex: -1, fullKey: raw };
+}
+
+// ── 字段信息映射 ──────────────────────────────────────────────────────
+
+/**
+ * 从 formData（describeFormFields 返回值）构建字段信息映射。
+ * 返回 { byName: Map<"fieldname" → fieldId>, byId: Map<"fieldId" → fieldInfo> }
+ */
+export function buildFieldInfoMap(formData) {
+    const byName = new Map();
+    const byId = new Map();
+    if (!formData?.tables) return { byName, byId };
+
+    for (const table of formData.tables) {
+        for (const fld of table.fields ?? []) {
+            const id = String(fld.id);
+            const name = fld.name ?? fld.label ?? '';
+            if (!id) continue;
+            byId.set(id, {
+                id,
+                name: fld.name,
+                label: fld.label,
+                htmltype: fld.htmltype,
+                viewattr: fld.viewattr,
+                table: table.key,
+            });
+            // 字段名映射：fieldname（数据库名）优先，label 兜底
+            if (name) byName.set(String(name).toLowerCase(), id);
+            if (fld.label && fld.label !== name) {
+                // label 做兜底映射（同名的以后面为准）
+                if (!byName.has(String(fld.label).toLowerCase())) {
+                    byName.set(String(fld.label).toLowerCase(), id);
+                }
+            }
+        }
+    }
+    return { byName, byId };
+}
+
+/** 从 formData 提取 nodeId。 */
+export function extractNodeId(formData) {
+    const sp = formData?.submitParams ?? {};
+    const p = formData?.params ?? {};
+    return String(sp.nodeid ?? p.nodeid ?? '');
+}
+
+// ── WfForm 模拟层 ──────────────────────────────────────────────────────
+
+/**
+ * 构建 WfForm 模拟对象，拦截所有 API 调用并记录变更。
+ *
+ * @param {object} opts
+ * @param {object} opts.values - 当前字段值 { fieldId: value }
+ * @param {Map} opts.fieldById - fieldId → fieldInfo 映射
+ * @param {Map} opts.fieldByName - fieldName → fieldId 映射
+ * @param {Function} [opts.resolveLinkageFn] - 联动解析函数，签名为 (fieldId, value) → { fieldId: {value, specialobj} }
+ */
+export function buildWfFormMock(opts = {}) {
+    const values = { ...opts.values ?? {} };
+    const fieldById = opts.fieldById ?? new Map();
+    const fieldByName = opts.fieldByName ?? new Map();
+    const resolveLinkageFn = opts.resolveLinkageFn ?? (async () => ({}));
+    const userId = opts.userId ?? '';
+
+    // 收集的变更
+    const mutations = {
+        values: {},   // 主表 { fieldId: { value, specialobj } }
+        attrs: {},    // { fieldId: viewAttr }
+        details: [],  // 明细操作：[{op:'add'|'set'|'del', table, rowIndex, ...}]
+    };
+
+    // 注册的事件处理器
+    const checkEvents = {};    // { '<type>': [callback] }
+    const changeEvents = [];   // [{ fieldMarks: Set, handler: fn }]
+
+    // 是否阻断提交
+    let submitBlocked = false;
+
+    // ── 明细行状态（支持 addDetailRow / delDetailRow / getDetailAllRowIndexStr）──
+    const detailState = new Map(); // table -> { rows: Map<rowIndex, object>, nextIndex }
+    function getDetailState(table) {
+        const key = table || 'detail_1';
+        if (!detailState.has(key))
+            detailState.set(key, { rows: new Map(), nextIndex: 0 });
+        return detailState.get(key);
+    }
+    // 用调用方已填的明细行初始化（details[].index：detail_1→0）
+    for (const d of opts.details ?? []) {
+        const table = `detail_${Number(d.index) + 1}`;
+        const st = getDetailState(table);
+        (d.rows ?? []).forEach((row, i) => {
+            st.rows.set(i, { ...row });
+            if (i + 1 > st.nextIndex)
+                st.nextIndex = i + 1;
+        });
+    }
+
+    // ── WfForm 方法实现 ──
+
+    const wfForm = {
+        // 常量
+        OPER_SAVE, OPER_SUBMIT, OPER_SUBMITCONFIRM, OPER_REJECT, OPER_REMARK,
+        OPER_INTERVENE, OPER_FORWARD, OPER_TAKEBACK, OPER_DELETE,
+        OPER_ADDROW, OPER_DELROW,
+        ACTION_ADDROW, ACTION_DELROW,
+
+        // 3.3 修改单个字段值（不支持附件类型）
+        changeFieldValue(fieldMark, valueInfo) {
+            const { fieldId, rowIndex, fullKey } = parseFieldMark(fieldMark);
+            if (!fieldId || !valueInfo) return;
+            // 明细行字段用 fullKey（主表和明细行各自独立），主表字段用 fieldId。
+            // ⚠️ 不再因“已有值”跳过记录：用户手填值是否被覆盖，由调用方 prepareCreateSubmission
+            //    按“用户意图优先”判断并报告冲突；这里只忠实记录代码块的建议值（与浏览器行为一致）。
+            const guardKey = rowIndex >= 0 ? fullKey : fieldId;
+
+            const cv = { value: String(valueInfo.value ?? '') };
+            if (Array.isArray(valueInfo.specialobj) && valueInfo.specialobj.length > 0) {
+                cv.specialobj = valueInfo.specialobj;
+            }
+            if (rowIndex >= 0) {
+                // 明细行：记录 set 操作（由调用方合并进 details；用户已填值优先）
+                const table = fieldById.get(String(fieldId))?.table || 'detail_1';
+                mutations.details.push({ op: 'set', table, rowIndex, fieldId, value: cv.value, specialobj: cv.specialobj });
+                values[fullKey] = cv.value;
+                return;
+            }
+            mutations.values[fullKey] = cv;
+            values[guardKey] = cv.value;
+        },
+
+        // 3.4 改变单个字段显示属性
+        changeFieldAttr(fieldMark, viewAttr) {
+            const { fieldId, fullKey } = parseFieldMark(fieldMark);
+            if (!fieldId) return;
+            mutations.attrs[fullKey] = Number(viewAttr);
+        },
+
+        // 3.2 获取单个字段值
+        getFieldValue(fieldMark) {
+            const { fieldId, rowIndex, fullKey } = parseFieldMark(fieldMark);
+            if (!fieldId) return '';
+            // 明细行：用 fullKey 取最新值（changeFieldValue/addDetailRow 会写入 values[fullKey]）
+            if (rowIndex >= 0)
+                return values[fullKey] !== undefined ? String(values[fullKey]) : '';
+            // 主表：优先 mutations 中的最新值，其次初始 values
+            if (mutations.values[fullKey] !== undefined) return mutations.values[fullKey].value;
+            return String(values[fieldId] ?? '');
+        },
+
+        // 3.1 将字段名称转换成字段 id
+        convertFieldNameToId(fieldname, symbol, prefix) {
+            if (!fieldname) return '';
+            // symbol: 'main'(默认) / 'detail_1' / ...
+            const key = String(fieldname).toLowerCase();
+            const id = fieldByName.get(key);
+            if (!id) return '';
+            return prefix !== false ? `field${id}` : id;
+        },
+
+        // 3.6 批量修改字段值或显示属性
+        changeMoreField(changeDatas, changeVariable) {
+            if (changeDatas && typeof changeDatas === 'object') {
+                for (const [mark, info] of Object.entries(changeDatas)) {
+                    if (info && typeof info === 'object') {
+                        wfForm.changeFieldValue(mark, info);
+                    }
+                }
+            }
+            if (changeVariable && typeof changeVariable === 'object') {
+                for (const [mark, attr] of Object.entries(changeVariable)) {
+                    if (attr && typeof attr === 'object' && attr.viewAttr != null) {
+                        wfForm.changeFieldAttr(mark, attr.viewAttr);
+                    }
+                }
+            }
+        },
+
+        // 3.5 同时修改字段的值及显示属性
+        changeSingleField(fieldMark, valueInfo, variableInfo) {
+            if (valueInfo) wfForm.changeFieldValue(fieldMark, valueInfo);
+            if (variableInfo?.viewAttr != null) wfForm.changeFieldAttr(fieldMark, variableInfo.viewAttr);
+        },
+
+        // 3.7 触发指定字段涉及的所有联动
+        triggerFieldAllLinkage(fieldMark) {
+            // 委托给外部 resolveLinkageFn（异步，但这里不 await——记录到待触发列表）
+            const { fieldId } = parseFieldMark(fieldMark);
+            if (fieldId) {
+                pendingLinkages.add(fieldId);
+            }
+        },
+
+        // 3.8 根据字段 ID 获取字段信息
+        getFieldInfo(fieldid) {
+            const info = fieldById.get(String(fieldid));
+            if (!info) return {};
+            return {
+                htmltype: info.htmltype,
+                fieldname: info.name,
+                fieldlabel: info.label,
+                viewattr: info.viewattr,
+            };
+        },
+
+        // 2.1 注册拦截事件（提交前执行）
+        registerCheckEvent(type, fun) {
+            if (typeof fun !== 'function') return;
+            const types = String(type).split(',');
+            for (const t of types) {
+                if (!checkEvents[t]) checkEvents[t] = [];
+                checkEvents[t].push(fun);
+            }
+        },
+
+        // 4.1 注册字段值改变事件
+        bindFieldChangeEvent(fieldMarkStr, funobj) {
+            if (typeof funobj !== 'function') return;
+            const marks = String(fieldMarkStr).split(',');
+            const fieldMarks = new Set(marks);
+            changeEvents.push({ fieldMarks, handler: funobj });
+        },
+
+        // 2.2 注册钩子事件（指定动作完成后触发）
+        registerAction(actionname, fn) {
+            // post-action hooks 在提交场景不需要模拟——跳过
+        },
+
+        // 工具方法
+        isMobile() { return false; },
+        // 3.9 实时获取字段属性——返回后台配置的 viewattr
+        getFieldRealViewAttr(fieldid) {
+            const info = fieldById.get(String(fieldid));
+            return info?.viewattr ?? 2; // 默认可编辑
+        },
+        // E9 官方文档方法名 alias（getFieldCurViewAttr = 同义方法，旧版代码块可能用 getFieldRealViewAttr）
+        getFieldCurViewAttr(fieldid) {
+            const info = fieldById.get(String(fieldid));
+            return info?.viewattr ?? 2;
+        },
+        // 全局存储（代码块常取 currentUserid 做权限/条件分支）
+        getGlobalStore() {
+            return { commonParam: { currentUserid: userId } };
+        },
+        // 明细表：取该明细表的行下标字符串（如 "0,1,2"；无行返回 ""）
+        getDetailAllRowIndexStr(detailTable) {
+            const st = getDetailState(detailTable);
+            return [...st.rows.keys()].sort((a, b) => a - b).join(',');
+        },
+        // 4.1 新增明细行：记录并返回新行下标
+        addDetailRow(detailTable, rowData) {
+            const table = detailTable || 'detail_1';
+            const st = getDetailState(table);
+            const rowIndex = st.nextIndex++;
+            const row = {};
+            for (const [mark, info] of Object.entries(rowData ?? {})) {
+                const { fieldId } = parseFieldMark(mark);
+                if (!fieldId)
+                    continue;
+                const value = String(info?.value ?? '');
+                row[fieldId] = value;
+                values[`${fieldId}_${rowIndex}`] = value;
+            }
+            st.rows.set(rowIndex, row);
+            mutations.details.push({ op: 'add', table, rowIndex, row });
+            return rowIndex;
+        },
+        // 4.2 删除明细行（rowIndex="all" 表示清空该明细表）
+        delDetailRow(detailTable, rowIndex) {
+            const table = detailTable || 'detail_1';
+            const st = getDetailState(table);
+            if (String(rowIndex) === 'all') {
+                mutations.details.push({ op: 'del', table, all: true });
+                st.rows.clear();
+                st.nextIndex = 0;
+                return;
+            }
+            const idx = Number(rowIndex);
+            if (!Number.isFinite(idx))
+                return;
+            mutations.details.push({ op: 'del', table, rowIndex: idx });
+            st.rows.delete(idx);
+        },
+        // 4.2 明细字段值变化事件绑定（CLI 场景下标不可用，只 mock 注册不报错）
+        bindDetailFieldChangeEvent(fieldMarkStr, funobj) {
+            // no-op：不模拟明细行动态增删事件
+        },
+    };
+
+    // 待触发的联动字段集合
+    const pendingLinkages = new Set();
+
+    return { wfForm, mutations, changeEvents, checkEvents, pendingLinkages, submitBlocked: () => submitBlocked, setSubmitBlocked: (v) => { submitBlocked = v; }, values };
+}
+
+// ── 沙箱执行 ──────────────────────────────────────────────────────────
+
+/**
+ * 在 Node.js vm 沙箱中执行代码块 JS。
+ * @returns {object} mockEnv（含 wfForm, mutations, changeEvents, checkEvents, pendingLinkages 等）
+ */
+export function runCodeBlockInSandbox(jsCode, mockEnv) {
+    if (!jsCode || typeof jsCode !== 'string' || jsCode.trim() === '') return mockEnv;
+
+    const { wfForm } = mockEnv;
+
+    // jQuery mock：jQuery(document).ready(fn) / jQuery().ready(fn) — 立即执行回调
+    const readyFns = [];
+    const jQuery = function (sel) {
+        return {
+            ready(fn) { if (typeof fn === 'function') readyFns.push(fn); return this; },
+            on() { return this; },
+            val() { return ''; },
+            find() { return this; },
+            each(fn) { return this; },
+            attr() { return ''; },
+            html() { return ''; },
+            text() { return ''; },
+            css() { return this; },
+            show() { return this; },
+            hide() { return this; },
+            prop() { return ''; },
+            is() { return false; },
+        };
+    };
+    // jQuery 静态方法
+    jQuery.ajax = () => {};
+    jQuery.get = () => {};
+    jQuery.post = () => {};
+    jQuery.getJSON = () => {};
+
+    const sandbox = {
+        window: { WfForm: wfForm },
+        WfForm: wfForm,
+        wfForm,                       // 别名（部分代码块用小写）
+        jQuery,
+        $: jQuery,
+        document: {},
+        console,
+        alert: () => {},
+        setTimeout: (fn, ms) => { if (typeof fn === 'function') fn(); return 0; },
+        setInterval: () => 0,
+        clearTimeout: () => {},
+        clearInterval: () => {},
+        // 常用全局
+        parseInt,
+        parseFloat,
+        isNaN,
+        Math,
+        Date,
+        String,
+        Number,
+        Boolean,
+        Array,
+        Object,
+        JSON,
+        RegExp,
+        Error,
+    };
+
+    try {
+        const context = vm.createContext(sandbox);
+        vm.runInContext(jsCode, context, { timeout: 10000 });
+    } catch (e) {
+        // 代码块执行异常不阻断业务——可能是环境差异（DOM 操作等）
+        mockEnv.executionError = e.message;
+        console.error(`  [wfcodeblock] 代码块执行异常（忽略）：${e.message}`);
+    }
+
+    // 执行所有 jQuery.ready 回调（异常不阻断，但记录首个错误供状态行展示）
+    for (const fn of readyFns) {
+        try {
+            fn();
+        }
+        catch (e) {
+            if (!mockEnv.executionError) {
+                mockEnv.executionError = e.message;
+                console.error(`  [wfcodeblock] 代码块回调异常（忽略）：${e.message}`);
+            }
+        }
+    }
+
+    return mockEnv;
+}
+
+// ── 事件模拟 ──────────────────────────────────────────────────────────
+
+/**
+ * 模拟字段值改变事件：对每个已填值的字段，调用 bindFieldChangeEvent 注册的回调。
+ * 执行过程中若代码块调了 changeFieldValue，新值也会被收集并继续触发相关事件。
+ */
+export function simulateFieldChangeEvents(mockEnv, filledValues) {
+    const { wfForm, changeEvents, pendingLinkages } = mockEnv;
+    const processed = new Set();
+
+    // 初始触发：所有有值的字段
+    const queue = [];
+    for (const [fieldId, val] of Object.entries(filledValues ?? {})) {
+        if (val !== undefined && val !== '') {
+            queue.push(String(fieldId));
+        }
+    }
+
+    // 最多迭代 5 轮（防止循环依赖无限触发）
+    for (let round = 0; round < 5 && queue.length > 0; round++) {
+        const thisRound = [...new Set(queue)];
+        queue.length = 0;
+
+        for (const fieldId of thisRound) {
+            if (processed.has(fieldId)) continue;
+            processed.add(fieldId);
+
+            for (const ev of changeEvents) {
+                // 检查该事件是否监听此字段
+                const fieldMark = `field${fieldId}`;
+                let matched = false;
+                for (const m of ev.fieldMarks) {
+                    if (m === fieldMark || m === fieldId || m.replace(/^field/, '') === fieldId) {
+                        matched = true;
+                        break;
+                    }
+                }
+                if (!matched) continue;
+
+                // ★ 用 wfForm.getFieldValue 取最新值（而非初始 filledValues）
+                const currentVal = String(wfForm.getFieldValue(fieldMark) ?? '');
+
+                try {
+                    // 调用 handler(obj, id, value)
+                    ev.handler({}, fieldId, currentVal);
+                } catch { /* handler 异常忽略 */ }
+
+                // 触发联动（代码块内 changeFieldValue 后自动触发）
+                for (const pf of pendingLinkages) {
+                    if (!processed.has(pf)) queue.push(pf);
+                }
+                pendingLinkages.clear();
+            }
+        }
+
+        // 新一轮触发：检查是否有新的 changeFieldValue 变更需要响应
+        if (queue.length === 0) break;
+    }
+}
+
+/**
+ * 模拟提交前校验：执行 registerCheckEvent(OPER_SUBMIT) 注册的回调。
+ * 若回调未调用 callback()，则 blocked=true（阻断提交）。
+ *
+ * @returns {boolean} blocked — true 表示提交被代码块阻断
+ */
+export function simulateSubmitCheck(mockEnv) {
+    const { checkEvents, setSubmitBlocked } = mockEnv;
+    const callbacks = checkEvents[OPER_SUBMIT];
+    if (!callbacks || callbacks.length === 0) return false;
+
+    let blocked = false;
+
+    for (const fn of callbacks) {
+        let callbackCalled = false;
+        const callback = () => { callbackCalled = true; };
+
+        try {
+            fn(callback);
+        } catch { /* 校验异常忽略 */ }
+
+        if (!callbackCalled) {
+            blocked = true;
+        }
+    }
+
+    setSubmitBlocked(blocked);
+    return blocked;
+}
+
+// ── API: 抓取代码块 ────────────────────────────────────────────────────
+
+/**
+ * 从 getLayout 响应中提取 layoutid（优先 layouttype=0 显示模板）。
+ * 对齐 e9-cli pickLayoutId 逻辑。
+ */
+function pickLayoutId(gl) {
+    if (!gl) return '';
+    const arr = Array.isArray(gl) ? gl : (gl?.datas || gl?.data || gl?.layouts || (gl?.layoutid ? [gl] : []));
+    const list = Array.isArray(arr) ? arr : [arr];
+    const pick = list.find(x => String(x?.layouttype ?? x?.layoutType ?? '') === '0' || x?.isdefault)
+        || list.find(x => { const id = x?.layoutid ?? x?.id; return id && String(id) !== '0'; })
+        || list[0];
+    const id = pick?.layoutid ?? pick?.id ?? pick?.layoutId ?? '';
+    return id && String(id) !== '0' ? String(id) : '';
+}
+
+/**
+ * 发现节点的真实 layoutid。
+ * 1. getLayout API → pickLayoutId()
+ * 2. 兜底：getNodeModeInfo API → 提取 modeid 值
+ */
+async function discoverLayoutId(api, wfId, nodeId) {
+    // 1) getLayout
+    try {
+        const gl = await api.get('/api/workflow/wfexceldesign/getLayout', {
+            wfid: String(wfId), nodeid: String(nodeId), isbill: '1',
+        });
+        const j = gl?.json ?? {};
+        const lid = pickLayoutId(j);
+        if (lid) return lid;
+    } catch { /* getLayout 本环境常返回 500 */ }
+
+    // 2) getNodeModeInfo 兜底
+    try {
+        const mi = await api.get('/api/workflow/nodeformedit/getModeInfo', {
+            workflowid: String(wfId), nodeid: String(nodeId), __random__: String(Date.now()),
+        });
+        const s = JSON.stringify(mi?.json ?? mi);
+        const m = s.match(/"modeid":(-?\d+)/g) || [];
+        const vals = [...new Set(m.map(x => x.split(':')[1]))].filter(v => v !== '-1');
+        if (vals.length) return vals[0];
+    } catch { /* ignore */ }
+
+    return '';
+}
+
+/**
+ * 从 E9 服务端抓取并解码代码块 JS。
+ * 1. discoverLayoutId → 真实 layoutid
+ * 2. POST doLoadDesigner → 取 scripts hex
+ * 3. POST decode → 得明文 JS
+ *
+ * @returns {string|null} 明文 JS 或 null（无代码块/抓取失败）
+ */
+export async function fetchAndDecodeCodeBlocks(cfg, workflowId, nodeId, formId) {
+    if (!workflowId || !nodeId) return null;
+
+    const api = await createApiFromProfile(cfg);
+    const wfId = String(workflowId);
+    const nid = String(nodeId);
+    const fid = String(formId ?? '');
+
+    // 1) 发现真实 layoutid
+    const layoutid = await discoverLayoutId(api, wfId, nid);
+    if (!layoutid) return null;
+
+    // 2) 读取布局
+    let scriptsHex = '';
+    try {
+        const r = await api.post('/api/workflow/wfexceldesign/doLoadDesigner', {
+            wfid: wfId,
+            nodeid: nid,
+            formid: fid,
+            isbill: '1',
+            layouttype: '0',
+            layoutid,
+        });
+        const j = r?.json ?? {};
+
+        // scripts 可能在顶层 loaded.scripts 或 layoutInfo.scripts 里
+        const layoutInfo = j.layoutInfo;
+        let parsed;
+        if (layoutInfo) {
+            try {
+                parsed = typeof layoutInfo === 'string' ? JSON.parse(layoutInfo) : layoutInfo;
+            } catch { parsed = null; }
+        }
+        scriptsHex = j.scripts || parsed?.scripts || '';
+        if (!scriptsHex) return null;
+    } catch {
+        return null;
+    }
+
+    // 3) 解码 hex → 明文 JS
+    try {
+        const d = await api.post('/api/workflow/wfexceldesign/decode', {
+            content: String(scriptsHex),
+        });
+        let text = d?.text ?? '';
+        if (!text) {
+            const json = d?.json ?? {};
+            text = json.result ?? json.content ?? json.scripts ?? json.text ?? '';
+        }
+        if (!text) return null;
+
+        // decode 返回形如 <script>JS</script> 或含 JSON {result:"<script>...</script>"}
+        // 先尝试 JSON 解析（decode 可能把结果包在 JSON 里）
+        if (text.trim().startsWith('{')) {
+            try {
+                const j = JSON.parse(text);
+                text = j.result ?? text;
+            } catch { /* not JSON */ }
+        }
+
+        // 提取 <script>...</script> 标签内的 JS（可能有多个）
+        const scripts = [];
+        const re = /<script[^>]*>([\s\S]*?)<\/script>/gi;
+        let m;
+        while ((m = re.exec(text)) !== null) {
+            if (m[1].trim()) scripts.push(m[1].trim());
+        }
+        return scripts.length > 0 ? scripts.join('\n') : text.replace(/<[^>]+>/g, '').trim() || null;
+    } catch {
+        return null;
+    }
+}
+
+// ── 主入口 ────────────────────────────────────────────────────────────
+
+/**
+ * 执行流程表单的代码块，模拟浏览器端 WfForm 逻辑。
+ *
+ * 流程：
+ *   1. 从 formData 提取 nodeId / formId
+ *   2. 构建字段信息映射（name→id, id→info）
+ *   3. 抓取代码块 JS（doLoadDesigner + decode）
+ *   4. 构建 WfForm 模拟层
+ *   5. 在 vm 沙箱中执行代码块 JS（注册事件）
+ *   6. 模拟字段变更事件（bindFieldChangeEvent 回调）
+ *   7. 执行 triggerFieldAllLinkage 收集的字段联动
+ *   8. 模拟提交前校验（registerCheckEvent 回调）
+ *   9. 返回收集的变更值
+ *
+ * @param {object} cfg - 环境配置
+ * @param {string} workflowId
+ * @param {object} values - 当前已填字段值 { fieldId: value }
+ * @param {object} formData - describeFormFields 返回值
+ * @param {object} [opts] - 可选参数
+ * @param {Function} [opts.resolveLinkageFn] - 联动解析函数，签名为 async (fieldId, value) => { fieldId: {value, specialobj} }
+ * @param {string} [opts.userId] - 当前用户 ID，注入 getGlobalStore().commonParam.currentUserid
+ * @param {string} [opts.selfId] - 用户 selfId，用于读取缓存的字段映射（跳过 buildFieldInfoMap 重建）
+ * @returns {{ mutations: { values: object, attrs: object }, blocked: boolean }}
+ */
+export async function executeFormCodeBlocks(cfg, workflowId, values, formData, opts = {}) {
+    const result = {
+        mutations: { values: {}, attrs: {}, details: [] },
+        blocked: false,
+        // 状态行：无代码块 / 执行完成（计数）/ 执行失败（原因）
+        codeblock: { fetched: false, jsBytes: 0, valueCount: 0, detailCount: 0, attrCount: 0, blocked: false, error: null },
+    };
+
+    const nodeId = extractNodeId(formData);
+    const formId = formData?.submitParams?.formid ?? formData?.params?.formid ?? '';
+
+    // 没有 nodeId 无法定位代码块
+    if (!nodeId) return result;
+
+    const cachedFieldMap = (opts.selfId && workflowId)
+        ? getCachedFieldMap(cfg, opts.selfId, workflowId)
+        : null;
+    const { byName, byId } = cachedFieldMap || buildFieldInfoMap(formData);
+
+    // 抓取代码块
+    const jsCode = await fetchAndDecodeCodeBlocks(cfg, workflowId, nodeId, formId);
+    if (!jsCode) return result; // 无代码块——正常，大多数流程没有
+
+    const resolveLinkageFn = opts.resolveLinkageFn ?? (async () => ({}));
+    const userId = opts.userId ?? '';
+
+    // 构建 WfForm 模拟层
+    const mockEnv = buildWfFormMock({
+        values,
+        fieldById: byId,
+        fieldByName: byName,
+        resolveLinkageFn,
+        userId,
+        details: opts.details, // 已填明细行（供 addDetailRow/delDetailRow 正确续行）
+    });
+
+    // 执行代码块 JS（注册事件处理器）
+    runCodeBlockInSandbox(jsCode, mockEnv);
+
+    // 模拟字段变更事件（bindFieldChangeEvent 回调）
+    simulateFieldChangeEvents(mockEnv, values);
+
+    // ★ 执行 triggerFieldAllLinkage 收集的联动字段
+    if (mockEnv.pendingLinkages && mockEnv.pendingLinkages.size > 0) {
+        for (const fieldId of mockEnv.pendingLinkages) {
+            const fieldVal = mockEnv.values[fieldId] ?? '';
+            try {
+                const linkageResult = await resolveLinkageFn(fieldId, fieldVal);
+                if (linkageResult && typeof linkageResult === 'object') {
+                    for (const [key, cv] of Object.entries(linkageResult)) {
+                        const targetId = key.replace(/^field/, '');
+                        // 不覆盖用户已填值
+                        if (values[targetId] !== undefined && values[targetId] !== '') continue;
+                        if (cv && typeof cv === 'object' && cv.value !== undefined) {
+                            result.mutations.values[targetId] = { value: String(cv.value), specialobj: cv.specialobj };
+                        }
+                    }
+                }
+            } catch { /* 联动失败不阻断 */ }
+        }
+    }
+
+    // 模拟提交前校验
+    const blocked = simulateSubmitCheck(mockEnv);
+
+    // 合并 mutations（代码块 changeFieldValue 产生 + 联动产生）
+    Object.assign(result.mutations.values, mockEnv.mutations.values);
+    Object.assign(result.mutations.attrs, mockEnv.mutations.attrs);
+    result.mutations.details = mockEnv.mutations.details ?? [];
+    result.blocked = blocked;
+    result.codeblock = {
+        fetched: true,
+        jsBytes: jsCode.length,
+        valueCount: Object.keys(result.mutations.values).length,
+        detailCount: result.mutations.details.length,
+        attrCount: Object.keys(result.mutations.attrs).length,
+        blocked,
+        error: mockEnv.executionError ?? null,
+    };
+    return result;
+}