hunter-mate 0.1.6 → 0.1.8

package/dist/commands/issue-env.js

@@ -0,0 +1,101 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+import axios from 'axios';
+import { i18n } from '../i18n/index.js';
+import { loadConfig, resolveDataDir } from '../config.js';
+import { readInstalledVersions } from '../version.js';
+// dev 软链/shim 安装时 __dirname 位于仓内(packages/cli/dist/commands),
+// 发布包安装时位于全局 node_modules —— 向上找含 .git 的目录即可判定并定位仓根。
+const START_DIR = path.dirname(fileURLToPath(import.meta.url));
+function findRepoRoot(start) {
+    let dir = start;
+    while (true) {
+        if (fs.existsSync(path.join(dir, '.git')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** 静默执行 git,失败(git 不可用/非工作区)返回 null */
+function git(args, cwd) {
+    try {
+        const out = execFileSync('git', args, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function runIssueEnv() {
+    const installed = readInstalledVersions();
+    const repoRoot = findRepoRoot(START_DIR);
+    let gitInfo = null;
+    if (repoRoot) {
+        const porcelain = git(['status', '--porcelain'], repoRoot) ?? '';
+        gitInfo = {
+            repoRoot,
+            head: git(['rev-parse', '--short', 'HEAD'], repoRoot),
+            branch: git(['branch', '--show-current'], repoRoot),
+            lastCommit: git(['log', '-1', '--format=%h %ci %s'], repoRoot),
+            dirty: porcelain.length > 0,
+        };
+    }
+    let serverBuildTime = null;
+    try {
+        const r = await axios.get(`${loadConfig().serverUrl}/health`, { timeout: 2000 });
+        serverBuildTime = r.data?.buildTime ?? null;
+    }
+    catch {
+        /* server 未运行,保持 null */
+    }
+    return {
+        cliVersion: installed.cli ?? 'unknown',
+        installType: repoRoot ? 'dev' : 'package',
+        git: gitInfo,
+        serverBuildTime,
+        os: `${os.platform()} ${os.release()} ${os.arch()}`,
+        node: process.version,
+        dataDir: resolveDataDir(),
+    };
+}
+function renderText(r) {
+    const lines = [];
+    lines.push(`${i18n.t('issueEnv.cliVersion')}: ${r.cliVersion}`);
+    lines.push(`${i18n.t('issueEnv.installType')}: ` +
+        (r.installType === 'dev' ? i18n.t('issueEnv.installDev') : i18n.t('issueEnv.installPackage')));
+    if (r.git) {
+        lines.push(`${i18n.t('issueEnv.gitHead')}: ${r.git.lastCommit ?? r.git.head ?? 'unknown'}`);
+        lines.push(`${i18n.t('issueEnv.gitBranch')}: ${r.git.branch ?? 'unknown'} · ` +
+            (r.git.dirty ? i18n.t('issueEnv.gitDirty') : i18n.t('issueEnv.gitClean')));
+        lines.push(`${i18n.t('issueEnv.repoRoot')}: ${r.git.repoRoot}`);
+    }
+    else {
+        lines.push(`${i18n.t('issueEnv.gitHead')}: ${i18n.t('issueEnv.gitUnavailable')}`);
+    }
+    lines.push(`${i18n.t('issueEnv.serverBuildTime')}: ${r.serverBuildTime ?? i18n.t('issueEnv.serverNotRunning')}`);
+    lines.push(`OS: ${r.os}`);
+    lines.push(`Node: ${r.node}`);
+    lines.push(`dataDir: ${r.dataDir}`);
+    return lines.join('\n');
+}
+export const issueEnvCommand = new Command('issue-env')
+    .description(i18n.t('issueEnv.description'))
+    .option('-f, --format <fmt>', '输出格式: text|json', 'text')
+    .action(async (opts) => {
+    const result = await runIssueEnv();
+    if (opts.format === 'json') {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(renderText(result));
+});

package/dist/commands/job.d.ts

@@ -3,7 +3,11 @@ export interface CreateJobCaseResult {
     id: number;
     externalId: string;
     status: string;
+    customerId?: number;
 }
-export declare function runJobCreate(folderPath: string): Promise<CreateJobCaseResult>;
-export declare function runJobList(): any[];
+export declare function runJobCreate(folderPath: string, customerRef?: string): Promise<CreateJobCaseResult>;
+/**
+ * 优先查 server 的 /job-cases;server 不可达或未登录时兜底本地 sqlite 缓存。
+ */
+export declare function runJobList(): Promise<any[]>;
 export declare const jobCommand: Command;

package/dist/commands/job.js

@@ -7,27 +7,63 @@ import { ensureCacheDir, saveJobCase, listJobCases } from '../cache/db.js';
 import { loadConfig } from '../config.js';
 import { getToken } from '../keychain.js';
 import { i18n } from '../i18n/index.js';
-import { getCliLogger } from '../logger.js';
-export async function runJobCreate(folderPath) {
+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));
+    // 根目录文件优先,再递归子目录,保证 keys[0] 是根目录第一个文件(用于 title)
+    for (const entry of entries) {
+        if (entry.isFile() && /\.(md|txt|pdf)$/.test(entry.name)) {
+            out[relPrefix + entry.name] = fs.readFileSync(path.join(dir, entry.name), 'utf-8');
+        }
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            collectJobFiles(path.join(dir, entry.name), relPrefix + entry.name + '/', out);
+        }
+    }
+    return out;
+}
+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}`);
     }
-    const files = fs.readdirSync(resolved).filter((f) => f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.pdf'));
-    const rawFiles = {};
-    for (const f of files) {
-        rawFiles[f] = fs.readFileSync(path.join(resolved, f), 'utf-8');
+    const rawFiles = collectJobFiles(resolved);
+    if (!Object.keys(rawFiles).length) {
+        throw new Error(`Folder 内未找到 .md/.txt/.pdf 文件: ${resolved}`);
     }
     const rawText = Object.values(rawFiles).join('\n---\n');
-    const title = Object.keys(rawFiles)[0]?.replace(/\.[^.]+$/, '') || 'Untitled JobCase';
+    const firstKey = Object.keys(rawFiles)[0];
+    const titleBase = firstKey.includes('/') ? firstKey.split('/').pop() : firstKey;
+    const title = titleBase.replace(/\.[^.]+$/, '') || 'Untitled JobCase';
     const res = await axios.post(`${config.serverUrl}/job-cases`, {
         externalId: uuidv4(),
         title,
         folderPath: resolved,
         rawFiles,
+        customerId,
     }, { headers, proxy: false });
     const serverCase = res.data;
     ensureCacheDir();
@@ -36,7 +72,7 @@ export async function runJobCreate(folderPath) {
         externalId: serverCase.externalId,
         parsedFrom: {
             folderPath: resolved,
-            fileNames: files.join(','),
+            fileNames: Object.keys(rawFiles).join(','),
             rawText,
         },
         requirements: {},
@@ -47,30 +83,49 @@ export async function runJobCreate(folderPath) {
     saveJobCase(jobCase);
     return serverCase;
 }
-export function runJobList() {
-    return listJobCases();
+/**
+ * 优先查 server 的 /job-cases;server 不可达或未登录时兜底本地 sqlite 缓存。
+ */
+export async function runJobList() {
+    const config = loadConfig();
+    const token = await getToken().catch(() => undefined);
+    try {
+        const res = await axios.get(`${config.serverUrl}/job-cases`, {
+            headers: token ? { Authorization: `UTOKEN ${token}` } : {},
+            proxy: false,
+            timeout: 8000,
+        });
+        const list = Array.isArray(res.data) ? res.data : [];
+        // server 为空时兜底本地缓存(server 数据可能被清理)
+        return list.length ? list : listJobCases();
+    }
+    catch (err) {
+        if (err?.response?.status === 401 || err?.response?.status === 403) {
+            console.error('登录已过期或无权访问,请运行 hunter-mate login 后重试(本次展示本地缓存数据)');
+        }
+        return listJobCases();
+    }
 }
 export const jobCommand = new Command('job')
     .description(i18n.t('job.description'));
 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) {
-        getCliLogger().error('job:create-failed', {
-            error: err.response?.data?.message || err.message,
-        });
+        await printCommandError('job:create-failed', err);
         process.exit(1);
     }
 });
 jobCommand
     .command('list')
-    .description('List local JobCases')
-    .action(() => {
-    const cases = runJobList();
-    console.table(cases.map((c) => ({ id: c.id, folder: c.parsedFrom?.folderPath, status: c.status, createdAt: c.createdAt })));
+    .description('List JobCases (优先 server,失败兜底本地缓存)')
+    .action(async () => {
+    const cases = await runJobList();
+    console.table(cases.map((c) => ({ id: c.id, folder: c.parsedFrom?.folderPath ?? c.folderPath, status: c.status, createdAt: c.createdAt })));
 });

package/dist/commands/login.d.ts

@@ -1,3 +1,22 @@
 import { Command } from 'commander';
+export type EmailLoginSource = 'server' | 'saas';
+/**
+ * 邮箱登录第一步:发送验证码。
+ * 优先走本地 server(SaaS 代理模式,verify 后拿到的是本地自签 UTOKEN,
+ * 受保护路由立即可用);server 不可达时 fallback 直连 SaaS。
+ */
+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;
+    source: EmailLoginSource;
+}>;
 export declare function runLogin(): Promise<string>;
 export declare const loginCommand: Command;

package/dist/commands/login.js

@@ -2,12 +2,64 @@ 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) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+/** 探测本地 server 是否在线(参照 doctor 的 server 检测) */
+async function isLocalServerReachable(serverUrl) {
+    try {
+        await axios.get(`${serverUrl}/health`, { timeout: 2000, proxy: false });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 邮箱登录第一步:发送验证码。
+ * 优先走本地 server(SaaS 代理模式,verify 后拿到的是本地自签 UTOKEN,
+ * 受保护路由立即可用);server 不可达时 fallback 直连 SaaS。
+ */
+export async function sendEmailCode(email) {
+    const config = loadConfig();
+    if (await isLocalServerReachable(config.serverUrl)) {
+        await axios.post(`${config.serverUrl}/auth/email/send-code`, { email }, { proxy: false });
+        return 'server';
+    }
+    await axios.post(`${config.saasUrl}/hunter-mate/auth/email/send-code`, { email }, { proxy: false });
+    return 'saas';
+}
+/**
+ * 邮箱登录第二步:校验验证码并保存 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();
+    if (await isLocalServerReachable(config.serverUrl)) {
+        const { data } = await axios.post(`${config.serverUrl}/auth/email/verify`, { email, code }, { proxy: false });
+        if (!data.access_token) {
+            throw new Error('verify returned no 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, '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() {
     const config = loadConfig();
     const { data: deviceCode } = await axios.post(`${config.serverUrl}/auth/device-code`);
@@ -44,28 +96,48 @@ export const loginCommand = new Command('login')
     .option('--code <code>', 'Email verification code (6 digits, step 2)')
     .action(async (options) => {
     try {
-        const config = loadConfig();
-        // 邮箱验证码登录(两步式无状态;SaaS 服务端,不经本地 server)
+        // 邮箱验证码登录(两步式无状态):优先走本地 server(SaaS 代理,自签 UTOKEN),
+        // server 不在线时 fallback 直连 SaaS 并警告(FID-057 #8)
         if (options.email) {
             if (!options.code) {
                 // 第一步:发送验证码
-                await axios.post(`${config.saasUrl}/hunter-mate/auth/email/send-code`, {
-                    email: options.email,
-                });
-                getCliLogger().info('login:email-code-sent', { email: options.email });
+                const source = await sendEmailCode(options.email);
+                if (source === 'saas') {
+                    console.warn(i18n.t('login.serverOfflineSaasFallback'));
+                }
+                getCliLogger().info('login:email-code-sent', { email: options.email, source });
                 console.log(`${i18n.t('login.emailCodeSent')} ${options.email}`);
                 console.log(`  ${i18n.t('login.emailCodeNextStep')}`);
                 return;
             }
             // 第二步:校验验证码 → 保存 token
-            const { data } = await axios.post(`${config.saasUrl}/hunter-mate/auth/email/verify`, { email: options.email, code: options.code });
-            if (!data.access_token) {
-                getCliLogger().error('login:email-verify-no-token');
-                throw new Error('verify returned no access_token');
+            const { source } = await verifyEmailCode(options.email, options.code);
+            if (source === 'saas') {
+                console.warn(i18n.t('login.serverOfflineSaasFallback'));
+                console.warn(i18n.t('login.serverOfflineReloginHint'));
             }
-            await saveToken(data.access_token);
-            getCliLogger().info('login:token-saved', { method: 'email', email: options.email });
+            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);
+    }
+});