bdip-office-assistant-cli 0.0.0-stage → 1.0.1

package/dist/wfstart.js

@@ -0,0 +1,558 @@
+import { createApiFromProfile } from './client.js';
+import { describeFormFields, HTMLTYPE_LABEL, getBrowserOptions } from './wfform.js';
+import { findCreateWfByName } from './wfcreate.js';
+import { todayStr } from './util.js';
+import { beginSubmission, updateSubmission } from './submissionstate.js';
+const VIEWATTR_LABEL = { 1: '只读', 2: '可编辑', 3: '必填', 4: '隐藏' };
+/** 已知系统字段 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），跑 bdip 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) && body['field'+id] !== '' && body['field'+id] != null).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 } }
+ */
+
+/**
+ * 真正提交（新建流程）。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）。
+ */
+/**
+ * ★字段属性硬规则：只允许填写「可编辑/必填」(viewattr=2/3) 的字段。
+ * 只读(1)/隐藏(4) 字段**禁止**由用户/助手填值——不得绕过表单字段属性自行填值。
+ * 明细表字段同样按 viewattr 判定。无属性信息(viewattr 缺失)不拦，交给后端判定，避免误伤。
+ */
+export function findNonEditableFields(form, values, details = []) {
+    const byId = new Map();
+    for (const table of form?.tables ?? []) {
+        for (const fld of table.fields ?? [])
+            byId.set(String(fld.id), fld);
+    }
+    const bad = [];
+    const checkId = (rawId) => {
+        const id = String(rawId ?? '').replace(/^field/, '');
+        const fld = byId.get(id);
+        if (!fld)
+            return; // 未知字段交给后端判定
+        // 只拦「明确的」只读(1)/隐藏(4)；va=2/3 可编辑或必填放行；va=0 或缺失=属性未设置（实测量到「签字意见/标题/紧急程度/密级」
+        // 等系统字段是 va=0），按"无法判定即不拦"处理，避免把本可填的系统字段误拒。
+        if (Number(fld.viewattr) !== 1 && Number(fld.viewattr) !== 4)
+            return;
+        bad.push({ id, label: fld.label, viewattr: fld.viewattr });
+    };
+    for (const k of Object.keys(values ?? {}))
+        checkId(k);
+    for (const d of details ?? [])
+        for (const row of d?.rows ?? [])
+            for (const k of Object.keys(row ?? {}))
+                checkId(k);
+    return bad;
+}
+
+export async function prepareCreateSubmission(cfg, workflowId, values, requestname, details = []) {
+    const {prepareFields} = await import('./field-preparation.js');
+    const api=await createApiFromProfile(cfg);
+    const r=await api.post('/api/workflow/reqform/loadForm',{iscreate:'1',workflowid:String(workflowId)},{forceCookie:true});
+    const form=r.json;
+    const plan={workflowId:String(workflowId),requestName:requestname||form?.params?.workflowname,values,details,accountId:String(form?.params?.currentUserid),baseUrl:cfg.baseUrl};
+    const prepared=await prepareFields(cfg,plan,{api,form});
+    return {...plan,workflowName:form.params.workflowname,prepared,body:prepared.body};
+}
+export async function submitCreateRequest(cfg, workflowId, values, requestname, files = [], details = [], prepared = undefined) {
+    const {actionBody,classifyWrite,verifyAction,checkBaseline,checkAdapter}=await import('./field-preparation.js');
+    const {detailTables}=await import('./workflow-runtime.js');
+    const plan=prepared??await prepareCreateSubmission(cfg,workflowId,values,requestname,details);
+    if((plan.files??files).length)throw Error('附件需先上传并纳入完整预览，不在确认后静默修改');
+    if(!plan.prepared)throw Error('旧版提交计划缺少统一联动准备，请重新预览');
+    const api=await createApiFromProfile(cfg);
+    const r=await api.post('/api/workflow/reqform/loadForm',{workflowid:String(workflowId),iscreate:'1'},{forceCookie:true});
+    await checkAdapter(cfg,plan,r.json);
+    const originalTables=await detailTables(api,r.json,workflowId);
+    checkBaseline(plan.prepared,r.json,originalTables);
+    const body=actionBody(plan.prepared,r.json,'submit');
+    const started=beginSubmission({workflowId,workflowName:plan.workflowName,requestName:plan.requestName,values:plan.values});
+    if(started.duplicate)throw Error('已有提交记录，禁止重复新建，请先核验');
+    if(plan.id)updateSubmission(started.record.id,{verificationPlanId:plan.id});
+    try {
+        const response=await api.post('/api/workflow/reqform/requestOperation',body,{forceCookie:true});
+        const result=classifyWrite(response);
+        if(result.state==='failed'){const submission=updateSubmission(started.record.id,{status:'failed',...result});return {response,submission,outcome:'failed'};}
+        let problems=['返回结果不明'];
+        if(result.state==='written-unverified'&&result.requestId){
+            const read=await api.post('/api/workflow/reqform/loadForm',{workflowid:String(workflowId),requestid:String(result.requestId),iscreate:'0'},{forceCookie:true});
+            const tables=await detailTables(api,read.json,workflowId,result.requestId);
+            problems=verifyAction(plan.prepared.expected,read.json,tables,'submit');
+        }
+        const submission=updateSubmission(started.record.id,{status:problems.length?'uncertain':'created',...result,problems});
+        return {response,submission,outcome:problems.length?'uncertain':'created'};
+    }catch(error){updateSubmission(started.record.id,{status:'uncertain',error:String(error.message)});throw Error('提交结果待核验，禁止自动重试：'+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() { throw Error('独立联动接口已停用；请使用统一字段准备链路，避免丢失明细/公式联动'); }

package/dist/wfsummary.js

@@ -0,0 +1,89 @@
+import { createApiFromProfile } from './client.js';
+export async function getFlowSummary(cfg, requestId) {
+    const api = await createApiFromProfile(cfg);
+    // 第一步 loadForm（不带 wf+node）→ 拿 workflowid/nodeid
+    const r0 = await api.post('/api/workflow/reqform/loadForm', { iscreate: '0', requestid: requestId });
+    const j0 = r0.json ?? {};
+    const wfId = String(j0.params?.workflowid ?? '');
+    const nodeId = String(j0.params?.nodeid ?? '');
+    // 第二步 loadForm（带 wf+node）→ 拿 per-request 签名（不带则签名字段空）
+    let j = j0;
+    if (wfId && nodeId) {
+        const r1 = await api.post('/api/workflow/reqform/loadForm', { iscreate: '0', requestid: requestId, workflowid: wfId, nodeid: nodeId });
+        j = r1.json ?? j0;
+    }
+    const fm = j.tableInfo?.main?.fieldinfomap ?? {};
+    const md = j.maindata ?? {};
+    const fields = Object.entries(fm).map(([id, f]) => ({
+        id,
+        label: f?.fieldlabel,
+        name: f?.fieldname,
+        htmltypeLabel: htmltypeLabel(f?.htmltype),
+        value: md[`field${id}`]?.value != null ? String(md[`field${id}`].value) : undefined,
+    })).filter((f) => f.value);
+    // 流转日志：先调 getRequestLogBaseInfo 取真实的 viewLogIds/creatorNodeId
+    const p = j.params ?? {};
+    const userId = String(p.f_weaver_belongto_userid ?? '1');
+    const sigStr = String(p.signatureAttributesStr ?? '');
+    const sigKey = String(p.signatureSecretKey ?? '');
+    const commonLogParams = {
+        requestid: requestId,
+        requestType: '0',
+        workflowid: String(p.workflowid ?? ''),
+        nodeid: String(p.nodeid ?? ''),
+        signatureAttributesStr: sigStr,
+        signatureSecretKey: sigKey,
+        'f_weaver_belongto_userid': userId,
+        'f_weaver_belongto_usertype': String(p.f_weaver_belongto_usertype ?? '0'),
+        authStr: String(p.authStr ?? ''),
+        authSignatureStr: String(p.authSignatureStr ?? ''),
+        wfTestStr: '',
+    };
+    let logs = [];
+    let logDebug = { viewLogIds: '', creatorNodeId: '', source: 'none' };
+    try {
+        // ① getRequestLogBaseInfo
+        let viewLogIds = '';
+        let creatorNodeId = '';
+        const rBase = await api.post('/api/workflow/reqform/getRequestLogBaseInfo', { ...commonLogParams });
+        const baseText = rBase.text ?? '';
+        const vlm = baseText.match(/["']?viewLogIds["']?\s*[:=]\s*["']?(\d+(?:%2C|,)?(?:\d+(?:%2C|,)?)*)["']?/i);
+        const cnm = baseText.match(/["']?creatorNodeId["']?\s*[:=]\s*["']?(\d+)["']?/i);
+        if (vlm)
+            viewLogIds = vlm[1].replace(/%2C/gi, ',');
+        if (cnm)
+            creatorNodeId = cnm[1];
+        if (!viewLogIds && p.viewLogIds)
+            viewLogIds = String(p.viewLogIds);
+        if (!creatorNodeId && p.creatorNodeId)
+            creatorNodeId = String(p.creatorNodeId);
+        logDebug = { viewLogIds, creatorNodeId, source: (viewLogIds || creatorNodeId) ? 'getRequestLogBaseInfo' : 'none' };
+        const rl = await api.post('/api/workflow/reqform/getRequestLogList', {
+            ...commonLogParams,
+            isFromWfForm: '1',
+            isprint: '0', isurger: 'false', submit: '0', pgnumber: '1',
+            maxrequestlogid: '', viewLogIds, creatorNodeId,
+            isHideInput: '', isFormSignature: '', wfsignlddtcnt: '10', orderbytype: '1',
+            logpagesize: '', loadmethod: 'split', operatorid: '', deptid: '', subcomid: '',
+            content: '', nodename: '', createdateselect: '0', createdatefrom: '', createdateto: '',
+            fromCommunication: '', __random__: String(Date.now()),
+        });
+        logs = rl.json?.loglist ?? [];
+    }
+    catch { /* 日志取失败不阻断 */ }
+    return {
+        requestId,
+        workflowName: j.cellInfo?.sysFieldInfo?.workflowname,
+        workflowId: String(j.params?.workflowid ?? ''),
+        nodeId: String(j.params?.nodeid ?? ''),
+        verifyRight: j.params?.verifyRight === true,
+        fields,
+        logs,
+        logDebug,
+        raw: j,
+    };
+}
+function htmltypeLabel(ht) {
+    const m = { 1: '文本', 2: '多行文本', 3: '浏览选择', 4: '附件', 5: '选择框', 6: '复选框' };
+    return m[ht] ?? `ht=${ht}`;
+}