weaver-e9-assistant-cli 1.0.0

package/dist/wfstart.js

@@ -0,0 +1,717 @@
+import { createApiFromProfile } from './client.js';
+import { describeFormFields, HTMLTYPE_LABEL, getBrowserOptions } from './wfform.js';
+import { AuthTokenSession } from './auth-token.js';
+import { findCreateWfByName } from './wfcreate.js';
+import { uploadFile } 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: '隐藏' };
+/** 已知系统字段 id（负数），单独标注，不作为业务填值候选。 */
+const SYS_FIELD_IDS = new Set(['-1', '-2', '-4', '-9', '-10']);
+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 (hits.length > 1) {
+        const list = hits.map((w) => `${w.name} [id=${w.id ?? ''}]`).join('\n  ');
+        throw new Error(`按名「${name}」找到 ${hits.length} 个候选，请指定 --id：\n  ${list}`);
+    }
+    return hits[0].id ?? '';
+}
+/**
+ * 取主表业务字段清单（isdetail==0，排除系统字段）。**不按 viewattr 过滤**（静态 viewattr
+ * 不反映运行时可编辑性）。从 maindata 取当前值与选项。供 AI 向用户问答"填哪些"。
+ */
+export async function getStartableFields(cfg, workflowId) {
+    const f = await describeFormFields(cfg, workflowId);
+    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)))
+        .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.inputHint = fld.options.length > 0 ? `浏览框（前10: 给 option id）` : '浏览选择（给 id）';
+            }
+            catch {
+                /* 取选项失败不影响主流程，用户仍可给 id */
+            }
+        }
+    }
+    // 当前用户相关字段（申请人/部门/日期等）填默认值
+    let user = null;
+    try {
+        user = await getCurrentUser(cfg);
+    }
+    catch { /* 取不到不影响 */ }
+    if (user) {
+        for (const fld of fields) {
+            const dv = defaultForField(fld.label, fld.htmltype, user);
+            if (dv)
+                fld.defaultValue = dv;
+        }
+    }
+    // 明细表（detail_1/detail_2/...）：index=提交体后缀(detail_1→0,detail_2→1)，取字段+浏览框选项
+    const detailTables = [];
+    for (const t of f.tables) {
+        if (!t.key.startsWith('detail_'))
+            continue;
+        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 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.inputHint = fld.options.length > 0 ? `明细浏览框（前10: 给 option id）` : '明细浏览选择（给 id）';
+                }
+                catch { /* 取选项失败不阻断 */ }
+            }
+        }
+        detailTables.push({ index: idx, key: t.key, fields: dStartable });
+    }
+    return {
+        workflowId: f.workflowId,
+        workflowName: f.workflowName,
+        verifyRight: f.verifyRight,
+        fields,
+        detailTables,
+        maindata: f.maindata,
+        submitParams: f.submitParams,
+        params: f.params,
+        linkageCfg: f.raw?.linkageCfg,
+    };
+}
+function toStartable(fld, maindata) {
+    const key = `field${fld.id}`;
+    const cell = maindata?.[key];
+    const special = Array.isArray(cell?.specialobj) ? cell.specialobj : [];
+    let options = special.filter((o) => o && (o.id != null || o.name != null)).map((o) => ({ id: String(o.id ?? ''), name: String(o.name ?? '') }));
+    const ht = fld.htmltype;
+    // 选择框(htmltype=5)：选项在 fieldinfomap.selectattr.selectitemlist（不在 maindata）
+    if (ht === 5 && options.length === 0) {
+        const items = fld.raw?.selectattr?.selectitemlist;
+        if (Array.isArray(items)) {
+            options = items.filter((it) => it && it.selectname != null).map((it) => ({ id: String(it.selectvalue), name: String(it.selectname) }));
+        }
+    }
+    let inputHint;
+    if (ht === 3)
+        inputHint = '浏览选择（给 option id）';
+    else if (ht === 5 && options.length > 0)
+        inputHint = `选择框（给 option id）`;
+    else if (options.length > 1)
+        inputHint = '选择框（给 option id）';
+    else if (ht === 2)
+        inputHint = '多行文本';
+    else
+        inputHint = '文本';
+    const va = fld.viewattr;
+    return {
+        id: String(fld.id),
+        label: fld.label,
+        name: fld.name,
+        htmltype: ht,
+        htmltypeLabel: ht != null ? HTMLTYPE_LABEL[ht] ?? `ht=${ht}` : undefined,
+        viewattr: va,
+        viewattrLabel: va != null ? VIEWATTR_LABEL[va] ?? `va=${va}` : undefined,
+        currentValue: cell?.value != null ? String(cell.value) : undefined,
+        options: options.length > 0 ? options : undefined,
+        inputHint,
+    };
+}
+/**
+ * 构造新建提交体（扁平 form-urlencoded，匹配 create curl 字段集）。
+ * values: { "<id>": "值" }（业务字段值；图片/附件字段值=imagefileid；多选浏览框值=逗号分隔选项id）。
+ * requestname: 请求标题。browserNames: { "<fieldId>": "名称1##~~@@##名称2" }（多选浏览框的显示名，设 field<id>name）。
+ * details: 明细表行数据 [{index, rows:[{fieldId:value}, ...]}]，index 对应 detailTables[].index（detail_1→0）。
+ *   每行每字段生成 field<id>_<rownum>=value（rownum 从 0 开始，每个明细表独立编号）；
+ *   + nodesnum<index>/indexnum<index>=行数 + submitdtlid<index>=0,0,...（每行一个0带尾逗号）+ deldtlid<index>=（空）；
+ *   + detailFieldUnEmptyCount=所有明细行非空字段总数；existChangeRange 追加 field<id>_<rownum>。
+ *
+ * 字段值结构（用户 create curl 确认）：
+ *   - 文本/数字字段：field<id>=<值>
+ *   - 图片/附件字段：field<id>=<imagefileid>（annexdocids/annexdocinfos/field-annexupload 全空）
+ *   - 多选浏览框：field<id>=<id1>,<id2> + field<id>name=<名1>##~~@@##<名2>
+ *   - 明细行：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 = []) {
+    const wf = String(workflowId);
+    const p = params ?? {};
+    const sp = submitParams ?? {};
+    const filledIds = Object.keys(values).map((k) => (k.startsWith('field') ? k.replace(/^field/, '') : k));
+    // 当前流程创建人 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');
+    // 公文(odoc)流程标识：loadForm params.isWorkflowDoc=true 或 workflowtype=26。
+    // isOdocRequest/odocBtnFlag 浏览器提交体必带(否则 requestOperation 不进公文流转态，只保存不流转)。
+    const isWorkflowDoc = String(p.isWorkflowDoc ?? sp.isWorkflowDoc ?? 'false');
+    const isOdoc = isWorkflowDoc === 'true' || String(sp.workflowtype ?? p.workflowtype ?? '') === '26';
+    const body = {
+        formid: String(sp.formid ?? p.formid ?? ''),
+        'f_weaver_belongto_userid': uid,
+        isWorkflowDoc,
+        'f_weaver_belongto_usertype': String(p.f_weaver_belongto_usertype ?? sp.f_weaver_belongto_usertype ?? '0'),
+        nodetype: String(sp.nodetype ?? '0'),
+        method: '',
+        needoutprint: '',
+        src: 'submit',
+        isMultiDoc: '',
+        [`${uid}_${wf}_addrequest_submit_token`]: String(sp[`${uid}_${wf}_addrequest_submit_token`] ?? sp[`1_${wf}_addrequest_submit_token`] ?? ''),
+        topage: '',
+        workflowtype: String(sp.workflowtype ?? p.workflowtype ?? ''),
+        iscreate: '1',
+        comemessage: '',
+        remindTypes: '',
+        rand: '',
+        requestid: '-1',
+        linkageUUID: String(sp.linkageUUID ?? ''),
+        htmlfieldids: '',
+        needwfback: '1',
+        lastloginuserid: String(p.lastloginuserid ?? uid),
+        nodeid: String(sp.nodeid ?? p.nodeid ?? ''),
+        workflowid: wf,
+        isbill: String(sp.isbill ?? '1'),
+        annexdocids: '',
+        signdocids: '',
+        annexdocinfos: '',
+        handWrittenSign: '',
+        remark: '',
+        'field-annexupload': '',
+        signworkflowids: '',
+        remarkLocation: '',
+        isOdocRequest: isOdoc ? '1' : '0',
+        enableIntervenor: '',
+        odocBtnFlag: isOdoc ? 'odocTransfer1' : '',
+        verifyRequiredRange: 'field-9999,field-1,',
+        linkageUnFinishedKey: '',
+        remarkquote: '',
+        actiontype: 'requestOperation',
+        isFirstSubmit: '',
+        existChangeRange: filledIds.map((id) => `field${id}`).join(','),
+        requestname,
+        requestlevel: String(values['-2'] ?? '0'),
+        'field-10': values['-10'] ?? values['field-10'] ?? '4',
+        'field-9': '',
+    };
+    // 业务字段值（扁平 field<id>=<value>）；浏览框字段额外设 field<id>name
+    for (const [k, v] of Object.entries(values)) {
+        const id = k.startsWith('field') ? k.replace(/^field/, '') : k;
+        if (SYS_FIELD_IDS.has(id))
+            continue; // 系统字段已单独处理
+        body[`field${id}`] = v;
+        if (browserNames[id])
+            body[`field${id}name`] = browserNames[id];
+    }
+    body.remark = String(values['-4'] ?? '');
+    body.mainFieldUnEmptyCount = String(filledIds.filter((id) => !SYS_FIELD_IDS.has(id)).length);
+    // 明细表行：每行每字段 field<id>_<rownum>=value（rownum 从 0，每明细表独立）+ 行控制字段
+    const existDetail = [];
+    let detailUnEmpty = 0;
+    for (const dt of details) {
+        const rows = dt.rows || [];
+        if (rows.length === 0)
+            continue; // 空明细表不设行控制（新建场景无删行）
+        body[`nodesnum${dt.index}`] = String(rows.length);
+        body[`indexnum${dt.index}`] = String(rows.length);
+        body[`submitdtlid${dt.index}`] = rows.map(() => '0').join(',') + ',';
+        body[`deldtlid${dt.index}`] = '';
+        rows.forEach((row, rownum) => {
+            for (const [k, v] of Object.entries(row)) {
+                const id = k.startsWith('field') ? k.replace(/^field/, '') : k;
+                if (SYS_FIELD_IDS.has(id))
+                    continue;
+                body[`field${id}_${rownum}`] = v;
+                if (browserNames[id])
+                    body[`field${id}_${rownum}name`] = browserNames[id];
+                if (v !== '') {
+                    detailUnEmpty++;
+                    existDetail.push(`field${id}_${rownum}`);
+                }
+            }
+        });
+    }
+    body.detailFieldUnEmptyCount = String(detailUnEmpty);
+    // existChangeRange 追加明细非空字段（带 _<rownum> 后缀）
+    if (existDetail.length > 0)
+        body.existChangeRange = (body.existChangeRange ? body.existChangeRange + ',' : '') + existDetail.join(',');
+    body.signatureAttributesStr = String(p.signatureAttributesStr ?? '');
+    body.signatureSecretKey = String(p.signatureSecretKey ?? '');
+    body.selectNextFlow = '0';
+    body.openDataVerify = '0';
+    body.wfTestStr = '';
+    return body;
+}
+/**
+ * 解析多选浏览框(htmltype=3)字段的显示名。
+ * values 里某字段值=逗号分隔选项 id，这里查 browser data 接口拼成 "名1##~~@@##名2"，
+ * 供提交体设 field<id>name。取不到不阻断（提交体仍发 field<id>=ids）。
+ *
+ * 由 create start 的 dry-run 预览与真提交共享，避免两处重复 getBrowserOptions+拼名逻辑。
+ */
+export async function resolveBrowserNames(cfg, workflowId, fields, values, details = []) {
+    const bn = {};
+    for (const fld of fields) {
+        if (fld.htmltype !== 3)
+            continue;
+        const id = String(fld.id);
+        const fieldValues = [values[id]];
+        for (const detail of details) {
+            for (const row of detail.rows ?? [])
+                fieldValues.push(row[id] ?? row[`field${id}`]);
+        }
+        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)
+            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('##~~@@##');
+        }
+        catch {
+            /* 解析失败不阻断 */
+        }
+    }
+    return bn;
+}
+/**
+ * 选择框/浏览框字段：中文选项名 → 选项 ID 自动转换。
+ * 遍历所有表（主表+明细表）的字段，若字段 htmltype=3(浏览框) 或 5(选择框)，
+ * 将用户传入的选项名（中文）匹配为选项 id。name→id 匹配完成后原地修改 merged。
+ * 选项来源：先查 maindata 的 specialobj，再查 fieldinfomap 的 selectattr.selectitemlist。
+ */
+function resolveOptionNames(tables, maindata, merged) {
+    for (const t of tables) {
+        for (const fld of t.fields ?? []) {
+            const ht = fld.htmltype;
+            if (ht !== 3 && ht !== 5)
+                continue;
+            const id = String(fld.id);
+            const v = merged[id];
+            if (v === undefined || v === '')
+                continue;
+            // 收集选项：先 maindata.specialobj → 再 fieldinfomap.selectattr
+            const key = `field${id}`;
+            const cell = maindata?.[key];
+            const special = Array.isArray(cell?.specialobj) ? cell.specialobj : [];
+            let selectItems = special.filter((o) => o && (o.id != null || o.name != null)).map((o) => ({ selectvalue: String(o.id ?? ''), selectname: String(o.name ?? '') }));
+            if (selectItems.length === 0) {
+                const rawItems = fld.raw?.selectattr?.selectitemlist;
+                if (Array.isArray(rawItems))
+                    selectItems = rawItems.filter((it) => it && it.selectname != null);
+            }
+            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 result = converted.join(',');
+            if (result !== String(v)) {
+                merged[id] = result;
+            }
+        }
+    }
+}
+/**
+ * 字段联动：已填字段触发联动，自动补上关联字段值。
+ * 遍历所有表的字段，若有 linkageId 且已填值，调 reqDataInputResult 获取联动值，
+ * 合并进 merged（不覆盖用户已填的值）。
+ *
+ * 接口：POST /api/workflow/linkage/reqDataInputResult
+ * 参数：linkageid（来自 fieldinfomap.linkageId）、linkageUUID（来自 loadForm）
+ * 响应：assignInfo_{linkageId}.changeValue = { fieldNNN: { value, specialobj } }
+ */
+async function resolveFieldLinkages(cfg, workflowId, f, merged) {
+    const params = f.params ?? {};
+    const sp = f.submitParams ?? {};
+    const linkageUUID = String(sp.linkageUUID ?? '');
+    if (!linkageUUID)
+        return;
+    const uid = String(params.f_weaver_belongto_userid ?? sp.f_weaver_belongto_userid ?? '1');
+    const nodeid = String(sp.nodeid ?? params.nodeid ?? '');
+    const formid = String(sp.formid ?? params.formid ?? '');
+    // linkageCfg.dataInputCfg.{fieldId} = [{ config: linkageId, assignfields: [targetFieldId], relateFields: [triggerFieldId] }]
+    const dataInputCfg = f.raw?.linkageCfg?.dataInputCfg;
+    if (!dataInputCfg || typeof dataInputCfg !== 'object')
+        return;
+    const triggers = [];
+    for (const [fieldId, configs] of Object.entries(dataInputCfg)) {
+        if (!Array.isArray(configs))
+            continue;
+        const v = merged[String(fieldId)];
+        if (v === undefined || v === '')
+            continue;
+        for (const cfg of configs) {
+            const linkageId = cfg?.config;
+            if (!linkageId)
+                continue;
+            triggers.push({
+                linkageId: String(linkageId),
+                fieldId: String(fieldId),
+                value: String(v),
+                tableKey: 'main',
+            });
+        }
+    }
+    if (triggers.length === 0)
+        return;
+    const api = await createApiFromProfile(cfg);
+    for (const tr of triggers) {
+        const rowIndex = tr.tableKey === 'main' ? '-1' : '0'; // 明细表目前仅支持首行
+        const body = {
+            requestid: '-1', workflowid: String(workflowId), nodeid, formid,
+            isbill: '1', triSource: '1', showAI: '1',
+            [`triFieldid_${tr.linkageId}`]: tr.fieldId,
+            [`rowIndexStr_${tr.linkageId}`]: rowIndex,
+            [`triTableMark_${tr.linkageId}`]: tr.tableKey,
+            [`field${tr.fieldId}`]: tr.value,
+            linkageid: tr.linkageId,
+            linkageUUID,
+            wfTestStr: '',
+            f_weaver_belongto_userid: uid,
+            f_weaver_belongto_usertype: '0',
+        };
+        try {
+            const r = await api.post('/api/workflow/linkage/reqDataInputResult', body);
+            const j = r.json ?? {};
+            const assignInfo = j[`assignInfo_${tr.linkageId}`];
+            if (!assignInfo || assignInfo.resultOutOfLimit)
+                continue;
+            const changeValue = assignInfo.changeValue;
+            if (!changeValue || typeof changeValue !== 'object')
+                continue;
+            for (const [key, cv] of Object.entries(changeValue)) {
+                if (!cv || typeof cv !== 'object')
+                    continue;
+                const targetId = key.replace(/^field/, '');
+                if (merged[targetId] !== undefined)
+                    continue; // 用户已填则不覆盖
+                merged[targetId] = String(cv.value ?? '');
+                // 同时记录 specialobj 供后续使用（如 resolveBrowserNames）
+                if (Array.isArray(cv.specialobj) && cv.specialobj.length > 0) {
+                    const so = cv.specialobj[0];
+                    merged[`_so_${targetId}`] = JSON.stringify(so);
+                }
+            }
+        }
+        catch {
+            // 联动失败不阻断提交
+        }
+    }
+}
+/**
+ * 真正提交（新建流程）。POST /api/workflow/reqform/requestOperation（aiAgentToken）。
+ * files: {fieldId, filePath, listType?}[] —— 先上传拿 imagefileid，并入 field<id>（不设 annex 字段）。
+ * values 里多选浏览框字段的值=逗号分隔选项id，自动解析对应 name 设 field<id>name。
+ * details: 明细表行数据 [{index, rows:[{fieldId:value}]}]，每明细表 index 对应 detailTables[].index（detail_1→0）。
+ *   明细浏览框字段解析并提交 id 与 name；确认后由提交计划冻结，避免二次解析漂移。
+ * 返回 E9Response（成功通常含 requestid）。
+ */
+export async function prepareCreateSubmission(cfg, workflowId, values, requestname, details = []) {
+    const f = await describeFormFields(cfg, workflowId);
+    if (f.verifyRight === false)
+        throw new Error('无权限（verifyRight:false），跑 e9 auth token-login');
+    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 { /* 取不到不阻断 */ }
+    if (user) {
+        for (const fld of main?.fields ?? []) {
+            const id = String(fld.id);
+            if (merged[id] !== undefined)
+                continue; // 用户已填
+            if (fld.viewattr === 2)
+                continue; // 只读字段由系统/联动控制，不补默认值（避免覆盖联动计算，如外出时间 WCSJ）
+            const dv = defaultForField(fld.label, fld.htmltype, user);
+            if (dv)
+                merged[id] = dv;
+        }
+    }
+    // 联动解析：根据已填字段值，调用 reqDataInputResult 获取联动字段值
+    try {
+        const linkageChanges = await resolveLinkage(cfg, workflowId, merged);
+        for (const [fieldId, cv] of Object.entries(linkageChanges)) {
+            if (merged[fieldId] === undefined || merged[fieldId] === '0') {
+                merged[fieldId] = cv.value;
+                if (cv.specialobj && cv.specialobj.length > 0) {
+                    const so = cv.specialobj[0];
+                    console.log(`  🔗 联动: 经办人 → ${fieldId}=${so.name} (id=${cv.value})`);
+                }
+            }
+        }
+    }
+    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 };
+}
+
+/**
+ * 真正提交（新建流程）。若传入 prepared，则只用确认阶段冻结的业务字段、明细行与浏览框名称，
+ * 仅刷新本次表单必需的短期签名参数，绝不重新补默认值或执行联动。
+ */
+export async function submitCreateRequest(cfg, workflowId, values, requestname, files = [], details = [], prepared = undefined) {
+    let plan = prepared;
+    if (!plan) {
+        plan = await prepareCreateSubmission(cfg, workflowId, values, requestname, details);
+    }
+    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);
+    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);
+    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}。`);
+    }
+    const api = await createApiFromProfile(cfg);
+    // 公文(odoc)流程：requestOperation 只保存主表+分配 requestid，返回 type=ASYNC_SUBMIT（进入
+    // 异步流转态但未推送）。**不在此自动流转**——需先调 getOdocNextNodes 取候选操作人，跟用户确认
+    // 流转给谁后，再调 odocFlowNext 带 nextDirections 推送。create start 仅保存+展示候选，
+    // create flow 子命令完成选定+流转（符合"确认后再流转"）。
+    try {
+        const response = await api.post('/api/workflow/reqform/requestOperation', body);
+        const result = extractCreatedRequestId(response);
+        if (result.accepted) {
+            const submission = updateSubmission(started.record.id, { status: 'created', requestId: result.requestId, responseType: result.type });
+            return { response, submission, outcome: 'created' };
+        }
+        const submission = updateSubmission(started.record.id, { status: 'uncertain', responseType: result.type, lastHttpStatus: response.status });
+        return { response, submission, outcome: 'uncertain' };
+    }
+    catch (error) {
+        const submission = updateSubmission(started.record.id, { status: 'uncertain', error: String(error?.message ?? error) });
+        throw new Error(`发起请求结果未确认（submission_id=${submission.id}），系统已阻止自动重试以避免重复创建。请先运行 create verify ${submission.id} 核验。原始错误：${error.message}`);
+    }
+}
+export async function getOdocNextNodes(cfg, requestid, workflowId, params, submitParams) {
+    const p = params ?? {};
+    const sp = submitParams ?? {};
+    const uid = String(p.f_weaver_belongto_userid ?? sp.f_weaver_belongto_userid ?? '1');
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/odoc/odocrequest/loadData', {
+        dataId: '', requestid, workflowid: String(workflowId),
+        nodeid: String(sp.nodeid ?? p.nodeid ?? ''), formid: String(sp.formid ?? p.formid ?? ''),
+        isbill: String(sp.isbill ?? p.isbill ?? '1'),
+        'f_weaver_belongto_userid': uid, 'f_weaver_belongto_usertype': String(p.f_weaver_belongto_usertype ?? sp.f_weaver_belongto_usertype ?? '0'),
+        creater: uid, creatertype: '0', requestType: '2', remindTypes: '',
+        authSignatureStr: '', authStr: '', agentType: '', agentorByAgentId: '',
+    });
+    const j = r.json ?? {};
+    const list = Array.isArray(j.nextNodeList) ? j.nextNodeList : [];
+    return list.map((n) => ({
+        nodeid: Number(n.nodeid),
+        linkId: Number(n.linkId),
+        nodename: String(n.nodename ?? ''),
+        operators: Array.isArray(n.nodeOperators) ? n.nodeOperators.map((o) => ({ id: String(o.id ?? o.operatorid ?? ''), name: String(o.name ?? o.operatorname ?? '') })) : [],
+        defaultUserIds: String(n.nodeOperatorIds ?? ''),
+        isMustSelected: !!n.isMustSelected,
+    }));
+}
+/**
+ * 公文流转下一步。POST /api/odoc/odocrequest/flowNext（aiAgentToken 鉴权）。
+ *
+ * 公文流程 requestOperation（iscreate=1）只保存+进 ASYNC_SUBMIT 态，未推送。调本接口把请求推到
+ * 下一审批节点，公文才算"提交完成"。nextDirections 必须指定流转对象（userIds+nodeid+linkId），
+ * 由调用方从 getOdocNextNodes 选定后传入——空 nextDirections 是假成功（不真流转）。
+ *
+ * 链路（浏览器抓包对齐）：getLastOperateInfo 取真实 lastOperate → POST flowNext（带选定 nextDirections）。
+ * 复用 requestOperation 提交体的 verifyRequiredRange（必填校验范围，flowNext 同样校验）。
+ *
+ * 返回 {success, msg}（success=1 即"提交成功"，流程已流转到下一节点）。
+ */
+export async function odocFlowNext(cfg, requestid, workflowId, params, submitParams, submitBody, nextDirections) {
+    const p = params ?? {};
+    const sp = submitParams ?? {};
+    const uid = String(p.f_weaver_belongto_userid ?? sp.f_weaver_belongto_userid ?? '1');
+    const wf = String(workflowId);
+    const api = await createApiFromProfile(cfg);
+    // 1) getLastOperateInfo — 取真实 lastOperate（flowNext body 必须带，否则报"处理前已流转"误报）
+    let lastOperateDate = todayStr();
+    let lastOperator = uid;
+    let lastOperateTime = '';
+    try {
+        const last = await api.post('/api/odoc/odocrequest/getLastOperateInfo', { requestid });
+        const lj = last.json ?? {};
+        if (lj.lastOperateDate)
+            lastOperateDate = String(lj.lastOperateDate);
+        if (lj.lastOperator)
+            lastOperator = String(lj.lastOperator);
+        if (lj.lastOperateTime)
+            lastOperateTime = String(lj.lastOperateTime);
+    }
+    catch { /* 取不到用默认，不阻断 */ }
+    // 2) flowNext — nextDirections 由调用方选定（来自 getOdocNextNodes），空则不流转
+    const body = {
+        formid: String(sp.formid ?? p.formid ?? ''),
+        'f_weaver_belongto_userid': uid,
+        isWorkflowDoc: 'true',
+        'f_weaver_belongto_usertype': String(p.f_weaver_belongto_usertype ?? sp.f_weaver_belongto_usertype ?? '0'),
+        nodetype: String(sp.nodetype ?? p.nodetype ?? '0'),
+        method: '', needoutprint: '', src: '',
+        isMultiDoc: '', topage: '',
+        workflowtype: String(sp.workflowtype ?? p.workflowtype ?? '26'),
+        iscreate: '0', comemessage: '', remindTypes: '', rand: '',
+        requestid, linkageUUID: '', htmlfieldids: '', needwfback: '',
+        lastloginuserid: String(p.lastloginuserid ?? uid),
+        nodeid: String(sp.nodeid ?? p.nodeid ?? ''),
+        workflowid: wf,
+        isbill: String(sp.isbill ?? p.isbill ?? '1'),
+        [`${uid}_${wf}_addrequest_submit_token`]: '',
+        annexdocids: '', signdocids: '', annexdocinfos: '', handWrittenSign: '', remark: '',
+        'field-annexupload': '', signworkflowids: '', remarkLocation: '',
+        isOdocRequest: '1', enableIntervenor: '0', odocBtnFlag: 'odocTransfer1',
+        verifyRequiredRange: submitBody.verifyRequiredRange ?? 'field-9999,field-1,',
+        linkageUnFinishedKey: '', isremark: '0',
+        [`${uid}_${requestid}_request_submit_token`]: '',
+        lastOperateDate, lastOperator, lastOperateTime,
+        creater: uid, creatertype: '0', requestType: '2',
+        authSignatureStr: '', authStr: '', agentType: '', agentorByAgentId: '',
+        isend: '1', assignRemark: '',
+        nextDirections: JSON.stringify(nextDirections.map((d) => ({
+            userIds: d.userIds, ccUserIds: '', userSignType: '', userTransferType: '', userCopyType: '',
+            nodeid: d.nodeid, linkId: d.linkId,
+        }))),
+    };
+    const r = await api.post('/api/odoc/odocrequest/flowNext', body);
+    const j = r.json ?? {};
+    return { success: j.success === 1 || j.success === true, msg: String(j.msg ?? '') };
+}
+/**
+ * 审批路径预览：获取流程的所有节点及操作者信息。
+ * POST /api/workflow/layout/getSimpleModeData
+ * 返回 nodeInfo 数组，每节点含 nodeName/operatorName/nodeType 等。
+ */
+export async function getWorkflowPreview(cfg, requestId) {
+    const api = await createApiFromProfile(cfg);
+    // 先通过 loadForm 获取 workflowid
+    const r0 = await api.post('/api/workflow/reqform/loadForm', { iscreate: '0', requestid: requestId });
+    const j0 = r0.json ?? {};
+    const p0 = j0.params ?? {};
+    const wfId = String(p0.workflowid ?? '');
+    if (!wfId)
+        throw new Error('无法获取 workflowid');
+    const r = await api.post('/api/workflow/layout/getSimpleModeData', {
+        requestid: requestId,
+        requestType: '0',
+        workflowid: wfId,
+    });
+    const j = r.json ?? {};
+    const nodeInfo = Array.isArray(j.nodeInfo) ? j.nodeInfo : [];
+    const forecastInfo = j.forecastInfo ?? null;
+    return {
+        nodeInfo: nodeInfo.map((n) => ({
+            nodeName: String(n.nodeName ?? ''),
+            nodeOperatorName: String(n.nodeOperatorName ?? ''),
+            nodeType: n.nodeType,
+            isCurrent: n.isCurrent === true || n.isCurrent === 'true',
+            isPassed: n.isPassed === true || n.isPassed === 'true',
+        })),
+        forecastInfo: forecastInfo ? {
+            forecastNodeName: String(forecastInfo.forecastNodeName ?? ''),
+            forecastUserName: String(forecastInfo.forecastUserName ?? ''),
+        } : null,
+    };
+}
+/**
+ * 联动解析：根据已填字段值，调用 reqDataInputResult 获取联动字段值。
+ * 从 loadForm.linkageCfg.dataInputCfg 读取联动配置，对每个触发字段逐一调用。
+ * 返回 { "<fieldId>": { value, specialobj } } 的变更值映射。
+ */
+export async function resolveLinkage(cfg, workflowId, values) {
+    const f = await describeFormFields(cfg, workflowId);
+    const linkageCfg = f.raw?.linkageCfg;
+    if (!linkageCfg?.dataInputCfg)
+        return {};
+    const p = f.params ?? {};
+    const sp = f.submitParams ?? {};
+    const base = cfg.baseUrl.replace(/\/+$/, '');
+    const sess = AuthTokenSession.fromProfile(cfg);
+    const changes = {};
+    for (const [triggerFieldId, configs] of Object.entries(linkageCfg.dataInputCfg)) {
+        if (!Array.isArray(configs))
+            continue;
+        const triggerValue = values[triggerFieldId];
+        if (!triggerValue)
+            continue;
+        for (const cfg of configs) {
+            const configId = cfg.config;
+            if (!configId)
+                continue;
+            try {
+                const body = new URLSearchParams({
+                    requestid: '-1',
+                    workflowid: String(workflowId),
+                    nodeid: String(sp.nodeid ?? p.nodeid ?? ''),
+                    formid: String(sp.formid ?? p.formid ?? ''),
+                    isbill: String(sp.isbill ?? p.isbill ?? '1'),
+                    triSource: '1',
+                    showAI: '1',
+                    [`triFieldid_${configId}`]: triggerFieldId,
+                    [`rowIndexStr_${configId}`]: '-1',
+                    [`triTableMark_${configId}`]: 'main',
+                    [`field${triggerFieldId}`]: triggerValue,
+                    linkageid: configId,
+                    linkageUUID: String(sp.linkageUUID ?? ''),
+                    wfTestStr: '',
+                    'f_weaver_belongto_userid': String(p.f_weaver_belongto_userid ?? '1'),
+                    'f_weaver_belongto_usertype': String(p.f_weaver_belongto_usertype ?? '0'),
+                });
+                const r = await fetch(`${base}/api/workflow/linkage/reqDataInputResult`, {
+                    method: 'POST',
+                    headers: { aiAgentToken: sess.token, 'Content-Type': 'application/x-www-form-urlencoded', 'X-Requested-With': 'XMLHttpRequest' },
+                    body: body.toString(),
+                    signal: AbortSignal.timeout(15000),
+                });
+                const j = JSON.parse(await r.text());
+                const assignInfo = j[`assignInfo_${configId}`];
+                if (assignInfo?.changeValue) {
+                    for (const [key, cv] of Object.entries(assignInfo.changeValue)) {
+                        const fieldId = key.replace(/^field/, '');
+                        changes[fieldId] = { value: cv.value, specialobj: cv.specialobj };
+                    }
+                }
+            }
+            catch { /* 联动失败不阻断 */ }
+        }
+    }
+    return changes;
+}