weaver-work-cli 0.1.32 → 0.1.36

package/dist/shortcuts/ehr/operations/recruit.js

@@ -42,7 +42,7 @@ const LIST_KEYWORDS = {
     biz_config: ['业务配置映射表'],
 };
 /** 列表类型 -> 缓存键 + 表单逻辑名（candidate.list 四列表映射，同 recruit-list.mjs TYPES） */
-const LIST_TYPES = {
+export const LIST_TYPES = {
     demand: { listKey: 'demand', formType: 'demand_manage', title: '招聘需求' },
     position: { listKey: 'position', formType: 'position_manage', title: '招聘职位' },
     entry: { listKey: 'entry', formType: 'entry_manage', title: '入职管理' },
@@ -58,7 +58,7 @@ const INTERNAL_KEYS = new Set([
 const DISPLAY_UI_KEYS = new Set([
     ...INTERNAL_KEYS, 'operate', 'isToDo', 'todoPropSpan', 'flow_status',
 ]);
-function randHex32() {
+export function randHex32() {
     return randomUUID().replace(/-/g, '');
 }
 function randHex6() {
@@ -419,7 +419,7 @@ export function createRecruitContextLoader() {
     return { load };
 }
 /** EB 列表通用查询体（同 recruit-list.mjs baseBody） */
-function buildListBody(params) {
+export function buildListBody(params) {
     return {
         current: params.current ?? 1,
         pageSize: params.pageSize ?? 10,
@@ -444,7 +444,7 @@ function buildListBody(params) {
     };
 }
 /** 列表 + 计数并行；displayData 优先（同 recruit-search/recruit-list 的显示层策略） */
-async function fetchListRows(host, objId, listId, body) {
+export async function fetchListRows(host, objId, listId, body) {
     const countBody = { ...body };
     delete countBody.current;
     delete countBody.pageSize;
@@ -466,8 +466,33 @@ async function fetchListRows(host, objId, listId, body) {
     const hasDisplay = Array.isArray(displayRows) && displayRows.length > 0;
     const rows = hasDisplay ? displayRows : rawRows;
     const countData = countResponse ? normalizePaged(countResponse).data : null;
-    const total = countData?.total !== undefined ? countData.total : rows.length;
-    return { rows, displayRows: hasDisplay ? displayRows : null, total };
+    const pageSize = typeof body.pageSize === 'number'
+        ? body.pageSize
+        : (typeof body.pageSize === 'string' ? (Number(body.pageSize) || rows.length) : rows.length);
+    // 总数取值（不输出假值，对齐 ehr recruit-list.mjs 三态降级）：
+    // ① 计数接口可用（200 且 total 为数字）→ 精确；
+    // ② 计数不可用但本页未满（rows < pageSize，即已到末页）→ 总数=已取回行数（精确）；
+    // ③ 计数不可用且本页已满 → total=null（总数不可知），附 note 提示加大 pageSize。
+    // 背景：部分租户/列表 getListDataCount 恒 500，且 getListDatas 的 total 不可信，唯一可靠判据是分页本身。
+    const countUsable = countData !== null && typeof countData.total === 'number';
+    let total;
+    let totalExact;
+    let totalNote;
+    if (countUsable) {
+        total = countData.total;
+        totalExact = true;
+    }
+    else if (rows.length < pageSize) {
+        total = rows.length;
+        totalExact = true;
+        totalNote = '计数接口不可用，本页未满（已到末页），总数按已取回行数得出';
+    }
+    else {
+        total = null;
+        totalExact = false;
+        totalNote = '计数接口不可用且本页已满，总数不可知（可调大 pageSize 取回全部行数）';
+    }
+    return { rows, displayRows: hasDisplay ? displayRows : null, total, totalExact, totalNote };
 }
 // ─────────────────────────────────────────────────────────────────────────────
 // operations
@@ -537,7 +562,7 @@ const candidateSearch = {
             pageSize: toNumber(args.pageSize, 'pageSize') ?? 10,
             conditions,
         });
-        const { rows, displayRows, total } = await fetchListRows(env.host, talentObjId, talentList.listId, body);
+        const { rows, displayRows, total, totalExact, totalNote } = await fetchListRows(env.host, talentObjId, talentList.listId, body);
         // 显示层优先：displayData 已内联人员/字典中文，零额外请求；
         // 缺失时回退原始层：字典映射 + 纯 ID 经 hrm getEmployeeByIds 批量反查（兜底，行为不变）
         let creatorNameMap = {};
@@ -590,7 +615,7 @@ const candidateSearch = {
                 createTime: row?.create_time || null,
             };
         });
-        return ehrSuccess('ehr.recruit.candidate.search', { total, rows: dataRows });
+        return ehrSuccess('ehr.recruit.candidate.search', { total, totalExact, ...(totalNote ? { totalNote } : {}), rows: dataRows });
     },
 };
 const candidateList = {
@@ -632,7 +657,7 @@ const candidateList = {
             current: toPositiveInt(args.current, 'current') ?? 1,
             pageSize: toNumber(args.pageSize, 'pageSize') ?? 10,
         });
-        const { rows, displayRows, total } = await fetchListRows(env.host, formObjId, listParam.listId, body);
+        const { rows, displayRows, total, totalExact, totalNote } = await fetchListRows(env.host, formObjId, listParam.listId, body);
         const outRows = rows.map((row) => {
             const cleaned = { form_data_id: row?.form_data_id || row?.id };
             for (const [key, value] of Object.entries(row || {})) {
@@ -669,7 +694,153 @@ const candidateList = {
             return cleaned;
         });
         return ehrSuccess('ehr.recruit.candidate.list', {
-            type, total, current: body.current, pageSize: body.pageSize, rows: outRows,
+            type, total, totalExact, ...(totalNote ? { totalNote } : {}), current: body.current, pageSize: body.pageSize, rows: outRows,
+        });
+    },
+};
+/** 当前登录人姓名（teamsCheck → currentUser.username），用于「我作为面试官」匹配 */
+/** 人员字段可能是 JSON 数组串（[{name,id,...}]）→ 取姓名连接；纯文本原样返回 */
+function personNames(value) {
+    const text = String(value ?? '').trim();
+    if (!text)
+        return '';
+    if (text.startsWith('[')) {
+        try {
+            const arr = JSON.parse(text);
+            if (Array.isArray(arr)) {
+                const names = arr
+                    .map((item) => (typeof item === 'string' ? item : item?.name ?? item?.username ?? ''))
+                    .filter(Boolean);
+                if (names.length)
+                    return names.join('、');
+            }
+        }
+        catch { /* 非 JSON，按纯文本处理 */ }
+    }
+    return text;
+}
+/** 展示名兜底：跨基线 displayData 会把关联字段直接给名字（talent_id=人名、position_manage_id=职位名）；纯 16 位以上数字视为 id，不当名字用 */
+function nameLike(value) {
+    const text = String(value ?? '').trim();
+    if (!text || /^\d{16,}$/.test(text))
+        return null;
+    return text;
+}
+async function resolveCurrentUserName(host) {
+    // teamsCheck 的响应不被 isBusinessSuccess 认可（无 status 字段），故直接 fetch，绕开业务判定
+    try {
+        const session = await host.getSession();
+        const baseUrl = String(session?.baseUrl || '');
+        if (!baseUrl)
+            return '';
+        const resp = await fetch(`${baseUrl}/api/baseserver/layout/teamsCheck?clientType=not_xinchuang&client=WEB&domainName=${encodeURIComponent(baseUrl)}`, {
+            method: 'POST',
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                eteamsid: String(session?.eteamsId || ''),
+                cookie: typeof session?.cookieHeader === 'function' ? session.cookieHeader() : '',
+                'user-agent': typeof session?.uaHeader === 'function' ? session.uaHeader() : 'weaver-work-cli',
+                origin: baseUrl,
+            },
+            redirect: 'manual',
+        });
+        const data = await resp.json().catch(() => ({}));
+        const cu = data.currentUser ?? data.data?.currentUser ?? null;
+        return cu ? String(cu.username ?? cu.id ?? '') : '';
+    }
+    catch {
+        return '';
+    }
+}
+const interviewFeedbackTodo = {
+    name: 'ehr.recruit.interview.feedbackTodo',
+    resource: 'recruit',
+    method: 'interview.feedbackTodo',
+    action: 'ehr.recruit.interview.feedbackTodo',
+    summary: '面试待办：**只返回我作为面试官的 AI 面试待反馈清单**（候选人已答完、已有录像、我还没填意见）；按需翻页 + 客户端筛选，不返回全量面试',
+    capability: 'recruit',
+    risk: READ,
+    inputSchema: schemaOf({
+        maxPages: { type: 'integer', minimum: 1, maximum: 50, description: '最多翻页数（默认 5）' },
+        pageSize: { type: 'integer', minimum: 1, maximum: 200, description: '单页条数（默认 200，实测服务端上限 200）' },
+    }),
+    handler: async (args, env) => {
+        if (!env.recruitContext)
+            throw ehrValidationError('recruit_context_unavailable', '招聘上下文加载器未初始化');
+        const cache = await env.recruitContext.load(env.host);
+        const listParam = cache.lists.interview;
+        const form = cache.forms.interview_plan;
+        if (!listParam?.listId || !form?.objId) {
+            throw new RecruitContextError('recruit_list_unavailable', '当前环境未启用「面试管理」功能（未找到面试列表/表单参数，按能力探测拦截）。');
+        }
+        const pageSize = toNumber(args.pageSize, 'pageSize') ?? 200;
+        const maxPages = toNumber(args.maxPages, 'maxPages') ?? 5;
+        const me = await resolveCurrentUserName(env.host);
+        // 枚举可能回退成 optionId：用环境缓存的 field_options 运行时映射回中文（不写死 id）
+        const fields = cache.fields[form.objId] || {};
+        const fieldOpts = cache.field_options[form.objId] || {};
+        const statusOpts = fieldOpts[fields.union_status] || {};
+        const typeOpts = fieldOpts[fields.interview_type] || {};
+        const toCn = (map, raw) => {
+            const text = String(raw ?? '');
+            return map[text] ?? text;
+        };
+        const statusOf = (row) => toCn(statusOpts, row?.union_status_key ?? row?.union_status);
+        const typeOf = (row) => toCn(typeOpts, row?.interview_type_key ?? row?.interview_type);
+        const interviewerOf = (row) => personNames(row?.interviewer);
+        const scanned = [];
+        let lastPageCount = 0;
+        for (let i = 0; i < maxPages; i++) {
+            const body = buildListBody({
+                listId: listParam.listId,
+                cusMenuId: listParam.cusMenuId,
+                menuName: listParam.menuName || '面试管理',
+                title: '面试管理',
+                current: i + 1,
+                pageSize,
+            });
+            const page = await fetchListRows(env.host, form.objId, listParam.listId, body);
+            const use = page.displayRows && page.displayRows.length ? page.displayRows : page.rows;
+            scanned.push(...use);
+            lastPageCount = use.length;
+            if (use.length < pageSize)
+                break;
+        }
+        // 「待反馈」= 后端 InterviewStatusEnum.TO_FEEDBACK：
+        // AI 面试结束时间已过 且（有录像附件 或 已开始录制）且 反馈结果为空
+        // ⇒ 这个状态本身就等于「已完成 + 有视频 + 未填意见」，无需再读视频字段
+        const pending = scanned.filter((row) => /待反馈/.test(statusOf(row)));
+        const mineAll = me ? pending.filter((row) => interviewerOf(row).includes(me)) : [];
+        const mineAi = mineAll.filter((row) => /AI\s*面试/i.test(typeOf(row)));
+        const slim = (row) => ({
+            form_data_id: row?.form_data_id ?? row?.id ?? null,
+            candidate_name: nameLike(row?.candidate_name) ?? nameLike(row?.talent_id) ?? nameLike(row?.name),
+            position_name: nameLike(row?.position_name) ?? nameLike(row?.position_manage_id),
+            start_time: row?.start_time ?? null,
+            interview_type_key: typeOf(row) || null,
+            interview_session: row?.interview_session ?? null,
+            interviewer: interviewerOf(row) || null,
+            union_status_key: statusOf(row) || null,
+            subject: row?.subject ?? null,
+            talent_id: row?.talent_id ?? null,
+            position_manage_id: row?.position_manage_id ?? null,
+        });
+        const notes = [];
+        if (!me)
+            notes.push('未能解析当前登录人姓名（teamsCheck 失败），无法按面试官过滤');
+        if (lastPageCount >= pageSize && scanned.length >= pageSize * maxPages) {
+            notes.push(`已扫描 ${scanned.length} 条（达 maxPages=${maxPages} 上限），如怀疑遗漏可加大 maxPages`);
+        }
+        return ehrSuccess('ehr.recruit.interview.feedbackTodo', {
+            currentUser: me || null,
+            scanned: scanned.length,
+            myAiPendingFeedback: { count: mineAi.length, rows: mineAi.map(slim) },
+            myOtherPendingFeedback: {
+                count: mineAll.length - mineAi.length,
+                rows: mineAll.filter((row) => !/AI\s*面试/i.test(typeOf(row))).map(slim),
+            },
+            ...(notes.length ? { note: notes.join('；') } : {}),
         });
     },
 };
@@ -790,6 +961,7 @@ export const recruitOperations = [
     candidateSearch,
     candidateList,
     candidateCard,
+    interviewFeedbackTodo,
 ];
 export const RECRUIT_SECOND_PHASE_WITHHELD = [
     'recruit.candidate.create',

package/dist/shortcuts/ehr/operations/registry.js

@@ -6,6 +6,9 @@ import { hrDataSourceOperations } from './hr-ds.js';
 import { hrReportOperations } from './hr-report.js';
 import { recruitOperations } from './recruit.js';
 import { recruitWriteOperations } from './recruit-write.js';
+import { recruitStatsOperations } from './recruit-stats.js';
+import { recruitPositionOperations } from './recruit-position.js';
+import { recruitCandidateImportOperations } from './recruit-candidate-import.js';
 import { salaryOperations } from './salary.js';
 function buildRegistry() {
     const registry = new Map();
@@ -18,6 +21,9 @@ function buildRegistry() {
         ...hrReportOperations,
         ...recruitOperations,
         ...recruitWriteOperations,
+        ...recruitStatsOperations,
+        ...recruitPositionOperations,
+        ...recruitCandidateImportOperations,
     ];
     for (const definition of definitions) {
         if (registry.has(definition.name)) {

package/dist/shortcuts/fna/operations/expense-chart.js

@@ -8,6 +8,8 @@ const MAX_ROWS_LIMIT = 5000;
 const USER_INPUT_LIMIT = 500;
 const BLOCKED_MESSAGE = /拦截|高危|安全校验/;
 const CLARIFY_MESSAGE = /不明确|请补充|补充查询/;
+/** 权限类文案：命中即视为数据权限不足，Agent 必须停在原地，不得改调其它接口拼数据。 */
+const PERMISSION_DENIED_MESSAGE = /权限|越权/;
 function requireUserInput(value) {
     if (typeof value !== 'string' || value.trim().length === 0) {
         throw fnaValidationError('user_input_required', 'userInput 必填（自然语言问题，不能为空白）');
@@ -65,16 +67,23 @@ function collectColumns(rows) {
     }
     return columns;
 }
+/**
+ * 按文案推断字符串 data 的语义。
+ * 权限类文案优先归类为 clarify：服务端可能只返回「无数据权限」而不带「不明确」，
+ * 若落进 unexpected，Agent 会误判为无非预期形态，进而换问法或改调其它接口拼数据。
+ */
 function classifyMessage(message) {
+    if (PERMISSION_DENIED_MESSAGE.test(message))
+        return { kind: 'clarify', permissionDenied: true };
     if (BLOCKED_MESSAGE.test(message))
-        return 'blocked';
+        return { kind: 'blocked', permissionDenied: false };
     if (CLARIFY_MESSAGE.test(message))
-        return 'clarify';
+        return { kind: 'clarify', permissionDenied: false };
     return undefined;
 }
 /**
  * 归一化 getExpenseChart 的 data。code 恒为 200，成败只看 data 形态：
- * 对象数组 → rows/empty；追问/安全拦截文案 → clarify/blocked（按文案推断）；其余 → unexpected。
+ * 对象数组 → rows/empty；追问/安全拦截/无权限文案 → clarify/blocked（按文案推断，无权限额外标 permissionDenied）；其余 → unexpected。
  * maxRows 只截断本地返回，列名仍按服务端全量结果收集。
  */
 function normalizeChart(data, maxRows) {
@@ -107,9 +116,12 @@ function normalizeChart(data, maxRows) {
         });
     }
     if (typeof data === 'string') {
-        const kind = classifyMessage(data);
-        if (kind) {
-            return fnaSuccess('fna.expense.chart', { kind, message: data }, { messageKindInferred: true });
+        const classified = classifyMessage(data);
+        if (classified) {
+            return fnaSuccess('fna.expense.chart', { kind: classified.kind, message: data }, {
+                messageKindInferred: true,
+                permissionDenied: classified.permissionDenied,
+            });
         }
     }
     return fnaSuccess('fna.expense.chart', { kind: 'unexpected' }, { dataType: dataTypeOf(data) });
@@ -124,7 +136,7 @@ const fnaExpenseChart = {
     resource: 'expense',
     method: 'expense.chart',
     action: 'fna.expense.chart',
-    summary: '报销报表 AI 问答：用自然语言查询分组/排名/趋势，返回 kind=rows/empty/clarify/blocked/unexpected；maxRows 只截断本地展示',
+    summary: '报销报表 AI 问答：用自然语言查询分组/排名/趋势，返回 kind=rows/empty/clarify/blocked/unexpected；无权限文案额外返回 meta.permissionDenied=true，此时必须停住、不得改调其它接口拼数据；maxRows 只截断本地展示',
     capability: 'expense-chart',
     risk: READ,
     inputSchema: schemaOf({

package/dist/shortcuts/im/diagnostics.js

@@ -0,0 +1,97 @@
+/**
+ * 易秒办（im）域内的诊断能力：**只动本模块目录，不改公共 core/cmd/internal**。
+ *
+ * 两个能力都通过公共已有的扩展点实现：
+ * - 失败信封双写：`im` 自己的 catch 分支里写 stdout + stderr，不扩 `Output` 类；
+ * - 请求级追踪：走 `HookManager.registerE10RequestInterceptor()`，不碰 `E10RequestRuntime`。
+ */
+const TRACE_ENV = 'WEAVER_WORK_CLI_TRACE';
+/** 同一进程内只注册一次拦截器（`forCommand()` 复用同一个 HookManager 实例）。 */
+const registeredHooks = new WeakSet();
+function truthy(value) {
+    const raw = String(value ?? '').toLowerCase();
+    return raw === '1' || raw === 'true' || raw === 'yes';
+}
+/** 从当前命令向上找 `im --trace`：命令级开关，不占用全局选项槽位。 */
+function traceFromCommand(ctx) {
+    let current = ctx.activeCommand;
+    for (let depth = 0; current && depth <= 3; depth += 1) {
+        const opts = typeof current.opts === 'function' ? current.opts() : undefined;
+        if (opts?.trace === true)
+            return true;
+        current = current.parent ?? undefined;
+    }
+    return false;
+}
+export function imTraceEnabled(ctx) {
+    if (truthy(ctx.env?.[TRACE_ENV]) || truthy(process.env[TRACE_ENV]))
+        return true;
+    try {
+        return traceFromCommand(ctx);
+    }
+    catch {
+        // 单测里的 ctx 可能是最小 mock：追踪开关不得影响请求本身
+        return false;
+    }
+}
+/** 按 path 记录在途请求的起始时间；同 path 并发时按 FIFO 配对。 */
+const inflight = new Map();
+function remember(path) {
+    const list = inflight.get(path) ?? [];
+    list.push(Date.now());
+    inflight.set(path, list);
+}
+function forget(path) {
+    const list = inflight.get(path);
+    if (!list?.length)
+        return undefined;
+    const startedAt = list.shift();
+    if (!list.length)
+        inflight.delete(path);
+    return startedAt;
+}
+function label(request) {
+    const operation = request.operation || '-';
+    return `${request.method} ${request.path} op=${operation}`;
+}
+function traceInterceptor() {
+    return {
+        beforeRequest({ request }) {
+            remember(request.path);
+        },
+        afterResponse({ request, response }) {
+            const startedAt = forget(request.path);
+            const ms = startedAt === undefined ? '-' : `${Date.now() - startedAt}ms`;
+            process.stderr.write(`[trace] ${label(request)} status=${response.status} ${ms}\n`);
+        },
+        onError({ request, error }) {
+            const startedAt = forget(request.path);
+            const ms = startedAt === undefined ? '-' : `${Date.now() - startedAt}ms`;
+            const code = error?.subtype
+                || error?.code
+                || 'unknown';
+            // 只打方法/路径/operation/错误码/耗时，绝不打印请求头与请求体（可能含凭证）
+            process.stderr.write(`[trace] ${label(request)} status=ERR code=${code} ${ms}\n`);
+        },
+    };
+}
+/** 按需注册追踪拦截器：未开启 trace 时完全零开销。 */
+export function registerImTrace(ctx) {
+    if (!imTraceEnabled(ctx))
+        return;
+    const hooks = ctx.hooks;
+    if (!hooks || registeredHooks.has(hooks))
+        return;
+    registeredHooks.add(hooks);
+    ctx.hooks.registerE10RequestInterceptor(traceInterceptor());
+}
+/**
+ * 失败信封：**stdout 与 stderr 各写一份**（内容相同）。
+ * stdout 是主通道 —— 只读 stdout 的调用方也能拿到结构化错误；
+ * stderr 保留一份，兼容「stderr 有内容 = 失败」的历史判断。
+ */
+export function printImFailure(envelope) {
+    const text = `${JSON.stringify(envelope, null, 2)}\n`;
+    process.stdout.write(text);
+    process.stderr.write(text);
+}

package/dist/shortcuts/im/host.js

@@ -94,6 +94,7 @@ export function createImHost(ctx, dependencies = {}) {
         return createE10RequestRuntime(ctx, await ensureSession(), {
             interceptors: dependencies.interceptors,
             fetch: dependencies.fetch,
+            recoverAuthentication: dependencies.recoverAuthentication,
         });
     }
     async function request(request) {
@@ -144,41 +145,53 @@ export function createImHost(ctx, dependencies = {}) {
     }
     async function requestBinary(url, headers = {}) {
         const session = await ensureSession();
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), 60_000);
+        const baseUrl = new URL(session.getBaseUrl());
+        let target;
         try {
-            const resp = await (dependencies.fetch || globalThis.fetch)(url, {
-                headers: {
-                    accept: 'application/json, text/plain, */*',
-                    cookie: session.cookieHeader(),
-                    eteamsid: session.eteamsId,
-                    'user-agent': session.uaHeader(),
-                    origin: session.getBaseUrl(),
-                    ...headers,
-                },
-                redirect: 'manual',
-                signal: controller.signal,
+            target = new URL(url, baseUrl);
+        }
+        catch {
+            throw imValidationError('download_url_invalid', '下载地址不是合法 URL');
+        }
+        if (target.origin !== baseUrl.origin) {
+            throw imValidationError('download_url_cross_origin', '下载地址不允许跨 E10 环境');
+        }
+        assertPath(target.pathname);
+        const query = {};
+        for (const [key, value] of target.searchParams) {
+            const previous = query[key];
+            if (previous === undefined)
+                query[key] = value;
+            else if (Array.isArray(previous))
+                previous.push(value);
+            else
+                query[key] = [previous, value];
+        }
+        let response;
+        try {
+            response = await (await runtime()).requestBinary({
+                module: 'im',
+                operation: 'im.file.download',
+                method: 'GET',
+                path: target.pathname,
+                query,
+                headers,
+                timeoutMs: 60_000,
             });
-            if (resp.status === 401 || resp.status === 302) {
-                throw imAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE);
-            }
-            if (resp.status !== 200) {
-                throw new ImCliError('api', 'download_failed', `下载失败 HTTP ${resp.status}`, {
-                    code: resp.status,
-                    exitCode: 1,
-                });
-            }
-            return Buffer.from(await resp.arrayBuffer());
         }
         catch (error) {
-            if (error instanceof ImCliError)
-                throw error;
-            const message = error instanceof Error ? error.message : String(error);
-            throw imNetworkError('transport', `下载失败：${message}`, { retryable: true });
+            mapRuntimeNetworkError(error);
+        }
+        if (response.status === 401 || response.status === 302) {
+            throw imAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE);
         }
-        finally {
-            clearTimeout(timer);
+        if (response.status !== 200) {
+            throw new ImCliError('api', 'download_failed', `下载失败 HTTP ${response.status}`, {
+                code: response.status,
+                exitCode: 1,
+            });
         }
+        return response.content;
     }
     /** teamsCheck：解析当前登录人的 imUid/imCid/name（IM uid 语义 = 员工 id）。 */
     async function getSelfIdentity() {
@@ -248,11 +261,25 @@ export function createImHost(ctx, dependencies = {}) {
             timeoutMs: 15_000,
         });
         const preData = preRes?.data || {};
+        /**
+         * 秒传分支：服务端按 MD5 命中已有文件时**不再返回 preUploadId**，而是直接给出 fileObj
+         * （`uploadType: "second"`）。实测两种结构：
+         *   { uploadType: 'second', fileObj: {...} }
+         *   { uploadType: 'second', imUploadInfoDto: { uploadType: 'second', fileObj: {...}, transcode: {...} } }
+         * 旧实现只认 preUploadId，导致「同一张图/同一个文件第二次发送」必定失败（upload_check_failed，
+         * 但响应本身是 code:200 status:true）。命中秒传时直接复用 fileObj，跳过 valid/upload。
+         */
+        const preInfo = preData.imUploadInfoDto || preData;
+        const preFileObj = preInfo?.fileObj && (preInfo.fileObj.id || preInfo.fileObj.fileid) ? preInfo.fileObj : null;
+        const preUploadType = String(preData.uploadType || preInfo?.uploadType || '');
+        if (preFileObj && (!preData.preUploadId || preUploadType === 'second')) {
+            return preFileObj;
+        }
         if (!preData.preUploadId) {
-            throw new ImCliError('api', 'upload_check_failed', `preUploadCheck 失败`, { details: preRes, exitCode: 1 });
+            throw new ImCliError('api', 'upload_check_failed', `preUploadCheck 失败（未返回 preUploadId，也没有可复用的秒传 fileObj）`, { details: preRes, exitCode: 1 });
         }
         const preUploadId = String(preData.preUploadId);
-        const uploadType = preData.uploadType || 'common';
+        const uploadType = preUploadType || 'common';
         // 第 2 步：实传
         const upForm = new FormData();
         upForm.append('data', new Blob([data], { type: mime }), name);

package/dist/shortcuts/im/index.js

@@ -1,6 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
 import { createImContinuationSigner } from './continuation.js';
+import { printImFailure, registerImTrace } from './diagnostics.js';
 import { imValidationError } from './errors.js';
 import { createImHost } from './host.js';
 import { imManifest } from './manifest.js';
@@ -81,6 +82,8 @@ function failureEnvelope(error) {
     };
 }
 async function executeAndPrint(ctx, operation, input) {
+    // 排障/接口计数：`im --trace` 或 WEAVER_WORK_CLI_TRACE=1（实现完全在 im 域内，不改公共 runtime）
+    registerImTrace(ctx);
     try {
         const result = await executeImOperation(operation, input, {
             ctx,
@@ -90,7 +93,7 @@ async function executeAndPrint(ctx, operation, input) {
         ctx.output.write(successEnvelope(operation, result), { json: true });
     }
     catch (error) {
-        console.error(JSON.stringify(failureEnvelope(error), null, 2));
+        printImFailure(failureEnvelope(error));
         process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
     }
 }
@@ -110,7 +113,9 @@ export const imShortcut = {
     description: '泛微E10易秒办（即时通讯）CLI',
     category: 'shortcut',
     register({ program, action }) {
-        const im = program.command('im').description('泛微E10易秒办：消息/群组/会话/系统消息');
+        const im = program.command('im')
+            .description('泛微E10易秒办：消息/群组/会话/系统消息')
+            .option('--trace', '每个 E10 请求在 stderr 打一行 [trace]（method/path/op/status/耗时，不含凭证）');
         im.command('schema')
             .description('Print im operation manifest for agents')
             .action(action((ctx) => {