novelws 1.2.0

package/dist/plugins/installers/github.js

@@ -0,0 +1,133 @@
+/**
+ * GitHub 安装器
+ *
+ * 从 GitHub 仓库下载并安装插件。
+ * 继承 BaseInstaller，复用公共 tar 解压逻辑。
+ * 支持 GITHUB_TOKEN 环境变量用于私有仓库。
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { pipeline } from 'stream/promises';
+import { createWriteStream } from 'fs';
+import { BaseInstaller } from './base.js';
+import { NetworkError, PluginInstallError } from '../../core/errors.js';
+import { logger } from '../../utils/logger.js';
+/** config.yaml 搜索最大深度 */
+const MAX_SEARCH_DEPTH = 3;
+export class GitHubInstaller extends BaseInstaller {
+    token;
+    constructor(options) {
+        super();
+        this.token = options?.githubToken || process.env.GITHUB_TOKEN;
+    }
+    getHeaders() {
+        const headers = {
+            'User-Agent': 'novel-writer-skills',
+            'Accept': 'application/vnd.github.v3+json',
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        return headers;
+    }
+    async getRepoInfo(repository) {
+        const url = `https://api.github.com/repos/${repository}`;
+        let response;
+        try {
+            response = await fetch(url, { headers: this.getHeaders() });
+        }
+        catch (error) {
+            throw new NetworkError(url, undefined, error instanceof Error ? error.message : '网络连接失败');
+        }
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new PluginInstallError(repository, 'github', `仓库 ${repository} 在 GitHub 上未找到`);
+            }
+            throw new NetworkError(url, response.status);
+        }
+        return await response.json();
+    }
+    async downloadArchive(repository, ref, destPath) {
+        const url = `https://api.github.com/repos/${repository}/tarball/${ref}`;
+        let response;
+        try {
+            response = await fetch(url, {
+                headers: { ...this.getHeaders(), 'Accept': '*/*' },
+                redirect: 'follow',
+            });
+        }
+        catch (error) {
+            throw new NetworkError(url, undefined, error instanceof Error ? error.message : '下载失败');
+        }
+        if (!response.ok || !response.body) {
+            throw new NetworkError(url, response.status, `从 GitHub 下载失败: ${repository}@${ref}`);
+        }
+        const fileStream = createWriteStream(destPath);
+        // @ts-ignore - Node.js fetch body is a ReadableStream
+        await pipeline(response.body, fileStream);
+    }
+    /**
+     * 在目录中查找 config.yaml，限制搜索深度
+     */
+    async findConfigYaml(dir, depth = 0) {
+        if (depth > MAX_SEARCH_DEPTH) {
+            return null;
+        }
+        const files = await fs.readdir(dir, { withFileTypes: true });
+        // 先检查当前目录
+        for (const file of files) {
+            if (file.isFile() && file.name === 'config.yaml') {
+                return path.join(dir, file.name);
+            }
+        }
+        // 再递归子目录
+        for (const file of files) {
+            if (file.isDirectory() && !file.name.startsWith('.') && file.name !== 'node_modules') {
+                const result = await this.findConfigYaml(path.join(dir, file.name), depth + 1);
+                if (result)
+                    return result;
+            }
+        }
+        return null;
+    }
+    async install(identifier, destDir) {
+        const { repository, version, name } = identifier;
+        if (!repository) {
+            throw new PluginInstallError(name, 'github', '缺少 GitHub 仓库地址');
+        }
+        logger.info(`从 GitHub 获取 ${repository}...`);
+        // 1. 创建临时目录
+        const tmpDir = await this.createTempDir('nws-gh-');
+        const tarballPath = path.join(tmpDir, 'repo.tar.gz');
+        try {
+            // 2. 下载 tarball
+            const ref = version || 'main';
+            logger.info(`下载 ${repository}@${ref}...`);
+            await this.downloadArchive(repository, ref, tarballPath);
+            // 3. 解压（GitHub tarball 有一层 repo-name-sha/ 包装）
+            const extractPath = path.join(tmpDir, 'extracted');
+            await this.extractTarball(tarballPath, extractPath, 0);
+            // 找到解压后的顶层目录
+            const entries = await fs.readdir(extractPath, { withFileTypes: true });
+            const topDir = entries.find(e => e.isDirectory());
+            if (!topDir) {
+                throw new PluginInstallError(name, 'github', '无效的归档结构');
+            }
+            const repoDir = path.join(extractPath, topDir.name);
+            // 4. 查找 config.yaml
+            const configPath = await this.findConfigYaml(repoDir);
+            if (!configPath) {
+                throw new PluginInstallError(name, 'github', `仓库 ${repository} 中未找到 config.yaml`);
+            }
+            const pluginRoot = path.dirname(configPath);
+            // 5. 移动到目标
+            const pluginDir = path.join(destDir, name);
+            await fs.move(pluginRoot, pluginDir, { overwrite: true });
+            return { version: ref, pluginPath: pluginDir };
+        }
+        finally {
+            await this.cleanup(tmpDir);
+        }
+    }
+}
+//# sourceMappingURL=github.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * 本地安装器
+ *
+ * 从本地路径复制插件到项目的 plugins 目录。
+ */
+import { PluginIdentifier, InstallResult } from '../types.js';
+import { BaseInstaller } from './base.js';
+export declare class LocalInstaller extends BaseInstaller {
+    install(identifier: PluginIdentifier, destDir: string): Promise<InstallResult>;
+    /**
+     * 从本地路径直接复制插件
+     */
+    installFromPath(sourcePath: string, pluginName: string, destDir: string): Promise<InstallResult>;
+    private installFromTarball;
+}
+//# sourceMappingURL=local.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/plugins/installers/local.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,qBAAa,cAAe,SAAQ,aAAa;IACzC,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAWpF;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YA2BxF,kBAAkB;CA2BjC"}

package/dist/plugins/installers/local.js

@@ -0,0 +1,69 @@
+/**
+ * 本地安装器
+ *
+ * 从本地路径复制插件到项目的 plugins 目录。
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { BaseInstaller } from './base.js';
+import { PluginInstallError } from '../../core/errors.js';
+export class LocalInstaller extends BaseInstaller {
+    async install(identifier, destDir) {
+        const { name } = identifier;
+        // 本地 tarball 安装
+        if (name.endsWith('.tgz') || name.endsWith('.tar.gz')) {
+            return this.installFromTarball(identifier, destDir);
+        }
+        throw new PluginInstallError(name, 'local', '不支持的本地安装格式');
+    }
+    /**
+     * 从本地路径直接复制插件
+     */
+    async installFromPath(sourcePath, pluginName, destDir) {
+        if (!await fs.pathExists(sourcePath)) {
+            throw new PluginInstallError(pluginName, 'local', `源路径不存在: ${sourcePath}`);
+        }
+        const pluginDir = path.join(destDir, pluginName);
+        await fs.copy(sourcePath, pluginDir, { overwrite: true });
+        // 尝试读取版本号
+        let version = '0.0.0';
+        try {
+            const yaml = (await import('js-yaml')).default;
+            const configPath = path.join(pluginDir, 'config.yaml');
+            if (await fs.pathExists(configPath)) {
+                const content = await fs.readFile(configPath, 'utf-8');
+                const config = yaml.load(content);
+                if (config && typeof config.version === 'string') {
+                    version = config.version;
+                }
+            }
+        }
+        catch {
+            // 读取版本失败不阻塞安装
+        }
+        return { version, pluginPath: pluginDir };
+    }
+    async installFromTarball(identifier, destDir) {
+        const { name } = identifier;
+        const tarballPath = path.resolve(name);
+        if (!await fs.pathExists(tarballPath)) {
+            throw new PluginInstallError(name, 'local', `文件不存在: ${tarballPath}`);
+        }
+        const tmpDir = await this.createTempDir('nws-local-');
+        try {
+            const extractPath = path.join(tmpDir, 'extracted');
+            await this.extractTarball(tarballPath, extractPath, 1);
+            // 确定插件名
+            const ext = name.endsWith('.tar.gz') ? '.tar.gz' : '.tgz';
+            const pluginName = path.basename(name, ext);
+            const pluginDir = path.join(destDir, pluginName);
+            await fs.ensureDir(path.dirname(pluginDir));
+            await fs.move(extractPath, pluginDir, { overwrite: true });
+            return { version: '0.0.0', pluginPath: pluginDir };
+        }
+        finally {
+            await this.cleanup(tmpDir);
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * NPM 安装器
+ *
+ * 从 npm registry 下载并安装插件。
+ * 继承 BaseInstaller，复用公共 tar 解压逻辑。
+ */
+import { PluginIdentifier, InstallResult, InstallerOptions } from '../types.js';
+import { BaseInstaller } from './base.js';
+export declare class NpmInstaller extends BaseInstaller {
+    private registry;
+    constructor(options?: InstallerOptions);
+    getPackageInfo(name: string): Promise<any>;
+    getTarballUrl(name: string, version?: string): Promise<{
+        url: string;
+        version: string;
+    }>;
+    downloadTarball(url: string, destPath: string): Promise<void>;
+    install(identifier: PluginIdentifier, destDir: string): Promise<InstallResult>;
+}
+//# sourceMappingURL=npm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../../src/plugins/installers/npm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI1C,qBAAa,YAAa,SAAQ,aAAa;IAC7C,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,CAAC,EAAE,gBAAgB;IAKhC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAoB1C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBxF,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7D,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAsCrF"}

package/dist/plugins/installers/npm.js

@@ -0,0 +1,99 @@
+/**
+ * NPM 安装器
+ *
+ * 从 npm registry 下载并安装插件。
+ * 继承 BaseInstaller，复用公共 tar 解压逻辑。
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { pipeline } from 'stream/promises';
+import { createWriteStream } from 'fs';
+import { BaseInstaller } from './base.js';
+import { NetworkError, PluginInstallError } from '../../core/errors.js';
+import { logger } from '../../utils/logger.js';
+export class NpmInstaller extends BaseInstaller {
+    registry;
+    constructor(options) {
+        super();
+        this.registry = options?.registryUrl || 'https://registry.npmjs.org';
+    }
+    async getPackageInfo(name) {
+        const url = `${this.registry}/${encodeURIComponent(name).replace('%40', '@')}`;
+        let response;
+        try {
+            response = await fetch(url);
+        }
+        catch (error) {
+            throw new NetworkError(url, undefined, error instanceof Error ? error.message : '网络连接失败');
+        }
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new PluginInstallError(name, 'npm', `包 ${name} 在 npm registry 中未找到`);
+            }
+            throw new NetworkError(url, response.status);
+        }
+        return await response.json();
+    }
+    async getTarballUrl(name, version) {
+        const info = await this.getPackageInfo(name);
+        const targetVersion = version || info['dist-tags']?.latest;
+        if (!targetVersion) {
+            throw new PluginInstallError(name, 'npm', '未找到可用版本');
+        }
+        const versionInfo = info.versions?.[targetVersion];
+        if (!versionInfo) {
+            throw new PluginInstallError(name, 'npm', `版本 ${targetVersion} 不存在`);
+        }
+        return {
+            url: versionInfo.dist.tarball,
+            version: targetVersion,
+        };
+    }
+    async downloadTarball(url, destPath) {
+        let response;
+        try {
+            response = await fetch(url);
+        }
+        catch (error) {
+            throw new NetworkError(url, undefined, error instanceof Error ? error.message : '下载失败');
+        }
+        if (!response.ok || !response.body) {
+            throw new NetworkError(url, response.status, '下载 tarball 失败');
+        }
+        const fileStream = createWriteStream(destPath);
+        // @ts-ignore - Node.js fetch body is a ReadableStream
+        await pipeline(response.body, fileStream);
+    }
+    async install(identifier, destDir) {
+        const { name, version } = identifier;
+        logger.info(`从 npm registry 获取 ${name}...`);
+        // 1. 获取 tarball URL
+        const tarball = await this.getTarballUrl(name, version);
+        // 2. 创建临时目录
+        const tmpDir = await this.createTempDir('nws-npm-');
+        const tarballPath = path.join(tmpDir, 'package.tgz');
+        try {
+            // 3. 下载
+            logger.info(`下载 ${name}@${tarball.version}...`);
+            await this.downloadTarball(tarball.url, tarballPath);
+            // 4. 解压（npm tarball 有一层 package/ 包装）
+            const extractPath = path.join(tmpDir, 'extracted');
+            await this.extractTarball(tarballPath, extractPath, 1);
+            // 5. 验证 config.yaml
+            const configPath = path.join(extractPath, 'config.yaml');
+            if (!await fs.pathExists(configPath)) {
+                throw new PluginInstallError(name, 'npm', `包 ${name} 中未找到 config.yaml`);
+            }
+            // 6. 移动到目标
+            const pluginName = path.basename(name);
+            const pluginDir = path.join(destDir, pluginName);
+            await fs.ensureDir(path.dirname(pluginDir));
+            await fs.move(extractPath, pluginDir, { overwrite: true });
+            return { version: tarball.version, pluginPath: pluginDir };
+        }
+        finally {
+            await this.cleanup(tmpDir);
+        }
+    }
+}
+//# sourceMappingURL=npm.js.map

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

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

package/dist/plugins/manager.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 插件管理器
+ *
+ * 协调层：安装器选择 → 安装 → 验证 → 注册 → 注入。
+ * 注册表管理已拆到 registry.ts，安装器已拆到 installers/。
+ *
+ * Bug 修复:
+ * - removePlugin() 现在会清理注入的命令文件
+ * - installPlugin() 统一更新注册表
+ */
+import { PluginConfig } from './types.js';
+import { PluginRegistry } from './registry.js';
+export declare class PluginManager {
+    private projectRoot;
+    private pluginsDir;
+    private commandsDir;
+    private skillsDir;
+    private registry;
+    private npmInstaller;
+    private githubInstaller;
+    private localInstaller;
+    constructor(projectRoot: string);
+    /**
+     * 扫描并加载所有插件
+     */
+    loadPlugins(): Promise<void>;
+    /**
+     * 扫描插件目录
+     */
+    private scanPlugins;
+    /**
+     * 加载单个插件（注入 commands 和 skills）
+     */
+    private loadPlugin;
+    /**
+     * 注入插件命令
+     */
+    private injectCommands;
+    /**
+     * 注入插件 Skills
+     */
+    private injectSkills;
+    /**
+     * 清理插件注入的命令文件
+     */
+    private cleanupCommands;
+    /**
+     * 列出所有已安装的插件
+     */
+    listPlugins(): Promise<PluginConfig[]>;
+    /**
+     * 从本地路径安装插件（内置插件）
+     */
+    installPlugin(pluginName: string, source?: string): Promise<void>;
+    /**
+     * 移除插件
+     * 修复: 现在会读取配置并清理注入的命令文件
+     */
+    removePlugin(pluginName: string): Promise<void>;
+    /**
+     * 检查插件是否已安装
+     */
+    isPluginInstalled(name: string): Promise<boolean>;
+    /**
+     * 远程安装插件（支持 npm/GitHub/local）
+     */
+    installRemotePlugin(input: string): Promise<void>;
+    /**
+     * 更新插件
+     */
+    updatePlugin(name: string): Promise<void>;
+    /**
+     * 获取已安装插件的注册表信息
+     */
+    getRegistry(): Promise<PluginRegistry>;
+}
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAM1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAS/C,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,WAAW,EAAE,MAAM;IAY/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBlC;;OAEG;YACW,WAAW;IAyBzB;;OAEG;YACW,UAAU;IA8BxB;;OAEG;YACW,cAAc;IAkB5B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;YACW,eAAe;IAc7B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAe5C;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCvE;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrD;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvD;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8EvD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;CAI7C"}