weaver-e9-assistant-cli 1.1.2 → 1.1.4

package/dist/cli.js

@@ -3,7 +3,7 @@
 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 { getWfList, getOaTabGroups, resolveWorkflowType, CATEGORY_SCOPE } 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';
@@ -28,9 +28,10 @@ import { searchWorkplan, createWorkplan, getMyCalendar, getAttentionData, getBas
 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 { listCube, getCubeCondition, getCubeInit, exportCubeExcel, getSearchColumnInfo, listCubeExcel, getCubeCountData, getCubeGroupData, getExpCardConfig, getModeBrowserOptions, getCardFields, submitCubeCard, deleteCubeData, printCubePdf, listCubeMenus, findCubeByName, fetchMenuMounts, previewCubeCard, fetchCubeRowsByIds, resolveCubeCondition, downloadCubeImportTemplate, importCubeExcel, assertEditableCardValues } from './cube.js';
 import { getCurrentUser, getCurrentUserIsAdmin } from './wfuser.js';
 import { getSubordinates, assertUserIdsInScope, assertNamesInScope, isScopeEnforced } from './subordinate.js';
+import { resolveHrmTab, getHrmTabs, getHrmConditions, resolveHrmCondition, hrmList, buildHrmCardUrl, findHrmOrgNode, applyResolvedPersonIds, expandHrmOrgTree } from './hrm.js';
 import { parseArgs, flagStr, flagBool } from './args.js';
 import { todayStr } from './util.js';
 import { BOX_TOP, DIVIDER } from './render.js';
@@ -145,6 +146,11 @@ function usage() {
         '  e9 cube find <名称>          按名模糊匹配台账（列候选消歧，返回 customid+mode+app，供 list/create 等用）',
         '  e9 cube find <名称> --tree-detail   展开 tree 测试类台账的全部树节点路径（默认只显首条菜单路径）',
         '  e9 subordinate list [--name <姓名>] [--all-level] [--page <n>] [--json] [--raw] [--refresh]   查询我的下属（默认直接下属；--all-level 全部层级）',
+        '  e9 hrm tree [--id <组织id>] [--type <1分部|2部门>] [--depth <n>] [--dept <部门名|id>] [--subcompany <分部名|id>] [--json]   组织架构树',
+        '  e9 hrm tabs                                         列出人事搜索范围（全部人员/同部门/我的下属）',
+        '  e9 hrm conditions [--tab <全部人员|同部门|我的下属>]   列出该范围可用搜索条件（label→domkey）',
+        '  e9 hrm search [--tab <全部人员|同部门|我的下属>] [--name <姓名>] [--condition "岗位=经理;性别=男"]',
+        '              [--dept <部门名|id>] [--subcompany <分部名|id>] [--all-level] [--page <n>] [--json] [--raw]   人事搜索（姓名=详情卡片超链接）',
         '  e9 search <名称>            统一搜台账+菜单+流程（只说名字、不知归属时用，避免猜错域）',
         '  e9 config                    查看当前配置来源与状态',
         '  e9 config set <field> <value>   设置配置（field: baseUrl/cookie/username/menuIds/...；首次用 set baseUrl）',
@@ -340,7 +346,7 @@ function escapeLinkText(text) {
     return String(text).replace(/([\[\]()\\])/g, '\\$1');
 }
 /** 统一拼各域 list/search 项的 markdown 超链接；无 id/无可链目标时回退纯文本。
- *  domain: 'todo'|'odoc'|'create'|'blog'|'email'|'cube'|'workplan'
+ *  domain: 'todo'|'odoc'|'create'|'blog'|'email'|'cube'|'workplan'|'hrm'
  *  text: 展示文本（调用方已计算好回退值）；ctx: cube 需 {modeId,formId,customid} */
 function hyperlinkFor(domain, item, base, text, ctx = {}) {
     const meta = linkMetaFor(domain, item, base, ctx);
@@ -389,6 +395,12 @@ function linkMetaFor(domain, item, base, ctx = {}) {
                 url = `${b}/spa/workplan/static/index.html#/main/wp/myWorkPlan`;
             urlType = url ? 'list-generic' : '';
             break;
+        case 'hrm':
+            // 人事详情卡片（真机验证通过）：SPA hash 路由 #/main/hrm/card/cardInfo/<hrmresource.id>
+            if (item?.id)
+                url = buildHrmCardUrl(b, item.id);
+            urlType = url ? 'detail' : '';
+            break;
     }
     return {
         url: url || null,
@@ -1736,15 +1748,16 @@ async function runBlog(args) {
             return { ...it, matchType, _sort: matchType === 'exact' ? 0 : matchType === 'prefix' ? 1 : 2 };
         });
         annotated.sort((a, b) => a._sort - b._sort);
+        const atBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
         if (args.flags.json) {
-            console.log(JSON.stringify({ pageIndex: r.pageIndex, pageSize: r.pageSize, noMore: r.noMore, query: q || undefined, items: annotated.map(({ _sort, ...rest }) => rest) }, null, 2));
+            console.log(JSON.stringify({ pageIndex: r.pageIndex, pageSize: r.pageSize, noMore: r.noMore, query: q || undefined, items: annotated.map(({ _sort, ...rest }) => withLink('hrm', { id: rest.uid, name: rest.name }, atBase, rest)) }, null, 2));
             return;
         }
         console.log(`E9 微博 @ 提及用户列表 [第 ${r.pageIndex} 页]${r.noMore ? '' : '（还有更多）'}  共 ${annotated.length} 条${q ? ` · 搜索「${flagStr(args, 'name')}」` : ''}`);
         for (let i = 0; i < annotated.length; i++) {
             const it = annotated[i];
             const tag = it.matchType === 'exact' ? ' ★精确匹配' : it.matchType === 'prefix' ? ' ·前缀' : '';
-            console.log(`${i + 1}. ${it.name}  (uid=${it.uid})${tag}`);
+            console.log(`${i + 1}. ${hyperlinkFor('hrm', { id: it.uid }, atBase, it.name)}  (uid=${it.uid})${tag}`);
         }
         return;
     }
@@ -3432,6 +3445,12 @@ async function runCube(args) {
             catch {
                 curFields = null;
             }
+            // ★字段属性硬规则：只读字段禁止填值，编辑 dry-run 也要拦（真实提交由 submitCubeCard 兜底）。
+            //   判据必须取「新建态」字段定义——curFields 带 billid 是查看态，isedit 恒为 false，会误伤全部字段。
+            const defFields = (await getCardFields(cfg, { modeId, formId })).fields;
+            assertEditableCardValues(defFields, values);
+            if (files.length)
+                assertEditableCardValues(defFields, Object.fromEntries(files.map((f) => [String(f.fieldId), '1'])));
             // 查看态不带值时：list 反查该条记录的行值作对比兜底
             if (!(curFields && curFields.fields.some((f) => f.value !== undefined && f.value !== null && f.value !== ''))) {
                 try {
@@ -3764,8 +3783,9 @@ async function runSubordinate(args) {
         console.error(JSON.stringify(r.raw.counts, null, 2));
         console.error('===== 解析结果 =====');
     }
+    const subBase = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
     if (args.flags.json) {
-        console.log(JSON.stringify({ lastname, allLevel, page, pageSize: r.pageSize, total: r.total, count: r.count, items: r.items.map((it) => ({ id: it.id, name: it.name, fields: it.fields })) }, null, 2));
+        console.log(JSON.stringify({ lastname, allLevel, page, pageSize: r.pageSize, total: r.total, count: r.count, items: r.items.map((it) => withLink('hrm', { id: it.id, name: it.name, fields: it.fields }, subBase)) }, null, 2));
         return;
     }
     console.log(`我的下属${allLevel ? '（全部层级）' : '（直接下属）'}${name ? ` · 姓名过滤「${name}」` : ''} [第 ${page} 页${r.pageSize != null ? ` · 每页 ${r.pageSize} 条` : ''}${r.total != null ? ` / 共 ${r.total} 人` : ''}]  当前 ${r.count} 人`);
@@ -3773,17 +3793,230 @@ async function runSubordinate(args) {
         console.log('（无下属）');
         return;
     }
-    const cols = (r.columns || []).filter((c) => c.dataIndex && c.dataIndex !== 'randomFieldId');
+    // 表头同样排除 id 列（服务端把 id 列的标题误标为「是否在线」，列出来会误导）与 randomFieldId
+    const hdrIdCol = r.items[0]?.idCol;
+    const cols = (r.columns || []).filter((c) => c.dataIndex && c.dataIndex !== 'randomFieldId' && c.dataIndex !== hdrIdCol);
     if (cols.length)
         console.log(`字段(${cols.length}): ${cols.map((c) => c.title ?? c.dataIndex).join(' | ')}`);
     for (let i = 0; i < r.items.length; i++) {
         const it = r.items[i];
-        console.log(`${i + 1}. ${it.name || '(无姓名)'}  [id=${it.id || ''}]`);
-        const meta = it.fields.filter((f) => f.value && f.title && f.dataIndex !== it.idCol).slice(0, 6).map((f) => `${f.title}=${f.value}`).join(' | ');
+        console.log(`${i + 1}. ${hyperlinkFor('hrm', { id: it.id }, subBase, it.name || '(无姓名)')}  [id=${it.id || ''}]`);
+        // 排除内部列：id 列（其标题被服务端误标为「是否在线」）、姓名列（已作可点标题）、randomFieldId（id 的副本）
+        const meta = it.fields.filter((f) => f.value && f.title && f.dataIndex !== it.idCol && f.dataIndex !== it.nameCol && f.dataIndex !== 'randomFieldId').slice(0, 6).map((f) => `${f.title}=${f.value}`).join(' | ');
         if (meta)
             console.log(`   ${meta}`);
     }
 }
+
+// ─── 组织人事（HRM）搜索 ─────────────────────────────────
+
+/**
+ * hrm search 结果里值为「字典编码」的列（dataIndex）。
+ * E9 在人事搜索接口（hrm/search/getHrmSearchResult）里**不解析**这些字段——给的是 id/code，
+ * 而同为人员列表的 subordinateinfo/getSearchResult 会解析（部门/分部/直接上级都给中文名）。
+ * 实测：岗位 jobtitlespan 给的就是 "1830"、性别 sexspan 给 "1"。OA 的「查询人员」页同样只显示编码。
+ * 故渲染时标注「（编码）」，避免用户把 1830 误读成名称。
+ */
+const HRM_CODE_FIELDS = new Set([
+    'sex', 'accounttype', 'belongto', 'jobtitle', 'jobGroupId',
+    'jobactivity', 'jobcall', 'joblevel', 'status', 'systemlanguage', 'locationid',
+]);
+
+/** 组织节点名称 → id（用于 --dept/--subcompany 名称定位；纯数字原样直传）。 */
+async function resolveHrmOrgValue(cfg, keyword, { matchType, flag }) {
+    const node = await findHrmOrgNode(cfg, keyword, { matchType });
+    if (!node)
+        throw new Error(`${flag} 无法在组织树中定位「${keyword}」（type=${matchType}）。可先用数字 ID 直传，或确认名称在人事组织树中存在。`);
+    return node.id;
+}
+
+/** 未识别条件的提示（含相近候选），与 cube 的 printConditionUnresolved 一致——不给静默放空。 */
+function printHrmConditionUnresolved(unresolved) {
+    for (const u of unresolved) {
+        const cands = (u.candidates ?? []).join('、');
+        console.error(`⚠ 人事条件「${u.label}」未匹配到搜索条件字段${cands ? `。相近字段候选: ${cands}` : ''}（可用 e9 hrm conditions 查看全部可用条件名）。`);
+    }
+    process.exit(1);
+}
+
+async function runHrm(args) {
+    const sub = args._[1] ?? 'search';
+    const cfg = loadConfig(flagStr(args, 'config'));
+    if (sub === 'tabs') {
+        const r = await getHrmTabs(cfg);
+        if (args.flags.json) {
+            console.log(JSON.stringify({ tabs: r.tabs }, null, 2));
+            return;
+        }
+        console.log('E9 人事搜索范围：');
+        if (r.tabs.length === 0) {
+            console.log('（无可用范围，可能无组织人事查看权限）');
+            return;
+        }
+        for (const t of r.tabs)
+            console.log(`  ${t.title}  (${t.typeid})`);
+        return;
+    }
+    if (sub === 'conditions') {
+        const tab = flagStr(args, 'tab') ?? '全部人员';
+        const mouldid = resolveHrmTab(tab);
+        const r = await getHrmConditions(cfg, { mouldid });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ tab, mouldid, groups: r.groups }, null, 2));
+            return;
+        }
+        console.log(`E9 人事搜索条件 [${tab}]：`);
+        if (r.groups.length === 0) {
+            console.log('（无可用条件）');
+            return;
+        }
+        for (const g of r.groups) {
+            console.log(`  ${g.title}：`);
+            for (const it of g.items)
+                console.log(`    - ${it.label}  (${it.domkey}${it.conditionType ? `, ${it.conditionType}` : ''})`);
+        }
+        return;
+    }
+    if (sub === 'tree') {
+        // 组织架构树：无参列顶层分部；--dept/--subcompany 定位到该组织后展开；--id（+可选 --type）直接指定起点；--depth 展示层数
+        const depth = Math.min(Math.max(Number(flagStr(args, 'depth') ?? '1') || 1, 1), 5);
+        const deptSpec = flagStr(args, 'dept');
+        const subSpec = flagStr(args, 'subcompany');
+        let start = { type: '0', id: '0' };
+        let located = null;
+        if (deptSpec || subSpec) {
+            const kw = deptSpec ?? subSpec;
+            const wantType = deptSpec ? '2' : '1';
+            const label = deptSpec ? '部门' : '分部';
+            if (/^\d+$/.test(kw)) {
+                located = { id: kw, type: wantType, name: kw };
+            }
+            else {
+                located = await findHrmOrgNode(cfg, kw, { matchType: wantType });
+                if (!located)
+                    throw new Error(`未找到${label}「${kw}」。可先跑 e9 hrm tree 查看顶层分部，或改用数字 id。`);
+            }
+            start = { type: located.type, id: located.id };
+        }
+        else if (flagStr(args, 'id')) {
+            start = { type: flagStr(args, 'type') ?? '1', id: flagStr(args, 'id') };
+        }
+        const r = await expandHrmOrgTree(cfg, { ...start, depth });
+        if (args.flags.json) {
+            console.log(JSON.stringify({ start, located, depth, nodes: r.nodes, total: r.total, truncated: r.truncated }, null, 2));
+            return;
+        }
+        console.log(located
+            ? `E9 组织架构 · ${located.name || located.id}（type=${start.type} id=${start.id}）`
+            : 'E9 组织架构 · 顶层分部');
+        if (!r.nodes.length) {
+            console.log('（无下级组织）');
+            return;
+        }
+        const render = (nodes, indent) => {
+            for (const n of nodes) {
+                const kind = n.type === '1' ? '分部' : n.type === '2' ? '部门' : `type=${n.type}`;
+                console.log(`${indent}${n.name}  [${kind} id=${n.id}]`);
+                if (n.children.length)
+                    render(n.children, indent + '  ');
+            }
+        };
+        render(r.nodes, '  ');
+        console.log(`\n共 ${r.total} 个组织节点${r.truncated ? '（已达显示上限，结果被截断）' : ''}。`);
+        return;
+    }
+    if (sub !== 'search') {
+        console.error(`hrm 子命令: tabs/conditions/search/tree，收到: ${sub}`);
+        process.exit(1);
+    }
+    const tab = flagStr(args, 'tab') ?? '全部人员';
+    const tabkey = resolveHrmTab(tab);
+    const page = Number(flagStr(args, 'page') ?? '1') || 1;
+    const allLevel = flagBool(args, 'all-level');
+    const name = flagStr(args, 'name');
+    const dept = flagStr(args, 'dept');
+    const subcompany = flagStr(args, 'subcompany');
+    const spec = flagStr(args, 'condition') ?? '';
+
+    const values = {};
+    // ★越权防护：按名过滤目标必须 ∈ {本人 + 全部层级下属}（与 subordinate/todo/cube 一致：默认停用 no-op）
+    if (name) {
+        await assertNamesInScope(cfg, [name], { domain: 'hrm' });
+        values.resourcename = name;
+    }
+    // --dept/--subcompany：数字直传 domkey；名称走组织树 BFS 定位（部门 type 2 / 分部 type 1）
+    if (dept)
+        values.departmentid = /^\d+$/.test(dept) ? dept : await resolveHrmOrgValue(cfg, dept, { matchType: '2', flag: '--dept' });
+    if (subcompany)
+        values.subcompanyid1 = /^\d+$/.test(subcompany) ? subcompany : await resolveHrmOrgValue(cfg, subcompany, { matchType: '1', flag: '--subcompany' });
+    // --condition 中文条件（label→domkey 自动映射）
+    const condRes = await resolveHrmCondition(cfg, { mouldid: tabkey, condition: spec });
+    if (condRes.unresolved.length)
+        printHrmConditionUnresolved(condRes.unresolved);
+    // ★越权防护（fail-closed）：无法确认是否按人过滤的条件 → 硬拒绝；策略未启用（默认）不拦，仅保留代码路径
+    if (isScopeEnforced() && condRes.unverifiablePerson)
+        throw new Error('拒绝越权查询：人事搜索条件无法确认是否按人过滤（条件定义读取失败或含未识别字段）。为防越权，本次查询已拒绝，请稍后重试或改用中文字段名。');
+    // ★越权防护：按人条件（姓名/直接上级/助理）目标必须 ∈ {本人 + 全部层级下属}
+    // assertNamesInScope 同时返回解析后的 uid（blog at-list 硬规则唯一入口）。
+    // ★E9 实测校准（2026-09-20 e9pc）：姓名=INPUT 认姓名文本；直接上级/助理=BROWSER 人字段认 **hrmresource id**
+    //   （=userid，本人 7111 验证 manager=7111 → 9 个直接下属；manager=杨文元sh → 0）。故 BROWSER 人字段值回填为 uid。
+    if (condRes.personConditions?.length) {
+        const resolvedIds = await assertNamesInScope(cfg, condRes.personConditions.map((p) => p.value), { domain: 'hrm' });
+        condRes.conditionValues = applyResolvedPersonIds(condRes.conditionValues, condRes.personConditions, resolvedIds);
+    }
+    Object.assign(values, condRes.conditionValues);
+    // ★E9 实测校准：--condition 里的 部门/分部 已由 resolveHrmCondition 重映射为 departmentid/subcompanyid1
+    //   （条件定义 domkey=department/subcompany 不是搜索接口认的参数）；名称值在此经组织树解析为 id（同 --dept/--subcompany 路径）。
+    for (const [key, matchType, label] of [['departmentid', '2', '部门'], ['subcompanyid1', '1', '分部']]) {
+        const raw = values[key];
+        if (raw != null && raw !== '' && !/^\d+$/.test(String(raw)))
+            values[key] = await resolveHrmOrgValue(cfg, String(raw), { matchType, flag: `--condition "${label}=${raw}"` });
+    }
+
+    const r = await hrmList(cfg, { tabkey, values, showAllLevel: allLevel, page });
+    const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    if (args.flags.raw) {
+        console.error('===== RAW getHrmSearchResult =====');
+        console.error(JSON.stringify(r.raw.search, 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({
+            tab, tabkey, page,
+            pageSize: r.pageSize, total: r.total, count: r.count,
+            sessionkey: r.sessionkey,
+            columns: r.columns.map((c) => ({ dataIndex: c.dataIndex, title: c.title })),
+            items: r.items.map((it) => withLink('hrm', { id: it.id, name: it.name, fields: it.fields.reduce((acc, f) => { acc[f.dataIndex] = f.value; return acc; }, {}) }, base)),
+        }, null, 2));
+        return;
+    }
+    console.log(`E9 人事 [${tab}]${allLevel ? '（含子部门）' : ''}  第 ${page} 页${r.pageSize != null ? ` · 每页 ${r.pageSize} 条` : ''}${r.total != null ? ` / 共 ${r.total} 人` : ''}  当前 ${r.count} 人`);
+    if (r.count === 0) {
+        console.log('（无匹配人员）');
+        return;
+    }
+    const cols = (r.columns || []).filter((c) => c.dataIndex && !['id', 'randomField0', 'randomFieldId'].includes(c.dataIndex));
+    if (cols.length)
+        console.log(`字段(${cols.length}): ${cols.map((c) => c.title ?? c.dataIndex).join(' | ')}`);
+    for (let i = 0; i < r.items.length; i++) {
+        const it = r.items[i];
+        const head = hyperlinkFor('hrm', it, base, it.name || '(无姓名)');
+        console.log(`${i + 1}. ${head}  [id=${it.id || ''}]`);
+        // 行 meta 去掉姓名（head 已显示）与 id 类列，避免重复；字典编码字段标注「（编码）」
+        const meta = it.fields
+            .filter((f) => !['lastname', 'id', 'randomField0', 'randomFieldId'].includes(f.dataIndex))
+            .slice(0, 8)
+            .map((f) => `${f.title}=${f.value}${f.value && HRM_CODE_FIELDS.has(f.dataIndex) ? '（编码）' : ''}`)
+            .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++) {
@@ -3873,6 +4106,7 @@ async function runReport(args) {
         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) {
@@ -3882,7 +4116,7 @@ async function main() {
     const cmd = args._[0] ?? 'todo';
     if (cmd === 'version') {
         const buildHash = createHash('sha256').update(fs.readFileSync(new URL(import.meta.url))).digest('hex').slice(0, 12);
-        console.log(JSON.stringify({ name: 'weaver-e9-assistant-cli', version: '1.1.2', buildHash }, null, 2));
+        console.log(JSON.stringify({ name: 'weaver-e9-assistant-cli', version: '1.1.4', buildHash }, null, 2));
         return;
     }
     if (cmd === 'whoami') {
@@ -3941,6 +4175,10 @@ async function main() {
         await runSubordinate(args);
         return;
     }
+    if (cmd === 'hrm') {
+        await runHrm(args);
+        return;
+    }
     if (cmd !== 'todo') {
         console.error(`未知命令: ${cmd}\n\n${usage()}`);
         process.exit(1);
@@ -4086,33 +4324,37 @@ async function main() {
         debug: queryBool('debug'),
         excludeCreatorId,
     };
-    // 默认概览优先展示“我需要做什么”，而不是把转发和关注与待处理混在数千条列表里。
-    const shouldGroup = category === 'todo' && !listOpts.subCategory && !tab && !listOpts.totalOnly && !queryBool('ungrouped') && !queryBool('raw');
+    // 默认按 OA 二级分类（流程中心页签）分组展示——待办/已办/我发起通用；只列有数据的分类。
+    const shouldGroup = !listOpts.subCategory && !tab && !listOpts.totalOnly && !queryBool('ungrouped') && !queryBool('raw');
     if (shouldGroup) {
-        const grouped = await getSmartTodoGroups(cfg, listOpts);
+        const grouped = await getOaTabGroups(cfg, { ...listOpts, category });
+        const scope = CATEGORY_SCOPE[category] ?? CATEGORY_SCOPE.todo;
         const groupedSnapshot = {
-            actionTotal: grouped.actionTotal,
+            category,
             categoryTotals: grouped.categoryTotals,
             categoryTotalSum: grouped.categoryTotalSum,
             page: grouped.page,
             groups: grouped.groups.map((group) => ({
-                key: group.key,
+                viewcondition: group.viewcondition,
                 title: group.title,
-                total: group.result.total,
+                total: group.total,
                 items: group.items,
                 raw: group.result.raw,
             })),
         };
-        const savedGroupedResult = persistSearchResult(groupedSnapshot, 'E9 待办智能概览');
+        const savedGroupedResult = persistSearchResult(groupedSnapshot, `E9 ${scope.pageTitle}分类概览`);
+        const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
         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));
+            console.log(JSON.stringify({ category, page: grouped.page, categoryTotals: grouped.categoryTotals, groups: grouped.groups.map((g) => ({ viewcondition: g.viewcondition, title: g.title, total: g.total, items: g.items.map((item) => withLink('todo', item, base)) })) }, null, 2));
             return;
         }
-        const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
-        console.log('E9 待办智能概览（按处理方式分组，避免重复提醒）');
+        if (!grouped.groups.length) {
+            console.log(`E9 ${scope.pageTitle}：各分类均无数据。`);
+            return;
+        }
+        console.log(`E9 ${scope.pageTitle}（按 OA 分类页签分组，只列有数据的分类）`);
         for (const group of grouped.groups) {
-            console.log(`\n### ${group.title}（共 ${group.result.total ?? '?'} 条，第 ${group.result.page} 页显示前 10 条）`);
+            console.log(`\n### ${group.title}（共 ${group.total ?? '?'} 条，第 ${group.result.page} 页显示前 10 条）`);
             if (group.items.length)
                 printTodoItems(group.items, base);
             else

package/dist/cube.js

@@ -1161,6 +1161,25 @@ function scanChangeValue(obj) {
  * opts: { modeId, formId, billid?, values:{id:value}, files:[{fieldId,filePath}], trigger?, pageexpandid?, cf? }
  *  ⚠ 必须全程 cookie 鉴权（layoutBase + doSubmit 同 session），否则 doSubmit 返 repeat。
  */
+/**
+ * ★字段属性硬规则：只读字段（isedit=false）禁止由用户/助手填值——不得绕过卡片字段属性自行填值。
+ * 返回被违规填值的只读字段清单（空数组 = 无违规）。
+ */
+export function findNonEditableCardFields(fields, values) {
+    return (fields ?? []).filter((f) => {
+        if (f.isedit)
+            return false; // 可编辑字段允许填
+        const id = String(f.id);
+        return values?.[id] !== undefined || values?.[`field${id}`] !== undefined;
+    });
+}
+/** 只读字段被填值 → 硬拒绝。 */
+export function assertEditableCardValues(fields, values) {
+    const bad = findNonEditableCardFields(fields, values);
+    if (bad.length)
+        throw new Error(`拒绝填写只读字段：${bad.map((f) => `${f.label ?? f.name ?? f.id}`).join('、')}。台账卡片只允许填写「可编辑」字段，不得绕过字段属性自行填值。`);
+}
+
 export async function submitCubeCard(cfg, opts = {}) {
     const ep = endpointFor(cfg);
     const cookie = ep.cookie;
@@ -1170,6 +1189,12 @@ export async function submitCubeCard(cfg, opts = {}) {
     const iscreate = billid ? '0' : '1';
     const cf = opts.cf ?? await getCardFields(cfg, { modeId, formId, billid });
     const { layoutid, cardToken, _key, uuid, fields } = cf;
+    // ★字段属性硬规则：只读字段禁止填值。判据取「新建态」字段定义——带 billid 时 cf 是查看态，
+    //   查看态字段 isedit 恒为 false（全部只读），不能作为可编辑性判据。
+    const defFields = billid ? (await getCardFields(cfg, { modeId, formId })).fields : fields;
+    assertEditableCardValues(defFields, opts.values);
+    if (opts.files?.length)
+        assertEditableCardValues(defFields, Object.fromEntries(opts.files.map((f) => [String(f.fieldId), '1'])));
     const t = String(Date.now());
     const cq = (o = {}) => ({ type: '1', modeId, formId, guid: 'card', t, _key, uuid, billid, ...o });
     // ① 卡片打开链路（cookie，同 session）
@@ -1242,6 +1267,12 @@ export async function previewCubeCard(cfg, opts = {}) {
     const values = { ...(opts.values ?? {}) };
     // 附件：只记录清单（dry-run 不上传），预览提示"--yes 时上传"
     const files = (opts.files ?? []).map((f) => ({ fieldId: String(f.fieldId), filePath: f.filePath }));
+    // ★字段属性硬规则：只读字段禁止填值——dry-run 也要拦，避免「预览通过、提交才报错」。
+    //   判据取「新建态」字段定义（billid 时 fields 是查看态，全为只读，不能作判据）。
+    const defFields = billid ? (await getCardFields(cfg, { modeId, formId })).fields : fields;
+    assertEditableCardValues(defFields, opts.values);
+    if (files.length)
+        assertEditableCardValues(defFields, Object.fromEntries(files.map((f) => [f.fieldId, '1'])));
     // 联动解析（真实接口、无写副作用；失败不阻断——resolveCubeLinkage 内部 catch 返回原 values）
     let linked = [];
     if (opts.trigger === undefined) {

package/dist/hrm.js

@@ -0,0 +1,478 @@
+/**
+ * 组织人事（HRM）—— 人事搜索：按搜索条件查员工，返回人事档案 + 详情卡片超链接。
+ *
+ * 链路（用户抓包实证，HAR：capture/人事抓包.har）：
+ *   1) GET  /api/hrm/search/getHrmSearchMoudleList          → tabs（全部人员 default_3 / 同部门 default_1 / 我的下属 default_2）
+ *   2) GET  /api/hrm/search/getHrmSearchCondition?mouldid=X → 搜索条件 label→domkey（default_3=23 个 / default_1=21 / default_2=22）
+ *   3) POST /api/hrm/search/getHrmSearchResult  body{tabkey,showAllLevel,virtualtype,...} → sessionkey（恒顶层）
+ *   4) POST /api/ec/dev/table/datas             body{dataKey=sessionkey,current,sortParams} → columns(32 列) + datas
+ *   5) POST /api/ec/dev/table/counts            body{dataKey} → {count:N, status:true}
+ *   6) GET  /api/hrm/base/getHrmSearchTree      组织树（type=0 顶层分部 / type=1 分部→子分部+部门 / type=2 部门→子部门）
+ *
+ * 详情卡片链接（真机验证通过）：
+ *   {base}/spa/hrm/index_mobx.html#/main/hrm/card/cardInfo/<hrmresource.id>
+ *   resourceId 取自 randomField0/randomFieldId（与 id 列同值，但 id 列标题是「是否在线」，不作为主键）。
+ *
+ * 越权防护（与全局一致，见 cube/subordinate）：
+ *   按人条件（姓名/直接上级/助理）由调用方 assertNamesInScope 校验——目标必须 ∈ {本人 + 全部层级下属}；
+ *   E9_SCOPE_ENFORCE=1 时才硬拦截，默认停用（不拦截，代码路径保留）。
+ *   部门/分部是组织结构过滤，不涉及具体个人，不做按人校验。
+ */
+import { createApiFromProfile } from './client.js';
+import { extractDataKey, extractRows, extractColumns, extractTotal, pickByPaths, stripHtml } from './parse.js';
+
+// ─── Tab 定义 ────────────────────────────────────────────
+
+/** 人事搜索 Tab：中文名/别名 → tabkey（抓包实证 getHrmSearchMoudleList）。 */
+export const HRM_TABS = {
+    '全部人员': 'default_3',
+    '全部': 'default_3',
+    'all': 'default_3',
+    '同部门': 'default_1',
+    'dept': 'default_1',
+    '我的下属': 'default_2',
+    '下属': 'default_2',
+    'subordinate': 'default_2',
+};
+
+/** Tab 名/别名/tabkey → tabkey；未知原样透传（交服务端判定），空则默认全部人员。 */
+export function resolveHrmTab(tab) {
+    const t = String(tab ?? '').trim();
+    if (HRM_TABS[t])
+        return HRM_TABS[t];
+    return t || 'default_3';
+}
+
+// ─── 按人条件判定（越权校验用） ──────────────────────────
+
+/** 明确排除的非人字段：联系方式/日期时间/计数单位（与 cube.js 一致）。 */
+const HRM_NON_PERSON_LABEL = /电话|手机|邮箱|号码|传真|日期|时间|区间|人数|人次|人天/;
+/** 明确的人员白名单（人事域：姓名/直接上级/助理 + 通用称谓）。 */
+const HRM_PERSON_LABEL = /^(姓名|直接上级|直属上级|助理|上级|下属|人员|联系人|领导)$/u;
+/** 人员后缀判据：X人/X人员/X员/X者（报销人/值班人员/采购员…）。 */
+const HRM_PERSON_SUFFIX = /[人者员]$/u;
+
+/** 该条件 label 是否「按人过滤」（fail-closed：宁可多拦）。 */
+export function isHrmPersonCondition(label) {
+    if (typeof label !== 'string' || !label.trim())
+        return false;
+    const l = label.trim();
+    if (HRM_NON_PERSON_LABEL.test(l))
+        return false;
+    if (HRM_PERSON_SUFFIX.test(l))
+        return true;
+    return HRM_PERSON_LABEL.test(l);
+}
+
+// ─── 链路 1/2：Tab 与条件定义 ────────────────────────────
+
+/** 人事搜索 Tab 列表。GET /api/hrm/search/getHrmSearchMoudleList。 */
+export async function getHrmTabs(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/hrm/search/getHrmSearchMoudleList', { virtualtype: opts.virtualtype ?? '' });
+    const j = r?.json ?? {};
+    const tabs = (j.tabs || []).map((t) => ({
+        typeid: t.typeid,
+        title: t.title,
+        editable: !!t.editable,
+    }));
+    return { tabs, raw: j };
+}
+
+/** 指定 Tab 的搜索条件定义。GET /api/hrm/search/getHrmSearchCondition?mouldid=<tabkey>。 */
+export async function getHrmConditions(cfg, { mouldid = 'default_3' } = {}) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/hrm/search/getHrmSearchCondition', { mouldid: String(mouldid) });
+    const j = r?.json ?? {};
+    const groups = (j.condition || []).map((g) => ({
+        title: g.title,
+        items: (g.items || []).map((it) => ({
+            label: it.label,
+            domkey: Array.isArray(it.domkey) ? it.domkey[0] : (typeof it.domkey === 'string' ? it.domkey : null),
+            conditionType: it.conditionType,
+        })).filter((it) => it.label),
+    })).filter((g) => g.items.length);
+    // 扁平 items（供 label→domkey 映射 / 按人分类）
+    const items = groups.flatMap((g) => g.items);
+    return { groups, items, raw: j };
+}
+
+// ─── 条件解析（--condition "岗位=经理;性别=男"） ──────────
+
+/** 条件定义 domkey → 真实搜索参数：部门/分部是 BROWSER 占位 domkey（department/subcompany），
+ *  搜索接口实际认 departmentid/subcompanyid1（2026-09-20 e9pc 抓包实证 subcompanyid1=80、departmentid=850）。 */
+export const HRM_ORG_DOMKEY_REMAP = { department: 'departmentid', subcompany: 'subcompanyid1' };
+
+/** BROWSER 人字段 domkey：值须为 hrmresource id（=userid），不认姓名文本（2026-09-20 e9pc 实测）。
+ *  姓名(INPUT)认姓名文本，不在此列。 */
+export const HRM_BROWSER_PERSON_DOMKEYS = new Set(['manager', 'assistant']);
+
+/**
+ * ★E9 实测校准（2026-09-20 e9pc）：直接把 manager/助理 的姓名文本传给搜索接口会 0 结果，
+ * 必须先经 assertNamesInScope 解析为 uid（=hrmresource id）再回填。本函数按位把解析结果
+ * 替换到 BROWSER 人字段值上（姓名 INPUT 字段如 resourcename 保持姓名文本不动）。
+ *
+ * @param conditionValues resolveHrmCondition 产出的 {domkey:value}（domkey 已归一为搜索接口认的键）
+ * @param personConditions resolveHrmCondition 产出的按人条件 [{label, domkey, value}]（与 resolvedIds 按位对应）
+ * @param resolvedIds assertNamesInScope 的返回值：单个 uid 或 uid 数组
+ * @param browserDomkeys 需替换为 id 的 BROWSER 人字段 domkey 集合（默认 manager/assistant）
+ * @returns 新 conditionValues（不修改入参）
+ */
+export function applyResolvedPersonIds(conditionValues, personConditions, resolvedIds, browserDomkeys = HRM_BROWSER_PERSON_DOMKEYS) {
+    const values = { ...(conditionValues ?? {}) };
+    const idArr = Array.isArray(resolvedIds) ? resolvedIds : [resolvedIds];
+    const idOf = new Map();
+    (personConditions ?? []).forEach((p, i) => {
+        if (p && idArr[i] != null && String(idArr[i]).trim())
+            idOf.set(p.value, String(idArr[i]));
+    });
+    for (const [k, v] of Object.entries(values))
+        if (browserDomkeys.has(k) && idOf.has(v))
+            values[k] = idOf.get(v);
+    return values;
+}
+
+/** 解析条件串：分号分段、每段取首个 = 为键值。 */
+export function parseHrmConditionPairs(spec) {
+    const pairs = [];
+    for (const seg of String(spec ?? '').split(';')) {
+        const kv = seg.trim();
+        if (!kv)
+            continue;
+        const i = kv.indexOf('=');
+        if (i > 0)
+            pairs.push([kv.slice(0, i).trim(), kv.slice(i + 1).trim()]);
+    }
+    return pairs;
+}
+
+/**
+ * ★越权防护 人员条件分类（纯函数，便于单测）。
+ * condItems：getHrmConditions 返回的扁平条件项 [{label, domkey, conditionType}]。
+ * rawPairs：[[键,值],...]（键可能是 domkey 或中文 label）。
+ * 返回 [{label, domkey, value}]——命中按人白名单的键值对。
+ */
+export function classifyHrmPersonConditions(condItems, rawPairs) {
+    if (!Array.isArray(rawPairs) || rawPairs.length === 0)
+        return [];
+    const domToLabel = {};
+    for (const it of condItems || [])
+        if (it.label && it.domkey && !(it.domkey in domToLabel))
+            domToLabel[it.domkey] = it.label;
+    const labels = new Set((condItems || []).map((it) => it.label).filter(Boolean));
+    const personConditions = [];
+    for (const [k, v] of rawPairs) {
+        const key = String(k ?? '').trim();
+        const val = String(v ?? '').trim();
+        if (!key || !val)
+            continue;
+        // con_/dom_/field/col 前缀键剥前缀反查（dom_manager → manager → 直接上级），堵前缀直传绕过按人校验。
+        const prefix = /^(con|dom|field|col)[-_]?/i.exec(key);
+        const plain = prefix ? key.slice(prefix[0].length) : key;
+        const label = domToLabel[plain] ?? domToLabel[key] ?? (labels.has(key) ? key : (labels.has(plain) ? plain : null));
+        // 后缀启发式直接判按键名（即使条件定义缺失也能拦「报销人=王五」）；
+        // domkey 依赖 domToLabel 反查；两者皆无则落到 unverifiablePerson 由调用方 fail-closed 拒绝。
+        if (isHrmPersonCondition(label ?? key))
+            personConditions.push({ label: label ?? key, domkey: key, value: val });
+    }
+    return personConditions;
+}
+
+/**
+ * ★新 条件字符串 → conditionValues 映射。
+ *
+ * 输入 `--condition` 原始串，自动识别（E9 hrm 搜索接口原生认 plain domkey，如 manager=李四）：
+ *   - 键以 con_/dom_/field/col 开头 → 剥前缀后是已知 domkey 则用 plain domkey（dom_manager→manager），
+ *     否则原样透传（向后兼容，交 unverifiablePerson fail-closed 兜底）；
+ *   - plain domkey（在条件定义中）→ 原样直传（E9 原生形式）；
+ *   - 其它 → 中文 label，用 getHrmConditions 的 label→domkey 自动转换；
+ *     未匹配时返回 unresolved（含候选 label），由调用方报错提示，不静默放空。
+ * ★越权防护（1.1.x）：只要传了条件就取一次条件定义——含 domkey 直传也要反查 label 分类。
+ * 返回 { conditionValues, unresolved:[{label,candidates}], unverifiablePerson, personConditions }。
+ */
+export async function resolveHrmCondition(cfg, { mouldid = 'default_3', condition = '' } = {}) {
+    const rawStr = String(condition ?? '');
+    const pairs = parseHrmConditionPairs(rawStr);
+    const conditionValues = {};
+    if (pairs.length === 0)
+        return { conditionValues, unresolved: [], unverifiablePerson: false, personConditions: [] };
+    let condItems = [];
+    let condFetched = false;
+    try {
+        const cond = await getHrmConditions(cfg, { mouldid });
+        condItems = cond.items;
+        condFetched = true;
+    }
+    catch {
+        // fail-closed：定义读不到时 domkey 无法反查 → 下方 unverifiablePerson 拒绝；中文 label 按名称判定不受影响
+        if (pairs.some(([k]) => /^(con|dom|field|col)[-_]?/i.test(String(k))))
+            process.stderr.write('⚠ 无法读取人事搜索条件定义：domkey 类条件将被拒绝（无法确认是否按人过滤），中文字段名条件按名称判定。\n');
+    }
+    const labelToDom = {};
+    for (const it of condItems)
+        if (it.label && it.domkey && !(it.label in labelToDom))
+            labelToDom[it.label] = it.domkey;
+    const knownDom = new Set(condItems.map((it) => it.domkey).filter(Boolean));
+    const unresolved = [];
+    for (const [k, v] of pairs) {
+        const key = String(k).trim();
+        if (!key)
+            continue;
+        const prefix = /^(con|dom|field|col)[-_]?/i.exec(key);
+        if (prefix) {
+            // 剥前缀后用 E9 认的 plain domkey（如 dom_manager→manager）；未知前缀键原样透传
+            const plain = key.slice(prefix[0].length);
+            conditionValues[knownDom.has(plain) ? plain : key] = v;
+            continue;
+        }
+        if (labelToDom[key] !== undefined) {
+            conditionValues[labelToDom[key]] = v;
+            continue;
+        }
+        if (knownDom.has(key)) {
+            conditionValues[key] = v;   // plain domkey 直传（E9 hrm 搜索接口原生认的形式）
+            continue;
+        }
+        if (!condFetched) {
+            // 条件定义接口失败（网络抖动/无权限）：按原样透传，不阻断（用户可能直接给了 domkey）——但已打越权警告
+            conditionValues[key] = v;
+            continue;
+        }
+        const candidates = Object.keys(labelToDom).filter((l) => l.includes(key) || key.includes(l)).slice(0, 8);
+        unresolved.push({ label: key, candidates });
+    }
+    // ★越权防护（fail-closed）：无法确认是否按人过滤的条件 → 调用方硬拒绝。
+    //   前缀键剥前缀后仍不在条件定义中 / 定义读取失败 → 无法确认；中文 label 与已知 plain domkey 可经分类判定。
+    let unverifiablePerson = false;
+    for (const [k, v] of pairs) {
+        const key = String(k).trim();
+        if (!key || !String(v ?? '').trim())
+            continue;
+        const prefix = /^(con|dom|field|col)[-_]?/i.exec(key);
+        if (prefix) {
+            const plain = key.slice(prefix[0].length);
+            if (!knownDom.has(plain))
+                unverifiablePerson = true;
+        }
+    }
+    const personConditions = classifyHrmPersonConditions(condItems, pairs);
+    // ★E9 实测校准（2026-09-20，e9pc 抓包）：条件定义里 部门→department / 分部→subcompany 只是 UI 占位 domkey，
+    // 真实搜索接口认 departmentid / subcompanyid1（HAR 实证 subcompanyid1=80、departmentid=850）。
+    // 重映射这两个条件键为真实搜索参数；名称值由调用方 resolveHrmOrgValue 解析为 id。
+    for (const [src, dst] of Object.entries(HRM_ORG_DOMKEY_REMAP))
+        if (src in conditionValues && !(dst in conditionValues)) {
+            conditionValues[dst] = conditionValues[src];
+            delete conditionValues[src];
+        }
+    return { conditionValues, unresolved, unverifiablePerson, personConditions };
+}
+
+// ─── 链路 3/4/5：搜索 → sessionkey → 表数据 → 总数 ───────
+
+/** 发起人事搜索。POST /api/hrm/search/getHrmSearchResult，body 表单编码，返回 sessionkey（恒顶层）。 */
+export async function hrmSearch(cfg, { tabkey = 'default_3', values = {}, showAllLevel = false } = {}) {
+    const api = await createApiFromProfile(cfg);
+    const body = {
+        tabkey: String(tabkey),
+        showAllLevel: showAllLevel ? '1' : '0',
+        virtualtype: '',
+        ...(values ?? {}),
+    };
+    let r = await api.post('/api/hrm/search/getHrmSearchResult', body);
+    let sessionkey = extractDataKey(r?.json);
+    if (!sessionkey && cfg.cookie) {
+        // token no-op 逃生：200 但无 sessionkey 且配了 cookie → 强制 cookie 重试一次
+        r = await api.post('/api/hrm/search/getHrmSearchResult', body, { forceCookie: true });
+        sessionkey = extractDataKey(r?.json);
+    }
+    if (!sessionkey) {
+        throw new Error('未能从 getHrmSearchResult 响应中提取 sessionkey。\n' + `响应(前300字): ${truncate(r?.text)}`);
+    }
+    return { sessionkey, raw: r?.json ?? null };
+}
+
+/** 拉一页人事搜索结果。POST /api/ec/dev/table/datas。 */
+export async function fetchHrmSearchTable(cfg, sessionkey, page) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/ec/dev/table/datas', {
+        dataKey: sessionkey,
+        current: String(page),
+        sortParams: '[]',
+    });
+    const j = r?.json ?? {};
+    return { rows: extractRows(j), columns: extractColumns(j), raw: j };
+}
+
+/** 人事搜索总数。POST /api/ec/dev/table/counts。 */
+export async function fetchHrmSearchCount(cfg, sessionkey) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/ec/dev/table/counts', { dataKey: sessionkey });
+    return { total: extractTotal(r?.json), raw: r?.json ?? null };
+}
+
+// ─── 行归一化 + 详情卡片链接 ─────────────────────────────
+
+/**
+ * 找人事行 resourceId：randomField0/randomFieldId（抓包三值与 id 列同值；
+ * 但 id 列标题是「是否在线」，不作为主键，避免语义混用）。
+ */
+function pickHrmRowId(row) {
+    for (const key of ['randomField0', 'randomFieldId']) {
+        const raw = pickByPaths(row, [key]);
+        if (raw != null && String(raw).trim())
+            return stripHtml(raw);
+    }
+    return '';
+}
+
+/** 归一化一行人事档案：id(resourceId) + name + 全部字段（<field>span 优先去 HTML）。 */
+export function normalizeHrmRow(row, columns) {
+    if (!row || typeof row !== 'object')
+        return {};
+    const get = (k) => pickByPaths(row, [k]);
+    const id = pickHrmRowId(row);
+    const name = stripHtml(get('lastnamespan') ?? get('lastname'));
+    const fields = (columns || []).map((c) => ({
+        dataIndex: c.dataIndex,
+        title: c.title ?? c.dataIndex,
+        value: stripHtml(get(`${c.dataIndex}span`) ?? get(c.dataIndex)),
+    })).filter((f) => f.value !== '');
+    return { id, name, fields, raw: row };
+}
+
+/** 详情卡片 URL（真机验证通过）：{base}/spa/hrm/index_mobx.html#/main/hrm/card/cardInfo/<resourceId> */
+export function buildHrmCardUrl(baseUrl, resourceId) {
+    if (resourceId == null || String(resourceId).trim() === '')
+        return '';
+    const b = String(baseUrl ?? '').replace(/\/+$/, '');
+    return `${b}/spa/hrm/index_mobx.html#/main/hrm/card/cardInfo/${String(resourceId).trim()}`;
+}
+
+// ─── 组织树（--dept/--subcompany 按名定位） ───────────────
+
+/** 组织树节点拉取。GET /api/hrm/base/getHrmSearchTree。
+ *  param 说明（抓包实证）：type=0&id=0 → 顶层分部(type 1)；type=1&id=<分部> → 子分部+部门；type=2&id=<部门> → 子部门。 */
+export async function getHrmSearchTree(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const params = {
+        keyword: opts.keyword ?? '',
+        virtualCompanyid: opts.virtualCompanyid ?? '1',
+        isLoadSubDepartment: opts.isLoadSubDepartment ?? '1',
+    };
+    if (opts.type != null)
+        params.type = String(opts.type);
+    if (opts.id != null)
+        params.id = String(opts.id);
+    if (opts.isVirtual != null)
+        params.isVirtual = String(opts.isVirtual);
+    const r = await api.get('/api/hrm/base/getHrmSearchTree', params);
+    const j = r?.json ?? {};
+    const companys = (j.companys || []).map((c) => ({
+        id: String(c.companyid ?? ''),
+        name: c.name,
+        isVirtual: String(c.isVirtual ?? ''),
+        isParent: !!c.isParent,
+    }));
+    const datas = (j.datas || []).map((d) => ({
+        id: String(d.id ?? ''),
+        pid: String(d.pid ?? ''),
+        name: d.name,
+        isParent: !!d.isParent,
+        type: String(d.type ?? ''),
+        isVirtual: String(d.isVirtual ?? ''),
+    }));
+    return { companys, datas, raw: j };
+}
+
+/**
+ * 在组织树中按名定位节点（BFS，逐层拉取）。
+ * matchType：限定节点类型（'1'=分部 / '2'=部门；null=任意）。
+ * 返回匹配节点 {id, name, type, pid} 或 null；maxDepth 防失控。
+ */
+export async function findHrmOrgNode(cfg, keyword, { matchType = null, maxDepth = 6 } = {}) {
+    const kw = String(keyword ?? '').trim();
+    if (!kw)
+        return null;
+    const top = await getHrmSearchTree(cfg, { type: '0', id: '0', isVirtual: '0' });
+    const queue = top.datas.map((d) => ({ ...d, depth: 0 }));
+    while (queue.length) {
+        const node = queue.shift();
+        if (node.name === kw && (!matchType || node.type === matchType))
+            return node;
+        if (!node.isParent || node.depth >= maxDepth)
+            continue;
+        try {
+            const children = await getHrmSearchTree(cfg, { type: node.type, id: node.id, isVirtual: node.isVirtual });
+            for (const c of children.datas)
+                queue.push({ ...c, depth: node.depth + 1 });
+        }
+        catch { /* 子树拉取失败跳过该分支（同名节点仍可能在后继队列命中） */ }
+    }
+    return null;
+}
+
+/**
+ * 递归展开组织树（供 `e9 hrm tree` 用）。
+ * 起点 (type,id)：'0'/'0' = 顶层分部；'1'/<分部id> = 子分部+部门；'2'/<部门id> = 子部门。
+ * depth = 展示层数（1 = 只列起点下一层）；maxNodes 防失控（超限截断，调用方须提示）。
+ */
+export async function expandHrmOrgTree(cfg, { type = '0', id = '0', depth = 1, maxNodes = 500 } = {}) {
+    let count = 0;
+    let truncated = false;
+    async function walk(t, i, levels) {
+        if (levels < 1)
+            return [];
+        const r = await getHrmSearchTree(cfg, { type: t, id: i });
+        const out = [];
+        for (const n of r.datas) {
+            if (count >= maxNodes) {
+                truncated = true;
+                break;
+            }
+            count++;
+            const node = { id: n.id, name: n.name, type: n.type, isParent: n.isParent, children: [] };
+            if (n.isParent && levels > 1)
+                node.children = await walk(n.type, n.id, levels - 1);
+            out.push(node);
+        }
+        return out;
+    }
+    const nodes = await walk(type, id, depth);
+    return { nodes, total: count, truncated };
+}
+
+// ─── 编排：完整搜索 ──────────────────────────────────────
+
+/**
+ * 人事搜索编排：tab + 条件 → sessionkey → 分页数据 + 总数。
+ * opts: { tabkey, values:{domkey:value}, showAllLevel, page }。
+ */
+export async function hrmList(cfg, opts = {}) {
+    const tabkey = opts.tabkey ?? 'default_3';
+    const page = Number(opts.page ?? '1') || 1;
+    const values = { ...(opts.values ?? {}) };
+    const { sessionkey, raw: searchRaw } = await hrmSearch(cfg, { tabkey, values, showAllLevel: !!opts.showAllLevel });
+    const data = await fetchHrmSearchTable(cfg, sessionkey, page);
+    const count = await fetchHrmSearchCount(cfg, sessionkey);
+    const total = count.total ?? null;
+    const items = data.rows.map((row) => normalizeHrmRow(row, data.columns));
+    return {
+        tabkey,
+        page,
+        pageSize: data.rows.length || null,
+        total,
+        count: items.length,
+        sessionkey,
+        columns: data.columns,
+        items,
+        raw: { search: searchRaw, datas: data.raw, counts: count.raw },
+    };
+}
+
+// ─── 工具 ────────────────────────────────────────────────
+
+function truncate(s, n = 300) {
+    if (s == null)
+        return '(空)';
+    return String(s).length > n ? String(s).slice(0, n) + '…(已截断)' : String(s);
+}

package/dist/parse.js

@@ -113,6 +113,20 @@ export function stripHtml(s) {
         .replace(/'/g, "'");
     return str.trim();
 }
+/**
+ * 从 requestnamespan 提取可见标题。
+ * OA 把标题放进第一个 `<a>`（模板前缀如「[退回]」也在 `<a>` 内），把「我的关注」等状态标签
+ * 以独立 `<div class='wf_attention_div_btn'>` 追加在 `<a>` 之后——整体去标签会把标签文字并进标题
+ * （实测「我的关注」页签的标题被渲染成「采购审批4-... 我的关注」）。
+ * 故优先只取第一个 `<a>` 的文本；无 `<a>` 时回退整体去标签。
+ */
+function extractTitleFromNamespan(html) {
+    const s = String(html ?? '');
+    if (!s)
+        return '';
+    const m = s.match(/<a\b[^>]*>([\s\S]*?)<\/a>/i);
+    return stripHtml(m ? m[1] : s);
+}
 const LEVEL_LABEL = {
     '0': '一般',
     '1': '重要',
@@ -131,7 +145,7 @@ export function normalizeRow(row, columns) {
     const spanOr = (dataIndex, extraKeys = []) => stripHtml(get([`${dataIndex}span`, dataIndex, ...extraKeys]));
     // requestnamespan 是 OA 已按管理员模板渲染的可见标题；原始 requestname 仅作回退。
     const rawTitle = stringify(get(['requestname', 'requestName']));
-    const title = stripHtml(get(['requestnamespan'])) || rawTitle;
+    const title = extractTitleFromNamespan(get(['requestnamespan'])) || rawTitle;
     const levelRaw = stringify(get(['requestlevel', 'level'])) ?? '';
     const level = levelRaw ? (LEVEL_LABEL[levelRaw] ?? levelRaw) : undefined;
     const creatorIdRaw = get(['createrid', 'creatorid', 'creatorId', 'creater']);

package/dist/subordinate.js

@@ -116,7 +116,7 @@ export function normalizeSubordinateRow(row, columns) {
         title: c.title,
         value: stripHtml(get(`${c.dataIndex}span`) ?? get(c.dataIndex)),
     }));
-    return { id, name, fields, raw: row };
+    return { id, name, fields, idCol: idCol?.dataIndex, nameCol: nameCol?.dataIndex, raw: row };
 }
 
 /**

package/dist/wfstart.js

@@ -431,10 +431,42 @@ async function resolveFieldLinkages(cfg, workflowId, f, merged) {
  *   明细浏览框字段解析并提交 id 与 name；确认后由提交计划冻结，避免二次解析漂移。
  * 返回 E9Response（成功通常含 requestid）。
  */
+/**
+ * ★字段属性硬规则：只允许填写「可编辑」(viewattr=1) 的字段。
+ * 只读(2)/隐藏(3) 字段**禁止**由用户/助手填值——不得绕过表单字段属性自行填值。
+ * 明细表字段同样按 viewattr 判定。无属性信息(viewattr 缺失)不拦，交给后端判定，避免误伤。
+ */
+export function findNonEditableFields(form, values, details = []) {
+    const byId = new Map();
+    for (const table of form?.tables ?? []) {
+        for (const fld of table.fields ?? [])
+            byId.set(String(fld.id), fld);
+    }
+    const bad = [];
+    const checkId = (rawId) => {
+        const id = String(rawId ?? '').replace(/^field/, '');
+        const fld = byId.get(id);
+        if (!fld || fld.viewattr == null || fld.viewattr === 1)
+            return;
+        bad.push({ id, label: fld.label, viewattr: fld.viewattr });
+    };
+    for (const k of Object.keys(values ?? {}))
+        checkId(k);
+    for (const d of details ?? [])
+        for (const row of d?.rows ?? [])
+            for (const k of Object.keys(row ?? {}))
+                checkId(k);
+    return bad;
+}
+
 export async function prepareCreateSubmission(cfg, workflowId, values, requestname, details = []) {
     const f = await describeFormFields(cfg, workflowId);
     if (f.verifyRight === false)
         throw new Error('无权限（verifyRight:false），跑 e9 auth token-login');
+    // ★字段属性硬规则：只读/隐藏字段禁止填值（不得绕过字段属性自行填值）
+    const badFields = findNonEditableFields(f, values, details);
+    if (badFields.length)
+        throw new Error(`拒绝填写只读/隐藏字段：${badFields.map((b) => `${b.label ?? b.id}(${VIEWATTR_LABEL[b.viewattr] ?? 'va=' + b.viewattr})`).join('、')}。表单只允许填写「可编辑」字段，不得绕过字段属性自行填值。`);
     const name = requestname || `${f.workflowName ?? '流程'}-系统管理员-${todayStr()}`;
     const merged = { ...values };
     // 用户未填的人员/部门/日期字段，用当前用户信息默认补上
@@ -449,8 +481,8 @@ export async function prepareCreateSubmission(cfg, workflowId, values, requestna
             const id = String(fld.id);
             if (merged[id] !== undefined)
                 continue; // 用户已填
-            if (fld.viewattr === 2)
-                continue; // 只读字段由系统/联动控制，不补默认值（避免覆盖联动计算，如外出时间 WCSJ）
+            if (fld.viewattr === 2 || fld.viewattr === 3)
+                continue; // 只读/隐藏字段由系统/联动控制，不补默认值（不得绕过字段属性自行填值）
             const dv = defaultForField(fld.label, fld.htmltype, user);
             if (dv)
                 merged[id] = dv;

package/dist/wfuser.js

@@ -4,18 +4,17 @@
  * 接口（用户抓包确认）：GET /api/hrm/login/getAccountList?__random__=<ts>
  *   aiAgentToken 鉴权。返回 data.{userid, username, deptid, deptname, subcompanyname, jobs}。
  */
-import { AuthTokenSession } from './auth-token.js';
 import { createApiFromProfile } from './client.js';
 import { todayStr } from './util.js';
-/** 取当前登录用户信息。 */
+/**
+ * 取当前登录用户信息。GET /api/hrm/login/getAccountList?__random__=<ts>
+ * 走 E9Api（ensureValid + 双头 + 重试 + 失效逃生，见 client.js）——2026-09-20 e9pc 实测：
+ * 裸 fetch(aiAgentToken) 会 404（缺头/token 状态不同步），E9Api 通道正常返回 accountlist。
+ */
 export async function getCurrentUser(cfg) {
-    const sess = AuthTokenSession.fromProfile(cfg);
-    const base = cfg.baseUrl.replace(/\/+$/, '');
-    const r = await fetch(`${base}/api/hrm/login/getAccountList?__random__=${Date.now()}`, {
-        headers: { aiAgentToken: sess.token, 'X-Requested-With': 'XMLHttpRequest' },
-        signal: AbortSignal.timeout(12000),
-    });
-    const j = await r.json();
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/hrm/login/getAccountList', { __random__: Date.now() });
+    const j = r?.json ?? {};
     const d = j?.data ?? {};
     // accountlist 里 iscurrent=1 的是当前账号；data 顶层也有当前用户字段
     const list = Array.isArray(d.accountlist) ? d.accountlist : [];

package/dist/workflow.js

@@ -48,9 +48,9 @@ export const DEFAULT_FILTERS = {
 /** 各分类的 viewScope/complete/menuIds/默认viewcondition（来自 HAR 抓包实跑确认）。
  *  menuIds 可由 cfg 覆盖：cfg.doneMenuIds/mineMenuIds；viewcondition 可由 opts 覆盖（子 tab）。 */
 export const CATEGORY_SCOPE = {
-    todo: { viewScope: 'doing', complete: '0', menuIdsKey: 'menuIds', defaultViewcondition: '5' },
-    done: { viewScope: 'done', complete: '2', menuIdsKey: 'doneMenuIds', defaultMenuIds: '1,90', defaultViewcondition: '10' },
-    mine: { viewScope: 'mine', complete: '2', menuIdsKey: 'mineMenuIds', defaultMenuIds: '1,14', defaultViewcondition: '16' },
+    todo: { viewScope: 'doing', complete: '0', menuIdsKey: 'menuIds', defaultViewcondition: '5', fullTab: '0', pageTitle: '待办事宜', countEndpoint: 'doingCountInfo' },
+    done: { viewScope: 'done', complete: '2', menuIdsKey: 'doneMenuIds', defaultMenuIds: '1,90', defaultViewcondition: '10', fullTab: '10', pageTitle: '已办事宜', countEndpoint: 'doneCountInfo' },
+    mine: { viewScope: 'mine', complete: '2', menuIdsKey: 'mineMenuIds', defaultMenuIds: '1,14', defaultViewcondition: '16', fullTab: '16', pageTitle: '我的请求', countEndpoint: 'mineCountInfo' },
 };
 /** 排序字段映射表 */
 const SORT_FIELD_MAP = {
@@ -113,12 +113,16 @@ export const TODO_TABS = {
     "被督办": "4", "未读": "1", "反馈": "2", "超时": "3", "我的关注": "37",
 };
 
+/** 已办页签（实测 .18 doneBaseInfo.groupinfo；旧表把 17/18 误记成「审批中/已结束」）。 */
 export const DONE_TABS = {
-    "全部": "10", "关注": "38",
+    "全部": "10", "未归档": "11", "已归档": "12", "待回复": "13",
+    "未读": "14", "反馈": "15", "我的关注": "38",
 };
 
+/** 我发起页签（实测 .18 mineBaseInfo.groupinfo）。 */
 export const MINE_TABS = {
-    "全部": "16", "审批中": "17", "已结束": "18", "关注": "39",
+    "全部": "16", "未归档": "17", "已归档": "18",
+    "未读": "19", "反馈": "20", "我的关注": "39",
 };
 
 export function resolveSubCategory(spec, category) {
@@ -317,6 +321,97 @@ export function mergeSmartTodoGroups(results, page = 1) {
     };
 }
 
+// ─── 按 OA 二级分类页签分组（待办/已办/我发起通用）────────────
+
+/** 内置页签表（CountInfo 不返回 topTab 时回退；实测仅待办返回 topTab，已办/我发起均不返回）。 */
+function builtinTabs(category) {
+    const map = category === 'done' ? DONE_TABS : category === 'mine' ? MINE_TABS : TODO_TABS;
+    return Object.entries(map).map(([title, viewcondition]) => ({ title, viewcondition: String(viewcondition), groupid: '' }));
+}
+
+/**
+ * 取 OA 二级分类页签清单（三级数据源，逐级回退）：
+ *   ① {scope}CountInfo.topTab——**只有待办返回**（实测 .18）；附带各页签计数 totalcount[groupid]。
+ *   ② {scope}BaseInfo.groupinfo——**已办/我发起的唯一来源**（实测 .18：done 7 个页签、mine 6 个）；无计数。
+ *   ③ 内置页签名表（网络异常时的兜底）；无计数。
+ * 已剔除「全部」页签——它是其它所有页签的并集，单列会吞掉全部分类。
+ */
+export async function getOaTabs(cfg, category) {
+    const scope = CATEGORY_SCOPE[category] ?? CATEGORY_SCOPE.todo;
+    const menuIds = String(cfg[scope.menuIdsKey] ?? scope.defaultMenuIds ?? cfg.menuIds ?? '1,13');
+    const menuPathIds = String(cfg[scope.menuIdsKey] ?? cfg.menuPathIds ?? menuIds);
+    const mapTab = (t) => ({ title: String(t?.title ?? ''), viewcondition: String(t?.viewcondition ?? ''), groupid: String(t?.groupid ?? '') });
+    let tabs = [];
+    let counts = {};
+    let source = 'builtin';
+    const api = await createApiFromProfile(cfg);
+    // ① CountInfo.topTab（待办有；已办/我发起实测不返回）
+    try {
+        const r = await api.post(`/api/workflow/reqlist/${scope.countEndpoint}`, buildScopeBody(scope.defaultViewcondition, scope, menuIds, menuPathIds));
+        const j = r.json ?? {};
+        counts = j.totalcount ?? {};
+        tabs = (j.topTab ?? []).map(mapTab).filter((t) => t.title && t.viewcondition !== '');
+        if (tabs.length)
+            source = 'countinfo';
+    }
+    catch { /* 落到下一级 */ }
+    // ② BaseInfo.groupinfo（已办/我发起的权威来源）
+    if (!tabs.length) {
+        try {
+            const r = await api.post(`/api/workflow/reqlist/${scope.viewScope}BaseInfo`, buildScopeBody(scope.defaultViewcondition, scope, menuIds, menuPathIds));
+            tabs = (r.json?.groupinfo ?? []).map(mapTab).filter((t) => t.title && t.viewcondition !== '');
+            if (tabs.length)
+                source = 'baseinfo';
+        }
+        catch { /* 落到下一级 */ }
+    }
+    // ③ 内置表兜底
+    if (!tabs.length)
+        tabs = builtinTabs(category);
+    return { tabs: tabs.filter((t) => t.viewcondition !== String(scope.fullTab)), counts, scope, source };
+}
+
+/**
+ * 按 OA 页签分组取数：每个页签独立查询、并发执行，同一 requestId 只保留在靠前的页签里（避免重复推荐）。
+ * 只列有数据的分类：计数已知且为 0 的页签直接跳过（不查询）；查完 total=0 的也不展示。
+ */
+export async function getOaTabGroups(cfg, opts = {}) {
+    const category = opts.category ?? 'todo';
+    const { tabs, counts } = await getOaTabs(cfg, category);
+    const results = await Promise.all(tabs.map(async (tab) => {
+        const known = tab.groupid && counts[tab.groupid] !== undefined ? Number(counts[tab.groupid]) : NaN;
+        if (Number.isFinite(known) && known === 0)
+            return null; // 计数已知为 0 → 不查询
+        const result = await getWfList(cfg, { ...opts, category, subCategory: tab.viewcondition, _singleWorkflow: false });
+        return { tab, result };
+    }));
+    const seen = new Set();
+    const groups = [];
+    for (const entry of results) {
+        if (!entry)
+            continue;
+        const { tab, result } = entry;
+        if (!result.total)
+            continue; // 无数据不展示
+        const items = result.items.filter((item) => {
+            const id = String(item.requestId ?? '');
+            if (!id || seen.has(id))
+                return !id;
+            seen.add(id);
+            return true;
+        });
+        groups.push({ key: tab.viewcondition, title: tab.title, viewcondition: tab.viewcondition, total: result.total, items, result: { ...result, items } });
+    }
+    return {
+        category,
+        page: opts.page ?? 1,
+        groups,
+        categoryTotals: Object.fromEntries(groups.map((g) => [g.viewcondition, Number(g.total) || 0])),
+        // 仅用于诊断：各分类相加（页签间有交集，绝不能称为“总数”）
+        categoryTotalSum: groups.reduce((sum, g) => sum + (Number(g.total) || 0), 0),
+    };
+}
+
 /** 解析 doingBaseInfo.treedata 中的流程类型节点。 */
 export function parseWorkflowTypes(tree) {
     const out = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weaver-e9-assistant-cli",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "泛微 e-cology E9 HTTP 能力 CLI 封装（待办、微博、新建流程、邮件、公文、日程、考勤、建模台账）",
   "type": "module",
   "bin": {
@@ -18,7 +18,7 @@
   "scripts": {
     "start": "node dist/cli.js",
     "e9": "node dist/cli.js",
-    "build": "node --check dist/cli.js && node --check dist/cube.js && node --check dist/workplan.js && node --check dist/fileutil.js && node --check dist/kq.js && node --check dist/links.js && node --check dist/report.js && node --check dist/workflow.js && node --check dist/parse.js && node --check dist/todosubmit.js && node --check dist/wfsummary.js && node --check dist/wfstart.js && node --check dist/submissionplan.js && node --check dist/submissionstate.js && node --check dist/auth-token.js && node --check dist/todobatch.js && node --check dist/pageopen.js && node --check dist/createcontext.js && node --check dist/querystate.js && node --check dist/wfops.js && node --check dist/subordinate.js",
+    "build": "node --check dist/cli.js && node --check dist/cube.js && node --check dist/workplan.js && node --check dist/fileutil.js && node --check dist/kq.js && node --check dist/links.js && node --check dist/report.js && node --check dist/workflow.js && node --check dist/parse.js && node --check dist/todosubmit.js && node --check dist/wfsummary.js && node --check dist/wfstart.js && node --check dist/submissionplan.js && node --check dist/submissionstate.js && node --check dist/auth-token.js && node --check dist/todobatch.js && node --check dist/pageopen.js && node --check dist/createcontext.js && node --check dist/querystate.js && node --check dist/wfops.js && node --check dist/subordinate.js && node --check dist/hrm.js",
     "test": "node --test \"tests/**/*.test.js\"",
     "prepack": "npm test",
     "release": "node scripts/release.js",