hunter-mate 0.1.2 → 0.1.4

package/dist/commands/extras.js

@@ -1,72 +1,100 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
+import { Command } from 'commander';
+import WebSocket from 'ws';
+import * as readline from 'readline';
+import { loadConfig } from '../config.js';
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import { runInit } from './init.js';
+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 端点）
+ */
+export async function runReload(timeoutMs = 5000) {
+    const config = loadConfig();
+    // ---------- 1) HTTP 优先（POST /system/broadcast-extension） ----------
+    try {
+        const res = await axios.post(`${config.serverUrl}/system/broadcast-extension`, { payload: { type: 'reload' } }, { timeout: timeoutMs, proxy: false });
+        const body = (res.data ?? {});
+        const broadcast = typeof body.broadcast === 'number' ? body.broadcast : 0;
+        const errors = Array.isArray(body.errors) ? body.errors : [];
+        if (broadcast > 0) {
+            return {
+                broadcast,
+                errors,
+                msg: `reload 广播已通过 HTTP 通道发送给 ${broadcast} 个扩展实例：200ms 后每个实例会自动调 chrome.runtime.reload()，Chrome 将重新读取磁盘上的扩展文件。`,
+            };
+        }
+        if (errors.length) {
+            return {
+                broadcast: 0,
+                errors,
+                msg: `HTTP 广播 0 个成功；错误: ${errors.map((e) => `${e.extensionId}:${e.error}`).join('; ')}。请在 chrome://extensions/ 点 HunterMate「重新加载」按钮。`,
+            };
+        }
+        // broadcast=0 且无错误 = 没有扩展连接（虽然 HTTP 通了）
+        return {
+            broadcast: 0,
+            msg: '本地 server 运行正常，但当前无已连接的 HunterMate 扩展。请启动 Chrome 并确认扩展已启用/加载；也可到 chrome://extensions/ 手动点刷新图标。',
         };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.openExtCommand = exports.reloadCommand = void 0;
-exports.runReload = runReload;
-exports.runOpenExt = runOpenExt;
-const commander_1 = require("commander");
-const ws_1 = __importDefault(require("ws"));
-const config_1 = require("../config");
-const fs = __importStar(require("fs"));
-const init_1 = require("./init");
-/** 对应 ChromePilot reload: 通过 WS 向所有已连接扩展广播 {type: 'reload'} */
-function runReload(timeoutMs = 5000) {
-    const config = (0, config_1.loadConfig)();
+    }
+    catch (e) {
+        // HTTP 不通（server 版本 < 新增 broadcast-extension 端点）→ 退回 WS 方式
+    }
+    // ---------- 2) Fallback: WS 广播方式（兼容旧 server） ----------
     const wsUrl = config.serverUrl.replace(/^http/, 'ws') + '/ws';
-    const ws = new ws_1.default(wsUrl);
+    const ws = new WebSocket(wsUrl);
     return new Promise((resolve, reject) => {
         const timer = setTimeout(() => {
             ws.terminate();
             reject(new Error('reload timeout — is server running? Try `hunter-mate start`.'));
         }, timeoutMs);
         ws.on('open', () => {
-            // 以特殊 client 身份发广播消息
             ws.send(JSON.stringify({ type: 'broadcast', payload: { type: 'reload' } }));
-            // 服务器未实现 broadcast 路由时也当作 OK（由扩展端自己实现 ws.onmessage 监听），
-            // 给用户一个可预期的输出，说明下一步
+            const onMsg = (raw) => {
+                try {
+                    const data = JSON.parse(raw.toString());
+                    if (data.type === 'broadcast_ack') {
+                        clearTimeout(timer);
+                        ws.removeAllListeners();
+                        ws.close();
+                        const count = typeof data.broadcast === 'number' ? data.broadcast : 1;
+                        const errors = Array.isArray(data.errors) ? data.errors : [];
+                        if (count > 0) {
+                            resolve({
+                                broadcast: count,
+                                errors,
+                                msg: `reload 广播已通过 WS 通道发送给 ${count} 个扩展实例：200ms 后每个实例会自动调 chrome.runtime.reload()。`,
+                            });
+                        }
+                        else {
+                            resolve({
+                                broadcast: 0,
+                                errors,
+                                msg: `WS 通道广播返回 0：${errors.length ? errors.map((e) => `${e.extensionId}:${e.error}`).join('; ') : '无已连接扩展'}。请手动 chrome://extensions 刷新。`,
+                            });
+                        }
+                    }
+                }
+                catch {
+                    /* ignore non-JSON / non-ack */
+                }
+            };
+            ws.on('message', onMsg);
+            // 300ms 后没收到 broadcast_ack → 当成功（兼容老 server 不回 ack 的情况）
             setTimeout(() => {
                 clearTimeout(timer);
+                ws.removeAllListeners();
                 ws.close();
                 resolve({
                     broadcast: 1,
-                    msg: 'reload 广播已发送。若扩展端已实现 reload 处理器，所有 Chrome 实例中的 Hunter Mate 扩展会自动重载；否则请在 chrome://extensions 点击刷新按钮。',
+                    msg: 'WS 通道 broadcast 已发送（未收到 ack，兼容旧 server）：若扩展端已实现 reload 处理器，所有 Chrome 实例中的 HunterMate 扩展会自动重载；否则请在 chrome://extensions 点击刷新按钮。',
                 });
-            }, 300);
+            }, 600);
         });
         ws.on('error', (e) => {
             clearTimeout(timer);
@@ -74,22 +102,25 @@ function runReload(timeoutMs = 5000) {
         });
     });
 }
-/** 对应 ChromePilot open-ext / open-extension-folder: 打开 ~/.hunter-mate/extension */
-async function runOpenExt(target) {
-    const init = (0, init_1.runInit)();
-    const dir = target ?? init.extensionDir;
+/** 对应 ChromePilot open-ext / open-extension-folder: 打开扩展所在目录(~/.hunter-mate),方便拖到 chrome://extensions */
+export async function runOpenExt(target) {
+    const init = runInit();
+    // 默认打开父目录,让用户能把 extension 文件夹拖进 Chrome;--target 可覆盖
+    const dir = target ?? path.dirname(init.extensionDir);
     if (!fs.existsSync(dir))
         fs.mkdirSync(dir, { recursive: true });
     try {
-        const { default: open } = await Promise.resolve().then(() => __importStar(require('open')));
+        const { default: open } = await import('open');
         await open(dir);
     }
     catch (e) {
-        console.warn(`open(3) not available: ${e.message}. 请手动打开: ${dir}`);
+        getCliLogger().warn('extras:open-failed', {
+            hint: `open(3) not available: ${e.message}. 请手动打开: ${dir}`,
+        });
     }
     return dir;
 }
-exports.reloadCommand = new commander_1.Command('reload')
+export const reloadCommand = new Command('reload')
     .description('通知所有已连接的 Chrome 扩展重新加载（对应 chromepilot reload）')
     .action(async () => {
     try {
@@ -97,15 +128,172 @@ exports.reloadCommand = new commander_1.Command('reload')
         console.log(r.msg);
     }
     catch (e) {
-        console.error(`reload error: ${e.message}`);
+        getCliLogger().error('extras:reload-failed', { error: e.message });
         process.exit(1);
     }
 });
-exports.openExtCommand = new commander_1.Command('open-extension-folder')
+export const openExtCommand = new Command('open-extension-folder')
     .alias('open-ext')
-    .description('打开 ~/.hunter-mate/extension 文件夹，方便拖到 chrome://extensions 加载（对应 chromepilot open-ext）')
+    .description('打开扩展所在目录(~/.hunter-mate)，方便把 extension 文件夹拖到 chrome://extensions 加载（对应 chromepilot open-ext）')
     .option('-t, --target <dir>', '指定自定义扩展目录')
     .action(async (opts) => {
     const dir = await runOpenExt(opts.target);
     console.log(`extension folder: ${dir}`);
 });
+// ---------------------------------------------------------------------------
+// purge — 彻底清理本地 hunter-mate 数据
+// ---------------------------------------------------------------------------
+const HM_ROOT = () => path.join(process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.', '.hunter-mate');
+/** 交互式二次确认 */
+function confirmPrompt(question) {
+    return new Promise((resolve) => {
+        // 非 TTY 环境（如管道/CI）当作未确认，需要 --force
+        if (!process.stdin.isTTY)
+            return resolve(false);
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(question, (ans) => {
+            rl.close();
+            const a = ans.trim().toLowerCase();
+            resolve(a === 'y' || a === 'yes');
+        });
+    });
+}
+/** 递归目录大小统计（用于展示将要删除的数据量） */
+function dirSize(dir) {
+    let files = 0;
+    let bytes = 0;
+    if (!fs.existsSync(dir))
+        return { files: 0, bytes: 0 };
+    const walk = (d) => {
+        for (const ent of fs.readdirSync(d, { withFileTypes: true })) {
+            const full = path.join(d, ent.name);
+            if (ent.isDirectory())
+                walk(full);
+            else if (ent.isFile()) {
+                files++;
+                try {
+                    bytes += fs.statSync(full).size;
+                }
+                catch { }
+            }
+        }
+    };
+    try {
+        walk(dir);
+    }
+    catch { }
+    return { files, bytes };
+}
+function humanSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+/**
+ * 彻底清理本地 hunter-mate：
+ * 1. 停止本地 server（若运行中）
+ * 2. 删除整个 ~/.hunter-mate 目录（含 config、token、cache DB、插件、skill、trace、日志、pid 等）
+ */
+export async function runPurge(opts) {
+    const root = HM_ROOT();
+    const exists = fs.existsSync(root);
+    // 1) 预检查：数据规模展示
+    let info = { files: 0, bytes: 0 };
+    if (exists)
+        info = dirSize(root);
+    const livePid = tryReadPid();
+    // 2) 二次确认（--force 或非交互跳过）
+    if (!opts.force) {
+        console.log([
+            i18n.t('purge.preview.title'),
+            `  ${i18n.t('purge.preview.root')}: ${root}`,
+            `  ${i18n.t('purge.preview.exists')}: ${exists ? i18n.t('purge.preview.yes') : i18n.t('purge.preview.no')}`,
+            exists
+                ? `  ${i18n.t('purge.preview.size')}: ${info.files} ${i18n.t('purge.preview.files')} / ${humanSize(info.bytes)}`
+                : '',
+            livePid
+                ? `  ${i18n.t('purge.preview.running')}: pid=${livePid} (${i18n.t('purge.preview.willStop')})`
+                : '',
+            '',
+            i18n.t('purge.preview.includes'),
+            `  - server.pid / server.log / runtime.json`,
+            `  - token.json / config.json (${i18n.t('purge.preview.loginLost')})`,
+            `  - cache.sqlite (job_cases / communication_records / search_history)`,
+            `  - plugins/ skills/ memory.json externals.json`,
+            `  - sessions/*.trace.jsonl recordings/ extension/`,
+            '',
+        ].filter(Boolean).join('\n'));
+        const ok = await confirmPrompt(i18n.t('purge.confirm.prompt'));
+        if (!ok) {
+            return {
+                ok: false,
+                skipped: true,
+                root,
+                serverStopped: null,
+                msg: i18n.t('purge.confirm.cancelled'),
+            };
+        }
+    }
+    // 3) 停止 server（先于目录删除，避免 server 还在写日志导致删不干净）
+    let serverStopResult = null;
+    if (livePid || exists && fs.existsSync(path.join(root, 'server.pid'))) {
+        serverStopResult = runStop();
+    }
+    // 4) 删除目录
+    let removedFiles = info.files;
+    let removedBytes = info.bytes;
+    if (exists) {
+        try {
+            // 再扫一遍，防止 stop 过程中又有新文件
+            const post = dirSize(root);
+            removedFiles = Math.max(removedFiles, post.files);
+            removedBytes = Math.max(removedBytes, post.bytes);
+            fs.rmSync(root, { recursive: true, force: true });
+        }
+        catch (err) {
+            return {
+                ok: false,
+                root,
+                serverStopped: serverStopResult,
+                msg: `${i18n.t('purge.error.rmFailed')}: ${err.message}`,
+            };
+        }
+    }
+    return {
+        ok: true,
+        root,
+        serverStopped: serverStopResult,
+        removedFiles,
+        removedBytes,
+        msg: exists
+            ? [
+                i18n.t('purge.done.title'),
+                `  ${i18n.t('purge.done.root')}: ${root}`,
+                `  ${i18n.t('purge.done.removed')}: ${removedFiles} ${i18n.t('purge.preview.files')} / ${humanSize(removedBytes)}`,
+                serverStopResult?.stopped
+                    ? `  ${i18n.t('purge.done.server')}: ${serverStopResult.msg}`
+                    : serverStopResult
+                        ? `  ${i18n.t('purge.done.server')}: ${serverStopResult.msg}`
+                        : '',
+                `  ${i18n.t('purge.done.next')}: \`hunter-mate init\``,
+            ].filter(Boolean).join('\n')
+            : `${i18n.t('purge.done.nothing')} (${root} ${i18n.t('purge.preview.noExist')})`,
+    };
+}
+export const purgeCommand = new Command('purge')
+    .alias('reset')
+    .alias('uninstall')
+    .description(i18n.t('purge.description'))
+    .option('-y, --force', i18n.t('purge.forceOption'))
+    .action(async (opts) => {
+    const r = await runPurge({ force: !!opts.force });
+    console.log(r.msg);
+    if (!r.ok && !r.skipped)
+        process.exit(1);
+    if (r.skipped)
+        process.exit(2);
+});

package/dist/commands/init.js

@@ -1,53 +1,17 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initCommand = void 0;
-exports.runInit = runInit;
-const commander_1 = require("commander");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const config_1 = require("../config");
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { ensureConfigDir, loadConfig, saveConfig } from '../config.js';
+import { getCliLogger } from '../logger.js';
 /** 对应 ChromePilot init: 创建 ~/.hunter-mate 目录、SQLite、初始 token */
-function runInit(force = false) {
+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 EXT_DIR = path.join(ROOT, 'extension');
     const DB_FILE = path.join(ROOT, 'hunter-mate.db');
     const SESSIONS_DIR = path.join(ROOT, 'sessions');
     const TOKEN_FILE = path.join(ROOT, 'token');
-    (0, config_1.ensureConfigDir)();
+    ensureConfigDir();
     for (const d of [ROOT, EXT_DIR, SESSIONS_DIR]) {
         if (!fs.existsSync(d))
             fs.mkdirSync(d, { recursive: true });
@@ -63,21 +27,29 @@ function runInit(force = false) {
                 Math.random().toString(36).slice(2, 10) +
                 Math.random().toString(36).slice(2, 10) +
                 Date.now().toString(36);
+        // POSIX 上 mode 0o600 强制 owner-only;Windows NTFS 上 mode bit 被忽略,
+        // 由 %USERPROFILE%\.hunter-mate 目录的 ACL 兜底(默认仅当前用户可访问)。
+        // 真正安全的 Windows 路径是 keytar → Windows Credential Manager(见 keychain.ts)。
         fs.writeFileSync(TOKEN_FILE, token, { mode: 0o600 });
     }
     else {
         token = fs.readFileSync(TOKEN_FILE, 'utf-8').trim();
     }
     // 保证 serverUrl 默认值落到 config（首次）
-    (0, config_1.loadConfig)();
-    void config_1.saveConfig;
+    loadConfig();
+    void saveConfig;
     return { dir: ROOT, extensionDir: EXT_DIR, dbFile: DB_FILE, sessionsDir: SESSIONS_DIR, token };
 }
-exports.initCommand = new commander_1.Command('init')
+export const initCommand = new Command('init')
     .description('创建 ~/.hunter-mate 目录、SQLite 数据库文件、初始 token（对应 chromepilot init）')
     .option('-f, --force', '强制重建 token')
     .action((opts) => {
     const r = runInit(opts.force);
+    getCliLogger().info('init:done', {
+        dir: r.dir,
+        dbFile: r.dbFile,
+        force: !!opts.force,
+    });
     console.log(`hunter-mate init OK:`);
     console.log(`  dir:         ${r.dir}`);
     console.log(`  extension:   ${r.extensionDir} (用 \`hunter-mate install\` 写入扩展 dist)`);

package/dist/commands/install.js

@@ -1,49 +1,17 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.installCommand = void 0;
-exports.runInstall = runInstall;
-exports.showInstallGuide = showInstallGuide;
-const commander_1 = require("commander");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const init_1 = require("./init");
+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() {
-    // 约定: monorepo 中 extension dist 与 CLI 包并列 packages/extension/dist
-    // 单包发布时则 fallback 到 CLI 包内的 bundled-extension/
+    // 优先 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
@@ -53,8 +21,8 @@ function resolveBuiltinExtensionDist() {
             return c;
     return null;
 }
-function runInstall(target) {
-    const init = (0, init_1.runInit)();
+export function runInstall(target) {
+    const init = runInit();
     const targetDir = target ?? init.extensionDir;
     if (!fs.existsSync(targetDir))
         fs.mkdirSync(targetDir, { recursive: true });
@@ -83,42 +51,45 @@ const B = {
     green: '\x1b[32m', yellow: '\x1b[33m', red: '\x1b[31m', cyan: '\x1b[36m', magenta: '\x1b[35m',
 };
 /** 友好引导: 告诉用户如何在 Chrome 中加载 Hunter Mate 扩展 */
-function showInstallGuide(extDir) {
+export function showInstallGuide(extDir) {
+    const parentDir = path.dirname(extDir);
+    const folderName = path.basename(extDir);
     console.log(`\n${B.bold}${B.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━  Hunter Mate 扩展安装指引  ━━━━━━━━━━━━━━━━━━━━━━━━━━${B.reset}`);
     console.log(`\n${B.bold}扩展文件已经准备好:${B.reset}`);
-    console.log(`   ${B.cyan}${extDir}${B.reset}`);
-    console.log(`\n${B.bold}请按以下 5 步在 Chrome 中加载(约 30 秒):${B.reset}\n`);
+    console.log(`   扩展文件夹: ${B.cyan}${extDir}${B.reset}`);
+    console.log(`   已为你打开: ${B.cyan}${parentDir}${B.reset}`);
+    console.log(`\n${B.bold}请按以下 4 步在 Chrome 中加载(约 30 秒):${B.reset}\n`);
     console.log(`   ${B.magenta}①${B.reset} 打开 Chrome, 地址栏输入: ${B.cyan}chrome://extensions${B.reset}`);
     console.log(`      (hunter-mate 已帮你自动打开了这个页面)`);
     console.log(`   ${B.magenta}②${B.reset} 右上角打开「${B.bold}开发者模式${B.reset}」开关`);
-    console.log(`   ${B.magenta}③${B.reset} 点击「${B.bold}加载已解压的扩展程序${B.reset}」按钮`);
-    console.log(`   ${B.magenta}④${B.reset} 在文件选择框中选择目录: ${B.cyan}${extDir}${B.reset}`);
-    console.log(`   ${B.magenta}⑤${B.reset} Chrome 工具栏应出现 Hunter Mate 🤝 图标\n`);
+    console.log(`   ${B.magenta}③${B.reset} 把文件夹 ${B.bold}${folderName}${B.reset} 拖到 chrome://extensions 页面里`);
+    console.log(`      (也可以点击「加载已解压的扩展程序」后选择 ${B.cyan}${extDir}${B.reset})`);
+    console.log(`   ${B.magenta}④${B.reset} Chrome 工具栏应出现 Hunter Mate 🤝 图标,侧栏显示「已连接」\n`);
     console.log(`${B.bold}${B.yellow}常见问题:${B.reset}`);
     console.log(`   · 没看到「加载已解压的扩展程序」? → 先开启「开发者模式」开关`);
     console.log(`   · 加载后图标灰显? → 点击图标确认侧栏显示「已连接」`);
     console.log(`   · 扩展报权限错误? → chrome://extensions → Hunter Mate → 详情 → 允许访问所有网站`);
     console.log(`\n${B.bold}${B.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${B.reset}\n`);
 }
-exports.installCommand = new commander_1.Command('install')
-    .description('把内置 extension dist 复制到 ~/.hunter-mate/extension（对应 chromepilot install）。完成后自动打开目录并给出中文引导。')
+export const installCommand = new Command('install')
+    .description('把内置 extension dist 复制到 ~/.hunter-mate/extension（对应 chromepilot install）。完成后自动打开扩展所在目录(~/.hunter-mate)并给出中文引导，方便把 extension 文件夹拖到 chrome://extensions。')
     .option('-t, --target <dir>', '目标目录，默认 ~/.hunter-mate/extension')
     .option('--no-open', '不自动打开扩展所在目录')
     .action(async (opts) => {
     const r = runInstall(opts.target);
     if (!r.source) {
-        console.log(`${B.yellow}⚠  未找到内置 extension dist（本仓库 packages/extension 尚未构建）。${B.reset}\n` +
-            `   请先在 hunter-mate monorepo 执行:\n` +
-            `   ${B.bold}pnpm --filter @hunter-mate/extension build${B.reset}\n` +
+        console.log(`${B.yellow}⚠  hunter-mate 找不到内置 extension dist。${B.reset}\n` +
+            `   - 若你正在 monorepo 开发:执行 ${B.bold}pnpm --filter @hunter-mate/extension build${B.reset} 后重试。\n` +
+            `   - 若你已 ${B.bold}npm install -g hunter-mate${B.reset}:本 npm 包未含 extension 资产,完整终端分发包(含 extension)需联系 Hiredchina IT 索要。\n` +
             `   目标目录已准备好: ${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}`);
-    // 自动打开目录 + 引导
+    // 自动打开扩展所在目录(父目录),方便用户把 extension 文件夹拖到 chrome://extensions
     if (opts.open !== false) {
         try {
-            const { default: open } = await Promise.resolve().then(() => __importStar(require('open')));
-            open(r.target).catch(() => { });
+            const { default: open } = await import('open');
+            open(path.dirname(r.target)).catch(() => { });
         }
         catch { }
     }