weaver-e9-assistant-cli 1.1.4 → 1.1.11

package/dist/nodemap.js

@@ -0,0 +1,232 @@
+/**
+ * 流程节点名解析：nodeid → nodename。
+ *
+ * 背景：待办/已办/我发起列表服务端**只给当前节点的 id**——行字段 `currentnodeid` 的值形如 "2882"，
+ *   且行里没有节点名（实测 `currentnodeidspan` 也只是 id 本身，整行不含 currentnodename/currentnodespan）。
+ *   要显示名字只能按流程另取节点表。
+ *
+ * 接口（2026-10-14 实测 e9pc.e-cology.com.cn）：
+ *   POST /api/workflow/test/getNodeInfo   body: { workflowId }
+ *     → { nodeInfo: [{id, name, type}], wfInfo: {workflowName, version}, authority, tabInfo, ... }
+ *   - 只需 workflowId；文档里的 requestid/userId/type 都非必需（逐个试过）。
+ *   - ⚠️ 路径必须带 `/api` 前缀：`/workflow/test/getNodeInfo`（无前缀）返回登录页 HTML。
+ *   - ⚠️ 接口挂在「流程测试」模块下，非所有部署/版本都有 → **一律 fail-soft**：
+ *       拿不到就返回 null，调用方退回显示节点 id，绝不让列表整体报错。
+ *   - `type`：0=发起节点 / 1=审批节点 / 3=归档节点。
+ *
+ * 缓存：`~/.e9/node_map_<envkey>.json`，按 workflowId 存，TTL 30 天
+ *   （节点表几乎不变；响应带 version，流程改版后重新拉取自然覆盖）。
+ *   - `E9_NODEMAP_CACHE_DIR` 覆盖缓存目录（测试隔离用，避免污染真实 ~/.e9）。
+ *   - `E9_NO_NODE_NAME=1` 或 CLI `--no-node-name` 整体停用解析。
+ */
+import { createApiFromProfile } from './client.js';
+import { endpointFor, profileNameFromBaseUrl } from './config.js';
+import { stripHtml } from './parse.js';
+import path from 'node:path';
+import os from 'node:os';
+
+/** 节点表缓存 TTL（天）。 */
+export const NODEMAP_TTL_MS = (Number(process.env.E9_NODEMAP_TTL_DAYS ?? '30') || 30) * 24 * 3600 * 1000;
+/** 并发拉取上限（一次列表页通常 ≤10 个流程，全量拉取路径可能几十个，别一次打满）。 */
+const FETCH_CHUNK = 6;
+
+function str(v) {
+    if (v === undefined || v === null || v === '')
+        return undefined;
+    return String(v);
+}
+
+/** 缓存目录（测试可用 E9_NODEMAP_CACHE_DIR 覆盖）。 */
+export function nodeMapCacheDir() {
+    return process.env.E9_NODEMAP_CACHE_DIR || path.join(os.homedir(), '.e9');
+}
+/** 缓存文件路径：~/.e9/node_map_<envkey>.json（按环境隔离，nodeid 不跨环境通用）。 */
+export function nodeMapCachePath(cfg) {
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    return path.join(nodeMapCacheDir(), `node_map_${profileNameFromBaseUrl(baseUrl)}.json`);
+}
+
+/** 是否停用节点名解析（E9_NO_NODE_NAME=1）。 */
+export function isNodeNameDisabled() {
+    return process.env.E9_NO_NODE_NAME === '1';
+}
+
+/**
+ * 纯函数：把 getNodeInfo 响应归一化为 { workflowName, version, nodes:{id:name} }。
+ * 结构不符（登录页/空表/非 JSON）返回 null——调用方据此 fail-soft。
+ */
+export function parseNodeInfo(json) {
+    const list = json?.nodeInfo;
+    if (!Array.isArray(list))
+        return null;
+    const nodes = {};
+    for (const n of list) {
+        const id = str(n?.id);
+        if (!id)
+            continue;
+        nodes[id] = stripHtml(n?.name) || id;
+    }
+    if (Object.keys(nodes).length === 0)
+        return null;
+    return {
+        workflowName: str(json?.wfInfo?.workflowName),
+        version: str(json?.wfInfo?.version),
+        nodes,
+    };
+}
+
+import { cacheGet, cacheUpdate } from './cache-store.js';
+
+/** 读缓存文件；坏文件/不存在返回 {}。 */
+function readCache(cfg) {
+    const raw = cacheGet(nodeMapCachePath(cfg));
+    return raw?.workflows ?? {};
+}
+
+/** 写回缓存（单流程）；写入失败不阻断（节点名只是锦上添花）。 */
+function writeCache(cfg, workflowId, entry) {
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    cacheUpdate(nodeMapCachePath(cfg), (current) => {
+        const workflows = current?.workflows ?? {};
+        workflows[workflowId] = entry;
+        return {
+            envkey: profileNameFromBaseUrl(baseUrl),
+            baseUrl,
+            updatedAt: new Date().toISOString(),
+            workflows,
+        };
+    });
+}
+
+function isStale(entry) {
+    if (!entry || !entry.fetchedAt)
+        return true;
+    return Date.now() - new Date(entry.fetchedAt).getTime() > NODEMAP_TTL_MS;
+}
+
+/**
+ * 取某流程的节点表（带缓存）。任何失败返回 null（fail-soft，不抛）。
+ * @returns {Promise<{workflowName?:string, version?:string, nodes:Record<string,string>}|null>}
+ */
+export async function getNodeMap(cfg, workflowId, opts = {}) {
+    const wfId = str(workflowId);
+    if (!wfId)
+        return null;
+    const cached = readCache(cfg)[wfId];
+    if (!opts.refresh && cached && !isStale(cached) && cached.nodes)
+        return { workflowName: cached.workflowName, version: cached.version, nodes: cached.nodes };
+    const api = opts.api ?? await createApiFromProfile(cfg);
+    let json = null;
+    try {
+        const r = await api.post('/api/workflow/test/getNodeInfo', { workflowId: wfId });
+        json = r?.json ?? null;
+    }
+    catch {
+        json = null; // 网络/鉴权异常同上：降级，不打断列表
+    }
+    const parsed = parseNodeInfo(json);
+    if (!parsed)
+        return null;
+    writeCache(cfg, wfId, { ...parsed, workflowId: wfId, fetchedAt: new Date().toISOString() });
+    return parsed;
+}
+
+/**
+ * 列出**本地缓存**里所有流程的节点表（供「按节点名跨流程解析」用）。
+ * 缓存来自历次列表查询；从没查过的流程不在其中。
+ */
+export function listCachedNodeMaps(cfg) {
+    const workflows = readCache(cfg);
+    return Object.entries(workflows)
+        .filter(([, w]) => w && w.nodes && Object.keys(w.nodes).length)
+        .map(([workflowId, w]) => ({ workflowId: String(workflowId), workflowName: w.workflowName, nodes: w.nodes }));
+}
+
+/**
+ * 按**节点名**解析节点 id（供 CLI `--node-name`）。
+ *
+ * 节点 id 是**流程内编号**（每个流程一套），故解析必须先限定流程范围：
+ *   - 给了 `workflowId`：只在该流程的节点表内找（按需拉取，不依赖缓存）；
+ *   - 未给：在**本地缓存**的所有流程节点表内找（缓存来自历次列表查询）。
+ *
+ * 匹配规则：**先精确同名**；无精确才做模糊（互相包含）。多候选一律**全部返回**，
+ * 由调用方列给用户选——严禁自动取首条（本仓库硬规则）。
+ *
+ * @returns {Promise<{candidates:Array<{workflowId,workflowName,nodeId,nodeName,matchType}>,
+ *                    exact:Array, scoped:boolean, poolSize:number, unavailable:boolean}>}
+ *   `unavailable`：限定了流程但节点表取不到（接口不存在/异常）——与"确实没有同名节点"要区分开。
+ */
+export async function resolveNodeByName(cfg, name, opts = {}) {
+    const want = String(name ?? '').trim();
+    const empty = { candidates: [], exact: [], scoped: Boolean(opts.workflowId), poolSize: 0, unavailable: false };
+    if (!want)
+        return empty;
+    let pool = [];
+    if (opts.workflowId) {
+        const m = await getNodeMap(cfg, opts.workflowId, opts);
+        if (!m)
+            return { ...empty, unavailable: true };
+        pool = [{ workflowId: String(opts.workflowId), workflowName: m.workflowName, nodes: m.nodes }];
+    }
+    else {
+        pool = listCachedNodeMaps(cfg);
+    }
+    const candidates = [];
+    for (const w of pool) {
+        for (const [nodeId, nodeName] of Object.entries(w.nodes)) {
+            if (!nodeName)
+                continue;
+            const isExact = nodeName === want;
+            const isFuzzy = !isExact && (nodeName.includes(want) || want.includes(nodeName));
+            if (isExact || isFuzzy)
+                candidates.push({ workflowId: w.workflowId, workflowName: w.workflowName, nodeId, nodeName, matchType: isExact ? 'exact' : 'fuzzy' });
+        }
+    }
+    return {
+        candidates,
+        exact: candidates.filter((c) => c.matchType === 'exact'),
+        scoped: Boolean(opts.workflowId),
+        poolSize: pool.length,
+        unavailable: false,
+    };
+}
+
+/** 从列表行取流程 id（normalizeRow 归一字段优先，回退原始行）。 */
+function workflowIdOf(item) {
+    return str(item?.workflowId) ?? str(item?.raw?.workflowid) ?? str(item?.raw?.workflowId);
+}
+
+/**
+ * 给列表行补 `nodeName`（就地写回）。返回补上的行数。
+ *
+ * - 行需带 `node`（节点 id）；流程 id 取 `workflowId` 或 `raw.workflowid`。
+ * - 按流程去重，每个流程只请求一次；同一流程的多行共用一张表。
+ * - 任何失败都不抛：拿不到节点表的行保持原样（渲染层回退显示 id）。
+ */
+export async function annotateNodeNames(cfg, items, opts = {}) {
+    if (!Array.isArray(items) || items.length === 0)
+        return 0;
+    if (opts.disabled)
+        return 0;
+    // 只对「node 是纯数字 id」的行解析：服务端不同列表的 span 给的东西不一样——
+    // 待办/公文给的是**节点 id**（需要解析），流程代理办理记录给的是**节点名**（解析无从匹配，纯浪费请求）。
+    const rows = items.filter((it) => /^\d+$/.test(str(it?.node) ?? '') && workflowIdOf(it));
+    if (rows.length === 0)
+        return 0;
+    const wfIds = [...new Set(rows.map(workflowIdOf))];
+    const maps = new Map();
+    for (let i = 0; i < wfIds.length; i += FETCH_CHUNK) {
+        const chunk = wfIds.slice(i, i + FETCH_CHUNK);
+        const got = await Promise.all(chunk.map((w) => getNodeMap(cfg, w, opts)));
+        chunk.forEach((w, idx) => maps.set(w, got[idx]));
+    }
+    let filled = 0;
+    for (const it of rows) {
+        const name = maps.get(workflowIdOf(it))?.nodes?.[str(it.node)];
+        if (name) {
+            it.nodeName = name;
+            filled++;
+        }
+    }
+    return filled;
+}

package/dist/odoc.js

@@ -119,8 +119,13 @@ export function normalizeOdocRow(row) {
         createDate: stringify(get(['createdate'])),
         sendDepartment: stringify(get(['senddepartment'])),
         lastOperateDate: stringify(get(['lastoperatedate'])),
-        currentNodeId: stripHtml(get(['currentnodeidspan'])) || stringify(get(['currentnodeid'])),
-        currentNode: stripHtml(get(['currentnodespan'])) || stringify(get(['currentnode'])),
+        // ⚠️ E9 公文列表这两列的**字段名与内容是反的**（2026-10-14 实测 wf=552 发文）：
+        //   currentnodeidspan → "拟稿"（公文环节名，是标签不是 id）
+        //   currentnodespan   → "2868"（真正的**节点 id**，用 getNodeInfo 可解析出节点名「拟稿发起」）
+        // 故不再沿用误导性的原名，改为语义正确的 stageName / node；nodeName 由 nodemap 回填。
+        stageName: stripHtml(get(['currentnodeidspan'])) || stringify(get(['currentnodeid'])),
+        node: stripHtml(get(['currentnodespan'])) || stringify(get(['currentnode'])),
+        nodeName: undefined,
         zbr: stringify(get(['zbr'])),
         wbr: stringify(get(['wbr'])),
         docAbstract: stripHtml(get(['docabstractspan'])) || stringify(get(['docabstract'])),

package/dist/parse.js

@@ -158,7 +158,11 @@ export function normalizeRow(row, columns) {
         creatorId,
         createdate: spanOr('createdate', ['createdatespan', 'createDate']),
         receivedate: spanOr('receivedate', ['receivedate', 'recieveDate']),
+        // 注意：服务端流程列表**只有节点 id**（currentnodeidspan 实测也是 id 本身，整行无节点名），
+        // 节点名由 nodemap.annotateNodeNames 按流程节点表回填到 nodeName。
         node: stripHtml(get(['currentnodeidspan', 'currentnodespan'])) || stringify(get(['currentnodeid', 'nodeName', 'nodename'])),
+        nodeName: undefined,
+        workflowId: stringify(get(['workflowid', 'workflowId'])),
         status: stripHtml(get(['statusspan'])) || stringify(get(['status'])),
         level,
         requestmark: stringify(get(['requestmark'])),

package/dist/subordinate.js

@@ -16,7 +16,6 @@
  *   - 姓名→userid 解析唯一入口是 blog at-list（SKILL.md 硬规则），候选按 精确>前缀>拼音 排序后过滤到范围。
  *   - 下属表找不到 id 列 → scope 标记 reliable:false → 非本人查询拒绝（安全但功能受限，实跑校准回填规则）。
  */
-import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { createApiFromProfile } from './client.js';
@@ -24,16 +23,22 @@ import { extractDataKey, extractRows, extractColumns, extractTotal, pickByPaths,
 import { getCurrentUser } from './wfuser.js';
 import { getAtAllList } from './blog.js';
 import { profileNameFromBaseUrl } from './config.js';
+import { cacheGet, cacheSet } from './cache-store.js';
 
 /** 全层级下属翻页上限（超限仍未收全 → reliable:false）。 */
 export const MAX_SCOPE_PAGES = 20;
+/**
+ * 授权集合拉取的单页条数。服务端 table/datas 认 pageSize（实测 pageSize=500 一次返回全部 96 条），
+ * 用大页把「逐页排队」压成通常 1 次请求；超过 500 人才继续翻页。
+ */
+const SCOPE_PAGE_SIZE = 500;
 /** 授权集合缓存 TTL（默认 12h，比台账目录的 7 天短——越权集合同理会随组织变动，宁短勿长）。 */
 export const SCOPE_TTL_MS = (Number(process.env.E9_SCOPE_TTL_HOURS ?? '12') || 12) * 3600 * 1000;
 /** 缓存目录（测试可用 E9_SCOPE_CACHE_DIR 覆盖，避免污染真实 ~/.e9）。 */
 function scopeCacheDir() {
     return process.env.E9_SCOPE_CACHE_DIR || path.join(os.homedir(), '.e9');
 }
-function scopeCachePath(cfg) {
+export function scopeCachePath(cfg) {
     const envkey = profileNameFromBaseUrl(cfg.baseUrl);
     return path.join(scopeCacheDir(), `subordinate_scope_${envkey}.json`);
 }
@@ -56,10 +61,13 @@ export async function fetchSubordinateDataKey(cfg, { lastname = '', showAllLevel
     return { dataKey, raw: r?.json ?? null };
 }
 
-/** 取下属表一页数据（不带 pageSize，跟随服务端默认每页条数）。 */
-export async function fetchSubordinateDataPage(cfg, dataKey, page) {
+/** 取下属表一页数据（pageSize 可选；不传则跟随服务端默认每页条数）。 */
+export async function fetchSubordinateDataPage(cfg, dataKey, page, { pageSize } = {}) {
     const api = await createApiFromProfile(cfg);
-    const r = await api.post('/api/ec/dev/table/datas', { dataKey, current: String(page), sortParams: '[]' });
+    const body = { dataKey, current: String(page), sortParams: '[]' };
+    if (pageSize != null)
+        body.pageSize = String(pageSize);
+    const r = await api.post('/api/ec/dev/table/datas', body);
     const json = r?.json ?? {};
     return {
         rows: extractRows(json),
@@ -129,14 +137,19 @@ export async function getSubordinates(cfg, opts = {}) {
     const page = Number(opts.page ?? '1') || 1;
     const { dataKey, raw: searchRaw } = await fetchSubordinateDataKey(cfg, { lastname, showAllLevel: allLevel });
     const data = await fetchSubordinateDataPage(cfg, dataKey, page);
-    const count = await fetchSubordinateCount(cfg, dataKey);
-    const total = count.total ?? null;
+    // counts 按需：首页且未填满一页 → 总数即本页条数，省一次请求；否则才查总数。
+    const pageSize = data.pageSize ?? (data.rows.length || null);
+    const firstPageComplete = page === 1 && data.pageSize && data.rows.length < data.pageSize;
+    let count = { total: null, raw: null };
+    if (!firstPageComplete)
+        count = await fetchSubordinateCount(cfg, dataKey);
+    const total = count.total ?? (firstPageComplete ? data.rows.length : null);
     const items = data.rows.map((r) => normalizeSubordinateRow(r, data.columns));
     return {
         lastname,
         allLevel,
         page,
-        pageSize: data.pageSize ?? (data.rows.length || null),
+        pageSize,
         total,
         count: items.length,
         dataKey,
@@ -146,6 +159,53 @@ export async function getSubordinates(cfg, opts = {}) {
     };
 }
 
+// ─── 全量下属列表（批量按人查询用） ──────────────────────
+
+/**
+ * 拉取全部下属（直接/全部层级），供「按人批量查数据」类命令使用。
+ * - 大页 pageSize（默认 500）减少翻页；翻页串行（同一 dataKey 并发翻页不可靠）。
+ * - names 非空时按姓名精确过滤，并返回未匹配名单（不静默丢人）。
+ * - complete=false 表示达到 MAX_SCOPE_PAGES 仍未收全（调用方须提示可能不完整）。
+ */
+export async function listAllSubordinates(cfg, { allLevel = false, names = [], pageSize = SCOPE_PAGE_SIZE } = {}) {
+    const wanted = (Array.isArray(names) ? names : [names]).map((n) => String(n ?? '').trim()).filter(Boolean);
+    const { dataKey } = await fetchSubordinateDataKey(cfg, { lastname: '', showAllLevel: !!allLevel });
+    let page = 1;
+    let complete = false;
+    let columns = [];
+    let rows = [];
+    while (page <= MAX_SCOPE_PAGES) {
+        const d = await fetchSubordinateDataPage(cfg, dataKey, page, { pageSize });
+        if (page === 1)
+            columns = d.columns;
+        rows = rows.concat(d.rows);
+        if (d.rows.length === 0 || (d.pageSize && d.rows.length < d.pageSize)) {
+            complete = true;
+            break;
+        }
+        page++;
+    }
+    const seen = new Set();
+    const all = [];
+    for (const row of rows) {
+        const item = normalizeSubordinateRow(row, columns);
+        const id = String(item.id ?? '');
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        all.push({ id, name: item.name, fields: item.fields });
+    }
+    let items = all;
+    let unmatched = [];
+    if (wanted.length) {
+        const wantedSet = new Set(wanted);
+        items = all.filter((it) => wantedSet.has(String(it.name ?? '').trim()));
+        const found = new Set(items.map((it) => String(it.name ?? '').trim()));
+        unmatched = wanted.filter((n) => !found.has(n));
+    }
+    return { items, columns, total: all.length, count: items.length, unmatched, complete };
+}
+
 // ─── 授权集合加载 + 缓存（严格 fail-closed） ─────────────
 
 /**
@@ -175,7 +235,10 @@ export async function loadScope(cfg, opts = {}) {
             return { ...cached, selfId, selfName, userIds: new Set(cached.userIds), userNames: new Set(cached.userNames), fromCache: true };
         }
     }
-    // 3. 拉全层级下属，逐页收行
+    // 3. 拉全层级下属：大页 + 串行翻页
+    //    - 服务端认 pageSize，SCOPE_PAGE_SIZE=500 通常一次拿全，避免逐页排队；
+    //    - ⚠ 不能并发翻页：实测同一 dataKey 并发请求 table/datas 时，服务端偶发返回空页
+    //      （5 次里 1 次出现连续两页 0 行），会导致 scope 判定不可靠。此处必须串行。
     const userIds = new Set([selfId]);
     const userNames = new Set([selfName].filter(Boolean));
     let reliable = false;
@@ -188,7 +251,7 @@ export async function loadScope(cfg, opts = {}) {
         let page = 1;
         let hitEnd = false;
         while (page <= MAX_SCOPE_PAGES) {
-            const d = await fetchSubordinateDataPage(cfg, dataKey, page);
+            const d = await fetchSubordinateDataPage(cfg, dataKey, page, { pageSize: SCOPE_PAGE_SIZE });
             if (page === 1) {
                 idCol = detectSubordinateIdColumn(d.columns);
                 nameCol = detectSubordinateNameColumn(d.columns);
@@ -233,35 +296,23 @@ export async function loadScope(cfg, opts = {}) {
 
 /** 读缓存；selfId 不匹配 / 过期 / 不可靠 → null。 */
 function readScopeCache(cfg, selfId) {
-    try {
-        const raw = JSON.parse(fs.readFileSync(scopeCachePath(cfg), 'utf8'));
-        if (!raw || raw.selfId !== selfId || raw.reliable !== true)
-            return null;
-        if (Date.now() - (raw.fetchedAt || 0) > SCOPE_TTL_MS)
-            return null;
-        return raw;
-    }
-    catch {
-        return null;
-    }
+    const raw = cacheGet(scopeCachePath(cfg), SCOPE_TTL_MS);
+    if (!raw || raw.selfId !== selfId || raw.reliable !== true) return null;
+    return raw;
 }
 
 /** 写缓存（失败不阻断）。 */
 function writeScopeCache(cfg, scope) {
-    try {
-        fs.mkdirSync(scopeCacheDir(), { recursive: true });
-        fs.writeFileSync(scopeCachePath(cfg), JSON.stringify({
-            envkey: profileNameFromBaseUrl(cfg.baseUrl),
-            baseUrl: cfg.baseUrl,
-            selfId: scope.selfId,
-            selfName: scope.selfName,
-            userIds: [...scope.userIds],
-            userNames: [...scope.userNames],
-            reliable: scope.reliable,
-            fetchedAt: scope.fetchedAt,
-        }, null, 2) + '\n', 'utf8');
-    }
-    catch { /* 缓存写失败不阻断查询 */ }
+    cacheSet(scopeCachePath(cfg), {
+        envkey: profileNameFromBaseUrl(cfg.baseUrl),
+        baseUrl: cfg.baseUrl,
+        selfId: scope.selfId,
+        selfName: scope.selfName,
+        userIds: [...scope.userIds],
+        userNames: [...scope.userNames],
+        reliable: scope.reliable,
+        fetchedAt: scope.fetchedAt,
+    });
 }
 
 /** 是否在授权集合内（纯函数，便于单测）。 */
@@ -342,6 +393,31 @@ export async function assertNamesInScope(cfg, names, opts = {}) {
     return resolved.length === 1 ? resolved[0] : resolved;
 }
 
+/**
+ * 仅把姓名解析成 uid，**不做任何范围过滤**。
+ *
+ * 与 assertNamesInScope 的区别：后者用于「查询他人」类筛选，越界要拦；
+ * 而本函数用于**给他人派活**的场景（如流程代理把待办委托给谁——委托对象不限于下属），
+ * 只需遵守「人员搜索必须走 blog at-list」这条硬规则，不施加授权集合限制。
+ * 恰 1 个候选才返回；0 个 / 多个一律抛错并**列全候选**（不自动取首条）。
+ */
+export async function resolveNameToUid(cfg, name) {
+    const n = String(name ?? '').trim();
+    if (!n)
+        throw new Error('人员姓名为空。');
+    if (/^\d+$/.test(n))
+        return n;
+    const r = await getAtAllList(cfg, { name: n });
+    const candidates = sortPersonCandidates(r.items, n);
+    if (candidates.length === 0)
+        throw new Error(`未找到「${n}」对应的人员（at-list 无候选）。`);
+    if (candidates.length > 1) {
+        const list = candidates.slice(0, 10).map((c) => `${stripHtml(String(c.name ?? ''))}(${c.uid})`).join('、');
+        throw new Error(`「${n}」匹配到 ${candidates.length} 个人员，请确认后用 --agent <用户id> 指定：${list}${candidates.length > 10 ? ' …' : ''}`);
+    }
+    return String(candidates[0].uid ?? '');
+}
+
 /** 候选过滤到授权集合（纯函数）。策略未启用（默认）时不过滤，全部视为在范围内。 */
 export function filterCandidatesToScope(scope, candidates) {
     if (!isScopeEnforced()) {

package/dist/supervise.js

@@ -0,0 +1,152 @@
+/**
+ * E9 流程督办（supervise）模块。
+ *
+ * 链路（HAR 抓包实证 + 前端 bundle 逆向）：
+ *   1) POST /api/workflow/supervise/getTree        body{menuIds,menuPathIds} → topTab[]（页签）+ treedata（流程类型树）
+ *   2) POST /api/workflow/supervise/getTreeCount   body 同上 → {flowAllCounts, flowOverCounts, treecount{}} 各类型计数
+ *   3) POST /api/workflow/supervise/getConditionInfo body 空 → conditioninfo（搜索条件定义，结构与待办同构）
+ *   4) POST /api/workflow/supervise/getSessionkey  body{同待办过滤项 + tabKey} → sessionkey（**恒顶层**）
+ *        tabKey：0=全部 / 1=未督办 / 2=已督办 / 3=我的关注
+ *   5) POST /api/ec/dev/table/datas   body{dataKey=sessionkey,current,sortParams} → columns + datas 行
+ *   6) POST /api/ec/dev/table/counts  body{dataKey} → {count}
+ *   7) POST /api/workflow/supervise/doSupervise  body{requestids,remark} → 发起督办（勾选多条用逗号分隔）
+ *
+ * 列表行 `ops` 含 4 个操作（前端 href 实证）：督办(handle) / 短信催办(smsHandle) / 邮件催办(emailHandle) / 关注(doAttention)。
+ * ⚠️ 短信/邮件催办的**实际发送接口未抓到**（前端 getSendEmailInfo 取信息后要打开弹窗填写再发），故本模块只做「督办」。
+ */
+import { endpointFor } from './config.js';
+import { createApiFromProfile } from './client.js';
+import { extractRows, extractColumns, extractTotal, pickByPaths, stripHtml } from './parse.js';
+
+/** 督办菜单 id（抓包实证：menuIds=1,235）。 */
+const SUPERVISE_MENU = { menuIds: '1,235', menuPathIds: '1,235' };
+
+/** 督办页签：tabKey ↔ 中文名（getTree.topTab 实证）。 */
+export const SUPERVISE_TABS = {
+    '全部': '0', '未督办': '1', '已督办': '2', '我的关注': '3',
+};
+
+/** 页签名/别名 → tabKey（数字直传）。 */
+export function resolveSuperviseTab(spec) {
+    const s = String(spec ?? '').trim();
+    if (!s)
+        return '0';
+    if (/^[0-3]$/.test(s))
+        return s;
+    const key = Object.keys(SUPERVISE_TABS).find((k) => k === s || k.includes(s));
+    return key ? SUPERVISE_TABS[key] : undefined;
+}
+
+/** 督办页签 + 流程类型树。POST /api/workflow/supervise/getTree */
+export async function getSuperviseTree(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/supervise/getTree', SUPERVISE_MENU);
+    const j = r.json ?? {};
+    return {
+        tabs: (j.topTab ?? []).map((t) => ({ key: String(t.key ?? ''), title: String(t.title ?? '') })),
+        tree: j.treedata ?? [],
+        raw: j,
+    };
+}
+
+/** 督办计数。POST /api/workflow/supervise/getTreeCount（flowAllCounts=总数、flowOverCounts=未督办）。 */
+export async function getSuperviseCount(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/supervise/getTreeCount', SUPERVISE_MENU);
+    const j = r.json ?? {};
+    return {
+        total: j.flowAllCounts ?? null,
+        pending: j.flowOverCounts ?? null,
+        treeCount: j.treecount ?? {},
+        raw: j,
+    };
+}
+
+/** 督办搜索条件（结构与待办同构）。POST /api/workflow/supervise/getConditionInfo */
+export async function getSuperviseConditions(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/supervise/getConditionInfo', {});
+    const j = r.json ?? {};
+    const groups = (j.conditioninfo ?? []).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 ?? ''),
+        })),
+    }));
+    return { groups, raw: j };
+}
+
+/**
+ * 督办列表。getSessionkey → table/datas → table/counts（同待办 table 链路）。
+ * opts: { tabKey, keyword, page, pageSize, ...过滤项 }
+ */
+export async function listSupervise(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const tabKey = String(opts.tabKey ?? '0');
+    const body = {
+        requestname: opts.keyword ?? '',
+        workcode: '', requestlevel: '', creatertype: '0',
+        ownerdepartmentid: opts.creatorDept ?? '', creatersubcompanyid: opts.creatorSubcom ?? '',
+        receivedateselect: '0', receivedatefrom: '', receivedateto: '',
+        createdateselect: '0', createdatefrom: '', createdateto: '',
+        wfstatu: '1', currentnodetype: '', unophrmid: '', docids: '',
+        hrmcreaterid: opts.creator ?? '', crmids: '', proids: '',
+        ...SUPERVISE_MENU, tabKey,
+    };
+    const r1 = await api.post('/api/workflow/supervise/getSessionkey', body);
+    const sessionkey = pickByPaths(r1.json, ['sessionkey', 'data.sessionkey']);
+    if (!sessionkey)
+        throw new Error(`未拿到督办 sessionkey（getSessionkey 响应：${(r1.text ?? '').slice(0, 200)}）`);
+    const page = Number(opts.page ?? '1') || 1;
+    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 rows = extractRows(r2.json);
+    const items = rows.map((row) => normalizeSuperviseRow(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 { tabKey, page, total, pageSize: pageSize ?? null, items, sessionkey, columns, raw: { getSessionkey: r1.json, datas: r2.json, counts: countsRaw } };
+}
+
+/** 规范化一行督办（可读值优先取 `<field>span`，回退原值）。 */
+export function normalizeSuperviseRow(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 {
+        requestId: String(pickByPaths(row, ['requestid', 'randomField2', 'randomFieldId']) ?? ''),
+        title: stripHtml(get(['requestnamespan'])) || String(get(['requestname', 'requestName']) ?? ''),
+        creator: spanOr('creater', ['createrName']),
+        createTime: spanOr('createtime', ['createdate']),
+        node: stripHtml(get(['currentnodeidspan', 'currentnodespan'])) || String(get(['currentnodeid', 'currentnodename']) ?? ''),
+        unoperators: stripHtml(get(['unoperatorsspan', 'unoperators'])),
+        workflowId: String(get(['workflowid', 'randomField0']) ?? ''),
+        raw: row,
+    };
+}
+
+/** 发起督办。POST /api/workflow/supervise/doSupervise（body: requestids + remark）。 */
+export async function doSupervise(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const requestIds = String(opts.requestIds ?? '').split(',').map((s) => s.trim()).filter(Boolean);
+    const remark = String(opts.remark ?? '');
+    if (!requestIds.length)
+        throw new Error('doSupervise 需要 requestIds（逗号分隔多个）。');
+    if (!opts.send)
+        return { sent: false, endpoint: { baseUrl: ep.baseUrl }, requestIds, remark };
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/workflow/supervise/doSupervise', { requestids: requestIds.join(','), remark });
+    return { sent: true, endpoint: { baseUrl: ep.baseUrl }, requestIds, remark, response: r };
+}