hunter-mate 0.1.7 → 0.1.11

package/dist/commands/extension.js

@@ -21,13 +21,15 @@ function http(baseUrl) {
         headers: { 'Content-Type': 'application/json' },
     });
 }
-/** 带鉴权的 client(server /extensions* 端点要求 UTOKEN,与 job/record/search 等模块一致)。 */
-async function httpAuth(baseUrl) {
+/** 带鉴权的 client(server /extensions* 端点要求 UTOKEN,与 job/record/search 等模块一致)。
+ *  D4(R3 定案):timeoutMs 可传 —— axios 层默认 60s,server 侧 timeoutMs(-t)更大时
+ *  HTTP 层先弃,linkedin search 等多页编排(分钟级)走 CLI 必死;+15s 缓冲覆盖 server 处理+回传。 */
+async function httpAuth(baseUrl, timeoutMs) {
     const { getToken } = await import('../keychain.js');
     const token = await getToken();
     return axios.create({
         baseURL: baseUrl,
-        timeout: 60_000,
+        timeout: timeoutMs ?? 60_000,
         headers: {
             'Content-Type': 'application/json',
             ...(token ? { Authorization: `UTOKEN ${token}` } : {}),
@@ -37,7 +39,8 @@ async function httpAuth(baseUrl) {
 function requireServerUrl() {
     const config = loadConfig();
     if (!config.serverUrl) {
-        printCommandError('extension:no-server-url', new Error('请先 hunter-mate config 设置 serverUrl'));
+        // 同步上下文:手工构造的 Error 无 response.status,不会触发 issuer 诊断分支
+        void printCommandError('extension:no-server-url', new Error('请先 hunter-mate config 设置 serverUrl'));
         process.exit(1);
     }
     return config.serverUrl;
@@ -126,7 +129,7 @@ export function ensureEnvReady() {
             catch { /* ignore */ }
         }
         if (!serverUp) {
-            printCommandError('extension:server-start-failed', new Error('请手动执行 hunter-mate start -f'));
+            await printCommandError('extension:server-start-failed', new Error('请手动执行 hunter-mate start -f'));
             process.exit(1);
         }
         // 2) 检查扩展是否安装
@@ -141,7 +144,7 @@ export function ensureEnvReady() {
             const r = runInstall(init.extensionDir);
             if (!r.source) {
                 // 内置 dist 不存在, 无法自动安装
-                printCommandError('extension:auto-install-failed', new Error('内置 extension dist 不存在,请在 hunter-mate monorepo 执行 pnpm --filter @hunter-mate/extension build,或手动 hunter-mate install'));
+                await printCommandError('extension:auto-install-failed', new Error('内置 extension dist 不存在,请在 hunter-mate monorepo 执行 pnpm --filter @hunter-mate/extension build,或手动 hunter-mate install'));
                 process.exit(1);
             }
             console.log(`${B.green}✓  扩展已自动安装到 ${r.target}${B.reset}`);
@@ -183,7 +186,7 @@ export function ensureEnvReady() {
         }
         catch {
             // /extensions 端点不可达
-            printCommandError('extension:check-failed', new Error('Server 可能未正确启动, 请执行 hunter-mate start -f'));
+            await printCommandError('extension:check-failed', new Error('Server 可能未正确启动, 请执行 hunter-mate start -f'));
             process.exit(1);
         }
     })();
@@ -247,7 +250,7 @@ async function withEnvCheck(fn) {
         await fn();
     }
     catch (err) {
-        printCommandError('extension:exec-failed', err);
+        await printCommandError('extension:exec-failed', err);
         const msg = err.response?.data?.message ?? err.response?.data?.error ?? err.message;
         if (msg.includes('no Hunter Mate Chrome extension registered') || msg.includes('no Hunter Mate')) {
             const init = await import('./init.js').then((m) => m.runInit());
@@ -279,7 +282,7 @@ async function cmdControl(command, argsJson, opts) {
                 process.exit(1);
             }
         }
-        const r = await (await httpAuth(serverUrl)).post('/extensions/control', {
+        const r = await (await httpAuth(serverUrl, opts.timeout ? Number(opts.timeout) + 15_000 : undefined)).post('/extensions/control', {
             command,
             params,
             timeoutMs: opts.timeout ? Number(opts.timeout) : undefined,
@@ -292,9 +295,10 @@ async function cmdControl(command, argsJson, opts) {
 async function cmdGoto(url, opts) {
     return withEnvCheck(async () => {
         const serverUrl = requireServerUrl();
-        const r = await (await httpAuth(serverUrl)).post('/extensions/goto', {
+        const r = await (await httpAuth(serverUrl, opts.timeout ? Number(opts.timeout) + 15_000 : undefined)).post('/extensions/goto', {
             url,
             waitUntil: opts.waitUntil,
+            reload: opts.reload ? true : undefined,
             timeoutMs: opts.timeout ? Number(opts.timeout) : undefined,
             extensionId: opts.extensionId,
             sessionId: opts.sessionId ?? opts.taskId,
@@ -305,7 +309,7 @@ async function cmdGoto(url, opts) {
 async function cmdEval(expression, opts) {
     return withEnvCheck(async () => {
         const serverUrl = requireServerUrl();
-        const r = await (await httpAuth(serverUrl)).post('/extensions/eval', {
+        const r = await (await httpAuth(serverUrl, opts.timeout ? Number(opts.timeout) + 15_000 : undefined)).post('/extensions/eval', {
             expression,
             timeoutMs: opts.timeout ? Number(opts.timeout) : undefined,
             extensionId: opts.extensionId,
@@ -317,7 +321,7 @@ async function cmdEval(expression, opts) {
 async function cmdScreenshot(opts) {
     return withEnvCheck(async () => {
         const serverUrl = requireServerUrl();
-        const r = await (await httpAuth(serverUrl)).post('/extensions/screenshot', {
+        const r = await (await httpAuth(serverUrl, opts.timeout ? Number(opts.timeout) + 15_000 : undefined)).post('/extensions/screenshot', {
             fullPage: opts.full ? true : undefined,
             selector: opts.selector,
             format: opts.imageFormat ?? 'png',
@@ -354,7 +358,7 @@ async function cmdRun(site, command, opts) {
             timeoutMs: opts.timeout ? Number(opts.timeout) : undefined,
             extensionId: opts.extensionId,
         };
-        const r = await (await httpAuth(serverUrl)).post(endpoint, payload);
+        const r = await (await httpAuth(serverUrl, opts.timeout ? Number(opts.timeout) + 15_000 : undefined)).post(endpoint, payload);
         printResult(r.data, opts.format);
     });
 }
@@ -382,7 +386,7 @@ extensionCommand
         console.log(`\n${B.green}✓  Hunter Mate 扩展已连接 (${count} 个浏览器实例)${B.reset}\n`);
     }
     catch (err) {
-        printCommandError('extension:check-error', err);
+        await printCommandError('extension:check-error', err);
         process.exit(1);
     }
 });
@@ -394,8 +398,9 @@ common(extensionCommand
     .description('通用页面控制（OpenCLI 全能力, 对应 chromepilot control）：cp.state/cp.goto/cp.find/cp.click/cp.type/cp.fill/cp.select/cp.keys/cp.hover/cp.focus/cp.dblclick/cp.check/cp.uncheck/cp.get/cp.extract/cp.eval/cp.network/cp.frames/cp.wait/cp.upload/cp.drag/cp.scroll/cp.back/cp.screenshot/cp.insert/cp.cdp/cp.cookies/cp.window.close/cp.tab.*(list|new|select|close|bind|unbind)。参数 JSON 内 "__tab":"<tabId>" 定向 tab')).action(async (command, argsJson, opts) => cmdControl(command, argsJson, opts));
 common(extensionCommand
     .command('goto <url>')
-    .description('导航到指定 URL (对应 chromepilot control cp.goto)'))
+    .description('导航到指定 URL (对应 chromepilot control cp.goto;同 URL 默认复用返回 reused:true,--reload 强制刷新)'))
     .option('--wait-until <mode>', 'domcontentloaded|load|networkidle0|networkidle2')
+    .option('--reload', '同 URL 时也强制 location.reload()(FID-077 复用+强制重载模式)')
     .action(async (url, opts) => cmdGoto(url, opts));
 common(extensionCommand
     .command('eval <expression>')
@@ -410,6 +415,6 @@ common(extensionCommand
     .action(async (opts) => cmdScreenshot(opts));
 common(extensionCommand
     .command('run <site> <command>')
-    .description('站点适配器命令 (对应 chromepilot run): linkedin search|extract|invite 或 resume extract'))
+    .description('站点适配器命令 (对应 chromepilot run): linkedin search|extract|invite、liepin search|extract 或 resume extract'))
     .option('--args <json>', '命令参数 JSON 字符串')
     .action(async (site, command, opts) => cmdRun(site, command, opts));

package/dist/commands/extras.d.ts

@@ -1,8 +1,23 @@
 import { Command } from 'commander';
+/** 目录最新 mtime(recursive);不可读返回 0。供前视守卫与静止等待共用 */
+export declare function latestMtimeMs(dir: string): number;
+export declare function waitForExtensionDirQuiet(dir: string, opts?: {
+    quietMs?: number;
+    maxWaitMs?: number;
+    pollMs?: number;
+}): Promise<{
+    quiet: boolean;
+    waitedMs: number;
+    newestMtimeMs: number;
+}>;
+/** FID-092:轮询 server 已连接扩展数(>=1 即判定 reload 后已回连)。 */
+export declare function extensionConnectedCount(serverUrl: string, timeoutMs?: number): Promise<number>;
 /**
- * 通知所有已连接扩展 reload（自愈主链路）:
- * 1) 优先 HTTP POST /system/broadcast-extension（返回明确 broadcast 计数和错误）
- * 2) Fallback: 直连 WS /ws 发 {type:'broadcast', payload:{type:'reload'}}（兼容旧 server 无 HTTP 端点）
+ * 通知所有已连接扩展 reload（自愈主链路）,FID-092 三段式:
+ * 1) dist 静止确认(防 reload 读到写一半的扩展文件)
+ * 2) 广播(broadcastReload):优先 HTTP POST /system/broadcast-extension;
+ *    旧 server 无该端点时退回直连 WS /ws 广播
+ * 3) 健康校验 + 自动重试(广播后 12s 内未回连 → 再广播,最多 3 次)
  */
 export declare function runReload(timeoutMs?: number): Promise<{
     broadcast: number;

package/dist/commands/extras.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import WebSocket from 'ws';
 import * as readline from 'readline';
-import { loadConfig } from '../config.js';
+import { loadConfig, resolveDataDir } from '../config.js';
 import axios from 'axios';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -10,12 +10,162 @@ import { runStop, tryReadPid } from './server.js';
 import { i18n } from '../i18n/index.js';
 import { getCliLogger } from '../logger.js';
 /**
- * 通知所有已连接扩展 reload（自愈主链路）:
- * 1) 优先 HTTP POST /system/broadcast-extension（返回明确 broadcast 计数和错误）
- * 2) Fallback: 直连 WS /ws 发 {type:'broadcast', payload:{type:'reload'}}（兼容旧 server 无 HTTP 端点）
+ * FID-092:扫描扩展目录最新 mtime,等待其静止——reload 广播前确认 dist 已写完。
+ * 背景:R5 实机 reload 后 3 秒 dist 仍在写入,Chrome 重读读到写了一半的
+ * service-worker.js → SW eval 崩溃 → 无 alarm 监听/无 offscreen/零重连,
+ * 所有自愈路径全部失效,只能人工点。Windows 兼容:纯 node fs,无 shell。
+ */
+const newestMtime = (d) => {
+    let latest = 0;
+    let entries;
+    try {
+        entries = fs.readdirSync(d, { withFileTypes: true });
+    }
+    catch {
+        return latest; // 目录不可读(未安装/权限)时不阻塞 reload
+    }
+    for (const e of entries) {
+        const full = path.join(d, e.name);
+        try {
+            if (e.isDirectory()) {
+                latest = Math.max(latest, newestMtime(full));
+            }
+            else {
+                latest = Math.max(latest, fs.statSync(full).mtimeMs);
+            }
+        }
+        catch {
+            /* 单个文件竞态删除,跳过 */
+        }
+    }
+    return latest;
+};
+/** 目录最新 mtime(recursive);不可读返回 0。供前视守卫与静止等待共用 */
+export function latestMtimeMs(dir) {
+    return newestMtime(dir);
+}
+export async function waitForExtensionDirQuiet(dir, opts = {}) {
+    const quietMs = opts.quietMs ?? 2500;
+    const maxWaitMs = opts.maxWaitMs ?? 15000;
+    const pollMs = opts.pollMs ?? 400;
+    const start = Date.now();
+    let newest = newestMtime(dir);
+    while (newest > 0 && Date.now() - newest < quietMs && Date.now() - start < maxWaitMs) {
+        await new Promise((r) => setTimeout(r, pollMs));
+        newest = newestMtime(dir);
+    }
+    return { quiet: newest === 0 || Date.now() - newest >= quietMs, waitedMs: Date.now() - start, newestMtimeMs: newest };
+}
+/** FID-092:轮询 server 已连接扩展数(>=1 即判定 reload 后已回连)。 */
+export async function extensionConnectedCount(serverUrl, timeoutMs = 3000) {
+    try {
+        const r = await axios.get(`${serverUrl}/extensions`, { timeout: timeoutMs, proxy: false });
+        return Array.isArray(r.data) ? r.data.length : 0;
+    }
+    catch {
+        return -1; // server 不可达
+    }
+}
+/**
+ * 通知所有已连接扩展 reload（自愈主链路）,FID-092 三段式:
+ * 1) dist 静止确认(防 reload 读到写一半的扩展文件)
+ * 2) 广播(broadcastReload):优先 HTTP POST /system/broadcast-extension;
+ *    旧 server 无该端点时退回直连 WS /ws 广播
+ * 3) 健康校验 + 自动重试(广播后 12s 内未回连 → 再广播,最多 3 次)
  */
 export async function runReload(timeoutMs = 5000) {
     const config = loadConfig();
+    // FID-092 步骤 1:dist 静止确认(软链/目录均可,扫描真实路径)
+    let extDir;
+    try {
+        extDir = fs.realpathSync(path.join(resolveDataDir(), 'extension'));
+    }
+    catch {
+        extDir = path.join(resolveDataDir(), 'extension');
+    }
+    const VERIFY_WINDOW_MS = 12000;
+    const MAX_ATTEMPTS = 3;
+    // FID-093 前视守卫:dist 静止确认只看"过去",构建中(tsc 编译 shared 等
+    // 数分钟不碰 extension dist)会误判静止 → 广播后构建 resumed 写 dist →
+    // 重载的扩展读到半写完文件 → SW eval 崩溃死透(2026-09-10 实机事故)。
+    // 对策:回连后监视 dist 一个窗口期,发现仍在写入 → 判本次 reload 中毒,
+    // 等静止后重播(有界)。
+    const POISON_WINDOW_MS = 10_000;
+    const POISON_POLL_MS = 500;
+    const MAX_POISON_REBROADCAST = 2;
+    const quietNotes = [];
+    let last = { broadcast: 0, msg: '' };
+    let poisonRebroadcasts = 0;
+    while (true) {
+        const q = await waitForExtensionDirQuiet(extDir);
+        if (q.waitedMs > 500)
+            quietNotes.push(`(等待 dist 写入静止 ${q.waitedMs}ms)`);
+        const m0 = latestMtimeMs(extDir);
+        // FID-092 步骤 2+3:广播 → 校验回连 → 失败重试
+        last = await broadcastReload(config, timeoutMs);
+        if (last.broadcast <= 0) {
+            return { ...last, msg: `${quietNotes.join(' ')}${last.msg}` };
+        }
+        const start = Date.now();
+        let connected = 0;
+        while (Date.now() - start < VERIFY_WINDOW_MS) {
+            await new Promise((r) => setTimeout(r, 1000));
+            const n = await extensionConnectedCount(config.serverUrl);
+            if (n > 0) {
+                connected = n;
+                break;
+            }
+            if (n === -1)
+                break; // server 挂了,重试无意义
+        }
+        if (connected <= 0)
+            break; // 走下方未回连重试路径
+        // 回连成功 → 前视窗口监视 dist 是否被构建 resumed 写入
+        const poisonDeadline = Date.now() + POISON_WINDOW_MS;
+        let poisoned = false;
+        while (Date.now() < poisonDeadline) {
+            await new Promise((r) => setTimeout(r, POISON_POLL_MS));
+            if (latestMtimeMs(extDir) > m0) {
+                poisoned = true;
+                break;
+            }
+        }
+        if (!poisoned) {
+            return {
+                ...last,
+                msg: `${quietNotes.join(' ')}${last.msg}；已校验扩展回连(connected=${connected})。`,
+            };
+        }
+        if (poisonRebroadcasts >= MAX_POISON_REBROADCAST) {
+            return {
+                ...last,
+                msg: `${quietNotes.join(' ')}${last.msg}；已回连,但 dist 在回连后仍持续被写入(构建进行中),` +
+                    `重播 ${MAX_POISON_REBROADCAST} 次后仍在写——reload 可能再次读到半写完文件,请等构建结束后再执行 hunter-mate reload。`,
+            };
+        }
+        poisonRebroadcasts++;
+        quietNotes.push(`(回连后发现 dist 仍在写入:构建 resumed,等静止后第 ${poisonRebroadcasts} 次重播)`);
+    }
+    // 未回连:重试广播(第一次读到的可能是写了一半的文件,重读即恢复)
+    for (let attempt = 2; attempt <= MAX_ATTEMPTS; attempt++) {
+        await new Promise((r) => setTimeout(r, 1000));
+        last = await broadcastReload(config, timeoutMs);
+        if (last.broadcast <= 0)
+            break;
+        const deadline = Date.now() + VERIFY_WINDOW_MS;
+        while (Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, 1000));
+            if ((await extensionConnectedCount(config.serverUrl)) > 0) {
+                return { ...last, msg: `${quietNotes.join(' ')}第 ${attempt} 次广播后已校验扩展回连。` };
+            }
+        }
+    }
+    return {
+        ...last,
+        msg: `${quietNotes.join(' ')}${MAX_ATTEMPTS} 次广播后扩展仍未回连(server /extensions=0)——扩展可能处于错误态,请到 chrome://extensions 查看 HunterMate「错误」并点「重新加载」。`,
+    };
+}
+async function broadcastReload(config, timeoutMs = 5000) {
     // ---------- 1) HTTP 优先（POST /system/broadcast-extension） ----------
     try {
         const res = await axios.post(`${config.serverUrl}/system/broadcast-extension`, { payload: { type: 'reload' } }, { timeout: timeoutMs, proxy: false });
@@ -29,6 +179,13 @@ export async function runReload(timeoutMs = 5000) {
                 msg: `reload 广播已通过 HTTP 通道发送给 ${broadcast} 个扩展实例：200ms 后每个实例会自动调 chrome.runtime.reload()，Chrome 将重新读取磁盘上的扩展文件。`,
             };
         }
+        // FID-086 deferred reload: server 已挂起意图,扩展重连(≤30s)自动下发——断连态不失败、不静默
+        if (body.queued) {
+            return {
+                broadcast: 0,
+                msg: '扩展当前未连接,重载请求已挂起:扩展重连(通常 ≤30 秒,chrome.alarms 唤醒)后将自动重新加载。无需手动干预。',
+            };
+        }
         if (errors.length) {
             return {
                 broadcast: 0,
@@ -143,7 +300,7 @@ export const openExtCommand = new Command('open-extension-folder')
 // ---------------------------------------------------------------------------
 // purge — 彻底清理本地 hunter-mate 数据
 // ---------------------------------------------------------------------------
-const HM_ROOT = () => path.join(process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.', '.hunter-mate');
+const HM_ROOT = resolveDataDir;
 /** 交互式二次确认 */
 function confirmPrompt(question) {
     return new Promise((resolve) => {

package/dist/commands/init.d.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-/** 对应 ChromePilot init: 创建 ~/.hunter-mate 目录、SQLite、初始 token */
+/** 对应 ChromePilot init: 创建数据目录、SQLite、初始 token(目录位置随 dataDir 配置,FID-071) */
 export declare function runInit(force?: boolean): {
     dir: string;
     extensionDir: string;

package/dist/commands/init.js

@@ -1,12 +1,11 @@
 import { Command } from 'commander';
 import * as fs from 'fs';
 import * as path from 'path';
-import { ensureConfigDir, loadConfig, saveConfig } from '../config.js';
+import { ensureConfigDir, loadConfig, saveConfig, resolveDataDir } from '../config.js';
 import { getCliLogger } from '../logger.js';
-/** 对应 ChromePilot init: 创建 ~/.hunter-mate 目录、SQLite、初始 token */
+/** 对应 ChromePilot init: 创建数据目录、SQLite、初始 token(目录位置随 dataDir 配置,FID-071) */
 export function runInit(force = false) {
-    const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-    const ROOT = path.join(HOME, '.hunter-mate');
+    const ROOT = resolveDataDir();
     const EXT_DIR = path.join(ROOT, 'extension');
     const DB_FILE = path.join(ROOT, 'hunter-mate.db');
     const SESSIONS_DIR = path.join(ROOT, 'sessions');

package/dist/commands/install.d.ts

@@ -1,8 +1,13 @@
 import { Command } from 'commander';
+/** 对应 ChromePilot install: 把内置 extension dist 同步到 ~/.hunter-mate/extension
+ *  (Issue #23 起走 syncExtensionArtifacts:checksum 比对 + 剪枝,不再只增不剪) */
 export declare function runInstall(target?: string): {
     source: string | null;
     target: string;
     copied: number;
+    removed: number;
+    skipped: boolean;
+    reason?: string;
 };
 /** 友好引导: 告诉用户如何在 Chrome 中加载 Hunter Mate 扩展 */
 export declare function showInstallGuide(extDir: string): void;

package/dist/commands/install.js

@@ -1,50 +1,22 @@
 import { Command } from 'commander';
-import * as fs from 'fs';
 import * as path from 'path';
-import { fileURLToPath } from 'node:url';
 import { runInit } from './init.js';
-import { findBundledAssets } from '../bundled-assets.js';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-/** 对应 ChromePilot install: 把内置 extension dist 复制到 ~/.hunter-mate/extension */
-function resolveBuiltinExtensionDist() {
-    // 优先 bundled-assets(npm 安装模式:dist/assets/extension 已存在)
-    const bundled = findBundledAssets();
-    if (bundled)
-        return bundled.extensionDir;
-    // fallback:monorepo 并列路径(老 hunter-mate 开发模式)
-    const candidates = [
-        path.resolve(__dirname, '../../../extension/dist'), // monorepo: packages/cli/dist/commands -> packages/extension/dist
-        path.resolve(__dirname, '../../bundled-extension'), // bundled
-    ];
-    for (const c of candidates)
-        if (fs.existsSync(c))
-            return c;
-    return null;
-}
+import { compareExtensionArtifacts, syncExtensionArtifacts } from '../extension-sync.js';
+/** 对应 ChromePilot install: 把内置 extension dist 同步到 ~/.hunter-mate/extension
+ *  (Issue #23 起走 syncExtensionArtifacts:checksum 比对 + 剪枝,不再只增不剪) */
 export function runInstall(target) {
     const init = runInit();
     const targetDir = target ?? init.extensionDir;
-    if (!fs.existsSync(targetDir))
-        fs.mkdirSync(targetDir, { recursive: true });
-    const source = resolveBuiltinExtensionDist();
-    let copied = 0;
-    if (source) {
-        const copy = (src, dst) => {
-            const st = fs.statSync(src);
-            if (st.isDirectory()) {
-                if (!fs.existsSync(dst))
-                    fs.mkdirSync(dst, { recursive: true });
-                for (const f of fs.readdirSync(src))
-                    copy(path.join(src, f), path.join(dst, f));
-            }
-            else {
-                fs.copyFileSync(src, dst);
-                copied++;
-            }
-        };
-        copy(source, targetDir);
-    }
-    return { source, target: targetDir, copied };
+    const cmp = compareExtensionArtifacts(targetDir);
+    const r = syncExtensionArtifacts({ target: targetDir, ensureTarget: true });
+    return {
+        source: cmp.source,
+        target: targetDir,
+        copied: r.copied,
+        removed: r.removed,
+        skipped: !r.synced,
+        reason: r.reason,
+    };
 }
 const B = {
     reset: '\x1b[0m', bold: '\x1b[1m',
@@ -84,7 +56,15 @@ export const installCommand = new Command('install')
             `   目标目录已准备好: ${B.cyan}${r.target}${B.reset}`);
         return;
     }
-    console.log(`${B.green}✓  hunter-mate install OK: ${r.copied} files${B.reset} → ${B.cyan}${r.target}${B.reset}`);
+    if (r.skipped && r.reason === 'identical') {
+        console.log(`${B.green}✓  扩展产物已是最新,无需同步${B.reset} → ${B.cyan}${r.target}${B.reset}`);
+    }
+    else if (r.skipped) {
+        console.log(`${B.yellow}⚠  扩展产物同步跳过: ${r.reason}${B.reset} → ${B.cyan}${r.target}${B.reset}`);
+    }
+    else {
+        console.log(`${B.green}✓  hunter-mate install OK: copied=${r.copied}, removed=${r.removed}${B.reset} → ${B.cyan}${r.target}${B.reset}`);
+    }
     // 自动打开扩展所在目录(父目录),方便用户把 extension 文件夹拖到 chrome://extensions
     if (opts.open !== false) {
         try {

package/dist/commands/issue-env.d.ts

@@ -0,0 +1,23 @@
+import { Command } from 'commander';
+export interface IssueEnvGitInfo {
+    repoRoot: string;
+    head: string | null;
+    branch: string | null;
+    /** 最近一次提交(短 hash + 时间 + subject),与 issue 模板「代码 HEAD」行对应 */
+    lastCommit: string | null;
+    /** 有未提交改动 = dist 可能滞后于 HEAD,提 issue 必须注明 */
+    dirty: boolean;
+}
+export interface IssueEnvResult {
+    cliVersion: string;
+    /** dev = CLI 位于 git 工作区(软链/shim 到源码仓);package = 发布包安装 */
+    installType: 'dev' | 'package';
+    git: IssueEnvGitInfo | null;
+    /** server 未运行时为 null */
+    serverBuildTime: string | null;
+    os: string;
+    node: string;
+    dataDir: string;
+}
+export declare function runIssueEnv(): Promise<IssueEnvResult>;
+export declare const issueEnvCommand: Command;

package/dist/commands/issue-env.js

@@ -0,0 +1,101 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+import axios from 'axios';
+import { i18n } from '../i18n/index.js';
+import { loadConfig, resolveDataDir } from '../config.js';
+import { readInstalledVersions } from '../version.js';
+// dev 软链/shim 安装时 __dirname 位于仓内(packages/cli/dist/commands),
+// 发布包安装时位于全局 node_modules —— 向上找含 .git 的目录即可判定并定位仓根。
+const START_DIR = path.dirname(fileURLToPath(import.meta.url));
+function findRepoRoot(start) {
+    let dir = start;
+    while (true) {
+        if (fs.existsSync(path.join(dir, '.git')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** 静默执行 git,失败(git 不可用/非工作区)返回 null */
+function git(args, cwd) {
+    try {
+        const out = execFileSync('git', args, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function runIssueEnv() {
+    const installed = readInstalledVersions();
+    const repoRoot = findRepoRoot(START_DIR);
+    let gitInfo = null;
+    if (repoRoot) {
+        const porcelain = git(['status', '--porcelain'], repoRoot) ?? '';
+        gitInfo = {
+            repoRoot,
+            head: git(['rev-parse', '--short', 'HEAD'], repoRoot),
+            branch: git(['branch', '--show-current'], repoRoot),
+            lastCommit: git(['log', '-1', '--format=%h %ci %s'], repoRoot),
+            dirty: porcelain.length > 0,
+        };
+    }
+    let serverBuildTime = null;
+    try {
+        const r = await axios.get(`${loadConfig().serverUrl}/health`, { timeout: 2000 });
+        serverBuildTime = r.data?.buildTime ?? null;
+    }
+    catch {
+        /* server 未运行,保持 null */
+    }
+    return {
+        cliVersion: installed.cli ?? 'unknown',
+        installType: repoRoot ? 'dev' : 'package',
+        git: gitInfo,
+        serverBuildTime,
+        os: `${os.platform()} ${os.release()} ${os.arch()}`,
+        node: process.version,
+        dataDir: resolveDataDir(),
+    };
+}
+function renderText(r) {
+    const lines = [];
+    lines.push(`${i18n.t('issueEnv.cliVersion')}: ${r.cliVersion}`);
+    lines.push(`${i18n.t('issueEnv.installType')}: ` +
+        (r.installType === 'dev' ? i18n.t('issueEnv.installDev') : i18n.t('issueEnv.installPackage')));
+    if (r.git) {
+        lines.push(`${i18n.t('issueEnv.gitHead')}: ${r.git.lastCommit ?? r.git.head ?? 'unknown'}`);
+        lines.push(`${i18n.t('issueEnv.gitBranch')}: ${r.git.branch ?? 'unknown'} · ` +
+            (r.git.dirty ? i18n.t('issueEnv.gitDirty') : i18n.t('issueEnv.gitClean')));
+        lines.push(`${i18n.t('issueEnv.repoRoot')}: ${r.git.repoRoot}`);
+    }
+    else {
+        lines.push(`${i18n.t('issueEnv.gitHead')}: ${i18n.t('issueEnv.gitUnavailable')}`);
+    }
+    lines.push(`${i18n.t('issueEnv.serverBuildTime')}: ${r.serverBuildTime ?? i18n.t('issueEnv.serverNotRunning')}`);
+    lines.push(`OS: ${r.os}`);
+    lines.push(`Node: ${r.node}`);
+    lines.push(`dataDir: ${r.dataDir}`);
+    return lines.join('\n');
+}
+export const issueEnvCommand = new Command('issue-env')
+    .description(i18n.t('issueEnv.description'))
+    .option('-f, --format <fmt>', '输出格式: text|json', 'text')
+    .action(async (opts) => {
+    const result = await runIssueEnv();
+    if (opts.format === 'json') {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(renderText(result));
+});

package/dist/commands/job.d.ts

@@ -3,8 +3,9 @@ export interface CreateJobCaseResult {
     id: number;
     externalId: string;
     status: string;
+    customerId?: number;
 }
-export declare function runJobCreate(folderPath: string): Promise<CreateJobCaseResult>;
+export declare function runJobCreate(folderPath: string, customerRef?: string): Promise<CreateJobCaseResult>;
 /**
  * 优先查 server 的 /job-cases;server 不可达或未登录时兜底本地 sqlite 缓存。
  */