weaver-e9-assistant-cli 1.0.0

package/dist/cli.js

@@ -0,0 +1,4041 @@
+#!/usr/bin/env node
+// @ts-nocheck
+import fs from 'node:fs';
+import { createHash } from 'node:crypto';
+import { loadConfig, resolveViewcondition, endpointFor, setConfigField } from './config.js';
+import { getWfList, getSmartTodoGroups, resolveWorkflowType } from './workflow.js';
+import { parseIdList, batchSubmit, batchForward, batchAttention, getAttentionTypes } from './todobatch.js';
+import { pageUrl, availablePages } from './pageopen.js';
+import { buildBlogMyUrl, buildCubeCardUrl, buildCubeSearchUrl, normalizeE9Url } from './links.js';
+import { createContext, loadContext, updateContext } from './createcontext.js';
+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 { rejectTodo } from './todoreject.js';
+import { transferTodo } from './todotransfer.js';
+import { forwardTodo, circulateTodo } from './todoforward.js';
+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 } from './blog.js';
+import { getCreateWfList, buildCreateWfUrl, buildRequestFormUrl, findCreateWfByName } from './wfcreate.js';
+import { describeFormFields } 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 } from './workplan.js';
+import { listOdocTodo, getOdocTodoCount, listOdocCreate } from './odoc.js';
+import { punch, getButtons, resolvePunchItem, signSecret, buildEncryptObj } 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 } from './cube.js';
+import { getCurrentUser } from './wfuser.js';
+import { parseArgs, flagStr, flagBool } from './args.js';
+import { todayStr } from './util.js';
+import { BOX_TOP, DIVIDER } from './render.js';
+function usage() {
+    return [
+        'E9 个人助手 CLI',
+        '',
+        '用法:',
+        '  e9 version',
+        '  e9 todo list [--tab <key>] [--page <n>] [--keyword <text>] [--exclude-current-user]',
+        '              [--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>]',
+        '  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]   退回/驳回待办',
+        '  e9 todo transfer --requestid <id> --receiver <uid> | --receiver-name <姓名> [--remark "转办"] [--yes]   转办（处理权转移）',
+        '  e9 todo forward --requestid <id> --receiver <uid> | --receiver-name <姓名> [--remark "转发"] [--yes]   转发（分享给某人看）',
+        '  e9 todo circulate --requestid <id> --receiver <uid> | --receiver-name <姓名> [--remark "传阅"] [--yes]   传阅',
+        '  e9 todo cc --requestid <id> [--remark "抄送"] [--yes]   抄送',
+        '  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 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]',
+        '  e9 blog search --content <关键词> [--start-date <YYYY-MM-DD>] [--end-date <YYYY-MM-DD>] [--page <n>]   搜索我的微博',
+        '  e9 blog view --user-id <id>                               查看某人微博主页',
+        '  e9 blog remind --user-id <id> [--workdate YYYY-MM-DD] [--yes]   催办（提醒某人写日报，默认今天）',
+        '  e9 blog reply --id <微博id> --content "<内容>" [--yes]    回复微博',
+        '  e9 blog like --id <微博id> [--yes]                       点赞/取消点赞（默认 dry-run）',
+        '  e9 blog check [--date YYYY-MM-DD]   查某天是否已写日报（按 isReCalled 区分正常发布/已撤回）；默认今天，无正常发布记录退出码 1',
+        '  e9 report collect [--date YYYY-MM-DD] [--json]   汇总当前环境可查询业务数据（非操作审计）',
+        '  e9 blog create --content "<文本>" [--content-file <路径>] [--share-type N] [--date YYYY-MM-DD] [--discuss-id <id>] [--yes]',
+        '  e9 blog recall --id <微博id> [--workdate <YYYY-MM-DD>] [--restore] [--yes]   撤回微博（--restore 恢复已撤回）',
+        '  e9 blog note --save --content "<文本>" [--content-file <路径>] [--date <YYYY-MM-DD>] [--yes]   存草稿/便签（E9 微博无独立草稿，存到工作笔记）',
+        '  e9 blog delete-reply --id <评论id> --discuss-id <微博id> [--workdate <YYYY-MM-DD>] [--yes]   删除微博评论（微博正文不可删，只能撤回）',
+        '  e9 auth token-login --consent                    登录拿 aiAgentToken（先经隐私确认：信息会经大模型处理；preflight：探测地址可达+自动装 playwright+开浏览器登录，失败引导 cookie-login）',
+        '  e9 auth cookie-login [--cookie <串> | --file <路径>] [--consent]   手动导入 cookie 走 cookie 鉴权（需先隐私确认；无需浏览器，无桌面机器的后路）',
+        '  e9 auth status [--check]                         查看当前环境 token 状态/剩余时间；--check 联网探活地址可达+鉴权是否真有效',
+        '  e9 auth consent true|false                       设置隐私确认：true=同意信息经大模型处理（登录免 --consent），false=撤销同意',
+        '  e9 config set llmConsent true                    一次性同意隐私确认（写入配置，登录免 --consent）',
+        '  e9 create list [--keyword <text>] [--tab <key>] [--json] [--raw]   我有权限新建的流程列表',
+        '  e9 create workflows [--name <关键词>]                         查找可发起流程（四步式第 1 步）',
+        '  e9 create form --workflow-id <id>                             初始化表单并创建上下文（第 2 步）',
+        '  e9 create prepare <context_id> --data <JSON>                  保存字段值并预览（第 3 步）',
+        '  e9 create create <context_id> --confirm --submit              二次确认后发起（第 4 步）',
+        '  e9 create verify <submission_id>                               核验超时发起是否已创建（禁止盲目重试）',
+        '  e9 create open --id <流程id>                          生成发起该流程的页面 URL',
+        '  e9 create open --name <流程名>                        按名查找 id 并生成发起 URL（多个候选则列出）',
+        '  e9 create open --requestid <请求id> [--id <wf>]      生成已有请求表单 URL（处理/提交待办用，手动填+提交）',
+        '  e9 create fields --id <流程id>                        模拟打开发起表单，列出字段（可编辑/只读/隐藏/控件类型）',
+        '  e9 create start [--id <id>|--name <名>] [--values <json>|--values-file <path>] [--detail-file <path>] [--file <字段id>=<路径>] [--requestname <名>] [--yes --plan <id>]  预览生成确认计划；提交复用确认字段',
+        '  e9 create flow --requestid <请求id> --workflowid <流程id> [--next-user <uid>] [--yes]  公文流转：取可流转候选→确认→推送下一节点（公文 create start 后续步骤）',
+        '  e9 page-open --page todo|done|mine|center|newflow|view [--request-id <id>]   生成流程中心页面链接',
+        '  e9 email list [--page <n>] [--subject <text>] [--from <text>] [--to <text>] [--date <语义>] [--datetype <n>] [--startdate <YYYY-MM-DD>] [--enddate <YYYY-MM-DD>] [--folder inbox|sent|<id>]   收件箱/已发送邮件列表（单步 GET）',
+        '  e9 email view --id <邮件id> [--mark-read]   查看邮件详情（元信息+正文+附件清单，默认只读）',
+        '  e9 email send --to <邮箱> --subject <主题> --content <正文> [--attachment <文件>]   写信+发送（可带附件，默认 dry-run）',
+        '  e9 email read --id <ids> [--unread]         标记已读/未读',
+        '  e9 email star --id <ids> [--unstar]         标星/取消标星',
+        '  e9 email delete --id <ids> [--permanent] [--yes]   删除邮件（默认移回收站；--permanent 彻底删除）',
+        '  e9 email move --id <ids> --folder <folderid> [--yes]   移动邮件到文件夹（0收件箱/-1已发送/-2草稿/-3已删除）',
+        '  e9 email label list|add|apply   标签：list 列表 / add 新建 / apply 贴去标签',
+        '  e9 email waitdeal --id <ids> --time <YYYY-MM-DD> [--way 5|1] [--note <文本>] [--yes]   设为待办邮件（提醒处理）',
+        '  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 my-calendar [--date <YYYY-MM-DD>] [--view-type <1|3>]   日程月视图（MyCalendar，浏览器主用）',
+        '  e9 workplan view --id <id>                       查看日程详情',
+        '  e9 workplan finish --id <id> [--yes]             完成日程',
+        '  e9 workplan delete --id <id> [--yes]             删除日程',
+        '  e9 workplan types                                列出日程类型',
+        '  e9 workplan search-conditions                    搜索可用条件（分组+字段）',
+        '  e9 workplan attention                            关注的日程',
+        '  e9 workplan base-data                            日历初始化数据（含部门/分部/组织视图）',
+        '  e9 workplan search [--name <text>] [--type <id>] [--status <id>] [--creater <id>] [--begin <YYYY-MM-DD>] [--end <YYYY-MM-DD>] [--group <全部|今天|本周|...>] [--page <n>]   日程表搜索（可过滤分页）',
+        '  e9 workplan create --name <名称> --begin "YYYY-MM-DD HH:mm" --end "YYYY-MM-DD HH:mm" [--description-file <路径>]   新建日程（默认 dry-run）',
+        '  e9 workplan import-template [--out-dir <目录>]   下载原生日程导入模板',
+        '  e9 workplan import --file <模板.xls[x]> [--yes]  批量导入日程（默认仅预览）',
+        '  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 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）',
+        '  e9 cube import-template --customid <id> [--out-dir <目录>]   下载原生台账导入模板',
+        '  e9 cube import --customid <id> --file <模板.xls[x]> [--yes]  批量导入台账（默认仅预览）',
+        '  e9 cube view   --customid <id> --billid <id>   单条记录完整详情（label=值，行尾附卡片链接）',
+        '  e9 cube search-info --customid <id>      台账字段下拉选项全表（合并字段中文名）',
+        '  e9 cube excel --customid <id> [--menu-ids <m,..>] [--page <n>]   Excel 视图取数（列含可编辑标记）',
+        '  e9 cube count --customid <id> [--menu-ids <m,..>]    聚合统计',
+        '  e9 cube group --customid <id> [--menu-ids <m,..>]     分组统计',
+        '  e9 cube card --customid <id> --mode-id <m>   卡片导出配置',
+        '  e9 cube browser --customid <id> --mode-id <m> --field-id <f> --detail-type <dt>   建模浏览框选项',
+        '  e9 cube card-fields --customid <id>   卡片字段定义（label/控件类型/可编辑/必填）',
+        '  e9 cube create --customid <id> --values <json>   新建台账记录（默认 dry-run，--yes 真提交）',
+        '  e9 cube edit --customid <id> --billid <id> --values <json>   编辑台账记录',
+        '  e9 cube delete --customid <id> --billids <id,...>   删除台账记录（默认 dry-run，--yes 真删）',
+        '  e9 cube print --customid <id> --billid <id>   打开合同详情页，用户在浏览器点打印另存 PDF',
+        '  e9 cube menus [--refresh]   列全部建模台账（目录接口为主、菜单兜底，缓存7天，一次拿全 customid+mode+app）',
+        '  e9 cube find <名称>          按名模糊匹配台账（列候选消歧，返回 customid+mode+app，供 list/create 等用）',
+        '  e9 cube find <名称> --tree-detail   展开 tree 测试类台账的全部树节点路径（默认只显首条菜单路径）',
+        '  e9 search <名称>            统一搜台账+菜单+流程（只说名字、不知归属时用，避免猜错域）',
+        '  e9 config                    查看当前配置来源与状态',
+        '  e9 config set <field> <value>   设置配置（field: baseUrl/cookie/username/menuIds/...；首次用 set baseUrl）',
+        '  e9 config init               首次配置引导',
+        '',
+        '说明:',
+        '  todo list   获取我的待办流程列表（跑 getWfListParams→splitPageKey→datas→counts 链路）',
+        '    --tab       tab key，对应 config.tabs 中的某项，默认 defaultTab',
+        '    --page      页码，默认 1',
+        '    --keyword   按标题(requestname)过滤',
+        '    --json      以 JSON 输出（适合 AI 工具消费）',
+        '    --raw       额外打印各步原始响应（首次调试必用）',
+        '    --debug     打印每步请求状态',
+        '  blog list   获取微博列表（默认今天，支持 --scope 切换范围）',
+        '    --date      日期 YYYY-MM-DD，默认今天',
+        '    --scope     范围：全部/关注/共享/下级（默认=自己的微博）',
+        '    --page      页码，默认 1',
+        '  blog search 搜索微博（GET /api/blog/base/getMyBlogListBySearch）',
+        '    --content   搜索关键词（必填）',
+        '    --start-date/--end-date  日期区间 YYYY-MM-DD',
+        '    --page      页码，默认 1',
+        '  blog view   查看某人微博主页（GET /api/blog/base/getBlogPersonalInfo）',
+        '    --user-id   用户 ID（必填）',
+        '  blog remind 催办（提醒某人写日报，GET /api/blog/base/sendRemindUnsubmit?remindId&workdate）',
+        '    --user-id   用户 ID（必填，即被催办人 remindId）',
+        '    --workdate  日报日期 YYYY-MM-DD（默认今天）',
+        '    --yes       真正发送（不加则只打印目标）',
+        '  blog reply  回复微博（POST /api/blog/base/addBlogReply）',
+        '    --id        微博 id（必填）',
+        '    --content   回复内容（必填）',
+        '    --yes       真正发送（不加则只打印目标）',
+        '  blog like   点赞/取消点赞（POST /api/blog/base/addOrDeleteZan，默认 dry-run，--yes 执行）',
+        '    --id        微博 id（必填）',
+        '    --workdate  微博日期（不传自动解析）',
+        '    --user-id   当前用户 id（不传自动解析）',
+        '    --opt-type  1=赞 / 0=取消（不传按当前点赞状态自动切换）',
+        '    --date      微博所在日期（列表自动查不到时指定）',
+        '  blog create 发布/补录/更新微博（默认 dry-run，加 --yes 才真发）',
+        '    --content   微博正文（纯文本，自动按行包 <p>）',
+        '    --content-file 微博正文来自文件（避免命令行中文/转义问题）',
+        '    --share-type 分享范围，默认 1',
+        '    --date      今天留空=发布今天；填过去日期=补录那天',
+        '    --discuss-id 目标微博 id（提供则走"更新整体替换"模式，用于续写已有微博）',
+        '    --yes       真正发送（不加则只打印请求体）',
+        '  blog stats   工作指数 + 心情指数 + 微博统计（调用 getBlogWorkIndex + getBlogMenuCountdata）',
+        '  blog note    草稿/工作笔记',
+        '    --date      日期 YYYY-MM-DD（默认今天）',
+        '  blog user-info 当前用户信息（id / 姓名 / 部门 / 岗位）',
+        '  blog reminders 消息提醒列表',
+        '  blog apps    可用应用列表（心情、文档、日程、流程等）',
+        '  blog at-list @ 提及用户列表',
+        '    --name      姓名关键字过滤 / --page 页码，默认 1',
+        '  blog visitors 访客列表',
+        '    --type      visit=访问我的 / access=我访问的（默认 visit）',
+        '    --page      页码，默认 1',
+        '  blog search-fields 搜索可用字段（列出 getBlogPageSearchCondition 返回的字段名/标签/类型）',
+        '  blog template 默认模板（如果有配置）',
+        '  create list 列可建流程（--keyword/--tab/--json/--raw）',
+        '  create open 生成发起/已有请求表单 URL（--id/--name 新建，或 --requestid 已有）',
+        '  create fields 列表单字段（可编辑/只读/隐藏/控件类型）',
+        '  create start 发起流程：无 --values 列待填字段（含明细表；多选浏览框自动列前10选项）；',
+        '              --values/--values-file 给值（key=字段id，值=文本/option id；中文用 --values-file）；',
+        '              --detail-file 给明细表行数据（JSON 数组 [{index, rows:[{fieldId:value}]}]，index=明细表序号0起，每行多字段）；',
+        '              --file <字段id>=<本地路径> 上传图片/附件（逗号分隔多个）；默认 dry-run，--yes 真发',
+        '  email list 收件箱邮件列表（单步 GET /api/email/list/allList）',
+        '    --page      页码，默认 1',
+        '    --subject   主题关键字过滤',
+        '    --from      发件人过滤',
+        '    --to        收件人过滤',
+        '    --date      语义化日期：today/yesterday/前天/大前天/this-week/last-week/this-month/last-month/recent-7/recent-30',
+        '              + 通用 前N天/N天前（如 前天=前2天、5天前）；中文别名 今天/昨天/前天/本周/上周/本月/上月/最近7天/最近30天',
+        '              给定即强制 datetype=6 + 算出的 startdate/enddate，覆盖 --datetype/--startdate/--enddate',
+        '    --datetype  日期范围过滤（已知 5=预设范围、6=自定义区间；不传=不过滤）',
+        '    --startdate 自定义区间起 YYYY-MM-DD（配 --datetype 6）',
+        '    --enddate   自定义区间止 YYYY-MM-DD（配 --datetype 6）',
+        '    --folder    文件夹：inbox/收件箱（默认）、sent/已发送，或数字 folderid（自定义）',
+        '    --json/--raw 同 todo（--raw 首次跑必用，校准解析字段）',
+        '  email view 查看邮件详情（mailView 元信息 + mailContentView 正文两步）',
+        '    --id        邮件 id（从 email list 取）',
+        '    --mark-read 标记已读（写操作，默认只读不标）',
+        '  email send 写信+发送（POST /api/email/base/send，默认 dry-run）',
+        '    --to        外部收件人邮箱（逗号分隔，如 a@x.com,b@y.com）',
+        '    --cc/--bcc  外部抄送/密送',
+        '    --internal-to   内部收件人资源 id（逗号分隔；内部走 internaltonew，外部走 to）',
+        '    --internal-cc/--internal-bcc  内部抄送/密送',
+        '    --subject   主题（必填）',
+        '    --content   正文（纯文本自动按行包 <p>；中文建议用 --content-file 避免乱码）',
+        '    --content-file  正文来自文件（避免命令行中文/转义问题）',
+        '    --html      正文已是 HTML（默认按纯文本包 <p>）',
+        '    --priority  0=普通（默认）/3=紧急（实跑观察值）',
+        '    --need-receipt 要求回执',
+        '    --timing    定时发送时间（留空=立即发）',
+        '    --classification / --hrm-accountid  覆盖账号配置（默认取自 getEmailAllConfig）',
+        '    --mailid    草稿再发模式：传已有草稿/邮件 id，则 mailid=oldmailid=id + flag=4（编辑后重发）',
+        '    --attachment  本地附件路径（逗号分隔多个；先 uploadFile 拿 fileid → accids）',
+        '    --yes       真正发送（不加则只打印请求体）',
+        '  email read/star/delete/move/waitdeal/recall 邮件操作（写操作 delete/move/waitdeal/recall 默认 dry-run，--yes 真执行）',
+        '    --id        邮件 id（逗号分隔多个；email list 取）',
+        '    --unread    标为未读（默认已读）；--unstar 取消标星（默认标星）',
+        '    --permanent delete 时彻底删除（默认移回收站）',
+        '    --folder    move 目标文件夹：0=收件箱 -1=已发送 -2=草稿箱 -3=已删除 或自定义 folderid',
+        '    --time      waitdeal 处理日期 YYYY-MM-DD（必填）',
+        '    --way       waitdeal 提醒方式：5=消息中心提醒（默认）/1=短信提醒',
+        '    --remind-time / --note / --has-remind / --has-note  waitdeal 提醒时间/备注',
+        '  email label 标签（getMailLabel→table/datas）',
+        '    email label list      标签列表（名称/颜色/未读/总数）',
+        '    email label add --name <名> [--color #hex] [--yes]     新建标签（返回标签id）',
+        '    email label apply --id <ids> --label <标签id> [--remove] [--yes]  给邮件贴/去标签',
+        '  email attachment 附件（uploadFile/attachment/list→table/datas）',
+        '    email attachment upload --file <路径> [--name <名>]    上传附件，返回 fileid（send --attachment 内部复用）',
+        '    email attachment list [--filename <关键词>] [--subject <关键词>]   附件列表',
+        '  email size 邮箱容量统计；email accounts 接收账户列表',
+        '  workplan list 日程列表（POST /api/workplan/calendar/getCalendarData，支持组织视图）',
+        '    --date      参考日期 YYYY-MM-DD，默认今天',
+        '    --view-type 视图：1=当天 / 3=月视图（默认）',
+        '    --group     组织视图：部门/分部/上级/下级/常用组/关注；不传=默认当前用户',
+        '    --type      日程类型 id 筛选，留空=全部',
+        '    --json/--raw 同 todo',
+        '  workplan my-calendar 日程月视图（POST /api/workplan/calendar/MyCalendar，浏览器主用）',
+        '    --date/--view-type/--select-user 同 list',
+        '    --json/--raw 同 todo',
+        '  workplan view 查看日程详情（POST /api/workplan/base/view）',
+        '    --id        日程 id（必填）',
+        '  workplan finish 完成日程（POST /api/workplan/base/finish，默认 dry-run）',
+        '    --id        日程 id（必填）',
+        '    --yes       真正完成（不加则只打印目标）',
+        '  workplan delete 删除日程（POST /api/workplan/base/delete，默认 dry-run）',
+        '    --id        日程 id（必填）',
+        '    --yes       真正删除（不加则只打印目标）',
+        '  workplan types 列出日程类型（POST /api/workplan/type/getSelectType）',
+        '  workplan search-conditions 搜索可用条件（POST /api/workplan/search/getCondition）',
+        '  workplan attention 关注的日程（POST /api/workplan/calendar/getAttentionData）',
+        '  workplan base-data 日历初始化数据（POST /api/workplan/calendar/getBaseData）',
+        '  workplan search 日程表搜索（POST getlist → ec/dev/table/datas → counts，同待办 table 链路）',
+        '    --name      名称关键字',
+        '    --group     分组：全部/今天/本周/本月/本季/本年',
+        '    --type      日程类型 id / --status 状态 id / --creater 创建人 id / --receiver 接收人 id',
+        '    --begin/--end 日期区间 YYYY-MM-DD / --time-sag 时间范围标志（0=全部）',
+        '    --overtime 是否加班 / --creater-dep 创建人部门 / --creater-sub 创建人分部',
+        '    --doc-ids/--request-ids/--prj-id/--crm-id 关联文档/流程/项目/客户',
+        '    --page      页码，默认 1 / --json/--raw 同 todo',
+        '  workplan create 新建日程（POST /api/workplan/base/add，默认 dry-run）',
+        '    --name      日程名称（必填）',
+        '    --begin     开始时间 "YYYY-MM-DD HH:mm"（必填）',
+        '    --end       结束时间 "YYYY-MM-DD HH:mm"（必填）',
+        '    --description 描述（明文，不转 HTML，对齐抓包；中文建议用 --description-file）',
+        '    --description-file 描述来自文件（避免命令行中文/转义问题）',
+        '    --members   成员人员 id，逗号分隔（默认当前用户）',
+        '    --urgent    0=普通（默认）/1=紧急',
+        '    --type      日程类型，默认 0',
+        '    --secret    密级，默认 4（公开）',
+        '    --yes       真正新建（不加则只打印请求体）',
+        '  odoc todo 公文待办列表（POST getCustomPageList → ec/dev/table/datas → counts，同待办 table 链路）',
+        '    --subject   公文标题关键字（requestname）',
+        '    --dispatch-num 发文字号（dispatchnum）',
+        '    --type      公文种类 id / --topic 主题分类 id / --urgent 紧急程度 id / --secret 密级 id',
+        '    --send-unit 发文单位 / --receive-unit 收文单位 / --issued-userid 签发人 id',
+        '    --owner-id 拟稿/操作人 id / --dealing-userid 在办人 id / --undealed-userid 未办人 id',
+        '    --department 部门 id / --read-status 已读状态 / --doc-abstract 正文摘要',
+        '    --receive-num 来文文号 / --workflow-id 流程 id / --odoc-subject 主题词',
+        '    --btn-type 1=待办（默认） / --custom-list-id 列表 id（默认 -12）/ --custom-tab-id tab id（默认 -24）',
+        '    --page      页码，默认 1 / --json/--raw 同 todo',
+        '  odoc count 公文待办/待阅计数（POST /api/odoc/odocTodoList/getTodoCount）',
+        '    --view      待阅计数（不加=待办计数），返回发文/收文/签报',
+        '  odoc create-list 发文/收文流程列表（POST /api/odoc/odocCenter/createOfficalList）',
+        '    --type      1=发文拟稿（默认）/ 2=收文登记；返回 wfbeans，复用 create start 发起',
+        '  config      打印当前加载的配置文件路径 / cookie 是否配置 / 已定义的 tab 列表',
+        '',
+        '示例:',
+        '  e9 todo list --json',
+        '  e9 todo list --tab todo --page 2 --json',
+        '  e9 todo list --raw          # 首次跑，把输出贴回来校准解析',
+        '  e9 email list --json',
+        '  e9 email list --raw        # 首次跑，把 RAW JSON 贴回来收敛字段名',
+        '  e9 email list --date 本周  # 语义化日期（自动转 datetype=6 + 起止）',
+        '  e9 workplan list --raw     # 首次跑，把 RAW JSON 贴回来校准日程字段',
+        '  e9 workplan list --date 2026-08-18 --group 下级   # 查看直接下级日程',
+        '  e9 workplan list --date 2026-08-12 --view-type 1   # 看某天',
+        '  e9 workplan view --id 138          # 查看日程详情',
+        '  e9 workplan types                   # 列出所有日程类型',
+        '  e9 workplan search-conditions       # 查看可用搜索条件',
+        '  e9 workplan create --name "开会" --begin "2026-08-11 14:00" --end "2026-08-11 15:00" --yes',
+        '  e9 odoc todo --json          # 公文待办列表',
+        '  e9 odoc count               # 公文待办计数（发文/收文/签报）',
+        '  e9 odoc create-list --type 1 # 发文流程列表',
+    ].join('\n');
+}
+/** 转义 markdown 链接文本中的特殊字符（[ ] ( ) 与反斜杠）。
+ *  待办/公文标题可能是 E9 服务端渲染的 requestnamespan（如「[退回]【普通】【通知】人事任命通知」），
+ *  标题自带方括号若不做转义，`[${text}](url)` 里的 ] 会被解析器误判为链接文本闭合符，
+ *  导致链接只包住部分标题甚至整体失效。按 CommonMark 规范用反斜杠转义，合规解析器渲染为字面量括号。 */
+function escapeLinkText(text) {
+    return String(text).replace(/([\[\]()\\])/g, '\\$1');
+}
+/** 统一拼各域 list/search 项的 markdown 超链接；无 id/无可链目标时回退纯文本。
+ *  domain: 'todo'|'odoc'|'create'|'blog'|'email'|'cube'|'workplan'
+ *  text: 展示文本（调用方已计算好回退值）；ctx: cube 需 {modeId,formId,customid} */
+function hyperlinkFor(domain, item, base, text, ctx = {}) {
+    const meta = linkMetaFor(domain, item, base, ctx);
+    return meta.url ? `[${escapeLinkText(text)}](${meta.url})` : String(text);
+}
+
+/** 文本和 JSON 共用同一链接判定，禁止上层模型自行拼 URL。 */
+function linkMetaFor(domain, item, base, ctx = {}) {
+    const b = String(base ?? '').replace(/\/+$/, '');
+    let url = '';
+    let urlType = '';
+    switch (domain) {
+        case 'todo':
+        case 'odoc':
+            if (item?.requestId)
+                url = buildRequestFormUrl(b, item.requestId);
+            urlType = url ? 'detail' : '';
+            break;
+        case 'create':
+            if (item?.id)
+                url = buildCreateWfUrl(b, item.id);
+            urlType = url ? 'create-empty' : '';
+            break;
+        case 'blog':
+            if (item?.id)
+                url = buildBlogMyUrl(b);
+            urlType = url ? 'list-generic' : '';
+            break;
+        case 'email':
+            // SPA bundle 实证（index.js）：点邮件实际跳 main/email/view?id=<mailid>&title=<主题>
+            // 路由表只有 view/inbox/sent/folder/new 等，没有 viewMail——旧地址 #/main/email/viewMail?mailid= 匹配不到路由会白屏。
+            if (item?.id)
+                url = `${b}/spa/email/static/index.html#/main/email/view?id=${item.id}&title=${encodeURIComponent(item.subject ?? '查看邮件')}`;
+            urlType = url ? 'detail' : '';
+            break;
+        case 'cube':
+            url = buildCubeCardUrl(b, { modeId: ctx.modeId, formId: ctx.formId, billid: item?.id, customid: ctx.customId ?? ctx.customid });
+            urlType = url ? 'detail' : '';
+            break;
+        case 'cube-search':
+            url = normalizeE9Url(b, ctx.menuUrl ?? item?.url) || buildCubeSearchUrl(b, item?.customid ?? item?.id) || '';
+            urlType = url ? (ctx.menuUrl || item?.url ? 'menu' : 'search') : '';
+            break;
+        case 'workplan':
+            if (item?.id)
+                url = `${b}/spa/workplan/static/index.html#/main/wp/myWorkPlan`;
+            urlType = url ? 'list-generic' : '';
+            break;
+    }
+    return {
+        url: url || null,
+        urlType: urlType || null,
+        urlUnavailableReason: url ? null : (item?.id || item?.requestId ? '缺少生成链接所需的上下文参数' : '结果没有可用 ID'),
+    };
+}
+
+function withLink(domain, item, base, ctx = {}) {
+    const id = item?.id ?? item?.requestId ?? null;
+    const title = item?.title ?? item?.name ?? item?.requestName ?? item?.subject ?? item?.content ?? null;
+    return { ...item, id, title, ...linkMetaFor(domain, item, base, ctx) };
+}
+
+async function runCreateWorkflows(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const keyword = flagStr(args, 'name') ?? flagStr(args, 'keyword') ?? '';
+    const result = await getCreateWfList(cfg, { keyword, tab: flagStr(args, 'tab') ?? '1' });
+    const workflows = result.categories.flatMap((category) => category.workflows.map((workflow) => ({ ...workflow, category: category.name })));
+    if (args.flags.json) {
+        const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        console.log(JSON.stringify({ total: workflows.length, workflows: workflows.map((item) => withLink('create', item, base)) }, null, 2));
+        return;
+    }
+    console.log(`可发起流程共 ${workflows.length} 个${keyword ? `，匹配“${keyword}”` : ''}：`);
+    const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    workflows.slice(0, 20).forEach((workflow, index) => console.log(`${index + 1}. ${hyperlinkFor('create', workflow, base, workflow.name ?? '(无名称)')}  [${workflow.id}]  ${workflow.category ?? ''}`));
+    if (workflows.length > 20)
+        console.log(`还有 ${workflows.length - 20} 个，请用 --name 缩小范围。`);
+}
+
+async function runCreateForm(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const workflowId = flagStr(args, 'workflow-id') ?? flagStr(args, 'id');
+    if (!workflowId)
+        throw new Error('create form 需要 --workflow-id <流程 ID>。');
+    const form = await getStartableFields(cfg, workflowId);
+    const context = createContext({ workflowId: form.workflowId ?? workflowId, workflowName: form.workflowName });
+    const output = { contextId: context.id, workflowId: context.workflowId, workflowName: context.workflowName, fields: form.fields, detailTables: form.detailTables };
+    if (args.flags.json) {
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    console.log(`已初始化“${context.workflowName || context.workflowId}”表单。`);
+    console.log(`上下文：${context.id}`);
+    for (const field of form.fields) {
+        console.log(`- [${field.id}] ${field.label ?? '(未命名字段)'}${field.required ? '（必填）' : ''}${field.inputHint ? `：${field.inputHint}` : ''}`);
+    }
+    console.log(`\n下一步：e9 create prepare ${context.id} --data '<JSON>'`);
+}
+
+function readContextData(args) {
+    const raw = flagStr(args, 'data');
+    const file = flagStr(args, 'data-file');
+    let text = raw;
+    if (!text && file) {
+        text = fs.readFileSync(file, 'utf8');
+    }
+    if (!text)
+        throw new Error('create prepare 需要 --data <JSON> 或 --data-file <文件>。');
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        throw new Error('--data 不是合法 JSON 对象。');
+    }
+    if (!data || Array.isArray(data) || typeof data !== 'object')
+        throw new Error('--data 必须是字段 ID 到值的 JSON 对象。');
+    return data;
+}
+
+async function runCreatePrepare(args) {
+    const id = args._[2];
+    if (!id)
+        throw new Error('create prepare 需要 <context_id>。');
+    const data = readContextData(args);
+    const context = loadContext(id);
+    const updated = updateContext(id, {
+        values: { ...context.values, ...data },
+        requestName: flagStr(args, 'requestname') ?? context.requestName,
+    });
+    console.log(`已保存 ${Object.keys(data).length} 个字段到上下文 ${updated.id}。`);
+    console.log('预览：');
+    for (const [field, value] of Object.entries(updated.values))
+        console.log(`- field${field} = ${value}`);
+    console.log(`\n确认后：e9 create create ${updated.id} --confirm --submit`);
+}
+
+async function runContextCreate(args) {
+    const id = args._[2];
+    if (!id)
+        throw new Error('create create 需要 <context_id>。');
+    const context = loadContext(id);
+    if (!args.flags.confirm || !args.flags.submit) {
+        const cfg = loadConfig(flagStr(args, 'config'));
+        const prepared = await prepareCreateSubmission(cfg, context.workflowId, context.values, context.requestName, context.details);
+        const plan = saveSubmissionPlan({ ...prepared, files: context.files });
+        updateContext(id, { planId: plan.id });
+        console.log(BOX_TOP);
+        console.log(`  发起预览 · ${context.workflowName || context.workflowId}`);
+        console.log(DIVIDER);
+        console.log(JSON.stringify(prepared.body, null, 2));
+        console.log(`\n确认无误后：e9 create create ${id} --confirm --submit（将使用计划 ${plan.id} 原样提交已确认字段）`);
+        return;
+    }
+    const cfg = loadConfig(flagStr(args, 'config'));
+    if (!context.planId)
+        throw new Error('此上下文尚未生成确认计划。请先不带 --confirm --submit 运行一次预览。');
+    const plan = loadSubmissionPlan(context.planId, context.workflowId);
+    const result = await submitCreateRequest(cfg, context.workflowId, plan.values, plan.requestName, [], plan.details, plan);
+    const response = result.response;
+    const body = response.json ?? {};
+    const requestId = body.requestid ?? body.data?.requestid ?? body.data?.requestId;
+    if (result.outcome === 'created')
+        console.log(`✅ 已提交“${context.workflowName || context.workflowId}”${requestId ? `，requestid=${requestId}` : ''}。`);
+    else
+        console.log(`⚠ 已收到响应，但是否创建成功尚未确认（submission_id=${result.submission.id}）。请运行 create verify ${result.submission.id}，不要重复提交。`);
+    console.log(JSON.stringify(body, null, 2));
+}
+
+async function runCreateVerify(args) {
+    const id = args._[2];
+    if (!id)
+        throw new Error('create verify 需要 <submission_id>。');
+    const submission = loadSubmission(id);
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const result = await getWfList(cfg, {
+        category: 'mine', page: 1, keyword: submission.requestName, createTime: submission.createdAt.slice(0, 10),
+    });
+    const candidates = result.items.filter((item) => item.title === submission.requestName || item.rawTitle === submission.requestName);
+    if (candidates.length === 1) {
+        const saved = updateSubmission(id, { status: 'created', requestId: candidates[0].requestId, verifiedAt: new Date().toISOString() });
+        console.log(`✅ 已核验首次发起成功：requestid=${saved.requestId}。未再次提交。`);
+        return;
+    }
+    if (candidates.length === 0) {
+        updateSubmission(id, { status: 'uncertain', verifiedAt: new Date().toISOString(), candidateRequestIds: [] });
+        console.log('⚠ 暂未查到可唯一确认的流程。请稍后再核验；在确认前系统不会自动重试。');
+        return;
+    }
+    updateSubmission(id, { status: 'uncertain', verifiedAt: new Date().toISOString(), candidateRequestIds: candidates.map((item) => item.requestId) });
+    console.log('⚠ 查到多条同名候选，无法安全判断首次发起的是哪一条：');
+    candidates.forEach((item) => console.log(`- ${item.title}  requestid=${item.requestId}  ${item.createdate ?? ''}`));
+    console.log('请在 OA 中确认保留项；在确认前系统不会自动重试。');
+}
+
+async function runCreate(args) {
+    const sub = args._[1] ?? 'list';
+    if (sub === 'workflows') {
+        await runCreateWorkflows(args);
+        return;
+    }
+    if (sub === 'form') {
+        await runCreateForm(args);
+        return;
+    }
+    if (sub === 'prepare') {
+        await runCreatePrepare(args);
+        return;
+    }
+    if (sub === 'create') {
+        await runContextCreate(args);
+        return;
+    }
+    if (sub === 'verify') {
+        await runCreateVerify(args);
+        return;
+    }
+    if (sub === 'open') {
+        await runCreateOpen(args);
+        return;
+    }
+    if (sub === 'fields') {
+        await runCreateFields(args);
+        return;
+    }
+    if (sub === 'start') {
+        await runCreateStart(args);
+        return;
+    }
+    if (sub === 'flow') {
+        await runCreateFlow(args);
+        return;
+    }
+    if (sub !== 'list') {
+        console.error(`create 暂只支持 list / workflows / form / prepare / create / verify / open / fields / start 子命令，收到: ${sub}`);
+        process.exit(1);
+    }
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const tab = flagStr(args, 'tab') ?? '1';
+    const keyword = flagStr(args, 'keyword') ?? '';
+    const r = await getCreateWfList(cfg, { tab, keyword });
+    if (args.flags.raw) {
+        console.error('===== RAW createreq/wfinfo =====');
+        console.error(JSON.stringify(r.raw, null, 2));
+        console.error('===== 解析结果 =====');
+    }
+    if (args.flags.json) {
+        const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        console.log(JSON.stringify({
+            tab: r.tab,
+            tabs: r.tabs,
+            totalCategories: r.totalCategories,
+            totalWorkflows: r.totalWorkflows,
+            categories: r.categories.map((c) => ({
+                id: c.id,
+                name: c.name,
+                color: c.color,
+                workflows: c.workflows.map((w) => withLink('create', {
+                    id: w.id,
+                    name: w.name,
+                    typeId: w.typeId,
+                    spell: w.spell,
+                    letter: w.letter,
+                    pcurl: w.pcurl,
+                }, base)),
+            })),
+        }, null, 2));
+        return;
+    }
+    console.log(BOX_TOP);
+    console.log(`  E9 新建流程 · [${r.tab.title ?? r.tab.key}]`);
+    console.log(`  ${r.totalCategories} 个分类 / ${r.totalWorkflows} 个流程${keyword ? `  · 关键词「${keyword}」` : ''}`);
+    console.log(`  tabs: ${r.tabs.map((t) => `${t.key}=${t.title}`).join('  |  ')}`);
+    if (tab === '3') {
+        console.log('  注：常用流程由服务端统计，本接口未按常用过滤，以下同"全部流程"。');
+    }
+    console.log(BOX_TOP);
+    if (r.categories.length === 0) {
+        console.log('\n  （无数据，换个 --tab 或检查 cookie/token）');
+        if (args.flags.raw)
+            console.error('提示：用 --raw 查看真实响应校准解析。');
+        return;
+    }
+    const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    let idx = 0;
+    for (const c of r.categories) {
+        console.log(`\n  ■ ${c.name ?? '(未命名分类)'}  (${c.workflows.length})`);
+        for (const w of c.workflows) {
+            idx++;
+            const num = String(idx).padStart(3, ' ');
+            console.log(`    ${num}. ${hyperlinkFor('create', w, base, w.name ?? '(无名称)')}  [id=${w.id ?? ''}]${w.spell ? `  (${w.spell})` : ''}`);
+        }
+    }
+}
+async function runCreateStart(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const id = flagStr(args, 'id');
+    const name = flagStr(args, 'name');
+    const valuesRaw = flagStr(args, 'values');
+    const valuesFile = flagStr(args, 'values-file');
+    const detailFile = flagStr(args, 'detail-file');
+    const send = !!args.flags.yes;
+    let wfId;
+    if (!id && name) {
+        // 按名查；多个候选则列出让用户选
+        const hits = await findCreateWfByName(cfg, name);
+        if (hits.length === 0) {
+            console.error(`按名「${name}」未找到流程。`);
+            process.exit(1);
+        }
+        if (hits.length > 1) {
+            console.log(BOX_TOP);
+            console.log(`  「${name}」找到 ${hits.length} 个相似流程，请选一个：`);
+            console.log(DIVIDER);
+            for (let i = 0; i < hits.length; i++) {
+                const w = hits[i];
+                console.log(`  ${String(i + 1).padStart(2, ' ')}. ${w.name}  [id=${w.id ?? ''}]${w.spell ? `  (${w.spell})` : ''}`);
+            }
+            console.log(BOX_TOP);
+            console.log('  用 --id <流程id> 指定其中一个再跑。');
+            process.exit(0);
+        }
+        wfId = hits[0].id ?? '';
+    }
+    else {
+        try {
+            wfId = await resolveWorkflowId(cfg, id, name);
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+    }
+    const r = await getStartableFields(cfg, wfId);
+    const requestname = flagStr(args, 'requestname');
+    // --file <字段id>=<本地路径>（逗号分隔多个）：上传图片/附件
+    const fileRaw = flagStr(args, 'file');
+    const files = [];
+    if (fileRaw) {
+        for (const seg of fileRaw.split(',')) {
+            const i = seg.indexOf('=');
+            if (i <= 0) {
+                console.error(`--file 格式应为 <字段id>=<路径>，收到: ${seg}`);
+                process.exit(1);
+            }
+            files.push({ fieldId: seg.slice(0, i).trim(), filePath: seg.slice(i + 1).trim() });
+        }
+    }
+    // 解析值来源：--values 或 --values-file（文件避免命令行中文/转义问题）
+    let valuesRawResolved = valuesRaw;
+    if (!valuesRawResolved && valuesFile) {
+        try {
+            const fs = await import('node:fs');
+            valuesRawResolved = fs.readFileSync(valuesFile, 'utf8');
+        }
+        catch (e) {
+            console.error(`读取 --values-file 失败：${e.message}`);
+            process.exit(1);
+        }
+    }
+    // --detail-file <json>：明细表行数据 [{index, rows:[{fieldId:value}]}]（index: detail_1→0, detail_2→1）
+    let details = [];
+    if (detailFile) {
+        try {
+            const fs = await import('node:fs');
+            const parsed = JSON.parse(fs.readFileSync(detailFile, 'utf8'));
+            if (!Array.isArray(parsed))
+                throw new Error('detail JSON 应为数组 [{index, rows:[{...}]}]');
+            details = parsed.map((d) => ({
+                index: Number(d.index),
+                rows: (d.rows || []).map((rw) => {
+                    const row = {};
+                    for (const [k, v] of Object.entries(rw))
+                        row[k] = String(v);
+                    return row;
+                }),
+            }));
+        }
+        catch (e) {
+            console.error(`--detail-file 解析失败：${e.message}`);
+            process.exit(1);
+        }
+    }
+    // 无值来源且无 --file 且无 --detail-file：打印待填字段清单（供 AI 问答）
+    if (!valuesRawResolved && files.length === 0 && details.length === 0) {
+        if (args.flags.json) {
+            console.log(JSON.stringify({ workflowId: r.workflowId, workflowName: r.workflowName, verifyRight: r.verifyRight, fields: r.fields, detailTables: r.detailTables, submitParams: r.submitParams }, null, 2));
+            return;
+        }
+        console.log(BOX_TOP);
+        console.log(`  E9 发起流程 · ${r.workflowName ?? 'workflowid=' + r.workflowId}  (id=${r.workflowId})`);
+        console.log(`  主表业务字段 ${r.fields.length} 个 · 明细表 ${r.detailTables.length} 个 · verifyRight=${r.verifyRight ? '✅ 有权限' : '❌ 无权限'}`);
+        console.log(BOX_TOP);
+        console.log('  注：viewattr 是 loadForm 静态值，不反映运行时可编辑性（va=3 隐藏实际可能可填）。填哪些由你定。');
+        if (r.fields.length === 0) {
+            console.log('\n  （无主表业务字段——该流程可能是自由流程或仅系统字段）');
+        }
+        for (const f of r.fields) {
+            console.log(`\n  ▸ [${f.id}] ${f.label ?? '(无标签)'}${f.name ? `  (${f.name})` : ''}`);
+            const meta = [f.htmltypeLabel, f.viewattrLabel ? `静态${f.viewattrLabel}` : null, f.inputHint, f.currentValue ? `当前值=${f.currentValue}` : null, f.defaultValue ? `默认=${f.defaultValue}` : null].filter(Boolean).join('  ·  ');
+            if (meta)
+                console.log(`      ${meta}`);
+            if (f.options && f.options.length > 0) {
+                console.log(`      选项: ${f.options.map((o) => `${o.id}=${o.name}`).join('  |  ')}`);
+            }
+        }
+        // 明细表字段（多行，用 --detail-file 给行数据）
+        for (const dt of r.detailTables) {
+            console.log(`\n  ▦ 明细表 ${dt.key}（index=${dt.index}，多行）`);
+            for (const f of dt.fields) {
+                const meta = [f.htmltypeLabel, f.inputHint].filter(Boolean).join('  ·  ');
+                console.log(`    ▸ [${f.id}] ${f.label ?? '(无标签)'}${meta ? `  (${meta})` : ''}`);
+                if (f.options && f.options.length > 0) {
+                    console.log(`        选项: ${f.options.map((o) => `${o.id}=${o.name}`).join('  |  ')}`);
+                }
+            }
+        }
+        console.log('\n  ─────────────────────────────────────────────');
+        console.log('  给值：--values-file \'<json>\'   key=字段id，值=文本/option id（中文用 --values-file 避免乱码）');
+        console.log('  明细：--detail-file \'<json>\'   [{index:0, rows:[{22106:"v",22107:"v2"}, ...]}, ...]（index=明细表序号0起，每行多字段）');
+        console.log('  上传：--file <字段id>=<本地路径>   逗号分隔多个；图片按扩展名自动判 listType');
+        console.log('  发起：默认 dry-run，确认后加 --yes 真提交');
+        return;
+    }
+    // 有值来源或 --file：构造提交体
+    let values = {};
+    if (valuesRawResolved) {
+        try {
+            values = JSON.parse(valuesRawResolved);
+        }
+        catch {
+            console.error(`--values / --values-file 不是合法 JSON：${valuesRawResolved}`);
+            process.exit(1);
+        }
+    }
+    // 预览与提交必须共用同一份已解析字段，避免默认值、联动或浏览框名称在确认后改变。
+    if (!send || args.flags.dryRun) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 未发送 · 流程: ${r.workflowName ?? wfId}`);
+        console.log(`  requestname = ${requestname || `${r.workflowName ?? '流程'}-系统管理员-${todayStr()}`}`);
+        if (files.length > 0) {
+            console.log('  待上传（--yes 时先上传拿 fileid 再提交）：');
+            for (const fl of files)
+                console.log(`    ▸ field${fl.fieldId} ← ${fl.filePath}`);
+            console.log('  附件上传会产生新文件 ID，不能冻结到本次确认计划；请在无附件字段变更时单独确认。');
+        }
+        const prepared = await prepareCreateSubmission(cfg, wfId, values, requestname, details);
+        const plan = saveSubmissionPlan({ ...prepared, files });
+        if (details.length > 0) {
+            console.log(BOX_TOP);
+            console.log('  明细表行（--detail-file）：');
+            for (const dt of details) {
+                console.log(`    ▦ 明细表 index=${dt.index}（${dt.rows.length} 行）：`);
+                dt.rows.forEach((row, i) => console.log(`      第${i}行: ${Object.entries(row).map(([k, v]) => `field${k}=${v}`).join(', ')}`));
+            }
+        }
+        console.log('提交体（POST /api/workflow/reqform/requestOperation）：');
+        console.log(JSON.stringify(prepared.body, null, 2));
+        console.log(`\n  确认无误后：加 --yes --plan ${plan.id} 真发起。将原样提交本次确认的业务字段和明细浏览框名称；附件仅在提交时上传。`);
+        return;
+    }
+    const planId = flagStr(args, 'plan');
+    if (!planId) {
+        console.error('为防止确认值与实际提交值漂移，--yes 必须使用预览输出的 --plan <plan_id>。');
+        process.exit(1);
+    }
+    const plan = loadSubmissionPlan(planId, wfId);
+    // 真提交只刷新 loadForm 的短期签名参数；业务字段、明细与浏览框名称完全复用确认计划。
+    const submitResult = await submitCreateRequest(cfg, wfId, plan.values, plan.requestName, files, plan.details, plan);
+    const res = submitResult.response;
+    const j = res.json;
+    const rid = j?.requestid ?? j?.data?.requestid ?? j?.data?.resultInfo?.requestid ?? j?.data?.requestId;
+    // 普通流程 requestOperation 返回 SUCCESS（已流转）；公文流程返回 ASYNC_SUBMIT（仅保存，需再 flowNext 流转）。
+    const isAsync = j?.data?.type === 'ASYNC_SUBMIT' || j?.type === 'ASYNC_SUBMIT';
+    const ok = submitResult.outcome === 'created';
+    console.log(BOX_TOP);
+    console.log(`  发起结果 · ${r.workflowName ?? wfId}`);
+    console.log(`  ${ok ? '✅ 创建成功' : `⚠ 创建结果待核验（submission_id=${submitResult.submission.id}），请勿重试`}  status=${res.status}${rid ? `  requestid=${rid}` : ''}`);
+    // 公文流程：保存成功但未流转。调 loadData 取可流转候选，展示给用户确认后再 flowNext。
+    if (isAsync && rid) {
+        try {
+            const nodes = await getOdocNextNodes(cfg, String(rid), wfId, r.params, r.submitParams);
+            if (nodes.length === 0) {
+                console.log('  ℹ 公文无可流转候选（流程可能已到末节点或需在浏览器处理）');
+            }
+            else {
+                console.log('  公文已保存，待流转到下一节点（未自动流转）。可流转候选：');
+                for (const n of nodes) {
+                    const ops = n.operators.map((o) => `${o.id}=${o.name}`).join(', ') || `(默认 ${n.defaultUserIds})`;
+                    console.log(`    · [节点 ${n.nodeid} · ${n.nodename} · link ${n.linkId}] ${ops}`);
+                }
+                console.log(`  确认流转对象后：e9 create flow --requestid ${rid} [--next-user <uid>]`);
+            }
+        }
+        catch (e) {
+            console.log(`  ⚠ 取流转候选失败：${e.message}`);
+        }
+    }
+    console.log(BOX_TOP);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 600));
+    else
+        console.log('响应(非JSON):', (res.text ?? '').slice(0, 300));
+}
+// === 新增流程操作命令 ===
+async function runTodoReject(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo reject 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    const rejectToNode = flagStr(args, 'reject-to-node');
+    const rejectToType = flagStr(args, 'reject-to-type');
+    const rejectNode = flagStr(args, 'reject-node');
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 退回流程 requestid=${requestId}`);
+        console.log(`  退回目标：${rejectToNode ? `节点 ${rejectToNode}` : '自动取第一个可退回节点'}${rejectToType ? ` · 类型 ${rejectToType}` : ''}`);
+        console.log('  可加 --reject-to-node <nodeid> 指定退回节点；--reject-to-type <类型>；--reject-node <nodes>');
+        console.log('  加 --yes 真退回');
+        return;
+    }
+    const remark = flagStr(args, 'remark') ?? '退回';
+    const res = await rejectTodo(cfg, { requestId, remark, rejectToNode, rejectToType, rejectNode });
+    const j = res.json;
+    const ok = j?.data?.type === 'SUCCESS' || j?.type === 'SUCCESS';
+    console.log(BOX_TOP);
+    console.log(`  ${ok ? '✅ 退回成功' : '⚠ 退回异常'}  status=${res.status}  requestid=${requestId}`);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 500));
+}
+async function runTodoTransfer(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo transfer 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    const receiver = flagStr(args, 'receiver');
+    const receiverName = flagStr(args, 'receiver-name');
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 转办流程 requestid=${requestId}`);
+        console.log(`  目标人：${receiver ? `ID ${receiver}` : (receiverName ? `姓名 ${receiverName}` : '【未指定】')}`);
+        console.log('  必传 --receiver <userId> 或 --receiver-name <姓名>（逗号分隔多个）');
+        console.log('  加 --yes 真转办');
+        return;
+    }
+    const remark = flagStr(args, 'remark') ?? '';
+    const res = await transferTodo(cfg, { requestId, remark, receiver, receiverName });
+    const j = res.json;
+    const ok = j?.success === true;
+    console.log(BOX_TOP);
+    console.log(`  ${ok ? '✅ 转办成功' : '⚠ 转办异常'}  status=${res.status}  requestid=${requestId}`);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 500));
+}
+async function runTodoForward(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo forward 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    const receiver = flagStr(args, 'receiver');
+    const receiverName = flagStr(args, 'receiver-name');
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 转发流程 requestid=${requestId}`);
+        console.log(`  目标人：${receiver ? `ID ${receiver}` : (receiverName ? `姓名 ${receiverName}` : '【未指定】')}`);
+        console.log('  必传 --receiver <userId> 或 --receiver-name <姓名>');
+        console.log('  加 --yes 真转发');
+        return;
+    }
+    const remark = flagStr(args, 'remark') ?? '';
+    const res = await forwardTodo(cfg, { requestId, remark, receiver, receiverName });
+    const j = res.json;
+    const ok = j?.success === true;
+    console.log(BOX_TOP);
+    console.log(`  ${ok ? '✅ 转发成功' : '⚠ 转发异常'}  status=${res.status}  requestid=${requestId}`);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 500));
+}
+async function runTodoCirculate(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo circulate 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    const receiver = flagStr(args, 'receiver');
+    const receiverName = flagStr(args, 'receiver-name');
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 传阅流程 requestid=${requestId}`);
+        console.log(`  目标人：${receiver ? `ID ${receiver}` : (receiverName ? `姓名 ${receiverName}` : '【未指定】')}`);
+        console.log('  必传 --receiver <userId> 或 --receiver-name <姓名>');
+        console.log('  加 --yes 真传阅');
+        return;
+    }
+    const remark = flagStr(args, 'remark') ?? '';
+    const res = await circulateTodo(cfg, { requestId, remark, receiver, receiverName });
+    const j = res.json;
+    const ok = j?.success === true;
+    console.log(BOX_TOP);
+    console.log(`  ${ok ? '✅ 传阅成功' : '⚠ 传阅异常'}  status=${res.status}  requestid=${requestId}`);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 500));
+}
+async function runTodoAskIdea(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo ask-idea 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    const receiver = flagStr(args, 'receiver');
+    const receiverName = flagStr(args, 'receiver-name');
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 意见征询 requestid=${requestId}`);
+        console.log(`  征询对象：${receiver ? `ID ${receiver}` : (receiverName ? `姓名 ${receiverName}` : '【未指定】')}`);
+        console.log('  必传 --receiver <userId> 或 --receiver-name <姓名>');
+        console.log('  加 --yes 真征询');
+        return;
+    }
+    const remark = flagStr(args, 'remark') ?? '';
+    const res = await askIdeaTodo(cfg, { requestId, remark, receiver, receiverName });
+    const j = res.json;
+    const ok = j?.success === true;
+    console.log(BOX_TOP);
+    console.log(`  ${ok ? '✅ 意见征询成功' : '⚠ 意见征询异常'}  status=${res.status}  requestid=${requestId}`);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 500));
+}
+async function runTodoCc(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo cc 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 抄送流程 requestid=${requestId}`);
+        console.log('  加 --yes 真抄送');
+        return;
+    }
+    const remark = flagStr(args, 'remark') ?? '抄送';
+    const res = await ccTodo(cfg, { requestId, remark });
+    const j = res.json;
+    const ok = j?.data?.type === 'SUCCESS' || j?.type === 'SUCCESS';
+    console.log(BOX_TOP);
+    console.log(`  ${ok ? '✅ 抄送成功' : '⚠ 抄送异常'}  status=${res.status}  requestid=${requestId}`);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 500));
+}
+/**
+ * 公文流转：对 create start 保存但未流转的公文请求，取可流转候选 → 用户确认 → flowNext 推送。
+ * 链路（浏览器抓包对齐）：requestOperation(ASYNC_SUBMIT) → loadData 取候选 → 确认 → flowNext。
+ * 公文必须显式选定流转对象（userIds+nodeid+linkId），空 nextDirections 是假成功不真流转。
+ */
+async function runCreateFlow(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const rid = flagStr(args, 'requestid');
+    const wfId = flagStr(args, 'workflowid') || flagStr(args, 'id');
+    const nextUser = flagStr(args, 'next-user');
+    if (!rid) {
+        console.error('create flow 需要 --requestid <请求id>（来自 create start 输出）');
+        process.exit(1);
+    }
+    if (!wfId) {
+        console.error('create flow 需要 --workflowid <流程id>（与 --requestid 配套，来自 create start 输出）');
+        process.exit(1);
+    }
+    const r = await describeFormFields(cfg, wfId);
+    let nodes;
+    try {
+        nodes = await getOdocNextNodes(cfg, rid, wfId, r.params, r.submitParams);
+    }
+    catch (e) {
+        console.error(`取流转候选失败：${e.message}`);
+        process.exit(1);
+    }
+    if (nodes.length === 0) {
+        console.log(`请求 ${rid} 无可流转候选（可能已流转/到末节点/非公文流程）。`);
+        return;
+    }
+    console.log(`可流转候选（请求 ${rid} · ${r.workflowName ?? wfId}）：`);
+    for (const n of nodes) {
+        const ops = n.operators.map((o) => `${o.id}=${o.name}`).join(', ') || `(默认 ${n.defaultUserIds})`;
+        console.log(`  · [节点 ${n.nodeid} · ${n.nodename} · link ${n.linkId}] ${ops}`);
+    }
+    const node = nodes[0];
+    const userIds = nextUser ?? node.defaultUserIds;
+    if (!userIds) {
+        console.error('候选无默认操作人。用 --next-user <uid> 指定（uid 见上方候选列表）。');
+        process.exit(1);
+    }
+    const opName = node.operators.find((o) => userIds.split(',').includes(o.id))?.name ?? '';
+    if (!nextUser)
+        console.log(`未指定 --next-user，用默认操作人 ${userIds}${opName ? '（' + opName + '）' : ''}`);
+    if (!args.flags.yes) {
+        console.log(`\n将把请求 ${rid} 流转到 [${node.nodename}] 给 ${userIds}。加 --yes 确认流转。`);
+        return;
+    }
+    const flow = await odocFlowNext(cfg, rid, wfId, r.params, r.submitParams, { verifyRequiredRange: 'field-9999,field-1,' }, [{ userIds, nodeid: node.nodeid, linkId: node.linkId }]);
+    console.log(BOX_TOP);
+    console.log(`  公文流转 · ${r.workflowName ?? wfId}  requestid=${rid}`);
+    console.log(`  ${flow.success ? '✅ 流转成功' : '⚠ 流转异常'}  ${flow.msg}`);
+    console.log(BOX_TOP);
+}
+async function runCreateFields(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    let id = flagStr(args, 'id');
+    const name = flagStr(args, 'name');
+    if (!id && !name) {
+        console.error('create fields 需要 --id <流程id> 或 --name <流程名>');
+        process.exit(1);
+    }
+    if (!id) {
+        const hits = await findCreateWfByName(cfg, name);
+        if (hits.length === 0) {
+            console.error(`按名「${name}」未找到流程`);
+            process.exit(1);
+        }
+        if (hits.length > 1) {
+            console.error(`按名「${name}」找到 ${hits.length} 个候选，请指定 --id：`);
+            for (const w of hits)
+                console.error(`  ${w.name}  [id=${w.id ?? ''}]`);
+            process.exit(1);
+        }
+        id = hits[0].id;
+    }
+    const r = await describeFormFields(cfg, id);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ workflowId: r.workflowId, workflowName: r.workflowName, verifyRight: r.verifyRight, totalFields: r.totalFields, tables: r.tables }, null, 2));
+        return;
+    }
+    console.log(`E9 表单字段 [${r.workflowName ?? 'workflowid=' + r.workflowId}]  ${r.totalFields} 个字段  verifyRight=${r.verifyRight}`);
+    for (const t of r.tables) {
+        console.log(`\n■ ${t.key === 'main' ? '主表' : t.key}（${t.fields.length} 字段）`);
+        for (const f of t.fields) {
+            console.log(`  [${f.id}] ${f.label ?? '(无标签)'}${f.name ? ` (${f.name})` : ''}  ${f.viewattrLabel ? '静态' + f.viewattrLabel : '?'}  ${f.htmltypeLabel ?? '?'}`);
+            // 选择框选项（selectattr.selectitemlist）
+            const items = f.raw?.selectattr?.selectitemlist;
+            if (Array.isArray(items) && items.length > 0) {
+                console.log(`      选项: ${items.map((it) => `${it.selectvalue}=${it.selectname}`).join('  |  ')}`);
+            }
+        }
+    }
+    console.log('\n注：必填标记不在 loadForm 接口（前端 DOM 控制），本表不显示必填。');
+    console.log('  可编辑/只读/隐藏由 viewattr 给出——viewattr 是表单设计态静态值（va=1只读/2可编辑/3隐藏），不反映运行时实际可编辑性（va=3 隐藏实际可能可填，运行时权限以节点配置/联动为准）。');
+}
+async function runCreateOpen(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const id = flagStr(args, 'id');
+    const name = flagStr(args, 'name');
+    const requestId = flagStr(args, 'requestid');
+    // --requestid：打开已有请求表单（处理/提交待办用），不要求 --id/--name
+    if (requestId) {
+        const base = endpointFor(cfg).baseUrl;
+        const url = buildRequestFormUrl(base, requestId, id);
+        if (args.flags.json) {
+            console.log(JSON.stringify({ requestid: requestId, workflowid: id, url }, null, 2));
+            return;
+        }
+        console.log(`打开请求表单（requestid=${requestId}${id ? ` workflowid=${id}` : ''}）：`);
+        console.log(url);
+        console.log('\n浏览器里手动填业务字段 + 点提交（自动提交被签名卡住，见 create start 说明）。');
+        return;
+    }
+    if (!id && !name) {
+        console.error('create open 需要 --id <流程id> / --name <流程名>（新建）或 --requestid <请求id>（打开已有请求）');
+        process.exit(1);
+    }
+    let wfId;
+    let matchedName;
+    if (id) {
+        wfId = id;
+    }
+    else {
+        const hits = await findCreateWfByName(cfg, name);
+        if (hits.length === 0) {
+            console.error(`按名「${name}」未找到可建流程。先跑 e9 create list --keyword "${name}" 看候选。`);
+            process.exit(1);
+        }
+        if (hits.length > 1) {
+            console.error(`按名「${name}」找到 ${hits.length} 个候选，请指定 --id：`);
+            for (const w of hits)
+                console.error(`  ${w.name}  [id=${w.id ?? ''}]`);
+            process.exit(1);
+        }
+        wfId = hits[0].id;
+        matchedName = hits[0].name;
+    }
+    const base = endpointFor(cfg).baseUrl;
+    const url = buildCreateWfUrl(base, wfId);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ workflowid: wfId, name: matchedName, url, urlType: 'create-empty', urlUnavailableReason: null }, null, 2));
+        return;
+    }
+    console.log(`打开空白新建页${matchedName ? `「${matchedName}」` : ''}（workflowid=${wfId}；预览值不会自动带入）：`);
+    console.log(url);
+}
+async function runAuth(args) {
+    const sub = args._[1] ?? 'status';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    if (sub === 'token-login') {
+        await cmdTokenLogin(cfg, args);
+        return;
+    }
+    if (sub === 'cookie-login') {
+        await cmdCookieLogin(cfg, args);
+        return;
+    }
+    if (sub === 'status') {
+        await cmdAuthStatus(cfg, args);
+        return;
+    }
+    if (sub === 'consent') {
+        const val = String(args._[2] ?? '').toLowerCase();
+        if (val !== 'true' && val !== 'false') {
+            console.error('用法: e9 auth consent true|false');
+            console.error('  true = 同意信息经大模型处理（登录免 --consent）；false = 撤销同意');
+            process.exit(1);
+        }
+        setConfigField('llmConsent', val === 'true', flagStr(args, 'config'));
+        console.log(val === 'true'
+            ? '✔ 已同意隐私确认：后续 auth token-login / cookie-login 免 --consent。'
+            : '⚠ 已撤销隐私同意：后续登录需重新确认（--consent）。');
+        return;
+    }
+    console.error(`auth 暂只支持 token-login / cookie-login / status / consent，收到: ${sub}`);
+    process.exit(1);
+}
+async function runBlog(args) {
+    const sub = args._[1] ?? 'list';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const blogBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    if (sub === 'check') {
+        const date = flagStr(args, 'date') ?? todayStr();
+        // check 要判定整天的正常发布记录：逐页拉取 + 重复检测终止（服务端无 total、越界页重复回放）
+        const r = await getMyBlogAll(cfg, date);
+        // 撤回状态按 isReCalled 判定（已抓包验证：0=正常发布，1/2=已撤回），不再用列表存在与否代替。
+        const todayItems = r.items.filter((it) => (it.workdate || (it.createdate ?? '').slice(0, 10)) === date);
+        const recalled = todayItems.filter((it) => isBlogRecalled(it));
+        const normal = todayItems.filter((it) => !isBlogRecalled(it));
+        const written = normal.length > 0;
+        if (args.flags.json) {
+            console.log(JSON.stringify({
+                date,
+                foundCount: todayItems.length,
+                normalCount: normal.length,
+                recalledCount: recalled.length,
+                written,
+                note: written ? `发现 ${normal.length} 条正常发布的微博，判定已写日报` : recalled.length > 0 ? '微博均已撤回，无正常发布记录，不能判定已写' : '列表无微博记录',
+            }, null, 2));
+            if (!written)
+                process.exit(1);
+            return;
+        }
+        if (written) {
+            console.log(`✅ ${date} 已写日报：${normal.length} 条正常发布的微博`);
+            if (recalled.length > 0)
+                console.log(`⚠️ 另有 ${recalled.length} 条已撤回微博（isReCalled≠0），未计入`);
+            return;
+        }
+        if (recalled.length > 0) {
+            console.log(`⚠️ ${date} 发现 ${recalled.length} 条微博但均已撤回（isReCalled≠0），无正常发布记录，不能判定已写日报`);
+            process.exit(1);
+        }
+        console.log(`⚠️ ${date} 列表无微博记录`);
+        process.exit(1);
+    }
+    if (sub === 'list') {
+        const scope = flagStr(args, 'scope');
+        if (scope) {
+            const r = await getBlogHomepageList(cfg, {
+                scope,
+                endDate: flagStr(args, 'date'),
+                startDate: flagStr(args, 'start-date'),
+                page: Number(flagStr(args, 'page') ?? '1') || 1,
+            });
+            if (args.flags.json) {
+                console.log(JSON.stringify({ scope: r.scope, groupId: r.groupId, startDate: r.startDate, endDate: r.endDate, page: r.page, total: r.total, count: r.items.length, items: r.items.map((it) => withLink('blog', { id: it.id, content: it.content, workdate: it.workdate, creator: it.creator, createdate: it.createdate, shareType: it.shareType, isReCalled: it.isReCalled }, blogBase)) }, null, 2));
+                return;
+            }
+            console.log(`E9 微博 [${r.scope} ${r.startDate}~${r.endDate}]  共 ${r.total ?? '?'} 条`);
+            if (r.items.length === 0) {
+                console.log('（无数据）');
+                return;
+            }
+            const visible = r.items.slice(0, 10);
+            for (let i = 0; i < visible.length; i++) {
+                const it = visible[i];
+                console.log(`${i + 1}. [${it.workdate ?? it.createdate ?? ''}] ${it.creator ?? '(未知)'}  ${hyperlinkFor('blog', it, blogBase, it.content ?? '(无内容)')}`);
+            }
+            if (r.items.length > visible.length)
+                console.log(`还有 ${r.items.length - visible.length} 条未显示，请用 --page <页码> 继续（每页 10 条）。`);
+            return;
+        }
+        const date = flagStr(args, 'date') ?? todayStr();
+        const page = Number(flagStr(args, 'page') ?? '1') || 1;
+        const r = await getMyBlogList(cfg, date, page);
+        if (args.flags.raw) {
+            console.error('===== RAW getMyBlogList =====');
+            console.error(JSON.stringify(r.raw, null, 2));
+            console.error('===== 解析结果 =====');
+        }
+        if (args.flags.json) {
+            console.log(JSON.stringify({ endDate: r.endDate, total: r.total, count: r.items.length, items: r.items.map((it) => withLink('blog', { id: it.id, content: it.content, workdate: it.workdate, creator: it.creator, createdate: it.createdate, shareType: it.shareType, isReCalled: it.isReCalled }, blogBase)) }, null, 2));
+            return;
+        }
+        console.log(`E9 微博 [我的微博 ${r.endDate}]  第 ${r.page} 页（每页 ${r.pageSize} 条）`);
+        if (r.items.length === 0) {
+            console.log('（无数据）');
+            return;
+        }
+        for (let i = 0; i < r.items.length; i++) {
+            const it = r.items[i];
+            console.log(`${i + 1}. [${it.workdate ?? it.createdate ?? ''}] ${hyperlinkFor('blog', it, blogBase, it.content ?? '(无内容)')}`);
+            const meta = [it.creator, it.shareType ? `shareType=${it.shareType}` : null].filter(Boolean).join(' | ');
+            if (meta)
+                console.log(`   ${meta}`);
+        }
+        // getMyBlogList 无总数，只能按本页是否满一页提示可能有更多；服务端越界会重复回放，翻到重复内容即已到末尾
+        if (r.items.length === r.pageSize)
+            console.log(`本页 ${r.pageSize} 条，可能还有更多，用 --page ${r.page + 1} 继续（每页 ${r.pageSize} 条）；若内容与上页重复则已到末尾。`);
+        return;
+    }
+    if (sub === 'search') {
+        const content = flagStr(args, 'content');
+        if (!content) {
+            console.error('blog search 需要 --content <关键词>');
+            process.exit(1);
+        }
+        const r = await searchMyBlog(cfg, {
+            content,
+            startDate: flagStr(args, 'start-date'),
+            endDate: flagStr(args, 'end-date'),
+            page: Number(flagStr(args, 'page') ?? '1') || 1,
+        });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ content: r.content, page: r.page, total: r.total, count: r.items.length, items: r.items.map((it) => withLink('blog', { id: it.id, content: it.content, workdate: it.workdate, creator: it.creator, createdate: it.createdate, shareType: it.shareType, isReCalled: it.isReCalled }, blogBase)) }, null, 2));
+            return;
+        }
+        console.log(`E9 微博搜索 [${r.content}]  共 ${r.total ?? '?'} 条`);
+        if (r.items.length === 0) {
+            console.log('（无匹配）');
+            return;
+        }
+        const visible = r.items.slice(0, 10);
+        for (let i = 0; i < visible.length; i++) {
+            const it = visible[i];
+            console.log(`${i + 1}. [${it.workdate ?? it.createdate ?? ''}] ${it.creator ?? '(未知)'}  ${hyperlinkFor('blog', it, blogBase, it.content ?? '(无内容)')}`);
+        }
+        if (r.items.length > visible.length)
+            console.log(`还有 ${r.items.length - visible.length} 条未显示，请用 --page <页码> 继续（每页 10 条）。`);
+        return;
+    }
+    if (sub === 'view') {
+        const userId = flagStr(args, 'user-id');
+        if (!userId) {
+            console.error('blog view 需要 --user-id <用户id>');
+            process.exit(1);
+        }
+        const r = await getBlogPersonalInfo(cfg, userId);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`${BOX_TOP}`);
+        console.log(`微博主页  ${r.username ?? '?'}(${r.userId})`);
+        console.log(DIVIDER);
+        console.log(`  部门: ${r.deptName ?? '?'}(${r.deptId ?? '?'})`);
+        console.log(`  微博数: ${r.blogCount ?? '?'}  |  关注: ${r.myAttentionCount ?? '?'}  |  粉丝: ${r.attentionMeCount ?? '?'}`);
+        console.log(`  是否下级: ${r.isLower ? '是' : '否'}  |  关注状态: ${r.attentionStatus ?? '?'}`);
+        console.log(`${BOX_TOP}`);
+        return;
+    }
+    if (sub === 'remind') {
+        const userId = flagStr(args, 'user-id') || flagStr(args, 'remind-id');
+        if (!userId) {
+            console.error('blog remind 需要 --user-id <用户id>（必填）');
+            process.exit(1);
+        }
+        const workdate = flagStr(args, 'workdate') || todayStr();
+        const send = !!args.flags.yes;
+        const r = await sendRemindUnsubmit(cfg, { remindId: userId, workdate, send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。将催办 userId=${r.remindId}  workdate=${r.workdate}。确认后加 --yes。`);
+            return;
+        }
+        console.log(`[已催办] userId=${r.remindId}  workdate=${r.workdate}  status=${r.response?.status}`);
+        const j = r.response?.json;
+        const ok = j?.api_status === true || j?.status === '1' || j?.status === true;
+        console.log(`  ${ok ? '✅ 催办成功' : '⚠ 催办失败'}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 300));
+        return;
+    }
+    if (sub === 'reply') {
+        const blogId = flagStr(args, 'id');
+        const content = flagStr(args, 'content');
+        if (!blogId || !content) {
+            console.error('blog reply 需要 --id <微博id> --content <内容>');
+            process.exit(1);
+        }
+        const send = !!args.flags.yes;
+        // 被评论人 userid(bediscussantId) + workdate：手动优先，否则从微博列表按 id 查
+        let discussantId = flagStr(args, 'bediscussant-id');
+        let workdate = flagStr(args, 'workdate');
+        if (!discussantId || !workdate) {
+            const date = flagStr(args, 'date') ?? todayStr();
+            // 逐页拉取当天全部微博（重复检测终止），避免目标微博落在单页之外
+            const list = await getMyBlogAll(cfg, date);
+            const hit = (list.items || []).find(b => String(b.id) === String(blogId));
+            if (!hit) {
+                console.error(`未在微博列表(${date})找到 id=${blogId}。用 --bediscussant-id <作者userid> --workdate <YYYY-MM-DD> 手动指定，或 --date 指定微博日期。`);
+                process.exit(1);
+            }
+            discussantId = discussantId || (hit.raw?.userid ? String(hit.raw.userid) : '') || (hit.raw?.creater ? String(hit.raw.creater) : '') || (hit.userid ? String(hit.userid) : '');
+            workdate = workdate || (hit.workdate ? String(hit.workdate) : '') || (hit.raw?.workdate ? String(hit.raw.workdate) : '') || String(hit.createdate ?? '').slice(0, 10);
+        }
+        const r = await addBlogReply(cfg, { blogId, content, send, discussantId, workdate });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。将回复微博 id=${r.blogId}（被评论人 userid=${discussantId}, workdate=${workdate}）。确认后加 --yes。`);
+            return;
+        }
+        console.log(`[已回复] blogId=${r.blogId}  status=${r.response?.status}`);
+        const j = r.response?.json;
+        const ok = j?.status === '1' || j?.status === 1 || j?.api_status === '1';
+        console.log(`  ${ok ? '✅ 回复成功' : '⚠ 回复失败'}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 300));
+        return;
+    }
+    if (sub === 'like') {
+        const blogId = flagStr(args, 'id');
+        if (!blogId) {
+            console.error('blog like 需要 --id <微博id>');
+            process.exit(1);
+        }
+        const send = !!args.flags.yes;
+        // 手动参数优先；否则自动从微博列表解析 workdate / 当前用户 id / 当前点赞状态。
+        // SPA bundle 实证 addOrDeleteZan 请求体：workdate + userId + optType(1=赞/0=取消) + discussId(微博id)。
+        let workdate = flagStr(args, 'workdate');
+        let userId = flagStr(args, 'user-id');
+        let optType = flagStr(args, 'opt-type');
+        if (!workdate || !userId || !optType) {
+            const date = flagStr(args, 'date') ?? todayStr();
+            // 逐页拉取当天全部微博（重复检测终止），避免目标微博落在单页之外
+            const list = await getMyBlogAll(cfg, date);
+            const hit = (list.items || []).find((b) => String(b.id) === String(blogId));
+            if (!hit) {
+                console.error(`未在微博列表(${date})找到 id=${blogId}。用 --workdate <YYYY-MM-DD> --user-id <当前用户id> --opt-type <1|0> 手动指定，或 --date 指定微博日期。`);
+                process.exit(1);
+            }
+            workdate = workdate || String(hit.workdate ?? '') || String(hit.createdate ?? '').slice(0, 10);
+            if (!userId) {
+                const me = await getCurrentUserInfo(cfg);
+                userId = me.id ? String(me.id) : '';
+            }
+            if (!optType) {
+                // 已赞判定：blogZanBean.blogZanPoList 含当前用户 zanHrmid（与前端 bundle 同款逻辑）
+                const zanList = Array.isArray(hit.raw?.blogZanBean?.blogZanPoList) ? hit.raw.blogZanBean.blogZanPoList : [];
+                const alreadyLiked = zanList.some((z) => String(z.zanHrmid ?? '') === String(userId));
+                optType = alreadyLiked ? '0' : '1';
+            }
+            if (!workdate || !userId) {
+                console.error('未能自动解析 workdate/userId，请用 --workdate --user-id 手动指定。');
+                process.exit(1);
+            }
+        }
+        const r = await addOrDeleteZan(cfg, { blogId, workdate, userId, optType, send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。将${optType === '1' ? '点赞' : '取消点赞'}微博 id=${r.blogId}（workdate=${workdate}, userId=${userId}）。确认后加 --yes。`);
+            return;
+        }
+        if (args.flags.json) {
+            console.log(JSON.stringify({ blogId: r.blogId, optType: r.optType, workdate, userId, isZan: r.isZan, response: r.response?.json }, null, 2));
+            return;
+        }
+        const j = r.response?.json;
+        const verb = r.optType === '1' ? '点赞' : '取消点赞';
+        console.log(`[${verb}] blogId=${r.blogId}  status=${r.response?.status}`);
+        console.log(`  ${r.ok ? '✅ 操作成功' : '⚠ 操作失败'}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 300));
+        return;
+    }
+    if (sub === 'create') {
+        let content = flagStr(args, 'content');
+        const contentFile = flagStr(args, 'content-file');
+        if (!content && contentFile) {
+            try {
+                const fs = await import('node:fs');
+                content = fs.readFileSync(contentFile, 'utf8');
+            }
+            catch (e) {
+                console.error(`读取 --content-file 失败：${e.message}`);
+                process.exit(1);
+            }
+        }
+        if (!content) {
+            console.error('blog create 需要 --content "<文本>" 或 --content-file <路径>');
+            process.exit(1);
+        }
+        const send = !!args.flags.yes;
+        const r = await createBlog(cfg, { content, shareType: flagStr(args, 'share-type'), workdate: flagStr(args, 'date'), discussId: flagStr(args, 'discuss-id'), send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。模式: ${r.mode}  目标: ${r.endpoint.baseUrl}/api/blog/base/saveOrUpdateBlog`);
+            console.log('请求体:');
+            console.log(JSON.stringify(r.body, null, 2));
+            console.log('\n确认无误后加 --yes 真正发布。');
+            return;
+        }
+        console.log(`[已发送] 模式: ${r.mode}  ${r.endpoint.baseUrl}/api/blog/base/saveOrUpdateBlog  status=${r.response?.status}`);
+        const j = r.response?.json;
+        const ok = j?.api_status === true || j?.api_status === '1' || j?.status === '1' || j?.status === true || j?.success === true;
+        console.log(`  ${ok ? '✅ 发送成功' : '⚠ 发送失败'}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 500));
+        else
+            console.log('响应(非JSON):', (r.response?.text ?? '').slice(0, 300));
+        if (!ok)
+            process.exit(1);
+        return;
+    }
+    if (sub === 'stats') {
+        const [wi, mc] = await Promise.all([getBlogWorkIndex(cfg), getBlogMenuCountdata(cfg)]);
+        if (args.flags.json) {
+            console.log(JSON.stringify({ workIndex: wi, menuCounts: mc }, null, 2));
+            return;
+        }
+        console.log(`${BOX_TOP}`);
+        console.log(`E9 微博 工作指数 & 心情指数`);
+        console.log(DIVIDER);
+        console.log(`  工作指数: ${wi.work.index ?? '?'}  ${wi.work.title ?? ''}`);
+        console.log(`  心情指数: ${wi.mood.index ?? '?'}  ${wi.mood.title ?? ''}`);
+        console.log(DIVIDER);
+        console.log('统计:');
+        const c = mc.counts;
+        console.log(`  微博数: ${c.blogCount ?? '?'}  |  待审批: ${c.requestCount ?? '?'}  |  更新: ${c.updateCount ?? '?'}`);
+        console.log(`  评论: ${c.commentCount ?? '?'}  |  提醒: ${c.remindCount ?? '?'}  |  关注: ${c.myAttentionCount ?? '?'}`);
+        console.log(`${BOX_TOP}`);
+        return;
+    }
+    if (sub === 'note') {
+        const date = flagStr(args, 'date') ?? todayStr();
+        // --save：写入草稿/便签（saveBlogNote）。E9 微博无独立草稿，存到工作笔记。
+        if (flagBool(args, 'save')) {
+            let content = flagStr(args, 'content');
+            const contentFile = flagStr(args, 'content-file');
+            if (!content && contentFile) {
+                try {
+                    const fs = await import('node:fs');
+                    content = fs.readFileSync(contentFile, 'utf8');
+                }
+                catch (e) {
+                    console.error(`读取 --content-file 失败：${e.message}`);
+                    process.exit(1);
+                }
+            }
+            if (!content) {
+                console.error('blog note --save 需要 --content "<文本>" 或 --content-file <路径>');
+                process.exit(1);
+            }
+            const send = !!args.flags.yes;
+            const r = await saveBlogNote(cfg, { content, workdate: date, send });
+            if (!r.sent) {
+                console.log(`[dry-run] 未发送。将保存草稿到 ${r.workdate}（POST /api/blog/base/saveBlogNote）。确认后加 --yes。`);
+                return;
+            }
+            console.log(`[已保存] 草稿 workdate=${r.workdate}  status=${r.response?.status}`);
+            console.log(`  ${r.ok ? '✅ 保存成功' : '⚠ 保存失败'}`);
+            if (r.response?.json)
+                console.log('响应:', JSON.stringify(r.response.json).slice(0, 300));
+            return;
+        }
+        const r = await getBlogNote(cfg, date);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`E9 微博草稿 [${r.workdate ?? date}]`);
+        if (r.content)
+            console.log(r.content);
+        else
+            console.log('（无草稿）');
+        return;
+    }
+    if (sub === 'recall') {
+        // 微博撤回/恢复。E9 微博不可删除，撤回是唯一收回手段（POST /api/blog/myblog/recallblog）。
+        const blogId = flagStr(args, 'id');
+        if (!blogId) {
+            console.error('blog recall 需要 --id <微博id>（建议同时给 --workdate）');
+            process.exit(1);
+        }
+        const opType = flagBool(args, 'restore') ? 0 : 1; // --restore 恢复已撤回
+        const send = !!args.flags.yes;
+        const r = await recallBlog(cfg, { blogId, workdate: flagStr(args, 'workdate'), opType, send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。将${opType === 1 ? '撤回' : '恢复'}微博 blogId=${r.blogId}（opType=${opType}）。确认后加 --yes。`);
+            return;
+        }
+        console.log(`[已${opType === 1 ? '撤回' : '恢复'}] blogId=${r.blogId}  status=${r.response?.status}`);
+        console.log(`  ${r.ok ? '✅ 操作成功' : '⚠ 操作失败'}`);
+        if (r.response?.json)
+            console.log('响应:', JSON.stringify(r.response.json).slice(0, 400));
+        return;
+    }
+    if (sub === 'delete-reply') {
+        // 删除微博评论（正文不可删，只能撤回；评论可删）。POST /api/blog/base/deleteBlogReplay。
+        const replyId = flagStr(args, 'id');
+        const discussId = flagStr(args, 'discuss-id');
+        if (!replyId || !discussId) {
+            console.error('blog delete-reply 需要 --id <评论id> --discuss-id <微博id>');
+            process.exit(1);
+        }
+        const send = !!args.flags.yes;
+        const r = await deleteBlogReply(cfg, { replyId, discussId, workdate: flagStr(args, 'workdate'), send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。将删除评论 replyId=${r.replyId}（discussId=${discussId}）。确认后加 --yes。`);
+            return;
+        }
+        console.log(`[已删除评论] replyId=${r.replyId}  status=${r.response?.status}`);
+        console.log(`  ${r.ok ? '✅ 删除成功' : '⚠ 删除失败'}`);
+        if (r.response?.json)
+            console.log('响应:', JSON.stringify(r.response.json).slice(0, 300));
+        return;
+    }
+    if (sub === 'user-info') {
+        const r = await getCurrentUserInfo(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`${BOX_TOP}`);
+        console.log(`E9 微博 当前用户`);
+        console.log(DIVIDER);
+        console.log(`  ID: ${r.id}  |  姓名: ${r.lastname}  |  部门: ${r.departmentName}  |  岗位: ${r.jobtitle}`);
+        console.log(`${BOX_TOP}`);
+        return;
+    }
+    if (sub === 'reminders') {
+        const r = await getMsgRemindList(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`E9 微博 消息提醒  共 ${r.items.length} 条`);
+        if (r.items.length === 0) {
+            console.log('（无提醒）');
+            return;
+        }
+        for (let i = 0; i < r.items.length; i++) {
+            const it = r.items[i];
+            console.log(`${i + 1}. [${it.type ?? ''}] ${it.content ?? ''}  ${it.creator ?? ''}  ${it.createDate ?? ''}`);
+        }
+        return;
+    }
+    if (sub === 'apps') {
+        const r = await getBlogAppList(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log('E9 微博 可用应用:');
+        for (const g of r.appList) {
+            console.log(`  ${g.name}: ${g.items.join(', ')}`);
+        }
+        return;
+    }
+    if (sub === 'at-list') {
+        const page = Number(flagStr(args, 'page') ?? '1') || 1;
+        const q = (flagStr(args, 'name') ?? '').trim().toLowerCase();
+        const r = await getAtAllList(cfg, { pageIndex: page, name: flagStr(args, 'name') ?? '' });
+        // 人员搜索消歧排序：精确匹配(name==搜索词) > 前缀 > 拼音缩写/包含（修复#5）
+        // 原接口按拼音缩写返回，精确匹配常被埋在列表中段，这里前置并标注。
+        const annotated = r.items.map((it) => {
+            const name = String(it.name ?? '').trim();
+            const nameLow = name.toLowerCase();
+            let matchType = 'other';
+            if (q && nameLow === q)
+                matchType = 'exact';
+            else if (q && nameLow.startsWith(q))
+                matchType = 'prefix';
+            return { ...it, matchType, _sort: matchType === 'exact' ? 0 : matchType === 'prefix' ? 1 : 2 };
+        });
+        annotated.sort((a, b) => a._sort - b._sort);
+        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));
+            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}`);
+        }
+        return;
+    }
+    if (sub === 'visitors') {
+        const recordType = flagStr(args, 'type') ?? 'visit';
+        const page = Number(flagStr(args, 'page') ?? '1') || 1;
+        const r = await getVisitorList(cfg, { recordType, page });
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        const label = recordType === 'access' ? '我访问的' : '访问我的';
+        console.log(`E9 微博 访客列表 [${label}] [第 ${r.page} 页]  共 ${r.total} 条`);
+        if (r.items.length === 0) {
+            console.log('（无访客）');
+            return;
+        }
+        for (let i = 0; i < r.items.length; i++) {
+            const it = r.items[i];
+            console.log(`${i + 1}. ${it.visitorName || it.visitor || it.name || '(未知)'}  ${it.visitDate ?? ''}`);
+        }
+        return;
+    }
+    if (sub === 'search-fields') {
+        const r = await getBlogPageSearchCondition(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log('E9 微博 搜索可用字段:');
+        let lastGroup = '';
+        for (const f of r.fields) {
+            if (f.group && f.group !== lastGroup) {
+                console.log(`  [${f.group}]`);
+                lastGroup = f.group;
+            }
+            console.log(`    ${f.label}  (${f.type})  domkey=${f.domkey}`);
+        }
+        return;
+    }
+    if (sub === 'template') {
+        const r = await getDefaultTemplate(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`E9 微博 默认模板`);
+        if (r.isEmpty) {
+            console.log('（未配置模板）');
+            return;
+        }
+        console.log(JSON.stringify(r.template, null, 2));
+        return;
+    }
+    console.error(`blog 暂只支持 list / search / view / remind / reply / like / create / check / stats / note / recall / delete-reply / user-info / reminders / apps / at-list / visitors / search-fields / template，收到: ${sub}`);
+    process.exit(1);
+}
+async function runWorkplan(args) {
+    const sub = args._[1] ?? 'list';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const wpBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    if (sub === 'import-template') {
+        const r = await downloadWorkplanImportTemplate(cfg, { outDir: flagStr(args, 'out-dir'), filename: flagStr(args, 'filename') });
+        if (args.flags.json) console.log(JSON.stringify(r, null, 2));
+        else {
+            console.log(`日程批量导入模板已下载到：${r.outPath}`);
+            console.log(`必填字段：${r.requiredFields.join('、')}`);
+            console.log('可选择：自己填写；把文件交给助手填写；或直接描述每行数据。填写时只允许改数据单元格。');
+        }
+        return;
+    }
+    if (sub === 'import') {
+        const file = flagStr(args, 'file');
+        if (!file) throw new Error('workplan import 需要 --file <已填写模板路径>。');
+        const r = await importWorkplanExcel(cfg, { file, yes: !!args.flags.yes, secretLevel: flagStr(args, 'secret-level') });
+        if (args.flags.json) console.log(JSON.stringify(r, null, 2));
+        else if (!r.imported && r.requiresConfirmation) console.log(`将导入日程文件：${r.filePath}\n确认文件内容无误后加 --yes。`);
+        else console.log(`${r.imported ? '✅ 日程导入成功' : '⚠ 日程导入失败'}${r.message ? `：${r.message}` : ''}`);
+        if (args.flags.yes && !r.imported) process.exitCode = 1;
+        return;
+    }
+    if (sub === 'list') {
+        // 使用 getCalendarData 替代 AllCalendar，支持组织视图
+        const group = flagStr(args, 'group');
+        // 先获取 baseData 拿组织信息
+        const bd = await getBaseData(cfg);
+        let objType = '1', objIds = bd.dept[0]?.id ?? '';
+        if (group) {
+            const groupMap = { '部门': '1', '分部': '2', '人力': '3', '上级': '4', '下级': '5', '常用组': '6', '关注': '7' };
+            const gkey = groupMap[group] || group;
+            const sg = bd.selectGroup.find((g) => g.key === gkey);
+            if (sg) {
+                if (gkey === '1') {
+                    objType = '1';
+                    objIds = bd.dept[0]?.id ?? '';
+                }
+                else if (gkey === '2') {
+                    objType = '2';
+                    objIds = bd.subComp[0]?.id ?? '';
+                }
+                else if (gkey === '5') {
+                    objType = '1';
+                    objIds = bd.dept[0]?.id ?? '';
+                }
+            }
+        }
+        const r = await getCalendarData(cfg, {
+            selectDate: flagStr(args, 'date'),
+            objType,
+            objIds,
+            workPlanType: flagStr(args, 'type'),
+        });
+        if (args.flags.raw) {
+            console.error('===== RAW getCalendarData =====');
+            console.error(JSON.stringify(r.raw, null, 2));
+            console.error('===== 解析结果 =====');
+        }
+        if (args.flags.json) {
+            console.log(JSON.stringify({
+                selectDate: r.selectDate,
+                count: r.count,
+                memberids: r.memberids,
+                events: r.events.map((ev) => withLink('workplan', {
+                    id: ev.id, name: ev.name,
+                    beginDate: ev.beginDate, beginTime: ev.beginTime,
+                    endDate: ev.endDate, endTime: ev.endTime,
+                    color: ev.color, workplanType: ev.workplanType,
+                    creater: ev.creater, description: ev.description,
+                    memberName: ev.memberName,
+                }, wpBase)),
+            }, null, 2));
+            return;
+        }
+        const groupLabel = group ? ` · ${group}` : '';
+        console.log(`E9 日程 [${r.selectDate}${groupLabel}]  共 ${r.count} 条`);
+        if (r.count === 0) {
+            console.log('（该区间无日程）');
+            return;
+        }
+        for (const d of r.datas) {
+            console.log(`\n  ── ${d.memberName || d.memberid} ──`);
+            for (let i = 0; i < d.info.length; i++) {
+                const ev = d.info[i];
+                const time = [ev.beginDate, ev.beginTime].filter(Boolean).join(' ') + ' ~ ' + [ev.endDate, ev.endTime].filter(Boolean).join(' ');
+                console.log(`  ${i + 1}. ${hyperlinkFor('workplan', ev, wpBase, ev.name ?? '(无名)')}  [${time}]`);
+                if (ev.description)
+                    console.log(`     ${ev.description}`);
+            }
+        }
+        return;
+    }
+    if (sub === 'view') {
+        const id = flagStr(args, 'id');
+        if (!id) {
+            console.error('workplan view 需要 --id <日程id>');
+            process.exit(1);
+        }
+        const r = await viewWorkplan(cfg, id);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`${BOX_TOP}`);
+        console.log(`日程详情  id=${r.id}`);
+        console.log(DIVIDER);
+        console.log(`  名称: ${r.name ?? '(无)'}`);
+        console.log(`  时间: ${r.beginDateTime ?? '?'} ~ ${r.endDateTime ?? '?'}`);
+        console.log(`  描述: ${r.description ?? '(无)'}`);
+        console.log(`  类型: ${r.workPlanType ?? '?'}  |  紧急: ${r.urgentLevel ?? '?'}`);
+        console.log(`  成员: ${r.memberIDs ?? '(无)'}`);
+        console.log(`  操作: ${(r.buttons || []).join(' / ')}`);
+        console.log(`${BOX_TOP}`);
+        return;
+    }
+    if (sub === 'finish') {
+        const id = flagStr(args, 'id');
+        if (!id) {
+            console.error('workplan finish 需要 --id <日程id>');
+            process.exit(1);
+        }
+        const send = !!args.flags.yes;
+        const r = await finishWorkplan(cfg, id, { send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。将完成日程 workid=${r.workid}。确认后加 --yes。`);
+            return;
+        }
+        console.log(`[已完成] workid=${r.workid}  status=${r.response?.status}`);
+        const j = r.response?.json;
+        const ok = j?.api_status === true || j?.status === '1' || j?.status === true || j?.success === true;
+        console.log(`  ${ok ? '✅ 完成成功' : '⚠ 完成失败'}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 300));
+        return;
+    }
+    if (sub === 'delete') {
+        const id = flagStr(args, 'id');
+        if (!id) {
+            console.error('workplan delete 需要 --id <日程id>');
+            process.exit(1);
+        }
+        const send = !!args.flags.yes;
+        const r = await deleteWorkplan(cfg, id, { send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。将删除日程 workid=${r.workid}。确认后加 --yes。⚠️ 删除不可恢复！`);
+            return;
+        }
+        console.log(`[已删除] workid=${r.workid}  status=${r.response?.status}`);
+        const j = r.response?.json;
+        const ok = j?.api_status === true || j?.status === '1' || j?.status === true || j?.success === true;
+        console.log(`  ${ok ? '✅ 删除成功' : '⚠ 删除失败'}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 300));
+        return;
+    }
+    if (sub === 'types') {
+        const r = await getSelectType(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`E9 日程类型 共 ${r.types.length} 种`);
+        for (const t of r.types) {
+            console.log(`  ${t.key}. ${t.name}`);
+        }
+        return;
+    }
+    if (sub === 'search-conditions') {
+        const r = await getWorkplanSearchCondition(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`${BOX_TOP}`);
+        console.log('E9 日程 搜索条件');
+        console.log(DIVIDER);
+        console.log('分组:');
+        for (const g of r.groups) {
+            console.log(`  ${g.id}  ${g.title}`);
+        }
+        console.log('\n搜索字段:');
+        let lastGroup = '';
+        for (const f of r.fields) {
+            if (f.group && f.group !== lastGroup) {
+                console.log(`  [${f.group}]`);
+                lastGroup = f.group;
+            }
+            const opts = f.options.length > 0 ? `  选项: ${f.options.map((o) => `${o.key}=${o.name}`).join(', ')}` : '';
+            console.log(`    ${f.label}  (${f.type})  domkey=${f.domkey}${opts}`);
+        }
+        console.log(`${BOX_TOP}`);
+        return;
+    }
+    if (sub === 'search') {
+        // 支持 --group 分组搜索
+        let groupFilter = flagStr(args, 'group');
+        if (groupFilter) {
+            try {
+                const cond = await getWorkplanSearchCondition(cfg);
+                const g = cond.groups.find((g) => g.id === groupFilter || g.title === groupFilter);
+                if (g)
+                    groupFilter = String(g.viewcondition);
+            }
+            catch { /* 获取分组失败不阻断 */ }
+        }
+        const r = await searchWorkplan(cfg, {
+            name: flagStr(args, 'name'),
+            type: flagStr(args, 'type'),
+            status: flagStr(args, 'status'),
+            createrId: flagStr(args, 'creater'),
+            receiveId: flagStr(args, 'receiver'),
+            timeSag: groupFilter ?? flagStr(args, 'time-sag') ?? '0',
+            beginDate: flagStr(args, 'begin'),
+            endDate: flagStr(args, 'end'),
+            isOvertime: flagStr(args, 'overtime'),
+            createrDep: flagStr(args, 'creater-dep'),
+            createrSub: flagStr(args, 'creater-sub'),
+            docids: flagStr(args, 'doc-ids'),
+            requestids: flagStr(args, 'request-ids'),
+            prjids: flagStr(args, 'prj-id'),
+            crmids: flagStr(args, 'crm-id'),
+            page: Number(flagStr(args, 'page') ?? '1') || 1,
+        });
+        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({
+                dataKey: r.dataKey, page: r.page, total: r.total, pageSize: r.pageSize, count: r.items.length,
+                items: r.items.map((it) => withLink('workplan', {
+                    id: it.id, name: it.name, type: it.typeId, typeName: it.typeName,
+                    urgent: it.urgentLevel, urgentName: it.urgentName,
+                    creater: it.creater, createrId: it.createrId,
+                    status: it.status, statusName: it.statusName,
+                    begin: it.beginDate, end: it.endDate,
+                }, wpBase)),
+            }, null, 2));
+            return;
+        }
+        console.log(`E9 日程搜索 [第 ${r.page} 页${r.total != null ? ` / 共 ${r.total}` : ''}]  当前 ${r.items.length} 条`);
+        if (r.items.length === 0) {
+            console.log('（无匹配日程）');
+            return;
+        }
+        const visible = r.items.slice(0, 10);
+        for (let i = 0; i < visible.length; i++) {
+            const it = visible[i];
+            const time = [it.beginDate, it.endDate].filter(Boolean).join(' ~ ');
+            console.log(`${i + 1}. ${hyperlinkFor('workplan', it, wpBase, it.name ?? '(无名)')}${time ? `  [${time}]` : ''}`);
+            const meta = [it.typeName, it.urgentName, it.statusName, it.creater].filter(Boolean).join(' | ');
+            if (meta)
+                console.log(`   ${meta}`);
+        }
+        if (r.items.length > visible.length)
+            console.log(`还有 ${r.items.length - visible.length} 条未显示，请用 --page <页码> 继续（每页 10 条）。`);
+        return;
+    }
+    if (sub === 'create') {
+        const planName = flagStr(args, 'name');
+        const beginDateTime = flagStr(args, 'begin');
+        const endDateTime = flagStr(args, 'end');
+        if (!planName || !beginDateTime || !endDateTime) {
+            console.error('workplan create 需要 --name <名称> --begin "YYYY-MM-DD HH:mm" --end "YYYY-MM-DD HH:mm"');
+            process.exit(1);
+        }
+        let description = flagStr(args, 'description');
+        const descriptionFile = flagStr(args, 'description-file');
+        if (!description && descriptionFile) {
+            try {
+                const fs = await import('node:fs');
+                description = fs.readFileSync(descriptionFile, 'utf8');
+            }
+            catch (e) {
+                console.error(`读取 --description-file 失败：${e.message}`);
+                process.exit(1);
+            }
+        }
+        const send = !!args.flags.yes;
+        const r = await createWorkplan(cfg, { planName, beginDateTime, endDateTime, workPlanType: flagStr(args, 'type'), secretLevel: flagStr(args, 'secret'), urgentLevel: flagStr(args, 'urgent'), description, memberIDs: flagStr(args, 'members'), docIDs: flagStr(args, 'doc-ids'), requestIDs: flagStr(args, 'request-ids'), send });
+        if (!r.sent) {
+            console.log(`[dry-run] 未发送。目标: ${r.endpoint.baseUrl}/api/workplan/base/add`);
+            console.log('请求体:');
+            console.log(JSON.stringify(r.body, null, 2));
+            console.log('\n确认无误后加 --yes 真正新建。');
+            return;
+        }
+        console.log(`[已新建] ${r.endpoint.baseUrl}/api/workplan/base/add  status=${r.response?.status}`);
+        const j = r.response?.json;
+        const ok = j?.api_status === true || j?.api_status === '1' || j?.status === '1' || j?.status === true || j?.success === true;
+        console.log(`  ${ok ? '✅ 新建成功' : '⚠ 新建失败（api_status 未通过）'}`);
+        if (j)
+            console.log('响应:', JSON.stringify(j).slice(0, 500));
+        else
+            console.log('响应(非JSON):', (r.response?.text ?? '').slice(0, 300));
+        if (!ok)
+            process.exit(1);
+        return;
+    }
+    if (sub === 'my-calendar') {
+        const r = await getMyCalendar(cfg, { selectDate: flagStr(args, 'date'), viewType: flagStr(args, 'view-type'), selectUser: flagStr(args, 'select-user'), workPlanType: flagStr(args, 'type') });
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`E9 日程 MyCalendar [${r.selectDate}]  viewType=${r.viewType}  ${r.range.start} ~ ${r.range.end}  共 ${r.items.length} 条`);
+        if (r.items.length === 0) {
+            console.log('（无日程）');
+            return;
+        }
+        for (let i = 0; i < r.items.length; i++) {
+            const it = r.items[i];
+            const time = [it.beginDateTime, it.endDateTime].filter(Boolean).join(' ~ ');
+            const allDay = it.allDay === '1' ? ' [全天]' : '';
+            console.log(`${i + 1}. ${hyperlinkFor('workplan', it, wpBase, it.name ?? '(无名)')}${allDay}${time ? `  [${time}]` : ''}  ${it.typeName ?? ''}`);
+        }
+        return;
+    }
+    if (sub === 'attention') {
+        const r = await getAttentionData(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`E9 日程 关注的日程  totalpage=${r.totalpage}  共 ${r.items.length} 条`);
+        if (r.items.length === 0) {
+            console.log('（无关注数据）');
+            return;
+        }
+        for (let i = 0; i < r.items.length; i++) {
+            const it = r.items[i] || {};
+            const time = [it.begindate, it.enddate].filter(Boolean).join(' ~ ');
+            console.log(`${i + 1}. ${hyperlinkFor('workplan', it, wpBase, it.name || '(无名)')}${time ? `  [${time}]` : ''}`);
+        }
+        return;
+    }
+    if (sub === 'base-data') {
+        const r = await getBaseData(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        console.log(`${BOX_TOP}`);
+        console.log('E9 日程 日历初始化数据');
+        console.log(DIVIDER);
+        if (r.dept.length > 0)
+            console.log(`  部门: ${r.dept.map((d) => `${d.name}(${d.id})`).join(', ')}`);
+        if (r.subComp.length > 0)
+            console.log(`  分部: ${r.subComp.map((s) => `${s.name}(${s.id})`).join(', ')}`);
+        console.log(`  工作时段: ${r.wpSetInfo.amStart ?? '?'}~${r.wpSetInfo.amEnd ?? '?'} / ${r.wpSetInfo.pmStart ?? '?'}~${r.wpSetInfo.pmEnd ?? '?'}`);
+        console.log(`  时间范围: ${r.timeRange.start}~${r.timeRange.end}  |  同步天数: ${r.syncDay}  |  周起始: ${r.weekstartday}`);
+        console.log(`  视图类型: ${r.viewType ?? '?'}  |  时区偏移: ${r.zone_offset ?? '?'}`);
+        console.log(`  可选组: ${r.selectGroup.map((g) => `${g.name}(${g.key})`).join(', ')}`);
+        if (r.selectType.length > 0)
+            console.log(`  日程类型: ${r.selectType.map((t) => `${t.name}(${t.key})`).join(', ')}`);
+        if (r.calendarInit)
+            console.log(`  日历区间: ${r.calendarInit.range.start} ~ ${r.calendarInit.range.end}  (${r.calendarInit.events.length} 条)`);
+        console.log(`${BOX_TOP}`);
+        return;
+    }
+    console.error(`workplan 暂只支持 list / view / finish / delete / types / search-conditions / search / create / my-calendar / attention / base-data / import-template / import，收到: ${sub}`);
+    process.exit(1);
+}
+async function runOdoc(args) {
+    const sub = args._[1] ?? 'todo';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const odocBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    if (sub === 'count') {
+        const r = await getOdocTodoCount(cfg, { view: flagBool(args, 'view') });
+        if (args.flags.raw) {
+            console.error('===== RAW getTodoCount =====');
+            console.error(JSON.stringify(r.raw, null, 2));
+            console.error('===== 解析结果 =====');
+        }
+        if (args.flags.json) {
+            console.log(JSON.stringify({ view: r.view, items: r.items }, null, 2));
+            return;
+        }
+        console.log(`E9 公文${r.view ? '待阅' : '待办'}计数`);
+        if (r.items.length === 0) {
+            console.log('（无数据）');
+            return;
+        }
+        let total = 0;
+        for (const it of r.items) {
+            console.log(`  ${it.title}（${it.officalType}）: ${it.count}`);
+            total += it.count;
+        }
+        console.log(`  合计: ${total}`);
+        return;
+    }
+    if (sub === 'create-list') {
+        const r = await listOdocCreate(cfg, { officalType: flagStr(args, 'type') ?? '1' });
+        if (args.flags.raw) {
+            console.error('===== RAW createOfficalList =====');
+            console.error(JSON.stringify(r.raw, null, 2));
+            console.error('===== 解析结果 =====');
+        }
+        if (args.flags.json) {
+            console.log(JSON.stringify({
+                officalType: r.officalType,
+                toplabel: r.toplabel,
+                categories: r.categories.map((c) => ({
+                    id: c.id,
+                    name: c.name,
+                    workflows: c.workflows.map((w) => withLink('create', { id: w.id, name: w.name, typeId: w.typeId, spell: w.spell }, odocBase)),
+                })),
+            }, null, 2));
+            return;
+        }
+        console.log(`E9 公文流程列表 · ${r.toplabel ?? (r.officalType === '1' ? '发文拟稿' : '收文登记')}`);
+        if (r.categories.length === 0) {
+            console.log('（无数据）');
+            if (args.flags.raw)
+                console.error('提示：用 --raw 查看真实响应校准解析。');
+            return;
+        }
+        const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        let idx = 0;
+        for (const c of r.categories) {
+            console.log(`\n  ■ ${c.name ?? '(未命名分类)'}  (${c.workflows.length})`);
+            for (const w of c.workflows) {
+                idx++;
+                console.log(`    ${String(idx).padStart(3, ' ')}. ${hyperlinkFor('create', w, base, w.name ?? '(无名称)')}  [id=${w.id ?? ''}]${w.spell ? `  (${w.spell})` : ''}`);
+            }
+        }
+        console.log('\n  发起公文复用 create start：e9 create start --id <流程id> ...');
+        return;
+    }
+    if (sub !== 'todo') {
+        console.error(`odoc 暂只支持 todo / count / create-list，收到: ${sub}`);
+        process.exit(1);
+    }
+    const r = await listOdocTodo(cfg, {
+        requestName: flagStr(args, 'subject'),
+        dispatchNum: flagStr(args, 'dispatch-num'),
+        odocType: flagStr(args, 'type'),
+        topicType: flagStr(args, 'topic'),
+        urgencyDegree: flagStr(args, 'urgent'),
+        secretLevel: flagStr(args, 'secret'),
+        sendUnit: flagStr(args, 'send-unit'),
+        receiveUnit: flagStr(args, 'receive-unit'),
+        issuedUserid: flagStr(args, 'issued-userid'),
+        ownerId: flagStr(args, 'owner-id'),
+        dealingUserid: flagStr(args, 'dealing-userid'),
+        undealedUserid: flagStr(args, 'undealed-userid'),
+        departmentId: flagStr(args, 'department'),
+        readStatus: flagStr(args, 'read-status'),
+        odocSubject: flagStr(args, 'odoc-subject'),
+        docAbstract: flagStr(args, 'doc-abstract'),
+        receiveNum: flagStr(args, 'receive-num'),
+        workflowId: flagStr(args, 'workflow-id'),
+        btnType: flagStr(args, 'btn-type'),
+        customListId: flagStr(args, 'custom-list-id'),
+        customTabId: flagStr(args, 'custom-tab-id'),
+        page: Number(flagStr(args, 'page') ?? '1') || 1,
+    });
+    if (args.flags.raw) {
+        console.error('===== RAW getCustomPageList =====');
+        console.error(JSON.stringify(r.raw.getCustomPageList, 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({
+            dataKey: r.dataKey,
+            page: r.page,
+            total: r.total,
+            pageSize: r.pageSize,
+            count: r.items.length,
+            columns: r.columns.map((c) => ({ dataIndex: c.dataIndex, title: c.title })),
+            items: r.items.map((it) => withLink('odoc', {
+                requestId: it.requestId,
+                requestName: it.requestName,
+                odocType: it.odocType,
+                odocTypeName: it.odocTypeName,
+                issuedNum: it.issuedNum,
+                receiveNum: it.receiveNum,
+                currentNodeId: it.currentNodeId,
+                currentNode: it.currentNode,
+                createrId: it.createrId,
+                createDate: it.createDate,
+                lastOperateDate: it.lastOperateDate,
+                zbr: it.zbr,
+                wbr: it.wbr,
+                workflowId: it.workflowId,
+            }, odocBase)),
+        }, null, 2));
+        return;
+    }
+    console.log(`E9 公文待办 [第 ${r.page} 页（每页 10 条）${r.total != null ? ` / 共 ${r.total}` : ''}]  当前 ${r.items.length} 条`);
+    if (r.items.length === 0) {
+        console.log('（无数据）');
+        if (args.flags.raw)
+            console.error('提示：用 --raw 查看真实响应校准解析。');
+        return;
+    }
+    for (let i = 0; i < r.items.length; i++) {
+        const it = r.items[i];
+        const nameLinked = hyperlinkFor('odoc', it, odocBase, it.requestName ?? '(无标题)');
+        console.log(`${i + 1}. ${nameLinked}`);
+        const meta = [
+            it.odocTypeName,
+            it.issuedNum ? `发文字号=${it.issuedNum}` : null,
+            it.currentNodeId,
+            it.createrId ? `拟稿人=${it.createrId}` : null,
+            it.createDate,
+            it.lastOperateDate ? `最后修改=${it.lastOperateDate}` : null,
+        ].filter(Boolean).join(' | ');
+        if (meta)
+            console.log(`   ${meta}`);
+    }
+    const remaining = (r.total ?? 0) - r.page * 10;
+    if (remaining > 0)
+        console.log(`还有 ${remaining} 条，用 --page ${r.page + 1} 继续（每页 10 条）。`);
+}
+async function runKq(args) {
+    const sub = args._[1] ?? 'status';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    if (sub === 'status') {
+        const r = await getButtons(cfg);
+        if (args.flags.raw) {
+            console.error('===== RAW getButtons =====');
+            console.error(JSON.stringify(r.raw, null, 2));
+            console.error('===== 解析结果 =====');
+        }
+        if (args.flags.json) {
+            console.log(JSON.stringify({ date: r.date, now: r.now, groupname: r.groupname, lastname: r.lastname, timeline: r.timeline }, null, 2));
+            return;
+        }
+        console.log(`${BOX_TOP}`);
+        console.log(`E9 考勤打卡  ${r.lastname} | ${r.groupname} | 今天=${r.date} | 服务器时间=${r.now}`);
+        console.log(DIVIDER);
+        if (r.timeline.length === 0) {
+            console.log('（今日无打卡班次）');
+            console.log(BOX_TOP);
+            return;
+        }
+        for (const it of r.timeline) {
+            const tag = it.type === 'on' ? '上班卡' : '下班卡';
+            const done = it.signTime ? `已打 ${it.signTime}` : '未打';
+            const active = it.active === '1' ? '【当前时段】' : '';
+            console.log(`  ${it.date} ${tag} ${active}  班次 ${it.time} | ${done}`);
+        }
+        console.log(BOX_TOP);
+        return;
+    }
+    if (sub === 'punch') {
+        const type = (args._[2] ?? 'off');
+        if (type !== 'on' && type !== 'off') {
+            console.error(`kq punch 参数须为 on（上班卡）或 off（下班卡），收到: ${type}`);
+            process.exit(1);
+        }
+        const groupId = flagStr(args, 'group-id') ?? '1';
+        const userid = flagStr(args, 'userid');
+        const date = flagStr(args, 'date');
+        const signTime = flagStr(args, 'sign-time');
+        const yes = flagBool(args, 'yes');
+        if (signTime !== undefined) {
+            console.error('kq punch 不支持指定 --sign-time。该参数不是修改既有打卡时间的安全接口；请使用 OA 考勤补签/更正流程。');
+            process.exit(1);
+        }
+        // 先 getButtons 展示目标班次 + 生成 encryptObj 给用户确认
+        const buttons = await getButtons(cfg);
+        let item;
+        try {
+            ({ item } = resolvePunchItem(buttons, { type, date }));
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        const uid = userid ?? parseUserIdFromCookie(cfg.cookie) ?? '';
+        if (!uid) {
+            console.error('未取到 userid：需 --userid，或 config.cookie 须含 loginuuids（token-login 写回）');
+            process.exit(1);
+        }
+        const ts = Date.now();
+        const encryptObj = buildEncryptObj(uid, groupId, ts);
+        const punchSignTime = nowHHmmssCLI();
+        console.log(`${BOX_TOP}`);
+        console.log(`E9 考勤打卡  ${buttons.lastname} | ${buttons.groupname}`);
+        console.log(DIVIDER);
+        console.log(`  类型：${type === 'on' ? '上班卡' : '下班卡'}  日期：${item.date}  班次：${item.time}`);
+        console.log(`  打卡时间(signTime)：${punchSignTime}`);
+        console.log(`  userid=${uid}  groupid=${groupId}`);
+        console.log(`  encryptObj=${encryptObj}`);
+        console.log(`  signSecret("${uid}${groupId}")=${signSecret(`${uid}${groupId}`)}`);
+        console.log(DIVIDER);
+        if (!yes) {
+            console.log('  ↑ dry-run 预览（未真打）。加 --yes 真正打卡。');
+            console.log(BOX_TOP);
+            return;
+        }
+        const beforeSignTime = item.signTime;
+        const r = await punch(cfg, { type, groupId: groupId, userid: uid, date, timestamp: ts });
+        if (args.flags.raw) {
+            console.error('===== RAW punchButton =====');
+            console.error(JSON.stringify(r.raw, null, 2));
+        }
+        if (r.success === '1') {
+            console.log(`  ✅ ${r.message}  ${r.signdate} ${r.signtime}`);
+        }
+        else {
+            // 部分 E9 环境会在已经写入考勤时返回 kqstatus=2（如早退/迟到提示）。
+            // 对这类非标准结果必须回读，不可直接标记失败，更不可自动重试。
+            let afterItem;
+            try {
+                const after = await getButtons(cfg);
+                ({ item: afterItem } = resolvePunchItem(after, { type, date }));
+            }
+            catch { /* 回读失败时保留原始不确定结果 */ }
+            const wrote = !!afterItem?.signTime && afterItem.signTime !== beforeSignTime;
+            if (wrote) {
+                console.log(`  ⚠️ 已打卡，但系统返回业务提示：${r.message || `kqstatus=${r.kqstatus}`}`);
+                console.log(`  回读确认：${afterItem.date} ${type === 'on' ? '上班卡' : '下班卡'} 已记录 ${afterItem.signTime}。未自动重试。`);
+            }
+            else {
+                console.log(`  ⚠️ ${r.message || '打卡结果未确认'}（success=${r.success} status=${r.status} kqstatus=${r.kqstatus}）`);
+                console.log('  未检测到新的打卡记录；为避免重复打卡，系统没有自动重试。');
+            }
+        }
+        console.log(BOX_TOP);
+        return;
+    }
+    console.error(`kq 暂只支持 status / punch，收到: ${sub}`);
+    process.exit(1);
+}
+/** CLI 侧当前时刻 HH:mm:ss（与 kq.ts 的 nowHHmmss 同逻辑，CLI 输出用）。 */
+function nowHHmmssCLI() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, '0');
+    return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+/** 从 cookie 串解析 loginuuids（与 kq.ts 同逻辑）。 */
+function parseUserIdFromCookie(cookie) {
+    if (!cookie)
+        return '';
+    const m = cookie.match(/loginuuids=([^;]+)/);
+    return m ? m[1].trim() : '';
+}
+async function runEmail(args) {
+    const sub = args._[1] ?? 'list';
+    if (sub === 'view') {
+        await runEmailView(args);
+        return;
+    }
+    if (sub === 'send') {
+        await runEmailSend(args);
+        return;
+    }
+    if (sub === 'read' || sub === 'star' || sub === 'delete' || sub === 'move' || sub === 'waitdeal' || sub === 'recall') {
+        await runEmailOperate(args, sub);
+        return;
+    }
+    if (sub === 'label') {
+        await runEmailLabel(args);
+        return;
+    }
+    if (sub === 'attachment') {
+        await runEmailAttachment(args);
+        return;
+    }
+    if (sub === 'size') {
+        await runEmailSize(args);
+        return;
+    }
+    if (sub === 'accounts') {
+        await runEmailAccounts(args);
+        return;
+    }
+    if (sub !== 'list') {
+        console.error(`email 支持 list/view/send/read/star/delete/move/label/waitdeal/recall/attachment/size/accounts，收到: ${sub}`);
+        process.exit(1);
+    }
+    const cfg = loadConfig(flagStr(args, 'config'));
+    // --date 语义化日期：解析后强制 datetype=6 + startdate/enddate，覆盖手动日期参数
+    const dateKw = flagStr(args, 'date');
+    let datetype = flagStr(args, 'datetype');
+    let startdate = flagStr(args, 'startdate');
+    let enddate = flagStr(args, 'enddate');
+    if (dateKw) {
+        const range = resolveDateRange(dateKw);
+        if (!range) {
+            console.error(`--date "${dateKw}" 无法识别。支持: today/yesterday/前天/大前天/this-week/last-week/this-month/last-month/recent-7/recent-30\n` +
+                `  + 通用 前N天/N天前（如 前天、5天前）；中文别名 今天/昨天/前天/本周/上周/本月/上月/最近7天/最近30天`);
+            process.exit(1);
+        }
+        datetype = '6';
+        startdate = range.startdate;
+        enddate = range.enddate;
+    }
+    const r = await getEmailList(cfg, {
+        folder: flagStr(args, 'folder'),
+        current: Number(flagStr(args, 'page') ?? '1') || 1,
+        subject: flagStr(args, 'subject'),
+        from: flagStr(args, 'from'),
+        to: flagStr(args, 'to'),
+        datetype,
+        startdate,
+        enddate,
+    });
+    const emailBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    if (args.flags.raw) {
+        console.error('===== RAW getEmailList =====');
+        console.error(JSON.stringify(r.raw, null, 2));
+        console.error('===== 解析结果 =====');
+    }
+    if (args.flags.json) {
+        console.log(JSON.stringify({
+            folder: r.folderKey,
+            folderName: r.folderName,
+            folderid: r.folderid,
+            page: r.current,
+            total: r.total,
+            count: r.items.length,
+            items: r.items.map((it) => withLink('email', {
+                id: it.id,
+                subject: it.subject,
+                from: it.from,
+                to: it.to,
+                fromAddress: it.fromAddress,
+                date: it.date,
+                read: it.read,
+                starred: it.starred,
+                hasAttachment: it.hasAttachment,
+            }, emailBase)),
+        }, null, 2));
+        return;
+    }
+    console.log(`E9 邮件 [${r.folderName} folderid=${r.folderid}]  第 ${r.current} 页（每页 ${r.pageSize} 条）  共 ${r.total ?? '?'} 条`);
+    if (r.items.length === 0) {
+        console.log('（无数据）');
+        if (args.flags.raw)
+            console.error('提示：若无数据但页面有，用 --raw 查看真实响应校准解析。');
+        return;
+    }
+    const visible = r.items.slice(0, r.pageSize);
+    for (let i = 0; i < visible.length; i++) {
+        const it = visible[i];
+        const flags = [
+            it.read === false ? '未读' : null,
+            it.starred ? '★' : null,
+            it.hasAttachment ? '附件' : null,
+        ].filter(Boolean).join(' ');
+        // 邮件详情 URL（E9 email SPA；格式待校准：以浏览器实际打开为准）
+        const subj = it.subject ?? '(无主题)';
+        const subjLinked = hyperlinkFor('email', it, emailBase, subj);
+        console.log(`${i + 1}. ${subjLinked}`);
+        // 收件箱显示发件人(from)，已发送显示收件人(to)——各自有值才显示，自动适配
+        const who = [it.from, it.to, it.fromAddress].filter(Boolean).join(' → ');
+        const whoShort = who.length > 40 ? who.slice(0, 38) + '…' : who;
+        const meta = [whoShort, it.date, flags].filter(Boolean).join(' | ');
+        if (meta)
+            console.log(`   ${meta}`);
+    }
+    // allList 服务端固定每页条数（本环境 14），直读服务端页天然连续；
+    // 还有多少条按可靠总数推算
+    const remaining = (r.total ?? 0) - r.current * r.pageSize;
+    if (remaining > 0)
+        console.log(`还有 ${remaining} 条，用 --page ${r.current + 1} 继续（每页 ${r.pageSize} 条）。`);
+}
+async function runEmailSend(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const subject = flagStr(args, 'subject');
+    // 正文来源：--content 或 --content-file（文件避免命令行中文/转义问题，同 create start）
+    let content = flagStr(args, 'content');
+    const contentFile = flagStr(args, 'content-file');
+    if (!content && contentFile) {
+        try {
+            const fs = await import('node:fs');
+            content = fs.readFileSync(contentFile, 'utf8');
+        }
+        catch (e) {
+            console.error(`读取 --content-file 失败：${e.message}`);
+            process.exit(1);
+        }
+    }
+    if (!subject) {
+        console.error('email send 需要 --subject "<主题>"');
+        process.exit(1);
+    }
+    if (!content) {
+        console.error('email send 需要 --content "<正文>" 或 --content-file <路径>');
+        process.exit(1);
+    }
+    const to = flagStr(args, 'to');
+    const internalTo = flagStr(args, 'internal-to');
+    if (!to && !internalTo) {
+        console.error('email send 需要至少一个收件人：--to <外部邮箱> 或 --internal-to <内部人员id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    const attachmentFiles = (flagStr(args, 'attachment') ?? '').split(/[,，]/).map((s) => s.trim()).filter(Boolean);
+    const r = await sendEmail(cfg, {
+        to,
+        cc: flagStr(args, 'cc'),
+        bcc: flagStr(args, 'bcc'),
+        internalTo,
+        internalCc: flagStr(args, 'internal-cc'),
+        internalBcc: flagStr(args, 'internal-bcc'),
+        subject,
+        content,
+        contentIsHtml: flagBool(args, 'html'),
+        priority: flagStr(args, 'priority'),
+        needReceipt: flagBool(args, 'need-receipt'),
+        timingDate: flagStr(args, 'timing'),
+        classification: flagStr(args, 'classification'),
+        hrmAccountid: flagStr(args, 'hrm-accountid'),
+        mailid: flagStr(args, 'mailid'),
+        attachmentFiles,
+        send,
+    });
+    if (args.flags.raw) {
+        console.error('===== RAW getEmailAllConfig =====');
+        console.error(JSON.stringify(r.accountConfig.raw, null, 2));
+        if (r.response) {
+            console.error('===== RAW send 响应 =====');
+            console.error(JSON.stringify(r.response.json ?? r.response.text, null, 2));
+        }
+        console.error('===== 解析结果 =====');
+    }
+    if (!r.sent) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 未发送 · ${r.endpoint.baseUrl}/api/email/base/send`);
+        console.log(`  classification=${r.accountConfig.classification}  hrmAccountid=${r.accountConfig.hrmAccountid || '(空,回退1)'}`);
+        console.log(DIVIDER);
+        console.log('收件人:');
+        if (to)
+            console.log(`  外部 To: ${to}`);
+        if (flagStr(args, 'cc'))
+            console.log(`  外部 Cc: ${flagStr(args, 'cc')}`);
+        if (flagStr(args, 'bcc'))
+            console.log(`  外部 Bcc: ${flagStr(args, 'bcc')}`);
+        if (internalTo)
+            console.log(`  内部 To: ${internalTo}`);
+        if (flagStr(args, 'internal-cc'))
+            console.log(`  内部 Cc: ${flagStr(args, 'internal-cc')}`);
+        if (flagStr(args, 'internal-bcc'))
+            console.log(`  内部 Bcc: ${flagStr(args, 'internal-bcc')}`);
+        console.log(`  主题: ${subject}`);
+        if (attachmentFiles.length) {
+            console.log(`  附件(${attachmentFiles.length}):`);
+            for (const f of attachmentFiles)
+                console.log(`    ▸ ${f}`);
+        }
+        console.log(DIVIDER);
+        console.log('请求体:');
+        console.log(JSON.stringify(r.body, null, 2));
+        console.log('\n  确认无误后加 --yes 真正发送。');
+        console.log(BOX_TOP);
+        return;
+    }
+    const j = r.response?.json;
+    const ok = j?.status === '1' || j?.status === true || j?.success === true || r.response?.ok;
+    console.log(BOX_TOP);
+    console.log(`  发送结果 · ${subject}`);
+    console.log(`  ${ok ? '✅ 已发送' : '⚠ 提交完成但状态异常'}  status=${r.response?.status}`);
+    console.log(BOX_TOP);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 500));
+    else
+        console.log('响应(非JSON):', (r.response?.text ?? '').slice(0, 300));
+}
+async function runEmailView(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const id = flagStr(args, 'id');
+    if (!id) {
+        console.error('email view 需要 --id <邮件id>（从 email list 取 id）');
+        process.exit(1);
+    }
+    const r = await getEmailView(cfg, id);
+    if (args.flags.raw) {
+        console.error('===== RAW mailView =====');
+        console.error(JSON.stringify(r.rawMailView, null, 2));
+        console.error('===== RAW mailContentView =====');
+        console.error(JSON.stringify(r.rawContent, null, 2));
+        console.error('===== 解析结果 =====');
+    }
+    // 可选：标记已读（写操作，默认不执行，需 --mark-read）
+    if (flagBool(args, 'mark-read')) {
+        const ok = await setMailReadStatus(cfg, id, true);
+        console.error(`标记已读: ${ok ? '✅' : '⚠ 状态异常'}`);
+    }
+    const m = r.meta;
+    if (args.flags.json) {
+        console.log(JSON.stringify({
+            id: m.id,
+            subject: m.subject,
+            from: m.from,
+            fromAddress: m.fromAddress,
+            to: m.to,
+            cc: m.cc,
+            senddate: m.senddate,
+            receivedate: m.receivedate,
+            size: m.size,
+            hasAttachment: m.hasAttachment,
+            attachments: m.attachments,
+            importance: m.importance,
+            content: r.contentText,
+            contentHtml: r.contentHtml,
+        }, null, 2));
+        return;
+    }
+    console.log(BOX_TOP);
+    console.log(`  E9 邮件详情 · ${m.subject ?? '(无主题)'}`);
+    console.log(`  id=${m.id ?? id}`);
+    console.log(DIVIDER);
+    const rows = [
+        ['发件人', m.from ? `${m.from}${m.fromAddress ? ` <${m.fromAddress}>` : ''}` : undefined],
+        ['收件人', m.to],
+        ['抄送', m.cc],
+        ['主题', m.subject],
+        ['发送时间', m.senddate],
+        ['接收时间', m.receivedate],
+        ['大小', m.size],
+        ['重要性', m.importance],
+    ];
+    for (const [k, v] of rows)
+        if (v)
+            console.log(`  ${k}: ${v}`);
+    if (m.attachments && m.attachments.length > 0) {
+        console.log(DIVIDER);
+        console.log(`  附件（${m.attachments.length}）:`);
+        for (const a of m.attachments)
+            console.log(`    ▸ ${a.name ?? '(无名)'}${a.size ? `  ${a.size}` : ''}${a.fileid ? `  [fileid=${a.fileid}]` : ''}`);
+    }
+    if (r.contentText) {
+        console.log(DIVIDER);
+        console.log('  正文:');
+        // 正文可能很长，人类可读截断到约 800 字符
+        const text = r.contentText.length > 800 ? r.contentText.slice(0, 800) + '…（截断，--json 看全文）' : r.contentText;
+        console.log(`  ${text}`);
+    }
+    console.log(BOX_TOP);
+}
+/** email 操作子命令统一处理：read/star/delete/move/waitdeal/recall。写操作默认 dry-run，--yes 执行。 */
+async function runEmailOperate(args, sub) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const ids = flagStr(args, 'id');
+    if (!ids) {
+        console.error(`email ${sub} 需要 --id <邮件id>（逗号分隔多个，从 email list 取）`);
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    let r;
+    switch (sub) {
+        case 'read': {
+            const unread = flagBool(args, 'unread');
+            const ok = await setMailReadStatus(cfg, ids, !unread);
+            console.log(BOX_TOP);
+            console.log(`  标记${unread ? '未读' : '已读'} ${ids}  ${ok ? '✅ 成功' : '⚠ 状态异常'}`);
+            console.log(BOX_TOP);
+            return;
+        }
+        case 'star': {
+            const unstar = flagBool(args, 'unstar');
+            r = await setEmailStar(cfg, ids, !unstar);
+            console.log(BOX_TOP);
+            console.log(`  ${unstar ? '取消标星' : '标星'} ${ids}  ${r.ok ? '✅ 成功' : '⚠ 状态异常'}`);
+            if (args.flags.raw)
+                console.log(JSON.stringify(r.raw, null, 2));
+            console.log(BOX_TOP);
+            return;
+        }
+        case 'delete': {
+            const permanent = flagBool(args, 'permanent');
+            const label = permanent ? '彻底删除' : '删除(移回收站)';
+            if (!send) {
+                console.log(BOX_TOP);
+                console.log(`  [dry-run] 未执行 · ${label} ${ids}`);
+                console.log(`  ${permanent ? '此操作不可恢复' : '回收站可恢复'}，确认后加 --yes 执行。`);
+                console.log(BOX_TOP);
+                return;
+            }
+            r = await deleteEmails(cfg, ids, { permanent });
+            console.log(BOX_TOP);
+            console.log(`  ${label} ${ids}  ${r.ok ? '✅ 成功' : '⚠ 状态异常'}`);
+            if (args.flags.raw)
+                console.log(JSON.stringify(r.raw, null, 2));
+            console.log(BOX_TOP);
+            return;
+        }
+        case 'move': {
+            const folder = flagStr(args, 'folder');
+            if (!folder) {
+                console.error('email move 需要 --folder <folderid>（0收件箱/-1已发送/-2草稿/-3已删除 或自定义）');
+                process.exit(1);
+            }
+            if (!send) {
+                console.log(BOX_TOP);
+                console.log(`  [dry-run] 未执行 · 移动 ${ids} → 文件夹 ${folder}`);
+                console.log('  确认后加 --yes 执行。');
+                console.log(BOX_TOP);
+                return;
+            }
+            r = await moveEmails(cfg, ids, folder);
+            console.log(BOX_TOP);
+            console.log(`  移动 ${ids} → ${folder}  ${r.ok ? '✅ 成功' : '⚠ 状态异常'}`);
+            if (args.flags.raw)
+                console.log(JSON.stringify(r.raw, null, 2));
+            console.log(BOX_TOP);
+            return;
+        }
+        case 'waitdeal': {
+            const time = flagStr(args, 'time');
+            if (!time) {
+                console.error('email waitdeal 需要 --time <YYYY-MM-DD>（处理日期）');
+                process.exit(1);
+            }
+            const way = flagStr(args, 'way') ?? '5';
+            const note = flagStr(args, 'note');
+            const remindTime = flagStr(args, 'remind-time');
+            const hasRemind = flagBool(args, 'has-remind');
+            const hasNote = flagBool(args, 'has-note');
+            if (!send) {
+                console.log(BOX_TOP);
+                console.log(`  [dry-run] 未执行 · 设待办邮件 ${ids}`);
+                console.log(`  处理日期=${time}  提醒方式=${way === '1' ? '短信提醒' : '消息中心提醒'}${remindTime ? `  提醒时间=${remindTime}` : ''}${note ? `  备注=${note}` : ''}`);
+                console.log('  确认后加 --yes 执行。');
+                console.log(BOX_TOP);
+                return;
+            }
+            r = await setEmailWaitdeal(cfg, ids, { time, way, remindTime, note, hasNote, hasRemind });
+            console.log(BOX_TOP);
+            console.log(`  设待办邮件 ${ids}  ${r.ok ? '✅ 成功' : '⚠ 状态异常'}`);
+            if (args.flags.raw)
+                console.log(JSON.stringify(r.raw, null, 2));
+            console.log(BOX_TOP);
+            return;
+        }
+        case 'recall': {
+            const single = ids.split(/[,，]/)[0].trim();
+            if (!send) {
+                console.log(BOX_TOP);
+                console.log(`  [dry-run] 未执行 · 撤回邮件 ${single}`);
+                console.log('  ⚠ 撤回仅对未读/未删除的已发送内部邮件有效，且不可恢复。确认后加 --yes 执行。');
+                console.log(BOX_TOP);
+                return;
+            }
+            r = await recallEmail(cfg, single);
+            console.log(BOX_TOP);
+            console.log(`  撤回邮件 ${single}  ${r.ok ? '✅ 成功' : '⚠ 状态异常（可能已读/已删/外部邮件）'}`);
+            if (args.flags.raw)
+                console.log(JSON.stringify(r.raw, null, 2));
+            console.log(BOX_TOP);
+            return;
+        }
+    }
+}
+/** email label list/add/apply。 */
+async function runEmailLabel(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const op = args._[2] ?? 'list';
+    if (op === 'list') {
+        const r = await getEmailLabels(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify({ count: r.items.length, items: r.items.map((it) => ({ id: it.id, name: it.name, color: it.color, unreadCount: it.unreadCount, totalCount: it.totalCount })) }, null, 2));
+            return;
+        }
+        console.log(`E9 邮件标签（共 ${r.items.length} 个）`);
+        if (r.items.length === 0) {
+            console.log('（暂无标签）');
+            return;
+        }
+        r.items.forEach((it, i) => console.log(`${i + 1}. ${it.name ?? '(无名)'}${it.color ? `  ${it.color}` : ''}${it.unreadCount ? `  未读 ${it.unreadCount}` : ''}${it.totalCount ? `  共 ${it.totalCount}` : ''}  [id=${it.id}]`));
+        return;
+    }
+    if (op === 'add') {
+        const name = flagStr(args, 'name');
+        if (!name) {
+            console.error('email label add 需要 --name <标签名>');
+            process.exit(1);
+        }
+        const color = flagStr(args, 'color') ?? '#000000';
+        const send = !!args.flags.yes;
+        if (!send) {
+            console.log(BOX_TOP);
+            console.log(`  [dry-run] 未执行 · 新建标签 "${name}" (${color})`);
+            console.log('  确认后加 --yes 执行。');
+            console.log(BOX_TOP);
+            return;
+        }
+        const r = await addEmailLabel(cfg, { name, color });
+        console.log(BOX_TOP);
+        console.log(`  新建标签 "${name}"  ${r.ok ? `✅ 成功 [id=${r.id}]` : '⚠ 状态异常'}`);
+        console.log(BOX_TOP);
+        return;
+    }
+    if (op === 'apply') {
+        const ids = flagStr(args, 'id');
+        const label = flagStr(args, 'label');
+        if (!ids || !label) {
+            console.error('email label apply 需要 --id <邮件ids> 和 --label <标签id>');
+            process.exit(1);
+        }
+        const remove = flagBool(args, 'remove');
+        const send = !!args.flags.yes;
+        if (!send) {
+            console.log(BOX_TOP);
+            console.log(`  [dry-run] 未执行 · ${remove ? '去掉' : '贴'}标签[${label}] ${ids}`);
+            console.log('  确认后加 --yes 执行。');
+            console.log(BOX_TOP);
+            return;
+        }
+        const r = await applyEmailLabel(cfg, ids, label, { remove });
+        console.log(BOX_TOP);
+        console.log(`  ${remove ? '去' : '贴'}标签[${label}] ${ids}  ${r.ok ? '✅ 成功' : '⚠ 状态异常'}`);
+        if (args.flags.raw)
+            console.log(JSON.stringify(r.raw, null, 2));
+        console.log(BOX_TOP);
+        return;
+    }
+    console.error(`email label 支持 list/add/apply，收到: ${op}`);
+    process.exit(1);
+}
+/** email attachment upload/list。 */
+async function runEmailAttachment(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const op = args._[2] ?? 'list';
+    if (op === 'upload') {
+        const file = flagStr(args, 'file');
+        if (!file) {
+            console.error('email attachment upload 需要 --file <本地路径>');
+            process.exit(1);
+        }
+        const name = flagStr(args, 'name');
+        const r = await uploadEmailAttachment(cfg, file, name ? { name } : {});
+        if (args.flags.raw)
+            console.log(JSON.stringify(r.raw, null, 2));
+        console.log(BOX_TOP);
+        console.log(`  上传附件 ${r.data?.filename ?? file}`);
+        console.log(`  ${r.ok ? `✅ fileid=${r.data?.id}  ${r.data?.filesize ?? ''}` : '⚠ 上传失败'}`);
+        if (r.data?.filelink)
+            console.log(`  filelink: ${r.data.filelink}`);
+        console.log(BOX_TOP);
+        return;
+    }
+    if (op === 'list') {
+        const r = await getEmailAttachmentList(cfg, { filename: flagStr(args, 'filename'), subject: flagStr(args, 'subject') });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ count: r.items.length, items: r.items }, null, 2));
+            return;
+        }
+        console.log(`E9 邮件附件（共 ${r.items.length} 个）`);
+        if (r.items.length === 0) {
+            console.log('（暂无附件）');
+            return;
+        }
+        r.items.forEach((it, i) => console.log(`${i + 1}. ${it.filename ?? '(无名)'}${it.size ? `  ${it.size}` : ''}${it.subject ? `  | ${it.subject}` : ''}${it.mailid ? `  [mailid=${it.mailid}]` : ''}`));
+        return;
+    }
+    console.error(`email attachment 支持 upload/list，收到: ${op}`);
+    process.exit(1);
+}
+/** email size 邮箱容量。 */
+async function runEmailSize(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const r = await getEmailSize(cfg);
+    if (args.flags.json) {
+        console.log(JSON.stringify(r, null, 2));
+        return;
+    }
+    console.log(BOX_TOP);
+    console.log('  E9 邮箱容量');
+    console.log(`  未读 ${r.unreadsize ?? 0} 封 · 总数 ${r.totalSize ?? 0} 封`);
+    console.log(`  已用 ${r.occupyspace ?? 0} / 总 ${r.totalspace ?? 0}`);
+    console.log(`  剩余 ${r.remainspace ?? 0}`);
+    console.log(BOX_TOP);
+}
+/** email accounts 接收账户。 */
+async function runEmailAccounts(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const r = await getEmailReciveAccounts(cfg);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ count: r.items.length, items: r.items }, null, 2));
+        return;
+    }
+    console.log(`E9 接收账户（共 ${r.items.length} 个）`);
+    if (r.items.length === 0) {
+        console.log('（无独立接收账户，使用主账户）');
+        return;
+    }
+    r.items.forEach((it, i) => console.log(`${i + 1}. ${JSON.stringify(it)}`));
+}
+/**
+
+/**
+ * 渲染台账的菜单挂载点（菜单名索引）：取与关键字匹配的菜单路径，无则首个；截断 32 字符。
+ * 用户按门户菜单名找台账时，菜单名可能与台账名不符，这列把两者关联起来。
+ */
+function fmtMenus(e, kw) {
+    const menus = Array.isArray(e.menus) ? e.menus : [];
+    if (!menus.length)
+        return '';
+    let pick = menus[0];
+    if (kw) {
+        const q = String(kw).toLowerCase();
+        pick = menus.find((mu) => (mu.name || '').toLowerCase().includes(q) || (mu.path || '').toLowerCase().includes(q)) || menus[0];
+    }
+    const s = pick.path || pick.name || '';
+    if (!s)
+        return '';
+    const t = s.length > 32 ? s.slice(0, 32) + '…' : s;
+    return `  菜单=${t}`;
+}
+/**
+ * #7 统一名称搜索：用户只说名字、不知归属（台账/菜单/流程）时，一次搜三类，避免猜错域来回。
+ *   台账：cube find（台账目录 list_name + 菜单挂载名）
+ *   菜单：fetchMenuMounts 的 menuNodes（含非 cube 的 CRM/SPA 前台菜单，按节点名搜）
+ *   流程：getCreateWfList（流程名/拼音）
+ */
+async function runSearch(args) {
+    const kw = flagStr(args, 'name') ?? args._.slice(1).join(' ');
+    if (!kw) {
+        console.error('用法: e9 search <名称关键字>  （或 --name <关键字>）—— 同时搜台账/菜单/流程');
+        process.exit(1);
+    }
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const kwl = kw.toLowerCase();
+    const searchBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    console.log(`搜索「${kw}」：台账 / 菜单 / 流程 三类\n`);
+    let ledgerN = 0, menuN = 0, wfN = 0;
+    // ① 台账
+    try {
+        const r = await listCubeMenus(cfg, {});
+        const cands = findCubeByName(r.entries, kw);
+        ledgerN = cands.length;
+        console.log(`■ 台账（${ledgerN} 个，来源:${r.source}）`);
+        if (cands.length === 0)
+            console.log('  （无）');
+        for (const c of cands.slice(0, 10)) {
+            const label = hyperlinkFor('cube-search', { ...c, customid: c.id }, searchBase, c.list_name, { menuUrl: c.menus?.[0]?.url });
+            console.log(`  customid=${String(c.id).padEnd(7)} ${label}  [mode=${c.mode_id || '-'} app=${c.app_name || '-'}]  (${c.matchNote})${fmtMenus(c, kw)}`);
+        }
+        if (cands.length > 10)
+            console.log(`  ... 还有 ${cands.length - 10} 个（e9 cube find --name ${kw} 看全部）`);
+    }
+    catch (e) {
+        console.log(`■ 台账：查询失败 ${e.message}`);
+    }
+    // ② 菜单（含非 cube 的 CRM/SPA 前台菜单，解决"客户监控"这类不在台账目录的菜单）
+    try {
+        const mm = await fetchMenuMounts(cfg);
+        const nodes = (mm.menuNodes || []).filter((n) => (n.name || '').toLowerCase().includes(kwl) || (n.path || '').toLowerCase().includes(kwl));
+        menuN = nodes.length;
+        console.log(`\n■ 菜单（${menuN} 个，含 CRM/SPA 前台菜单）`);
+        if (nodes.length === 0)
+            console.log('  （无）');
+        for (const n of nodes.slice(0, 10))
+            console.log(`  ${hyperlinkFor('cube-search', { ...n, id: n.customid }, searchBase, n.name, { menuUrl: n.url })}  路径=${n.path}${n.customid ? ' (→台账 ' + n.customid + ')' : ''}`);
+        if (nodes.length > 10)
+            console.log(`  ... 还有 ${nodes.length - 10} 个`);
+    }
+    catch (e) {
+        console.log(`\n■ 菜单：查询失败 ${e.message}`);
+    }
+    // ③ 流程
+    try {
+        const r = await getCreateWfList(cfg, { tab: '1', keyword: kw });
+        const flows = [];
+        for (const cat of (r.categories || []))
+            for (const w of (cat.workflows || []))
+                flows.push({ id: w.id, name: w.name, cat: cat.name });
+        wfN = flows.length;
+        console.log(`\n■ 流程（${wfN} 个）`);
+        if (flows.length === 0)
+            console.log('  （无）');
+        for (const w of flows.slice(0, 10))
+            console.log(`  [${w.id}] ${hyperlinkFor('create', w, searchBase, w.name)}  (${w.cat})`);
+        if (flows.length > 10)
+            console.log(`  ... 还有 ${flows.length - 10} 个`);
+    }
+    catch (e) {
+        console.log(`\n■ 流程：查询失败 ${e.message}`);
+    }
+    console.log(`\n合计：台账 ${ledgerN} / 菜单 ${menuN} / 流程 ${wfN}`);
+}
+/**
+ * 建模台账（cube）：list/fields/export。接线自 cli-cube-接线.js。
+ */
+/** 条件 label 未匹配时列候选，提示修正并终止（不静默放空结果）。 */
+function printConditionUnresolved(unresolved) {
+    for (const u of unresolved) {
+        const cands = (u.candidates ?? []).join('、');
+        console.error(`⚠ 条件「${u.label}」未匹配到台账查询字段${cands ? `。相近字段候选: ${cands}` : ''}（可用 e9 cube fields 查看全部查询字段名）。`);
+    }
+    process.exit(1);
+}
+
+async function runCube(args) {
+    const sub = args._[1] ?? 'list';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    // ---------- menus：列全部台账（目录发现 + 缓存） ----------
+    if (sub === 'menus') {
+        const r = await listCubeMenus(cfg, { refresh: flagBool(args, 'refresh'), noCache: flagBool(args, 'no-cache') });
+        const cubeBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        const linkedEntries = r.entries.map((entry) => withLink('cube-search', { ...entry, customid: entry.id }, cubeBase, { menuUrl: entry.menus?.[0]?.url ?? entry.url }));
+        if (args.flags.json) {
+            console.log(JSON.stringify({ source: r.source, count: r.count, fetchedAt: r.fetchedAt, fromCache: r.fromCache, total: r.total, entries: linkedEntries }, null, 2));
+            return;
+        }
+        console.log(`E9 台账目录 · ${r.count} 个（来源:${r.source}${r.fromCache ? ' ·缓存' : ''}${r.fetchedAt ? ' ·' + r.fetchedAt.slice(0, 10) : ''}）`);
+        if (r.count === 0) {
+            console.log(r.error ? `（${r.error}）` : '（无台账）');
+            return;
+        }
+        for (const e of linkedEntries)
+            console.log(`  customid=${String(e.id).padEnd(7)} ${e.url ? `[${escapeLinkText(e.list_name)}](${e.url})` : e.list_name}  [mode=${e.mode_id || '-'} app=${e.app_name || '-'}]${!e.mode_id ? ' ·查询视图' : ''}${fmtMenus(e)}`);
+        return;
+    }
+    // ---------- find：按名模糊匹配台账 ----------
+    if (sub === 'find') {
+        const kw = flagStr(args, 'name') ?? args._.slice(2).join(' ');
+        if (!kw) {
+            console.error('用法: e9 cube find <名称关键字>  （或 --name <关键字>）');
+            process.exit(1);
+        }
+        const r = await listCubeMenus(cfg, {});
+        const cands = findCubeByName(r.entries, kw);
+        const cubeBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        const linkedCands = cands.map((entry) => withLink('cube-search', { ...entry, customid: entry.id }, cubeBase, { menuUrl: entry.menus?.[0]?.url ?? entry.url }));
+        const detail = flagBool(args, 'tree-detail');
+        if (args.flags.json) {
+            console.log(JSON.stringify({ keyword: kw, source: r.source, matches: linkedCands }, null, 2));
+            return;
+        }
+        if (cands.length === 0) {
+            console.log(`未匹配到含「${kw}」的台账（来源:${r.source}，共${r.count}个）。可用 e9 cube menus 查看全部。`);
+            return;
+        }
+        console.log(`匹配「${kw}」的台账（${cands.length} 个，按相关度排序 ·来源:${r.source}）：`);
+        for (const c of linkedCands) {
+            // ★ #8 多节点（树形菜单叶子）标注总数，避免"只看到1条"的误解
+            const ncnt = Array.isArray(c.menus) && c.menus.length > 1 ? ` (共${c.menus.length}节点)` : '';
+            console.log(`  customid=${String(c.id).padEnd(7)} ${c.url ? `[${escapeLinkText(c.list_name)}](${c.url})` : c.list_name}  [mode=${c.mode_id || '-'} app=${c.app_name || '-'}]  (${c.matchNote})${!c.mode_id ? ' ·查询视图' : ''}${fmtMenus(c, kw)}${ncnt}`);
+            // ★ #8 --tree-detail：展开该台账对应的全部菜单/树节点路径
+            if (detail && Array.isArray(c.menus) && c.menus.length > 1) {
+                for (const mu of c.menus)
+                    console.log(`      - ${mu.path || mu.name}`);
+            }
+        }
+        return;
+    }
+    const customid = flagStr(args, 'customid') ?? flagStr(args, 'id');
+    if (!customid) {
+        console.error('用法: e9 cube <list|fields|export|search-info|excel|count|group|card|browser|card-fields|create|edit|delete|print|import-template|import> --customid <id>\n      e9 cube menus [--refresh]    列全部台账\n      e9 cube find <名称>           按名找台账');
+        process.exit(1);
+    }
+    const menuIds = flagStr(args, 'menu-ids') ?? '';
+    if (sub === 'import-template') {
+        const r = await downloadCubeImportTemplate(cfg, { customid, modeId: flagStr(args, 'mode-id'), outDir: flagStr(args, 'out-dir'), filename: flagStr(args, 'filename') });
+        if (args.flags.json) console.log(JSON.stringify(r, null, 2));
+        else {
+            console.log(`台账批量导入模板已下载到：${r.outPath}`);
+            console.log(r.requiredFieldsKnown ? `必填字段：${r.requiredFields.join('、')}` : '必填字段未能从卡片接口读取，请保留模板中的必填提示，不能猜。');
+            console.log('可选择：自己填写；把文件交给助手填写；或直接描述每行数据。填写时只允许改数据单元格。');
+        }
+        return;
+    }
+    if (sub === 'import') {
+        const file = flagStr(args, 'file');
+        if (!file) throw new Error('cube import 需要 --file <已填写模板路径>。');
+        const r = await importCubeExcel(cfg, { customid, modeId: flagStr(args, 'mode-id'), file, yes: !!args.flags.yes, ignoreErrors: flagStr(args, 'ignore-errors') ?? '0' });
+        if (args.flags.json) console.log(JSON.stringify(r, null, 2));
+        else if (!r.imported && r.requiresConfirmation) console.log(`将向台账 customid=${customid} 导入文件：${r.filePath}\n确认文件内容无误后加 --yes。`);
+        else console.log(`${r.imported ? '✅ 台账导入完成' : '⚠ 台账导入失败'}${r.message ? `：${r.message}` : ''}${r.successCount != null ? `（成功 ${r.successCount} 条）` : ''}`);
+        if (args.flags.yes && !r.imported) process.exitCode = 1;
+        return;
+    }
+    // ---------- card-fields：卡片字段定义 ----------
+    if (sub === 'card-fields') {
+        const init = await getCubeInit(cfg, { customid });
+        const modeId = flagStr(args, 'mode-id') ?? init.modeId;
+        const formId = flagStr(args, 'form-id') ?? init.formId;
+        const r = await getCardFields(cfg, { modeId, formId, billid: flagStr(args, 'billid') });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ customid, modeId, formId, layoutid: r.layoutid, fields: r.fields }, null, 2));
+            return;
+        }
+        console.log(`E9 卡片字段 · ${init.name ?? customid} (modeId=${modeId} formId=${formId} layoutid=${r.layoutid})`);
+        for (const f of r.fields)
+            console.log(`  field${f.id} ${f.label ?? ''} [${f.name ?? ''}] ht=${f.htmltype ?? '?'} ${f.isedit ? '可编辑' : '只读'}${f.ismandatory ? ' 必填' : ''}`);
+        return;
+    }
+    // ---------- view：单条记录完整详情（P1-2） ----------
+    if (sub === 'view') {
+        const billid = flagStr(args, 'billid');
+        if (!billid) {
+            console.error('cube view 需要 --billid <记录id>');
+            process.exit(1);
+        }
+        const init = await getCubeInit(cfg, { customid });
+        const modeId = flagStr(args, 'mode-id') ?? init.modeId;
+        const formId = flagStr(args, 'form-id') ?? init.formId;
+        // 查看态字段定义 + best-effort 当前值
+        const cf = await getCardFields(cfg, { modeId, formId, billid });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ customid, billid, modeId, formId, layoutid: cf.layoutid, fields: cf.fields }, null, 2));
+            return;
+        }
+        console.log(`E9 台账记录详情 · ${init.name ?? customid}  billid=${billid} (modeId=${modeId} formId=${formId})`);
+        const hasVal = cf.fields.some((f) => f.value !== undefined && f.value !== null && f.value !== '');
+        if (hasVal) {
+            for (const f of cf.fields)
+                console.log(`  ${f.label ?? `field${f.id}`} [${f.htmltype ?? '?'}] = ${f.value || '（空）'}${f.ismandatory ? ' 必填' : ''}${f.isedit ? '' : ' 只读'}`);
+        }
+        else {
+            // 查看态 mainFields 不带值时：回退 list 反查该条记录的行值
+            let row = null;
+            try {
+                const fb = await fetchCubeRowsByIds(cfg, { customid, billids: [billid], modeId });
+                row = fb.rows[0];
+            }
+            catch { /* 反查失败不阻断 */ }
+            if (row && row.fields.length) {
+                console.log('（查看态无值，回退列表行值）');
+                for (const f of row.fields)
+                    if (f.value)
+                        console.log(`  ${f.title ?? f.dataIndex} = ${f.value}`);
+            }
+            else {
+                console.log('（未能读取该记录的值，请人工核对 billid）');
+            }
+        }
+        const cubeBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        const link = hyperlinkFor('cube', { id: billid }, cubeBase, '打开卡片', { modeId, formId, customid });
+        console.log(`\n${link}`);
+        return;
+    }
+    // ---------- create：新建台账记录 ----------
+    if (sub === 'create') {
+        const init = await getCubeInit(cfg, { customid });
+        const modeId = flagStr(args, 'mode-id') ?? init.modeId;
+        const formId = flagStr(args, 'form-id') ?? init.formId;
+        const vf = flagStr(args, 'values-file');
+        const valuesRaw = flagStr(args, 'values') ?? (vf ? (await import('node:fs')).readFileSync(vf, 'utf8') : '');
+        if (!valuesRaw) {
+            console.error('cube create 需要 --values <json> 或 --values-file');
+            process.exit(1);
+        }
+        const values = JSON.parse(valuesRaw);
+        // 附件：--file fieldId=path[,fieldId=path]
+        const fileStr = flagStr(args, 'file') ?? '';
+        const files = fileStr ? fileStr.split(',').map((s) => { const i = s.indexOf('='); return { fieldId: s.slice(0, i), filePath: s.slice(i + 1) }; }).filter((f) => f.fieldId && f.filePath) : [];
+        if (!args.flags.yes) {
+            // P1-1：dry-run 跑真实联动解析，确认表与最终提交字段集一致
+            const pv = await previewCubeCard(cfg, { modeId, formId, values, files });
+            const cf = { layoutid: pv.layoutid, fields: pv.fields };
+            console.log(`[dry-run] 新建台账记录 · ${init.name ?? customid}`);
+            console.log(`modeId=${modeId} formId=${formId} layoutid=${cf.layoutid}  字段 ${cf.fields.length} 个\n`);
+            // 字段确认表：字段 | 控件类型 | 必填 | 值/【待填】
+            for (const f of cf.fields) {
+                const val = pv.finalValues[f.id] ?? pv.finalValues[`field${f.id}`] ?? '';
+                const valDisplay = val ? val : (f.ismandatory ? '【待填·必填】' : '（空）');
+                console.log(`  field${f.id} ${f.label ?? ''} [${f.htmltype ?? '?'}]${f.ismandatory ? ' 必填' : ''} = ${valDisplay}`);
+            }
+            if (pv.linked.length) {
+                console.log('\n🔗 联动自动带出：');
+                for (const lk of pv.linked)
+                    console.log(`  ${lk.label} (field${lk.fieldId}) = ${lk.value}   ← 由已填触发字段带出`);
+            }
+            if (pv.files.length)
+                console.log('\n附件:', pv.files.map((f) => `field${f.fieldId}←${f.filePath}`).join(', '), '(--yes 时上传)');
+            console.log('\n加 --yes 真提交（cookie 鉴权 + 完整链路 + 附件上传 + 全字段 JSONStr）。');
+            return;
+        }
+        const res = await submitCubeCard(cfg, { modeId, formId, values, files });
+        console.log(`${res.ok ? '✅ 新建成功' : '⚠ 提交异常'}  billid=${res.billid ?? '?'}  status=${res.raw?.status}`);
+        if (!res.ok)
+            console.log('响应:', JSON.stringify(res.raw).slice(0, 400));
+        return;
+    }
+    // ---------- edit：编辑台账记录 ----------
+    if (sub === 'edit') {
+        const billid = flagStr(args, 'billid');
+        if (!billid) {
+            console.error('cube edit 需要 --billid <id> --values <json>');
+            process.exit(1);
+        }
+        const init = await getCubeInit(cfg, { customid });
+        const modeId = flagStr(args, 'mode-id') ?? init.modeId;
+        const formId = flagStr(args, 'form-id') ?? init.formId;
+        const vf = flagStr(args, 'values-file');
+        const valuesRaw = flagStr(args, 'values') ?? (vf ? (await import('node:fs')).readFileSync(vf, 'utf8') : '');
+        if (!valuesRaw) {
+            console.error('cube edit 需要 --values <json>');
+            process.exit(1);
+        }
+        const values = JSON.parse(valuesRaw);
+        const fileStr = flagStr(args, 'file') ?? '';
+        const files = fileStr ? fileStr.split(',').map((s) => { const i = s.indexOf('='); return { fieldId: s.slice(0, i), filePath: s.slice(i + 1) }; }).filter((f) => f.fieldId && f.filePath) : [];
+        if (!args.flags.yes) {
+            // P0-2：dry-run 显示改前→改后对比（取查看态当前值，能力已具备，复用 card-fields 的 billid 查看态）
+            let curFields = null;
+            let rowFallback = null;
+            try {
+                curFields = await getCardFields(cfg, { modeId, formId, billid });
+            }
+            catch {
+                curFields = null;
+            }
+            // 查看态不带值时：list 反查该条记录的行值作对比兜底
+            if (!(curFields && curFields.fields.some((f) => f.value !== undefined && f.value !== null && f.value !== ''))) {
+                try {
+                    const fb = await fetchCubeRowsByIds(cfg, { customid, billids: [billid], modeId });
+                    rowFallback = fb.rows[0];
+                }
+                catch { /* 反查失败不阻断 */ }
+            }
+            console.log(`[dry-run] 编辑台账记录 · billid=${billid}${rowFallback ? `  当前记录: ${rowFallback.name || '(无标题)'}` : ''}`);
+            if (curFields && curFields.fields.some((f) => f.value !== undefined && f.value !== null && f.value !== '')) {
+                console.log('字段变更对比（仅列有变动的字段；未列出的保持原值）：');
+                let diffCount = 0;
+                for (const f of curFields.fields) {
+                    const newVal = values[f.id] ?? values[`field${f.id}`];
+                    if (newVal === undefined)
+                        continue;
+                    const oldVal = f.value ?? '';
+                    const changed = String(oldVal) !== String(newVal);
+                    if (changed) {
+                        diffCount++;
+                        console.log(`  ${f.label ?? `field${f.id}`} (field${f.id}): ${oldVal || '（空）'} → ${newVal}`);
+                    }
+                }
+                if (diffCount === 0)
+                    console.log('  （传入值与当前值无差异，或字段均未匹配）');
+                const unknownKeys = Object.keys(values).filter((k) => !curFields.fields.some((f) => String(f.id) === k.replace(/^field/, '')));
+                if (unknownKeys.length)
+                    console.log(`  ⚠ 以下 key 未匹配到卡片字段: ${unknownKeys.join(', ')}`);
+                if (files.length)
+                    console.log('附件:', files.map((f) => `field${f.fieldId}←${f.filePath}`).join(', '), '(--yes 时上传)');
+            }
+            else {
+                // 取不到原值（查看态不带值 / 无权限）：降级展示传入值 + list 反查行值，并标注
+                if (rowFallback && rowFallback.fields.length)
+                    console.log('当前记录行值（list 反查，查看态未带值）:');
+                for (const f of (rowFallback?.fields ?? []))
+                    if (f.value)
+                        console.log(`  ${f.title ?? f.dataIndex} = ${f.value}`);
+                console.log('JSONStr（⚠ 未能读取卡片字段原值，请人工核对）:');
+                console.log(JSON.stringify(values, null, 2));
+                if (files.length)
+                    console.log('附件:', files.map((f) => `field${f.fieldId}←${f.filePath}`).join(', '));
+            }
+            console.log('\n加 --yes 真提交。');
+            return;
+        }
+        const res = await submitCubeCard(cfg, { modeId, formId, billid, values, files });
+        console.log(`${res.ok ? '✅ 编辑成功' : '⚠ 提交异常'}  billid=${billid}  status=${res.raw?.status}`);
+        if (!res.ok)
+            console.log('响应:', JSON.stringify(res.raw).slice(0, 400));
+        return;
+    }
+    // ---------- delete：删除台账记录 ----------
+    if (sub === 'delete') {
+        const billids = flagStr(args, 'billids') ?? flagStr(args, 'billid');
+        if (!billids) {
+            console.error('cube delete 需要 --billids <id,...>');
+            process.exit(1);
+        }
+        const init = await getCubeInit(cfg, { customid });
+        const modeId = flagStr(args, 'mode-id') ?? init.modeId;
+        if (!args.flags.yes) {
+            // P0-1：反查记录名，输出确认表，避免黑盒删
+            console.log(`[dry-run] 删除台账记录 · customid=${customid} modeId=${modeId}`);
+            let rows = null;
+            let missing = [];
+            try {
+                const fb = await fetchCubeRowsByIds(cfg, { customid, billids, modeId });
+                rows = fb.rows;
+                missing = fb.missing;
+            }
+            catch (e) {
+                console.log(`  （反查记录名失败: ${e.message}）`);
+            }
+            if (rows && rows.length) {
+                console.log(`将删除以下 ${rows.length} 条（⚠ 删除不可恢复）：`);
+                rows.forEach((row, i) => console.log(`  ${i + 1}. ${row.name || '(无标题)'}  [id=${row.id}]`));
+            }
+            else if (rows) {
+                console.log('（未能反查到目标记录）');
+            }
+            if (missing && missing.length)
+                console.log(`  ⚠ 未找到/无权限的记录: ${missing.join(', ')}（请人工核对 billids）`);
+            console.log('\n加 --yes 真删。');
+            return;
+        }
+        const res = await deleteCubeData(cfg, { customid, billids, modeId });
+        console.log(`${res.ok ? '✅ 删除成功' : '⚠ 删除异常'}  ${res.message ?? ''}`);
+        if (!res.ok)
+            console.log('响应:', JSON.stringify(res.raw).slice(0, 400));
+        return;
+    }
+    // ---------- print：打印台账记录为 PDF ----------
+    if (sub === 'print') {
+        const billid = flagStr(args, 'billid');
+        if (!billid) {
+            console.error('cube print 需要 --billid <记录id>');
+            process.exit(1);
+        }
+        const init = await getCubeInit(cfg, { customid });
+        const modeId = flagStr(args, 'mode-id') ?? init.modeId;
+        const formId = flagStr(args, 'form-id') ?? init.formId;
+        console.log(`打开合同详情页 · customid=${customid} billid=${billid}（浏览器打开卡片，请在页面点「打印」按钮另存 PDF）...`);
+        const res = await printCubePdf(cfg, { customid, billid, modeId, formId });
+        console.log(`${res.ok ? '✅ 已打开详情页' : '⚠ 失败'}  ${res.mode}`);
+        return;
+    }
+    // ---------- search-info：字段下拉选项全表 ----------
+    if (sub === 'search-info') {
+        const r = await getSearchColumnInfo(cfg, { customid });
+        // P2-2：合并 card-fields 的 fid→label 中文名（获取失败不阻断，回退数字 fid）
+        let labelMap = {};
+        try {
+            const init = await getCubeInit(cfg, { customid });
+            const modeId = flagStr(args, 'mode-id') ?? init.modeId;
+            const formId = flagStr(args, 'form-id') ?? init.formId;
+            const cf = await getCardFields(cfg, { modeId, formId });
+            for (const f of cf.fields)
+                labelMap[String(f.id)] = f.label;
+        }
+        catch { /* label 获取失败不阻断 */ }
+        if (args.flags.json) {
+            // 向后兼容：保留 optionsMap 原结构，另加 labelMap（fid→中文名）供 AI 对应字段
+            console.log(JSON.stringify({ customid, optionsMap: r.optionsMap, labelMap }, null, 2));
+            return;
+        }
+        console.log(`E9 台账字段选项 · customid=${customid}`);
+        for (const [fid, list] of Object.entries(r.optionsMap)) {
+            const label = labelMap[fid] ? `${labelMap[fid]}(` : '';
+            console.log(`  字段 ${label}${fid}${labelMap[fid] ? ')' : ''}:`);
+            for (const o of list)
+                if (o.showname)
+                    console.log(`      ${o.key ?? ''} = ${o.showname}`);
+        }
+        return;
+    }
+    // ---------- excel：Excel 视图取数 ----------
+    if (sub === 'excel') {
+        const r = await listCubeExcel(cfg, { customid, menuIds, page: Number(flagStr(args, 'page') ?? '1') || 1 });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ customid, name: r.name, total: r.total, columns: r.columns, items: r.items }, null, 2));
+            return;
+        }
+        console.log(`E9 台账(Excel视图) · ${r.name ?? customid} 第 ${r.page} 页（每页 10 条）  共 ${r.total ?? '?'} 条`);
+        for (const c of r.columns)
+            console.log(`  · ${c.title ?? c.dataIndex} [${c.dataIndex}] ${c.editable ? '(可编辑)' : ''}`);
+        const cubeBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        for (let i = 0; i < r.items.length; i++) {
+            const it = r.items[i];
+            // 卡片详情 URL（点开进 E9 台账卡片页）
+            const nameLinked = hyperlinkFor('cube', it, cubeBase, it.name ?? '(无名称)', { modeId: r.modeId, formId: r.formId, customid: r.customid });
+            console.log(`${i + 1}. ${nameLinked}  [id=${it.id ?? ''}]`);
+            const meta = it.fields.filter((f) => f.value).slice(0, 5).map((f) => `${f.title}=${f.value}`).join(' | ');
+            if (meta)
+                console.log(`   ${meta}`);
+        }
+        // getDataAndTime 服务端固定 10 条/页（无视 pageSize 入参），直读服务端页天然连续
+        const remaining = (r.total ?? 0) - r.page * 10;
+        if (remaining > 0)
+            console.log(`还有 ${remaining} 条，用 --page ${r.page + 1} 继续（每页 10 条）。`);
+        return;
+    }
+    // ---------- count / group / card / browser ----------
+    if (sub === 'count') {
+        const r = await getCubeCountData(cfg, { customid, menuIds });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ customid, countData: r.countData }, null, 2));
+            return;
+        }
+        console.log(`E9 台账聚合统计 · customid=${customid}`);
+        for (const c of r.countData)
+            console.log(`  ${JSON.stringify(c)}`);
+        return;
+    }
+    if (sub === 'group') {
+        const r = await getCubeGroupData(cfg, { customid, menuIds, groupValue: flagStr(args, 'group-value') });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ customid, groupData: r.groupData }, null, 2));
+            return;
+        }
+        console.log(`E9 台账分组统计 · customid=${customid}: ${JSON.stringify(r.groupData).slice(0, 600)}`);
+        return;
+    }
+    if (sub === 'card') {
+        const modeId = flagStr(args, 'mode-id') ?? flagStr(args, 'modeid');
+        if (!modeId) {
+            console.error('cube card 需要 --mode-id');
+            process.exit(1);
+        }
+        const r = await getExpCardConfig(cfg, { customid, modeId });
+        console.log(`E9 卡片导出配置 · 可导出:${r.canExp ? '是' : '否'} 导出名:${r.expCardName ?? ''}`);
+        for (const b of r.batchExpList)
+            console.log(`  · ${b.showname} [key=${b.key}]`);
+        return;
+    }
+    if (sub === 'browser') {
+        const modeId = flagStr(args, 'mode-id');
+        const fieldId = flagStr(args, 'field-id');
+        const dt = flagStr(args, 'detail-type');
+        if (!modeId || !fieldId || !dt) {
+            console.error('cube browser 需要 --mode-id --field-id --detail-type(1人员/17多选/167部门/256 cube树)');
+            process.exit(1);
+        }
+        // 256（cube 树浏览框）：treeid = fielddbtype，未给则从 card-fields 自动取
+        let fielddbtype = flagStr(args, 'field-db-type');
+        if (dt === '256' && !fielddbtype) {
+            const init = await getCubeInit(cfg, { customid });
+            const formId = flagStr(args, 'form-id') ?? init.formId;
+            const cf = await getCardFields(cfg, { modeId, formId });
+            const fld = cf.fields.find((f) => String(f.id) === String(fieldId));
+            fielddbtype = fld?.fielddbtype;
+        }
+        const r = await getModeBrowserOptions(cfg, { modeId, fieldId, detailtype: dt, fielddbtype, pageSize: Number(flagStr(args, 'page-size') ?? '10') || 10 });
+        for (const it of r.items)
+            console.log(`  ${it.id} = ${it.name}${it.path ? '  (' + it.path + ')' : ''}`);
+        return;
+    }
+    // ---------- fields ----------
+    if (sub === 'fields') {
+        const r = await getCubeCondition(cfg, { customid });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ customid, items: r.items }, null, 2));
+            return;
+        }
+        console.log(`E9 建模查询条件 · customid=${customid}`);
+        if (r.items.length === 0) {
+            console.log('（无查询条件）');
+            return;
+        }
+        for (const it of r.items) {
+            console.log(`  ${it.label}（domkey=${(it.domkey || []).join(',')}，类型=${it.type ?? '?'}）${it.isQuickSearch ? ' [快捷搜索]' : ''}`);
+            for (const o of it.options)
+                console.log(`      ${o.key} = ${o.showname}`);
+        }
+        console.log('\n注：以上为查询条件字段，不含必填标记和完整控件类型。');
+        console.log('新建/编辑请用 `cube card-fields --customid <id>` 查看卡片字段定义（含必填/可编辑/完整控件类型）。');
+        return;
+    }
+    // ---------- export ----------
+    if (sub === 'export') {
+        const filename = flagStr(args, 'filename');
+        // P2-1：透传筛选条件（--condition/--keyword），中文 label 自动映射 domkey
+        const condRes = await resolveCubeCondition(cfg, { customid, condition: flagStr(args, 'condition') ?? '' });
+        if (condRes.unresolved.length)
+            printConditionUnresolved(condRes.unresolved);
+        const r = await exportCubeExcel(cfg, { customid, filename, yes: !!args.flags.yes, outDir: flagStr(args, 'out-dir'), modeCustomidPlain: !!args.flags.plain, conditionValues: condRes.conditionValues, keyword: flagStr(args, 'keyword') ?? '' });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ customid, dataKey: r.dataKey, filename: r.filename, downloaded: r.downloaded, outPath: r.outPath, size: r.size, sourceTotal: r.sourceTotal, validation: r.validation, expBody: r.expBody }, null, 2));
+            return;
+        }
+        if (!r.downloaded) {
+            console.log(`E9 建模导出 · dry-run 文件名=${r.filename}`);
+            console.log(JSON.stringify(r.expBody, null, 2));
+            console.log('\n加 --yes 真导出。');
+            return;
+        }
+        console.log(`导出完成并通过结构校验: ${r.outPath}（${r.size} 字节，${r.validation.rowCount} 行，${r.validation.cellCount} 个单元格）`);
+        return;
+    }
+    // ---------- list ----------
+    if (sub !== 'list') {
+        console.error(`cube 子命令: list/fields/export/view/search-info/excel/count/group/card/browser/card-fields/create/edit/delete/print/menus/find/import-template/import，收到: ${sub}`);
+        process.exit(1);
+    }
+    const condRes = await resolveCubeCondition(cfg, { customid, condition: flagStr(args, 'condition') ?? '' });
+    if (condRes.unresolved.length)
+        printConditionUnresolved(condRes.unresolved);
+    const conditionValues = condRes.conditionValues;
+    const r = await listCube(cfg, { customid, page: Number(flagStr(args, 'page') ?? '1') || 1, keyword: flagStr(args, 'keyword') ?? '', conditionValues });
+    if (args.flags.json) {
+        const cubeBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        console.log(JSON.stringify({ customid: r.customid, name: r.name, modeId: r.modeId, formId: r.formId, dataKey: r.dataKey, page: r.page, total: r.total, count: r.count, columns: r.columns.map((c) => ({ dataIndex: c.dataIndex, title: c.title })), items: r.items.map((it) => withLink('cube', { id: it.id, name: it.name, fields: it.fields }, cubeBase, { modeId: r.modeId, formId: r.formId, customid: r.customid })) }, null, 2));
+        return;
+    }
+    console.log(`E9 建模台账 · ${r.name ?? 'customid=' + r.customid} [第 ${r.page} 页${r.total != null ? ` / 共 ${r.total}` : ''}]  当前 ${r.count} 条`);
+    if (r.count === 0) {
+        console.log('（无数据）');
+        return;
+    }
+    // 固定列头：模型据此观察全部字段，挑选 ≤5 个展示列后逐行对齐渲染（空值显式显示（无数据））。
+    const headerCols = (r.columns || []).filter((c) => c.dataIndex && c.dataIndex !== 'randomFieldId');
+    if (headerCols.length)
+        console.log(`字段(${headerCols.length}): ${headerCols.map((c) => c.title ?? c.dataIndex).join(' | ')}`);
+    const cubeBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    for (let i = 0; i < r.items.length; i++) {
+        const it = r.items[i];
+        // 卡片详情 URL（点开进 E9 台账卡片页）
+        const nameLinked = hyperlinkFor('cube', it, cubeBase, it.name ?? '(无名称)', { modeId: r.modeId, formId: r.formId, customid: r.customid });
+        console.log(`${i + 1}. ${nameLinked}  [id=${it.id ?? ''}]`);
+        // 逐行按全量 columns 对齐输出（空值显式标（无数据）），不再 filter 非空 + slice 5 ——
+        // 避免“每行展示的字段集合不同、同一位置含义不一致”的合并列错觉。
+        const meta = it.fields.map((f) => `${f.title}=${f.value || '（无数据）'}`).join(' | ');
+        if (meta)
+            console.log(`   ${meta}`);
+    }
+}
+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 headLinked = hyperlinkFor('todo', it, base, head);
+        console.log(`${indent}${i + 1}. ${headLinked}${it.level ? `  (${it.level})` : ''}`);
+        if (meta)
+            console.log(`${indent}   ${meta}`);
+    }
+    if (items.length > visible.length)
+        console.log(`${indent}还有 ${items.length - visible.length} 条本页结果未显示，可使用 --page 查看后续内容。`);
+}
+
+async function runTodoBatch(args) {
+    const sub = args._[1];
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestIds = parseIdList(flagStr(args, 'request-ids'), 'requestIds');
+    const remark = flagStr(args, 'remark');
+    let preview;
+    if (sub === 'batch-submit') {
+        const userIds = parseIdList(flagStr(args, 'user-ids'), 'userIds');
+        if (requestIds.length !== userIds.length)
+            throw new Error('request-ids 与 user-ids 数量必须一致。');
+        preview = { operation: '批量提交', requestIds, userIds, remark: remark ?? 'OK' };
+    }
+    else if (sub === 'batch-forward') {
+        const receiver = parseIdList(flagStr(args, 'receiver'), 'receiver');
+        preview = { operation: '批量转发', requestIds, receiver, remark: remark ?? '转发' };
+    }
+    else {
+        // 批量关注：dry-run 也先查关注类型（只读），供用户确认加入哪个关注类型
+        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 })) };
+    }
+    if (!args.flags.yes) {
+        console.log(BOX_TOP);
+        console.log(`  ${preview.operation}预览（共 ${requestIds.length} 条）`);
+        console.log(DIVIDER);
+        console.log(JSON.stringify(preview, null, 2));
+        console.log('\n  确认无误后，请使用相同命令加 --yes 执行。');
+        return;
+    }
+    let result;
+    if (sub === 'batch-submit')
+        result = await batchSubmit(cfg, { requestIds, userIds: preview.userIds, remark: preview.remark });
+    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 });
+    const body = result.result?.json ?? {};
+    const ok = result.result?.ok && body.success !== false && body.status !== false;
+    console.log(`${ok ? '✅' : '⚠'} ${preview.operation}已请求处理（${requestIds.length} 条）。`);
+    console.log(JSON.stringify(body, null, 2));
+}
+
+async function runPageOpen(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const page = flagStr(args, 'page') ?? 'center';
+    const url = pageUrl(cfg, page, flagStr(args, 'request-id'));
+    if (args.flags.json) {
+        console.log(JSON.stringify({ page, url }, null, 2));
+        return;
+    }
+    console.log(`打开“${page}”页面：`);
+    console.log(url);
+    console.log(`可选页面：${availablePages().join('、')}`);
+}
+async function runReport(args) {
+    const sub = args._[1] ?? 'collect';
+    if (sub !== 'collect')
+        throw new Error('report 只支持 collect。');
+    const report = await collectQueryableBusiness(loadConfig(flagStr(args, 'config')), flagStr(args, 'date') ?? todayStr());
+    if (args.flags.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log(report.scope);
+    console.log(`环境：${report.baseUrl}；日期：${report.date}`);
+    for (const [name, items] of Object.entries(report.sources))
+        console.log(`- ${name}：${items.length} 条`);
+    for (const note of report.notes ?? [])
+        console.log(`- ${note}`);
+    if (report.failures.length)
+        console.log(`- 未查询成功的来源：${report.failures.map((item) => item.index).join(', ')}`);
+}
+
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.flags.help || args.flags.h) {
+        console.log(usage());
+        return;
+    }
+    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.0.0', buildHash }, null, 2));
+        return;
+    }
+    if (cmd === 'config') {
+        runConfig(args);
+        return;
+    }
+    if (cmd === 'auth') {
+        await runAuth(args);
+        return;
+    }
+    if (cmd === 'create') {
+        await runCreate(args);
+        return;
+    }
+    if (cmd === 'page-open') {
+        await runPageOpen(args);
+        return;
+    }
+    if (cmd === 'report') {
+        await runReport(args);
+        return;
+    }
+    if (cmd === 'blog') {
+        await runBlog(args);
+        return;
+    }
+    if (cmd === 'email') {
+        await runEmail(args);
+        return;
+    }
+    if (cmd === 'workplan') {
+        await runWorkplan(args);
+        return;
+    }
+    if (cmd === 'odoc') {
+        await runOdoc(args);
+        return;
+    }
+    if (cmd === 'kq') {
+        await runKq(args);
+        return;
+    }
+    if (cmd === 'search') {
+        await runSearch(args);
+        return;
+    }
+    if (cmd === 'cube') {
+        await runCube(args);
+        return;
+    }
+    if (cmd !== 'todo') {
+        console.error(`未知命令: ${cmd}\n\n${usage()}`);
+        process.exit(1);
+    }
+    const sub = args._[1] ?? 'list';
+    if (sub === 'summary') {
+        await runTodoSummary(args);
+        return;
+    }
+    if (sub === 'submit') {
+        await runTodoSubmit(args);
+        return;
+    }
+    if (sub === 'retract') {
+        await runTodoRetract(args);
+        return;
+    }
+    if (sub === 'reject') {
+        await runTodoReject(args);
+        return;
+    }
+    if (sub === 'transfer') {
+        await runTodoTransfer(args);
+        return;
+    }
+    if (sub === 'forward') {
+        await runTodoForward(args);
+        return;
+    }
+    if (sub === 'circulate') {
+        await runTodoCirculate(args);
+        return;
+    }
+    if (sub === 'cc') {
+        await runTodoCc(args);
+        return;
+    }
+    if (sub === 'ask-idea') {
+        await runTodoAskIdea(args);
+        return;
+    }
+    if (sub === 'batch-submit' || sub === 'batch-forward' || sub === 'batch-attention') {
+        await runTodoBatch(args);
+        return;
+    }
+    // P1-1: done/mine 子命令（按 category 分流，viewcondition 由 workflow.js 默认）
+    const category = (sub === 'done') ? 'done' : (sub === 'mine') ? 'mine' : 'todo';
+    if (sub !== 'list' && sub !== 'done' && sub !== 'mine') {
+        console.error(`todo 暂只支持 list / done / mine / summary / submit / retract / reject / transfer / forward / circulate / cc / ask-idea 子命令，收到: ${sub}`);
+        process.exit(1);
+    }
+    const cfg = loadConfig(flagStr(args, 'config'));
+    let savedQueryFlags = {};
+    let tab = flagStr(args, 'tab');
+    let key = '', viewcondition = undefined, name = sub;
+    if (category === 'todo') {
+        const r = resolveViewcondition(cfg, tab);
+        key = r.key;
+        viewcondition = r.viewcondition;
+        // 默认 tab=5 是“待处理”，不是 OA 的“全部”；无论旧配置如何命名，都用准确口径展示。
+        name = r.viewcondition === '5' ? '待处理' : r.name;
+    }
+    let creatorFilter = flagStr(args, 'creator');
+    let workflowFilter = flagStr(args, 'workflow');
+    const resumeQuery = flagStr(args, 'resume-query');
+    if (resumeQuery) {
+        const saved = loadCandidateQuery(resumeQuery);
+        savedQueryFlags = saved.options?.flags ?? {};
+        tab = flagStr(args, 'tab') ?? (typeof savedQueryFlags.tab === 'string' ? savedQueryFlags.tab : tab);
+        if (category === 'todo') {
+            const resolved = resolveViewcondition(cfg, tab);
+            key = resolved.key;
+            viewcondition = resolved.viewcondition;
+            name = resolved.viewcondition === '5' ? '待处理' : resolved.name;
+        }
+        creatorFilter = flagStr(args, 'creator') ?? (typeof savedQueryFlags.creator === 'string' ? savedQueryFlags.creator : creatorFilter);
+        const candidate = Number(flagStr(args, 'candidate'));
+        if (!Number.isInteger(candidate) || candidate < 1 || candidate > saved.candidates.length)
+            throw new Error(`请用 --candidate 选择 1 到 ${saved.candidates.length} 的候选流程。`);
+        workflowFilter = String(saved.candidates[candidate - 1].id);
+    }
+    else if (workflowFilter && !/^\d+(\s*,\s*\d+)*$/.test(workflowFilter)) {
+        const candidates = await findCreateWfByName(cfg, workflowFilter);
+        if (candidates.length === 0)
+            throw new Error(`未找到名称包含“${workflowFilter}”的流程。`);
+        if (candidates.length > 1) {
+            const contextId = saveCandidateQuery({ workflow: workflowFilter, candidates, options: { flags: args.flags, sub } });
+            console.log(`找到 ${candidates.length} 个相似流程，请选择：`);
+            candidates.forEach((item, index) => console.log(`${index + 1}. ${item.name}  [${item.id}]`));
+            console.log(`\n选定后继续：e9 todo ${sub} --resume-query ${contextId} --candidate <序号>`);
+            return;
+        }
+        workflowFilter = String(candidates[0].id);
+    }
+    const effectiveCreatorName = flagStr(args, 'creator-name') ?? (typeof savedQueryFlags['creator-name'] === 'string' ? savedQueryFlags['creator-name'] : undefined);
+    if (!creatorFilter && effectiveCreatorName) {
+        const people = await getAtAllList(cfg, { name: effectiveCreatorName });
+        const exact = people.items.filter((person) => String(person.name) === effectiveCreatorName);
+        if (exact.length !== 1) {
+            console.log(`“${effectiveCreatorName}”匹配到 ${people.items.length} 位人员，请改用 --creator <人员 ID>：`);
+            people.items.forEach((person, index) => console.log(`${index + 1}. ${person.name}  [${person.uid}]${person.name === effectiveCreatorName ? ' ★精确匹配' : ''}`));
+            return;
+        }
+        creatorFilter = String(exact[0].uid);
+    }
+    const queryFlag = (key) => {
+        const current = flagStr(args, key);
+        if (current !== undefined)
+            return current;
+        const saved = savedQueryFlags[key];
+        return typeof saved === 'string' ? saved : undefined;
+    };
+    const queryBool = (key) => args.flags[key] === true || savedQueryFlags[key] === true;
+    let workflowTypeFilter = queryFlag('workflow-type');
+    if (workflowTypeFilter && !/^\d+$/.test(workflowTypeFilter)) {
+        const resolvedType = await resolveWorkflowType(cfg, workflowTypeFilter, { category, viewcondition });
+        workflowTypeFilter = resolvedType.id;
+    }
+    let excludeCreatorId;
+    if (queryBool('exclude-current-user')) {
+        const currentUser = await getCurrentUser(cfg);
+        if (!currentUser.userid)
+            throw new Error('未能读取当前用户 ID，无法安全执行“不是我发起”筛选。');
+        excludeCreatorId = currentUser.userid;
+    }
+    const listOpts = {
+        category,
+        viewcondition,
+        subCategory: queryFlag('sub-category'),
+        page: Number(queryFlag('page') ?? '1') || 1,
+        keyword: queryFlag('keyword') ?? '',
+        sort: queryFlag('sort'),
+        workflow: workflowFilter,
+        creator: creatorFilter,
+        creatorDept: queryFlag('creator-dept'),
+        creatorSubcom: queryFlag('creator-subcom'),
+        createTime: queryFlag('create-time'),
+        receiveTime: queryFlag('receive-time'),
+        operateTime: queryFlag('operate-time'),
+        requestLevel: queryFlag('request-level'),
+        requestMark: queryFlag('request-mark'),
+        workflowType: workflowTypeFilter,
+        nodeId: queryFlag('node-id'),
+        flowStatus: queryFlag('flow-status'),
+        totalOnly: queryBool('total-only'),
+        debug: queryBool('debug'),
+        excludeCreatorId,
+    };
+    // 默认概览优先展示“我需要做什么”，而不是把转发和关注与待处理混在数千条列表里。
+    const shouldGroup = category === 'todo' && !listOpts.subCategory && !tab && !listOpts.totalOnly && !queryBool('ungrouped') && !queryBool('raw');
+    if (shouldGroup) {
+        const grouped = await getSmartTodoGroups(cfg, listOpts);
+        const groupedSnapshot = {
+            actionTotal: grouped.actionTotal,
+            categoryTotals: grouped.categoryTotals,
+            categoryTotalSum: grouped.categoryTotalSum,
+            page: grouped.page,
+            groups: grouped.groups.map((group) => ({
+                key: group.key,
+                title: group.title,
+                total: group.result.total,
+                items: group.items,
+                raw: group.result.raw,
+            })),
+        };
+        const savedGroupedResult = persistSearchResult(groupedSnapshot, 'E9 待办智能概览');
+        if (args.flags.json) {
+            const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+            console.log(JSON.stringify({ page: grouped.page, actionTotal: grouped.actionTotal, categoryTotals: grouped.categoryTotals, groups: grouped.groups.map((g) => ({ key: g.key, title: g.title, total: g.result.total, items: g.items.map((item) => withLink('todo', item, base)) })) }, null, 2));
+            return;
+        }
+        const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        console.log('E9 待办智能概览（按处理方式分组，避免重复提醒）');
+        for (const group of grouped.groups) {
+            console.log(`\n### ${group.title}（共 ${group.result.total ?? '?'} 条，第 ${group.result.page} 页显示前 10 条）`);
+            if (group.items.length)
+                printTodoItems(group.items, base);
+            else
+                console.log('（本页无数据）');
+        }
+        if (savedGroupedResult)
+            console.log(`完整结果已保存到 ${savedGroupedResult.jsonPath}`);
+        return;
+    }
+    const result = await getWfList(cfg, listOpts);
+    const savedResult = persistSearchResult(result, `E9 ${name ?? key} 查询`);
+    if (args.flags.raw) {
+        console.error('===== RAW getWfListParams =====');
+        console.error(JSON.stringify(result.raw.getWfListParams, null, 2));
+        console.error('===== RAW splitPageKey =====');
+        console.error(JSON.stringify(result.raw.splitPageKey, null, 2));
+        console.error('===== RAW datas =====');
+        console.error(JSON.stringify(result.raw.datas, null, 2));
+        console.error('===== RAW counts =====');
+        console.error(JSON.stringify(result.raw.counts, null, 2));
+        console.error('===== 解析结果 =====');
+    }
+    if (args.flags.json) {
+        console.log(JSON.stringify({
+            tab: key,
+            tabName: name,
+            page: result.page,
+            pageSize: result.pageSize,
+            total: result.total,
+            count: result.items.length,
+            dataKey: result.dataKey,
+            columns: result.columns.map((c) => ({ dataIndex: c.dataIndex, title: c.title })),
+            items: result.items.map((it) => ({
+                ...linkMetaFor('todo', it, endpointFor(cfg).baseUrl),
+                requestId: it.requestId,
+                title: it.title,
+                creator: it.creator,
+                creatorId: it.creatorId,
+                currentOperator: it.currentOperator,
+                node: it.node,
+                createdate: it.createdate,
+                receivedate: it.receivedate,
+                status: it.status,
+                level: it.level,
+                requestmark: it.requestmark,
+            })),
+            sourceTotal: result.sourceTotal,
+            excludedCreatorId: result.excludedCreatorId,
+            fetchedPages: result.fetchedPages,
+        }, null, 2));
+        return;
+    }
+    if (listOpts.totalOnly) {
+        console.log(`E9 待办 [${name ?? key}]：共 ${result.total ?? '?'} 条`);
+        return;
+    }
+    // 人类可读输出
+    console.log(`E9 待办 [${name ?? key}]  第 ${result.page} 页  共 ${result.total ?? '?'} 条`);
+    if (result.items.length === 0) {
+        console.log('（无数据）');
+        if (args.flags.raw) {
+            console.error('提示：如果 total 显示为 ? 或无数据，请用 --raw 查看真实响应后反馈。');
+        }
+        return;
+    }
+    const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    printTodoItems(result.items, base);
+    if (savedResult)
+        console.log(`完整结果已保存到 ${savedResult.jsonPath}`);
+}
+async function runTodoSummary(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo summary 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const s = await getFlowSummary(cfg, requestId);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ requestId: s.requestId, workflowName: s.workflowName, workflowId: s.workflowId, nodeId: s.nodeId, verifyRight: s.verifyRight, fields: s.fields, logs: s.logs }, null, 2));
+        return;
+    }
+    console.log(BOX_TOP);
+    console.log(`  流程摘要 · ${s.workflowName ?? '(未知流程)'}  (requestid=${s.requestId})`);
+    console.log(`  workflowid=${s.workflowId ?? '?'}  nodeid=${s.nodeId ?? '?'}  verifyRight=${s.verifyRight ? '✅' : '❌'}`);
+    console.log(DIVIDER);
+    if (s.fields.length === 0) {
+        console.log('  表单字段：无数据');
+    }
+    else {
+        console.log('  表单内容：');
+        for (const f of s.fields) {
+            console.log(`    ▸ ${f.label ?? f.id}${f.name ? ` (${f.name})` : ''}  =  ${f.value ?? ''}`);
+        }
+    }
+    if (s.logs.length > 0) {
+        console.log(DIVIDER);
+        console.log('  流转历史：');
+        for (const log of s.logs) {
+            const who = log.displayname || log.receiveUser || '?';
+            const when = `${log.log_operatedate ?? ''} ${log.log_operatetime ?? ''}`.trim();
+            const op = log.operationname || '';
+            const node = log.log_nodename || '';
+            const remark = log.remark || log.remarkContent || '';
+            console.log(`    ${who}  ${op}  ${node}  ${when}${remark ? `  「${remark}」` : ''}`);
+        }
+    }
+    else {
+        console.log('  流转历史：暂无');
+    }
+    console.log(BOX_TOP);
+}
+async function runTodoSubmit(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo submit 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const remark = flagStr(args, 'remark') ?? 'OK';
+    const send = !!args.flags.yes;
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 提交待办 requestid=${requestId}`);
+        console.log(`  签字意见 = ${remark}`);
+        console.log('  确认无误后加 --yes 真正提交。');
+        console.log(BOX_TOP);
+        return;
+    }
+    const res = await submitTodo(cfg, { requestId, remark });
+    console.log(BOX_TOP);
+    const j = res.json;
+    const ok = j?.data?.type === 'SUCCESS' || j?.type === 'SUCCESS';
+    console.log(`  ${ok ? '✅ 提交成功' : '⚠ 提交异常'}  status=${res.status}`);
+    if (j)
+        console.log('响应:', JSON.stringify(j).slice(0, 400));
+    else
+        console.log('响应(非JSON):', (res.text ?? '').slice(0, 300));
+    console.log(BOX_TOP);
+}
+async function runTodoRetract(args) {
+    const cfg = loadConfig(flagStr(args, 'config'));
+    const requestId = flagStr(args, 'requestid');
+    if (!requestId) {
+        console.error('todo retract 需要 --requestid <请求id>');
+        process.exit(1);
+    }
+    const send = !!args.flags.yes;
+    if (!send) {
+        console.log(BOX_TOP);
+        console.log(`  [dry-run] 撤回流程 requestid=${requestId}`);
+        console.log('  确认无误后加 --yes 真正撤回。');
+        console.log(BOX_TOP);
+        return;
+    }
+    const res = await retractRequest(cfg, requestId);
+    console.log(BOX_TOP);
+    console.log(`  ${res.verified ? '✅ 撤回成功且已核验' : '⚠ 撤回结果未确认'}${res.response ? `  status=${res.response.status}` : ''}`);
+    console.log(`  ${res.message ?? ''}`);
+    if (!res.verified)
+        console.log(`  请在 OA 中核对流程状态：${buildRequestFormUrl(endpointFor(cfg).baseUrl, requestId)}`);
+    console.log(BOX_TOP);
+}
+function runConfig(args) {
+    const sub = args._[1];
+    if (sub === 'set') {
+        const field = args._[2];
+        const value = args._[3];
+        if (!field || value === undefined) {
+            console.error('用法: e9 config set <field> <value>   （field: baseUrl/cookie/username/menuIds/...）');
+            console.error('  首次使用: e9 config set baseUrl http://你的E9地址:端口');
+            process.exit(1);
+        }
+        setConfigField(field, String(value), flagStr(args, 'config'));
+        return;
+    }
+    if (sub === 'init') {
+        console.log('E9 首次配置：');
+        console.log('  1) e9 config set baseUrl http://你的E9地址:端口');
+        console.log('  2) e9 auth token-login   （有头浏览器登录 E9 + 点确认授权，拿 aiAgentToken，cookie 自动写回）');
+        console.log('  3) e9 blog check / e9 todo list / e9 create list   验证');
+        return;
+    }
+    printConfig(args);
+}
+function printConfig(args) {
+    let cfg;
+    try {
+        cfg = loadConfig(flagStr(args, 'config'));
+    }
+    catch (e) {
+        console.log(`配置加载失败：${e.message}`);
+        return;
+    }
+    const tabs = cfg.tabs ?? {};
+    console.log(`配置文件: ${cfg._configPath}`);
+    console.log(`baseUrl:  ${cfg.baseUrl}`);
+    console.log(`cookie:   ${cfg.cookie ? `已配置 (${cfg.cookie.length} 字符)` : '未配置'}`);
+    console.log(`defaultTab: ${cfg.defaultTab ?? '(未设)'}`);
+    console.log('tabs:');
+    for (const [k, t] of Object.entries(tabs)) {
+        console.log(`  ${k.padEnd(10)} viewcondition=${t.viewcondition}  ${t.name ?? ''}`);
+    }
+}
+main().catch((e) => {
+    console.error(`错误: ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+});