hunter-mate 0.1.1 → 0.1.3

package/dist/assets/server/telemetry/telemetry.service.js

@@ -0,0 +1,116 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var TelemetryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const config_1 = require("@nestjs/config");
+const os = require("os");
+const parse_log_entity_1 = require("../extraction/entities/parse-log.entity");
+let TelemetryService = TelemetryService_1 = class TelemetryService {
+    parseLogRepo;
+    config;
+    logger = new common_1.Logger(TelemetryService_1.name);
+    reporting = false;
+    timer;
+    constructor(parseLogRepo, config) {
+        this.parseLogRepo = parseLogRepo;
+        this.config = config;
+    }
+    onApplicationBootstrap() {
+        if (!this.url) {
+            this.logger.log('HM_TELEMETRY_URL 未配置,parse_log 上报停用(纯本地模式)');
+            return;
+        }
+        setTimeout(() => this.reportUnreported(), 30_000);
+        this.timer = setInterval(() => this.reportUnreported(), 5 * 60_000);
+        this.timer.unref?.();
+    }
+    get url() {
+        const base = this.config.get('HM_TELEMETRY_URL');
+        return base ? `${base.replace(/\/$/, '')}/hunter-mate/telemetry/parse-log` : undefined;
+    }
+    async reportUnreported() {
+        const endpoint = this.url;
+        if (!endpoint || this.reporting)
+            return { skipped: true };
+        this.reporting = true;
+        try {
+            const rows = await this.parseLogRepo.find({
+                where: { reportedAt: (0, typeorm_2.IsNull)() },
+                order: { id: 'ASC' },
+                take: 200,
+            });
+            if (!rows.length)
+                return { reported: 0 };
+            const items = rows.map((r) => ({
+                localId: r.id,
+                sessionId: r.sessionId,
+                sourceUrl: r.sourceUrl,
+                domain: r.domain,
+                pageClass: r.pageClass,
+                matchedRuleIds: r.matchedRuleIds || [],
+                extractedFields: this.sanitize(r.extractedFields),
+                missingFields: r.missingFields || [],
+                hasSnapshot: r.hasSnapshot,
+                status: r.status,
+                entityId: r.entityId ?? null,
+                localCreatedAt: r.createdAt?.toISOString(),
+            }));
+            const res = await fetch(endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Api-Key': this.config.get('HM_TELEMETRY_API_KEY') || '',
+                },
+                body: JSON.stringify({ clientId: this.clientId, items }),
+            });
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}`);
+            await this.parseLogRepo.update({ id: (0, typeorm_2.In)(rows.map((r) => r.id)) }, { reportedAt: new Date() });
+            this.logger.log(`telemetry reported ${rows.length} parse_log rows`);
+            return { reported: rows.length };
+        }
+        catch (err) {
+            this.logger.warn(`telemetry report failed: ${err.message}`);
+            return { error: err.message };
+        }
+        finally {
+            this.reporting = false;
+        }
+    }
+    get clientId() {
+        return `${os.userInfo().username}@${os.hostname()}`.slice(0, 64);
+    }
+    sanitize(fields) {
+        const out = {};
+        for (const [k, v] of Object.entries(fields || {})) {
+            if (v == null)
+                continue;
+            const s = String(v);
+            out[k] = s.length > 200 ? s.slice(0, 200) + '…' : s;
+        }
+        return out;
+    }
+};
+exports.TelemetryService = TelemetryService;
+exports.TelemetryService = TelemetryService = TelemetryService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, typeorm_1.InjectRepository)(parse_log_entity_1.ParseLog)),
+    __metadata("design:paramtypes", [typeorm_2.Repository,
+        config_1.ConfigService])
+], TelemetryService);
+//# sourceMappingURL=telemetry.service.js.map

package/dist/assets/server/telemetry/telemetry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.service.js","sourceRoot":"","sources":["../../src/telemetry/telemetry.service.ts"],"names":[],"mappings":"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"}

package/dist/bundled-assets.d.ts

@@ -0,0 +1,22 @@
+export interface BundledAssets {
+    extensionDir: string;
+    serverEntry: string;
+}
+/**
+ * Locate the bundled server + extension assets.
+ *
+ * Resolution order (first hit wins):
+ *   1) npm-installed mode:
+ *      - `<cliDir>/assets/server/main.js`
+ *      - `<cliDir>/assets/extension/manifest.json`
+ *      produced by `scripts/postbuild-assets.mjs` at build time.
+ *   2) monorepo dev mode (worktree layout):
+ *      - `../../../server/dist/main.js` next to `packages/cli/dist/index.js`
+ *      - `../../../extension/dist/manifest.json`
+ *
+ * Returns null if neither layout finds both pieces. Callers must show a
+ * clear "this npm package is missing server/extension assets — contact
+ * Hiredchina IT" message instead of generic "not found".
+ */
+export declare function findBundledAssets(cliDir?: string): BundledAssets | null;
+export declare function findExtensionParentDir(assets?: BundledAssets | null): string | null;

package/dist/bundled-assets.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Locate the bundled server + extension assets.
+ *
+ * Resolution order (first hit wins):
+ *   1) npm-installed mode:
+ *      - `<cliDir>/assets/server/main.js`
+ *      - `<cliDir>/assets/extension/manifest.json`
+ *      produced by `scripts/postbuild-assets.mjs` at build time.
+ *   2) monorepo dev mode (worktree layout):
+ *      - `../../../server/dist/main.js` next to `packages/cli/dist/index.js`
+ *      - `../../../extension/dist/manifest.json`
+ *
+ * Returns null if neither layout finds both pieces. Callers must show a
+ * clear "this npm package is missing server/extension assets — contact
+ * Hiredchina IT" message instead of generic "not found".
+ */
+export function findBundledAssets(cliDir) {
+    const baseDir = cliDir ?? findCliDir();
+    // (1) npm-installed mode
+    const installedServerEntry = path.join(baseDir, "assets", "server", "main.js");
+    const installedExtensionDir = path.join(baseDir, "assets", "extension");
+    if (fs.existsSync(installedServerEntry) &&
+        fs.existsSync(path.join(installedExtensionDir, "manifest.json"))) {
+        return {
+            serverEntry: installedServerEntry,
+            extensionDir: installedExtensionDir,
+        };
+    }
+    // (2) monorepo dev mode (CLI lives in packages/cli/dist)
+    const devServerEntry = path.resolve(baseDir, "..", "..", "..", "server", "dist", "main.js");
+    const devExtensionDir = path.resolve(baseDir, "..", "..", "..", "extension", "dist");
+    if (fs.existsSync(devServerEntry) &&
+        fs.existsSync(path.join(devExtensionDir, "manifest.json"))) {
+        return {
+            serverEntry: devServerEntry,
+            extensionDir: devExtensionDir,
+        };
+    }
+    // (3) monorepo dev mode via import.meta.url (more reliable for ts-node)
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        const dev2ServerEntry = path.resolve(here, "..", "..", "..", "server", "dist", "main.js");
+        const dev2ExtensionDir = path.resolve(here, "..", "..", "..", "extension", "dist");
+        if (fs.existsSync(dev2ServerEntry) &&
+            fs.existsSync(path.join(dev2ExtensionDir, "manifest.json"))) {
+            return {
+                serverEntry: dev2ServerEntry,
+                extensionDir: dev2ExtensionDir,
+            };
+        }
+    }
+    catch {
+        /* import.meta.url may be unavailable in CJS bundles; fall through */
+    }
+    return null;
+}
+/**
+ * Best-effort CLI directory resolution. We prefer `import.meta.url` because
+ * on Windows the npm `.cmd` shim sets argv[1] to the wrapper file, not the
+ * real `.js` entry. CJS fallback uses `__dirname` (reliable in bundled
+ * CJS output).
+ */
+function findCliDir() {
+    try {
+        return path.dirname(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return __dirname;
+    }
+}
+export function findExtensionParentDir(assets) {
+    const resolved = assets ?? findBundledAssets();
+    if (!resolved)
+        return null;
+    return path.dirname(resolved.extensionDir);
+}

package/dist/cache/db.js

@@ -1,63 +1,19 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureCacheDir = ensureCacheDir;
-exports.getDb = getDb;
-exports.saveJobCase = saveJobCase;
-exports.listJobCases = listJobCases;
-exports.saveCommunicationRecord = saveCommunicationRecord;
-exports.listCommunicationRecords = listCommunicationRecords;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+import * as fs from 'fs';
+import * as path from 'path';
+import Database from 'better-sqlite3';
 const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
 const CACHE_DIR = path.join(HOME, '.hunter-mate');
 const DB_FILE = path.join(CACHE_DIR, 'cache.db');
 let db = null;
-function ensureCacheDir() {
+export function ensureCacheDir() {
     if (!fs.existsSync(CACHE_DIR)) {
         fs.mkdirSync(CACHE_DIR, { recursive: true });
     }
 }
-function getDb() {
+export function getDb() {
     if (!db) {
         ensureCacheDir();
-        db = new better_sqlite3_1.default(DB_FILE);
+        db = new Database(DB_FILE);
         initSchema(db);
     }
     return db;
@@ -83,21 +39,21 @@ function initSchema(db) {
     );
   `);
 }
-function saveJobCase(jobCase) {
+export function saveJobCase(jobCase) {
     const stmt = getDb().prepare('INSERT OR REPLACE INTO job_cases (id, payload, created_at) VALUES (?, ?, ?)');
     stmt.run(jobCase.id, JSON.stringify(jobCase), jobCase.createdAt);
 }
-function listJobCases() {
+export function listJobCases() {
     return getDb()
         .prepare('SELECT payload FROM job_cases ORDER BY created_at DESC')
         .all()
         .map((row) => JSON.parse(row.payload));
 }
-function saveCommunicationRecord(record) {
+export function saveCommunicationRecord(record) {
     const stmt = getDb().prepare('INSERT OR REPLACE INTO communication_records (id, payload, created_at) VALUES (?, ?, ?)');
     stmt.run(String(record.id), JSON.stringify(record), Date.parse(record.createdAt) || Date.now());
 }
-function listCommunicationRecords() {
+export function listCommunicationRecords() {
     return getDb()
         .prepare('SELECT payload FROM communication_records ORDER BY created_at DESC')
         .all()

package/dist/commands/addons.js

@@ -1,42 +1,8 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.externalCommand = exports.skillCommand = exports.pluginCommand = void 0;
-const commander_1 = require("commander");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawnSyncSafe } from '../utils/spawn.js';
+import { getCliLogger } from '../logger.js';
 function formatOpt(cmd) {
     return cmd.option('-f, --format <format>', '输出格式: table|json|yaml|md|csv', 'json');
 }
@@ -75,13 +41,14 @@ const writeJson = (f, v) => fs.writeFileSync(f, JSON.stringify(v, null, 2));
 // ---------------------------------------------------------------------------
 // plugin (对应 chromepilot plugin)
 // ---------------------------------------------------------------------------
-exports.pluginCommand = formatOpt(new commander_1.Command('plugin')
+export const pluginCommand = formatOpt(new Command('plugin')
     .description('插件管理（对应 chromepilot plugin）: list|install|update|uninstall|create')
     .argument('[action]', '操作 (默认 list)', 'list')
     .argument('[arg]', 'install:source / uninstall|update:name / create:name')).action(async (action, arg, opts) => {
     ensure(PLUGINS_DIR());
     // install/update/uninstall 后: server 在跑则自动热重载插件（磁盘 vs 运行版本对比）
-    const syncPlugins = () => Promise.resolve().then(() => __importStar(require('../version'))).then(({ ensureRuntimeConsistency }) => ensureRuntimeConsistency({ force: true, verbose: true }))
+    const syncPlugins = () => import('../version.js')
+        .then(({ ensureRuntimeConsistency }) => ensureRuntimeConsistency({ force: true, verbose: true }))
         .catch(() => { });
     switch (action) {
         case 'list': {
@@ -103,12 +70,12 @@ exports.pluginCommand = formatOpt(new commander_1.Command('plugin')
         }
         case 'create': {
             if (!arg) {
-                console.error('plugin create 需要 name');
+                getCliLogger().error('addons:plugin-create-missing-arg', { hint: 'plugin create 需要 name' });
                 process.exit(1);
             }
             const dir = path.join(PLUGINS_DIR(), arg);
             if (fs.existsSync(dir)) {
-                console.error(`plugin ${arg} already exists: ${dir}`);
+                getCliLogger().error('addons:plugin-already-exists', { hint: `plugin ${arg} already exists: ${dir}` });
                 process.exit(1);
             }
             ensure(dir);
@@ -128,7 +95,7 @@ exports.pluginCommand = formatOpt(new commander_1.Command('plugin')
         }
         case 'install': {
             if (!arg) {
-                console.error('plugin install 需要 source（本地路径或 npm 包名）');
+                getCliLogger().error('addons:plugin-install-missing-arg', { hint: 'plugin install 需要 source（本地路径或 npm 包名）' });
                 process.exit(1);
             }
             // MVP: 本地路径复制；npm 包需单独调用 npm install --prefix
@@ -146,7 +113,7 @@ exports.pluginCommand = formatOpt(new commander_1.Command('plugin')
         }
         case 'update': {
             if (!arg) {
-                console.error('plugin update 需要 name');
+                getCliLogger().error('addons:plugin-update-missing-arg', { hint: 'plugin update 需要 name' });
                 process.exit(1);
             }
             const dir = path.join(PLUGINS_DIR(), arg);
@@ -155,18 +122,19 @@ exports.pluginCommand = formatOpt(new commander_1.Command('plugin')
                 return;
             }
             // 真实更新: git 仓 → git pull;npm 包 → npm update;完成后触发 server 端热重载
-            const { spawnSync } = require('child_process');
+            // spawnSyncSafe 跨平台处理:Windows 自动 shell:true + PATHEXT 解析(.cmd/.bat/.exe)
+            // POSIX 行为零变化(不依赖 shell)
             let updated = false;
             let detail = '';
             if (fs.existsSync(path.join(dir, '.git'))) {
-                const r = spawnSync('git', ['-C', dir, 'pull', '--ff-only'], { encoding: 'utf-8', timeout: 60_000 });
+                const r = spawnSyncSafe('git', ['-C', dir, 'pull', '--ff-only'], { encoding: 'utf-8', timeout: 60_000 });
                 updated = r.status === 0;
-                detail = r.stdout?.trim() || r.stderr?.trim() || '';
+                detail = String(r.stdout ?? '').trim() || String(r.stderr ?? '').trim() || '';
             }
             else if (fs.existsSync(path.join(dir, 'package.json')) && fs.existsSync(path.join(dir, 'node_modules'))) {
-                const r = spawnSync('npm', ['update', '--prefix', dir], { encoding: 'utf-8', timeout: 120_000 });
+                const r = spawnSyncSafe('npm', ['update', '--prefix', dir], { encoding: 'utf-8', timeout: 120_000 });
                 updated = r.status === 0;
-                detail = r.stdout?.trim() || r.stderr?.trim() || '';
+                detail = String(r.stdout ?? '').trim() || String(r.stderr ?? '').trim() || '';
             }
             else {
                 detail = `非 git 仓且非 npm 安装目录，请手动更新: ${dir}`;
@@ -178,7 +146,7 @@ exports.pluginCommand = formatOpt(new commander_1.Command('plugin')
         }
         case 'uninstall': {
             if (!arg) {
-                console.error('plugin uninstall 需要 name');
+                getCliLogger().error('addons:plugin-uninstall-missing-arg', { hint: 'plugin uninstall 需要 name' });
                 process.exit(1);
             }
             const dir = path.join(PLUGINS_DIR(), arg);
@@ -192,14 +160,16 @@ exports.pluginCommand = formatOpt(new commander_1.Command('plugin')
             return;
         }
         default:
-            console.error(`plugin: unknown action ${action}（支持: list|install|update|uninstall|create）`);
+            getCliLogger().error('addons:plugin-unknown-action', {
+                hint: `plugin: unknown action ${action}（支持: list|install|update|uninstall|create）`,
+            });
             process.exit(1);
     }
 });
 // ---------------------------------------------------------------------------
 // skill (对应 chromepilot skill)
 // ---------------------------------------------------------------------------
-exports.skillCommand = formatOpt(new commander_1.Command('skill')
+export const skillCommand = formatOpt(new Command('skill')
     .description('本地 CLI 级 skill 管理（对应 chromepilot skill）: list|show|path|create|remove|edit')
     .argument('[action]', '操作 (默认 list)', 'list')
     .argument('[name]', 'skill 名称')).action(async (action, name, opts) => {
@@ -216,7 +186,7 @@ exports.skillCommand = formatOpt(new commander_1.Command('skill')
         }
         case 'path': {
             if (!name) {
-                console.error('skill path 需要 name');
+                getCliLogger().error('addons:skill-path-missing-name', { hint: 'skill path 需要 name' });
                 process.exit(1);
             }
             const p = path.join(SKILLS_DIR(), name);
@@ -225,7 +195,7 @@ exports.skillCommand = formatOpt(new commander_1.Command('skill')
         }
         case 'show': {
             if (!name) {
-                console.error('skill show 需要 name');
+                getCliLogger().error('addons:skill-show-missing-name', { hint: 'skill show 需要 name' });
                 process.exit(1);
             }
             const sm = path.join(SKILLS_DIR(), name, 'SKILL.md');
@@ -238,12 +208,12 @@ exports.skillCommand = formatOpt(new commander_1.Command('skill')
         }
         case 'create': {
             if (!name) {
-                console.error('skill create 需要 name');
+                getCliLogger().error('addons:skill-create-missing-name', { hint: 'skill create 需要 name' });
                 process.exit(1);
             }
             const dir = path.join(SKILLS_DIR(), name);
             if (fs.existsSync(dir)) {
-                console.error(`skill ${name} 已存在`);
+                getCliLogger().error('addons:skill-already-exists', { hint: `skill ${name} 已存在` });
                 process.exit(1);
             }
             ensure(dir);
@@ -268,7 +238,7 @@ exports.skillCommand = formatOpt(new commander_1.Command('skill')
         }
         case 'remove': {
             if (!name) {
-                console.error('skill remove 需要 name');
+                getCliLogger().error('addons:skill-remove-missing-name', { hint: 'skill remove 需要 name' });
                 process.exit(1);
             }
             const dir = path.join(SKILLS_DIR(), name);
@@ -282,29 +252,33 @@ exports.skillCommand = formatOpt(new commander_1.Command('skill')
         }
         case 'edit': {
             if (!name) {
-                console.error('skill edit 需要 name');
+                getCliLogger().error('addons:skill-edit-missing-name', { hint: 'skill edit 需要 name' });
                 process.exit(1);
             }
             const sm = path.join(SKILLS_DIR(), name, 'SKILL.md');
             try {
-                const { default: open } = await Promise.resolve().then(() => __importStar(require('open')));
+                const { default: open } = await import('open');
                 await open(sm);
                 printResult({ ok: true, opening: sm }, opts.format);
             }
             catch (e) {
-                console.warn(`open not available: ${e.message}. 手动编辑: ${sm}`);
+                getCliLogger().warn('addons:skill-edit-open-failed', {
+                    hint: `open not available: ${e.message}. 手动编辑: ${sm}`,
+                });
             }
             return;
         }
         default:
-            console.error(`skill: unknown action ${action}（支持: list|show|path|create|remove|edit）`);
+            getCliLogger().error('addons:skill-unknown-action', {
+                hint: `skill: unknown action ${action}（支持: list|install|update|uninstall|create）`,
+            });
             process.exit(1);
     }
 });
 // ---------------------------------------------------------------------------
 // external (对应 chromepilot external)
 // ---------------------------------------------------------------------------
-exports.externalCommand = formatOpt(new commander_1.Command('external')
+export const externalCommand = formatOpt(new Command('external')
     .description('外部 CLI 透传（对应 chromepilot external）: list|register|install|run|unregister')
     .argument('[action]', '操作 (默认 list)', 'list')
     .argument('[name]', 'CLI 名称'))
@@ -319,7 +293,7 @@ exports.externalCommand = formatOpt(new commander_1.Command('external')
             return;
         case 'register': {
             if (!name || !opts.binary) {
-                console.error('external register 需要 name + --binary <path>');
+                getCliLogger().error('addons:external-register-missing-arg', { hint: 'external register 需要 name + --binary <path>' });
                 process.exit(1);
             }
             const e = { name, binary: opts.binary, description: opts.desc, registeredAt: new Date().toISOString() };
@@ -330,7 +304,7 @@ exports.externalCommand = formatOpt(new commander_1.Command('external')
         }
         case 'unregister': {
             if (!name) {
-                console.error('external unregister 需要 name');
+                getCliLogger().error('addons:external-unregister-missing-name', { hint: 'external unregister 需要 name' });
                 process.exit(1);
             }
             store.entries = store.entries.filter((x) => x.name !== name);
@@ -340,12 +314,12 @@ exports.externalCommand = formatOpt(new commander_1.Command('external')
         }
         case 'install': {
             if (!name) {
-                console.error('external install 需要 name（已注册的 CLI）');
+                getCliLogger().error('addons:external-install-missing-name', { hint: 'external install 需要 name（已注册的 CLI）' });
                 process.exit(1);
             }
             const e = store.entries.find((x) => x.name === name);
             if (!e) {
-                console.error(`external not registered: ${name}`);
+                getCliLogger().error('addons:external-not-registered', { hint: `external not registered: ${name}` });
                 process.exit(1);
             }
             // 校验可执行权限/存在
@@ -361,17 +335,18 @@ exports.externalCommand = formatOpt(new commander_1.Command('external')
         }
         case 'run': {
             if (!name) {
-                console.error('external run 需要 name');
+                getCliLogger().error('addons:external-run-missing-name', { hint: 'external run 需要 name' });
                 process.exit(1);
             }
             const e = store.entries.find((x) => x.name === name);
             if (!e) {
-                console.error(`external not registered: ${name}. 先 hunter-mate external register ${name} --binary <path>`);
+                getCliLogger().error('addons:external-not-registered', { hint: `external not registered: ${name}. 先 hunter-mate external register ${name} --binary <path>` });
                 process.exit(1);
             }
-            const { spawnSync } = require('child_process');
+            // spawnSyncSafe 在 Windows 上自动开 shell:true 让 .cmd/.bat 可执行;
+            // POSIX 上 shell:false 与原行为一致。
             const extraArgs = process.argv.slice(process.argv.indexOf(name) + 1);
-            const r = spawnSync(e.binary, extraArgs, { stdio: 'inherit', shell: false });
+            const r = spawnSyncSafe(e.binary, extraArgs, { stdio: 'inherit' });
             process.exit(r.status ?? 0);
         }
     }