weaver-work-cli 0.1.7 → 0.1.20

package/dist/shortcuts/contract/operations/types.js

@@ -0,0 +1,7 @@
+/** 写操作链路的统一状态名，与业票通保持一致。 */
+export const CONTRACT_WORKFLOW = {
+    awaitingConfirmation: (operation) => ({ operation, status: 'AWAITING_CONFIRMATION' }),
+    executing: (operation) => ({ operation, status: 'EXECUTING' }),
+    verifying: (operation) => ({ operation, status: 'VERIFYING' }),
+    complete: (operation) => ({ operation, status: 'COMPLETE' }),
+};

package/dist/shortcuts/contract/operations/workflow.js

@@ -0,0 +1,52 @@
+import { contractValidationError } from '../errors.js';
+import { ContractReadOperation, projectWorkflowBase, projectWorkflowList } from './read.js';
+import { queryFrom, requireId, requireNonEmptyString } from './shared.js';
+import { contractWorkflowFormInfoOperation } from './form-info.js';
+export const contractWorkflowQueryOperation = new ContractReadOperation('contract.workflow.query', {
+    method: 'POST',
+    path: '/api/workflow/pathdef/openapi/getBaseInfoByCondition',
+    userIdField: 'userid',
+    body: (input) => ({
+        workflowName: requireNonEmptyString(input.workflowName, 'workflowName'),
+        ...queryFrom(input, ['workflowType', 'status']),
+    }),
+    shape: projectWorkflowBase,
+});
+export const contractWorkflowListOperation = new ContractReadOperation('contract.workflow.list', {
+    method: 'POST',
+    path: '/api/workflow/list/paService/v1/getCreateWorkflowList',
+    userIdField: 'userid',
+    body: (input) => {
+        const wfpCode = Number(input.wfpCode);
+        if (wfpCode !== 0 && wfpCode !== 1) {
+            throw contractValidationError('wfp_code_invalid', 'wfpCode 只能是 0（个人审批）或 1（团队审批）');
+        }
+        return { wfpCode, ...queryFrom(input, ['filterHide']) };
+    },
+    shape: projectWorkflowList,
+});
+export const contractWorkflowFieldOptionsOperation = new ContractReadOperation('contract.workflow.field.options', {
+    method: 'POST',
+    path: '/api/workflow/core/paService/v1/getFieldOption',
+    userIdField: 'userid',
+    body: (input) => ({
+        fieldId: requireId(input.fieldId, 'fieldId'),
+        ...queryFrom(input, ['pageNo', 'pageSize']),
+    }),
+    shape: (value) => {
+        const data = (value.data ?? {});
+        const rows = Array.isArray(data.data) ? data.data : [];
+        return {
+            message: value.message,
+            total: data.total,
+            maxPage: data.maxPage,
+            options: rows.map((item) => ({ id: item?.id, name: item?.name })),
+        };
+    },
+});
+export const contractWorkflowOperations = [
+    contractWorkflowQueryOperation,
+    contractWorkflowListOperation,
+    contractWorkflowFormInfoOperation,
+    contractWorkflowFieldOptionsOperation,
+];

package/dist/shortcuts/contract/operations/write.js

@@ -0,0 +1,131 @@
+import { ContractCliError, contractConfirmationError, contractPartialError, contractValidationError } from '../errors.js';
+import { objectFingerprint, sessionMatches } from './shared.js';
+import { CONTRACT_WORKFLOW } from './types.js';
+function baseNameOf(operation) {
+    return operation.replace(/\.(prepare|apply)$/u, '');
+}
+function defaultFingerprint(input) {
+    return objectFingerprint(input);
+}
+export class ContractWritePrepareOperation {
+    name;
+    applyName;
+    spec;
+    constructor(name, applyName, spec) {
+        this.name = name;
+        this.applyName = applyName;
+        this.spec = spec;
+    }
+    async execute(input, { host, continuation }) {
+        this.spec.validate?.(input);
+        const precheck = this.spec.precheck ? await this.spec.precheck(input, host) : undefined;
+        const session = await host.getSession();
+        const preview = this.spec.preview(input);
+        const baseName = baseNameOf(this.name);
+        const continuationToken = await continuation.issue({
+            operation: this.applyName,
+            path: this.spec.path,
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            fingerprint: (this.spec.fingerprint ?? defaultFingerprint)(input),
+            preview,
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview,
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: CONTRACT_WORKFLOW.awaitingConfirmation(baseName),
+                ...(precheck ? { precheck } : {}),
+            },
+        };
+    }
+}
+export class ContractWriteApplyOperation {
+    name;
+    spec;
+    constructor(name, spec) {
+        this.name = name;
+        this.spec = spec;
+    }
+    async execute(input, { host, continuation }) {
+        this.spec.validate?.(input);
+        if (input.confirm !== true) {
+            throw contractConfirmationError(this.name, { hint: '重新调用时传入 confirm=true 与 prepare 返回的 continuation' });
+        }
+        const lease = await continuation.verify(input.continuation, this.name);
+        if (typeof lease.fingerprint !== 'string') {
+            throw contractValidationError('continuation_invalid', 'continuation 缺少写入指纹，请重新 prepare');
+        }
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session)) {
+            throw contractValidationError('context_mismatch', '确认上下文已变化，请重新 prepare');
+        }
+        if ((this.spec.fingerprint ?? defaultFingerprint)(input) !== lease.fingerprint) {
+            throw contractValidationError('target_changed', '待写入内容与确认时不一致，请重新 prepare');
+        }
+        const baseName = baseNameOf(this.name);
+        const body = {
+            ...(this.spec.defaults ?? {}),
+            ...this.spec.body(input),
+        };
+        let result;
+        try {
+            result = await host.contractRequest({
+                method: this.spec.method,
+                path: this.spec.path,
+                body,
+                ...(this.spec.userIdField ? { userIdField: this.spec.userIdField } : {}),
+            });
+        }
+        catch (error) {
+            if (error instanceof ContractCliError && this.spec.mapError) {
+                const mapped = this.spec.mapError(error);
+                if (mapped)
+                    throw mapped;
+            }
+            if (error instanceof ContractCliError && error.type === 'network') {
+                throw contractPartialError('写请求发送后连接中断，结果不确定，禁止自动重试；先用查询接口确认是否已生效', {
+                    preview: lease.preview,
+                    workflow: CONTRACT_WORKFLOW.executing(baseName),
+                }, { stage: 'write' });
+            }
+            throw error;
+        }
+        if (!this.spec.readback) {
+            return {
+                status: 'COMPLETE',
+                data: {
+                    result,
+                    verified: false,
+                    workflow: CONTRACT_WORKFLOW.complete(baseName),
+                },
+            };
+        }
+        let verified;
+        try {
+            verified = await this.spec.readback(result, input, host);
+        }
+        catch (error) {
+            if (error instanceof ContractCliError && error.type === 'partial')
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            throw contractPartialError(`写入接口已返回成功，但回读校验失败，结果不确定：${message}`, {
+                preview: lease.preview,
+                result,
+                workflow: CONTRACT_WORKFLOW.verifying(baseName),
+            }, { stage: 'readback' });
+        }
+        return {
+            status: 'COMPLETE',
+            data: {
+                result,
+                verified: true,
+                workflow: CONTRACT_WORKFLOW.complete(baseName),
+                ...(verified ? { readback: verified } : {}),
+            },
+        };
+    }
+}

package/dist/shortcuts/contract/operations.js

@@ -0,0 +1,8 @@
+import { getContractOperation } from './operations/registry.js';
+import { asObject, assertNoForbiddenKeys } from './operations/shared.js';
+export async function executeContractOperation(operation, rawInput, context) {
+    const handler = getContractOperation(operation);
+    const input = asObject(rawInput);
+    assertNoForbiddenKeys(input);
+    return handler.execute(input, context);
+}

package/dist/shortcuts/hrm/index.js

@@ -57,6 +57,51 @@ function parseJsonInput(raw, label) {
         throw hrmValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
     }
 }
+/** 解析 run-many 的 JSON 数组输入：[{ "op": "...", "input": {...} }, ...] */
+export async function inputArrayFrom(options) {
+    const opts = asOptions(options);
+    if (opts.input && opts.inputJson) {
+        throw hrmValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    let raw;
+    if (opts.inputJson) {
+        raw = String(opts.inputJson);
+    }
+    else if (opts.input) {
+        try {
+            raw = stripBom(opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8'));
+        }
+        catch {
+            throw hrmValidationError('input_unreadable', `无法读取 --input：${String(opts.input)}`);
+        }
+    }
+    else {
+        throw hrmValidationError('input_required', 'run-many 需要 --input 或 --input-json 提供 JSON 数组');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(stripBom(raw));
+    }
+    catch {
+        throw hrmValidationError('input_invalid', 'run-many 输入不是合法 JSON');
+    }
+    if (!Array.isArray(parsed)) {
+        throw hrmValidationError('input_invalid', 'run-many 输入必须是数组：[{"op":"...","input":{...}}, ...]');
+    }
+    return parsed.map((item, index) => {
+        if (!item || typeof item !== 'object' || Array.isArray(item)) {
+            throw hrmValidationError('input_invalid', `run-many 第 ${index + 1} 项必须是对象`);
+        }
+        const obj = item;
+        if (typeof obj.op !== 'string' || !obj.op.trim()) {
+            throw hrmValidationError('input_invalid', `run-many 第 ${index + 1} 项缺少 op 字段`);
+        }
+        const input = obj.input && typeof obj.input === 'object' && !Array.isArray(obj.input)
+            ? obj.input
+            : {};
+        return { op: obj.op.trim(), input };
+    });
+}
 export function successEnvelope(operation, result) {
     return {
         schemaVersion: 1,
@@ -96,8 +141,25 @@ export const hrmShortcut = {
         const hrm = program.command('hrm').description('泛微E10组织管理（员工查询/组织架构/岗位查询）');
         hrm.command('schema')
             .description('Print hrm operation manifest for agents')
-            .action(action((ctx) => {
-            ctx.output.write(hrmManifest, { json: true });
+            .option('--full', 'print full manifest with complete inputSchema')
+            .action(action((ctx, options) => {
+            if (asOptions(options).full === true) {
+                ctx.output.write(hrmManifest, { json: true });
+                return;
+            }
+            // 精简版：name + summary + 参数名 + 必填项，供 Agent 快速路由，避免全量 schema 撑爆上下文
+            const brief = {
+                schemaVersion: hrmManifest.schemaVersion,
+                name: hrmManifest.name,
+                version: hrmManifest.version,
+                operations: hrmManifest.operations.map((o) => ({
+                    name: o.name,
+                    summary: o.summary,
+                    params: Object.keys(o.inputSchema?.properties ?? {}),
+                    required: o.inputSchema?.required ?? [],
+                })),
+            };
+            ctx.output.write(brief, { json: true });
         }));
         hrm.command('run')
             .description('Run an hrm operation with JSON input')
@@ -107,5 +169,24 @@ export const hrmShortcut = {
             .action(action(async (ctx, operation, options) => {
             await executeAndPrint(ctx, String(operation), await inputFrom(options));
         }));
+        hrm.command('run-many')
+            .description('Run multiple hrm operations in a single process (shared session)')
+            .option('--input <path>', 'JSON array file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON array')
+            .action(action(async (ctx, options) => {
+            const items = await inputArrayFrom(options);
+            const host = createHrmHost(ctx);
+            const results = [];
+            for (const item of items) {
+                try {
+                    const result = await executeHrmOperation(item.op, item.input, { ctx, host });
+                    results.push(successEnvelope(item.op, result));
+                }
+                catch (error) {
+                    results.push({ operation: item.op, ...failureEnvelope(error) });
+                }
+            }
+            ctx.output.write({ schemaVersion: 1, ok: true, count: results.length, results }, { json: true });
+        }));
     },
 };

package/dist/shortcuts/hrm/operations/employee.js

@@ -26,6 +26,125 @@ function formatMember(r, baseUrl) {
         deptLink: deptId ? orgLink(baseUrl, deptId) : '',
     };
 }
+/**
+ * 人员卡片默认输出的核心字段白名单（顺序即输出顺序）。
+ * 完整卡片有 85 个顶层键、~5.3KB，其中大部分是登录/管理元数据（password、last_android、
+ * hideFieldList、setting、*_admin…），Agent 用不上；投影后 ~1.2KB。
+ * 需要完整卡片时传 `full: true`。
+ */
+const DETAIL_CORE_FIELDS = [
+    'id', 'name', 'username', 'job_num', 'sex', 'avatar',
+    'personnel_status', 'status', 'type',
+    'department', 'subcompany', 'organization', 'position', 'jobsetid', 'jobset_level',
+    'superior', 'other_superior', 'only_superior', 'subordinate', 'assistant',
+    'mobile', 'email', 'telephone', 'office', 'location', 'active_date',
+];
+/** 实体数组字段（人员状态/部门/分部/岗位/职级/地点）：只留 id + name。 */
+const DETAIL_ENTITY_FIELDS = ['personnel_status', 'department', 'subcompany', 'position', 'jobsetid', 'jobset_level', 'location'];
+/** 人员数组字段（上级/其他上级/助理）：保留 id + name + statusCode + 瘦身头像。 */
+const DETAIL_PERSON_FIELDS = ['superior', 'other_superior', 'assistant'];
+/** 头像瘦身：原响应重复给出 7 个等价 URL（url/downloadUrl/appDownloadUrl/previewUrl/…）+ p1..p5，只留 1 个 url。 */
+function slimAvatar(avatar) {
+    if (!avatar || typeof avatar !== 'object')
+        return avatar;
+    const a = avatar;
+    const out = {};
+    for (const key of ['url', 'name', 'userId']) {
+        if (a[key] !== undefined && a[key] !== '')
+            out[key] = a[key];
+    }
+    return out;
+}
+/** 实体数组瘦身：只留 id + name，丢掉 _entityType/icon/tenantKey/delete 等前端元数据。 */
+function slimEntities(value) {
+    if (!Array.isArray(value))
+        return value;
+    return value.map((item) => {
+        if (!item || typeof item !== 'object')
+            return item;
+        const e = item;
+        return e.name === undefined ? { id: e.id } : { id: e.id, name: e.name };
+    });
+}
+/** 人员数组瘦身：id + name + statusCode + 瘦身头像。 */
+function slimPersons(value) {
+    if (!Array.isArray(value))
+        return value;
+    return value.map((item) => {
+        if (!item || typeof item !== 'object')
+            return item;
+        const p = item;
+        const out = { id: p.id, name: p.name };
+        if (p.statusCode !== undefined)
+            out.statusCode = p.statusCode;
+        if (p.avatar !== undefined)
+            out.avatar = slimAvatar(p.avatar);
+        return out;
+    });
+}
+/** 默认精简投影：只保留核心业务字段（`full: true` 时跳过，直接回完整卡片）。 */
+function pickDetailCore(raw) {
+    const out = {};
+    for (const key of DETAIL_CORE_FIELDS) {
+        const value = raw[key];
+        if (value === undefined || value === null)
+            continue;
+        if (DETAIL_PERSON_FIELDS.includes(key))
+            out[key] = slimPersons(value);
+        else if (DETAIL_ENTITY_FIELDS.includes(key))
+            out[key] = slimEntities(value);
+        else if (key === 'avatar')
+            out[key] = slimAvatar(value);
+        else
+            out[key] = value;
+    }
+    return out;
+}
+/**
+ * 「人员列表」精简行：只留 id + name（外加派生的 link，供 `[姓名](link)` 渲染）。
+ * 用于 `subordinate.mine` / `subordinate.by-id` / `dept.members` 的默认输出。
+ * 对比原始行：by-id 原始行单行 960B（其中上游的 superior 对象一项就占 485B）、
+ * `formatMember` 行 366B；精简后约 120B。需要部门/岗位/电话等完整行时传 `full: true`。
+ */
+function formatPersonBrief(r, baseUrl) {
+    const id = r.id ?? r.employeeId;
+    return { id, name: r.name ?? r.username, link: personLink(baseUrl, id) };
+}
+/** 下属完整行（`full: true` 时用于 by-id）：by-id 原始行的显式投影。 */
+function formatSubordinateFull(r, baseUrl) {
+    const id = r.id ?? r.employeeId;
+    return {
+        id,
+        name: r.name ?? r.username,
+        pinyin: r.pinyin,
+        telephone: r.telephone,
+        sex: r.sex,
+        personnelStatus: r.personnelStatus,
+        department: r.department,
+        position: r.position,
+        superior: r.superior,
+        link: personLink(baseUrl, id),
+    };
+}
+/**
+ * `employee.query` 默认行：只回「人员信息」——人员 id / 姓名 / 部门 / 岗位 / 状态 + 卡片 link。
+ * 相对完整行（`formatMember`，368B）去掉的是：
+ *   ① 另两套 id —— `userid`（登录信息 id）、`cid`（IM 联系人 id）：查人场景用不到，且极易和人员 id 混用；
+ *   ② `mobile`：本接口恒为空串（要脱敏手机号得用 `employee.batch`）；
+ *   ③ `departmentId` + `deptLink`：部门卡片链接，需要时用 `org.detail` 或传 `full: true`。
+ * 注意人员 id 是唯一应该传给 `employee.detail` / `employee.batch` / `subordinate.by-id` 的 id。
+ */
+function formatQueryRowBrief(r, baseUrl) {
+    const id = r.id;
+    return {
+        id,
+        name: r.name,
+        department: r.department,
+        position: r.position,
+        statusCode: r.statusCode,
+        link: personLink(baseUrl, id),
+    };
+}
 /** 批量详情行 → 精简人员行。 */
 function formatBatch(u, baseUrl) {
     const deptId = u.departmentId != null && u.departmentId !== '' ? String(u.departmentId) : '';
@@ -73,7 +192,7 @@ const employeeQuery = {
     resource: 'employee',
     method: 'employee.query',
     action: 'hrm.employee.query',
-    summary: '按工号/姓名/手机/邮箱（keyword 自动推断或显式字段）查询员工；默认在职，status 传 ["6"] 查离职',
+    summary: '按工号/姓名/手机/邮箱（keyword 自动推断或显式字段）查询员工；默认在职，status 传 ["6"] 查离职；默认每行只回人员信息',
     risk: READ,
     inputSchema: schemaOf({
         keyword: { type: 'string', description: '查询关键词，自动推断：含 @→邮箱；11 位纯数字→手机；纯数字或字母开头含数字→工号；其余→姓名（模糊）' },
@@ -82,6 +201,7 @@ const employeeQuery = {
         mobile: { type: 'string', description: '手机号（模糊匹配）' },
         email: { type: 'string', description: '邮箱（模糊匹配）' },
         status: { type: 'array', items: { type: 'string', enum: [...EMPLOYEE_STATUS] }, description: '默认 ["normal"] 在职；["6"] 离职。不能单独作为收敛条件' },
+        full: { type: 'boolean', description: '默认 false：每行只回人员信息（id/name/department/position/statusCode/link）；true：回完整行（另含 userid/cid/mobile/departmentId/deptLink）' },
         ...SCHEMA_PAGE,
     }),
     handler: async (args, { host }) => {
@@ -117,11 +237,13 @@ const employeeQuery = {
             body.pageSize = pageSize;
         const session = await host.getSession();
         const baseUrl = session.baseUrl.replace(/\/+$/, '');
-        const countResp = await host.request({ method: 'POST', path: '/api/hrm/common/browser/count/resource', body });
+        // 不请求 count 接口（省一次 HTTP 往返）；data 接口的 count 字段不可靠（恒 0），
+        // 用返回行数作为 total。收敛条件查询结果通常 < pageSize，行数即总数。
         const dataResp = await host.request({ method: 'POST', path: '/api/hrm/common/browser/data/resource', body });
-        const total = Number(countResp?.data?.total ?? 0);
         const rawRows = dataResp?.data?.data ?? [];
-        const rows = rawRows.map((r) => formatMember(r, baseUrl));
+        const total = rawRows.length;
+        // 默认只回人员信息（id/name/department/position/statusCode/link）；完整行传 full: true。
+        const rows = rawRows.map((r) => (args.full === true ? formatMember(r, baseUrl) : formatQueryRowBrief(r, baseUrl)));
         const lookingNormal = statusText.includes('normal');
         const hint = lookingNormal && rows.length === 0
             ? `在职员工未查到「${value}」；若为离职人员，请用 status=["6"] 再查`
@@ -170,18 +292,30 @@ const employeeDetail = {
     resource: 'employee',
     method: 'employee.detail',
     action: 'hrm.employee.detail',
-    summary: '按人员 id 取资料名片（头像/是否管理员/管理者类型/在线状态）；不含姓名/工号/部门/手机',
+    summary: '按人员 id 取人员卡片（默认只回核心业务字段；full=true 回完整卡片 85 个顶层键）',
     risk: READ,
-    inputSchema: schemaOf({ id: SCHEMA_ID }, { required: ['id'] }),
+    inputSchema: schemaOf({
+        id: SCHEMA_ID,
+        full: { type: 'boolean', description: '默认 false：只回核心业务字段（姓名/工号/组织/岗位/上级/助理/联系方式/办公地点等，体积约为完整卡片的 1/5）；true：回完整人员卡片（含 password、last_android、hideFieldList、setting、*_admin 等登录/管理元数据）' },
+    }, { required: ['id'] }),
     handler: async (args, { host }) => {
         const id = String(args.id).trim();
         if (!id)
             throw hrmValidationError('id_required', 'id 必填');
-        const resp = await host.request({ method: 'GET', path: '/api/hrm/profile/get', query: { id } });
-        const data = resp?.data ?? {};
         const session = await host.getSession();
         const baseUrl = session.baseUrl.replace(/\/+$/, '');
-        return hrmSuccess('hrm.employee.detail', { ...data, link: personLink(baseUrl, id) });
+        // readOnly=true 必需：非只读且非本人/非基础信息管理员时服务端会拒绝（checkCardHasRight）。
+        const resp = await host.request({
+            method: 'GET',
+            path: `/api/hrm/card/get/${id}`,
+            query: { id, readOnly: true },
+            headers: { Referer: `${baseUrl}/sp/hrm/profileInfo/${id}` },
+        });
+        // 第一层：只提取 data.data 的业务字段，砍掉 groups/layout/items 等前端表单元数据（几千行）。
+        const raw = resp?.data?.data ?? {};
+        // 第二层：默认再投影成核心字段（85 键/~5.3KB → 26 键/~1.2KB）；full=true 时保留完整卡片。
+        const payload = args.full === true ? raw : pickDetailCore(raw);
+        return hrmSuccess('hrm.employee.detail', { ...payload, id, link: personLink(baseUrl, id) });
     },
 };
 const subordinateMine = {
@@ -189,10 +323,11 @@ const subordinateMine = {
     resource: 'employee',
     method: 'subordinate.mine',
     action: 'hrm.subordinate.mine',
-    summary: '查当前登录人的下属（all 所有/direct 直接/indirect 间接），基于当前会话身份',
+    summary: '查当前登录人的下属（all 所有/direct 直接/indirect 间接），基于当前会话身份；默认每行只回 id+name',
     risk: READ,
     inputSchema: schemaOf({
         scope: { type: 'string', enum: [...SUBORDINATE_SCOPE], description: '默认 all；direct 直接 / indirect 间接 / all 所有' },
+        full: { type: 'boolean', description: '默认 false：每行只回 id/name/link；true：回完整行（部门/岗位/手机/状态等）' },
         ...SCHEMA_PAGE,
     }),
     handler: async (args, { host }) => {
@@ -217,11 +352,13 @@ const subordinateMine = {
             body.pageSize = pageSize;
         const session = await host.getSession();
         const baseUrl = session.baseUrl.replace(/\/+$/, '');
-        const countResp = await host.request({ method: 'POST', path: '/api/hrm/common/browser/count/resource', body });
+        // 不请求 count 接口（省一次 HTTP 往返）；data 接口的 count 字段不可靠（恒 0），
+        // 用返回行数作为 total。收敛条件查询结果通常 < pageSize，行数即总数。
         const dataResp = await host.request({ method: 'POST', path: '/api/hrm/common/browser/data/resource', body });
-        const total = Number(countResp?.data?.total ?? 0);
         const rawRows = dataResp?.data?.data ?? [];
-        const rows = rawRows.map((r) => formatMember(r, baseUrl));
+        const total = rawRows.length;
+        // 默认只回 id + name（+ link）；需要部门/岗位/手机等完整行时传 full: true。
+        const rows = rawRows.map((r) => (args.full === true ? formatMember(r, baseUrl) : formatPersonBrief(r, baseUrl)));
         return hrmSuccess('hrm.subordinate.mine', { rows, total, scope }, { current: current ?? 1, pageSize: pageSize ?? 200 });
     },
 };
@@ -230,13 +367,14 @@ const subordinateById = {
     resource: 'employee',
     method: 'subordinate.by-id',
     action: 'hrm.subordinate.by-id',
-    summary: '按目标人员 id 查其直接/间接下属（无需切换会话）；所有下属 = direct + indirect 两次并集',
+    summary: '按目标人员 id 查其直接/间接下属（无需切换会话）；默认每行只回 id+name；所有下属 = direct + indirect 两次并集',
     risk: READ,
     inputSchema: schemaOf({
         id: SCHEMA_ID,
         scope: { type: 'string', enum: [...SUBORDINATE_BYID_SCOPE], description: '默认 direct；direct 直接 / indirect 间接' },
-        pageNo: SCHEMA_ID,
-        pageSize: SCHEMA_ID,
+        full: { type: 'boolean', description: '默认 false：每行只回 id/name/link；true：回完整行（部门/岗位/上级/电话等）' },
+        pageNo: { ...SCHEMA_ID, description: '页码，从 1 开始。⚠️ 本操作用 pageNo（不是 current）' },
+        pageSize: { ...SCHEMA_ID, description: '每页条数，默认 10' },
     }, { required: ['id'] }),
     handler: async (args, { host }) => {
         const id = String(args.id).trim();
@@ -258,18 +396,8 @@ const subordinateById = {
         });
         const page = resp?.data?.page ?? {};
         const rawRows = Array.isArray(page.result) ? page.result : [];
-        const rows = rawRows.map((r) => ({
-            id: r.id ?? r.employeeId,
-            name: r.name ?? r.username,
-            pinyin: r.pinyin,
-            telephone: r.telephone,
-            sex: r.sex,
-            personnelStatus: r.personnelStatus,
-            department: r.department,
-            position: r.position,
-            superior: r.superior,
-            link: personLink(baseUrl, r.id ?? r.employeeId),
-        }));
+        // 默认只回 id + name（+ link）；需要部门/岗位/上级/电话等完整行时传 full: true。
+        const rows = rawRows.map((r) => (args.full === true ? formatSubordinateFull(r, baseUrl) : formatPersonBrief(r, baseUrl)));
         return hrmSuccess('hrm.subordinate.by-id', {
             rows,
             total: Number(page.totalCount ?? rows.length),
@@ -288,10 +416,11 @@ const deptMembers = {
     resource: 'employee',
     method: 'dept.members',
     action: 'hrm.dept.members',
-    summary: '查某部门/分部下的直接成员（部门名或 id；部门名需唯一，重名改用 id）',
+    summary: '查某部门/分部下的直接成员（部门名或 id；部门名需唯一，重名改用 id）；默认每行只回 id+name',
     risk: READ,
     inputSchema: schemaOf({
         dept: { type: 'string', description: '部门/分部名称（需唯一）或组织节点 id' },
+        full: { type: 'boolean', description: '默认 false：每行只回 id/name/link；true：回完整行（部门/岗位/手机/状态/部门卡片链接等）' },
         ...SCHEMA_PAGE,
     }, { required: ['dept'] }),
     handler: async (args, { host }) => {
@@ -324,7 +453,8 @@ const deptMembers = {
         const rawRows = resp?.data?.data ?? [];
         const session = await host.getSession();
         const baseUrl = session.baseUrl.replace(/\/+$/, '');
-        const rows = rawRows.map((r) => formatMember(r, baseUrl));
+        // 默认只回 id + name（+ link）；需要部门/岗位/手机/状态等完整行时传 full: true。
+        const rows = rawRows.map((r) => (args.full === true ? formatMember(r, baseUrl) : formatPersonBrief(r, baseUrl)));
         return hrmSuccess('hrm.dept.members', { dept: { id: deptId }, rows, total: rows.length }, { current: current ?? 1, pageSize: pageSize ?? 200 });
     },
 };

package/dist/shortcuts/hrm/operations/org.js

@@ -1,6 +1,6 @@
 import { hrmValidationError } from '../errors.js';
 import { READ, SCHEMA_ID, SCHEMA_PAGE, hrmSuccess, schemaOf, } from './types.js';
-import { browserBaseBody, orgLink, toNumber, toPositiveInt, toStringIdList, } from './shared.js';
+import { browserBaseBody, orgLink, pickDefined, toNumber, toPositiveInt, toStringIdList, } from './shared.js';
 const ORG_TYPES = ['subcompany', 'department'];
 /**
  * 组织浏览接口（分部 subcompany / 部门 department）统一入口。
@@ -100,8 +100,22 @@ const orgDetail = {
             query: { id, readOnly: true, includeSub: true, quote: true, isMobile: false },
             headers: { Referer: `${baseUrl}/sp/hrm/orgCard/${id}` },
         });
-        const data = resp?.data ?? {};
-        return hrmSuccess('hrm.org.detail', { ...data, link: orgLink(baseUrl, id) });
+        // 只提取 data.data 的业务字段，砍掉 groups/layout/items 等前端表单元数据（几千行）。
+        const raw = resp?.data?.data ?? {};
+        const parentName = Array.isArray(raw.parent) && raw.parent[0]?.name ? String(raw.parent[0].name) : '';
+        const subcompanyName = Array.isArray(raw.subcompany) && raw.subcompany[0]?.name ? String(raw.subcompany[0].name) : '';
+        return hrmSuccess('hrm.org.detail', {
+            id,
+            name: raw.name,
+            type: raw.type,
+            code: raw.code,
+            fullPath: raw.fullPath,
+            status: raw.status,
+            ...(parentName ? { parentName } : {}),
+            ...(subcompanyName ? { subcompanyName } : {}),
+            ...pickDefined(raw, ['description', 'remark']),
+            link: orgLink(baseUrl, id),
+        });
     },
 };
 export const hrmOrgOperations = [

package/dist/shortcuts/hrm/operations/position.js

@@ -100,8 +100,24 @@ const positionDetail = {
             query: { id, type: 'info' },
             headers: { Referer: `${baseUrl}/sp/hrm/positionCard/${id}` },
         });
-        const data = resp?.data ?? {};
-        return hrmSuccess('hrm.position.detail', { ...data, link: positionLink(baseUrl, id) });
+        // 只提取 data.data 的业务字段，砍掉 groups/layout/items 等前端表单元数据。
+        const raw = resp?.data?.data ?? {};
+        const parentName = Array.isArray(raw.parent) && raw.parent[0]?.name ? String(raw.parent[0].name) : '';
+        const jobsetName = Array.isArray(raw.jobsetid) && raw.jobsetid[0]?.name ? String(raw.jobsetid[0].name) : '';
+        const jobsetTypeName = Array.isArray(raw.jobset_type_id) && raw.jobset_type_id[0]?.name ? String(raw.jobset_type_id[0].name) : '';
+        const grade = Array.isArray(raw.grade)
+            ? raw.grade.map((g) => (g && typeof g === 'object' ? (g.name ?? g) : g))
+            : raw.grade;
+        return hrmSuccess('hrm.position.detail', {
+            id,
+            name: raw.name,
+            code: raw.code,
+            ...(parentName ? { parentName } : {}),
+            ...(jobsetName ? { jobsetName } : {}),
+            ...(jobsetTypeName ? { jobsetTypeName } : {}),
+            ...(grade !== undefined ? { grade } : {}),
+            link: positionLink(baseUrl, id),
+        });
     },
 };
 const positionList = {