weaver-e9-assistant-cli 1.1.4 → 1.1.11

package/dist/util.js

@@ -17,6 +17,27 @@ export function nowTimeStr() {
 export function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));
 }
+/**
+ * 并发受限的 map：保持返回顺序与 items 一致，最多 limit 个任务同时执行。
+ * 用于组织树/多页数据等「彼此独立但数量可能很大」的请求，避免串行排队拖慢，
+ * 也避免一次性打满服务端。
+ */
+export async function mapLimit(items, limit, fn) {
+    const list = Array.from(items ?? []);
+    const results = new Array(list.length);
+    const max = Math.max(1, Number(limit) || 1);
+    let next = 0;
+    const worker = async () => {
+        while (true) {
+            const i = next++;
+            if (i >= list.length)
+                return;
+            results[i] = await fn(list[i], i);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(max, list.length) }, worker));
+    return results;
+}
 /** 非空字符串化：null/undefined/'' → undefined，否则 String(v)。 */
 export function stringify(v) {
     if (v === undefined || v === null || v === '')

package/dist/wfagent.js

@@ -0,0 +1,538 @@
+/**
+ * E9 流程代理（workflow agent）模块。
+ *
+ * 链路（HAR 抓包实证 2026-10-14 `workflow流程代理.har` + 实跑校准）：
+ *   1) POST /api/workflow/agent/getList            body{agented,agentFlag,+过滤项,current} → sessionkey（**恒顶层**）
+ *   2) POST /api/ec/dev/table/datas                body{dataKey=sessionkey,current,sortParams,pageSize} → columns + datas
+ *   3) POST /api/ec/dev/table/counts               body{dataKey} → {count}
+ *   4) POST /api/workflow/agent/getSearchCondition body{agented,agentFlag,menuIds,menuPathIds} → 查询条件定义（含 SELECT options）
+ *   5) POST /api/workflow/agent/getAddAgentInfo    body{symbol:'addAgent'} → {formValue,fields}（取默认被代理人）
+ *   6) POST /api/workflow/agent/agentTemplateList  body{name,workflowid,agenterid,current} → sessionkey → 同 2/3 步
+ *   7) POST /api/workflow/agent/verifyAgentOverlap body{保存体+method} → {overlapIds,overlapCount}
+ *   8) POST /api/workflow/agent/saveAgentTemplate  body{保存体+templatename} → {api_status:true}
+ *   9) POST /api/workflow/agent/addAgentSave       body{保存体+method} → {agentresult:'success'}
+ *  10) POST /api/workflow/agent/getAgentDetail     body{agentid,symbol:'edit'} → {agentid,datas,formValue,wfInfo,...}（编辑取详情）
+ *  11) POST /api/workflow/agent/saveAgentDetail    body{详情回吐体} → {agentresult:'success'}（编辑保存）
+ *  12) POST /api/workflow/agent/takeBackAgent      body{symbol:'it',agentid} / {symbol:'pt',agentid,bagentuid} → {flag:true}（收回）
+ *  13) POST /api/workflow/agent/getBatchEditInfo   body 空 → {fields}（批量编辑弹窗字段：仅起止日期/时间）
+ *  14) POST /api/workflow/agent/saveBatchEditInfo  body{method:'editBatch',agentids,起止日期/时间} → {agentresult:'success'}（批量改期）
+ *
+ * 保存链路顺序（抓包实证）：saveAgentTemplate（可选）→ verifyAgentOverlap → addAgentSave；
+ * 编辑同理：verifyAgentOverlap → saveAgentDetail。
+ *
+ * 三视图 agented × agentFlag（2026-10-14 实跑核实总数 2 / 67 / 20）：
+ *   mine    agented=0 agentFlag=0  我设置的代理
+ *   all     agented=0 agentFlag=1  全部代理设置（多一列 beagenterid）
+ *   records agented=1 agentFlag=0  代理办理记录（代理产生的流程，行带 requestname/requestid）
+ *
+ * ⚠️ 未实现（E9 有这些接口、但**未抓到包**，不猜参数）：
+ *   deleteAgentTemplate（模板删除）、takeBackPromptMsg（收回前提示）。
+ * ⚠️ **一行 = 一个流程**：`workflow_agent` 表带 `workflowid` 列（表结构实证），
+ *   抓包里的 `rangetype=567,531`（2 个流程）也确实落成 2 行。
+ *   因此 `agentrange=2`（全部流程）会**为每个流程各建一条**——2026-10-14 实测本环境一次建出 466 条！
+ *   只想试一条务必用 `--workflow <单个流程id>`。
+ *
+ * 四个开关语义（2026-10-14 用 `workflow_agent` 表结构校准，非推测）：
+ *   isCreateAgenter    → iscreateagenter 「是否代理创建权限」
+ *   isProxyDeal        → isproxydeal     「流转中的待办事宜」
+ *   isPendThing        → ispending       「是否要把待办事宜转给代理人」
+ *   isSysCreateAgenter → isSysCreateAgenter「系统创建代理标记」
+ *   默认值 1 照抄抓包样本，可用命令行覆盖。
+ */
+import { endpointFor } from './config.js';
+import { createApiFromProfile } from './client.js';
+import { extractRows, extractColumns, extractTotal, pickByPaths, stripHtml } from './parse.js';
+
+/** 流程代理菜单 id（抓包实证：menuIds=1,86）。 */
+const WFAGENT_MENU = { menuIds: '1,86', menuPathIds: '1,86' };
+
+/** 视图 → agented/agentFlag（实跑核实）。 */
+export const WFAGENT_VIEWS = {
+    mine: { agented: '0', agentFlag: '0', title: '我设置的代理' },
+    all: { agented: '0', agentFlag: '1', title: '全部代理设置' },
+    records: { agented: '1', agentFlag: '0', title: '代理办理记录' },
+};
+
+/** 代理状态筛选（getSearchCondition 的 options 实证）。 */
+export const WFAGENT_STATUS = {
+    '全部': '0', '未结束': '1', '未开始': '2', '代理中': '3', '收回中': '5', '已结束': '4',
+};
+
+/** 视图名 → 视图定义；接受 mine/all/records 或中文别名，未知返回 undefined。 */
+export function resolveView(spec) {
+    const s = String(spec ?? '').trim();
+    if (!s)
+        return 'mine';
+    const low = s.toLowerCase();
+    if (WFAGENT_VIEWS[low])
+        return low;
+    if (/^[012]$/.test(s))
+        return undefined; // 视图不是一个数字，别误判
+    if (/代理办理|办理记录|记录|日志/.test(s))
+        return 'records';
+    if (/全部|所有/.test(s))
+        return 'all';
+    if (/我的|我设置|自己/.test(s))
+        return 'mine';
+    return undefined;
+}
+
+/**
+ * 状态名 → agentstatus 值；接受中文名或数字直传，空返回 ''。
+ * ⚠️ 空串（不传 agentstatus）时服务端返回的是**全部**（含已结束），**不是** OA 表单默认的「未结束」（实测）。
+ */
+export function resolveStatus(spec) {
+    const s = String(spec ?? '').trim();
+    if (!s)
+        return '';
+    if (/^\d+$/.test(s))
+        return s;
+    const key = Object.keys(WFAGENT_STATUS).find((k) => k === s || k.includes(s));
+    return key ? WFAGENT_STATUS[key] : undefined;
+}
+
+/**
+ * 组装保存体（verifyAgentOverlap / addAgentSave 通用）。**纯函数**，便于单测。
+ * agentrange：1=选择（配合 rangetype 流程列表）/ 2=全部（getAddAgentInfo.fields.agentrange.options 实证）；
+ * 未指定流程 → 全部。
+ * 必填缺失/范围为空时抛错（写操作宁可不出手）。
+ */
+export function buildAgentBody(opts = {}) {
+    const agentUid = String(opts.agentUid ?? '').trim();
+    const beAgentUid = String(opts.beAgentUid ?? '').trim();
+    const beginDate = String(opts.beginDate ?? '').trim();
+    const endDate = String(opts.endDate ?? '').trim();
+    if (!agentUid)
+        throw new Error('缺少代理人（--agent）。');
+    if (!beAgentUid)
+        throw new Error('缺少被代理人（--be-agent）。');
+    if (!beginDate || !endDate)
+        throw new Error('缺少代理起止日期（--begin / --end，YYYY-MM-DD）。');
+    const workflowIds = String(opts.workflowIds ?? '').split(',').map((s) => s.trim()).filter(Boolean);
+    const wantAll = opts.range === undefined || opts.range === null || opts.range === ''
+        ? workflowIds.length === 0
+        : /^(全部|所有|all)$/i.test(String(opts.range));
+    const agentrange = wantAll ? '2' : '1';
+    if (agentrange === '1' && workflowIds.length === 0)
+        throw new Error('agentrange=选择 但没有流程范围：请给 --workflow <流程id,id> 或改用 --range 全部。');
+    // 四个开关：默认 1（照抄抓包样本）；语义未校准，见文件头。
+    const sw = (v) => (v === undefined || v === null || v === '' ? '1' : String(v));
+    return {
+        method: 'add',
+        beginDate,
+        endDate,
+        isCreateAgenter: sw(opts.isCreateAgenter),
+        isProxyDeal: sw(opts.isProxyDeal),
+        rangetype: agentrange === '1' ? workflowIds.join(',') : '',
+        bagentuid: beAgentUid,
+        agentuid: agentUid,
+        beginTime: String(opts.beginTime ?? ''),
+        endTime: String(opts.endTime ?? ''),
+        isSysCreateAgenter: sw(opts.isSysCreateAgenter),
+        isPendThing: sw(opts.isPendThing),
+        agentrange,
+    };
+}
+
+/**
+ * 代理列表。getList → table/datas → table/counts（同待办 table 链路）。
+ * opts: { view, status, agent, beAgent, wftype, workflowPath, beginFrom/beginTo, endFrom/endTo, dept, subcom, page, pageSize }
+ */
+export async function getAgentList(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const view = WFAGENT_VIEWS[opts.view ?? 'mine'] ?? WFAGENT_VIEWS.mine;
+    const page = Number(opts.page ?? '1') || 1;
+    const body = {
+        bagentuid: opts.beAgent ?? '',
+        agentuid: opts.agent ?? '',
+        wftype: opts.wftype ?? '',
+        wfidbytype: opts.workflowPath ?? '',
+        // selectXXXDate：0=全部 / 1=今天 / 2=本周 / … / 6=指定日期范围（getSearchCondition 的 options 实证）
+        // ⚠️ 给了显式起止日期必须用 6（曾误用 1=今天，会静默筛成"今天"）
+        selectBeginDate: opts.beginFrom ? '6' : '0',
+        begindatefrom: opts.beginFrom ?? '',
+        begindateto: opts.beginTo ?? opts.beginFrom ?? '',
+        selectEndDate: opts.endFrom ? '6' : '0',
+        enddatefrom: opts.endFrom ?? '',
+        enddateto: opts.endTo ?? opts.endFrom ?? '',
+        agentstatus: opts.status ?? '',
+        aiddepartmentid: opts.dept ?? '',
+        aidsubcompanyid: opts.subcom ?? '',
+        current: String(page),
+        agented: view.agented,
+        agentFlag: view.agentFlag,
+    };
+    const r1 = await api.post('/api/workflow/agent/getList', body);
+    const sessionkey = pickByPaths(r1.json, ['sessionkey', 'data.sessionkey']);
+    if (!sessionkey)
+        throw new Error(`未拿到代理列表 sessionkey（getList 响应：${(r1.text ?? '').slice(0, 200)}）`);
+    const r2 = await api.post('/api/ec/dev/table/datas', { dataKey: sessionkey, current: String(page), sortParams: '[]', pageSize: String(opts.pageSize ?? '10') });
+    const columns = extractColumns(r2.json);
+    const items = extractRows(r2.json).map((row) => normalizeAgentRow(row, columns));
+    let total = null;
+    let countsRaw = null;
+    try {
+        const r3 = await api.post('/api/ec/dev/table/counts', { dataKey: sessionkey });
+        countsRaw = r3.json;
+        total = extractTotal(r3.json);
+    }
+    catch { /* counts 失败不阻断 */ }
+    let pageSize = pickByPaths(r2.json, ['pageSize', 'data.pageSize']);
+    if (typeof pageSize !== 'number' && /^\d+$/.test(String(pageSize ?? '')))
+        pageSize = parseInt(String(pageSize), 10);
+    return { view: opts.view ?? 'mine', viewTitle: view.title, page, total, pageSize: pageSize ?? null, items, sessionkey, columns, raw: { getList: r1.json, datas: r2.json, counts: countsRaw } };
+}
+
+/**
+ * 规范化一行代理数据（可读值优先取 `<field>span`，回退原值）。
+ * mine/all 视图给的是代理配置（代理人/被代理人/流程路径/起止/状态）；
+ * records 视图给的是代理产生的流程（标题/当前节点/经办人）。
+ */
+export function normalizeAgentRow(row, columns) {
+    if (!row || typeof row !== 'object')
+        return {};
+    void columns;
+    const get = (keys) => pickByPaths(row, keys);
+    const spanOr = (k, extra = []) => stripHtml(get([`${k}span`, k, ...extra]));
+    return {
+        // 代理配置（mine / all）
+        agentId: String(get(['randomField0', 'agentid']) ?? ''),
+        agent: spanOr('agenterid', ['agentname']),
+        agentUid: String(get(['agenterid']) ?? ''),
+        beAgent: spanOr('beagenterid', ['bagentuid']),
+        beAgentUid: String(get(['beagenterid', 'randomField1', 'bagentuid']) ?? ''),
+        operator: spanOr('operatorid', ['operator']),
+        workflowType: spanOr('workflowtype'),
+        workflowName: spanOr('workflowname'),
+        beginDate: spanOr('beginDate'),
+        endDate: spanOr('endDate'),
+        status: spanOr('agenttype'),
+        // 原始状态码：1=有效（配合起止日期再渲染成「未开始」/「代理中」）/ 0=已结束。
+        // ⚠️ 收回(@see takeBackAgent)是**把 agenttype 置 0**，行**不会从列表消失**——核验必须看这个码。
+        statusCode: String(get(['agenttype']) ?? ''),
+        // 代理办理记录（records）
+        requestId: String(get(['randomFieldId', 'randomField2']) ?? ''),
+        title: stripHtml(get(['requestnamespan'])) || String(get(['requestname']) ?? ''),
+        node: stripHtml(get(['currentnodeidspan', 'currentnodespan'])) || String(get(['currentnodeid']) ?? ''),
+        handler: spanOr('userid', ['username']),
+        principal: spanOr('agentorbyagentid'),
+        creator: spanOr('creater'),
+        createTime: spanOr('createdate', ['createtime']),
+        // ⚠️ 只认 workflowid：mine/all 视图的 randomField0 是**代理记录 id**，不能当流程 id 用
+        workflowId: String(get(['workflowid']) ?? ''),
+        raw: row,
+    };
+}
+
+/** 规范化一行代理模板（列：name/workflowrange/agenterid/randomFieldId，抓包实证）。 */
+export function normalizeTemplateRow(row) {
+    if (!row || typeof row !== 'object')
+        return {};
+    const get = (keys) => pickByPaths(row, keys);
+    const spanOr = (k, extra = []) => stripHtml(get([`${k}span`, k, ...extra]));
+    return {
+        templateId: String(get(['randomFieldId']) ?? ''),
+        name: stripHtml(get(['namespan'])) || String(get(['name']) ?? ''),
+        workflowRange: spanOr('workflowrange') || '',
+        agent: spanOr('agenterid'),
+        agentUid: String(get(['agenterid']) ?? ''),
+        raw: row,
+    };
+}
+
+/** 代理列表查询条件定义。POST /api/workflow/agent/getSearchCondition */
+export async function getAgentConditions(cfg, opts = {}) {
+    const view = WFAGENT_VIEWS[opts.view ?? 'mine'] ?? WFAGENT_VIEWS.mine;
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/getSearchCondition', { agented: view.agented, agentFlag: view.agentFlag, ...WFAGENT_MENU });
+    const j = r.json ?? {};
+    const groups = (j.condition ?? []).map((g) => ({
+        title: String(g.title ?? ''),
+        items: (g.items ?? []).map((it) => ({
+            label: String(it.label ?? ''),
+            domkey: Array.isArray(it.domkey) ? it.domkey.join(',') : String(it.domkey ?? ''),
+            type: String(it.conditionType ?? ''),
+            options: (it.options ?? []).map((o) => ({ key: String(o.key ?? ''), name: String(o.showname ?? '') })),
+        })),
+    }));
+    return { groups, raw: j };
+}
+
+/** 新建代理表单初始值。POST /api/workflow/agent/getAddAgentInfo（取默认被代理人 = 当前登录人）。 */
+export async function getAddAgentInfo(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/getAddAgentInfo', { symbol: 'addAgent' });
+    const j = r.json ?? {};
+    const fv = j.formValue ?? {};
+    const field = (k) => j.fields?.[k] ?? {};
+    return {
+        defaultBeAgentUid: String(fv.bagentuid?.value ?? ''),
+        defaultBeAgent: String(fv.bagentuid?.valueSpan ?? ''),
+        // agentrange 选项（1=选择 / 2=全部）
+        rangeOptions: (field('agentrange').options ?? []).map((o) => ({ key: String(o.key ?? ''), name: String(o.showname ?? '') })),
+        raw: j,
+    };
+}
+
+/** 代理模板列表（agentTemplateList → 同 3 步链路）。 */
+export async function listAgentTemplates(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const page = Number(opts.page ?? '1') || 1;
+    const r1 = await api.post('/api/workflow/agent/agentTemplateList', {
+        name: opts.name ?? '', workflowid: opts.workflowId ?? '', agenterid: opts.agentUid ?? '', current: String(page),
+    });
+    const sessionkey = pickByPaths(r1.json, ['sessionkey', 'data.sessionkey']);
+    if (!sessionkey)
+        throw new Error(`未拿到代理模板 sessionkey（agentTemplateList 响应：${(r1.text ?? '').slice(0, 200)}）`);
+    const r2 = await api.post('/api/ec/dev/table/datas', { dataKey: sessionkey, current: String(page), sortParams: '[]', pageSize: String(opts.pageSize ?? '10') });
+    const columns = extractColumns(r2.json);
+    const items = extractRows(r2.json).map((row) => normalizeTemplateRow(row));
+    let total = null;
+    try {
+        total = extractTotal((await api.post('/api/ec/dev/table/counts', { dataKey: sessionkey })).json);
+    }
+    catch { /* counts 失败不阻断 */ }
+    return { page, total, items, columns, sessionkey, raw: { agentTemplateList: r1.json, datas: r2.json } };
+}
+
+/** 重叠校验（保存前）。POST /api/workflow/agent/verifyAgentOverlap → {overlapIds, overlapCount} */
+export async function verifyOverlap(cfg, body) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/verifyAgentOverlap', body);
+    const j = r.json ?? {};
+    return { overlapIds: String(j.overlapIds ?? ''), overlapCount: Number(j.overlapCount ?? 0) || 0, raw: j };
+}
+
+/** 存为模板（可选步骤）。POST /api/workflow/agent/saveAgentTemplate → {api_status:true} */
+export async function saveAgentTemplate(cfg, body, templateName) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/saveAgentTemplate', { ...body, templatename: String(templateName ?? '') });
+    return { ok: r.json?.api_status === true, raw: r.json };
+}
+
+/**
+ * 收回代理。POST /api/workflow/agent/takeBackAgent → {flag:true}
+ *
+ * 参数（2026-10-14 用户在 OA 点「收回此条代理」抓包实证）：
+ *   `symbol=it`（**必带**，就是它把单条收回与其它语义区分开）+ `agentid`（代理记录 id）+ `backRunning`（1=连流转中的一并收回）。
+ *   ⚠️ 只传 `agentid` 会返回 `{flag:true}` 但**毫无效果**——失败静默，务必回读核验。
+ *
+ * 一次一条（UI 也是逐条发），多条循环发；每条都带 `symbol=it`。
+ * 与 doSupervise 同款闸门：未传 opts.send 只回显不执行（由 CLI 负责打印预览）。
+ */
+export async function takeBackAgent(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const agentIds = String(opts.agentIds ?? '').split(',').map((s) => s.trim()).filter(Boolean);
+    if (!agentIds.length)
+        throw new Error('takeBackAgent 需要代理记录 id（--agent-ids "69,70"，即列表里的「代理id」）。');
+    const backRunning = opts.backRunning === undefined || opts.backRunning === '' ? '1' : String(opts.backRunning);
+    if (!opts.send)
+        return { sent: false, endpoint: { baseUrl: ep.baseUrl }, agentIds, backRunning };
+    const api = await createApiFromProfile(cfg);
+    const results = [];
+    for (let i = 0; i < agentIds.length; i++) {
+        const agentId = agentIds[i];
+        if (opts.onProgress)
+            opts.onProgress(i + 1, agentIds.length, agentId);
+        let flag = false;
+        let raw = null;
+        try {
+            const r = await api.post('/api/workflow/agent/takeBackAgent', { symbol: 'it', agentid: agentId, backRunning });
+            raw = r.json;
+            flag = r.json?.flag === true;
+        }
+        catch (e) {
+            raw = { error: e.message };
+        }
+        results.push({ agentId, flag, raw });
+    }
+    return { sent: true, endpoint: { baseUrl: ep.baseUrl }, agentIds, backRunning, results, okCount: results.filter((r) => r.flag).length };
+}
+
+/**
+ * 取代理详情（编辑用）。POST /api/workflow/agent/getAgentDetail（body `agentid` + `symbol=edit`）
+ * → `{agentid, datas:[{...各行字段...}], formValue:{各顶层字段的当前值}, wfInfo, fields, isE9Rule, hrmBrowserParam}`。
+ * ⚠️ 编辑不是"重新填一张表"，而是**取详情 → 改字段 → 原样回吐**（见 buildAgentEditBody）。
+ */
+export async function getAgentDetail(cfg, agentId) {
+    const id = String(agentId ?? '').trim();
+    if (!id)
+        throw new Error('取代理详情需要代理记录 id（列表里的「代理id」）。');
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/getAgentDetail', { agentid: id, symbol: 'edit' });
+    return parseAgentDetail(r.json ?? {}, id);
+}
+
+/** 纯函数：把 getAgentDetail 响应归一化为 `{agentId, current, rows, raw}`（便于单测与复用）。 */
+export function parseAgentDetail(json, fallbackId = '') {
+    const j = json ?? {};
+    const fv = j.formValue ?? {};
+    const rows = Array.isArray(j.datas) ? j.datas : [];
+    if (!rows.length)
+        throw new Error(`代理详情为空（agentid=${fallbackId || j.agentid}）——该条可能已不存在。`);
+    return {
+        agentId: String(j.agentid ?? fallbackId),
+        current: {
+            beginDate: String(fv.beginDate?.value ?? ''),
+            endDate: String(fv.endDate?.value ?? ''),
+            beginTime: String(fv.beginTime?.value ?? ''),
+            endTime: String(fv.endTime?.value ?? ''),
+            beAgentUid: String(fv.bagentuid?.value ?? ''),
+            beAgent: String(fv.bagentuid?.valueSpan ?? ''),
+            workflowId: String(fv.workflowid?.value ?? ''),
+            workflowName: String(fv.workflowid?.valueSpan ?? j.wfInfo?.workflowname ?? ''),
+        },
+        rows,
+        raw: j,
+    };
+}
+
+/**
+ * 组装编辑保存体（**纯函数**）。以详情里的当前值为底、套用覆盖项，再把每一行**原样**回吐为 `row_<i>_<字段>`。
+ * 配方已用抓包 body 逐字段比对验证（22/22 吻合）。
+ * overrides 可给：beginDate / endDate / beginTime / endTime / 四个开关。
+ */
+export function buildAgentEditBody(detail, overrides = {}) {
+    const cur = detail?.current ?? {};
+    const rows = detail?.rows ?? [];
+    const pick = (v, fallback) => (v === undefined || v === null || v === '' ? fallback : v);
+    const body = {
+        agentid: String(detail?.agentId ?? ''),
+        symbol: 'edit',
+        beginDate: pick(overrides.beginDate, cur.beginDate ?? ''),
+        endDate: pick(overrides.endDate, cur.endDate ?? ''),
+        bagentuid: String(cur.beAgentUid ?? ''),
+        beginTime: pick(overrides.beginTime, cur.beginTime ?? ''),
+        endTime: pick(overrides.endTime, cur.endTime ?? ''),
+        workflowid: String(cur.workflowId ?? ''),
+        rownum: String(rows.length || 1),
+        ismodifyCondition: 'false',
+    };
+    rows.forEach((row, i) => {
+        for (const [k, v] of Object.entries(row ?? {}))
+            body[`row_${i}_${k}`] = String(v ?? '');
+    });
+    const switches = {
+        isCreateAgenter: overrides.isCreateAgenter,
+        isProxyDeal: overrides.isProxyDeal,
+        isSysCreateAgenter: overrides.isSysCreateAgenter,
+        isPendThing: overrides.isPendThing,
+    };
+    for (const [k, v] of Object.entries(switches))
+        if (v !== undefined && v !== null && v !== '')
+            body[`row_0_${k}`] = String(v);
+    return body;
+}
+
+/**
+ * 编辑代理保存。链路（抓包实证顺序）：`verifyAgentOverlap` → `saveAgentDetail` → `{agentresult:'success'}`。
+ * 与 doSupervise 同款闸门：未传 opts.send 只做重叠校验 + 回显（由 CLI 打印改前→改后）。
+ */
+export async function editAgent(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const agentId = String(opts.agentId ?? '').trim();
+    if (!agentId)
+        throw new Error('编辑代理需要代理记录 id（--agent-id）。');
+    const detail = opts.detail ?? await getAgentDetail(cfg, agentId);
+    const body = buildAgentEditBody(detail, opts);
+    const overlap = await verifyOverlap(cfg, body);
+    if (!opts.send)
+        return { sent: false, endpoint: { baseUrl: ep.baseUrl }, detail, body, overlap };
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/saveAgentDetail', body);
+    return { sent: true, endpoint: { baseUrl: ep.baseUrl }, detail, body, overlap, result: String(r.json?.agentresult ?? ''), raw: r.json };
+}
+
+/** 批量编辑弹窗的字段定义。POST /api/workflow/agent/getBatchEditInfo（**无 body**）→ `{fields:{...}}`（实测只有起止日期/时间 4 个）。 */
+export async function getBatchEditInfo(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/getBatchEditInfo', {});
+    const j = r.json ?? {};
+    return { fields: Object.keys(j.fields ?? {}), raw: j };
+}
+
+/**
+ * 组装批量编辑保存体（**纯函数**）。
+ *
+ * ⚠️ 与**单条**编辑完全不同：批量编辑**只改起止日期/时间**（弹窗只有这 4 个字段，`getBatchEditInfo` 实证），
+ *    **不需要**回吐 `row_0_*` 详情；body 就 6 个字段：`method=editBatch` + `agentids` + 起止日期/时间。
+ * ⚠️ 这 4 个字段是**整体覆盖**，且**日期留空会被填成 `1900-01-01`**（2026-10-15 实测）——
+ *    于是 `1900-01-01 ~ 未来日期` 直接覆盖"今天"，代理**立刻变成生效中**。
+ *    故本函数**强制要求 `--begin` 与 `--end` 同时给**（时间可留空=全天），避免静默把开始日期打成 1900。
+ */
+export function buildBatchEditBody(opts = {}) {
+    const ids = String(opts.agentIds ?? '').split(',').map((s) => s.trim()).filter(Boolean);
+    if (ids.length < 2)
+        throw new Error('批量编辑至少需要 2 条代理（--agent-ids "537,538"）；只改一条请用 --agent-id 走单条编辑。');
+    const beginDate = String(opts.beginDate ?? '').trim();
+    const endDate = String(opts.endDate ?? '').trim();
+    if (!beginDate || !endDate)
+        throw new Error('批量编辑是**整体覆盖**，且日期留空会被填成 1900-01-01（代理会立刻生效）——'
+            + '必须同时给 --begin 与 --end。只想改结束日期请用单条编辑（--agent-id）。');
+    return {
+        method: 'editBatch',
+        agentids: ids.join(','),
+        beginDate: String(opts.beginDate ?? ''),
+        endDate: String(opts.endDate ?? ''),
+        beginTime: String(opts.beginTime ?? ''),
+        endTime: String(opts.endTime ?? ''),
+    };
+}
+
+/** 批量编辑保存。链路同单条：`verifyAgentOverlap`（method=editBatch）→ `saveBatchEditInfo`。 */
+export async function editAgentBatch(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const body = buildBatchEditBody(opts);
+    const overlap = await verifyOverlap(cfg, body);
+    if (!opts.send)
+        return { sent: false, endpoint: { baseUrl: ep.baseUrl }, body, overlap };
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/saveBatchEditInfo', body);
+    return { sent: true, endpoint: { baseUrl: ep.baseUrl }, body, overlap, result: String(r.json?.agentresult ?? ''), raw: r.json };
+}
+
+/**
+ * 收回**该被代理人名下的全部**代理（界面按钮「收回全部代理」）。
+ *
+ * POST /api/workflow/agent/takeBackAgent，body `symbol=pt` + **`agentid`（锚点）** + `bagentuid` + `backRunning`
+ * （2026-10-14 用户在 OA 点「收回全部代理」抓包实证；**`symbol=pt` 与单条的 `symbol=it` 是两种语义**）。
+ * ⚠️ **`agentid` 必须带**（2026-10-14 实验证实）：只传 `symbol=pt`+`bagentuid` 时接口回 `{"flag":true}`，
+ *    但**毫无效果**（生效中的代理一条没少）；补上任意一条属于该被代理人的 `agentid` 后立刻生效。
+ *    界面语义是「点哪行就用哪行的 id 当锚点」，故本函数在未指定 `opts.agentId` 时**自动取该被代理人名下
+ *    第一条生效中的代理**作为锚点；一条都没有则不发请求（没有可收回的东西）。
+ * ⚠️ 同样是「标记 agenttype=0」，行不会从列表消失。
+ */
+export async function takeBackAllAgent(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const beAgentUid = String(opts.beAgentUid ?? '').trim();
+    if (!beAgentUid)
+        throw new Error('收回全部需要被代理人 id（--be-agent <姓名|id>）。');
+    const backRunning = opts.backRunning === undefined || opts.backRunning === '' ? '1' : String(opts.backRunning);
+    let agentId = String(opts.agentId ?? '').trim();
+    if (!opts.send)
+        return { sent: false, endpoint: { baseUrl: ep.baseUrl }, beAgentUid, backRunning, agentId: agentId || null };
+    if (!agentId) {
+        // 找锚点：该被代理人名下第一条生效中的代理（界面就是拿点击行的 id）
+        const anchor = await getAgentList(cfg, { view: 'all', beAgent: beAgentUid, status: '1', page: 1 });
+        agentId = String(anchor.items?.[0]?.agentId ?? '');
+        if (!agentId)
+            return { sent: true, endpoint: { baseUrl: ep.baseUrl }, beAgentUid, backRunning, agentId: null, flag: false, noop: true };
+    }
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/takeBackAgent', { symbol: 'pt', agentid: agentId, bagentuid: beAgentUid, backRunning });
+    return { sent: true, endpoint: { baseUrl: ep.baseUrl }, beAgentUid, agentId, backRunning, flag: r.json?.flag === true, raw: r.json };
+}
+
+/**
+ * 新建代理。POST /api/workflow/agent/addAgentSave → {agentresult:'success'}
+ * 与 doSupervise 同款闸门：未传 opts.send 只回显不落库（由 CLI 负责打印预览）。
+ */
+export async function addAgent(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const body = opts.body ?? buildAgentBody(opts);
+    if (!opts.send)
+        return { sent: false, endpoint: { baseUrl: ep.baseUrl }, body };
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/agent/addAgentSave', body);
+    return { sent: true, endpoint: { baseUrl: ep.baseUrl }, body, result: String(r.json?.agentresult ?? ''), raw: r.json };
+}