novelws 1.2.0

package/dist/core/config.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 自定义错误类型层级
+ *
+ * 所有 NovelWriter 错误继承自 NovelWriterError，
+ * CLI 层统一捕获并格式化输出。
+ */
+export declare class NovelWriterError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    constructor(message: string, code: string, exitCode?: number);
+}
+/** 不在项目目录中 */
+export declare class ProjectNotFoundError extends NovelWriterError {
+    constructor(dir?: string);
+}
+/** 项目已存在 */
+export declare class ProjectExistsError extends NovelWriterError {
+    constructor(name: string);
+}
+/** 插件不存在 */
+export declare class PluginNotFoundError extends NovelWriterError {
+    constructor(name: string);
+}
+/** 插件校验失败 */
+export declare class PluginValidationError extends NovelWriterError {
+    readonly errors: string[];
+    readonly warnings: string[];
+    constructor(name: string, errors: string[], warnings?: string[]);
+}
+/** 插件安装失败 */
+export declare class PluginInstallError extends NovelWriterError {
+    readonly source: string;
+    constructor(name: string, source: string, reason?: string);
+}
+/** 网络请求失败 */
+export declare class NetworkError extends NovelWriterError {
+    readonly url: string;
+    readonly statusCode?: number;
+    constructor(url: string, statusCode?: number, reason?: string);
+}
+/** 平台不兼容 */
+export declare class PlatformError extends NovelWriterError {
+    constructor(message: string);
+}
+/** 配置文件损坏或缺失 */
+export declare class ConfigError extends NovelWriterError {
+    readonly configPath: string;
+    constructor(configPath: string, reason?: string);
+}
+/** 插件已安装 */
+export declare class PluginAlreadyInstalledError extends NovelWriterError {
+    constructor(name: string);
+}
+/**
+ * CLI 全局错误处理
+ * 将 NovelWriterError 格式化为用户友好的输出，非预期错误输出堆栈
+ */
+export declare function handleError(error: unknown): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU;CAMhE;AAED,cAAc;AACd,qBAAa,oBAAqB,SAAQ,gBAAgB;gBAC5C,GAAG,CAAC,EAAE,MAAM;CAMzB;AAED,YAAY;AACZ,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,IAAI,EAAE,MAAM;CAGzB;AAED,YAAY;AACZ,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,IAAI,EAAE,MAAM;CAGzB;AAED,aAAa;AACb,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAEhB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAM,EAAO;CAKpE;AAED,aAAa;AACb,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAO1D;AAED,aAAa;AACb,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAU9D;AAED,YAAY;AACZ,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,OAAO,EAAE,MAAM;CAG5B;AAED,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOhD;AAED,YAAY;AACZ,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,IAAI,EAAE,MAAM;CAGzB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAyBjD"}

package/dist/core/errors.js

@@ -0,0 +1,125 @@
+/**
+ * 自定义错误类型层级
+ *
+ * 所有 NovelWriter 错误继承自 NovelWriterError，
+ * CLI 层统一捕获并格式化输出。
+ */
+export class NovelWriterError extends Error {
+    code;
+    exitCode;
+    constructor(message, code, exitCode = 1) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.exitCode = exitCode;
+    }
+}
+/** 不在项目目录中 */
+export class ProjectNotFoundError extends NovelWriterError {
+    constructor(dir) {
+        const msg = dir
+            ? `目录 "${dir}" 不是 novel-writer-skills 项目`
+            : '当前目录不是 novel-writer-skills 项目，请在项目根目录运行此命令';
+        super(msg, 'PROJECT_NOT_FOUND');
+    }
+}
+/** 项目已存在 */
+export class ProjectExistsError extends NovelWriterError {
+    constructor(name) {
+        super(`项目目录 "${name}" 已存在`, 'PROJECT_EXISTS');
+    }
+}
+/** 插件不存在 */
+export class PluginNotFoundError extends NovelWriterError {
+    constructor(name) {
+        super(`插件 "${name}" 未找到`, 'PLUGIN_NOT_FOUND');
+    }
+}
+/** 插件校验失败 */
+export class PluginValidationError extends NovelWriterError {
+    errors;
+    warnings;
+    constructor(name, errors, warnings = []) {
+        super(`插件 "${name}" 验证失败: ${errors.join(', ')}`, 'PLUGIN_VALIDATION_FAILED');
+        this.errors = errors;
+        this.warnings = warnings;
+    }
+}
+/** 插件安装失败 */
+export class PluginInstallError extends NovelWriterError {
+    source;
+    constructor(name, source, reason) {
+        const msg = reason
+            ? `插件 "${name}" 安装失败 (来源: ${source}): ${reason}`
+            : `插件 "${name}" 安装失败 (来源: ${source})`;
+        super(msg, 'PLUGIN_INSTALL_FAILED');
+        this.source = source;
+    }
+}
+/** 网络请求失败 */
+export class NetworkError extends NovelWriterError {
+    url;
+    statusCode;
+    constructor(url, statusCode, reason) {
+        const msg = reason
+            ? `网络请求失败 (${url}): ${reason}`
+            : statusCode
+                ? `网络请求失败 (${url}): HTTP ${statusCode}`
+                : `网络请求失败 (${url})`;
+        super(msg, 'NETWORK_ERROR');
+        this.url = url;
+        this.statusCode = statusCode;
+    }
+}
+/** 平台不兼容 */
+export class PlatformError extends NovelWriterError {
+    constructor(message) {
+        super(message, 'PLATFORM_ERROR');
+    }
+}
+/** 配置文件损坏或缺失 */
+export class ConfigError extends NovelWriterError {
+    configPath;
+    constructor(configPath, reason) {
+        const msg = reason
+            ? `配置文件错误 (${configPath}): ${reason}`
+            : `配置文件错误: ${configPath}`;
+        super(msg, 'CONFIG_ERROR');
+        this.configPath = configPath;
+    }
+}
+/** 插件已安装 */
+export class PluginAlreadyInstalledError extends NovelWriterError {
+    constructor(name) {
+        super(`插件 "${name}" 已安装。如需更新请使用 plugin:update`, 'PLUGIN_ALREADY_INSTALLED');
+    }
+}
+/**
+ * CLI 全局错误处理
+ * 将 NovelWriterError 格式化为用户友好的输出，非预期错误输出堆栈
+ */
+export function handleError(error) {
+    if (error instanceof NovelWriterError) {
+        console.error(`\n❌ ${error.message}`);
+        if (error instanceof PluginValidationError && error.errors.length > 0) {
+            for (const err of error.errors) {
+                console.error(`   - ${err}`);
+            }
+        }
+        process.exit(error.exitCode);
+    }
+    if (error instanceof Error) {
+        // Commander.js 的 exitOverride 错误
+        if (error.message === '(outputHelp)' || error.exitCode === 0) {
+            process.exit(0);
+        }
+        console.error(`\n❌ 未预期的错误: ${error.message}`);
+        if (process.env.DEBUG) {
+            console.error(error.stack);
+        }
+        process.exit(1);
+    }
+    console.error('\n❌ 未知错误:', error);
+    process.exit(1);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/platform.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 跨平台工具
+ *
+ * 统一 tar 解压逻辑（Windows PowerShell / Unix tar），
+ * 提供可执行权限设置、临时目录管理等工具。
+ */
+/**
+ * 解压 tarball 文件
+ * Windows 使用 PowerShell 的 tar 命令，Unix 使用系统 tar
+ */
+export declare function extractTarball(tarballPath: string, extractPath: string, options?: {
+    stripComponents?: number;
+}): Promise<void>;
+/**
+ * 设置文件可执行权限
+ * Unix 上设置 0o755，Windows 上跳过（无需此操作）
+ */
+export declare function setExecutable(filePath: string): void;
+/**
+ * 创建临时目录
+ */
+export declare function createTempDir(prefix?: string): Promise<string>;
+/**
+ * 清理临时目录
+ */
+export declare function cleanupTempDir(dir: string): Promise<void>;
+//# sourceMappingURL=platform.d.ts.map

package/dist/core/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/core/platform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAapD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,GAAE,MAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/D"}

package/dist/core/platform.js

@@ -0,0 +1,75 @@
+/**
+ * 跨平台工具
+ *
+ * 统一 tar 解压逻辑（Windows PowerShell / Unix tar），
+ * 提供可执行权限设置、临时目录管理等工具。
+ */
+import { execSync } from 'child_process';
+import fs from 'fs-extra';
+import os from 'os';
+import path from 'path';
+import { PlatformError } from './errors.js';
+/**
+ * 解压 tarball 文件
+ * Windows 使用 PowerShell 的 tar 命令，Unix 使用系统 tar
+ */
+export async function extractTarball(tarballPath, extractPath, options) {
+    await fs.ensureDir(extractPath);
+    const strip = options?.stripComponents ?? 0;
+    const isWindows = process.platform === 'win32';
+    try {
+        if (isWindows) {
+            // Windows: 使用 tar 命令（Windows 10+ 内置）
+            const stripArg = strip > 0 ? `--strip-components=${strip}` : '';
+            const cmd = `tar -xzf "${tarballPath}" -C "${extractPath}" ${stripArg}`.trim();
+            execSync(cmd, { stdio: 'ignore' });
+        }
+        else {
+            // Unix: 使用系统 tar
+            const stripArg = strip > 0 ? `--strip-components=${strip}` : '';
+            const cmd = `tar -xzf "${tarballPath}" -C "${extractPath}" ${stripArg}`.trim();
+            execSync(cmd, { stdio: 'ignore' });
+        }
+    }
+    catch (error) {
+        throw new PlatformError(`解压 tarball 失败: ${tarballPath} → ${extractPath}` +
+            (error instanceof Error ? `: ${error.message}` : ''));
+    }
+}
+/**
+ * 设置文件可执行权限
+ * Unix 上设置 0o755，Windows 上跳过（无需此操作）
+ */
+export function setExecutable(filePath) {
+    if (process.platform === 'win32') {
+        return;
+    }
+    try {
+        fs.chmodSync(filePath, 0o755);
+    }
+    catch (error) {
+        throw new PlatformError(`设置可执行权限失败: ${filePath}` +
+            (error instanceof Error ? `: ${error.message}` : ''));
+    }
+}
+/**
+ * 创建临时目录
+ */
+export async function createTempDir(prefix = 'nws-') {
+    const tmpBase = os.tmpdir();
+    const tmpDir = path.join(tmpBase, `${prefix}${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+    await fs.ensureDir(tmpDir);
+    return tmpDir;
+}
+/**
+ * 清理临时目录
+ */
+export async function cleanupTempDir(dir) {
+    try {
+        await fs.remove(dir);
+    }
+    catch {
+        // 清理失败不阻塞主流程
+    }
+}
+//# sourceMappingURL=platform.js.map

package/dist/core/platform.js.map

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

package/dist/core/template.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 模板引擎
+ *
+ * 封装模板复制逻辑，供 init 和 upgrade 命令使用。
+ */
+export interface CopyOptions {
+    /** 是否覆盖已存在的文件，默认 false */
+    overwrite?: boolean;
+    /** 过滤函数，返回 false 跳过该文件 */
+    filter?: (src: string) => boolean;
+}
+export interface CopyResult {
+    /** 已复制的文件数 */
+    copied: number;
+    /** 已跳过的文件数（已存在且未覆盖） */
+    skipped: number;
+}
+/**
+ * 复制模板目录
+ * 递归复制 source 下所有文件到 dest
+ */
+export declare function copyTemplates(source: string, dest: string, options?: CopyOptions): Promise<CopyResult>;
+/**
+ * 复制单个模板文件
+ * 返回 true 表示已复制，false 表示已跳过
+ */
+export declare function copyTemplateFile(source: string, dest: string, options?: CopyOptions): Promise<boolean>;
+/**
+ * 获取目录下所有文件的内容哈希清单
+ * 用于 upgrade 时比较文件是否有变化
+ *
+ * 返回 Map<相对路径, md5哈希>
+ */
+export declare function getTemplateManifest(dir: string): Promise<Map<string, string>>;
+//# sourceMappingURL=template.d.ts.map

package/dist/core/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/core/template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASnF"}

package/dist/core/template.js

@@ -0,0 +1,94 @@
+/**
+ * 模板引擎
+ *
+ * 封装模板复制逻辑，供 init 和 upgrade 命令使用。
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import crypto from 'crypto';
+/**
+ * 复制模板目录
+ * 递归复制 source 下所有文件到 dest
+ */
+export async function copyTemplates(source, dest, options) {
+    const result = { copied: 0, skipped: 0 };
+    if (!await fs.pathExists(source)) {
+        return result;
+    }
+    const overwrite = options?.overwrite ?? false;
+    await fs.ensureDir(dest);
+    const entries = await fs.readdir(source, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(source, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (options?.filter && !options.filter(srcPath)) {
+            result.skipped++;
+            continue;
+        }
+        if (entry.isDirectory()) {
+            const subResult = await copyTemplates(srcPath, destPath, options);
+            result.copied += subResult.copied;
+            result.skipped += subResult.skipped;
+        }
+        else {
+            if (!overwrite && await fs.pathExists(destPath)) {
+                result.skipped++;
+            }
+            else {
+                await fs.ensureDir(path.dirname(destPath));
+                await fs.copy(srcPath, destPath, { overwrite: true });
+                result.copied++;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * 复制单个模板文件
+ * 返回 true 表示已复制，false 表示已跳过
+ */
+export async function copyTemplateFile(source, dest, options) {
+    if (!await fs.pathExists(source)) {
+        return false;
+    }
+    if (options?.filter && !options.filter(source)) {
+        return false;
+    }
+    const overwrite = options?.overwrite ?? false;
+    if (!overwrite && await fs.pathExists(dest)) {
+        return false;
+    }
+    await fs.ensureDir(path.dirname(dest));
+    await fs.copy(source, dest, { overwrite: true });
+    return true;
+}
+/**
+ * 获取目录下所有文件的内容哈希清单
+ * 用于 upgrade 时比较文件是否有变化
+ *
+ * 返回 Map<相对路径, md5哈希>
+ */
+export async function getTemplateManifest(dir) {
+    const manifest = new Map();
+    if (!await fs.pathExists(dir)) {
+        return manifest;
+    }
+    await walkDir(dir, dir, manifest);
+    return manifest;
+}
+async function walkDir(baseDir, currentDir, manifest) {
+    const entries = await fs.readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(currentDir, entry.name);
+        if (entry.isDirectory()) {
+            await walkDir(baseDir, fullPath, manifest);
+        }
+        else {
+            const relativePath = path.relative(baseDir, fullPath);
+            const content = await fs.readFile(fullPath);
+            const hash = crypto.createHash('md5').update(content).digest('hex');
+            manifest.set(relativePath, hash);
+        }
+    }
+}
+//# sourceMappingURL=template.js.map

package/dist/core/template.js.map

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

package/dist/plugins/identifier.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 插件标识符解析
+ *
+ * 支持格式:
+ * - npm scoped: @scope/name 或 @scope/name@version
+ * - npm: name 或 name@version（支持版本范围如 ^1.0.0、~1.2.0）
+ * - GitHub URL: https://github.com/user/repo
+ * - GitHub shorthand: user/repo 或 user/repo@ref
+ * - Local tarball: ./path.tgz 或 ./path.tar.gz
+ */
+import { PluginIdentifier } from './types.js';
+export declare function parsePluginIdentifier(input: string): PluginIdentifier;
+//# sourceMappingURL=identifier.d.ts.map

package/dist/plugins/identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/plugins/identifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAU9C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CA6DrE"}

package/dist/plugins/identifier.js

@@ -0,0 +1,72 @@
+/**
+ * 插件标识符解析
+ *
+ * 支持格式:
+ * - npm scoped: @scope/name 或 @scope/name@version
+ * - npm: name 或 name@version（支持版本范围如 ^1.0.0、~1.2.0）
+ * - GitHub URL: https://github.com/user/repo
+ * - GitHub shorthand: user/repo 或 user/repo@ref
+ * - Local tarball: ./path.tgz 或 ./path.tar.gz
+ */
+import path from 'path';
+const SUPPORTED_FORMATS = [
+    'npm 包名 (如 my-plugin 或 my-plugin@1.0.0)',
+    'npm scoped 包名 (如 @scope/my-plugin)',
+    'GitHub 仓库 (如 user/repo 或 user/repo@tag)',
+    'GitHub URL (如 https://github.com/user/repo)',
+    '本地 tarball (如 ./plugin.tgz)',
+].join('\n  - ');
+export function parsePluginIdentifier(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error(`插件标识符不能为空。支持的格式:\n  - ${SUPPORTED_FORMATS}`);
+    }
+    // npm scoped package: @scope/name 或 @scope/name@version
+    const scopedNpmMatch = trimmed.match(/^(@[\w-]+\/[\w-]+)(?:@(.+))?$/);
+    if (scopedNpmMatch) {
+        return {
+            type: 'npm',
+            name: scopedNpmMatch[1],
+            version: scopedNpmMatch[2],
+            scope: scopedNpmMatch[1].split('/')[0],
+        };
+    }
+    // GitHub URL: 严格匹配 https://github.com/user/repo
+    const githubUrlMatch = trimmed.match(/^https?:\/\/github\.com\/([\w.-]+)\/([\w.-]+?)(?:\.git)?(?:\/.*)?$/);
+    if (githubUrlMatch) {
+        return {
+            type: 'github',
+            repository: `${githubUrlMatch[1]}/${githubUrlMatch[2]}`,
+            name: githubUrlMatch[2],
+        };
+    }
+    // Local tarball: *.tgz 或 *.tar.gz（在 GitHub shorthand 之前检查）
+    if (trimmed.endsWith('.tgz') || trimmed.endsWith('.tar.gz')) {
+        const ext = trimmed.endsWith('.tar.gz') ? '.tar.gz' : '.tgz';
+        return {
+            type: 'local',
+            name: path.basename(trimmed, ext),
+        };
+    }
+    // GitHub shorthand: user/repo 或 user/repo@ref
+    const githubMatch = trimmed.match(/^([\w.-]+)\/([\w.-]+)(?:@([\w./-]+))?$/);
+    if (githubMatch) {
+        return {
+            type: 'github',
+            repository: `${githubMatch[1]}/${githubMatch[2]}`,
+            name: githubMatch[2],
+            version: githubMatch[3] || 'main',
+        };
+    }
+    // npm package: name 或 name@version（支持版本范围如 ^1.0.0、~1.2.0、>=1.0.0）
+    const npmMatch = trimmed.match(/^([\w-]+)(?:@(.+))?$/);
+    if (npmMatch) {
+        return {
+            type: 'npm',
+            name: npmMatch[1],
+            version: npmMatch[2],
+        };
+    }
+    throw new Error(`无法识别的插件格式: "${trimmed}"。支持的格式:\n  - ${SUPPORTED_FORMATS}`);
+}
+//# sourceMappingURL=identifier.js.map

package/dist/plugins/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/plugins/identifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,iBAAiB,GAAG;IACxB,wCAAwC;IACxC,oCAAoC;IACpC,yCAAyC;IACzC,6CAA6C;IAC7C,6BAA6B;CAC9B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAEjB,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,iBAAiB,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,wDAAwD;IACxD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACtE,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;YACvB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YAC1B,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC3G,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE;YACvD,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;SACxB,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;SAClC,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5E,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE;YACjD,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM;SAClC,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACvD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YACjB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,iBAAiB,iBAAiB,EAAE,CAC3D,CAAC;AACJ,CAAC"}

package/dist/plugins/installers/base.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 安装器抽象基类
+ *
+ * 提取 npm/github/local 安装器的公共逻辑：
+ * 临时目录管理、tar 解压。
+ */
+import { PluginIdentifier, InstallResult } from '../types.js';
+export declare abstract class BaseInstaller {
+    /**
+     * 解压 tarball 到指定目录
+     */
+    protected extractTarball(tarballPath: string, extractPath: string, stripComponents?: number): Promise<void>;
+    /**
+     * 创建临时工作目录
+     */
+    protected createTempDir(prefix?: string): Promise<string>;
+    /**
+     * 清理临时目录
+     */
+    protected cleanup(tempDir: string): Promise<void>;
+    /**
+     * 安装插件到目标目录
+     * 子类必须实现此方法
+     */
+    abstract install(identifier: PluginIdentifier, destDir: string): Promise<InstallResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/plugins/installers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/plugins/installers/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG9D,8BAAsB,aAAa;IACjC;;OAEG;cACa,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;cACa,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D;;OAEG;cACa,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CACxF"}

package/dist/plugins/installers/base.js

@@ -0,0 +1,30 @@
+/**
+ * 安装器抽象基类
+ *
+ * 提取 npm/github/local 安装器的公共逻辑：
+ * 临时目录管理、tar 解压。
+ */
+import { extractTarball, createTempDir, cleanupTempDir } from '../../core/platform.js';
+export class BaseInstaller {
+    /**
+     * 解压 tarball 到指定目录
+     */
+    async extractTarball(tarballPath, extractPath, stripComponents) {
+        await extractTarball(tarballPath, extractPath, {
+            stripComponents: stripComponents ?? 0,
+        });
+    }
+    /**
+     * 创建临时工作目录
+     */
+    async createTempDir(prefix) {
+        return createTempDir(prefix);
+    }
+    /**
+     * 清理临时目录
+     */
+    async cleanup(tempDir) {
+        await cleanupTempDir(tempDir);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/plugins/installers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/plugins/installers/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEvF,MAAM,OAAgB,aAAa;IACjC;;OAEG;IACO,KAAK,CAAC,cAAc,CAC5B,WAAmB,EACnB,WAAmB,EACnB,eAAwB;QAExB,MAAM,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE;YAC7C,eAAe,EAAE,eAAe,IAAI,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,aAAa,CAAC,MAAe;QAC3C,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,OAAO,CAAC,OAAe;QACrC,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;CAOF"}

package/dist/plugins/installers/github.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GitHub 安装器
+ *
+ * 从 GitHub 仓库下载并安装插件。
+ * 继承 BaseInstaller，复用公共 tar 解压逻辑。
+ * 支持 GITHUB_TOKEN 环境变量用于私有仓库。
+ */
+import { PluginIdentifier, InstallResult, InstallerOptions } from '../types.js';
+import { BaseInstaller } from './base.js';
+export declare class GitHubInstaller extends BaseInstaller {
+    private token?;
+    constructor(options?: InstallerOptions);
+    private getHeaders;
+    getRepoInfo(repository: string): Promise<any>;
+    downloadArchive(repository: string, ref: string, destPath: string): Promise<void>;
+    /**
+     * 在目录中查找 config.yaml，限制搜索深度
+     */
+    private findConfigYaml;
+    install(identifier: PluginIdentifier, destDir: string): Promise<InstallResult>;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/plugins/installers/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/plugins/installers/github.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAO1C,qBAAa,eAAgB,SAAQ,aAAa;IAChD,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,OAAO,CAAC,EAAE,gBAAgB;IAKtC,OAAO,CAAC,UAAU;IAWZ,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAoB7C,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAsBhB;;OAEG;YACW,cAAc;IAyBtB,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAkDrF"}