weaver-e9-assistant-cli 1.1.3 → 1.1.5

package/dist/cli.js

@@ -3,7 +3,8 @@
 import fs from 'node:fs';
 import { createHash } from 'node:crypto';
 import { loadConfig, resolveViewcondition, endpointFor, setConfigField } from './config.js';
-import { getWfList, getOaTabGroups, resolveWorkflowType, CATEGORY_SCOPE } from './workflow.js';
+import { getWfList, getOaTabGroups, resolveWorkflowType, CATEGORY_SCOPE, parseTimeRange } from './workflow.js';
+import { annotateNodeNames, isNodeNameDisabled, resolveNodeByName } from './nodemap.js';
 import { parseIdList, batchSubmit, batchForward, batchAttention, getAttentionTypes } from './todobatch.js';
 import { pageUrl, availablePages } from './pageopen.js';
 import { buildBlogMyUrl, buildCubeCardUrl, buildCubeSearchUrl, normalizeE9Url } from './links.js';
@@ -12,7 +13,7 @@ import { loadSubmission, updateSubmission } from './submissionstate.js';
 import { saveSubmissionPlan, loadSubmissionPlan } from './submissionplan.js';
 import { saveCandidateQuery, loadCandidateQuery, persistSearchResult } from './querystate.js';
 import { getFlowSummary } from './wfsummary.js';
-import { submitTodo, retractRequest } from './todosubmit.js';
+import { submitTodo, retractRequest, validateFieldValuesAtNode } from './todosubmit.js';
 import { rejectTodo } from './todoreject.js';
 import { transferTodo } from './todotransfer.js';
 import { forwardTodo, circulateTodo } from './todoforward.js';
@@ -20,18 +21,20 @@ import { ccTodo } from './todocc.js';
 import { askIdeaTodo } from './todoaskidea.js';
 import { getMyBlogList, getMyBlogAll, isBlogRecalled, createBlog, getBlogWorkIndex, getBlogMenuCountdata, getVisitorList, getBlogNote, getCurrentUserInfo, getMsgRemindList, getDefaultTemplate, getBlogAppList, getAtAllList, getBlogPageSearchCondition, getBlogHomepageList, searchMyBlog, getBlogPersonalInfo, sendRemindUnsubmit, addBlogReply, addOrDeleteZan, saveBlogNote, recallBlog, deleteBlogReply, attentionOpt, dealMsgRemind, getShareToMeUserList } from './blog.js';
 import { getCreateWfList, buildCreateWfUrl, buildRequestFormUrl, findCreateWfByName } from './wfcreate.js';
-import { describeFormFields } from './wfform.js';
+import { describeFormFields, VIEWATTR_LABEL } from './wfform.js';
 import { getStartableFields, prepareCreateSubmission, submitCreateRequest, resolveWorkflowId, getOdocNextNodes, odocFlowNext } from './wfstart.js';
 import { cmdTokenLogin, cmdCookieLogin, cmdAuthStatus } from './auth.js';
 import { getEmailList, getEmailView, setMailReadStatus, resolveDateRange, sendEmail, setEmailStar, deleteEmails, moveEmails, getEmailLabels, addEmailLabel, applyEmailLabel, setEmailWaitdeal, recallEmail, uploadEmailAttachment, getEmailAttachmentList, getEmailSize, getEmailReciveAccounts } from './email.js';
 import { searchWorkplan, createWorkplan, getMyCalendar, getAttentionData, getBaseData, getCalendarData, getSelectType, getWorkplanSearchCondition, viewWorkplan, deleteWorkplan, finishWorkplan, downloadWorkplanImportTemplate, importWorkplanExcel, exportWorkplanExcel } from './workplan.js';
 import { listOdocTodo, getOdocTodoCount, listOdocCreate } from './odoc.js';
-import { punch, getButtons, resolvePunchItem, signSecret, buildEncryptObj } from './kq.js';
+import { getSuperviseTree, getSuperviseCount, getSuperviseConditions, listSupervise, doSupervise, resolveSuperviseTab, SUPERVISE_TABS } from './supervise.js';
+import { getAgentList, getAgentConditions, listAgentTemplates, getAddAgentInfo, verifyOverlap, saveAgentTemplate, addAgent, takeBackAgent, takeBackAllAgent, getAgentDetail, editAgent, editAgentBatch, getBatchEditInfo, buildAgentBody, resolveView as resolveWfagentView, resolveStatus as resolveWfagentStatus, WFAGENT_VIEWS, WFAGENT_STATUS } from './wfagent.js';
+import { punch, getButtons, resolvePunchItem, signSecret, buildEncryptObj, getKqReport, getKqMonthReport } from './kq.js';
 import { collectQueryableBusiness } from './report.js';
 import { listCube, getCubeCondition, getCubeInit, exportCubeExcel, getSearchColumnInfo, listCubeExcel, getCubeCountData, getCubeGroupData, getExpCardConfig, getModeBrowserOptions, getCardFields, submitCubeCard, deleteCubeData, printCubePdf, listCubeMenus, findCubeByName, fetchMenuMounts, previewCubeCard, fetchCubeRowsByIds, resolveCubeCondition, downloadCubeImportTemplate, importCubeExcel, assertEditableCardValues } from './cube.js';
 import { getCurrentUser, getCurrentUserIsAdmin } from './wfuser.js';
-import { getSubordinates, assertUserIdsInScope, assertNamesInScope, isScopeEnforced } from './subordinate.js';
-import { resolveHrmTab, getHrmTabs, getHrmConditions, resolveHrmCondition, hrmList, buildHrmCardUrl, findHrmOrgNode, applyResolvedPersonIds } from './hrm.js';
+import { getSubordinates, assertUserIdsInScope, assertNamesInScope, resolveNameToUid, isScopeEnforced } from './subordinate.js';
+import { resolveHrmTab, getHrmTabs, getHrmConditions, resolveHrmCondition, hrmList, buildHrmCardUrl, findHrmOrgNode, applyResolvedPersonIds, expandHrmOrgTree } from './hrm.js';
 import { parseArgs, flagStr, flagBool } from './args.js';
 import { todayStr } from './util.js';
 import { BOX_TOP, DIVIDER } from './render.js';
@@ -46,8 +49,8 @@ function usage() {
         '              [--workflow <id>] [--creator <id>] [--creator-dept <id>] [--creator-subcom <id>]',
         '              [--create-time <range>] [--receive-time <range>] [--operate-time <range>]',
         '              [--request-level <level>] [--request-mark <code>] [--workflow-type <type>]',
-        '              [--node-id <id>] [--flow-status <status>] [--sort <spec>] [--sub-category <tab>]',
-        '              [--total-only] [--ungrouped] [--creator-name <姓名>] [--resume-query <id> --candidate <n>]',
+        '              [--node-id <id> | --node-name <节点名>] [--flow-status <status>] [--sort <spec>] [--sub-category <tab>]',
+        '              [--total-only] [--ungrouped] [--no-node-name] [--creator-name <姓名>] [--resume-query <id> --candidate <n>]',
         '  e9 todo summary --requestid <id>   查看流程摘要（表单字段+值+流转历史）',
         '  e9 todo submit --requestid <id> [--remark "同意"] [--yes]   提交待办到下一节点（默认签字 OK）',
         '  e9 todo reject --requestid <id> [--remark "退回"] [--reject-to-node <nodeid>] [--reject-to-type <t>] [--reject-node <nodes>] [--yes]   退回/驳回待办',
@@ -58,7 +61,7 @@ function usage() {
         '  e9 todo ask-idea --requestid <id> --receiver <uid> | --receiver-name <姓名> [--remark "意见"] [--yes]   意见征询（向某人征询意见，不改审批人）',
         '  e9 todo batch-submit --request-ids "1,2" --user-ids "u1,u2" [--remark "同意"] [--yes]   批量提交（先预览）',
         '  e9 todo batch-forward --request-ids "1,2" --receiver <uid> [--remark "转发"] [--yes]   批量转发（先预览）',
-        '  e9 todo batch-attention --request-ids "1,2" [--attention-id <类型id>] [--yes]   批量关注（先预览，默认加入首个关注类型）',
+        '  e9 todo batch-attention --request-ids "1,2" [--category <todo|done|mine>] [--attention-id <类型id>] [--yes]   批量关注（先预览；--category 选在哪类列表定位，默认待办）',
         '  e9 todo done  [--page <n>] [--keyword <text>] [--workflow <id>] [--creator <id>] [--sort <spec>] [--sub-category <tab>] [--json] [--raw]   已办列表',
         '  e9 todo mine  [--page <n>] [--keyword <text>] [--workflow <id>] [--creator <id>] [--sort <spec>] [--sub-category <tab>] [--json] [--raw]   我发起的流程',
         '  e9 blog list [--date YYYY-MM-DD] [--scope <全部|关注|下级|未读|共享|分享给我|特别关注>] [--page <n>] [--json] [--raw]',
@@ -106,7 +109,7 @@ function usage() {
         '  e9 email recall --id <邮件id> [--yes]   撤回已发邮件',
         '  e9 email attachment upload --file <路径>   上传附件拿 fileid；attachment list 附件列表',
         '  e9 email size    邮箱容量/未读统计；email accounts   接收账户列表',
-        '  e9 workplan list [--date <YYYY-MM-DD>] [--view-type <1|3>] [--group <部门|分部|下级|...>]   日程列表（日历数据）',
+        '  e9 workplan list [--date <YYYY-MM-DD>] [--view-type <1当天|2周|3月>] [--group <部门|分部|下级|...>]   日程列表（默认我的日程；--group 走组织视图）',
         '  e9 workplan my-calendar [--date <YYYY-MM-DD>] [--view-type <1|3>]   日程月视图（MyCalendar，浏览器主用）',
         '  e9 workplan view --id <id>                       查看日程详情',
         '  e9 workplan finish --id <id> [--yes]             完成日程',
@@ -120,11 +123,28 @@ function usage() {
         '  e9 workplan import-template [--out-dir <目录>]   下载原生日程导入模板',
         '  e9 workplan import --file <模板.xls[x]> [--yes]  批量导入日程（默认仅预览）',
         '  e9 workplan export [--type <list|html>] [--group <部门|分部|下级|...>] [--date <YYYY-MM-DD>] [--workplan-type <id>] [--out-dir <目录>] [--yes]  导出日程（list=日程清单 / html=日程一览表，默认 dry-run）',
+        '  e9 supervise list [--tab <全部|未督办|已督办|我的关注>] [--keyword <text>] [--page <n>] [--json]   流程督办列表',
+        '  e9 supervise count [--json]              流程督办计数（总数/未督办）',
+        '  e9 supervise conditions [--json]         流程督办可用搜索条件',
+        '  e9 supervise send --requestids "1,2" [--remark "请尽快处理"] [--yes]   发起督办（默认 dry-run）',
+        '  e9 wfagent list [--view <mine|all|records>] [--status <全部|未结束|未开始|代理中|收回中|已结束>]',
+        '                 [--agent <代理人>] [--be-agent <被代理人>] [--begin <日期|"起 止">] [--end <日期|"起 止">]',
+        '                 [--page <n>] [--json]   流程代理列表（mine=我设置的 / all=全部 / records=代理办理记录）',
+        '  e9 wfagent conditions [--view <mine|all|records>] [--json]   流程代理可用搜索条件',
+        '  e9 wfagent templates [--name <名>] [--workflow <id>] [--page <n>] [--json]   代理模板列表',
+        '  e9 wfagent create --agent <代理人> --be-agent <被代理人> --begin <YYYY-MM-DD> --end <YYYY-MM-DD>',
+        '                    [--range 全部 | --workflow <流程id,id>] [--save-template <模板名>] [--yes]   新建代理（默认 dry-run）',
+        '  e9 wfagent edit --agent-ids "537,538" [--begin <日期>] [--end <日期>] [--time <HH:MM-HH:MM>] [--yes]   批量编辑（只改起止日期/时间）',
+        '  e9 wfagent edit --agent-id <代理id> [--end <YYYY-MM-DD>] [--begin <YYYY-MM-DD>] [--time <HH:MM-HH:MM>] [--yes]   编辑代理（默认 dry-run，显示改前→改后）',
+        '  e9 wfagent takeback --agent-ids "69,70" [--back-running <0|1>] [--yes]   收回代理（默认 dry-run；id 取列表的「代理id」）',
+        '  e9 wfagent takeback --all [--be-agent <被代理人>] [--yes]   收回该被代理人名下**全部**代理（默认 dry-run，批量）',
         '  e9 odoc todo [--page <n>] [--subject <标题>] [--dispatch-num <发文字号>] [--type <公文种类id>] [--topic <主题分类id>]   公文待办列表（getCustomPageList table，每页 10 条）',
         '  e9 odoc count [--view]              公文待办/待阅计数（发文/收文/签报）',
         '  e9 odoc create-list [--type 1|2]     发文/收文流程列表（1=发文拟稿 2=收文登记，复用 create start 发起）',
         '  e9 kq punch on|off [--group-id <id>] [--userid <id>] [--date <YYYY-MM-DD>] [--yes]   打卡（上班/下班卡，默认 dry-run 展示 encryptObj，--yes 真打）',
         '  e9 kq status                          查看今日打卡班次（getButtons timeline）',
+        '  e9 kq report [--user <id>|--user-name <姓名>] [--month YYYY-MM|--year YYYY] [--json]   考勤统计 + 假期余额（默认本人·本月）',
+        '  e9 kq detail [--user <id>|--user-name <姓名>] [--month YYYY-MM] [--json]   月度考勤明细（签到签退时间/IP）',
         '  e9 cube list   --customid <id> [--page <n>] [--keyword <text>] [--condition <k=v;...>] [--json]   建模台账列表（--condition 支持中文字段名自动映射 domkey）',
         '  e9 cube fields --customid <id>      建模查询条件探查（数据状态/筛选字段）',
         '  e9 cube export --customid <id> [--filename <名>] [--condition <k=v;...>] [--keyword <text>] [--out-dir <目录>] [--plain] [--yes]   导出建模台账为 Excel（默认 dry-run；--plain 明文 modeCustomid 逃生口，默认 base64）',
@@ -146,6 +166,7 @@ function usage() {
         '  e9 cube find <名称>          按名模糊匹配台账（列候选消歧，返回 customid+mode+app，供 list/create 等用）',
         '  e9 cube find <名称> --tree-detail   展开 tree 测试类台账的全部树节点路径（默认只显首条菜单路径）',
         '  e9 subordinate list [--name <姓名>] [--all-level] [--page <n>] [--json] [--raw] [--refresh]   查询我的下属（默认直接下属；--all-level 全部层级）',
+        '  e9 hrm tree [--id <组织id>] [--type <1分部|2部门>] [--depth <n>] [--dept <部门名|id>] [--subcompany <分部名|id>] [--json]   组织架构树',
         '  e9 hrm tabs                                         列出人事搜索范围（全部人员/同部门/我的下属）',
         '  e9 hrm conditions [--tab <全部人员|同部门|我的下属>]   列出该范围可用搜索条件（label→domkey）',
         '  e9 hrm search [--tab <全部人员|同部门|我的下属>] [--name <姓名>] [--condition "岗位=经理;性别=男"]',
@@ -264,7 +285,7 @@ function usage() {
         '  email size 邮箱容量统计；email accounts 接收账户列表',
         '  workplan list 日程列表（POST /api/workplan/calendar/getCalendarData，支持组织视图）',
         '    --date      参考日期 YYYY-MM-DD，默认今天',
-        '    --view-type 视图：1=当天 / 3=月视图（默认）',
+        '    --view-type 视图：1=当天 / 2=周 / 3=月（默认）',
         '    --group     组织视图：部门/分部/上级/下级/常用组/关注；不传=默认当前用户',
         '    --type      日程类型 id 筛选，留空=全部',
         '    --json/--raw 同 todo',
@@ -345,7 +366,7 @@ function escapeLinkText(text) {
     return String(text).replace(/([\[\]()\\])/g, '\\$1');
 }
 /** 统一拼各域 list/search 项的 markdown 超链接；无 id/无可链目标时回退纯文本。
- *  domain: 'todo'|'odoc'|'create'|'blog'|'email'|'cube'|'workplan'|'hrm'
+ *  domain: 'todo'|'odoc'|'create'|'blog'|'email'|'cube'|'workplan'|'hrm'|'wfagent'
  *  text: 展示文本（调用方已计算好回退值）；ctx: cube 需 {modeId,formId,customid} */
 function hyperlinkFor(domain, item, base, text, ctx = {}) {
     const meta = linkMetaFor(domain, item, base, ctx);
@@ -360,6 +381,7 @@ function linkMetaFor(domain, item, base, ctx = {}) {
     switch (domain) {
         case 'todo':
         case 'odoc':
+        case 'wfagent': // 仅 records 视图的行有 requestId（代理产生的流程）；mine/all 是代理配置、无流程详情页
             if (item?.requestId)
                 url = buildRequestFormUrl(b, item.requestId);
             urlType = url ? 'detail' : '';
@@ -1747,15 +1769,16 @@ async function runBlog(args) {
             return { ...it, matchType, _sort: matchType === 'exact' ? 0 : matchType === 'prefix' ? 1 : 2 };
         });
         annotated.sort((a, b) => a._sort - b._sort);
+        const atBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
         if (args.flags.json) {
-            console.log(JSON.stringify({ pageIndex: r.pageIndex, pageSize: r.pageSize, noMore: r.noMore, query: q || undefined, items: annotated.map(({ _sort, ...rest }) => rest) }, null, 2));
+            console.log(JSON.stringify({ pageIndex: r.pageIndex, pageSize: r.pageSize, noMore: r.noMore, query: q || undefined, items: annotated.map(({ _sort, ...rest }) => withLink('hrm', { id: rest.uid, name: rest.name }, atBase, rest)) }, null, 2));
             return;
         }
         console.log(`E9 微博 @ 提及用户列表 [第 ${r.pageIndex} 页]${r.noMore ? '' : '（还有更多）'}  共 ${annotated.length} 条${q ? ` · 搜索「${flagStr(args, 'name')}」` : ''}`);
         for (let i = 0; i < annotated.length; i++) {
             const it = annotated[i];
             const tag = it.matchType === 'exact' ? ' ★精确匹配' : it.matchType === 'prefix' ? ' ·前缀' : '';
-            console.log(`${i + 1}. ${it.name}  (uid=${it.uid})${tag}`);
+            console.log(`${i + 1}. ${hyperlinkFor('hrm', { id: it.uid }, atBase, it.name)}  (uid=${it.uid})${tag}`);
         }
         return;
     }
@@ -1859,6 +1882,13 @@ async function runWorkplan(args) {
         const group = flagStr(args, 'group');
         const date = flagStr(args, 'date');
         const type = flagStr(args, 'type');
+        // --view-type：1=当天 / 2=周 / 3=月（默认）。
+        // 此前 list 分支把 viewType 写死为 '3'，导致 --view-type 静默失效（传 1/2 都还是月视图，且不报错）。
+        const viewType = flagStr(args, 'view-type') ?? '3';
+        if (!['1', '2', '3'].includes(viewType)) {
+            console.error(`workplan list 的 --view-type 只支持 1（当天）/ 2（周）/ 3（月），收到: ${viewType}`);
+            process.exit(1);
+        }
         // 默认（无 --group）=「我的日程」：查当前用户自己的日程，走 MyCalendar（selectUser 空=当前用户）。
         // 只有显式传 --group 才走组织视图 getCalendarData（部门/分部/下级等）。
         if (!group) {
@@ -1866,7 +1896,7 @@ async function runWorkplan(args) {
             // ★越权防护：--select-user 指定他人日程时目标必须 ∈ {本人 + 全部层级下属}
             if (selectUser)
                 await assertUserIdsInScope(cfg, [selectUser], { domain: 'workplan' });
-            const r = await getMyCalendar(cfg, { selectDate: date, viewType: '3', selectUser: selectUser ?? '', workPlanType: type });
+            const r = await getMyCalendar(cfg, { selectDate: date, viewType, selectUser: selectUser ?? '', workPlanType: type });
             if (args.flags.raw) {
                 console.error('===== RAW MyCalendar =====');
                 console.error(JSON.stringify(r.raw, null, 2));
@@ -1883,7 +1913,10 @@ async function runWorkplan(args) {
                 }, null, 2));
                 return;
             }
-            console.log(`E9 日程 [${r.selectDate}]  共 ${r.items.length} 条`);
+            // 标明视图与覆盖区间——周/月视图下只看 selectDate 无法判断统计了哪几天
+            const viewLabel = viewType === '1' ? '当天' : viewType === '2' ? '本周' : '本月';
+            const range = r.range?.start && r.range?.end ? `  ${r.range.start} ~ ${r.range.end}` : '';
+            console.log(`E9 日程 [${r.selectDate} · ${viewLabel}]${range}  共 ${r.items.length} 条`);
             if (r.items.length === 0) {
                 console.log('（该区间无日程）');
                 return;
@@ -1922,7 +1955,8 @@ async function runWorkplan(args) {
                 objIds = bd.dept[0]?.id ?? '';
             }
         }
-        const r = await getCalendarData(cfg, { selectDate: date, objType, objIds, workPlanType: type });
+        // 组织视图同样跟随 --view-type（getCalendarData 的 bywhat：1=日 / 2=周 / 3=月）
+        const r = await getCalendarData(cfg, { selectDate: date, objType, objIds, workPlanType: type, bywhat: viewType });
         if (args.flags.raw) {
             console.error('===== RAW getCalendarData =====');
             console.error(JSON.stringify(r.raw, null, 2));
@@ -1945,7 +1979,11 @@ async function runWorkplan(args) {
             return;
         }
         const groupLabel = ` · ${group}`;
-        console.log(`E9 日程 [${r.selectDate}${groupLabel}]  共 ${r.count} 条`);
+        // 组织视图无 start/end 字段，区间从 days.value 推导（首日~末日）
+        const gDays = r.days?.value ?? [];
+        const gRange = gDays.length ? `  ${gDays[0]} ~ ${gDays[gDays.length - 1]}` : '';
+        const gViewLabel = viewType === '1' ? '当天' : viewType === '2' ? '本周' : '本月';
+        console.log(`E9 日程 [${r.selectDate} · ${gViewLabel}${groupLabel}]${gRange}  共 ${r.count} 条`);
         if (r.count === 0) {
             console.log('（该区间无日程）');
             return;
@@ -2297,6 +2335,560 @@ async function runWorkplan(args) {
     console.error(`workplan 暂只支持 list / view / finish / delete / types / search-conditions / search / create / my-calendar / attention / base-data / export / import-template / import，收到: ${sub}`);
     process.exit(1);
 }
+async function runSupervise(args) {
+    const sub = args._[1] ?? 'list';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    if (sub === 'count') {
+        const r = await getSuperviseCount(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify({ total: r.total, pending: r.pending }, null, 2));
+            return;
+        }
+        console.log(`E9 流程督办计数：共 ${r.total ?? '?'} 条，其中未督办 ${r.pending ?? '?'} 条。`);
+        return;
+    }
+    if (sub === 'conditions') {
+        const r = await getSuperviseConditions(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r.groups, null, 2));
+            return;
+        }
+        console.log('E9 流程督办 搜索条件：');
+        for (const g of r.groups) {
+            console.log(`  ${g.title}：`);
+            for (const it of g.items)
+                console.log(`    - ${it.label}  (${it.domkey}${it.type ? `, ${it.type}` : ''})`);
+        }
+        return;
+    }
+    if (sub === 'send') {
+        const requestIds = flagStr(args, 'requestids') ?? '';
+        if (!requestIds) {
+            console.error('supervise send 需要 --requestids "id1,id2"');
+            process.exit(1);
+        }
+        const remark = flagStr(args, 'remark') ?? '';
+        const r = await doSupervise(cfg, { requestIds, remark, send: !!args.flags.yes });
+        if (!r.sent) {
+            console.log(BOX_TOP);
+            console.log(`  [dry-run] 将发起督办（${r.requestIds.length} 条）`);
+            console.log(DIVIDER);
+            console.log(`  requestids = ${r.requestIds.join(', ')}`);
+            console.log(`  督办意见   = ${r.remark || '(空)'}`);
+            console.log('  确认无误后加 --yes 真正发起督办。');
+            console.log(BOX_TOP);
+            return;
+        }
+        const j = r.response?.json;
+        const ok = j?.status === true || j?.status === '1' || j?.status === 1 || j?.success === true;
+        console.log(`${ok ? '✅' : '⚠'} 督办已请求处理（${r.requestIds.length} 条）  HTTP ${r.response?.status}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 300));
+        return;
+    }
+    if (sub !== 'list') {
+        console.error(`supervise 暂只支持 list / count / conditions / send，收到: ${sub}`);
+        process.exit(1);
+    }
+    const tabSpec = flagStr(args, 'tab');
+    const tabKey = resolveSuperviseTab(tabSpec);
+    if (tabKey === undefined) {
+        console.error(`未知督办页签「${tabSpec}」，可选：${Object.keys(SUPERVISE_TABS).join(' / ')}`);
+        process.exit(1);
+    }
+    const r = await listSupervise(cfg, {
+        tabKey,
+        keyword: flagStr(args, 'keyword'),
+        page: Number(flagStr(args, 'page') ?? '1') || 1,
+        pageSize: flagStr(args, 'page-size'),
+        creator: flagStr(args, 'creator'),
+        creatorDept: flagStr(args, 'creator-dept'),
+        creatorSubcom: flagStr(args, 'creator-subcom'),
+    });
+    const tabName = Object.keys(SUPERVISE_TABS).find((k) => SUPERVISE_TABS[k] === tabKey) ?? tabKey;
+    if (args.flags.raw) {
+        console.error('===== RAW getSessionkey =====');
+        console.error(JSON.stringify(r.raw.getSessionkey, null, 2));
+        console.error('===== RAW datas =====');
+        console.error(JSON.stringify(r.raw.datas, null, 2));
+    }
+    if (args.flags.json) {
+        console.log(JSON.stringify({
+            tab: tabName, tabKey, page: r.page, pageSize: r.pageSize, total: r.total, count: r.items.length,
+            items: r.items.map((it) => withLink('todo', it, base)),
+        }, null, 2));
+        return;
+    }
+    console.log(`E9 流程督办 [${tabName}]  第 ${r.page} 页  共 ${r.total ?? '?'} 条`);
+    if (!r.items.length) {
+        console.log('（无数据）');
+        return;
+    }
+    for (let i = 0; i < r.items.length; i++) {
+        const it = r.items[i];
+        console.log(`${i + 1}. ${hyperlinkFor('todo', it, base, it.title || '(无标题)')}`);
+        const meta = [it.creator, it.node, it.createTime, it.unoperators ? `未操作者=${it.unoperators}` : null].filter(Boolean).join(' | ');
+        if (meta)
+            console.log(`   ${meta}`);
+    }
+    if (r.total != null && r.items.length < r.total)
+        console.log(`还有 ${r.total - r.items.length} 条，用 --page <页码> 继续。`);
+}
+
+/**
+ * 流程代理（wfagent）：list / conditions / templates / create。
+ * ⚠️ 编辑、收回、批量编辑、模板删除在 E9 里存在但**未抓到包**，本域未实现（见 references/wfagent.md）。
+ * ⚠️ create 的 4 个开关（isCreateAgenter/isProxyDeal/isSysCreateAgenter/isPendThing）语义未校准，
+ *    默认值 1 照抄抓包样本，dry-run 预览里会显式打印，可用对应命令行开关覆盖。
+ */
+async function runWfagent(args) {
+    const sub = args._[1] ?? 'list';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    const viewSpec = flagStr(args, 'view');
+    const view = resolveWfagentView(viewSpec);
+    if (view === undefined) {
+        console.error(`未知代理视图「${viewSpec}」，可选：${Object.keys(WFAGENT_VIEWS).join(' / ')}（mine=我设置的 / all=全部 / records=代理办理记录）`);
+        process.exit(1);
+    }
+
+    if (sub === 'conditions') {
+        const r = await getAgentConditions(cfg, { view });
+        if (args.flags.json) {
+            console.log(JSON.stringify(r.groups, null, 2));
+            return;
+        }
+        console.log(`E9 流程代理 搜索条件（视图：${WFAGENT_VIEWS[view].title}）：`);
+        for (const g of r.groups) {
+            console.log(`  ${g.title}：`);
+            for (const it of g.items)
+                console.log(`    - ${it.label}  (${it.domkey}${it.type ? `, ${it.type}` : ''})${it.options.length ? `  可选：${it.options.map((o) => `${o.name}=${o.key}`).join(' / ')}` : ''}`);
+        }
+        return;
+    }
+
+    if (sub === 'templates') {
+        const r = await listAgentTemplates(cfg, {
+            name: flagStr(args, 'name'),
+            workflowId: flagStr(args, 'workflow'),
+            agentUid: flagStr(args, 'agent'),
+            page: Number(flagStr(args, 'page') ?? '1') || 1,
+        });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ page: r.page, total: r.total, count: r.items.length, items: r.items.map(({ raw, ...rest }) => rest) }, null, 2));
+            return;
+        }
+        console.log(`E9 代理模板  第 ${r.page} 页  共 ${r.total ?? '?'} 条`);
+        if (!r.items.length) {
+            console.log('（无数据）');
+            return;
+        }
+        for (let i = 0; i < r.items.length; i++) {
+            const it = r.items[i];
+            // 模板没有可跳转的流程详情页，故不出链接（列表超链接规则只针对流程列表）
+            console.log(`${i + 1}. ${it.name || '(未命名)'}  [模板id=${it.templateId}]`);
+            console.log(`   代理人=${it.agent || '?'} | 流程范围=${it.workflowRange || '?'}`);
+        }
+        return;
+    }
+
+    if (sub === 'create') {
+        const agentSpec = flagStr(args, 'agent');
+        if (!agentSpec) {
+            console.error('wfagent create 需要 --agent <代理人>（姓名或用户id）');
+            process.exit(1);
+        }
+        // 代理人=委托对象，不限于下属 → 只走 at-list 姓名解析，不做授权范围过滤
+        const agentUid = await resolveNameToUid(cfg, agentSpec);
+        // 被代理人默认=当前登录人（getAddAgentInfo 的 formValue）；显式指定他人时按越权策略校验
+        const beAgentSpec = flagStr(args, 'be-agent');
+        let beAgentUid = '';
+        let beAgentLabel = '';
+        if (beAgentSpec) {
+            beAgentUid = await assertNamesInScope(cfg, [beAgentSpec], { domain: 'wfagent' });
+            beAgentLabel = beAgentSpec;
+        }
+        else {
+            const info = await getAddAgentInfo(cfg);
+            beAgentUid = info.defaultBeAgentUid;
+            beAgentLabel = info.defaultBeAgent || beAgentUid;
+            if (!beAgentUid) {
+                console.error('未能从 getAddAgentInfo 取到当前登录人作为被代理人，请用 --be-agent 显式指定。');
+                process.exit(1);
+            }
+        }
+        const { beginTime, endTime } = parseTimeSpec(flagStr(args, 'time'));
+        const body = buildAgentBody({
+            agentUid,
+            beAgentUid,
+            beginDate: flagStr(args, 'begin'),
+            endDate: flagStr(args, 'end'),
+            beginTime,
+            endTime,
+            workflowIds: flagStr(args, 'workflow'),
+            range: flagStr(args, 'range'),
+            isCreateAgenter: flagStr(args, 'agent-create-flow'),
+            isProxyDeal: flagStr(args, 'proxy-deal'),
+            isSysCreateAgenter: flagStr(args, 'sys-create'),
+            isPendThing: flagStr(args, 'pend-thing'),
+        });
+        const overlap = await verifyOverlap(cfg, body);
+        const templateName = flagStr(args, 'save-template');
+        if (!args.flags.yes) {
+            console.log(BOX_TOP);
+            console.log('  [dry-run] 新建流程代理');
+            console.log(DIVIDER);
+            console.log(`  被代理人   = ${beAgentLabel}(${body.bagentuid})`);
+            console.log(`  代理人     = ${agentSpec}(${body.agentuid})`);
+            console.log(`  代理期间   = ${body.beginDate} ~ ${body.endDate}${beginTime || endTime ? `  ${beginTime || '00:00'}~${endTime || '23:59'}` : '（全天）'}`);
+            console.log(`  流程范围   = ${body.agentrange === '2' ? '全部流程' : `指定流程 ${body.rangetype}`}`);
+            if (body.agentrange === '2')
+                console.log('    ⚠️ 「全部流程」= 会为**你的每一个流程各建一条**代理记录（实测本环境 466 条），**不是 1 条**！\n       只想试一条请改用 --workflow <单个流程id>。建议保存后到 OA「流程代理」页核对。');
+            console.log(`  开关       = isCreateAgenter=${body.isCreateAgenter}  isProxyDeal=${body.isProxyDeal}  isSysCreateAgenter=${body.isSysCreateAgenter}  isPendThing=${body.isPendThing}`);
+            console.log('    开关含义（据 workflow_agent 表结构校准）：isCreateAgenter=代理创建权限 / isProxyDeal=流转中的待办 /');
+            console.log('      isPendThing=是否把待办事宜转给代理人 / isSysCreateAgenter=系统创建代理标记。默认 1 来自抓包样本；');
+            console.log('      如需调整：--agent-create-flow / --proxy-deal / --sys-create / --pend-thing');
+            console.log(`  重叠校验   = ${overlap.overlapCount ? `⚠️ 与 ${overlap.overlapCount} 条已有代理重叠（overlapIds=${overlap.overlapIds}）` : '✅ 无重叠'}`);
+            if (templateName)
+                console.log(`  存为模板   = ${templateName}`);
+            console.log(DIVIDER);
+            console.log(`  完整请求体：${JSON.stringify(body)}`);
+            console.log(BOX_TOP);
+            console.log('  确认无误后加 --yes 真正保存。');
+            return;
+        }
+        let tplResult = null;
+        if (templateName)
+            tplResult = await saveAgentTemplate(cfg, body, templateName);
+        const r = await addAgent(cfg, { body, send: true });
+        const ok = /success/i.test(String(r.result ?? ''));
+        console.log(`${ok ? '✅' : '⚠'} 代理保存已请求（agentresult=${r.result || '无'}）`);
+        if (tplResult)
+            console.log(`  模板「${templateName}」：${tplResult.ok ? '✅ 已保存' : '⚠️ 未确认'}`);
+        console.log(`  响应：${JSON.stringify(r.raw ?? {})}`);
+        // 回读核验：到列表里找这条（找不回报「未确认」，不谎报成功）
+        // ⚠️ 必须带 status=1（未结束）并**翻页**：按人筛选在 all 视图可能命中数百条已结束的历史，
+        //    只翻第 1 页会漏掉刚建的那条，误报「回读未确认」。
+        try {
+            const want = (it) => it.agentUid === body.agentuid && it.beginDate === body.beginDate && it.endDate === body.endDate;
+            let hit = null;
+            for (let page = 1; page <= 5 && !hit; page++) {
+                const check = await getAgentList(cfg, { view: 'all', agent: body.agentuid, beAgent: body.bagentuid, status: '1', page, pageSize: '100' });
+                hit = (check.items || []).find(want) ?? null;
+                if ((check.items || []).length < 100)
+                    break;
+            }
+            console.log(hit
+                ? `  ✅ 已核验：列表中出现该条代理（状态 ${hit.status || '?'}）`
+                : '  ⚠️ 回读未确认：列表中暂未查到该条，请到 OA「流程代理」页核对。');
+        }
+        catch (e) {
+            console.log(`  ⚠️ 回读核验失败：${e.message}`);
+        }
+        return;
+    }
+
+    if (sub === 'edit') {
+        // --agent-ids（≥2 条）走**批量**编辑（只改起止日期/时间）；--agent-id 走单条编辑
+        const batchSpec = flagStr(args, 'agent-ids');
+        if (batchSpec) {
+            const time = parseTimeSpec(flagStr(args, 'time'));
+            const opts = {
+                agentIds: batchSpec,
+                beginDate: flagStr(args, 'begin'),
+                endDate: flagStr(args, 'end'),
+                ...(time.beginTime || time.endTime ? { beginTime: time.beginTime, endTime: time.endTime } : {}),
+            };
+            const r = await editAgentBatch(cfg, { ...opts, send: !!args.flags.yes });
+            if (!r.sent) {
+                console.log(BOX_TOP);
+                console.log(`  [dry-run] 批量编辑代理（${r.body.agentids.split(',').length} 条）`);
+                console.log(DIVIDER);
+                console.log(`  代理id     = ${r.body.agentids}`);
+                console.log(`  起止日期   = ${r.body.beginDate || '(空)'} ~ ${r.body.endDate || '(空)'}`);
+                console.log(`  起止时间   = ${r.body.beginTime || '(空)'} ~ ${r.body.endTime || '(空)'}`);
+                console.log('  ⚠️ 批量编辑是**整体覆盖**这 4 个字段——只改一部分请用单条编辑（--agent-id）。');
+                console.log(`  重叠校验   = ${r.overlap.overlapCount ? `⚠️ 与 ${r.overlap.overlapCount} 条已有代理重叠（overlapIds=${r.overlap.overlapIds}）` : '✅ 无重叠'}`);
+                console.log(DIVIDER);
+                console.log(`  完整请求体：${JSON.stringify(r.body)}`);
+                console.log(BOX_TOP);
+                console.log('  确认无误后加 --yes 真正保存。');
+                return;
+            }
+            console.log(`${/success/i.test(r.result) ? '✅' : '⚠'} 批量编辑已保存（agentresult=${r.result || '无'}）`);
+            try {
+                const ids = r.body.agentids.split(',');
+                const rows = await getAgentList(cfg, { view: 'mine', status: '1', page: 1, pageSize: '100' });
+                for (const id of ids) {
+                    const hit = (rows.items || []).find((it) => String(it.agentId) === String(id));
+                    console.log(hit
+                        ? `  代理 ${id}：起止 = ${hit.beginDate} ~ ${hit.endDate}  状态 = ${hit.status}`
+                        : `  代理 ${id}：⚠️ 生效中的列表里没找到（可能被改到「已结束」）`);
+                }
+                const allHit = ids.every((id) => (rows.items || []).some((it) => String(it.agentId) === String(id)));
+                console.log(allHit ? '  ✅ 已核验：所选代理均已出现并生效。' : '  ⚠️ 回读未确认，请核查。');
+            }
+            catch (e) {
+                console.log(`  ⚠️ 回读核验失败：${e.message}`);
+            }
+            return;
+        }
+        const agentId = flagStr(args, 'agent-id');
+        if (!agentId) {
+            console.error('wfagent edit 需要 --agent-id <单条> 或 --agent-ids "537,538" <批量>');
+            process.exit(1);
+        }
+        // 编辑 = 取详情 → 改字段 → 原样回吐，所以先拿详情（它同时也是 dry-run 的"改前"）
+        const detail = await getAgentDetail(cfg, agentId);
+        const time = parseTimeSpec(flagStr(args, 'time'));
+        const overrides = {
+            beginDate: flagStr(args, 'begin'),
+            endDate: flagStr(args, 'end'),
+            ...(time.beginTime || time.endTime ? { beginTime: time.beginTime, endTime: time.endTime } : {}),
+            isCreateAgenter: flagStr(args, 'agent-create-flow'),
+            isProxyDeal: flagStr(args, 'proxy-deal'),
+            isSysCreateAgenter: flagStr(args, 'sys-create'),
+            isPendThing: flagStr(args, 'pend-thing'),
+        };
+        const fmtSpan = (d, t) => `${d}${t ? ` ${t}` : ''}`;
+        const beforeSpan = `${fmtSpan(detail.current.beginDate, detail.current.beginTime)} ~ ${fmtSpan(detail.current.endDate, detail.current.endTime)}`;
+        if (!Object.values(overrides).some((v) => v !== undefined)) {
+            console.log(`代理 ${agentId}（${detail.current.workflowName}）当前值：`);
+            console.log(`  代理期间 = ${beforeSpan}`);
+            console.log('  没给任何要改的字段。可改：--begin / --end / --time / --agent-create-flow / --proxy-deal / --sys-create / --pend-thing');
+            console.log('  ⚠️ 代理人、流程范围不可改（要换请先 takeback 再 create）。');
+            return;
+        }
+        const r = await editAgent(cfg, { agentId, detail, ...overrides, send: !!args.flags.yes });
+        if (!r.sent) {
+            console.log(BOX_TOP);
+            console.log(`  [dry-run] 编辑代理 ${agentId}（${detail.current.workflowName}）`);
+            console.log(DIVIDER);
+            console.log(`  代理期间   = ${beforeSpan}   ← 改前`);
+            console.log(`             = ${fmtSpan(r.body.beginDate, r.body.beginTime)} ~ ${fmtSpan(r.body.endDate, r.body.endTime)}   ← 改后`);
+            console.log(`  开关       = isCreateAgenter=${r.body.row_0_isCreateAgenter}  isProxyDeal=${r.body.row_0_isProxyDeal}  isSysCreateAgenter=${r.body.row_0_isSysCreateAgenter}  isPendThing=${r.body.row_0_isPendThing}`);
+            console.log(`  重叠校验   = ${r.overlap.overlapCount ? `⚠️ 与 ${r.overlap.overlapCount} 条已有代理重叠（overlapIds=${r.overlap.overlapIds}）` : '✅ 无重叠'}`);
+            console.log(DIVIDER);
+            console.log(`  完整请求体：${JSON.stringify(r.body)}`);
+            console.log(BOX_TOP);
+            console.log('  确认无误后加 --yes 真正保存。');
+            return;
+        }
+        console.log(`${/success/i.test(r.result) ? '✅' : '⚠'} 编辑已保存（agentresult=${r.result || '无'}）`);
+        try {
+            const rows = await getAgentList(cfg, { view: 'mine', status: '1', page: 1, pageSize: '100' });
+            const hit = (rows.items || []).find((it) => String(it.agentId) === String(agentId));
+            if (!hit) {
+                console.log('  ⚠️ 回读未确认：生效中的列表里没找到该条（可能已被改到「已结束」）。');
+            }
+            else {
+                const beginOk = !overrides.beginDate || String(hit.beginDate).startsWith(String(overrides.beginDate));
+                const endOk = !overrides.endDate || String(hit.endDate) === String(overrides.endDate);
+                console.log(`  回读：起止 = ${hit.beginDate} ~ ${hit.endDate}  状态 = ${hit.status}`);
+                console.log(beginOk && endOk ? '  ✅ 已核验：改后的日期与提交一致。' : '  ⚠️ 回读与提交不一致，请核查。');
+            }
+        }
+        catch (e) {
+            console.log(`  ⚠️ 回读核验失败：${e.message}`);
+        }
+        return;
+    }
+
+    if (sub === 'takeback') {
+        // --all：收回该被代理人名下的全部代理（界面「收回全部代理」，symbol=pt）
+        if (args.flags.all === true) {
+            const beAgentSpec = flagStr(args, 'be-agent');
+            let beAgentUid = '';
+            if (beAgentSpec)
+                beAgentUid = await resolveNameToUid(cfg, beAgentSpec);
+            else
+                beAgentUid = (await getAddAgentInfo(cfg)).defaultBeAgentUid;
+            if (!beAgentUid) {
+                console.error('收回全部需要被代理人（--be-agent <姓名|id>），且未能从 getAddAgentInfo 取到当前登录人。');
+                process.exit(1);
+            }
+            const backRunning = flagStr(args, 'back-running');
+            const r = await takeBackAllAgent(cfg, { beAgentUid, backRunning, send: !!args.flags.yes });
+            if (!r.sent) {
+                console.log(BOX_TOP);
+                console.log('  [dry-run] 将收回该被代理人名下的**全部**代理');
+                console.log(DIVIDER);
+                console.log(`  被代理人   = ${beAgentSpec || beAgentUid}(${r.beAgentUid})`);
+                console.log(`  backRunning= ${r.backRunning}（1=连流转中的一并收回）`);
+                console.log(`  请求体     = symbol=pt & agentid=<自动取该被代理人名下第一条生效中的代理> & bagentuid=${r.beAgentUid} & backRunning=${r.backRunning}`);
+                console.log('  ⚠️ 这是**批量**动作，会把这个被代理人名下所有代理一并标记「已结束」。');
+                console.log('  确认无误后加 --yes 真正收回。');
+                console.log(BOX_TOP);
+                return;
+            }
+            if (r.noop) {
+                console.log(`该被代理人(${r.beAgentUid})名下没有生效中的代理，无需收回。`);
+                return;
+            }
+            console.log(`${r.flag ? '✅' : '⚠'} 已发起收回全部代理（锚点 agentid=${r.agentId}，flag=${r.flag}）`);
+            try {
+                const left = await getAgentList(cfg, { view: 'all', beAgent: r.beAgentUid, status: '1', page: 1 });
+                console.log(Number(left.total) === 0
+                    ? `  ✅ 回读核验：该被代理人名下生效中的代理已为 0 条。`
+                    : `  ⚠️ 回读核验：仍有 ${left.total} 条生效中的代理，请核查。`);
+            }
+            catch (e) {
+                console.log(`  ⚠️ 回读核验失败：${e.message}`);
+            }
+            return;
+        }
+        const idSpec = flagStr(args, 'agent-ids');
+        if (!idSpec) {
+            console.error('wfagent takeback 需要 --agent-ids "69,70"（列表里的「代理id」，逗号分隔多个），或 --all 收回全部');
+            process.exit(1);
+        }
+        const ids = idSpec.split(',').map((s) => s.trim()).filter(Boolean);
+        const backRunning = flagStr(args, 'back-running');
+        const r = await takeBackAgent(cfg, {
+            agentIds: ids.join(','),
+            backRunning,
+            send: !!args.flags.yes,
+            // 逐条发；大批量时每 25 条报一次进度（走 stderr，不污染 --json）
+            onProgress: (i, total, id) => {
+                if (total > 25 && (i === 1 || i % 25 === 0))
+                    console.error(`  正在收回 ${i}/${total}（agentid=${id}）…`);
+            },
+        });
+        if (!r.sent) {
+            console.log(BOX_TOP);
+            console.log(`  [dry-run] 将收回 ${ids.length} 条代理`);
+            console.log(DIVIDER);
+            console.log(`  代理id     = ${ids.slice(0, 20).join(', ')}${ids.length > 20 ? ` …（共 ${ids.length} 个）` : ''}`);
+            console.log(`  backRunning= ${r.backRunning}（1=连流转中的一并收回）`);
+            console.log(`  请求体     = symbol=it & agentid=<每个id> & backRunning=${r.backRunning}`);
+            console.log('  确认无误后加 --yes 真正收回。');
+            console.log(BOX_TOP);
+            return;
+        }
+        const failed = r.results.filter((x) => !x.flag);
+        console.log(`${failed.length ? '⚠' : '✅'} 已发起收回 ${ids.length} 条：接口回 flag=true 的 ${r.okCount} 条${failed.length ? `，失败/未确认 ${failed.length} 条（${failed.slice(0, 5).map((x) => x.agentId).join(',')}${failed.length > 5 ? ' …' : ''}）` : ''}`);
+        // ⚠️ 收回是「把 agenttype 置 0（已结束）」，行**不会消失**；且少传 symbol 时接口回 true 却毫无效果
+        // ——所以必须按**状态码**回读核验，不能看"行在不在"。
+        try {
+            const after = new Map();
+            let page = 1;
+            while (true) {
+                const p = await getAgentList(cfg, { view: 'mine', page, pageSize: '100' });
+                for (const it of p.items)
+                    after.set(String(it.agentId), it.statusCode);
+                if (p.items.length < 100 || page > 20)
+                    break;
+                page++;
+            }
+            const notDone = ids.filter((id) => after.get(String(id)) !== '0');
+            console.log(notDone.length
+                ? `  ⚠️ 回读核验：${ids.length - notDone.length}/${ids.length} 条已为「已结束」，仍有 ${notDone.length} 条没变（${notDone.slice(0, 8).join(',')}${notDone.length > 8 ? ' …' : ''}）——请核查。`
+                : `  ✅ 回读核验：${ids.length} 条均已标记「已结束」。`);
+        }
+        catch (e) {
+            console.log(`  ⚠️ 回读核验失败：${e.message}`);
+        }
+        return;
+    }
+
+    if (sub !== 'list') {
+        console.error(`wfagent 暂只支持 list / conditions / templates / create / edit / takeback，收到: ${sub}`);
+        process.exit(1);
+    }
+    const statusSpec = flagStr(args, 'status');
+    const status = resolveWfagentStatus(statusSpec);
+    if (status === undefined) {
+        console.error(`未知代理状态「${statusSpec}」，可选：${Object.keys(WFAGENT_STATUS).join(' / ')}`);
+        process.exit(1);
+    }
+    // 列表的按人筛选是「查他人数据」→ 走范围校验（姓名经 blog at-list 解析，硬规则）
+    const listAgentSpec = flagStr(args, 'agent');
+    const listBeAgentSpec = flagStr(args, 'be-agent');
+    const agentFilter = listAgentSpec ? await assertNamesInScope(cfg, [listAgentSpec], { domain: 'wfagent' }) : undefined;
+    const beAgentFilter = listBeAgentSpec ? await assertNamesInScope(cfg, [listBeAgentSpec], { domain: 'wfagent' }) : undefined;
+    const r = await getAgentList(cfg, {
+        view,
+        status,
+        agent: agentFilter,
+        beAgent: beAgentFilter,
+        wftype: flagStr(args, 'wftype'),
+        workflowPath: flagStr(args, 'workflow-path'),
+        // 日期沿用仓库惯例：单值=当天，双值="起 止"（同 todo --create-time）
+        beginFrom: parseTimeRange(flagStr(args, 'begin') ?? '').from,
+        beginTo: parseTimeRange(flagStr(args, 'begin') ?? '').to,
+        endFrom: parseTimeRange(flagStr(args, 'end') ?? '').from,
+        endTo: parseTimeRange(flagStr(args, 'end') ?? '').to,
+        dept: flagStr(args, 'dept'),
+        subcom: flagStr(args, 'subcom'),
+        page: Number(flagStr(args, 'page') ?? '1') || 1,
+        pageSize: flagStr(args, 'page-size'),
+    });
+    // 代理办理记录是「流程列表」→ 复用节点名解析，把 currentnodeid（id）显示成节点名
+    if (view === 'records')
+        await annotateNodeNamesForCli(cfg, r.items, args);
+    if (args.flags.raw) {
+        console.error('===== RAW getList =====');
+        console.error(JSON.stringify(r.raw.getList, null, 2));
+        console.error('===== RAW datas =====');
+        console.error(JSON.stringify(r.raw.datas, null, 2));
+        console.error('===== RAW counts =====');
+        console.error(JSON.stringify(r.raw.counts, null, 2));
+        console.error('===== 解析结果 =====');
+    }
+    if (args.flags.json) {
+        console.log(JSON.stringify({
+            view,
+            viewTitle: r.viewTitle,
+            page: r.page,
+            pageSize: r.pageSize,
+            total: r.total,
+            count: r.items.length,
+            items: r.items.map((it) => withLink('wfagent', it, base)),
+        }, null, 2));
+        return;
+    }
+    console.log(`E9 流程代理 · ${r.viewTitle}  第 ${r.page} 页（每页 ${r.pageSize ?? 10} 条）  共 ${r.total ?? '?'} 条`);
+    if (!r.items.length) {
+        console.log('（无数据）');
+        if (args.flags.raw)
+            console.error('提示：用 --raw 查看真实响应校准解析。');
+        return;
+    }
+    for (let i = 0; i < r.items.length; i++) {
+        const it = r.items[i];
+        if (view === 'records') {
+            // 代理产生的流程：标题必须渲染成流程详情超链接（列表超链接硬规则）
+            console.log(`${i + 1}. ${hyperlinkFor('wfagent', it, base, it.title || '(无标题)')}`);
+            const meta = [
+                it.principal ? `被代理人=${it.principal}` : null,
+                it.handler ? `代理人=${it.handler}` : null,
+                nodeLabel(it),
+                it.creator ? `流程发起人=${it.creator}` : null,
+                it.createTime,
+            ].filter(Boolean).join(' | ');
+            if (meta)
+                console.log(`   ${meta}`);
+        }
+        else {
+            console.log(`${i + 1}. ${it.agent || '(未知代理人)'}  ← 被代理人 ${it.beAgent || it.operator || '?'}`);
+            const meta = [
+                it.workflowName,
+                it.workflowType,
+                `${it.beginDate ?? '?'} ~ ${it.endDate ?? '?'}`,
+                it.status,
+                it.operator ? `创建人=${it.operator}` : null,
+                it.agentId ? `代理id=${it.agentId}` : null,
+            ].filter(Boolean).join(' | ');
+            if (meta)
+                console.log(`   ${meta}`);
+        }
+    }
+    const pageSize = r.pageSize ?? 10;
+    if (r.total != null && r.page * pageSize < r.total)
+        console.log(`还有更多，用 --page <页码> 继续（每页 ${pageSize} 条）。`);
+}
+
 async function runOdoc(args) {
     const sub = args._[1] ?? 'todo';
     const cfg = loadConfig(flagStr(args, 'config'));
@@ -2395,6 +2987,7 @@ async function runOdoc(args) {
         customTabId: flagStr(args, 'custom-tab-id'),
         page: Number(flagStr(args, 'page') ?? '1') || 1,
     });
+    await annotateNodeNamesForCli(cfg, r.items, args);
     if (args.flags.raw) {
         console.error('===== RAW getCustomPageList =====');
         console.error(JSON.stringify(r.raw.getCustomPageList, null, 2));
@@ -2419,8 +3012,9 @@ async function runOdoc(args) {
                 odocTypeName: it.odocTypeName,
                 issuedNum: it.issuedNum,
                 receiveNum: it.receiveNum,
-                currentNodeId: it.currentNodeId,
-                currentNode: it.currentNode,
+                stageName: it.stageName,
+                node: it.node,
+                nodeName: it.nodeName,
                 createrId: it.createrId,
                 createDate: it.createDate,
                 lastOperateDate: it.lastOperateDate,
@@ -2442,10 +3036,12 @@ async function runOdoc(args) {
         const it = r.items[i];
         const nameLinked = hyperlinkFor('odoc', it, odocBase, it.requestName ?? '(无标题)');
         console.log(`${i + 1}. ${nameLinked}`);
+        // 环节名（如「拟稿」）+ 当前节点（解析出名字时用「名字(id)」，否则退回 id）
+        const nodeText = [it.stageName, nodeLabel(it)].filter(Boolean).join(' · ');
         const meta = [
             it.odocTypeName,
             it.issuedNum ? `发文字号=${it.issuedNum}` : null,
-            it.currentNodeId,
+            nodeText || null,
             it.createrId ? `拟稿人=${it.createrId}` : null,
             it.createDate,
             it.lastOperateDate ? `最后修改=${it.lastOperateDate}` : null,
@@ -2566,7 +3162,88 @@ async function runKq(args) {
         console.log(BOX_TOP);
         return;
     }
-    console.error(`kq 暂只支持 status / punch，收到: ${sub}`);
+    if (sub === 'report' || sub === 'detail') {
+        const month = flagStr(args, 'month');
+        const year = flagStr(args, 'year');
+        if (month && year) {
+            console.error('--month 与 --year 只能传一个。');
+            process.exit(1);
+        }
+        // 目标人员：--user <id> / --user-name <姓名>；都不传 = 当前登录人（cookie loginuuids）
+        let targetId = flagStr(args, 'user') ?? '';
+        const userName = flagStr(args, 'user-name');
+        if (!targetId && userName)
+            targetId = await assertNamesInScope(cfg, [userName], { domain: 'kq' });
+        if (!targetId)
+            targetId = parseUserIdFromCookie(cfg.cookie);
+        if (!targetId) {
+            console.error('未能确定目标人员：请传 --user <id> 或 --user-name <姓名>，或确认 cookie 含 loginuuids。');
+            process.exit(1);
+        }
+        // 越权边界（默认停用；E9_SCOPE_ENFORCE=1 时启用）：目标须 ∈ {本人 + 全部层级下属}
+        await assertUserIdsInScope(cfg, [targetId], { domain: 'kq' });
+        const type = year && !month ? '1' : '2';
+        const typevalue = month || year || undefined;
+        if (sub === 'detail') {
+            const r = await getKqMonthReport(cfg, { typevalue, resourceId: targetId });
+            if (args.flags.raw) {
+                console.error('===== RAW getHrmKQMonthReportInfo =====');
+                console.error(JSON.stringify(r.raw, null, 2));
+            }
+            if (args.flags.json) {
+                console.log(JSON.stringify({ typevalue: r.typevalue, resourceId: r.resourceId, days: r.days }, null, 2));
+                return;
+            }
+            console.log(`E9 考勤明细  ${r.typevalue}  人员 id=${targetId}  共 ${r.days.length} 天`);
+            const withSign = r.days.filter((d) => d.signIn || d.signOut || d.types.length);
+            if (!withSign.length) {
+                console.log('（本月无打卡记录）');
+                return;
+            }
+            for (const d of withSign) {
+                const flags = d.types.length ? `  [${d.types.join(',')}]` : '';
+                console.log(`  ${d.date}  签到 ${d.signIn || '—'} → 签退 ${d.signOut || '—'}${flags}`);
+            }
+            return;
+        }
+        const r = await getKqReport(cfg, { type, typevalue, resourceId: targetId });
+        if (args.flags.raw) {
+            console.error('===== RAW getHrmKQReportInfo =====');
+            console.error(JSON.stringify(r.raw, null, 2));
+        }
+        if (args.flags.json) {
+            console.log(JSON.stringify({
+                typevalue: r.typevalue, view: type === '1' ? 'year' : 'month', resourceId: r.resourceId,
+                attendance: r.attendance, durations: r.durations, exceptions: r.exceptions, leave: r.leave,
+            }, null, 2));
+            return;
+        }
+        console.log(BOX_TOP);
+        console.log(`E9 考勤统计  ${r.typevalue}（${type === '1' ? '年' : '月'}视图）  人员 id=${targetId}`);
+        console.log(DIVIDER);
+        console.log(`  出勤统计：应出勤 ${r.attendance.workDays}`);
+        for (const it of r.attendance.items)
+            console.log(`    ${it.title} = ${it.value}`);
+        const line = (label, arr) => {
+            if (!arr.length)
+                return;
+            console.log(`  ${label}：${arr.map((x) => `${x.title} ${x.value}`).join('  |  ')}`);
+        };
+        line('流程时长', r.durations);
+        line('异常', r.exceptions);
+        if (r.leave.length) {
+            console.log(DIVIDER);
+            console.log('  假期余额（可请天数）：');
+            for (const g of r.leave) {
+                const items = g.items.map((x) => `${x.title} ${x.value}`).join('  |  ');
+                if (items)
+                    console.log(`    ${g.title}：${items}`);
+            }
+        }
+        console.log(BOX_TOP);
+        return;
+    }
+    console.error(`kq 暂只支持 status / punch / report / detail，收到: ${sub}`);
     process.exit(1);
 }
 /** CLI 侧当前时刻 HH:mm:ss（与 kq.ts 的 nowHHmmss 同逻辑，CLI 输出用）。 */
@@ -3781,8 +4458,9 @@ async function runSubordinate(args) {
         console.error(JSON.stringify(r.raw.counts, null, 2));
         console.error('===== 解析结果 =====');
     }
+    const subBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
     if (args.flags.json) {
-        console.log(JSON.stringify({ lastname, allLevel, page, pageSize: r.pageSize, total: r.total, count: r.count, items: r.items.map((it) => ({ id: it.id, name: it.name, fields: it.fields })) }, null, 2));
+        console.log(JSON.stringify({ lastname, allLevel, page, pageSize: r.pageSize, total: r.total, count: r.count, items: r.items.map((it) => withLink('hrm', { id: it.id, name: it.name, fields: it.fields }, subBase)) }, null, 2));
         return;
     }
     console.log(`我的下属${allLevel ? '（全部层级）' : '（直接下属）'}${name ? ` · 姓名过滤「${name}」` : ''} [第 ${page} 页${r.pageSize != null ? ` · 每页 ${r.pageSize} 条` : ''}${r.total != null ? ` / 共 ${r.total} 人` : ''}]  当前 ${r.count} 人`);
@@ -3790,13 +4468,16 @@ async function runSubordinate(args) {
         console.log('（无下属）');
         return;
     }
-    const cols = (r.columns || []).filter((c) => c.dataIndex && c.dataIndex !== 'randomFieldId');
+    // 表头同样排除 id 列（服务端把 id 列的标题误标为「是否在线」，列出来会误导）与 randomFieldId
+    const hdrIdCol = r.items[0]?.idCol;
+    const cols = (r.columns || []).filter((c) => c.dataIndex && c.dataIndex !== 'randomFieldId' && c.dataIndex !== hdrIdCol);
     if (cols.length)
         console.log(`字段(${cols.length}): ${cols.map((c) => c.title ?? c.dataIndex).join(' | ')}`);
     for (let i = 0; i < r.items.length; i++) {
         const it = r.items[i];
-        console.log(`${i + 1}. ${it.name || '(无姓名)'}  [id=${it.id || ''}]`);
-        const meta = it.fields.filter((f) => f.value && f.title && f.dataIndex !== it.idCol).slice(0, 6).map((f) => `${f.title}=${f.value}`).join(' | ');
+        console.log(`${i + 1}. ${hyperlinkFor('hrm', { id: it.id }, subBase, it.name || '(无姓名)')}  [id=${it.id || ''}]`);
+        // 排除内部列：id 列（其标题被服务端误标为「是否在线」）、姓名列（已作可点标题）、randomFieldId（id 的副本）
+        const meta = it.fields.filter((f) => f.value && f.title && f.dataIndex !== it.idCol && f.dataIndex !== it.nameCol && f.dataIndex !== 'randomFieldId').slice(0, 6).map((f) => `${f.title}=${f.value}`).join(' | ');
         if (meta)
             console.log(`   ${meta}`);
     }
@@ -3804,6 +4485,18 @@ async function runSubordinate(args) {
 
 // ─── 组织人事（HRM）搜索 ─────────────────────────────────
 
+/**
+ * hrm search 结果里值为「字典编码」的列（dataIndex）。
+ * E9 在人事搜索接口（hrm/search/getHrmSearchResult）里**不解析**这些字段——给的是 id/code，
+ * 而同为人员列表的 subordinateinfo/getSearchResult 会解析（部门/分部/直接上级都给中文名）。
+ * 实测：岗位 jobtitlespan 给的就是 "1830"、性别 sexspan 给 "1"。OA 的「查询人员」页同样只显示编码。
+ * 故渲染时标注「（编码）」，避免用户把 1830 误读成名称。
+ */
+const HRM_CODE_FIELDS = new Set([
+    'sex', 'accounttype', 'belongto', 'jobtitle', 'jobGroupId',
+    'jobactivity', 'jobcall', 'joblevel', 'status', 'systemlanguage', 'locationid',
+]);
+
 /** 组织节点名称 → id（用于 --dept/--subcompany 名称定位；纯数字原样直传）。 */
 async function resolveHrmOrgValue(cfg, keyword, { matchType, flag }) {
     const node = await findHrmOrgNode(cfg, keyword, { matchType });
@@ -3859,8 +4552,56 @@ async function runHrm(args) {
         }
         return;
     }
+    if (sub === 'tree') {
+        // 组织架构树：无参列顶层分部；--dept/--subcompany 定位到该组织后展开；--id（+可选 --type）直接指定起点；--depth 展示层数
+        const depth = Math.min(Math.max(Number(flagStr(args, 'depth') ?? '1') || 1, 1), 5);
+        const deptSpec = flagStr(args, 'dept');
+        const subSpec = flagStr(args, 'subcompany');
+        let start = { type: '0', id: '0' };
+        let located = null;
+        if (deptSpec || subSpec) {
+            const kw = deptSpec ?? subSpec;
+            const wantType = deptSpec ? '2' : '1';
+            const label = deptSpec ? '部门' : '分部';
+            if (/^\d+$/.test(kw)) {
+                located = { id: kw, type: wantType, name: kw };
+            }
+            else {
+                located = await findHrmOrgNode(cfg, kw, { matchType: wantType });
+                if (!located)
+                    throw new Error(`未找到${label}「${kw}」。可先跑 e9 hrm tree 查看顶层分部，或改用数字 id。`);
+            }
+            start = { type: located.type, id: located.id };
+        }
+        else if (flagStr(args, 'id')) {
+            start = { type: flagStr(args, 'type') ?? '1', id: flagStr(args, 'id') };
+        }
+        const r = await expandHrmOrgTree(cfg, { ...start, depth });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ start, located, depth, nodes: r.nodes, total: r.total, truncated: r.truncated }, null, 2));
+            return;
+        }
+        console.log(located
+            ? `E9 组织架构 · ${located.name || located.id}（type=${start.type} id=${start.id}）`
+            : 'E9 组织架构 · 顶层分部');
+        if (!r.nodes.length) {
+            console.log('（无下级组织）');
+            return;
+        }
+        const render = (nodes, indent) => {
+            for (const n of nodes) {
+                const kind = n.type === '1' ? '分部' : n.type === '2' ? '部门' : `type=${n.type}`;
+                console.log(`${indent}${n.name}  [${kind} id=${n.id}]`);
+                if (n.children.length)
+                    render(n.children, indent + '  ');
+            }
+        };
+        render(r.nodes, '  ');
+        console.log(`\n共 ${r.total} 个组织节点${r.truncated ? '（已达显示上限，结果被截断）' : ''}。`);
+        return;
+    }
     if (sub !== 'search') {
-        console.error(`hrm 子命令: tabs/conditions/search，收到: ${sub}`);
+        console.error(`hrm 子命令: tabs/conditions/search/tree，收到: ${sub}`);
         process.exit(1);
     }
     const tab = flagStr(args, 'tab') ?? '全部人员';
@@ -3940,19 +4681,52 @@ async function runHrm(args) {
         const it = r.items[i];
         const head = hyperlinkFor('hrm', it, base, it.name || '(无姓名)');
         console.log(`${i + 1}. ${head}  [id=${it.id || ''}]`);
-        // 行 meta 去掉姓名（head 已显示）与 id 类列，避免重复
-        const meta = it.fields.filter((f) => !['lastname', 'id', 'randomField0', 'randomFieldId'].includes(f.dataIndex)).slice(0, 8).map((f) => `${f.title}=${f.value}`).join(' | ');
+        // 行 meta 去掉姓名（head 已显示）与 id 类列，避免重复；字典编码字段标注「（编码）」
+        const meta = it.fields
+            .filter((f) => !['lastname', 'id', 'randomField0', 'randomFieldId'].includes(f.dataIndex))
+            .slice(0, 8)
+            .map((f) => `${f.title}=${f.value}${f.value && HRM_CODE_FIELDS.has(f.dataIndex) ? '（编码）' : ''}`)
+            .join(' | ');
         if (meta)
             console.log(`   ${meta}`);
     }
 }
 
+/**
+ * 节点名解析：默认开启，`--no-node-name` 或环境变量 E9_NO_NODE_NAME=1 停用。
+ * 接口失败/接口不存在时静默降级（列表照常出，只是节点列回退显示 id）。
+ */
+function annotateNodeNamesForCli(cfg, items, args) {
+    // --raw 是校准/排障出口，保持原样不额外请求；--no-node-name / E9_NO_NODE_NAME=1 显式关闭。
+    const disabled = args.flags['no-node-name'] === true || args.flags.raw === true || isNodeNameDisabled();
+    return annotateNodeNames(cfg, items, { disabled });
+}
+/** 解析 --time "HH:MM-HH:MM"；不传返回空串（= 全天）。 */
+function parseTimeSpec(raw) {
+    const s = String(raw ?? '').trim();
+    if (!s)
+        return { beginTime: '', endTime: '' };
+    const m = s.split(/[-~—]/).map((x) => x.trim()).filter(Boolean);
+    if (m.length !== 2) {
+        console.error('--time 格式应为 "HH:MM-HH:MM"');
+        process.exit(1);
+    }
+    return { beginTime: m[0], endTime: m[1] };
+}
+
+/** 节点显示：解析到名字时用「名字(id)」，否则退回 id。 */
+function nodeLabel(item) {
+    const id = item?.node ? String(item.node) : '';
+    if (!id)
+        return undefined;
+    return item.nodeName ? `${item.nodeName}(${id})` : id;
+}
 function printTodoItems(items, base, { indent = '', max = 10 } = {}) {
     const visible = items.slice(0, max);
     for (let i = 0; i < visible.length; i++) {
         const it = visible[i];
         const head = it.title ?? '(无标题)';
-        const meta = [it.creator, it.currentOperator ? `未操作者=${it.currentOperator}` : null, it.node, it.createdate].filter(Boolean).join(' | ');
+        const meta = [it.creator, it.currentOperator ? `未操作者=${it.currentOperator}` : null, nodeLabel(it), it.createdate].filter(Boolean).join(' | ');
         const headLinked = hyperlinkFor('todo', it, base, head);
         console.log(`${indent}${i + 1}. ${headLinked}${it.level ? `  (${it.level})` : ''}`);
         if (meta)
@@ -3980,9 +4754,15 @@ async function runTodoBatch(args) {
     }
     else {
         // 批量关注：dry-run 也先查关注类型（只读），供用户确认加入哪个关注类型
+        // 关注在 待办/已办/我发起 三个分类下都有「我的关注」页签，故定位列表可用 --category 指定（默认待办）
+        const category = flagStr(args, 'category') ?? 'todo';
+        if (!['todo', 'done', 'mine'].includes(category)) {
+            console.error(`batch-attention 的 --category 只支持 todo（待办）/ done（已办）/ mine（我发起），收到: ${category}`);
+            process.exit(1);
+        }
         const attentionTypes = await getAttentionTypes(cfg, requestIds);
         const attentionId = flagStr(args, 'attention-id') ?? attentionTypes[0]?.id;
-        preview = { operation: '批量关注', requestIds, attentionId, attentionTypes: attentionTypes.map((t) => ({ id: t.id, showname: t.showname })) };
+        preview = { operation: '批量关注', category, requestIds, attentionId, attentionTypes: attentionTypes.map((t) => ({ id: t.id, showname: t.showname })) };
     }
     if (!args.flags.yes) {
         console.log(BOX_TOP);
@@ -3998,7 +4778,7 @@ async function runTodoBatch(args) {
     else if (sub === 'batch-forward')
         result = await batchForward(cfg, { requestIds, receiver: preview.receiver, remark: preview.remark });
     else
-        result = await batchAttention(cfg, { requestIds, attentionId: preview.attentionId });
+        result = await batchAttention(cfg, { requestIds, attentionId: preview.attentionId, category: preview.category });
     const body = result.result?.json ?? {};
     const ok = result.result?.ok && body.success !== false && body.status !== false;
     console.log(`${ok ? '✅' : '⚠'} ${preview.operation}已请求处理（${requestIds.length} 条）。`);
@@ -4046,7 +4826,7 @@ async function main() {
     const cmd = args._[0] ?? 'todo';
     if (cmd === 'version') {
         const buildHash = createHash('sha256').update(fs.readFileSync(new URL(import.meta.url))).digest('hex').slice(0, 12);
-        console.log(JSON.stringify({ name: 'weaver-e9-assistant-cli', version: '1.1.3', buildHash }, null, 2));
+        console.log(JSON.stringify({ name: 'weaver-e9-assistant-cli', version: '1.1.5', buildHash }, null, 2));
         return;
     }
     if (cmd === 'whoami') {
@@ -4085,6 +4865,14 @@ async function main() {
         await runWorkplan(args);
         return;
     }
+    if (cmd === 'supervise') {
+        await runSupervise(args);
+        return;
+    }
+    if (cmd === 'wfagent') {
+        await runWfagent(args);
+        return;
+    }
     if (cmd === 'odoc') {
         await runOdoc(args);
         return;
@@ -4219,6 +5007,43 @@ async function main() {
         return typeof saved === 'string' ? saved : undefined;
     };
     const queryBool = (key) => args.flags[key] === true || savedQueryFlags[key] === true;
+    // ★按节点名筛选（--node-name）：节点 id 是**流程内编号**，必须先定位流程才能解析成 id。
+    //   与 --node-id 互斥；未给 --workflow 时只在**本地缓存**的节点表里找（缓存来自历次列表查询）。
+    let nodeIdFilter = queryFlag('node-id');
+    const nodeNameFilter = queryFlag('node-name');
+    if (nodeNameFilter) {
+        // --json 时信息一律走 stderr，保证 stdout 是纯 JSON
+        const say = args.flags.json ? console.error : console.log;
+        if (nodeIdFilter)
+            throw new Error('--node-name 与 --node-id 不能同时用（两者都在指定当前节点）。');
+        const wfScope = String(workflowFilter ?? '').split(',').map((s) => s.trim()).filter(Boolean);
+        if (wfScope.length > 1)
+            throw new Error(`--node-name 需要唯一的流程范围，但 --workflow 传了 ${wfScope.length} 个流程；请只保留一个。`);
+        const resolved = await resolveNodeByName(cfg, nodeNameFilter, { workflowId: wfScope[0] });
+        const pick = resolved.exact.length === 1 ? resolved.exact[0] : null;
+        if (!pick) {
+            if (resolved.unavailable) {
+                console.error(`取不到流程 ${wfScope[0]} 的节点表（/api/workflow/test/getNodeInfo 不可用），无法按节点名筛选；请改用 --node-id <id>。`);
+                process.exit(1);
+            }
+            if (resolved.candidates.length === 0) {
+                console.error(resolved.scoped
+                    ? `流程 ${wfScope[0]} 的节点表里没有匹配「${nodeNameFilter}」的节点。`
+                    : `本地缓存的 ${resolved.poolSize} 个流程节点表里没有匹配「${nodeNameFilter}」的节点。可加 --workflow <流程id> 限定流程，或先在待办列表里翻到该流程任意一条以缓存其节点表。`);
+                process.exit(1);
+            }
+            say(BOX_TOP);
+            say(`  「${nodeNameFilter}」匹配到 ${resolved.candidates.length} 个节点，请选一个后再用 --node-id 指定：`);
+            say(DIVIDER);
+            for (const c of resolved.candidates)
+                say(`  ${String(c.nodeId).padStart(6, ' ')}  ${c.nodeName}${c.matchType === 'exact' ? ' ★(精确)' : ''}  ← ${c.workflowName ?? '(未命名流程)'}（流程 ${c.workflowId}）`);
+            say(BOX_TOP);
+            say(`  例：e9 todo ${sub} --node-id ${resolved.candidates[0].nodeId} --workflow ${resolved.candidates[0].workflowId}`);
+            process.exit(0);
+        }
+        nodeIdFilter = pick.nodeId;
+        say(`按节点名筛选：「${pick.nodeName}」→ 节点 id=${pick.nodeId}（流程 ${pick.workflowName ?? pick.workflowId}）`);
+    }
     let workflowTypeFilter = queryFlag('workflow-type');
     if (workflowTypeFilter && !/^\d+$/.test(workflowTypeFilter)) {
         const resolvedType = await resolveWorkflowType(cfg, workflowTypeFilter, { category, viewcondition });
@@ -4248,7 +5073,7 @@ async function main() {
         requestLevel: queryFlag('request-level'),
         requestMark: queryFlag('request-mark'),
         workflowType: workflowTypeFilter,
-        nodeId: queryFlag('node-id'),
+        nodeId: nodeIdFilter,
         flowStatus: queryFlag('flow-status'),
         totalOnly: queryBool('total-only'),
         debug: queryBool('debug'),
@@ -4258,6 +5083,7 @@ async function main() {
     const shouldGroup = !listOpts.subCategory && !tab && !listOpts.totalOnly && !queryBool('ungrouped') && !queryBool('raw');
     if (shouldGroup) {
         const grouped = await getOaTabGroups(cfg, { ...listOpts, category });
+        await annotateNodeNamesForCli(cfg, grouped.groups.flatMap((g) => g.items), args);
         const scope = CATEGORY_SCOPE[category] ?? CATEGORY_SCOPE.todo;
         const groupedSnapshot = {
             category,
@@ -4295,6 +5121,7 @@ async function main() {
         return;
     }
     const result = await getWfList(cfg, listOpts);
+    await annotateNodeNamesForCli(cfg, result.items, args);
     const savedResult = persistSearchResult(result, `E9 ${name ?? key} 查询`);
     if (args.flags.raw) {
         console.error('===== RAW getWfListParams =====');
@@ -4325,6 +5152,7 @@ async function main() {
                 creatorId: it.creatorId,
                 currentOperator: it.currentOperator,
                 node: it.node,
+                nodeName: it.nodeName,
                 createdate: it.createdate,
                 receivedate: it.receivedate,
                 status: it.status,
@@ -4406,15 +5234,39 @@ async function runTodoSubmit(args) {
     }
     const remark = flagStr(args, 'remark') ?? 'OK';
     const send = !!args.flags.yes;
+    // --field-values '<json>'：提交时修改字段值。此前 CLI 声明了该参数却从未解析/传入（静默失效）。
+    const fvRaw = flagStr(args, 'field-values');
+    let fieldValues;
+    if (fvRaw) {
+        try {
+            fieldValues = JSON.parse(fvRaw);
+        }
+        catch {
+            console.error(`--field-values 不是合法 JSON：${fvRaw}`);
+            process.exit(1);
+        }
+        if (!fieldValues || typeof fieldValues !== 'object' || Array.isArray(fieldValues)) {
+            console.error('--field-values 需为对象，如 \'{"70702":"新值"}\'');
+            process.exit(1);
+        }
+    }
     if (!send) {
         console.log(BOX_TOP);
         console.log(`  [dry-run] 提交待办 requestid=${requestId}`);
         console.log(`  签字意见 = ${remark}`);
+        if (fieldValues && Object.keys(fieldValues).length)
+            console.log(`  字段修改 = ${JSON.stringify(fieldValues)}`);
+        // dry-run 即校验字段属性（当前节点）：只读/隐藏字段禁止填值——避免"预览通过、提交才报错"
+        if (fieldValues && Object.keys(fieldValues).length) {
+            const bad = await validateFieldValuesAtNode(cfg, requestId, fieldValues);
+            if (bad.length)
+                throw new Error(`拒绝填写当前节点的只读/隐藏字段：${bad.map((b) => `${b.label || b.id}(${VIEWATTR_LABEL[b.viewattr] ?? 'va=' + b.viewattr})`).join('、')}。本节点只允许修改「可编辑」字段，不得绕过节点字段权限自行填值。`);
+        }
         console.log('  确认无误后加 --yes 真正提交。');
         console.log(BOX_TOP);
         return;
     }
-    const res = await submitTodo(cfg, { requestId, remark });
+    const res = await submitTodo(cfg, { requestId, remark, fieldValues });
     console.log(BOX_TOP);
     const j = res.json;
     const ok = j?.data?.type === 'SUCCESS' || j?.type === 'SUCCESS';