hunter-mate 0.1.0

package/dist/commands/doctor.js

@@ -0,0 +1,332 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorCommand = void 0;
+exports.runDoctor = runDoctor;
+const commander_1 = require("commander");
+const axios_1 = __importDefault(require("axios"));
+const config_1 = require("../config");
+const init_1 = require("./init");
+const server_1 = require("./server");
+const install_1 = require("./install");
+const extension_1 = require("./extension");
+const native_check_1 = require("./native-check");
+const B = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    cyan: '\x1b[36m',
+    magenta: '\x1b[35m',
+};
+/** 对应 ChromePilot doctor: 全链路健康检查 — 带 auto-heal, 无感启动 server/安装扩展 */
+async function runDoctor(opts) {
+    const checks = [];
+    const hints = [];
+    const healed = [];
+    const actions = [];
+    const autoHeal = opts.autoHeal !== false; // default true
+    const interactive = opts.interactive !== false; // default true
+    // ── Banner (human 模式) ──
+    if (!opts.json) {
+        console.log(`\n${B.bold}${B.cyan}╭─────────────────────────────────────────────╮${B.reset}`);
+        console.log(`${B.bold}${B.cyan}│   HunterMate Doctor · 环境全链路自检与自愈   │${B.reset}`);
+        console.log(`${B.bold}${B.cyan}╰─────────────────────────────────────────────╯${B.reset}\n`);
+    }
+    // ── 1) 目录 & token ──
+    let initResult = null;
+    try {
+        initResult = (0, init_1.runInit)();
+        checks.push({ key: 'home_dir', status: 'ok', detail: initResult.dir });
+    }
+    catch (e) {
+        checks.push({ key: 'home_dir', status: 'fail', detail: e.message });
+        if (autoHeal && !opts.json) {
+            console.log(`${B.yellow}⚠  基础目录缺失, hunter-mate 正在自动创建...${B.reset}`);
+            initResult = (0, init_1.runInit)(true);
+            checks.push({ key: 'home_dir_auto_init', status: 'ok', detail: '已自动创建 ~/.hunter-mate 目录结构' });
+            healed.push('init_dirs');
+        }
+    }
+    if (!initResult)
+        initResult = (0, init_1.runInit)();
+    // ── 2) 扩展安装检测 + 自动安装 ──
+    const fs = require('fs');
+    const path = require('path');
+    const manifestPath = path.join(initResult.extensionDir, 'manifest.json');
+    let extInstalled = fs.existsSync(manifestPath);
+    if (extInstalled) {
+        checks.push({ key: 'extension_installed', status: 'ok', detail: `manifest.json present @ ${initResult.extensionDir}` });
+    }
+    else {
+        checks.push({ key: 'extension_installed', status: 'warn', detail: `manifest.json missing @ ${initResult.extensionDir}` });
+        if (autoHeal) {
+            if (!opts.json) {
+                console.log(`${B.yellow}⚠  扩展尚未安装, hunter-mate 正在自动执行 install...${B.reset}`);
+            }
+            const r = (0, install_1.runInstall)(initResult.extensionDir);
+            if (r.source) {
+                checks.push({ key: 'extension_auto_install', status: 'ok', detail: `已从 ${r.source} 复制 ${r.copied} 个文件到 ${r.target}` });
+                healed.push('install_extension');
+                extInstalled = true;
+            }
+            else {
+                checks.push({ key: 'extension_auto_install', status: 'warn', detail: `内置 extension dist 未构建, 无法自动安装。目标目录已准备好: ${r.target}` });
+                hints.push('请在 hunter-mate monorepo 执行: pnpm --filter @hunter-mate/extension build');
+            }
+        }
+        else {
+            hints.push('hunter-mate install');
+        }
+    }
+    // ── 2.5) 原生模块 ABI 自检(server 启动前置闸) ──
+    // better-sqlite3 按 node ABI 绑定;不匹配时 server 起来即崩且报错被后台 spawn 吞掉。
+    // 放在自动启动之前:fail 就不浪费 8s 去启动必然崩的 server。
+    const native = (0, native_check_1.checkNativeModules)();
+    for (const m of native.modules) {
+        if (m.status === 'skip') {
+            checks.push({ key: `native_${m.module}`, status: 'skip', detail: m.detail });
+            continue;
+        }
+        checks.push({
+            key: `native_${m.module}`,
+            status: m.status === 'ok' ? 'ok' : 'fail',
+            detail: m.status === 'ok' ? m.detail : `${m.detail} | 修复: ${m.hint ?? '见 TROUBLESHOOTING.md'}`,
+        });
+    }
+    // ── 3) Server 自动启动(原生模块 fail 时跳过) ──
+    const config = (0, config_1.loadConfig)();
+    let serverUp = false;
+    if (!native.ok) {
+        checks.push({ key: 'server', status: 'skip', detail: '原生模块检查未通过,跳过自动启动(修好 ABI 后重跑 doctor)' });
+        hints.push('先修复原生模块 ABI(见上方 native_* 检查项), 再重跑 hunter-mate doctor');
+    }
+    else {
+        try {
+            const r = await axios_1.default.get(`${config.serverUrl}/health`, { timeout: 3000 });
+            serverUp = true;
+            checks.push({ key: 'server', status: 'ok', detail: `${config.serverUrl} (HTTP ${r.status})` });
+        }
+        catch (e) {
+            checks.push({ key: 'server', status: 'warn', detail: `${config.serverUrl} unreachable (${e.code || e.message})` });
+            if (autoHeal) {
+                if (!opts.json) {
+                    console.log(`${B.yellow}⚠  Server 未运行, hunter-mate 正在后台自动启动...${B.reset}`);
+                }
+                const r = await (0, server_1.runStart)({ foreground: false });
+                // 等待 server 真正就绪(最多 8s)
+                for (let i = 0; i < 16; i++) {
+                    await new Promise((resolve) => setTimeout(resolve, 500));
+                    try {
+                        await axios_1.default.get(`${config.serverUrl}/health`, { timeout: 2000 });
+                        serverUp = true;
+                        break;
+                    }
+                    catch { /* keep trying */ }
+                }
+                if (serverUp) {
+                    checks.push({ key: 'server_auto_start', status: 'ok', detail: `已自动启动 server (pid=${r.pid}) on ${r.url}` });
+                    healed.push('start_server');
+                }
+                else if (!r.started && !r.pid) {
+                    // 秒死(runStart 已捕获日志尾部与排障指引)
+                    checks.push({ key: 'server_auto_start', status: 'fail', detail: r.msg });
+                    hints.push('排障: TROUBLESHOOTING.md#server-启动即崩abi(常见根因: node 与 better-sqlite3 ABI 不匹配)');
+                }
+                else {
+                    checks.push({ key: 'server_auto_start', status: 'fail', detail: `自动启动超时, server 仍不可达: ${r.msg}` });
+                    hints.push('请手动启动(前台模式看真实报错): hunter-mate start -f');
+                    hints.push('排障: TROUBLESHOOTING.md#server-启动即崩abi(常见根因: node 与 better-sqlite3 ABI 不匹配)');
+                }
+            }
+            else {
+                hints.push('hunter-mate start');
+            }
+        }
+    } // native.ok
+    // ── 4) 扩展 WebSocket 连通 ──
+    let extConnected = false;
+    try {
+        if (serverUp) {
+            await (0, extension_1.runExtensionCheck)(5000);
+            extConnected = true;
+            checks.push({ key: 'extension_ws', status: 'ok', detail: '扩展已连接, WebSocket 通道就绪' });
+        }
+        else {
+            checks.push({ key: 'extension_ws', status: 'skip', detail: 'server 未运行, 跳过扩展连通检查' });
+        }
+    }
+    catch (e) {
+        checks.push({ key: 'extension_ws', status: 'fail', detail: e.message });
+        hints.push('请在 Chrome 中加载 Hunter Mate 扩展(见下方引导)');
+        // autoHeal: 尝试打开扩展所在目录 + chrome://extensions
+        if (autoHeal) {
+            try {
+                const { default: open } = await Promise.resolve().then(() => __importStar(require('open')));
+                if (extInstalled) {
+                    if (!opts.json) {
+                        console.log(`${B.magenta}→  hunter-mate 正在为你打开扩展所在目录...${B.reset}`);
+                    }
+                    open(initResult.extensionDir).catch(() => { });
+                    healed.push('open_ext_dir');
+                }
+                if (!opts.json) {
+                    console.log(`${B.magenta}→  同时打开 Chrome 扩展管理页...${B.reset}`);
+                }
+                open('chrome://extensions').catch(() => { });
+                healed.push('open_chrome_extensions');
+            }
+            catch { }
+        }
+    }
+    // ── 5) 登录态(不强制) ──
+    try {
+        const { getToken } = await Promise.resolve().then(() => __importStar(require('../keychain')));
+        const token = await getToken();
+        checks.push({
+            key: 'auth',
+            status: token ? 'ok' : 'warn',
+            detail: token ? `已登录 (token head=${String(token).slice(0, 6)}...)` : '未登录, 数据面 API 可能受限',
+        });
+        if (!token)
+            hints.push('hunter-mate login');
+    }
+    catch (e) {
+        checks.push({ key: 'auth', status: 'skip', detail: `跳过(keychain 读取失败): ${e.message}` });
+    }
+    // ── Summary ──
+    const anyFail = checks.some((c) => c.status === 'fail');
+    const anyWarn = checks.some((c) => c.status === 'warn');
+    const summary = anyFail ? 'fail' : anyWarn ? 'warn' : 'pass';
+    // ── human output ──
+    if (!opts.json) {
+        if (healed.length) {
+            console.log(`\n${B.bold}${B.green}✓  hunter-mate 自动修复完成 (${healed.length} 项): ${healed.join(', ')}${B.reset}`);
+        }
+        console.log(`\n${B.bold}检查结果:${B.reset}`);
+        for (const c of checks) {
+            const sym = c.status === 'ok' ? `${B.green}✓${B.reset}` : c.status === 'warn' ? `${B.yellow}⚠${B.reset}` : c.status === 'fail' ? `${B.red}✗${B.reset}` : `${B.cyan}–${B.reset}`;
+            console.log(`  ${sym} [${c.status.toUpperCase()}] ${c.key}: ${c.detail}`);
+        }
+        // ── 友好中文引导(仅 human + 有问题时) ──
+        if (summary !== 'pass' || !extConnected) {
+            showFriendlyGuide(extInstalled, extConnected, serverUp, healed, initResult.extensionDir);
+        }
+        if (summary === 'pass') {
+            console.log(`\n${B.bold}${B.green}════════════════════════════════════════════${B.reset}`);
+            console.log(`${B.bold}${B.green}  HunterMate 环境就绪! 可以直接使用 extension 操作了${B.reset}`);
+            console.log(`${B.bold}${B.green}════════════════════════════════════════════${B.reset}\n`);
+        }
+        else if (summary === 'warn') {
+            console.log(`\n${B.bold}${B.yellow}⚠  环境基本就绪, 但有 ${checks.filter(c => c.status === 'warn').length} 项警告。查看上方引导。${B.reset}\n`);
+        }
+        else {
+            console.log(`\n${B.bold}${B.red}✗  环境未就绪, 请按上方引导完成修复后重试。${B.reset}\n`);
+        }
+    }
+    return { summary, checks, hints, healed, actions };
+}
+/** 友好中文引导 — 当环境不完备时给用户清晰的操作步骤 */
+function showFriendlyGuide(extInstalled, extConnected, serverUp, healed, extDir) {
+    const B = {
+        reset: '\x1b[0m', bold: '\x1b[1m',
+        green: '\x1b[32m', yellow: '\x1b[33m', red: '\x1b[31m', cyan: '\x1b[36m', magenta: '\x1b[35m',
+    };
+    console.log(`\n${B.bold}${B.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━  下一步操作指引  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━${B.reset}\n`);
+    if (!serverUp) {
+        console.log(`${B.bold}${B.red}❌ 数据面 Server 未启动${B.reset}`);
+        console.log(`   hunter-mate 已尝试自动启动。若持续失败请手动执行:`);
+        console.log(`   ${B.bold}hunter-mate start -f${B.reset}  (前台模式可看日志)\n`);
+    }
+    if (!extInstalled) {
+        console.log(`${B.bold}${B.yellow}⚠  Hunter Mate Chrome 扩展尚未安装${B.reset}`);
+        console.log(`   步骤: hunter-mate 已自动把扩展文件复制到:`);
+        console.log(`   ${B.cyan}${extDir}${B.reset}`);
+        console.log(`   ${B.bold}接下来需要你手动在 Chrome 中加载(Chrome 安全策略限制命令行自动化):${B.reset}`);
+        console.log(`   ${B.magenta}① 在 Chrome 地址栏输入:${B.reset}  chrome://extensions`);
+        console.log(`   ${B.magenta}② 打开右上角「开发者模式」开关${B.reset}`);
+        console.log(`   ${B.magenta}③ 点击「加载已解压的扩展程序」${B.reset}`);
+        console.log(`   ${B.magenta}④ 选择上面的目录:${B.reset}  ${B.cyan}${extDir}${B.reset}`);
+        console.log(`   ${B.magenta}⑤ Chrome 工具栏应出现 Hunter Mate 图标${B.reset}\n`);
+    }
+    if (extInstalled && !extConnected) {
+        console.log(`${B.bold}${B.yellow}⚠  扩展已安装但尚未连接到 Server${B.reset}`);
+        console.log(`   hunter-mate 已自动帮你打开了:`);
+        console.log(`   · 扩展所在目录: ${B.cyan}${extDir}${B.reset}`);
+        console.log(`   · Chrome 扩展管理页: ${B.cyan}chrome://extensions${B.reset}`);
+        console.log(`   ${B.bold}请确认以下几点:${B.reset}`);
+        console.log(`   ${B.magenta}① 扩展已在 chrome://extensions 中「已开启」${B.reset} (灰色开关变蓝色)`);
+        console.log(`   ${B.magenta}② 扩展详情中「允许访问的网站」设为「所有网站」或包含 LinkedIn${B.reset}`);
+        console.log(`   ${B.magenta}③ 点击 Chrome 工具栏的 Hunter Mate 图标, 确认侧栏显示「已连接」${B.reset}`);
+        console.log(`   ${B.magenta}④ 若仍无连接, 点击扩展详情的「重新加载」按钮刷新扩展${B.reset}\n`);
+    }
+    if (healed.length) {
+        console.log(`${B.bold}${B.green}✨ hunter-mate 已为你自动完成:${B.reset}`);
+        for (const h of healed) {
+            const map = {
+                init_dirs: '创建 ~/.hunter-mate 目录结构',
+                install_extension: '复制扩展文件到用户目录',
+                start_server: '后台启动 HunterMate Server',
+                open_ext_dir: '在 Finder/Explorer 中打开扩展目录',
+                open_chrome_extensions: '打开 chrome://extensions',
+            };
+            console.log(`   ${B.green}✓${B.reset} ${map[h] || h}`);
+        }
+        console.log('');
+    }
+    console.log(`${B.bold}${B.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${B.reset}\n`);
+}
+exports.doctorCommand = new commander_1.Command('doctor')
+    .description('全链路自检 + 自动修复(对应 chromepilot doctor): 自动启动 server、安装扩展、打开目录引导')
+    .option('--json', '仅以 JSON 输出检查结果与建议(跳过引导文案)')
+    .option('--open-extension-folder', '扩展未连接时自动打开扩展所在文件夹')
+    .option('--no-auto-heal', '禁用自动修复(仅检查并给出建议, 不自动启动/安装)')
+    .option('--no-interactive', '无交互模式(不打印友好引导, 仅输出结构化结果)')
+    .action(async (opts) => {
+    const r = await runDoctor({
+        json: opts.json,
+        openExtensionFolder: opts.openExtensionFolder,
+        autoHeal: opts.autoHeal !== false,
+        interactive: opts.interactive !== false,
+    });
+    if (opts.json) {
+        console.log(JSON.stringify(r, null, 2));
+    }
+    process.exit(r.summary === 'fail' ? 1 : 0);
+});

package/dist/commands/extension.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+/** 确保环境就绪(自动启动 server、自动安装扩展、打印引导) */
+export declare function ensureEnvReady(): Promise<void>;
+export declare function runExtensionCheck(timeoutMs?: number): Promise<void>;
+export declare const extensionCommand: Command;