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

package/dist/workflow.js

@@ -0,0 +1,570 @@
+import { createApiFromProfile } from './client.js';
+import { extractDataKey, extractRows, extractTotal, extractColumns, normalizeRow, pickByPaths, stripHtml } from './parse.js';
+/**
+ * 复刻 BDIP5 流程中心取数链路。支持 todo(待办)/done(已办)/mine(我发起) 三大分类。
+ *
+ *   1) getWfListParams(viewcondition)  -> 拿 dataKey（todo 有；done/mine 返空，靠 splitPageKey）
+ *   2) splitPageKey(viewcondition + 过滤项 + viewScope) -> 刷新 dataKey（三大分类都靠这步拿 dataKey）
+ *   3) ec/dev/table/datas(dataKey, current=页码) -> 数据行
+ *   4) ec/dev/table/counts(dataKey) -> 总数
+ *
+ * 实跑校准（2026-08-25）：
+ *   - todo: viewScope=doing, complete=0, menuIds=1,13
+ *   - done: viewScope=done,  complete=2, menuIds=1,90（getWfListParams 返空，splitPageKey 拿 dataKey）
+ *   - mine: viewScope=mine,  complete=2, menuIds=1,14
+ *   viewScope/complete/menuIds 来自 HAR 抓包。
+ */
+export const DEFAULT_FILTERS = {
+    defaultTabVal: '0',
+    requestname: '',
+    wfcode: '',
+    workflowid: '',
+    createdateselect: '0',
+    createdatefrom: '',
+    createdateto: '',
+    creatertype: '0',
+    workcode: '',
+    doingStatus: '0',
+    ownerdepartmentid: '',
+    creatersubcompanyid: '',
+    workflowtype: '',
+    requestlevel: '',
+    recievedateselect: '0',
+    recievedatefrom: '',
+    recievedateto: '',
+    wfstatu: '1',
+    nodetype: '',
+    unophrmid: '',
+    docids: '',
+    createrid: '',
+    operatedateselect: '0',
+    operatedatefrom: '',
+    operatedateto: '',
+    archivestatus: '0',
+    secLevel: '',
+    crmids: '',
+    proids: '',
+};
+/** 各分类的 viewScope/complete/menuIds/默认viewcondition（来自 HAR 抓包实跑确认）。
+ *  menuIds 可由 cfg 覆盖：cfg.doneMenuIds/mineMenuIds；viewcondition 可由 opts 覆盖（子 tab）。 */
+export const CATEGORY_SCOPE = {
+    todo: { viewScope: 'doing', complete: '0', menuIdsKey: 'menuIds', defaultViewcondition: '5', fullTab: '0', pageTitle: '待办事宜', countEndpoint: 'doingCountInfo' },
+    done: { viewScope: 'done', complete: '2', menuIdsKey: 'doneMenuIds', defaultMenuIds: '1,90', defaultViewcondition: '10', fullTab: '10', pageTitle: '已办事宜', countEndpoint: 'doneCountInfo' },
+    mine: { viewScope: 'mine', complete: '2', menuIdsKey: 'mineMenuIds', defaultMenuIds: '1,14', defaultViewcondition: '16', fullTab: '16', pageTitle: '我的请求', countEndpoint: 'mineCountInfo' },
+};
+/** 排序字段映射表 */
+const SORT_FIELD_MAP = {
+    "发起时间": "t1.createdate,t1.createtime",
+    "接收时间": "receivedate,receivetime",
+    "流程标题": "t1.requestname",
+    "流程编号": "t1.requestmark",
+    "紧急程度": "t1.requestlevel",
+    "当前节点": "t1.currentnodename",
+    "操作时间": "t1.operatedate,t1.operatetime",
+    "结束时间": "t1.lastoperatedate,t1.lastoperatetime",
+};
+
+export function parseSortSpec(spec) {
+    if (!spec)
+        return '[]';
+    const items = spec.split(",").map(s => s.trim()).filter(Boolean);
+    const arr = items.map(item => {
+        const [field, order] = item.split(":").map(s => s.trim());
+        const orderkey = SORT_FIELD_MAP[field] || field;
+        const sortOrder = order === "asc" ? "ascend" : "descend";
+        return { orderkey, sortOrder };
+    });
+    return JSON.stringify(arr);
+}
+
+/** 时间范围解析 */
+export function parseTimeRange(range) {
+    if (!range)
+        return { from: '', to: '' };
+    const parts = range.trim().split(/\s+/);
+    if (parts.length === 1)
+        return { from: parts[0], to: parts[0] };
+    return { from: parts[0] || "", to: parts[1] || "" };
+}
+/** 日期过滤的预设值（OA reqlist 的 createdateselect/recievedateselect/operatedateselect 共用）：
+ *  0=全部 1=今天 2=本周 3=本月 4=本季 5=本年；自定义区间用 select=0 + from/to。 */
+const DATE_PRESETS = { '全部': '0', '不限': '0', '今天': '1', '本周': '2', '本月': '3', '本季': '4', '本年': '5' };
+/**
+ * 解析日期过滤，返回 { select, from, to }：
+ *  - 预设名（今天/本周/本月/本季/本年/全部/不限）→ select=1~5 或 0，from/to 空；
+ *  - 数字 0~5 → 直接当 select；
+ *  - 日期范围（"YYYY-MM-DD [YYYY-MM-DD]"）→ select='0' + from/to（自定义区间）。
+ */
+export function resolveDateFilter(spec) {
+    const s = String(spec ?? '').trim();
+    if (!s)
+        return { select: '0', from: '', to: '' };
+    if (DATE_PRESETS[s] !== undefined)
+        return { select: DATE_PRESETS[s], from: '', to: '' };
+    if (/^[0-5]$/.test(s))
+        return { select: s, from: '', to: '' };
+    const parts = s.split(/\s+/);
+    return { select: '0', from: parts[0] || '', to: parts[1] || parts[0] || '' };
+}
+
+/** 子分类 viewcondition 映射表 */
+export const TODO_TABS = {
+    "全部": "0", "待处理": "5", "待阅": "6", "被退回": "7",
+    "被督办": "4", "未读": "1", "反馈": "2", "超时": "3", "我的关注": "37",
+};
+
+/** 已办页签（实测 .18 doneBaseInfo.groupinfo；旧表把 17/18 误记成「审批中/已结束」）。 */
+export const DONE_TABS = {
+    "全部": "10", "未归档": "11", "已归档": "12", "待回复": "13",
+    "未读": "14", "反馈": "15", "我的关注": "38",
+};
+
+/** 我发起页签（实测 .18 mineBaseInfo.groupinfo）。 */
+export const MINE_TABS = {
+    "全部": "16", "未归档": "17", "已归档": "18",
+    "未读": "19", "反馈": "20", "我的关注": "39",
+};
+
+export function resolveSubCategory(spec, category) {
+    if (!spec)
+        return undefined;
+    // 直接是数字，直接返回
+    if (/^\d+$/.test(spec))
+        return spec;
+    const map = category === 'todo' ? TODO_TABS : category === 'done' ? DONE_TABS : MINE_TABS;
+    const key = Object.keys(map).find(k => k === spec || k.includes(spec));
+    return key ? map[key] : undefined;
+}
+
+export async function getWfList(cfg, opts) {
+    // 多流程筛选不依赖后端是否支持逗号分隔：分别查询后合并，避免漏结果。
+    const workflowIds = String(opts.workflow ?? '').split(',').map((id) => id.trim()).filter(Boolean);
+    if (!opts._singleWorkflow && workflowIds.length > 1) {
+        const batches = await Promise.all(workflowIds.map((workflow) => getWfList(cfg, { ...opts, workflow, _singleWorkflow: true })));
+        const seen = new Set();
+        const items = batches.flatMap((r) => r.items).filter((item) => {
+            const id = String(item.requestId ?? '');
+            if (!id || seen.has(id))
+                return !id;
+            seen.add(id);
+            return true;
+        });
+        return {
+            category: opts.category ?? 'todo',
+            dataKey: '',
+            items,
+            columns: batches.find((r) => r.columns.length)?.columns ?? [],
+            total: batches.reduce((sum, r) => sum + (Number(r.total) || 0), 0),
+            page: opts.page ?? 1,
+            pageSize: batches.find((r) => r.pageSize)?.pageSize ?? null,
+            multiWorkflow: workflowIds,
+            raw: { batches: batches.map((r) => r.raw) },
+        };
+    }
+    const { page = 1, keyword = '', debug = false, category = 'todo' } = opts;
+    const viewcondition = resolveSubCategory(opts.subCategory, category) ?? opts.viewcondition ?? CATEGORY_SCOPE[category]?.defaultViewcondition ?? '5';
+    const api = await createApiFromProfile(cfg);
+    const scope = CATEGORY_SCOPE[category] ?? CATEGORY_SCOPE.todo;
+    const menuIds = String(cfg[scope.menuIdsKey] ?? scope.defaultMenuIds ?? cfg.menuIds ?? '1,13');
+    const menuPathIds = String(cfg[scope.menuIdsKey] ?? cfg.menuPathIds ?? menuIds);
+    // 1) getWfListParams（todo 返 dataKey；done/mine 返空，靠 splitPageKey）
+    const r1 = await api.post('/api/workflow/reqlist/getWfListParams', buildScopeBody(viewcondition, scope, menuIds, menuPathIds));
+    if (debug)
+        logStep('getWfListParams', r1);
+    // 2) splitPageKey（带过滤项；keyword 进 requestname；done/mine 需带 date2during=0）—— 三大分类都靠这步拿 dataKey
+    const filters = buildFilters(opts);
+    if (category !== 'todo')
+        filters.date2during = '0';
+    const r2 = await api.post('/api/workflow/reqlist/splitPageKey', buildSplitBody(viewcondition, filters, scope, menuIds, menuPathIds));
+    if (debug)
+        logStep('splitPageKey', r2);
+    // dataKey 优先取 splitPageKey 的响应，取不到再回退 getWfListParams
+    let dataKey = extractDataKey(r2.json) ?? extractDataKey(r1.json);
+    if (!dataKey) {
+        throw new Error(`未能从响应中提取 dataKey（category=${category}）。\n` +
+            '用 --raw 查看真实响应，或确认 cookie 是否已过期。\n' +
+            `getWfListParams 响应: ${truncate(r1.text)}\n` +
+            `splitPageKey 响应: ${truncate(r2.text)}`);
+    }
+    // total-only 用于语音/聊天中的快速确认：跳过大结果集的数据请求，只取数量。
+    let r3 = null;
+    if (!opts.totalOnly || opts.excludeCreatorId) {
+        const sortParams = parseSortSpec(opts.sort);
+        r3 = await api.post('/api/ec/dev/table/datas', {
+            dataKey,
+            current: String(page),
+            sortParams,
+            // 显式每页 10 条，与 printTodoItems 的“展示前 10 条”一致，避免 BDIP5 默认 30 条/页导致
+            // --page N 按 30 条跳页、本页第 11~30 条永远看不到、翻页时条数跳变成 30 的错位。
+            pageSize: opts.pageSize ?? '10',
+        });
+        if (debug)
+            logStep('ec/dev/table/datas', r3);
+    }
+    // 4) ec/dev/table/counts（total-only 的唯一数据读取）
+    const r4 = await api.post('/api/ec/dev/table/counts', { dataKey });
+    if (debug)
+        logStep('ec/dev/table/counts', r4);
+    let rows = r3 ? extractRows(r3.json) : [];
+    const columns = r3 ? extractColumns(r3.json) : [];
+    const total = extractTotal(r4.json) ?? (r3 ? extractTotal(r3.json) : null);
+    let pageSize = r3 ? pickNum(r3.json, ['pageSize', 'data.pageSize']) : null;
+    let fetchedPages = r3 ? 1 : 0;
+    // BDIP5 没有“不等于当前创建人”接口。需要排除时必须先拉完整结果集，不能只过滤当前页。
+    if (r3 && opts.excludeCreatorId) {
+        const firstPageRows = page === 1 ? rows : extractRows((await api.post('/api/ec/dev/table/datas', {
+            dataKey, current: '1', sortParams: parseSortSpec(opts.sort), pageSize: '100',
+        })).json);
+        rows = firstPageRows;
+        // 负向筛选固定 100/页全量拉取（下方循环 pageSize:'100'），页数基准不随列表分页 pageSize=10 变化，
+        // 否则 expectedPages 会被放大 10 倍、误触发 500 页安全上限。
+        const effectivePageSize = 100;
+        const expectedPages = Math.ceil((Number(total) || 0) / effectivePageSize);
+        if (expectedPages > 500)
+            throw new Error(`负向筛选需读取 ${expectedPages} 页，超过 500 页安全上限；请先增加其它筛选条件。`);
+        for (let current = 2; current <= expectedPages; current++) {
+            const next = await api.post('/api/ec/dev/table/datas', {
+                dataKey, current: String(current), sortParams: parseSortSpec(opts.sort), pageSize: '100',
+            });
+            const nextRows = extractRows(next.json);
+            rows.push(...nextRows);
+            fetchedPages++;
+            if (!nextRows.length)
+                break;
+        }
+        if (Number(total) > rows.length)
+            throw new Error(`负向筛选未能读取完整列表：服务端共 ${total} 条，实际只取到 ${rows.length} 条。`);
+        pageSize = effectivePageSize;
+    }
+    let items = rows.map((r) => normalizeRow(r, columns));
+    const sourceTotal = total;
+    if (opts.excludeCreatorId)
+        items = items.filter((item) => String(item.creatorId ?? '') !== String(opts.excludeCreatorId));
+    const filteredTotal = opts.excludeCreatorId ? items.length : total;
+    if (opts.totalOnly)
+        items = [];
+    // 待办才取当前处理人（已办/我发起无未操作者概念）
+    if (category === 'todo' && !opts.totalOnly) {
+        try {
+            const datasPayload = JSON.stringify(rows.map((r) => ({
+                requestid: r?.requestid ?? r?.randomField2 ?? '',
+                userid: r?.userid ?? r?.randomField4 ?? '',
+                unoperators: r?.unoperators ?? '',
+            })).filter((d) => d.requestid));
+            const r5 = await api.post('/api/workflow/reqlist/getUnoperators', {
+                datas: datasPayload, actiontype: 'batch', showAll: 'false', dataKey,
+            });
+            const opsMap = r5.json ?? {};
+            for (const row of rows) {
+                const uid = String(row?.userid ?? row?.randomField4 ?? '');
+                const rid = String(row?.requestid ?? row?.randomField2 ?? '');
+                const key = `${uid}${rid}loding`;
+                const item = items.find((candidate) => String(candidate.requestId ?? '') === rid);
+                if (item && opsMap[key])
+                    item.currentOperator = stripHtml(opsMap[key]).replace(/\s+/g, ' ').trim() || undefined;
+            }
+        }
+        catch { /* 取处理人失败不影响主列表 */ }
+    }
+    return {
+        category,
+        dataKey,
+        items,
+        columns,
+            total: filteredTotal,
+            sourceTotal,
+            page,
+            pageSize,
+            fetchedPages,
+            excludedCreatorId: opts.excludeCreatorId || undefined,
+        raw: { getWfListParams: r1.json, splitPageKey: r2.json, datas: r3?.json ?? null, counts: r4.json },
+    };
+}
+
+/**
+ * 面向用户的待办概览：把需要本人处理、转发/抄送和关注拆开显示。
+ * 每个分类独立分页；同一 requestId 只保留在优先级更高的分类，避免重复打扰用户。
+ */
+export async function getSmartTodoGroups(cfg, opts = {}) {
+    const groupDefs = [
+        { key: 'action', title: '需您亲自处理', subCategory: '待处理' },
+        { key: 'forwarded', title: '转发和抄送给您的流程', subCategory: '转发' },
+        { key: 'following', title: '您关注的流程', subCategory: '关注' },
+    ];
+    const results = await Promise.all(groupDefs.map(async (group) => ({
+        ...group,
+        result: await getWfList(cfg, { ...opts, category: 'todo', subCategory: group.subCategory, _singleWorkflow: false }),
+    })));
+    return mergeSmartTodoGroups(results, opts.page ?? 1);
+}
+
+/** 纯函数，便于测试分组去重规则。 */
+export function mergeSmartTodoGroups(results, page = 1) {
+    const seen = new Set();
+    const groups = results.map((group) => ({
+        ...group,
+        items: group.result.items.filter((item) => {
+            const id = String(item.requestId ?? '');
+            if (!id || seen.has(id))
+                return !id;
+            seen.add(id);
+            return true;
+        }),
+    }));
+    return {
+        groups,
+        actionTotal: Number(groups.find((group) => group.key === 'action')?.result?.total) || 0,
+        categoryTotals: Object.fromEntries(groups.map((group) => [group.key, Number(group.result.total) || 0])),
+        // 仅用于诊断，名称明确说明是分类相加，绝不能称为“待处理总数”。
+        categoryTotalSum: groups.reduce((sum, group) => sum + (Number(group.result.total) || 0), 0),
+        page,
+    };
+}
+
+// ─── 按 OA 二级分类页签分组（待办/已办/我发起通用）────────────
+
+/** 内置页签表（CountInfo 不返回 topTab 时回退；实测仅待办返回 topTab，已办/我发起均不返回）。 */
+function builtinTabs(category) {
+    const map = category === 'done' ? DONE_TABS : category === 'mine' ? MINE_TABS : TODO_TABS;
+    return Object.entries(map).map(([title, viewcondition]) => ({ title, viewcondition: String(viewcondition), groupid: '' }));
+}
+
+/**
+ * 取 OA 二级分类页签清单（三级数据源，逐级回退）：
+ *   ① {scope}CountInfo.topTab——**只有待办返回**（实测 .18）；附带各页签计数 totalcount[groupid]。
+ *   ② {scope}BaseInfo.groupinfo——**已办/我发起的唯一来源**（实测 .18：done 7 个页签、mine 6 个）；无计数。
+ *   ③ 内置页签名表（网络异常时的兜底）；无计数。
+ * 已剔除「全部」页签——它是其它所有页签的并集，单列会吞掉全部分类。
+ */
+export async function getOaTabs(cfg, category) {
+    const scope = CATEGORY_SCOPE[category] ?? CATEGORY_SCOPE.todo;
+    const menuIds = String(cfg[scope.menuIdsKey] ?? scope.defaultMenuIds ?? cfg.menuIds ?? '1,13');
+    const menuPathIds = String(cfg[scope.menuIdsKey] ?? cfg.menuPathIds ?? menuIds);
+    const mapTab = (t) => ({ title: String(t?.title ?? ''), viewcondition: String(t?.viewcondition ?? ''), groupid: String(t?.groupid ?? '') });
+    let tabs = [];
+    let counts = {};
+    let source = 'builtin';
+    const api = await createApiFromProfile(cfg);
+    // ① CountInfo.topTab（待办有；已办/我发起实测不返回）
+    try {
+        const r = await api.post(`/api/workflow/reqlist/${scope.countEndpoint}`, buildScopeBody(scope.defaultViewcondition, scope, menuIds, menuPathIds));
+        const j = r.json ?? {};
+        counts = j.totalcount ?? {};
+        tabs = (j.topTab ?? []).map(mapTab).filter((t) => t.title && t.viewcondition !== '');
+        if (tabs.length)
+            source = 'countinfo';
+    }
+    catch { /* 落到下一级 */ }
+    // ② BaseInfo.groupinfo（已办/我发起的权威来源）
+    if (!tabs.length) {
+        try {
+            const r = await api.post(`/api/workflow/reqlist/${scope.viewScope}BaseInfo`, buildScopeBody(scope.defaultViewcondition, scope, menuIds, menuPathIds));
+            tabs = (r.json?.groupinfo ?? []).map(mapTab).filter((t) => t.title && t.viewcondition !== '');
+            if (tabs.length)
+                source = 'baseinfo';
+        }
+        catch { /* 落到下一级 */ }
+    }
+    // ③ 内置表兜底
+    if (!tabs.length)
+        tabs = builtinTabs(category);
+    return { tabs: tabs.filter((t) => t.viewcondition !== String(scope.fullTab)), counts, scope, source };
+}
+
+/**
+ * 按 OA 页签分组取数：每个页签独立查询、并发执行，同一 requestId 只保留在靠前的页签里（避免重复推荐）。
+ * 只列有数据的分类：计数已知且为 0 的页签直接跳过（不查询）；查完 total=0 的也不展示。
+ */
+export async function getOaTabGroups(cfg, opts = {}) {
+    const category = opts.category ?? 'todo';
+    const { tabs, counts } = await getOaTabs(cfg, category);
+    const results = await Promise.all(tabs.map(async (tab) => {
+        const known = tab.groupid && counts[tab.groupid] !== undefined ? Number(counts[tab.groupid]) : NaN;
+        if (Number.isFinite(known) && known === 0)
+            return null; // 计数已知为 0 → 不查询
+        const result = await getWfList(cfg, { ...opts, category, subCategory: tab.viewcondition, _singleWorkflow: false });
+        return { tab, result };
+    }));
+    const seen = new Set();
+    const groups = [];
+    for (const entry of results) {
+        if (!entry)
+            continue;
+        const { tab, result } = entry;
+        if (!result.total)
+            continue; // 无数据不展示
+        const items = result.items.filter((item) => {
+            const id = String(item.requestId ?? '');
+            if (!id || seen.has(id))
+                return !id;
+            seen.add(id);
+            return true;
+        });
+        groups.push({ key: tab.viewcondition, title: tab.title, viewcondition: tab.viewcondition, total: result.total, items, result: { ...result, items } });
+    }
+    return {
+        category,
+        page: opts.page ?? 1,
+        groups,
+        categoryTotals: Object.fromEntries(groups.map((g) => [g.viewcondition, Number(g.total) || 0])),
+        // 仅用于诊断：各分类相加（页签间有交集，绝不能称为“总数”）
+        categoryTotalSum: groups.reduce((sum, g) => sum + (Number(g.total) || 0), 0),
+    };
+}
+
+/** 解析 doingBaseInfo.treedata 中的流程类型节点。 */
+export function parseWorkflowTypes(tree) {
+    const out = [];
+    const visit = (node, path = []) => {
+        if (Array.isArray(node)) {
+            node.forEach((item) => visit(item, path));
+            return;
+        }
+        if (!node || typeof node !== 'object')
+            return;
+        const name = stripHtml(node.name ?? node.title ?? node.label ?? '').trim();
+        const domid = String(node.domid ?? node.domId ?? '');
+        const id = domid.startsWith('type_') ? domid.slice(5) : (node.type === 'type' ? String(node.key ?? node.id ?? '') : '');
+        const nextPath = name ? [...path, name] : path;
+        if (id)
+            out.push({ id, name, path: nextPath.join(' / ') });
+        for (const key of ['childs', 'children', 'nodes', 'data'])
+            if (node[key]) visit(node[key], nextPath);
+    };
+    visit(tree);
+    return [...new Map(out.filter((item) => item.name).map((item) => [item.id, item])).values()];
+}
+
+export function matchWorkflowTypes(types, spec) {
+    const q = String(spec ?? '').trim().toLowerCase();
+    if (!q)
+        return [];
+    const ranked = types.map((item) => {
+        const name = String(item.name ?? '').trim().toLowerCase();
+        const score = name === q ? 3 : name.startsWith(q) ? 2 : name.includes(q) ? 1 : 0;
+        return { ...item, score };
+    }).filter((item) => item.score > 0);
+    return ranked.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name, 'zh-CN'));
+}
+
+export async function getWorkflowTypes(cfg, opts = {}) {
+    const category = opts.category ?? 'todo';
+    const scope = CATEGORY_SCOPE[category] ?? CATEGORY_SCOPE.todo;
+    const viewcondition = opts.viewcondition ?? scope.defaultViewcondition;
+    const menuIds = String(cfg[scope.menuIdsKey] ?? scope.defaultMenuIds ?? cfg.menuIds ?? '1,13');
+    const menuPathIds = String(cfg[scope.menuIdsKey] ?? cfg.menuPathIds ?? menuIds);
+    const api = await createApiFromProfile(cfg);
+    const response = await api.post('/api/workflow/reqlist/doingBaseInfo', {
+        ...buildScopeBody(viewcondition, scope, menuIds, menuPathIds), actiontype: 'baseinfo',
+    });
+    return { items: parseWorkflowTypes(response.json?.treedata ?? response.json?.data?.treedata), raw: response.json };
+}
+
+export async function resolveWorkflowType(cfg, spec, opts = {}) {
+    if (/^\d+$/.test(String(spec ?? '').trim()))
+        return { id: String(spec).trim(), name: String(spec).trim(), candidates: [] };
+    const result = await getWorkflowTypes(cfg, opts);
+    const candidates = matchWorkflowTypes(result.items, spec);
+    if (candidates.length === 1 || (candidates[0]?.score === 3 && candidates[1]?.score !== 3))
+        return { ...candidates[0], candidates };
+    if (!candidates.length)
+        throw new Error(`找不到流程类型“${spec}”。`);
+    const error = new Error(`流程类型“${spec}”匹配到多项，请指定类型 ID：\n${candidates.map((item) => `- ${item.name} [${item.id}]`).join('\n')}`);
+    error.candidates = candidates;
+    throw error;
+}
+
+/** 从 opts 构造 DEFAULT_FILTERS 覆盖 */
+function buildFilters(opts) {
+    const f = { ...DEFAULT_FILTERS, requestname: opts.keyword ?? '' };
+    if (opts.workflow)
+        f.workflowid = opts.workflow;
+    if (opts.creator)
+        f.createrid = opts.creator;
+    if (opts.creatorDept)
+        f.ownerdepartmentid = opts.creatorDept;
+    if (opts.creatorSubcom)
+        f.creatersubcompanyid = opts.creatorSubcom;
+    if (opts.createTime) {
+        const ct = resolveDateFilter(opts.createTime);
+        f.createdateselect = ct.select;
+        f.createdatefrom = ct.from;
+        f.createdateto = ct.to;
+    }
+    if (opts.receiveTime) {
+        const rt = resolveDateFilter(opts.receiveTime);
+        f.recievedateselect = rt.select;
+        f.recievedatefrom = rt.from;
+        f.recievedateto = rt.to;
+    }
+    if (opts.operateTime) {
+        const ot = resolveDateFilter(opts.operateTime);
+        f.operatedateselect = ot.select;
+        f.operatedatefrom = ot.from;
+        f.operatedateto = ot.to;
+    }
+    if (opts.requestLevel)
+        f.requestlevel = opts.requestLevel;
+    if (opts.requestMark)
+        f.wfcode = opts.requestMark;
+    if (opts.workflowType)
+        f.workflowtype = opts.workflowType;
+    if (opts.nodeId)
+        f.nodetype = opts.nodeId;
+    if (opts.flowStatus)
+        f.wfstatu = opts.flowStatus;
+    return f;
+}
+function pickNum(obj, paths) {
+    const v = pickByPaths(obj, paths);
+    if (typeof v === 'number')
+        return v;
+    if (typeof v === 'string' && /^\d+$/.test(v))
+        return parseInt(v, 10);
+    return null;
+}
+/** getWfListParams 的提交体（按分类的 viewScope/complete）。 */
+function buildScopeBody(viewcondition, scope, menuIds, menuPathIds) {
+    return {
+        method: 'all',
+        offical: '',
+        officalType: '-1',
+        hideNoDataTab: 'false',
+        viewScope: scope.viewScope,
+        complete: scope.complete,
+        viewcondition,
+        menuIds,
+        menuPathIds,
+    };
+}
+/**
+ * splitPageKey 的提交体（带过滤项 + 分类 viewScope）。直接构造 Record，值保持原样——
+ * 由 api.post 的 URLSearchParams 统一单次编码，避免二次编码 bug。
+ */
+export function buildSplitBody(viewcondition, filters, scope, menuIds, menuPathIds) {
+    return {
+        method: 'all',
+        offical: '',
+        officalType: '-1',
+        hideNoDataTab: 'false',
+        viewScope: scope.viewScope,
+        complete: scope.complete,
+        viewcondition,
+        ...filters,
+        menuIds,
+        menuPathIds,
+        actiontype: 'splitpage',
+    };
+}
+/** @deprecated 用 buildScopeBody 替代（保留向后兼容）。 */
+export function buildGetWfListParamsBody(viewcondition, cfg) {
+    return buildScopeBody(viewcondition, CATEGORY_SCOPE.todo, String(cfg.menuIds), String(cfg.menuPathIds ?? cfg.menuIds));
+}
+function logStep(name, r) {
+    console.error(`[debug] ${name} -> status=${r.status} json=${r.json ? 'yes' : 'no'} len=${r.text.length}`);
+}
+function truncate(s, n = 300) {
+    if (!s)
+        return '(空)';
+    return s.length > n ? s.slice(0, n) + '…(已截断)' : s;
+}