hunter-mate 0.1.3 → 0.1.4

package/dist/commands/doctor.js

@@ -9,6 +9,7 @@ import { runInstall } from './install.js';
 import { runExtensionCheck } from './extension.js';
 import { checkNativeModules } from '../native-check.js';
 import { getCliLogger } from '../logger.js';
+import { getToken } from '../keychain.js';
 const B = {
     reset: '\x1b[0m',
     bold: '\x1b[1m',
@@ -18,6 +19,32 @@ const B = {
     cyan: '\x1b[36m',
     magenta: '\x1b[35m',
 };
+/**
+ * 调用 server /doctor/run 统一入口。
+ * 失败时返回 null,调用方决定如何处理。
+ */
+export async function runDoctorChecks(opts) {
+    const config = loadConfig();
+    const token = await getToken().catch(() => undefined);
+    const checks = opts.checks && opts.checks.length ? opts.checks : undefined;
+    const timeout = opts.timeout ?? 60_000;
+    try {
+        const { data } = await axios.post(`${config.serverUrl}/doctor/run`, {
+            checks,
+            mode: opts.fix ? 'repair' : 'check',
+            dryRun: opts.dryRun === true,
+        }, {
+            timeout,
+            headers: token ? { Authorization: `UTOKEN ${token}` } : {},
+        });
+        return data;
+    }
+    catch (e) {
+        const message = e?.response?.data?.message || e.message || String(e);
+        getCliLogger().warn('doctor:checks:failed', { error: message, fix: opts.fix, checks });
+        return null;
+    }
+}
 /** 对应 ChromePilot doctor: 全链路健康检查 — 带 auto-heal, 无感启动 server/安装扩展 */
 export async function runDoctor(opts) {
     const checks = [];
@@ -25,7 +52,7 @@ export async function runDoctor(opts) {
     const healed = [];
     const actions = [];
     const autoHeal = opts.autoHeal !== false; // default true
-    const interactive = opts.interactive !== false; // default true
+    const fix = opts.fix === true;
     // ── Banner (human 模式) ──
     if (!opts.json) {
         console.log(`\n${B.bold}${B.cyan}╭─────────────────────────────────────────────╮${B.reset}`);
@@ -184,7 +211,7 @@ export async function runDoctor(opts) {
                     if (!opts.json) {
                         console.log(`${B.magenta}→  hunter-mate 正在为你打开扩展所在目录...${B.reset}`);
                     }
-                    open(initResult.extensionDir).catch(() => { });
+                    open(path.dirname(initResult.extensionDir)).catch(() => { });
                     healed.push('open_ext_dir');
                 }
                 if (!opts.json) {
@@ -211,6 +238,35 @@ export async function runDoctor(opts) {
     catch (e) {
         checks.push({ key: 'auth', status: 'skip', detail: `跳过(keychain 读取失败): ${e.message}` });
     }
+    // ── 6) 数据面 doctor checks ──
+    let data = null;
+    if (serverUp) {
+        if (!opts.json) {
+            console.log(`\n${B.bold}${B.cyan}→  正在运行数据面检查${fix ? ' (repair 模式)' : ' (只读 check 模式)'}...${B.reset}`);
+        }
+        data = await runDoctorChecks({
+            fix,
+            checks: opts.checks,
+            json: opts.json,
+            timeout: 120_000,
+        });
+        if (data) {
+            for (const c of data.checks) {
+                const status = c.ok ? 'ok' : c.severity === 'error' ? 'fail' : 'warn';
+                checks.push({
+                    key: `data_${c.id}`,
+                    status,
+                    detail: c.message || c.description,
+                });
+            }
+        }
+        else {
+            checks.push({ key: 'data_doctor', status: 'warn', detail: '无法连接 /doctor/run (server 可能尚未就绪)' });
+        }
+    }
+    else {
+        checks.push({ key: 'data_doctor', status: 'skip', detail: 'server 未运行,跳过数据面检查' });
+    }
     // ── Summary ──
     const anyFail = checks.some((c) => c.status === 'fail');
     const anyWarn = checks.some((c) => c.status === 'warn');
@@ -247,7 +303,7 @@ export async function runDoctor(opts) {
             console.log(`\n${B.bold}${B.red}✗  环境未就绪, 请按上方引导完成修复后重试。${B.reset}\n`);
         }
     }
-    return { summary, checks, hints, healed, actions };
+    return { summary, checks, hints, healed, actions, data };
 }
 /** 友好中文引导 — 当环境不完备时给用户清晰的操作步骤 */
 function showFriendlyGuide(extInstalled, extConnected, serverUp, healed, extDir) {
@@ -261,21 +317,24 @@ function showFriendlyGuide(extInstalled, extConnected, serverUp, healed, extDir)
         console.log(`   hunter-mate 已尝试自动启动。若持续失败请手动执行:`);
         console.log(`   ${B.bold}hunter-mate start -f${B.reset}  (前台模式可看日志)\n`);
     }
+    const extParentDir = path.dirname(extDir);
+    const extFolderName = path.basename(extDir);
     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.cyan}${extParentDir}${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`);
+        console.log(`   ${B.magenta}③ 把 ${B.bold}${extFolderName}${B.reset} 文件夹拖到 chrome://extensions 页面里${B.reset}`);
+        console.log(`      (也可以点击「加载已解压的扩展程序」后选择 ${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(`   · 扩展所在目录: ${B.cyan}${extParentDir}${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} (灰色开关变蓝色)`);
@@ -304,14 +363,110 @@ export const doctorCommand = new Command('doctor')
     .option('--json', '仅以 JSON 输出检查结果与建议(跳过引导文案)')
     .option('--no-auto-heal', '禁用自动修复(仅检查并给出建议, 不自动启动/安装)')
     .option('--no-interactive', '无交互模式(不打印友好引导, 仅输出结构化结果)')
+    .option('--fix', '执行可修复的数据检查(默认只读 check)')
+    .option('--checks <ids>', '只跑指定检查,逗号分隔(如 linkedin-dupes)', (val) => val.split(',').map((s) => s.trim()).filter(Boolean))
+    .option('--list', '列出 server 上注册的数据检查项')
     .action(async (opts) => {
+    if (opts.list) {
+        const config = loadConfig();
+        try {
+            const { data } = await axios.get(`${config.serverUrl}/doctor/checks`, { timeout: 10_000 });
+            if (opts.json) {
+                console.log(JSON.stringify(data, null, 2));
+            }
+            else {
+                console.log(`\n${B.bold}${B.cyan}已注册 Doctor 检查项:${B.reset}`);
+                for (const c of data) {
+                    const fixTag = c.fixable ? `${B.green}[可修复]${B.reset}` : `${B.yellow}[只读]${B.reset}`;
+                    console.log(`  ${fixTag} ${B.bold}${c.id}${B.reset} (${c.severity})`);
+                    console.log(`     ${c.name}`);
+                    console.log(`     ${c.description}`);
+                }
+            }
+            process.exit(0);
+        }
+        catch (e) {
+            const message = e?.response?.data?.message || e.message || String(e);
+            getCliLogger().error('doctor:list failed', { message });
+            if (opts.json) {
+                console.log(JSON.stringify({ error: message }, null, 2));
+            }
+            else {
+                console.log(`${B.red}获取检查列表失败:${B.reset} ${message}`);
+            }
+            process.exit(1);
+        }
+        return;
+    }
     const r = await runDoctor({
         json: opts.json,
         autoHeal: opts.autoHeal !== false,
         interactive: opts.interactive !== false,
+        fix: opts.fix === true,
+        checks: opts.checks,
     });
     if (opts.json) {
         console.log(JSON.stringify(r, null, 2));
     }
     process.exit(r.summary === 'fail' ? 1 : 0);
 });
+export const repairLinkedInDupesCommand = new Command('repair-linkedin-dupes')
+    .description('修复 LinkedIn /in/<slug>/details/... 子页产生的重复 talent 数据')
+    .option('--dry-run', '仅预览,不真正合并/删除')
+    .option('--json', '仅输出 JSON 结果')
+    .action(async (opts) => {
+    const data = await runDoctorChecks({
+        fix: true,
+        checks: ['linkedin-dupes'],
+        dryRun: opts.dryRun === true,
+        json: opts.json,
+        timeout: 120_000,
+    });
+    if (!data) {
+        const message = '无法连接 server /doctor/run, 请确认 server 已启动';
+        getCliLogger().error('repair-linkedin-dupes failed', { message });
+        if (opts.json) {
+            console.log(JSON.stringify({ error: message }, null, 2));
+        }
+        else {
+            console.log(`修复失败: ${message}`);
+        }
+        process.exit(1);
+    }
+    const c = data.checks.find((x) => x.id === 'linkedin-dupes');
+    const details = c?.details || {};
+    const compat = {
+        dryRun: data.dryRun,
+        totalCandidates: details.totalCandidates ?? 0,
+        duplicateGroups: details.duplicateGroups ?? 0,
+        repairedCount: data.repaired?.length ?? 0,
+        merged: data.repaired ?? [],
+        summary: data.summary,
+    };
+    if (opts.json) {
+        console.log(JSON.stringify({ ...compat, raw: data }, null, 2));
+    }
+    else {
+        const B = {
+            reset: '\x1b[0m',
+            bold: '\x1b[1m',
+            green: '\x1b[32m',
+            yellow: '\x1b[33m',
+            cyan: '\x1b[36m',
+        };
+        console.log(`\n${B.bold}${B.cyan}LinkedIn 重复 talent 修复结果${B.reset}`);
+        console.log(`  模式: ${data.dryRun ? B.yellow + 'dry-run' + B.reset : B.green + '正式修复' + B.reset}`);
+        console.log(`  LinkedIn talent 总数: ${compat.totalCandidates}`);
+        console.log(`  归一组数: ${compat.duplicateGroups}`);
+        console.log(`  需合并组数: ${compat.repairedCount}`);
+        if (compat.merged.length) {
+            console.log(`\n${B.bold}合并详情:${B.reset}`);
+            for (const m of compat.merged) {
+                console.log(`  • master #${m.masterId} ← ${m.removedIds.map((id) => `#${id}`).join(', ')}`);
+                console.log(`    ${m.sourceUrl}`);
+            }
+        }
+    }
+    process.exit(0);
+});
+doctorCommand.addCommand(repairLinkedInDupesCommand);

package/dist/commands/extension.js

@@ -151,10 +151,10 @@ export function ensureEnvReady() {
                 process.exit(1);
             }
             console.log(`${B.green}✓  扩展已自动安装到 ${r.target}${B.reset}`);
-            // 打开目录引导
+            // 打开扩展所在目录(父目录),方便用户把 extension 文件夹拖到 chrome://extensions
             try {
                 const { default: open } = await import('open');
-                open(init.extensionDir).catch(() => { });
+                open(path.dirname(init.extensionDir)).catch(() => { });
             }
             catch { }
             showInstallGuide(init.extensionDir);

package/dist/commands/extras.d.ts

@@ -12,7 +12,7 @@ export declare function runReload(timeoutMs?: number): Promise<{
         error: string;
     }>;
 }>;
-/** 对应 ChromePilot open-ext / open-extension-folder: 打开 ~/.hunter-mate/extension */
+/** 对应 ChromePilot open-ext / open-extension-folder: 打开扩展所在目录(~/.hunter-mate),方便拖到 chrome://extensions */
 export declare function runOpenExt(target?: string): Promise<string>;
 export declare const reloadCommand: Command;
 export declare const openExtCommand: Command;

package/dist/commands/extras.js

@@ -102,10 +102,11 @@ export async function runReload(timeoutMs = 5000) {
         });
     });
 }
-/** 对应 ChromePilot open-ext / open-extension-folder: 打开 ~/.hunter-mate/extension */
+/** 对应 ChromePilot open-ext / open-extension-folder: 打开扩展所在目录(~/.hunter-mate),方便拖到 chrome://extensions */
 export async function runOpenExt(target) {
     const init = runInit();
-    const dir = target ?? init.extensionDir;
+    // 默认打开父目录,让用户能把 extension 文件夹拖进 Chrome;--target 可覆盖
+    const dir = target ?? path.dirname(init.extensionDir);
     if (!fs.existsSync(dir))
         fs.mkdirSync(dir, { recursive: true });
     try {
@@ -133,7 +134,7 @@ export const reloadCommand = new Command('reload')
 });
 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);

package/dist/commands/install.js

@@ -52,16 +52,19 @@ const B = {
 };
 /** 友好引导: 告诉用户如何在 Chrome 中加载 Hunter Mate 扩展 */
 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(`   · 加载后图标灰显? → 点击图标确认侧栏显示「已连接」`);
@@ -69,7 +72,7 @@ export function showInstallGuide(extDir) {
     console.log(`\n${B.bold}${B.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${B.reset}\n`);
 }
 export const installCommand = new Command('install')
-    .description('把内置 extension dist 复制到 ~/.hunter-mate/extension（对应 chromepilot 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) => {
@@ -82,11 +85,11 @@ export const installCommand = new Command('install')
         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 import('open');
-            open(r.target).catch(() => { });
+            open(path.dirname(r.target)).catch(() => { });
         }
         catch { }
     }

package/dist/index.js

@@ -76,6 +76,13 @@ program
             for (const line of report.performed)
                 console.log(chalk.gray(`  [auto-update] ${line}`));
         }
+        try {
+            const { runAutoDoctor } = await import('./auto-doctor.js');
+            await runAutoDoctor(report);
+        }
+        catch {
+            /* auto-doctor 永不阻塞主命令 */
+        }
     }
     catch {
         /* 一致性检测永不阻塞主命令 */

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "hunter-mate",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "HiredChina 猎头 Agent 数据助手 CLI:人才库/客户/职位数据访问,浏览器录制解析简历,server/扩展一致性自愈",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+github.com:hiredchina-com/hunter-mate.git"
@@ -31,7 +31,7 @@
     "open": "^8.4.0",
     "uuid": "^9.0.0",
     "ws": "^8.21.3",
-    "@hunter-mate/shared": "0.1.2"
+    "@hunter-mate/shared": "0.1.3"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",