weaver-e9-assistant-cli 1.1.5 → 1.1.12

package/dist/wfstart.js

@@ -1,22 +1,74 @@
 import { createApiFromProfile } from './client.js';
-import { describeFormFields, HTMLTYPE_LABEL, getBrowserOptions } from './wfform.js';
+import { describeFormFields, HTMLTYPE_LABEL, VIEWATTR_LABEL, fieldNonEditableReason, getBrowserOptions, browserNameSeparator, normalizeSelectValue } from './wfform.js';
 import { AuthTokenSession } from './auth-token.js';
 import { findCreateWfByName } from './wfcreate.js';
-import { uploadFile } from './wfupload.js';
+import { uploadFile, fieldListType, uploadFieldValue } from './wfupload.js';
 import { getCurrentUser, defaultForField } from './wfuser.js';
 import { todayStr } from './util.js';
 import { beginSubmission, extractCreatedRequestId, updateSubmission } from './submissionstate.js';
-const VIEWATTR_LABEL = { 1: '可编辑', 2: '只读', 3: '隐藏' };
+import { findShortcut, findShortcutFuzzy, hitShortcut, saveFieldDefault, saveShortcut, cacheFormFields, getCachedFormFields, getCachedLinkageResult, cacheLinkageResult, getFieldDefaults } from './memory.js';
+import { executeFormCodeBlocks } from './wfcodeblock.js';
+import { applyFormulas } from './formula.js';
 /** 已知系统字段 id（负数），单独标注，不作为业务填值候选。 */
 const SYS_FIELD_IDS = new Set(['-1', '-2', '-4', '-9', '-10']);
+
+/**
+ * loadForm.maindata 的主表业务字段 → { "<id>": value }（id>0）。
+ * 浏览器 generateFormData 会提交全部主表字段；发起提交只发改动字段会被服务端判定数据丢失（674 实证）。
+ */
+function maindataToValues(maindata) {
+    const out = {};
+    for (const [key, cell] of Object.entries(maindata ?? {})) {
+        const m = String(key).match(/^field(-?\d+)$/);
+        if (!m)
+            continue;
+        const id = Number(m[1]);
+        if (id <= 0)
+            continue;
+        out[m[1]] = cell?.value === undefined || cell?.value === null ? '' : String(cell.value);
+    }
+    return out;
+}
+
+/** 从 cookie 解析 userId（兜底）。 */
+function parseUserIdFromCookie(cookie) {
+    if (!cookie) return '';
+    const m = cookie.match(/(?:^|;\s*)loginidweaver=([^;]+)/);
+    return m ? m[1] : '';
+}
+
+/** 获取当前 selfId（优先 getCurrentUser，cookie 兜底）。 */
+async function resolveSelfId(cfg) {
+    try {
+        const u = await getCurrentUser(cfg);
+        const id = String(u?.userid ?? '');
+        if (id) return { selfId: id, selfName: String(u?.username ?? '') };
+    } catch { /* fall through */ }
+    const fromCookie = parseUserIdFromCookie(cfg?.cookie);
+    return { selfId: fromCookie, selfName: fromCookie };
+}
+
 export async function resolveWorkflowId(cfg, id, name) {
-    if (id)
-        return id;
-    if (!name)
-        throw new Error('需要 --id 或 --name');
-    const hits = await findCreateWfByName(cfg, name);
-    if (hits.length === 0)
-        throw new Error(`按名「${name}」未找到流程`);
+    if (id) return id;
+    if (!name) throw new Error('需要 --id 或 --name');
+    // ★ 记忆优先（模糊匹配）：查用户是否记住过相同或相似关键词对应的流程
+    const { selfId } = await resolveSelfId(cfg);
+    if (selfId) {
+        // 1. 精确匹配
+        let shortcut = findShortcut(cfg, selfId, name);
+        if (shortcut) {
+            hitShortcut(cfg, selfId, name);
+            return shortcut.workflowId;
+        }
+        // 2. 模糊匹配（"请个假"→"请假"、"休假"→"请假"）
+        const fuzzy = findShortcutFuzzy(cfg, selfId, name);
+        if (fuzzy) {
+            hitShortcut(cfg, selfId, fuzzy.keyword);
+            return fuzzy.shortcut.workflowId;
+        }
+    }
+    const hits = await findCreateWfByName(cfg, name, selfId);
+    if (hits.length === 0) throw new Error(`按名「${name}」未找到流程`);
     if (hits.length > 1) {
         const list = hits.map((w) => `${w.name} [id=${w.id ?? ''}]`).join('\n  ');
         throw new Error(`按名「${name}」找到 ${hits.length} 个候选，请指定 --id：\n  ${list}`);
@@ -24,22 +76,78 @@ export async function resolveWorkflowId(cfg, id, name) {
     return hits[0].id ?? '';
 }
 /**
- * 取主表业务字段清单（isdetail==0，排除系统字段）。**不按 viewattr 过滤**（静态 viewattr
- * 不反映运行时可编辑性）。从 maindata 取当前值与选项。供 AI 向用户问答"填哪些"。
+ * 从缓存 tables 重建 raw.tableInfo（{key: {fieldinfomap: {fieldId: rawField}}}）。
+ * 字段元数据（detailtype/fielddbtype/selectattr 等）就在每个 fld.raw 里，
+ * 重建后 getBrowserOptions 可直接复用，不必为浏览框再拉一次 loadForm（~2.3s）。
+ */
+function rebuildTableInfo(tables) {
+    const ti = {};
+    for (const t of tables ?? []) {
+        if (!t || !t.key) continue;
+        const fmap = {};
+        for (const fld of t.fields ?? []) {
+            if (fld?.id != null && fld.raw) fmap[String(fld.id)] = fld.raw;
+        }
+        ti[t.key] = { fieldinfomap: fmap };
+    }
+    return ti;
+}
+
+/**
+ * 取主表业务字段清单（isdetail==0，排除系统字段；**viewattr=0 隐藏字段不进入清单**）。
+ * 字段属性语义：0=隐藏 / 1=只读 / 2=可编辑 / 3=必填；可编辑性判据见 fieldNonEditableReason。
+ * 从 maindata 取当前值与选项。供 AI 向用户问答"填哪些"。
  */
 export async function getStartableFields(cfg, workflowId) {
-    const f = await describeFormFields(cfg, workflowId);
+    // ★ 表单缓存：同流程字段结构极少变化，30 天 TTL，命中文档跳过一次 HTTP（~2.3s）
+    let f;
+    let fromCache = false;
+    let selfId = '';
+    try { ({ selfId } = await resolveSelfId(cfg)); } catch { /* 取不到不阻断 */ }
+    if (selfId) {
+        try {
+            const cached = getCachedFormFields(cfg, selfId, workflowId);
+            if (cached) {
+                f = {
+                    workflowId,
+                    workflowName: cached.workflowName,
+                    tables: cached.tables,
+                    totalFields: cached.totalFields,
+                    verifyRight: cached.verifyRight,
+                    submitParams: cached.submitParams,
+                    params: cached.params,
+                    // ★ 重建 tableInfo：getBrowserOptions 靠 raw.tableInfo 判断 formData 可复用，
+                    //   缺它会导致浏览框路径每次重复 describeFormFields（~2.3s）。
+                    raw: { linkageCfg: cached.linkageCfg, tableInfo: rebuildTableInfo(cached.tables) },
+                    maindata: undefined, // 缓存不含 maindata（每次变化），浏览框走 getBrowserOptions 兜底
+                };
+                fromCache = true;
+            }
+        } catch { /* 缓存读失败不阻断，走正常流程 */ }
+    }
+    if (!f) {
+        f = await describeFormFields(cfg, workflowId);
+        if (f.verifyRight !== false) {
+            try {
+                if (selfId) cacheFormFields(cfg, selfId, workflowId, f);
+            } catch { /* 缓存写失败不阻断 */ }
+        }
+    }
     if (f.verifyRight === false)
         throw new Error(`无权限（verifyRight:false），跑 e9 auth token-login 后重试`);
     const main = f.tables.find((t) => t.key === 'main');
-    const fields = (main?.fields ?? [])
-        .filter((fld) => String(fld.isdetail ?? 0) === '0' && !SYS_FIELD_IDS.has(String(fld.id)))
+    // 发起节点隐藏字段（viewattr=0）不进入「待填清单」——它们在后续节点才填，展示出来会误导用户/AI。
+    const mainBusiness = (main?.fields ?? [])
+        .filter((fld) => String(fld.isdetail ?? 0) === '0' && !SYS_FIELD_IDS.has(String(fld.id)));
+    let hiddenCount = mainBusiness.filter((fld) => fld.viewattr === 0).length;
+    const fields = mainBusiness
+        .filter((fld) => fld.viewattr !== 0)
         .map((fld) => toStartable(fld, f.maindata));
     // 浏览框(htmltype=3)且无 maindata 选项的，调通用 browser data 接口取前 10
     for (const fld of fields) {
         if (fld.htmltype === 3 && (!fld.options || fld.options.length === 0)) {
             try {
-                fld.options = await getBrowserOptions(cfg, workflowId, fld.id, 10);
+                fld.options = await getBrowserOptions(cfg, workflowId, fld.id, 10, selfId, {}, f);
                 fld.inputHint = fld.options.length > 0 ? `浏览框（前10: 给 option id）` : '浏览选择（给 id）';
             }
             catch {
@@ -68,12 +176,14 @@ export async function getStartableFields(cfg, workflowId) {
         const idx = Number(t.key.substring('detail_'.length)) - 1;
         if (!Number.isFinite(idx) || idx < 0)
             continue;
-        const dflds = t.fields.filter((fld) => !SYS_FIELD_IDS.has(String(fld.id)));
+        const dfldsAll = t.fields.filter((fld) => !SYS_FIELD_IDS.has(String(fld.id)));
+        hiddenCount += dfldsAll.filter((fld) => fld.viewattr === 0).length;
+        const dflds = dfldsAll.filter((fld) => fld.viewattr !== 0);
         const dStartable = dflds.map((fld) => toStartable(fld, f.maindata));
         for (const fld of dStartable) {
             if (fld.htmltype === 3 && (!fld.options || fld.options.length === 0)) {
                 try {
-                    fld.options = await getBrowserOptions(cfg, workflowId, fld.id, 10);
+                    fld.options = await getBrowserOptions(cfg, workflowId, fld.id, 10, selfId, {}, f);
                     fld.inputHint = fld.options.length > 0 ? `明细浏览框（前10: 给 option id）` : '明细浏览选择（给 id）';
                 }
                 catch { /* 取选项失败不阻断 */ }
@@ -87,10 +197,14 @@ export async function getStartableFields(cfg, workflowId) {
         verifyRight: f.verifyRight,
         fields,
         detailTables,
+        hiddenCount, // 发起节点隐藏（viewattr=0）的字段数——不进入待填清单
+        tables: f.tables,         // 原始表结构（供 prepareCreateSubmission/submitCreateRequest 复用）
+        raw: f.raw,               // 原始 loadForm 响应（含 tableInfo.linkageCfg 等）
         maindata: f.maindata,
         submitParams: f.submitParams,
         params: f.params,
         linkageCfg: f.raw?.linkageCfg,
+        selfId,                    // 当前用户 ID（供下游缓存/联动用）
     };
 }
 function toStartable(fld, maindata) {
@@ -111,6 +225,10 @@ function toStartable(fld, maindata) {
         inputHint = '浏览选择（给 option id）';
     else if (ht === 5 && options.length > 0)
         inputHint = `选择框（给 option id）`;
+    else if (ht === 6)
+        inputHint = '附件上传（--file）';
+    else if (ht === 4)
+        inputHint = '复选框';
     else if (options.length > 1)
         inputHint = '选择框（给 option id）';
     else if (ht === 2)
@@ -118,6 +236,7 @@ function toStartable(fld, maindata) {
     else
         inputHint = '文本';
     const va = fld.viewattr;
+    const reason = fieldNonEditableReason(fld);
     return {
         id: String(fld.id),
         label: fld.label,
@@ -126,6 +245,9 @@ function toStartable(fld, maindata) {
         htmltypeLabel: ht != null ? HTMLTYPE_LABEL[ht] ?? `ht=${ht}` : undefined,
         viewattr: va,
         viewattrLabel: va != null ? VIEWATTR_LABEL[va] ?? `va=${va}` : undefined,
+        // 字段权限：viewattr 0隐藏/1只读/2可编辑/3必填 + isonlyshow/isedit/isview（判据见 fieldNonEditableReason）
+        editable: reason == null,
+        nonEditableReason: reason,
         currentValue: cell?.value != null ? String(cell.value) : undefined,
         options: options.length > 0 ? options : undefined,
         inputHint,
@@ -147,11 +269,14 @@ function toStartable(fld, maindata) {
  *   - 明细行：field<id>_<rownum>=<值>（rownum 从 0，每明细表独立）
  *   - existChangeRange=field<id>,field<id>...（field 前缀）；verifyRequiredRange=field-9999,field-1,（标题必填）
  */
-export function buildCreateSubmitBody(workflowId, values, requestname, params, submitParams, browserNames = {}, details = []) {
+export function buildCreateSubmitBody(workflowId, values, requestname, params, submitParams, browserNames = {}, details = [], options = {}) {
     const wf = String(workflowId);
     const p = params ?? {};
     const sp = submitParams ?? {};
-    const filledIds = Object.keys(values).map((k) => (k.startsWith('field') ? k.replace(/^field/, '') : k));
+    const valueId = (k) => (String(k).startsWith('field') ? String(k).slice(5) : String(k));
+    const filledIds = [...new Set(Object.keys(values).map(valueId))];
+    // existChangeRange 只记「用户/默认/代码块/联动」实际给过的字段，不把全量重发的服务端默认值算进去
+    const changedIds = [...new Set((options.changedIds ?? Object.keys(values)).map(valueId))];
     // 当前流程创建人 userid（loadForm params 给定）。submit_token 等字段的 key 带此 userid 前缀，
     // 不能硬编码 "1"——非 sysadmin=1 的环境（如阿汤哥 222222600）会取不到 submit_token 致"创建人和系统登录人不一致"。
     const uid = String(p.f_weaver_belongto_userid ?? sp.f_weaver_belongto_userid ?? '1');
@@ -179,7 +304,8 @@ export function buildCreateSubmitBody(workflowId, values, requestname, params, s
         requestid: '-1',
         linkageUUID: String(sp.linkageUUID ?? ''),
         htmlfieldids: '',
-        needwfback: '1',
+        // 正常提交：E9 bundle doSubmitNoBack→needwfback:"0"（doSubmitBack 的 "1" 是退回当前节点）
+        needwfback: '0',
         lastloginuserid: String(p.lastloginuserid ?? uid),
         nodeid: String(sp.nodeid ?? p.nodeid ?? ''),
         workflowid: wf,
@@ -200,7 +326,7 @@ export function buildCreateSubmitBody(workflowId, values, requestname, params, s
         remarkquote: '',
         actiontype: 'requestOperation',
         isFirstSubmit: '',
-        existChangeRange: filledIds.map((id) => `field${id}`).join(','),
+        existChangeRange: changedIds.filter((id) => !SYS_FIELD_IDS.has(id)).map((id) => `field${id}`).join(','),
         requestname,
         requestlevel: String(values['-2'] ?? '0'),
         'field-10': values['-10'] ?? values['field-10'] ?? '4',
@@ -216,7 +342,9 @@ export function buildCreateSubmitBody(workflowId, values, requestname, params, s
             body[`field${id}name`] = browserNames[id];
     }
     body.remark = String(values['-4'] ?? '');
-    body.mainFieldUnEmptyCount = String(filledIds.filter((id) => !SYS_FIELD_IDS.has(id)).length);
+    const valueOf = (id) => (values[id] !== undefined ? values[id] : values[`field${id}`]);
+    body.mainFieldUnEmptyCount = String(filledIds.filter((id) => !SYS_FIELD_IDS.has(id)
+        && valueOf(id) !== undefined && valueOf(id) !== null && String(valueOf(id)) !== '').length);
     // 明细表行：每行每字段 field<id>_<rownum>=value（rownum 从 0，每明细表独立）+ 行控制字段
     const existDetail = [];
     let detailUnEmpty = 0;
@@ -226,7 +354,8 @@ export function buildCreateSubmitBody(workflowId, values, requestname, params, s
             continue; // 空明细表不设行控制（新建场景无删行）
         body[`nodesnum${dt.index}`] = String(rows.length);
         body[`indexnum${dt.index}`] = String(rows.length);
-        body[`submitdtlid${dt.index}`] = rows.map(() => '0').join(',') + ',';
+        // E9 前端：submitdtlid = 存活行下标升序 + 尾逗号（不是 0,0,）
+        body[`submitdtlid${dt.index}`] = rows.map((_, rowIndex) => String(rowIndex)).join(',') + ',';
         body[`deldtlid${dt.index}`] = '';
         rows.forEach((row, rownum) => {
             for (const [k, v] of Object.entries(row)) {
@@ -234,8 +363,9 @@ export function buildCreateSubmitBody(workflowId, values, requestname, params, s
                 if (SYS_FIELD_IDS.has(id))
                     continue;
                 body[`field${id}_${rownum}`] = v;
-                if (browserNames[id])
-                    body[`field${id}_${rownum}name`] = browserNames[id];
+                const rowName = browserNames[`${id}_${rownum}`] ?? browserNames[id];
+                if (rowName)
+                    body[`field${id}_${rownum}name`] = rowName;
                 if (v !== '') {
                     detailUnEmpty++;
                     existDetail.push(`field${id}_${rownum}`);
@@ -256,36 +386,63 @@ export function buildCreateSubmitBody(workflowId, values, requestname, params, s
 }
 /**
  * 解析多选浏览框(htmltype=3)字段的显示名。
- * values 里某字段值=逗号分隔选项 id，这里查 browser data 接口拼成 "名1##~~@@##名2"，
+ * values 里某字段值=逗号分隔选项 id，这里查 browser data 接口拼成名称串，
  * 供提交体设 field<id>name。取不到不阻断（提交体仍发 field<id>=ids）。
+ * 分隔符：普通浏览框 `##~~@@##`；自定义浏览框(161/162) `##~~@@~~##`（E9 前端实证）。
  *
  * 由 create start 的 dry-run 预览与真提交共享，避免两处重复 getBrowserOptions+拼名逻辑。
  */
-export async function resolveBrowserNames(cfg, workflowId, fields, values, details = []) {
+export async function resolveBrowserNames(cfg, workflowId, fields, values, details = [], _selfId, formData) {
+    // 尝试取 selfId 用于浏览框选项缓存
+    let selfId = _selfId;
+    if (!selfId) {
+        try { ({ selfId } = await resolveSelfId(cfg)); } catch { /* 取不到不阻断 */ }
+    }
     const bn = {};
     for (const fld of fields) {
         if (fld.htmltype !== 3)
             continue;
         const id = String(fld.id);
-        const fieldValues = [values[id]];
+        // 主表 + 明细行的每个值槽位：支持传 id 或显示名，解析后原地写回规范化 id
+        const slots = [];
+        if (values[id] !== undefined)
+            slots.push({ key: id, get: () => values[id], set: (v) => { values[id] = v; } });
         for (const detail of details) {
-            for (const row of detail.rows ?? [])
-                fieldValues.push(row[id] ?? row[`field${id}`]);
+            (detail.rows ?? []).forEach((row, rownum) => {
+                const key = row[id] !== undefined ? id : (row[`field${id}`] !== undefined ? `field${id}` : null);
+                if (key)
+                    slots.push({ key: `${id}_${rownum}`, get: () => row[key], set: (v) => { row[key] = v; } });
+            });
         }
-        const ids = [...new Set(fieldValues
-            .filter((value) => value !== undefined && value !== null && value !== '')
-            .flatMap((value) => String(value).split(','))
-            .map((value) => value.trim())
-            .filter(Boolean))];
-        if (ids.length === 0)
+        if (slots.length === 0)
             continue;
         try {
-            const opts = await getBrowserOptions(cfg, workflowId, String(fld.id), 50);
-            const names = ids
-                .map((id) => opts.find((o) => o.id === id)?.name ?? '')
-                .filter(Boolean);
-            if (names.length > 0)
-                bn[id] = names.join('##~~@@##');
+            // 解析名称时取大页：自定义浏览框的选中项可能不在前 10/50 条
+            // 联动浏览框需带父值(values)才能拿到选项；formData 复用避免重复 describeFormFields
+            const opts = await getBrowserOptions(cfg, workflowId, id, 500, selfId, values, formData);
+            if (opts.length === 0)
+                continue;
+            const sep = browserNameSeparator(fld.raw ?? fld);
+            for (const slot of slots) {
+                const rawValues = String(slot.get() ?? '').split(',').map((s) => s.trim()).filter(Boolean);
+                if (rawValues.length === 0)
+                    continue;
+                const idArr = [];
+                const names = [];
+                let resolvedAll = true;
+                for (const value of rawValues) {
+                    const byId = opts.find((o) => String(o.id) === value);
+                    const sameName = opts.filter((o) => String(o.name) === value);
+                    const hit = byId ?? (sameName.length === 1 ? sameName[0] : null);
+                    if (!hit) { resolvedAll = false; break; }
+                    idArr.push(String(hit.id));
+                    names.push(String(hit.name));
+                }
+                if (!resolvedAll)
+                    continue;
+                slot.set(idArr.join(','));
+                bn[slot.key] = names.join(sep);
+            }
         }
         catch {
             /* 解析失败不阻断 */
@@ -299,7 +456,7 @@ export async function resolveBrowserNames(cfg, workflowId, fields, values, detai
  * 将用户传入的选项名（中文）匹配为选项 id。name→id 匹配完成后原地修改 merged。
  * 选项来源：先查 maindata 的 specialobj，再查 fieldinfomap 的 selectattr.selectitemlist。
  */
-function resolveOptionNames(tables, maindata, merged) {
+function resolveOptionNames(tables, maindata, merged, optionsMap = {}) {
     for (const t of tables) {
         for (const fld of t.fields ?? []) {
             const ht = fld.htmltype;
@@ -309,7 +466,7 @@ function resolveOptionNames(tables, maindata, merged) {
             const v = merged[id];
             if (v === undefined || v === '')
                 continue;
-            // 收集选项：先 maindata.specialobj → 再 fieldinfomap.selectattr
+            // 收集选项：先 maindata.specialobj → 再 fieldinfomap.selectattr → 再外部 optionsMap（getBrowserOptions 主动拉取）
             const key = `field${id}`;
             const cell = maindata?.[key];
             const special = Array.isArray(cell?.specialobj) ? cell.specialobj : [];
@@ -319,15 +476,26 @@ function resolveOptionNames(tables, maindata, merged) {
                 if (Array.isArray(rawItems))
                     selectItems = rawItems.filter((it) => it && it.selectname != null);
             }
+            if (selectItems.length === 0 && Array.isArray(optionsMap[id])) {
+                selectItems = optionsMap[id].map((o) => ({ selectvalue: String(o.id ?? ''), selectname: String(o.name ?? '') }));
+            }
             if (selectItems.length === 0)
                 continue;
             // 按逗号拆分（支持多选）
             const parts = String(v).split(',').map((s) => s.trim());
             const converted = parts.map((p) => {
-                const match = selectItems.find((it) => it && String(it.selectname).trim() === p);
-                if (match)
-                    return String(match.selectvalue ?? match.id ?? '');
-                return p; // 不匹配则保持原值（可能是 id 本身）
+                // 精确匹配 → 前缀匹配（唯一→使用；多候选→保持原文避免盲选）
+                const exact = selectItems.find((it) => it && String(it.selectname).trim() === p);
+                if (exact)
+                    return String(exact.selectvalue ?? exact.id ?? '');
+                const prefix = selectItems.filter((it) => it && String(it.selectname).trim().startsWith(p));
+                if (prefix.length === 1)
+                    return String(prefix[0].selectvalue ?? prefix[0].id ?? '');
+                // 选项名是 p 的前缀（p 附带额外文字如选项名+说明），且唯一
+                const suffix = selectItems.filter((it) => p.startsWith(String(it.selectname).trim()));
+                if (suffix.length === 1)
+                    return String(suffix[0].selectvalue ?? suffix[0].id ?? '');
+                return p; // 不匹配或不唯一则保持原值（可能是 id 本身）
             });
             const result = converted.join(',');
             if (result !== String(v)) {
@@ -432,9 +600,13 @@ async function resolveFieldLinkages(cfg, workflowId, f, merged) {
  * 返回 E9Response（成功通常含 requestid）。
  */
 /**
- * ★字段属性硬规则：只允许填写「可编辑」(viewattr=1) 的字段。
- * 只读(2)/隐藏(3) 字段**禁止**由用户/助手填值——不得绕过表单字段属性自行填值。
- * 明细表字段同样按 viewattr 判定。无属性信息(viewattr 缺失)不拦，交给后端判定，避免误伤。
+ * ★字段属性硬规则：只允许填写「可编辑」字段。
+ *
+ * 判据 = `fieldNonEditableReason`（与 E9 前端 `getFieldCurViewAttr` 对齐）：
+ *   - 权限位：`isonlyshow=1`（禁止手工编辑）/ `isedit=0`（节点不可编辑）/ `isview=0`（节点不可见）→ 拦截；
+ *   - `viewattr`：**0=隐藏 / 1=只读 → 拦截；2=可编辑 / 3=必填 → 放行**；
+ *   - 属性缺失 → 不拦，交给后端判定，避免误伤。
+ * 明细行键 `field<id>_<row>` 按字段 id 判定，防止只读明细字段绕过门禁。
  */
 export function findNonEditableFields(form, values, details = []) {
     const byId = new Map();
@@ -444,15 +616,16 @@ export function findNonEditableFields(form, values, details = []) {
     }
     const bad = [];
     const checkId = (rawId) => {
-        const id = String(rawId ?? '').replace(/^field/, '');
+        const raw = String(rawId ?? '').replace(/^field/, '');
+        // 明细行键 field<id>_<rownum>：按字段 id 查权限（否则只读明细字段会绕过门禁）
+        const id = raw.replace(/_\d+$/, '');
         const fld = byId.get(id);
         if (!fld)
             return; // 未知字段交给后端判定
-        // 只拦「明确的」只读(2)/隐藏(3)；va=1 可编辑放行；va=0 或缺失=属性未设置（实测量到「签字意见/标题/紧急程度/密级」
-        // 等系统字段是 va=0），按"无法判定即不拦"处理，避免把本可填的系统字段误拒。
-        if (fld.viewattr !== 2 && fld.viewattr !== 3)
+        const reason = fieldNonEditableReason(fld);
+        if (!reason)
             return;
-        bad.push({ id, label: fld.label, viewattr: fld.viewattr });
+        bad.push({ id: raw, label: fld.label, reason, currentValue: fld.currentValue });
     };
     for (const k of Object.keys(values ?? {}))
         checkId(k);
@@ -463,30 +636,165 @@ export function findNonEditableFields(form, values, details = []) {
     return bad;
 }
 
-export async function prepareCreateSubmission(cfg, workflowId, values, requestname, details = []) {
-    const f = await describeFormFields(cfg, workflowId);
+export async function prepareCreateSubmission(cfg, workflowId, values, requestname, details = [], formData) {
+    const f = formData || await describeFormFields(cfg, workflowId);
     if (f.verifyRight === false)
         throw new Error('无权限（verifyRight:false），跑 e9 auth token-login');
-    // ★字段属性硬规则：只读/隐藏字段禁止填值（不得绕过字段属性自行填值）
+    // ★字段属性硬规则：禁止手工编辑/不可见字段禁止填值（判据见 findNonEditableFields）
     const badFields = findNonEditableFields(f, values, details);
     if (badFields.length)
-        throw new Error(`拒绝填写只读/隐藏字段：${badFields.map((b) => `${b.label ?? b.id}(${VIEWATTR_LABEL[b.viewattr] ?? 'va=' + b.viewattr})`).join('、')}。表单只允许填写「可编辑」字段，不得绕过字段属性自行填值。`);
+        throw new Error(`拒绝填写禁止编辑的字段：${badFields.map((b) => `${b.label ?? b.id}(${b.reason}${b.currentValue ? `，已有默认值 ${b.currentValue} 自动带出` : ''})`).join('、')}。表单只允许填写「可编辑」字段，不得绕过字段权限自行填值。`);
     const name = requestname || `${f.workflowName ?? '流程'}-系统管理员-${todayStr()}`;
     const merged = { ...values };
-    // 用户未填的人员/部门/日期字段，用当前用户信息默认补上
     const main = f.tables.find((t) => t.key === 'main');
     let user = null;
     try {
         user = await getCurrentUser(cfg);
     }
     catch { /* 取不到不阻断 */ }
+    const selfId = user ? String(user.userid ?? '') : (formData?.selfId || '');
+    // 字段 id → label（冲突报告用）
+    const fieldLabelById = new Map();
+    for (const t of f.tables ?? [])
+        for (const fld of t.fields ?? [])
+            fieldLabelById.set(String(fld.id), fld.label);
+    // 代码块建议值 vs 用户显式值的冲突（用户意图优先，冲突只报告不覆盖）
+    const codeblockConflicts = [];
+    let codeblockDetailMutations = [];
+    let codeblockStatus = null;
+    // ★ 默认值优先级（2026-10-23 调整）：用户手填 > 表单代码块 > 记忆默认值 > 内置标签默认值。
+    //   表单代码块代表流程自身的业务逻辑，必须先执行；否则日期/人员等字段会被 CLI 先填成
+    //   “今天/当前用户”，代码块的值因“不覆盖已有值”被丢弃。
+    // ★ 代码块执行：模拟浏览器端 WfForm 逻辑（changeFieldValue 补值、registerCheckEvent 校验）
+    try {
+        const userId = user ? String(user.userid ?? '') : '';
+        // 联动包装函数（供代码块 triggerFieldAllLinkage 调用）
+        const linkageWrapper = async (triggerFieldId, triggerValue) => {
+            try {
+                return await resolveLinkage(cfg, workflowId, { [triggerFieldId]: triggerValue }, { formData: f, selfId });
+            } catch { return {}; }
+        };
+        const cb = await executeFormCodeBlocks(cfg, workflowId, merged, f, {
+            userId,
+            selfId,
+            resolveLinkageFn: linkageWrapper,
+            details,
+        });
+        const { mutations, blocked } = cb;
+        codeblockStatus = cb.codeblock ?? null;
+        codeblockDetailMutations = mutations.details ?? [];
+        if (mutations.values && Object.keys(mutations.values).length > 0) {
+            for (const [mKey, cv] of Object.entries(mutations.values)) {
+                // mKey 可能是 "123"（主表）或 "123_2"（明细行）；merged 只用 fieldId 扁平存储
+                const fieldId = mKey.includes('_') ? mKey.split('_')[0] : mKey;
+                const currentVal = merged[fieldId];
+                // 只有“未出现/空串”才算用户没填；'0' 是合法业务值（如选择框“否”），必须保留并报告冲突
+                if (currentVal === undefined || currentVal === '') {
+                    merged[fieldId] = cv.value;
+                    if (cv.specialobj && Array.isArray(cv.specialobj) && cv.specialobj.length > 0) {
+                        const so = cv.specialobj[0];
+                        console.log(`  📝 代码块补值: ${fieldId}=${so.name ?? cv.value}`);
+                    } else {
+                        console.log(`  📝 代码块补值: ${fieldId}=${cv.value}`);
+                    }
+                }
+                else if (String(currentVal) !== String(cv.value)) {
+                    // 用户在 --values 里显式指定了不同的值 → 按用户意图保留，但把冲突报告出来
+                    codeblockConflicts.push({
+                        fieldId,
+                        label: fieldLabelById.get(fieldId) ?? '',
+                        codeblockValue: String(cv.value),
+                        keptValue: String(currentVal),
+                    });
+                    const label = fieldLabelById.get(fieldId);
+                    console.log(`  📝 代码块建议 ${label ? label + '(' + fieldId + ')' : fieldId}=${cv.value}，但用户已指定 ${currentVal} → 保留用户值`);
+                }
+            }
+        }
+        if (mutations.attrs && Object.keys(mutations.attrs).length > 0) {
+            console.log(`  📝 代码块属性变更: ${Object.entries(mutations.attrs).map(([k,v]) => `${k}→${v}`).join(', ')}`);
+        }
+        if (blocked) {
+            console.warn('  ⚠️ 代码块校验阻断提交，请检查必填字段或业务规则');
+        }
+    }
+    catch (e) {
+        // 代码块执行失败不阻断提交，但状态行要明确告知
+        codeblockStatus = { fetched: false, jsBytes: 0, valueCount: 0, detailCount: 0, attrCount: 0, blocked: false, error: e.message };
+    }
+    // 代码块状态行：无 / 执行完成（计数）/ 执行失败（原因，走 stderr）
+    if (codeblockStatus) {
+        if (codeblockStatus.error) {
+            console.error(`  ⚠️ 代码块执行失败：${codeblockStatus.error}（提交继续）`);
+        }
+        else if (!codeblockStatus.fetched) {
+            console.log('  📝 代码块：无');
+        }
+        else {
+            console.log(`  📝 代码块：执行完成（${codeblockStatus.valueCount} 个字段补值 / ${codeblockStatus.detailCount} 条明细操作${codeblockStatus.attrCount ? ` / ${codeblockStatus.attrCount} 个属性变更` : ''}）`);
+        }
+    }
+    // ★ 代码块明细变更：合并进 details（用户已填值优先，冲突报告）
+    if (codeblockDetailMutations.length > 0) {
+        const rowsByIndex = new Map();
+        for (const d of details)
+            rowsByIndex.set(Number(d.index), (d.rows ?? []).map((r) => ({ ...r })));
+        const idxOfTable = (table) => Number(String(table).replace(/^detail_/, '')) - 1;
+        for (const op of codeblockDetailMutations) {
+            const idx = idxOfTable(op.table);
+            if (!Number.isFinite(idx) || idx < 0)
+                continue;
+            if (!rowsByIndex.has(idx))
+                rowsByIndex.set(idx, []);
+            const rows = rowsByIndex.get(idx);
+            if (op.op === 'del') {
+                if (op.all)
+                    rows.length = 0;
+                else if (rows[op.rowIndex] !== undefined)
+                    rows.splice(op.rowIndex, 1);
+                continue;
+            }
+            if (op.op === 'add') {
+                rows.push({ ...op.row });
+                continue;
+            }
+            if (op.op === 'set') {
+                const row = rows[op.rowIndex] ?? (rows[op.rowIndex] = {});
+                const cur = row[op.fieldId];
+                if (cur === undefined || cur === '') {
+                    row[op.fieldId] = op.value;
+                }
+                else if (String(cur) !== String(op.value)) {
+                    const label = fieldLabelById.get(op.fieldId);
+                    codeblockConflicts.push({ fieldId: op.fieldId, label: label ?? '', table: op.table, rowIndex: op.rowIndex, codeblockValue: String(op.value), keptValue: String(cur) });
+                    console.log(`  📝 代码块建议 ${label ? label + '(' + op.fieldId + ')' : op.fieldId}[第${op.rowIndex + 1}行]=${op.value}，但用户已指定 ${cur} → 保留用户值`);
+                }
+            }
+        }
+        // 回写 details（按 detail index 排序，空表不保留）
+        details.length = 0;
+        for (const [idx, rows] of [...rowsByIndex.entries()].sort((a, b) => a[0] - b[0])) {
+            if (rows.length > 0)
+                details.push({ index: idx, rows });
+        }
+    }
+    // ★ 记忆学习默认值：仅补仍为空的字段（用户手填/代码块已填的不覆盖）
+    try {
+        const defaults = getFieldDefaults(cfg, selfId, String(workflowId));
+        for (const [fid, entry] of Object.entries(defaults ?? {})) {
+            if (merged[fid] === undefined && entry && entry.default !== undefined && entry.default !== '')
+                merged[fid] = entry.default;
+        }
+    }
+    catch { /* 记忆读取失败不阻断 */ }
+    // ★ 内置标签默认值：仅补仍为空的字段（用户 > 代码块 > 记忆 > 内置）
     if (user) {
         for (const fld of main?.fields ?? []) {
             const id = String(fld.id);
             if (merged[id] !== undefined)
-                continue; // 用户已填
-            if (fld.viewattr === 2 || fld.viewattr === 3)
-                continue; // 只读/隐藏字段由系统/联动控制，不补默认值（不得绕过字段属性自行填值）
+                continue;
+            if (fld.editable === false)
+                continue; // 禁止手工编辑/不可见字段由系统/联动控制，不补默认值
             const dv = defaultForField(fld.label, fld.htmltype, user);
             if (dv)
                 merged[id] = dv;
@@ -494,7 +802,7 @@ export async function prepareCreateSubmission(cfg, workflowId, values, requestna
     }
     // 联动解析：根据已填字段值，调用 reqDataInputResult 获取联动字段值
     try {
-        const linkageChanges = await resolveLinkage(cfg, workflowId, merged);
+        const linkageChanges = await resolveLinkage(cfg, workflowId, merged, { formData, selfId });
         for (const [fieldId, cv] of Object.entries(linkageChanges)) {
             if (merged[fieldId] === undefined || merged[fieldId] === '0') {
                 merged[fieldId] = cv.value;
@@ -506,34 +814,115 @@ export async function prepareCreateSubmission(cfg, workflowId, values, requestna
         }
     }
     catch { /* 联动失败不阻断 */ }
+    // ★ 选项名→ID 自动转换：用户手填中文选项名（浏览框/选择框）时，主动拉取选项并转 id
+    try {
+        const optionMap = {};
+        // 收集需要转换的字段：htmltype=3(浏览框)/5(选择框) 且值不是纯数字 id 串/日期时间等直填值的
+        const needConvert = (fld) => {
+            const ht = fld.htmltype;
+            if (ht !== 3 && ht !== 5)
+                return;
+            const fid = String(fld.id);
+            const v = merged[fid];
+            if (v === undefined || v === '')
+                return;
+            const sv = String(v).trim();
+            if (/^[\d,]+$/.test(sv))
+                return; // 纯数字 id 串不需要转换
+            // 日期/时间浏览框直接填值，不走选项转换（避免无谓的 browser data 请求）
+            if (/^\d{4}-\d{2}-\d{2}/.test(sv) || /^\d{2}:\d{2}/.test(sv))
+                return;
+            optionMap[fid] = null;
+        };
+        for (const t of f.tables ?? [])
+            for (const fld of t.fields ?? [])
+                needConvert(fld);
+        const idsToFetch = Object.keys(optionMap);
+        if (idsToFetch.length > 0) {
+            const results = await Promise.allSettled(idsToFetch.map((fid) => getBrowserOptions(cfg, workflowId, fid, 50, selfId, merged, f).then((opts) => { optionMap[fid] = opts; }).catch(() => { optionMap[fid] = []; })));
+            resolveOptionNames(f.tables, f.maindata, merged, optionMap);
+        }
+    }
+    catch { /* 选项转换失败不阻断 */ }
     // 多选浏览框字段(htmltype=3)的值=逗号分隔id，解析对应 name 设 field<id>name
     const browserFields = f.tables.flatMap((table) => table.fields ?? []);
-    const browserNames = await resolveBrowserNames(cfg, workflowId, browserFields, merged, details);
-    const body = buildCreateSubmitBody(workflowId, merged, name, f.params, f.submitParams, browserNames, details);
-    return { workflowId: String(workflowId), workflowName: f.workflowName, requestName: name, values: merged, details, browserNames, body };
+const browserNames = await resolveBrowserNames(cfg, workflowId, browserFields, merged, details, undefined, f);
+    // 选择框(htmltype=5)：显示名 → selectvalue（否则回显匹配不到选项，下拉框显示为空）
+    const selectFields = new Map();
+    for (const fld of browserFields)
+        if (Number(fld.htmltype) === 5)
+            selectFields.set(String(fld.id), fld);
+    const normalizeSelects = (obj) => {
+        for (const [k, v] of Object.entries(obj ?? {})) {
+            const id = k.startsWith('field') ? k.replace(/^field/, '') : k;
+            const fld = selectFields.get(String(id));
+            if (!fld)
+                continue;
+            const normalized = normalizeSelectValue(fld, v);
+            if (normalized !== undefined)
+                obj[k] = normalized;
+        }
+    };
+    normalizeSelects(merged);
+    for (const dt of details)
+        for (const row of dt.rows ?? [])
+            normalizeSelects(row);
+    // 公式字段（主表/明细）：本地计算后写入 merged/details
+    const formulas = applyFormulas(f, merged, details);
+    // 提交体带全量主表业务字段（服务端默认值 + 本次改动）；existChangeRange 只记 merged 里的改动
+    const bodyValues = { ...maindataToValues(f.maindata), ...merged };
+    const body = buildCreateSubmitBody(workflowId, bodyValues, name, f.params, f.submitParams, browserNames, details, { changedIds: Object.keys(merged) });
+    return { workflowId: String(workflowId), workflowName: f.workflowName, requestName: name, values: merged, details, browserNames, codeblockConflicts, codeblock: codeblockStatus, formulas, body };
 }
 
 /**
  * 真正提交（新建流程）。若传入 prepared，则只用确认阶段冻结的业务字段、明细行与浏览框名称，
  * 仅刷新本次表单必需的短期签名参数，绝不重新补默认值或执行联动。
  */
-export async function submitCreateRequest(cfg, workflowId, values, requestname, files = [], details = [], prepared = undefined) {
+export async function submitCreateRequest(cfg, workflowId, values, requestname, files = [], details = [], prepared = undefined, opts = {}) {
     let plan = prepared;
     if (!plan) {
-        plan = await prepareCreateSubmission(cfg, workflowId, values, requestname, details);
+        plan = await prepareCreateSubmission(cfg, workflowId, values, requestname, details, opts.formData);
     }
     else {
         plan = { ...prepared, values: { ...prepared.values } };
     }
     // 文件 ID 只能在真实提交时获得；其余已确认字段绝不重新解析或联动。
-    for (const fl of (plan.files ?? files)) {
-        const up = await uploadFile(cfg, { workflowId: String(workflowId), fieldId: fl.fieldId, filePath: fl.filePath, listType: fl.listType });
-        plan.values[fl.fieldId] = up.fileid;
-    }
-    const f = await describeFormFields(cfg, workflowId);
+    // ★ 表单缓存：优先用调用方传入的 formData（避免重复 describeFormFields ~2.3s）
+    const f = opts.formData || await describeFormFields(cfg, workflowId);
     if (f.verifyRight === false)
         throw new Error('无权限（verifyRight:false），跑 e9 auth token-login');
-    const body = buildCreateSubmitBody(workflowId, plan.values, plan.requestName, f.params, f.submitParams, plan.browserNames, plan.details);
+    // 附件字段的上传目录在 fieldinfomap.fileattr.docCategory（如 ",,2"），必须与表单字段一致
+    const allFields = f.tables.flatMap((t) => t.fields ?? []);
+    const categoryFor = (fieldId) => allFields.find((x) => String(x.id) === String(fieldId))?.raw?.fileattr?.docCategory || undefined;
+    for (const fl of (plan.files ?? files)) {
+        // 支持主表 fieldId 与明细行 fieldId_<row>（如 27799_0）
+        const m = String(fl.fieldId).match(/^(\d+)(?:_(\d+))?$/);
+        const baseId = m ? m[1] : String(fl.fieldId);
+        const rowIndex = m && m[2] !== undefined ? Number(m[2]) : null;
+        const fieldMeta = allFields.find((x) => String(x.id) === baseId);
+        // 附件字段走 list、图片字段走 img（E9 前端按 detailtype=2 判定）
+        const listType = fl.listType ?? fieldListType(fieldMeta);
+        const up = await uploadFile(cfg, {
+            workflowId: String(workflowId), fieldId: baseId, filePath: fl.filePath,
+            listType, category: categoryFor(baseId),
+        });
+        const fileValue = uploadFieldValue(up, listType);
+        if (rowIndex === null) {
+            plan.values[baseId] = fileValue;
+            continue;
+        }
+        const tableKey = fieldMeta?.table ?? '';
+        const detailIndex = tableKey.startsWith('detail_') ? Number(tableKey.slice('detail_'.length)) - 1 : NaN;
+        const detail = (plan.details ?? []).find((d) => Number(d.index) === detailIndex);
+        const row = detail?.rows?.[rowIndex];
+        if (!row)
+            throw new Error(`明细附件上传需要 --detail-file 中已有对应行：field${baseId}_${rowIndex}`);
+        row[baseId] = fileValue;
+    }
+    // 提交体带全量主表业务字段；existChangeRange 只记 plan.values 里的字段
+    const bodyValues = { ...maindataToValues(f.maindata), ...plan.values };
+    const body = buildCreateSubmitBody(workflowId, bodyValues, plan.requestName, f.params, f.submitParams, plan.browserNames, plan.details, { changedIds: Object.keys(plan.values) });
     const started = beginSubmission({ workflowId, workflowName: f.workflowName, requestName: plan.requestName, values: plan.values });
     if (started.duplicate) {
         throw new Error(`检测到相同内容刚刚已发起或结果待核验（submission_id=${started.record.id}）。为避免重复创建，本次没有再次提交；请先运行 create verify ${started.record.id}。`);
@@ -548,6 +937,27 @@ export async function submitCreateRequest(cfg, workflowId, values, requestname,
         const result = extractCreatedRequestId(response);
         if (result.accepted) {
             const submission = updateSubmission(started.record.id, { status: 'created', requestId: result.requestId, responseType: result.type });
+            // ★ 自动记忆：成功提交后保存快捷方式 + 字段默认值
+            //   ⚠️ 只跳过空串；'0' 是合法业务值（金额 0 / 数量 0 / 选择框"否"=0），必须记忆，
+            //   不能当"没填"处理（旧实现 userValues[fid] !== '0' 导致这些默认值永远学不到）。
+            if (opts.keyword) {
+                try {
+                    const { selfId, selfName } = await resolveSelfId(cfg);
+                    if (selfId) {
+                        saveShortcut(cfg, selfId, selfName, opts.keyword, String(workflowId), f.workflowName);
+                        const userValues = plan.values || {};
+                        const mainFields = (f.tables.find(t => t.key === 'main')?.fields ?? []);
+                        for (const fld of mainFields) {
+                            const fid = String(fld.id);
+                            if (userValues[fid] !== undefined && userValues[fid] !== ''
+                                && !SYS_FIELD_IDS.has(fid)) {
+                                saveFieldDefault(cfg, selfId, selfName, String(workflowId), fid,
+                                    fld.label || fid, String(userValues[fid]));
+                            }
+                        }
+                    }
+                } catch { /* 记忆保存失败不阻断业务 */ }
+            }
             return { response, submission, outcome: 'created' };
         }
         const submission = updateSubmission(started.record.id, { status: 'uncertain', responseType: result.type, lastHttpStatus: response.status });
@@ -691,9 +1101,12 @@ export async function getWorkflowPreview(cfg, requestId) {
  * 联动解析：根据已填字段值，调用 reqDataInputResult 获取联动字段值。
  * 从 loadForm.linkageCfg.dataInputCfg 读取联动配置，对每个触发字段逐一调用。
  * 返回 { "<fieldId>": { value, specialobj } } 的变更值映射。
+ *
+ * ★ formData 提供时可跳过 describeFormFields HTTP 调用（prepareCreateSubmission 已缓存）。
+ * ★ selfId 提供时启用联动结果缓存（1 小时 TTL），同 workflow+config+字段+值组合免重复 HTTP。
  */
-export async function resolveLinkage(cfg, workflowId, values) {
-    const f = await describeFormFields(cfg, workflowId);
+export async function resolveLinkage(cfg, workflowId, values, opts = {}) {
+    const f = opts.formData || await describeFormFields(cfg, workflowId);
     const linkageCfg = f.raw?.linkageCfg;
     if (!linkageCfg?.dataInputCfg)
         return {};
@@ -701,21 +1114,37 @@ export async function resolveLinkage(cfg, workflowId, values) {
     const sp = f.submitParams ?? {};
     const base = cfg.baseUrl.replace(/\/+$/, '');
     const sess = AuthTokenSession.fromProfile(cfg);
+    const selfId = opts.selfId || '';
     const changes = {};
     for (const [triggerFieldId, configs] of Object.entries(linkageCfg.dataInputCfg)) {
         if (!Array.isArray(configs))
             continue;
         const triggerValue = values[triggerFieldId];
-        if (!triggerValue)
+        // 只跳过"未填"；'0'/0 是合法业务值（选择框"否"=0），不能当没填（旧实现 !triggerValue 会误跳）
+        if (triggerValue === undefined || triggerValue === '')
             continue;
         for (const cfg of configs) {
             const configId = cfg.config;
             if (!configId)
                 continue;
+
+            const wfId = String(workflowId);
+            // ★ 缓存优先
+            if (selfId) {
+                const cached = getCachedLinkageResult(cfg, selfId, wfId, String(configId), triggerFieldId, triggerValue);
+                if (cached) {
+                    for (const [key, cv] of Object.entries(cached)) {
+                        const fieldId = key.replace(/^field/, '');
+                        changes[fieldId] = { value: cv.value, specialobj: cv.specialobj };
+                    }
+                    continue;
+                }
+            }
+
             try {
                 const body = new URLSearchParams({
                     requestid: '-1',
-                    workflowid: String(workflowId),
+                    workflowid: wfId,
                     nodeid: String(sp.nodeid ?? p.nodeid ?? ''),
                     formid: String(sp.formid ?? p.formid ?? ''),
                     isbill: String(sp.isbill ?? p.isbill ?? '1'),
@@ -740,6 +1169,12 @@ export async function resolveLinkage(cfg, workflowId, values) {
                 const j = JSON.parse(await r.text());
                 const assignInfo = j[`assignInfo_${configId}`];
                 if (assignInfo?.changeValue) {
+                    // ★ 写入缓存
+                    if (selfId) {
+                        try {
+                            cacheLinkageResult(cfg, selfId, wfId, String(configId), triggerFieldId, triggerValue, assignInfo.changeValue);
+                        } catch { /* 缓存写失败不阻断 */ }
+                    }
                     for (const [key, cv] of Object.entries(assignInfo.changeValue)) {
                         const fieldId = key.replace(/^field/, '');
                         changes[fieldId] = { value: cv.value, specialobj: cv.specialobj };