hunter-mate 0.1.7 → 0.1.11

package/dist/commands/job.js

@@ -8,6 +8,7 @@ import { loadConfig } from '../config.js';
 import { getToken } from '../keychain.js';
 import { i18n } from '../i18n/index.js';
 import { printCommandError } from '../utils/command-error.js';
+import { runCustomerList } from './customer.js';
 /** 递归收集目录下的 .md/.txt/.pdf(含 raw/jd/ 等子目录),键为相对路径(根目录文件不带前缀)。 */
 function collectJobFiles(dir, relPrefix = '', out = {}) {
     const entries = fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
@@ -24,10 +25,27 @@ function collectJobFiles(dir, relPrefix = '', out = {}) {
     }
     return out;
 }
-export async function runJobCreate(folderPath) {
+export async function runJobCreate(folderPath, customerRef) {
     const config = loadConfig();
     const token = await getToken();
     const headers = token ? { Authorization: `UTOKEN ${token}` } : {};
+    // --customer:按名称/别名解析客户 id,让职位 case 挂到客户锚点上
+    let customerId;
+    if (customerRef) {
+        if (/^\d+$/.test(customerRef.trim())) {
+            customerId = parseInt(customerRef.trim(), 10);
+        }
+        else {
+            const hits = await runCustomerList(customerRef.trim());
+            if (!hits.length) {
+                throw new Error(`客户 "${customerRef}" 未入库,请先: hunter-mate customer upsert --name "${customerRef}"`);
+            }
+            customerId = hits[0].id;
+            if (hits.length > 1) {
+                console.error(`ℹ 客户 "${customerRef}" 命中 ${hits.length} 条,使用第一个: [${hits[0].id}] ${hits[0].canonicalName}`);
+            }
+        }
+    }
     const resolved = path.resolve(folderPath);
     if (!fs.existsSync(resolved)) {
         throw new Error(`Folder not found: ${resolved}`);
@@ -45,6 +63,7 @@ export async function runJobCreate(folderPath) {
         title,
         folderPath: resolved,
         rawFiles,
+        customerId,
     }, { headers, proxy: false });
     const serverCase = res.data;
     ensureCacheDir();
@@ -92,13 +111,14 @@ export const jobCommand = new Command('job')
 jobCommand
     .command('create <folder>')
     .description(i18n.t('job.create'))
-    .action(async (folderPath) => {
+    .option('--customer <idOrName>', '关联客户(名称/别名/id),未入库会先报错提示 upsert')
+    .action(async (folderPath, opts) => {
     try {
-        const serverCase = await runJobCreate(folderPath);
-        console.log(`Created JobCase ${serverCase.id} (${serverCase.externalId})`);
+        const serverCase = await runJobCreate(folderPath, opts.customer);
+        console.log(`Created JobCase ${serverCase.id} (${serverCase.externalId})${serverCase.customerId ? ` customer=${serverCase.customerId}` : ''}`);
     }
     catch (err) {
-        printCommandError('job:create-failed', err);
+        await printCommandError('job:create-failed', err);
         process.exit(1);
     }
 });

package/dist/commands/login.d.ts

@@ -9,6 +9,10 @@ export declare function sendEmailCode(email: string): Promise<EmailLoginSource>;
 /**
  * 邮箱登录第二步:校验验证码并保存 token。
  * 分支选择与 sendEmailCode 保持一致:server 在线走本地代理自签,否则直连 SaaS。
+ *
+ * hmh#43:两个分支签发的 token 密钥不同,必须打 issuer 标记 —
+ * SaaS fallback 拿到的是 SaaS 签发的 token,本地 server 的 AuthMiddleware
+ * (USER_SESSION_SECRET)验不过,数据面(search 等)会 401。
  */
 export declare function verifyEmailCode(email: string, code: string): Promise<{
     token: string;

package/dist/commands/login.js

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import axios from 'axios';
 import open from 'open';
 import { loadConfig } from '../config.js';
-import { saveToken } from '../keychain.js';
+import { saveToken, getToken } from '../keychain.js';
 import { i18n } from '../i18n/index.js';
 import { getCliLogger } from '../logger.js';
 function sleep(ms) {
@@ -35,6 +35,10 @@ export async function sendEmailCode(email) {
 /**
  * 邮箱登录第二步:校验验证码并保存 token。
  * 分支选择与 sendEmailCode 保持一致:server 在线走本地代理自签,否则直连 SaaS。
+ *
+ * hmh#43:两个分支签发的 token 密钥不同,必须打 issuer 标记 —
+ * SaaS fallback 拿到的是 SaaS 签发的 token,本地 server 的 AuthMiddleware
+ * (USER_SESSION_SECRET)验不过,数据面(search 等)会 401。
  */
 export async function verifyEmailCode(email, code) {
     const config = loadConfig();
@@ -43,14 +47,17 @@ export async function verifyEmailCode(email, code) {
         if (!data.access_token) {
             throw new Error('verify returned no access_token');
         }
-        await saveToken(data.access_token);
+        await saveToken(data.access_token, 'local');
         return { token: data.access_token, source: 'server' };
     }
     const { data } = await axios.post(`${config.saasUrl}/hunter-mate/auth/email/verify`, { email, code }, { proxy: false });
     if (!data.access_token) {
         throw new Error('verify returned no access_token');
     }
-    await saveToken(data.access_token);
+    await saveToken(data.access_token, 'saas');
+    console.warn('⚠️  本地 server 未运行,本次登录由 SaaS 签发 token。\n' +
+        '    本地数据面(search 等)在 server 启动后会提示登录失效;\n' +
+        '    请先运行 hunter-mate server(或 hunter-mate extension check 自动拉起)再重新登录。');
     return { token: data.access_token, source: 'saas' };
 }
 export async function runLogin() {
@@ -63,7 +70,33 @@ export async function runLogin() {
     });
     console.log(i18n.t('login.userCode'), deviceCode.user_code);
     console.log(i18n.t('login.verifyUrl'), deviceCode.verification_uri);
-    await open(deviceCode.verification_uri);
+    // 打开验证页:走扩展的 cp.tab.open(查重复用,已有同 URL 存活 tab 就不再开,
+    // 防止重复 login/多会话叠加把浏览器刷满 web.test/auth 式废 tab);
+    // 扩展/server 不可用时回退系统 open。tabId 由扩展侧记录并返回。
+    let openedVia = 'open';
+    try {
+        const { data } = await axios.post(`${config.serverUrl}/extensions/control`, {
+            command: 'cp.tab.open',
+            params: { url: deviceCode.verification_uri, active: true },
+            sessionId: 'hm-cli-login',
+            timeoutMs: 10_000,
+        }, { proxy: false, timeout: 12_000 });
+        if (data?.result?.page) {
+            openedVia = data.result.reused ? 'extension-reused' : 'extension-created';
+            getCliLogger().info('login:verify-tab', {
+                tabId: data.result.page,
+                reused: !!data.result.reused,
+                url: data.result.url ?? deviceCode.verification_uri,
+            });
+        }
+        else {
+            await open(deviceCode.verification_uri);
+        }
+    }
+    catch {
+        await open(deviceCode.verification_uri);
+    }
+    getCliLogger().info('login:verify-opened', { via: openedVia, verifyUrl: deviceCode.verification_uri });
     const maxAttempts = Math.ceil(deviceCode.expires_in / deviceCode.interval);
     for (let i = 0; i < maxAttempts; i++) {
         await sleep(deviceCode.interval * 1000);
@@ -111,6 +144,26 @@ export const loginCommand = new Command('login')
             }
             getCliLogger().info('login:token-saved', { method: 'email', email: options.email, source });
             console.log(i18n.t('login.success'));
+            // 登录后自检:拿新 token 打一次受保护端点,把「登录成功但搜索 401」的
+            // 静默失败变成确定的成功/失败提示(FID-057 #36)
+            try {
+                const token = await getToken();
+                const probe = await axios.get(`${loadConfig().serverUrl}/job-cases`, {
+                    headers: token ? { Authorization: `UTOKEN ${token}` } : {},
+                    timeout: 5000,
+                    proxy: false,
+                });
+                console.log(`${i18n.t('login.selfCheckOk')} (HTTP ${probe.status})`);
+            }
+            catch (probeErr) {
+                const status = probeErr?.response?.status;
+                if (status === 401 || status === 403) {
+                    console.error(`${i18n.t('login.selfCheckFail')} (HTTP ${status})`);
+                }
+                else {
+                    console.warn(`${i18n.t('login.selfCheckSkipped')} (HTTP ${status || 'network'})`);
+                }
+            }
             return;
         }
         if (options.code) {

package/dist/commands/migrate.d.ts

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+/**
+ * 跨卷安全移动:同卷 renameSync;rename 失败(典型 EXDEV 跨盘,Windows C:→D:)
+ * 回退递归 copy + rm。symlink 项读 link 目标后经 linkDev 重建
+ * (Windows 普通用户无 symlink 权限,junction/copy+marker 兜底)。
+ */
+export declare function moveEntry(src: string, dest: string): void;
+export interface MigrateResult {
+    from: string;
+    to: string;
+    moved: string[];
+    skipped: string[];
+    serverRestarted: boolean;
+}
+/**
+ * 数据目录迁移(FID-071):
+ * 1. server 在跑则先停(记录状态,迁移后按需重启)
+ * 2. 源目录(除 config.json 外)全部移动到目标目录
+ * 3. config.json 留在原 CONFIG_DIR,写入 dataDir=目标
+ * 4. 重启 server(若迁移前在跑)
+ */
+export declare function runMigrateDataDir(targetArg: string, deps: {
+    isRunning: () => Promise<boolean>;
+    stop: () => Promise<{
+        stopped: boolean;
+    }>;
+    start: () => Promise<{
+        started: boolean;
+        msg: string;
+    }>;
+}): Promise<MigrateResult>;
+export declare const migrateDataDirCommand: Command;

package/dist/commands/migrate.js

@@ -0,0 +1,116 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { loadConfig, saveConfig, resolveDataDir } from '../config.js';
+import { getCliLogger } from '../logger.js';
+import { linkDev } from '../utils/link.js';
+/**
+ * 跨卷安全移动:同卷 renameSync;rename 失败(典型 EXDEV 跨盘,Windows C:→D:)
+ * 回退递归 copy + rm。symlink 项读 link 目标后经 linkDev 重建
+ * (Windows 普通用户无 symlink 权限,junction/copy+marker 兜底)。
+ */
+export function moveEntry(src, dest) {
+    const stat = fs.lstatSync(src);
+    if (stat.isSymbolicLink()) {
+        const linkTarget = fs.readlinkSync(src);
+        const r = linkDev(linkTarget, dest, stat.isDirectory() ? 'dir' : 'file');
+        if (!r.ok)
+            throw new Error(`重建软链失败 ${src} → ${dest}: ${r.error}`);
+        fs.unlinkSync(src);
+        return;
+    }
+    try {
+        fs.renameSync(src, dest);
+    }
+    catch {
+        fs.cpSync(src, dest, { recursive: true });
+        fs.rmSync(src, { recursive: true, force: true });
+    }
+}
+/**
+ * 数据目录迁移(FID-071):
+ * 1. server 在跑则先停(记录状态,迁移后按需重启)
+ * 2. 源目录(除 config.json 外)全部移动到目标目录
+ * 3. config.json 留在原 CONFIG_DIR,写入 dataDir=目标
+ * 4. 重启 server(若迁移前在跑)
+ */
+export async function runMigrateDataDir(targetArg, deps) {
+    const target = path.resolve(targetArg);
+    const source = resolveDataDir();
+    if (target === source) {
+        throw new Error(`目标目录与当前数据目录相同: ${target}`);
+    }
+    if (target.startsWith(source + path.sep)) {
+        throw new Error(`目标目录不能位于当前数据目录内部: ${target}`);
+    }
+    if (!fs.existsSync(source)) {
+        throw new Error(`当前数据目录不存在: ${source}(先运行 hunter-mate init)`);
+    }
+    // 1) server 状态探测并停止
+    const wasRunning = await deps.isRunning();
+    if (wasRunning) {
+        const stopRes = await deps.stop();
+        if (!stopRes.stopped) {
+            throw new Error('server 停止失败,已中止迁移(避免移动正在被写入的数据库)');
+        }
+    }
+    // 2) 逐项移动(config.json 是配置的锚点,永远留在 CONFIG_DIR)
+    fs.mkdirSync(target, { recursive: true });
+    const entries = fs.readdirSync(source, { withFileTypes: true });
+    const moved = [];
+    const skipped = [];
+    for (const entry of entries) {
+        if (entry.name === 'config.json') {
+            skipped.push(entry.name);
+            continue;
+        }
+        moveEntry(path.join(source, entry.name), path.join(target, entry.name));
+        moved.push(entry.name);
+    }
+    // 3) 写回配置
+    saveConfig({ dataDir: target });
+    loadConfig();
+    // 4) 按需重启
+    let serverRestarted = false;
+    if (wasRunning) {
+        const startRes = await deps.start();
+        serverRestarted = startRes.started;
+        if (!startRes.started) {
+            getCliLogger().warn('migrate:server-restart-failed', { msg: startRes.msg });
+        }
+    }
+    return { from: source, to: target, moved, skipped, serverRestarted };
+}
+export const migrateDataDirCommand = new Command('migrate-data-dir')
+    .description('把 ~/.hunter-mate 的重数据(数据库/日志/缓存/扩展等)迁移到指定目录,如 D:\\hm-data(FID-071)')
+    .argument('<target>', '目标目录(绝对路径,如 D:\\hm-data)')
+    .action(async (target) => {
+    const { tryReadPid, runStop, runStart } = await import('./server.js');
+    const result = await runMigrateDataDir(target, {
+        isRunning: async () => {
+            const pid = tryReadPid();
+            if (!pid)
+                return false;
+            const config = loadConfig();
+            try {
+                const res = await fetch(`${config.serverUrl}/health`, {
+                    signal: AbortSignal.timeout(1500),
+                });
+                return res.ok;
+            }
+            catch {
+                return false;
+            }
+        },
+        stop: () => runStop(),
+        start: () => runStart({}),
+    });
+    console.log(`✓ 数据目录已迁移: ${result.from} → ${result.to}`);
+    console.log(`  移动 ${result.moved.length} 项: ${result.moved.join(', ') || '(空)'}`);
+    if (result.skipped.length) {
+        console.log(`  保留在原位: ${result.skipped.join(', ')}(配置文件锚点,不迁移)`);
+    }
+    console.log(`  server: ${result.serverRestarted ? '已重启' : '迁移前未运行(下次 start 自动使用新目录)'}`);
+    console.log('  提示: 若 Chrome 扩展加载自旧目录,请在新目录重新加载扩展(chrome://extensions)');
+    getCliLogger().info('migrate-data-dir:done', { from: result.from, to: result.to, moved: result.moved.length });
+});

package/dist/commands/note.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** 业务备注(Remark 实体)CLI 入口:推荐反馈/沟通结论/不合适原因等记忆载体 */
+export declare const noteCommand: Command;

package/dist/commands/note.js

@@ -0,0 +1,75 @@
+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';
+const TARGETS = ['customer', 'job', 'talent', 'company', 'talent-job-match'];
+async function authedHeaders() {
+    const token = await getToken().catch(() => undefined);
+    return token ? { Authorization: `UTOKEN ${token}` } : {};
+}
+/** 业务备注(Remark 实体)CLI 入口:推荐反馈/沟通结论/不合适原因等记忆载体 */
+export const noteCommand = new Command('note').description('业务备注:挂在 customer/job/talent/company 上的记忆记录(Remark)');
+noteCommand
+    .command('add')
+    .requiredOption('--target <type>', `目标类型: ${TARGETS.join('|')}`)
+    .requiredOption('--id <targetId>', '目标 id')
+    .requiredOption('--content <text>', '备注内容')
+    .option('--category <cat>', '分类,如 feedback/general/interview', 'general')
+    .option('--tags <a,b>', '标签,逗号分隔')
+    .option('--json', 'JSON 输出')
+    .action(async (opts) => {
+    try {
+        if (!TARGETS.includes(opts.target)) {
+            throw new Error(`--target 必须是: ${TARGETS.join('|')}`);
+        }
+        const config = loadConfig();
+        const res = await axios.post(`${config.serverUrl}/remarks`, {
+            targetType: opts.target,
+            targetId: String(opts.id),
+            author: { userId: 'cli', userName: 'cli', source: 'cli' },
+            content: opts.content,
+            category: opts.category,
+            tags: opts.tags ? opts.tags.split(',').map((s) => s.trim()).filter(Boolean) : undefined,
+        }, { headers: await authedHeaders(), proxy: false });
+        if (opts.json)
+            console.log(JSON.stringify(res.data, null, 2));
+        else
+            console.log(`✓ 备注已记录 (${opts.target}#${opts.id}, category=${opts.category})`);
+    }
+    catch (err) {
+        printCommandError('note:add-failed', err);
+        process.exit(1);
+    }
+});
+noteCommand
+    .command('list')
+    .requiredOption('--target <type>', `目标类型: ${TARGETS.join('|')}`)
+    .requiredOption('--id <targetId>', '目标 id')
+    .option('--json', 'JSON 输出')
+    .action(async (opts) => {
+    try {
+        if (!TARGETS.includes(opts.target)) {
+            throw new Error(`--target 必须是: ${TARGETS.join('|')}`);
+        }
+        const config = loadConfig();
+        const res = await axios.get(`${config.serverUrl}/remarks/${opts.target}/${encodeURIComponent(String(opts.id))}`, { headers: await authedHeaders(), proxy: false });
+        const list = Array.isArray(res.data) ? res.data : [];
+        if (opts.json) {
+            console.log(JSON.stringify(list, null, 2));
+        }
+        else {
+            if (!list.length) {
+                console.log(`无备注 (${opts.target}#${opts.id})`);
+                return;
+            }
+            for (const r of list) {
+                console.log(`- [${r.category}] ${String(r.content).slice(0, 100)}  (${r.createdAt})`);
+            }
+        }
+    }
+    catch (err) {
+        printCommandError('note:list-failed', err);
+        process.exit(1);
+    }
+});

package/dist/commands/ops.js

@@ -2,8 +2,9 @@ import { Command } from 'commander';
 import axios from 'axios';
 import * as fs from 'fs';
 import * as path from 'path';
-import { loadConfig } from '../config.js';
+import { loadConfig, resolveDataDir } from '../config.js';
 import { getCliLogger } from '../logger.js';
+import { printCommandError } from '../utils/command-error.js';
 // OpenCLI 风格的通用选项
 function withFormat(cmd) {
     return cmd.option('-f, --format <format>', '输出格式: table|json|yaml|md|csv', 'json');
@@ -76,8 +77,37 @@ withFormat(recordingsCommand.command('list').description('列出录制会话（
         printResult(r.data, opts.format);
     }
     catch (e) {
-        // server 暂未实现 recordings list 时给出空结果与提示，避免 crash
-        printResult({ note: '/api/recordings GET 未实现，HunterMate server 正在逐步补齐。先从 /api/recordings/:sessionId GET 查看单个。', sessions: [] }, opts.format);
+        // hmh#44: /api/recordings GET 早已实现,连接失败应如实报错,不再回退到假提示
+        await printCommandError('ops:recordings-list-failed', e);
+        process.exit(1);
+    }
+});
+/** hmh#44: 按会话删除录制数据(DELETE /api/recordings/:sessionId) */
+recordingsCommand
+    .command('delete <sessionId>')
+    .description('删除指定录制会话的事件与快照 (DELETE /api/recordings/:id)')
+    .action(async (sessionId) => {
+    try {
+        const r = await http().delete(`/api/recordings/${sessionId}`);
+        console.log(JSON.stringify(r.data, null, 2));
+    }
+    catch (e) {
+        await printCommandError('ops:recordings-delete-failed', e);
+        process.exit(1);
+    }
+});
+/** hmh#44: 手动 VACUUM 缩容,删除数据后让 SQLite 文件真实释放磁盘 */
+recordingsCommand
+    .command('compact')
+    .description('VACUUM 压缩录制库,释放已删除数据占用的磁盘 (POST /api/recordings/compact)')
+    .action(async () => {
+    try {
+        const r = await http().post('/api/recordings/compact', {});
+        console.log(JSON.stringify(r.data, null, 2));
+    }
+    catch (e) {
+        await printCommandError('ops:recordings-compact-failed', e);
+        process.exit(1);
     }
 });
 withFormat(recordingsCommand.command('show <sessionId>').description('查看录制详情 (/api/recordings/:id) + 可选 parse'))
@@ -115,11 +145,12 @@ recordingsCommand
 // adapter (OpenCLI 风格)
 // ---------------------------------------------------------------------------
 export const adapterCommand = withFormat(new Command('adapter')
-    .description('站点适配器（对应 chromepilot adapter）: list | extract <url>')
-    .argument('[action]', '操作: list | extract', 'list')
+    .description('站点适配器（对应 chromepilot adapter）: list | extract <url> | sync')
+    .argument('[action]', '操作: list | extract | sync', 'list')
     .argument('[target]', 'list: 站点名过滤;extract: 页面 URL', '')
     .option('--tab <pageId>', 'extract: 指定目标 tab(page id;默认复用同站点 tab 或新建后台 tab,不抢焦点)')
-    .option('--settle-ms <n>', 'extract: 导航后首查等待 ms(默认 1200)', '1200')).action(async (action, target, opts) => {
+    .option('--settle-ms <n>', 'extract: 导航后首查等待 ms(默认 1200)', '1200')
+    .option('--dry-run', 'sync: 只统计差异不写库', false)).action(async (action, target, opts) => {
     if (action === 'list' || !action) {
         try {
             const r = await http().get('/adapters');
@@ -132,6 +163,7 @@ export const adapterCommand = withFormat(new Command('adapter')
             // server 暂未实现 /adapters 时退回内置清单
             printResult({ note: `GET /adapters failed (${e.message}),fallback 内置清单`, adapters: [
                     { platform: 'linkedin', host: 'linkedin.com', command: 'hm.linkedin.extract' },
+                    { platform: 'liepin', host: 'h.liepin.com', command: 'hm.liepin.extract' },
                 ] }, opts.format);
         }
         return;
@@ -168,7 +200,29 @@ export const adapterCommand = withFormat(new Command('adapter')
         }
         return;
     }
-    printResult({ error: `unknown action: ${action}`, supported: ['list', 'extract'] }, opts.format);
+    if (action === 'sync') {
+        // hunter-mate-harness adapters/ overlay 同步 @fid FID-081-adapter-overlay-suite
+        // 路径优先级: env HUNTER_MATE_HARNESS_PATH > config.json harnessPath
+        const cfg = loadConfig();
+        const harnessPath = process.env.HUNTER_MATE_HARNESS_PATH || cfg?.harnessPath;
+        if (!harnessPath || !harnessPath.trim()) {
+            getCliLogger().error('ops:adapter-sync-missing-harness-path', {
+                hint: '先配置: hunter-mate config --harness-path <hunter-mate-harness 仓绝对路径>(或设 env HUNTER_MATE_HARNESS_PATH)',
+            });
+            process.exit(1);
+        }
+        try {
+            const r = await http().post('/adapters/sync', { harnessPath, dryRun: !!opts.dryRun });
+            printResult(r.data, opts.format);
+        }
+        catch (e) {
+            const detail = e.response?.data?.message || e.message;
+            console.error(`✗ ops:adapter-sync-failed: ${detail}`);
+            process.exit(1);
+        }
+        return;
+    }
+    printResult({ error: `unknown action: ${action}`, supported: ['list', 'extract', 'sync'] }, opts.format);
 });
 // ---------------------------------------------------------------------------
 // memory (站点记忆: 基于 selector/流程建议 的持久化 KV)
@@ -178,8 +232,7 @@ export const memoryCommand = withFormat(new Command('memory')
     .argument('[action]', '操作 (默认 list)', 'list')
     .argument('[site]', '站点名', '')
     .argument('[ref]', 'suggest/delete 的元素引用', '')).action((action, site, ref, opts) => {
-    const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-    const STORE = path.join(HOME, '.hunter-mate', 'memory.json');
+    const STORE = path.join(resolveDataDir(), 'memory.json');
     let store = {};
     try {
         store = JSON.parse(fs.readFileSync(STORE, 'utf-8'));
@@ -304,8 +357,7 @@ export const traceCommand = withFormat(new Command('trace')
             }
             catch (e) {
                 // server 未就绪时: 本地追加 fallbacks 到 session JSONL 文件
-                const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-                const f = path.join(HOME, '.hunter-mate', 'sessions', `${sessionId}.trace.jsonl`);
+                const f = path.join(resolveDataDir(), 'sessions', `${sessionId}.trace.jsonl`);
                 fs.appendFileSync(f, JSON.stringify({ type: opts.type, payload, ts: Date.now() }) + '\n');
                 printResult({ ok: true, stored: 'local', file: f }, opts.format);
             }
@@ -318,8 +370,7 @@ export const traceCommand = withFormat(new Command('trace')
             }
             printResult({ ok: true, sessionId, note: '本地 trace 文件删除（server 侧请通过 api/recordings/* 管理）' }, opts.format);
             try {
-                const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-                const f = path.join(HOME, '.hunter-mate', 'sessions', `${sessionId}.trace.jsonl`);
+                const f = path.join(resolveDataDir(), 'sessions', `${sessionId}.trace.jsonl`);
                 if (fs.existsSync(f))
                     fs.unlinkSync(f);
             }

package/dist/commands/preference.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+/**
+ * 三层偏好:scope=user(顾问本人)/ customer(用人单位)/ case(具体职位)。
+ * 查询 case 层时自动按 case → customer → user 逐层 merge,按 weight 降序。
+ */
+export declare const preferenceCommand: Command;

package/dist/commands/preference.js

@@ -0,0 +1,80 @@
+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';
+const SCOPES = ['user', 'customer', 'case'];
+async function authedHeaders() {
+    const token = await getToken().catch(() => undefined);
+    return token ? { Authorization: `UTOKEN ${token}` } : {};
+}
+/**
+ * 三层偏好:scope=user(顾问本人)/ customer(用人单位)/ case(具体职位)。
+ * 查询 case 层时自动按 case → customer → user 逐层 merge,按 weight 降序。
+ */
+export const preferenceCommand = new Command('preference').description('三层偏好沉淀(user/customer/case),用于人才推荐筛选');
+preferenceCommand
+    .command('set')
+    .requiredOption('--scope <scope>', `范围: ${SCOPES.join('|')}`)
+    .requiredOption('--id <scopeId>', '范围 id(user id / customer id / job case id)')
+    .requiredOption('--dimension <dim>', '维度,如 industry/comp_size/school_tier/reject_reason/must_have')
+    .requiredOption('--value <json>', '偏好值(JSON 字符串,如 \'"electronics"\' 或 \'{"min":5}\')')
+    .option('--weight <w>', '权重(默认 1)', parseFloat)
+    .option('--evidence <text>', '证据来源:哪次推荐/哪条反馈')
+    .option('--json', 'JSON 输出')
+    .action(async (opts) => {
+    try {
+        if (!SCOPES.includes(opts.scope)) {
+            throw new Error(`--scope 必须是: ${SCOPES.join('|')}`);
+        }
+        let value;
+        try {
+            value = JSON.parse(opts.value);
+        }
+        catch {
+            throw new Error(`--value 必须是合法 JSON 字符串: ${opts.value}`);
+        }
+        const config = loadConfig();
+        const res = await axios.put(`${config.serverUrl}/preferences`, {
+            scope: opts.scope,
+            scopeId: parseInt(opts.id, 10),
+            items: [{ dimension: opts.dimension, value, weight: opts.weight, evidence: opts.evidence }],
+        }, { headers: await authedHeaders(), proxy: false });
+        if (opts.json)
+            console.log(JSON.stringify(res.data, null, 2));
+        else
+            console.log(`✓ 偏好已写入 (${opts.scope}#${opts.id}, ${opts.dimension}=${opts.value})`);
+    }
+    catch (err) {
+        printCommandError('preference:set-failed', err);
+        process.exit(1);
+    }
+});
+preferenceCommand
+    .command('get')
+    .requiredOption('--scope <scope>', `范围: ${SCOPES.join('|')}`)
+    .requiredOption('--id <scopeId>', '范围 id')
+    .option('--customer-id <id>', 'scope=case 时传客户 id,一并带出 customer/user 两层')
+    .option('--json', 'JSON 输出(默认 JSON:三层 merge 结构)')
+    .action(async (opts) => {
+    try {
+        if (!SCOPES.includes(opts.scope)) {
+            throw new Error(`--scope 必须是: ${SCOPES.join('|')}`);
+        }
+        const config = loadConfig();
+        const res = await axios.get(`${config.serverUrl}/preferences`, {
+            params: {
+                scope: opts.scope,
+                scopeId: parseInt(opts.id, 10),
+                ...(opts.customerId ? { customerId: parseInt(opts.customerId, 10) } : {}),
+            },
+            headers: await authedHeaders(),
+            proxy: false,
+        });
+        console.log(JSON.stringify(res.data, null, 2));
+    }
+    catch (err) {
+        printCommandError('preference:get-failed', err);
+        process.exit(1);
+    }
+});

package/dist/commands/record.js

@@ -42,7 +42,7 @@ recordCommand
         console.log('请使用本地 LLM 对转写文本做 NER/摘要/实体链接后确认归档。');
     }
     catch (err) {
-        printCommandError('record:upload-failed', err);
+        await printCommandError('record:upload-failed', err);
         process.exit(1);
     }
 });

package/dist/commands/report.js

@@ -42,7 +42,7 @@ reportCommand
         console.log('> 请使用本地 LLM 基于以上原始数据生成最终销售方案与交付节奏。');
     }
     catch (err) {
-        printCommandError('report:generate-failed', err);
+        await printCommandError('report:generate-failed', err);
         process.exit(1);
     }
 });

package/dist/commands/search.js

@@ -40,7 +40,7 @@ export const searchCommand = new Command('search')
         console.log(JSON.stringify(data, null, 2));
     }
     catch (err) {
-        printCommandError('search:failed', err);
+        await printCommandError('search:failed', err);
         process.exit(1);
     }
 });