hunter-mate 0.1.7 → 0.1.8

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);
     }
 });

package/dist/commands/server.d.ts

@@ -1,4 +1,11 @@
 import { Command } from 'commander';
+/**
+ * server.log 无界增长曾达 800M+ 挤占用户磁盘(FID-068)。
+ * 后台 daemon 启动前按大小轮转:超过 HM_LOG_MAX_BYTES(默认 50MB)时
+ * server.log → server.log.1 → …保留最近 LOG_KEEP_FILES 份,最旧丢弃。
+ * 纯 fs 实现,Windows 兼容(rename 前先清目标,Windows 不允许覆盖已有文件)。
+ */
+export declare function rotateLogIfNeeded(logFile: string, maxBytes?: number, keep?: number): boolean;
 declare function tryReadPid(): number | null;
 export { tryReadPid };
 /** 定位 server 包根（dist 优先，ts-node 开发模式兜底）；找不到返回 null */

package/dist/commands/server.js

@@ -3,11 +3,12 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'node:url';
 import { spawn } from 'child_process';
-import { loadConfig, saveConfig } from '../config.js';
+import { loadConfig, saveConfig, resolveDataDir } from '../config.js';
 import { killGracefullySync } from '../utils/proc.js';
 import { findBundledAssets } from '../bundled-assets.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PID_FILE = () => path.join(process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.', '.hunter-mate', 'server.pid');
+/** server.pid 等运行时文件随数据目录走(FID-071:dataDir 可配置后 server 状态文件一并迁移) */
+const PID_FILE = () => path.join(resolveDataDir(), 'server.pid');
 const LOG_FILE = () => PID_FILE().replace(/server\.pid$/, 'server.log');
 const WATCHDOG_PID_FILE = () => PID_FILE().replace(/server\.pid$/, 'watchdog.pid');
 function tryReadPidFile(file) {
@@ -29,6 +30,38 @@ function cleanPidFile(file) {
     }
     catch { /* ignore */ }
 }
+const LOG_MAX_BYTES = () => Number(process.env.HM_LOG_MAX_BYTES || 50 * 1024 * 1024);
+const LOG_KEEP_FILES = 3;
+/**
+ * server.log 无界增长曾达 800M+ 挤占用户磁盘(FID-068)。
+ * 后台 daemon 启动前按大小轮转:超过 HM_LOG_MAX_BYTES(默认 50MB)时
+ * server.log → server.log.1 → …保留最近 LOG_KEEP_FILES 份,最旧丢弃。
+ * 纯 fs 实现,Windows 兼容(rename 前先清目标,Windows 不允许覆盖已有文件)。
+ */
+export function rotateLogIfNeeded(logFile, maxBytes = LOG_MAX_BYTES(), keep = LOG_KEEP_FILES) {
+    try {
+        if (!fs.existsSync(logFile))
+            return false;
+        if (fs.statSync(logFile).size <= maxBytes)
+            return false;
+        for (let i = keep - 1; i >= 1; i--) {
+            const src = `${logFile}.${i}`;
+            const dest = `${logFile}.${i + 1}`;
+            if (!fs.existsSync(src))
+                continue;
+            try {
+                fs.unlinkSync(dest);
+            }
+            catch { /* dest 不存在时忽略 */ }
+            fs.renameSync(src, dest);
+        }
+        fs.renameSync(logFile, `${logFile}.1`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function tryReadPid() {
     const pid = tryReadPidFile(PID_FILE());
     if (pid)
@@ -131,6 +164,8 @@ export async function runStart(opts) {
         ...process.env,
         PORT: String(port),
         HOST: host,
+        // FID-071: server 所有数据落点(db/备份/runtime.json/artifacts)由 CLI 的数据目录决定
+        HM_DATA_DIR: resolveDataDir(),
     };
     const nodeArgs = [];
     if (entry.endsWith('.ts')) {
@@ -148,6 +183,8 @@ export async function runStart(opts) {
     const logDir = path.dirname(LOG_FILE());
     if (!fs.existsSync(logDir))
         fs.mkdirSync(logDir, { recursive: true });
+    // 后台 daemon 启动前轮转 server.log(超 50MB 保留 3 份),防止无界增长挤占磁盘
+    rotateLogIfNeeded(LOG_FILE());
     // 后台模式由独立 watchdog 进程托管 server,实现崩溃后自动重启
     const watchdogEntry = path.resolve(__dirname, '../watchdog.js');
     if (!fs.existsSync(watchdogEntry)) {
@@ -163,6 +200,7 @@ export async function runStart(opts) {
         HM_SERVER_ENTRY: entry,
         HM_SERVER_LOG: LOG_FILE(),
         HM_SERVER_NODE_ARGS: nodeArgs.join(','),
+        HM_DATA_DIR: resolveDataDir(),
         PORT: String(port),
         HOST: host,
     };

package/dist/commands/status.d.ts

@@ -1,8 +1,11 @@
 import { Command } from 'commander';
+import { TokenIssuer } from '../keychain.js';
 import { InstalledVersions, SystemVersions } from '@hunter-mate/shared';
 export interface StatusResult {
     version: string;
     loggedIn: boolean;
+    /** token 签发方(hmh#43):saas 签发的 token 会被本地 server 拒绝 */
+    tokenIssuer?: TokenIssuer;
     server: 'running' | 'not running' | 'unknown';
     serverUrl: string;
     extensionCount: number;
@@ -15,6 +18,7 @@ export interface StatusResult {
     }>;
     installed?: InstalledVersions;
     live?: SystemVersions | null;
+    dataDir: string;
 }
 export declare function runStatus(): Promise<StatusResult>;
 export declare const statusCommand: Command;

package/dist/commands/status.js

@@ -1,13 +1,14 @@
 import { Command } from 'commander';
 import axios from 'axios';
 import { i18n } from '../i18n/index.js';
-import { loadConfig } from '../config.js';
-import { getToken } from '../keychain.js';
+import { loadConfig, resolveDataDir } from '../config.js';
+import { getTokenInfo } from '../keychain.js';
 import { readInstalledVersions, fetchLiveVersions } from '../version.js';
 import { getCliLogger } from '../logger.js';
 export async function runStatus() {
     const config = loadConfig();
-    const token = await getToken();
+    const tokenInfo = await getTokenInfo();
+    const token = tokenInfo?.token ?? null;
     let serverStatus = 'unknown';
     let extensions = [];
     let live = null;
@@ -28,15 +29,18 @@ export async function runStatus() {
         serverStatus = 'not running';
         getCliLogger().warn('status:server-not-running', { serverUrl: config.serverUrl });
     }
+    const installed = readInstalledVersions();
     return {
-        version: '0.1.0',
+        version: installed.cli ?? '0.0.0',
         loggedIn: !!token,
+        tokenIssuer: tokenInfo?.issuer,
         server: serverStatus,
         serverUrl: config.serverUrl,
         extensionCount: extensions.length,
         extensions,
-        installed: readInstalledVersions(),
+        installed,
         live,
+        dataDir: resolveDataDir(),
     };
 }
 export const statusCommand = new Command('status')
@@ -49,8 +53,14 @@ export const statusCommand = new Command('status')
         return;
     }
     console.log(`${i18n.t('status.cli')}: ${status.version}`);
-    console.log(`${i18n.t('status.loggedIn')}: ${status.loggedIn ? 'yes' : 'no'}`);
+    const loggedInText = status.loggedIn
+        ? status.tokenIssuer === 'saas'
+            ? 'yes (SaaS 签发 — 本地 server 会拒绝,启动 server 后请重新登录)'
+            : 'yes'
+        : 'no';
+    console.log(`${i18n.t('status.loggedIn')}: ${loggedInText}`);
     console.log(`${i18n.t('status.server')}: ${status.server} (${status.serverUrl})`);
+    console.log(`dataDir: ${status.dataDir}`);
     // 版本一致性: 磁盘(期望) vs 运行中
     if (status.installed) {
         const inst = status.installed;

package/dist/commands/update.js

@@ -2,29 +2,28 @@ 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 { getToken } from '../keychain.js';
 import { i18n } from '../i18n/index.js';
 import { getCliLogger } from '../logger.js';
 import chalk from 'chalk';
 import { readInstalledVersions, ensureRuntimeConsistency } from '../version.js';
 import { isDevLinked, npmLatestVersion, npmSelfUpdate } from '../updater.js';
-const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-const RULES_DIR = path.join(HOME, '.hunter-mate', 'rules');
-const VERSION_FILE = path.join(RULES_DIR, 'version.json');
+const RULES_DIR = () => path.join(resolveDataDir(), 'rules');
+const VERSION_FILE = () => path.join(RULES_DIR(), 'version.json');
 function loadLocalVersion() {
-    if (!fs.existsSync(VERSION_FILE))
+    if (!fs.existsSync(VERSION_FILE()))
         return null;
     try {
-        return JSON.parse(fs.readFileSync(VERSION_FILE, 'utf-8'));
+        return JSON.parse(fs.readFileSync(VERSION_FILE(), 'utf-8'));
     }
     catch {
         return null;
     }
 }
 function saveLocalVersion(version) {
-    fs.mkdirSync(RULES_DIR, { recursive: true });
-    fs.writeFileSync(VERSION_FILE, JSON.stringify({ version, updatedAt: new Date().toISOString() }, null, 2));
+    fs.mkdirSync(RULES_DIR(), { recursive: true });
+    fs.writeFileSync(VERSION_FILE(), JSON.stringify({ version, updatedAt: new Date().toISOString() }, null, 2));
 }
 export async function runUpdate() {
     const config = loadConfig();

package/dist/config.d.ts

@@ -5,9 +5,28 @@ export interface HunterMateConfig {
     saasUrl: string;
     lang: string;
     watchFolder?: string;
+    /**
+     * 重数据目录(数据库/日志/缓存/扩展/CLI 安装树等),不含 config.json 本身。
+     * 通过 `hunter-mate migrate-data-dir <dir>` 迁移;留空表示默认 ~/.hunter-mate。
+     */
+    dataDir?: string;
+    /**
+     * hunter-mate-harness 仓绝对路径(外部 adapters overlay 真相源)。
+     * `hunter-mate adapter sync` 读取;env HUNTER_MATE_HARNESS_PATH 优先级更高。 @fid FID-081-adapter-overlay-suite
+     */
+    harnessPath?: string;
 }
 export declare const CONFIG_DIR: () => string;
 export declare const CONFIG_FILE: () => string;
+/**
+ * 重数据目录解析(FID-071):
+ * HM_DATA_DIR(env,进程级覆盖,CLI spawn server 时注入) > config.dataDir(用户配置) > 默认 CONFIG_DIR。
+ * config.json 本身始终留在 CONFIG_DIR(KB 级不迁移),保证任何时刻都能定位配置。
+ * 注意:每次调用都实时读取(不缓存),config --data-dir 写入后同一进程内立即生效。
+ */
+export declare function resolveDataDir(): string;
+/** resolveDataDir 的别名,语义化表达"数据目录"(与 CONFIG_DIR 配置目录区分) */
+export declare const DATA_DIR: typeof resolveDataDir;
 /**
  * 已知废弃的 URL 路径前缀(按部署形态演进顺序追加)。
  * 每当 nginx / 服务端路径收敛(如子路径 → 根路径)时,把旧前缀加到这里,
@@ -43,4 +62,6 @@ export declare function saveConfig(config: Partial<HunterMateConfig>): {
     saasUrl: string;
     lang: string;
     watchFolder?: string;
+    dataDir?: string;
+    harnessPath?: string;
 };

package/dist/config.js

@@ -4,6 +4,29 @@ import { createJsonConfigStore } from '@chromepilot/kit';
 const HOME = () => process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
 export const CONFIG_DIR = () => path.join(HOME(), '.hunter-mate');
 export const CONFIG_FILE = () => path.join(CONFIG_DIR(), 'config.json');
+/**
+ * 重数据目录解析(FID-071):
+ * HM_DATA_DIR(env,进程级覆盖,CLI spawn server 时注入) > config.dataDir(用户配置) > 默认 CONFIG_DIR。
+ * config.json 本身始终留在 CONFIG_DIR(KB 级不迁移),保证任何时刻都能定位配置。
+ * 注意:每次调用都实时读取(不缓存),config --data-dir 写入后同一进程内立即生效。
+ */
+export function resolveDataDir() {
+    if (process.env.HM_DATA_DIR && process.env.HM_DATA_DIR.trim()) {
+        return path.resolve(process.env.HM_DATA_DIR);
+    }
+    try {
+        const raw = store.load();
+        if (raw && typeof raw.dataDir === 'string' && raw.dataDir.trim()) {
+            return path.resolve(raw.dataDir);
+        }
+    }
+    catch {
+        /* 配置不可读时回落默认目录 */
+    }
+    return CONFIG_DIR();
+}
+/** resolveDataDir 的别名,语义化表达"数据目录"(与 CONFIG_DIR 配置目录区分) */
+export const DATA_DIR = resolveDataDir;
 /**
  * 已知废弃的 URL 路径前缀(按部署形态演进顺序追加)。
  * 每当 nginx / 服务端路径收敛(如子路径 → 根路径)时,把旧前缀加到这里,
@@ -70,6 +93,10 @@ export function ensureConfigDir() {
     if (!fs.existsSync(CONFIG_DIR())) {
         fs.mkdirSync(CONFIG_DIR(), { recursive: true });
     }
+    const dataDir = resolveDataDir();
+    if (dataDir !== CONFIG_DIR() && !fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
 }
 export function loadConfig() {
     const raw = store.load();

package/dist/i18n/locales/en-US.json

@@ -59,5 +59,21 @@
     "purge.done.next": "To re-initialize, run",
     "purge.done.nothing": "Nothing to purge",
     "login.serverOfflineSaasFallback": "Warning: local server is not running; logged in via SaaS directly. Start the server and run login again for local data operations.",
-    "login.serverOfflineReloginHint": "Note: the saved SaaS token will be rejected (401) by local server protected routes."
+    "login.serverOfflineReloginHint": "Note: the saved SaaS token will be rejected (401) by local server protected routes.",
+    "login.selfCheckOk": "Login self-check passed: protected endpoint reachable",
+    "login.selfCheckFail": "Login self-check failed: new token rejected by local server; please report with full output",
+    "login.selfCheckSkipped": "Login self-check skipped: local server unreachable; re-login once it is back",
+    "issueEnv.description": "Print the environment block needed for issue reports (CLI version / install type / git HEAD / server buildTime / OS); --format json for agents to paste directly",
+    "issueEnv.cliVersion": "CLI version",
+    "issueEnv.installType": "Install type",
+    "issueEnv.installDev": "dev (git worktree of source repo)",
+    "issueEnv.installPackage": "package (published npm build)",
+    "issueEnv.gitHead": "Code HEAD (version/buildTime do not identify code state; HEAD does)",
+    "issueEnv.gitBranch": "Branch",
+    "issueEnv.gitDirty": "uncommitted changes (dist may lag HEAD)",
+    "issueEnv.gitClean": "clean worktree",
+    "issueEnv.repoRoot": "Repo root",
+    "issueEnv.gitUnavailable": "unavailable (published package has no git info; use CLI version instead)",
+    "issueEnv.serverBuildTime": "server buildTime",
+    "issueEnv.serverNotRunning": "server not running (unavailable)"
 }