hunter-mate 0.1.7 → 0.1.8

package/dist/commands/case.js

@@ -0,0 +1,101 @@
+import { Command } from 'commander';
+import axios from 'axios';
+import { loadConfig } from '../config.js';
+import { getToken } from '../keychain.js';
+import { printCommandError } from '../utils/command-error.js';
+import { resolveCustomer } from './customer.js';
+async function authedHeaders() {
+    const token = await getToken().catch(() => undefined);
+    return token ? { Authorization: `UTOKEN ${token}` } : {};
+}
+async function getMergedPreferences(scope, scopeId, customerId) {
+    const config = loadConfig();
+    const res = await axios.get(`${config.serverUrl}/preferences`, {
+        params: { scope, scopeId, ...(customerId ? { customerId } : {}) },
+        headers: await authedHeaders(),
+        proxy: false,
+    });
+    return res.data;
+}
+/**
+ * 记忆完整性探针:推荐前自检用。
+ * 输出 customer / positions / memory(备注+不合适原因) / preferences(三层) / missing(缺口清单,空=完整)。
+ */
+export async function runCaseCheck(customerRef, jobExternalId) {
+    const related = await resolveCustomer(customerRef);
+    if (!related) {
+        return {
+            customer: { known: false, ref: customerRef },
+            positions: [],
+            memory: { remarksCount: 0, lastRemarkAt: null, rejectedReasons: [] },
+            preferences: { user: [], customer: [], case: [] },
+            missing: [`客户 "${customerRef}" 未入库 — 先运行: hunter-mate customer upsert --name "${customerRef}"`],
+        };
+    }
+    const { customer, jobCases, remarks } = related;
+    let jobCase = null;
+    if (jobExternalId) {
+        jobCase = jobCases.find((j) => j.externalId === jobExternalId || String(j.id) === String(jobExternalId)) ?? null;
+    }
+    else if (jobCases.length) {
+        // 未指定 --job 时取最新职位 case 做三层检查;否则 scope 退化为 customer,
+        // case 层永远空数组、case 层缺口检测失效(RS 模拟 R2 抓出)
+        jobCase = [...jobCases].sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())[0];
+    }
+    const prefs = await getMergedPreferences(jobCase ? 'case' : 'customer', jobCase ? jobCase.id : customer.id, customer.id).catch(() => ({ case: [], customer: [], user: [] }));
+    const feedbackRemarks = remarks.filter((r) => r.category === 'feedback');
+    const rejectedReasons = [
+        ...feedbackRemarks
+            .map((r) => ({ source: 'remark', content: String(r.content).slice(0, 200), at: r.createdAt })),
+        ...prefs.case
+            .filter((p) => p.dimension === 'reject_reason')
+            .map((p) => ({ source: 'preference', content: JSON.stringify(p.value), at: p.updatedAt })),
+    ];
+    const missing = [];
+    if (!jobCases.length)
+        missing.push(`客户 ${customer.canonicalName} 无关联职位 — 职位入库时带 --customer`);
+    if (jobCase && !prefs.case.length)
+        missing.push(`职位 "${jobCase.title ?? jobCase.externalId}" 无 case 层画像偏好 — 寻访后 preference set --scope case`);
+    if (!prefs.customer.length)
+        missing.push(`客户 ${customer.canonicalName} 无客户层偏好 — 沟通反馈后 preference set --scope customer`);
+    if (!remarks.length)
+        missing.push(`客户 ${customer.canonicalName} 无任何备注记录 — 推荐/反馈后 note add --target customer --id ${customer.id}`);
+    if (remarks.length && !feedbackRemarks.length)
+        missing.push('无 category=feedback 的反馈记录(过往推荐/不合适原因)');
+    return {
+        customer: {
+            known: true,
+            id: customer.id,
+            canonicalName: customer.canonicalName,
+            aliases: customer.aliases ?? [],
+        },
+        positions: jobCases.map((j) => ({ id: j.id, externalId: j.externalId, title: j.title, status: j.status, createdAt: j.createdAt })),
+        jobCase: jobCase ? { id: jobCase.id, externalId: jobCase.externalId, title: jobCase.title } : null,
+        memory: {
+            remarksCount: remarks.length,
+            lastRemarkAt: remarks[0]?.createdAt ?? null,
+            rejectedReasons,
+        },
+        preferences: prefs,
+        missing,
+    };
+}
+export const caseCommand = new Command('case').description('职位 case 记忆完整性检查(推荐前自检 / agent 流程判据)');
+caseCommand
+    .command('check')
+    .requiredOption('--customer <nameOrId>', '客户名或 id')
+    .option('--job <externalId>', '职位 externalId 或 id(可选,细查单个 case)')
+    .option('--json', 'JSON 输出(默认)')
+    .action(async (opts) => {
+    try {
+        const report = await runCaseCheck(opts.customer, opts.job);
+        console.log(JSON.stringify(report, null, 2));
+        if (!opts.json && report.missing.length) {
+            console.error(`\n⚠ ${report.missing.length} 个记忆缺口(见 missing 字段)`);
+        }
+    }
+    catch (err) {
+        printCommandError('case:check-failed', err);
+        process.exit(1);
+    }
+});

package/dist/commands/config.d.ts

@@ -3,11 +3,15 @@ export interface ConfigOptions {
     serverUrl?: string;
     watchFolder?: string;
     lang?: string;
+    dataDir?: string;
+    harnessPath?: string;
 }
 export declare function runConfig(options: ConfigOptions): {
     serverUrl: string;
     saasUrl: string;
     lang: string;
     watchFolder?: string;
+    dataDir?: string;
+    harnessPath?: string;
 };
 export declare const configCommand: Command;

package/dist/commands/config.js

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { saveConfig } from '../config.js';
+import { saveConfig, resolveDataDir } from '../config.js';
 import { i18n } from '../i18n/index.js';
 export function runConfig(options) {
     const updates = {};
@@ -9,6 +9,10 @@ export function runConfig(options) {
         updates.watchFolder = options.watchFolder;
     if (options.lang)
         updates.lang = options.lang;
+    if (options.dataDir)
+        updates.dataDir = options.dataDir;
+    if (options.harnessPath)
+        updates.harnessPath = options.harnessPath;
     const saved = saveConfig(updates);
     return saved;
 }
@@ -17,7 +21,10 @@ export const configCommand = new Command('config')
     .option('--server-url <url>', 'Server URL')
     .option('--watch-folder <path>', 'Watch folder for job cases')
     .option('--lang <lang>', 'Output language')
+    .option('--data-dir <path>', '重数据目录(数据库/日志/缓存等);迁移已有数据用 migrate-data-dir')
+    .option('--harness-path <path>', 'hunter-mate-harness 仓绝对路径(adapter sync 的 overlay 真相源;env HUNTER_MATE_HARNESS_PATH 优先)')
     .action((options) => {
     runConfig(options);
     console.log(i18n.t('config.saved'));
+    console.log(`dataDir: ${resolveDataDir()}`);
 });

package/dist/commands/customer.d.ts

@@ -0,0 +1,25 @@
+import { Command } from 'commander';
+export declare function runCustomerUpsert(opts: {
+    name: string;
+    alias?: string;
+    type?: string;
+    status?: string;
+    notes?: string;
+}): Promise<{
+    customer: any;
+    created: boolean;
+    merged: boolean;
+}>;
+export declare function runCustomerList(query?: string): Promise<any[]>;
+export declare function runCustomerRelated(id: number): Promise<{
+    customer: any;
+    jobCases: any[];
+    remarks: any[];
+}>;
+/** 按名称/别名/id 解析客户,返回 related 聚合;未命中返回 null */
+export declare function resolveCustomer(nameOrId: string): Promise<{
+    customer: any;
+    jobCases: any[];
+    remarks: any[];
+} | null>;
+export declare const customerCommand: Command;

package/dist/commands/customer.js

@@ -0,0 +1,137 @@
+import { Command } from 'commander';
+import axios from 'axios';
+import { loadConfig } from '../config.js';
+import { getToken } from '../keychain.js';
+import { printCommandError } from '../utils/command-error.js';
+async function authedHeaders() {
+    const token = await getToken().catch(() => undefined);
+    return token ? { Authorization: `UTOKEN ${token}` } : {};
+}
+function emit(jsonMode, data, human) {
+    if (jsonMode) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        human();
+    }
+}
+export async function runCustomerUpsert(opts) {
+    const config = loadConfig();
+    const res = await axios.post(`${config.serverUrl}/customers`, {
+        name: opts.name,
+        aliases: opts.alias ? opts.alias.split(',').map((s) => s.trim()).filter(Boolean) : undefined,
+        typeStatus: opts.type || opts.status ? { type: opts.type, status: opts.status } : undefined,
+        notes: opts.notes,
+    }, { headers: await authedHeaders(), proxy: false });
+    return res.data;
+}
+export async function runCustomerList(query) {
+    const config = loadConfig();
+    const res = await axios.get(`${config.serverUrl}/customers`, {
+        params: query ? { query } : {},
+        headers: await authedHeaders(),
+        proxy: false,
+    });
+    return res.data;
+}
+export async function runCustomerRelated(id) {
+    const config = loadConfig();
+    const res = await axios.get(`${config.serverUrl}/customers/${id}/related`, {
+        headers: await authedHeaders(),
+        proxy: false,
+    });
+    return res.data;
+}
+/** 按名称/别名/id 解析客户,返回 related 聚合;未命中返回 null */
+export async function resolveCustomer(nameOrId) {
+    if (/^\d+$/.test(nameOrId.trim())) {
+        try {
+            return await runCustomerRelated(parseInt(nameOrId, 10));
+        }
+        catch {
+            return null;
+        }
+    }
+    const hits = await runCustomerList(nameOrId);
+    if (!hits.length)
+        return null;
+    return runCustomerRelated(hits[0].id);
+}
+export const customerCommand = new Command('customer').description('客户(用人单位)归一化入库与查询 — 推荐记忆闭环锚点');
+customerCommand
+    .command('upsert')
+    .requiredOption('--name <name>', '客户名(自动归一化去重,命中别名则合并)')
+    .option('--alias <a,b>', '额外别名,逗号分隔')
+    .option('--type <type>', '客户类型,如 enterprise/startup')
+    .option('--status <status>', '合作状态,如 active/paused')
+    .option('--notes <notes>', '备注')
+    .option('--json', 'JSON 输出(供 agent 解析)')
+    .action(async (opts) => {
+    try {
+        const result = await runCustomerUpsert(opts);
+        emit(opts.json, result, () => {
+            const { customer, created, merged } = result;
+            const tag = created ? '✓ 新建客户' : merged ? '✓ 命中已有客户(已合并别名/信息)' : '✓ 客户已存在';
+            console.log(`${tag}: [${customer.id}] ${customer.canonicalName}`);
+            if (customer.aliases?.length)
+                console.log(`  别名: ${customer.aliases.join(', ')}`);
+        });
+    }
+    catch (err) {
+        printCommandError('customer:upsert-failed', err);
+        process.exit(1);
+    }
+});
+customerCommand
+    .command('list')
+    .option('--query <q>', '按名称/别名搜索')
+    .option('--json', 'JSON 输出')
+    .action(async (opts) => {
+    try {
+        const list = await runCustomerList(opts.query);
+        emit(opts.json, list, () => {
+            if (!list.length) {
+                console.log('无客户记录');
+                return;
+            }
+            console.table(list.map((c) => ({
+                id: c.id,
+                name: c.canonicalName,
+                aliases: (c.aliases ?? []).join(','),
+                updatedAt: c.updatedAt,
+            })));
+        });
+    }
+    catch (err) {
+        printCommandError('customer:list-failed', err);
+        process.exit(1);
+    }
+});
+customerCommand
+    .command('show <id>')
+    .description('客户详情(含关联职位与备注)')
+    .option('--json', 'JSON 输出')
+    .action(async (id, opts) => {
+    try {
+        const data = await runCustomerRelated(parseInt(id, 10));
+        emit(opts.json, data, () => {
+            const { customer, jobCases, remarks } = data;
+            console.log(`[${customer.id}] ${customer.canonicalName}`);
+            if (customer.aliases?.length)
+                console.log(`别名: ${customer.aliases.join(', ')}`);
+            if (customer.notes)
+                console.log(`备注: ${customer.notes}`);
+            console.log(`职位(${jobCases.length}):`);
+            for (const j of jobCases)
+                console.log(`  - [${j.id}] ${j.title ?? j.externalId} (${j.status})`);
+            console.log(`备注记录(${remarks.length}):`);
+            for (const r of remarks.slice(0, 10)) {
+                console.log(`  - [${r.category}] ${String(r.content).slice(0, 80)}`);
+            }
+        });
+    }
+    catch (err) {
+        printCommandError('customer:show-failed', err);
+        process.exit(1);
+    }
+});

package/dist/commands/doctor.js

@@ -9,7 +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';
+import { getToken, getTokenInfo } from '../keychain.js';
 const B = {
     reset: '\x1b[0m',
     bold: '\x1b[1m',
@@ -321,12 +321,24 @@ export async function runDoctor(opts) {
             hints.push('hunter-mate login');
         }
         else if (!serverUp) {
-            loggedIn = true;
-            checks.push({
-                key: 'auth',
-                status: 'ok',
-                detail: '已登录 (server 未运行, 仅验证 token 存在性)',
-            });
+            const issuer = (await getTokenInfo())?.issuer ?? 'unknown';
+            // hmh#43: SaaS 签发的 token 存在性 ok 但 server 起来后必 401,不能笼统报"已登录"
+            if (issuer === 'saas') {
+                checks.push({
+                    key: 'auth',
+                    status: 'warn',
+                    detail: 'token 由 SaaS 签发(server 未运行,仅验证存在性);server 启动后数据面会 401,请重新登录',
+                });
+                hints.push('启动 server 后重新登录: hunter-mate login');
+            }
+            else {
+                loggedIn = true;
+                checks.push({
+                    key: 'auth',
+                    status: 'ok',
+                    detail: '已登录 (server 未运行, 仅验证 token 存在性)',
+                });
+            }
         }
         else {
             try {
@@ -342,8 +354,20 @@ export async function runDoctor(opts) {
                 const status = e?.response?.status;
                 if (status === 401 || status === 403) {
                     // 真实 fail: server 明确拒绝了这个 token
-                    checks.push({ key: 'auth', status: 'fail', detail: `token 已被 server 拒绝 (HTTP ${status}), 登录已过期或无权访问` });
-                    hints.push('重新登录: hunter-mate login');
+                    const issuer = (await getTokenInfo())?.issuer ?? 'unknown';
+                    if (issuer === 'saas') {
+                        // hmh#43: 定向诊断,不再笼统报"登录已过期"
+                        checks.push({
+                            key: 'auth',
+                            status: 'fail',
+                            detail: `token 由 SaaS 签发,被本地 server 拒绝 (HTTP ${status});登录时本地 server 未运行`,
+                        });
+                        hints.push('保持 server 运行后重新登录: hunter-mate login');
+                    }
+                    else {
+                        checks.push({ key: 'auth', status: 'fail', detail: `token 已被 server 拒绝 (HTTP ${status}), 登录已过期或无权访问` });
+                        hints.push('重新登录: hunter-mate login');
+                    }
                 }
                 else {
                     // 网络/其他原因: 标 warn,不误报 fail

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,7 +295,7 @@ 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,
             timeoutMs: opts.timeout ? Number(opts.timeout) : undefined,
@@ -305,7 +308,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 +320,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 +357,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 +385,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);
     }
 });
@@ -410,6 +413,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,27 @@
 import { Command } from 'commander';
 /**
- * 通知所有已连接扩展 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。
+ */
+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（自愈主链路）,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;