novelws 1.2.0

package/dist/plugins/validator.js

@@ -0,0 +1,164 @@
+/**
+ * 插件验证器
+ *
+ * 验证插件目录结构和 config.yaml 内容。
+ * 增强：schema 校验、运行时类型检查、文件名合法性验证。
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import yaml from 'js-yaml';
+/** 合法的插件类型 */
+const VALID_PLUGIN_TYPES = ['feature', 'expert', 'workflow'];
+/** 检查 ID 是否为合法文件名 */
+function isValidId(id) {
+    return /^[\w-]+$/.test(id);
+}
+export class PluginValidator {
+    /**
+     * 验证插件目录
+     */
+    static async validate(pluginPath) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+        };
+        // 1. 检查 config.yaml 存在
+        const configPath = path.join(pluginPath, 'config.yaml');
+        if (!await fs.pathExists(configPath)) {
+            result.valid = false;
+            result.errors.push('config.yaml 未找到');
+            return result;
+        }
+        // 2. 解析 YAML
+        let rawConfig;
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            rawConfig = yaml.load(content);
+        }
+        catch {
+            result.valid = false;
+            result.errors.push('config.yaml 不是有效的 YAML 格式');
+            return result;
+        }
+        if (!rawConfig || typeof rawConfig !== 'object') {
+            result.valid = false;
+            result.errors.push('config.yaml 内容为空或无效');
+            return result;
+        }
+        const config = rawConfig;
+        // 3. 验证必填字段
+        if (!config.name || typeof config.name !== 'string') {
+            result.valid = false;
+            result.errors.push('config.yaml 缺少必填字段: name');
+        }
+        if (!config.version || typeof config.version !== 'string') {
+            result.warnings.push('config.yaml 缺少 version 字段');
+        }
+        if (!config.description || typeof config.description !== 'string') {
+            result.warnings.push('config.yaml 缺少 description 字段');
+        }
+        // 4. 验证 type 字段
+        if (config.type) {
+            if (typeof config.type !== 'string' || !VALID_PLUGIN_TYPES.includes(config.type)) {
+                result.warnings.push(`config.yaml 的 type 字段无效: "${config.type}"，有效值: ${VALID_PLUGIN_TYPES.join(', ')}`);
+            }
+        }
+        // 5. 验证命令声明
+        if (config.commands) {
+            if (!Array.isArray(config.commands)) {
+                result.valid = false;
+                result.errors.push('config.yaml 的 commands 字段必须是数组');
+            }
+            else {
+                for (const cmd of config.commands) {
+                    if (!cmd || typeof cmd !== 'object') {
+                        result.errors.push('commands 数组中包含无效条目');
+                        result.valid = false;
+                        continue;
+                    }
+                    const cmdObj = cmd;
+                    if (!cmdObj.id || typeof cmdObj.id !== 'string') {
+                        result.errors.push('命令缺少 id 字段');
+                        result.valid = false;
+                    }
+                    else if (!isValidId(cmdObj.id)) {
+                        result.errors.push(`命令 ID 不合法: "${cmdObj.id}"（只允许字母、数字、下划线、连字符）`);
+                        result.valid = false;
+                    }
+                    // 检查命令文件是否存在
+                    const cmdFile = cmdObj.file || `${cmdObj.id || 'unknown'}.md`;
+                    const cmdPath = path.join(pluginPath, cmdFile);
+                    if (!await fs.pathExists(cmdPath)) {
+                        result.warnings.push(`声明的命令文件不存在: ${cmdFile}`);
+                    }
+                }
+            }
+        }
+        // 6. 验证 Skills 声明
+        if (config.skills) {
+            if (!Array.isArray(config.skills)) {
+                result.valid = false;
+                result.errors.push('config.yaml 的 skills 字段必须是数组');
+            }
+            else {
+                for (const skill of config.skills) {
+                    if (!skill || typeof skill !== 'object') {
+                        result.errors.push('skills 数组中包含无效条目');
+                        result.valid = false;
+                        continue;
+                    }
+                    const skillObj = skill;
+                    if (!skillObj.id || typeof skillObj.id !== 'string') {
+                        result.errors.push('Skill 缺少 id 字段');
+                        result.valid = false;
+                    }
+                    else if (!isValidId(skillObj.id)) {
+                        result.errors.push(`Skill ID 不合法: "${skillObj.id}"（只允许字母、数字、下划线、连字符）`);
+                        result.valid = false;
+                    }
+                    // 检查 Skill 文件是否存在
+                    const skillFile = skillObj.file || path.join('skills', String(skillObj.id || 'unknown'), 'SKILL.md');
+                    const skillPath = path.join(pluginPath, skillFile);
+                    if (!await fs.pathExists(skillPath)) {
+                        result.warnings.push(`声明的 Skill 文件不存在: ${skillFile}`);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * 安全解析 config.yaml 为 PluginConfig
+     * 返回 null 表示解析失败
+     */
+    static async parseConfig(configPath) {
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            const raw = yaml.load(content);
+            if (!raw || typeof raw !== 'object') {
+                return null;
+            }
+            const config = raw;
+            if (!config.name || typeof config.name !== 'string') {
+                return null;
+            }
+            return {
+                name: config.name,
+                version: typeof config.version === 'string' ? config.version : '0.0.0',
+                description: typeof config.description === 'string' ? config.description : '',
+                type: VALID_PLUGIN_TYPES.includes(config.type)
+                    ? config.type
+                    : 'feature',
+                commands: Array.isArray(config.commands) ? config.commands : undefined,
+                skills: Array.isArray(config.skills) ? config.skills : undefined,
+                dependencies: config.dependencies,
+                installation: config.installation,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/plugins/validator.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,13 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export declare const logger: {
+    /** 设置日志级别 */
+    setLevel(level: LogLevel): void;
+    /** 获取当前日志级别 */
+    getLevel(): LogLevel;
+    info: (message: string, ...args: any[]) => void;
+    success: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+    debug: (message: string, ...args: any[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAgBtE,eAAO,MAAM,MAAM;IACjB,aAAa;oBACG,QAAQ,GAAG,IAAI;IAI/B,eAAe;gBACH,QAAQ;oBAIJ,MAAM,WAAW,GAAG,EAAE;uBAMnB,MAAM,WAAW,GAAG,EAAE;oBAMzB,MAAM,WAAW,GAAG,EAAE;qBAMrB,MAAM,WAAW,GAAG,EAAE;qBAMtB,MAAM,WAAW,GAAG,EAAE;CAKxC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,48 @@
+import chalk from 'chalk';
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+let _currentLevel = 'info';
+function shouldLog(level) {
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[_currentLevel];
+}
+export const logger = {
+    /** 设置日志级别 */
+    setLevel(level) {
+        _currentLevel = level;
+    },
+    /** 获取当前日志级别 */
+    getLevel() {
+        return _currentLevel;
+    },
+    info: (message, ...args) => {
+        if (shouldLog('info')) {
+            console.log(chalk.blue('ℹ'), message, ...args);
+        }
+    },
+    success: (message, ...args) => {
+        if (shouldLog('info')) {
+            console.log(chalk.green('✓'), message, ...args);
+        }
+    },
+    warn: (message, ...args) => {
+        if (shouldLog('warn')) {
+            console.log(chalk.yellow('⚠'), message, ...args);
+        }
+    },
+    error: (message, ...args) => {
+        if (shouldLog('error')) {
+            console.log(chalk.red('✗'), message, ...args);
+        }
+    },
+    debug: (message, ...args) => {
+        if (shouldLog('debug') && process.env.DEBUG) {
+            console.log(chalk.gray('🐛'), message, ...args);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,cAAc,GAA6B;IAC/C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,IAAI,aAAa,GAAa,MAAM,CAAC;AAErC,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,aAAa;IACb,QAAQ,CAAC,KAAe;QACtB,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,eAAe;IACf,QAAQ;QACN,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACxC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QAC3C,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACxC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACzC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACzC,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/utils/project.d.ts

@@ -0,0 +1,24 @@
+export interface ProjectInfo {
+    name: string;
+    version: string;
+    hasClaudeDir: boolean;
+    hasSpecifyDir: boolean;
+    hasStoriesDir: boolean;
+}
+/**
+ * 检测当前目录是否是 novel-writer-skills 项目
+ */
+export declare function isProjectRoot(dir: string): Promise<boolean>;
+/**
+ * 向上查找项目根目录
+ */
+export declare function findProjectRoot(startDir?: string): Promise<string | null>;
+/**
+ * 确保在项目根目录，否则抛出错误
+ */
+export declare function ensureProjectRoot(): Promise<string>;
+/**
+ * 获取项目信息
+ */
+export declare function getProjectInfo(projectPath: string): Promise<ProjectInfo | null>;
+//# sourceMappingURL=project.d.ts.map

package/dist/utils/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB9F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQzD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAoBrF"}

package/dist/utils/project.js

@@ -0,0 +1,61 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { DIRS, FILES } from '../core/config.js';
+import { ProjectNotFoundError } from '../core/errors.js';
+/**
+ * 检测当前目录是否是 novel-writer-skills 项目
+ */
+export async function isProjectRoot(dir) {
+    const configPath = path.join(dir, DIRS.SPECIFY, FILES.CONFIG);
+    return await fs.pathExists(configPath);
+}
+/**
+ * 向上查找项目根目录
+ */
+export async function findProjectRoot(startDir = process.cwd()) {
+    let currentDir = startDir;
+    while (true) {
+        if (await isProjectRoot(currentDir)) {
+            return currentDir;
+        }
+        const parentDir = path.dirname(currentDir);
+        // 已到达文件系统根目录
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+/**
+ * 确保在项目根目录，否则抛出错误
+ */
+export async function ensureProjectRoot() {
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot) {
+        throw new ProjectNotFoundError();
+    }
+    return projectRoot;
+}
+/**
+ * 获取项目信息
+ */
+export async function getProjectInfo(projectPath) {
+    try {
+        const configPath = path.join(projectPath, DIRS.SPECIFY, FILES.CONFIG);
+        if (!await fs.pathExists(configPath)) {
+            return null;
+        }
+        const config = await fs.readJson(configPath);
+        return {
+            name: config.name || path.basename(projectPath),
+            version: config.version || 'unknown',
+            hasClaudeDir: await fs.pathExists(path.join(projectPath, DIRS.CLAUDE)),
+            hasSpecifyDir: await fs.pathExists(path.join(projectPath, DIRS.SPECIFY)),
+            hasStoriesDir: await fs.pathExists(path.join(projectPath, DIRS.STORIES)),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/utils/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAUzD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,OAAO,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACpE,IAAI,UAAU,GAAG,QAAQ,CAAC;IAE1B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE3C,aAAa;QACb,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,WAAW,GAAG,MAAM,eAAe,EAAE,CAAC;IAE5C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,oBAAoB,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtE,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE7C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;YACpC,YAAY,EAAE,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACtE,aAAa,EAAE,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,aAAa,EAAE,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare function getVersion(): string;
+export declare function getVersionInfo(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA,wBAAgB,UAAU,IAAI,MAAM,CAWnC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/version.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'fs';
+import path from 'path';
+import { getPackageRoot } from './core/config.js';
+let _cachedVersion = null;
+export function getVersion() {
+    if (_cachedVersion)
+        return _cachedVersion;
+    try {
+        const packagePath = path.join(getPackageRoot(), 'package.json');
+        const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        _cachedVersion = packageJson.version;
+        return _cachedVersion;
+    }
+    catch {
+        return '1.0.0';
+    }
+}
+export function getVersionInfo() {
+    return `v${getVersion()}`;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,IAAI,cAAc,GAAkB,IAAI,CAAC;AAEzC,MAAM,UAAU,UAAU;IACxB,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,cAAc,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC;QACrC,OAAO,cAAe,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,UAAU,EAAE,EAAE,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "novelws",
+  "version": "1.2.0",
+  "type": "module",
+  "description": "Claude Code 专用的 AI 小说创作工具 - 深度集成 Slash Commands 和 Agent Skills",
+  "keywords": [
+    "novel",
+    "writer",
+    "chinese",
+    "ai",
+    "creative-writing",
+    "claude",
+    "claude-code",
+    "agent-skills",
+    "小说",
+    "创作",
+    "写作"
+  ],
+  "author": "Novel Writer Team",
+  "license": "MIT",
+  "main": "dist/cli.js",
+  "bin": {
+    "novelws": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "node -e \"try{require('fs').chmodSync('dist/cli.js',0o755)}catch{}\"",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "clean": "rm -rf dist",
+    "prepare": "npm run build",
+    "test": "jest --config jest.config.cjs",
+    "test:watch": "jest --config jest.config.cjs --watch",
+    "test:coverage": "jest --config jest.config.cjs --coverage",
+    "test:unit": "jest --config jest.config.cjs tests/unit",
+    "test:integration": "jest --config jest.config.cjs tests/integration"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^12.0.0",
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.12",
+    "js-yaml": "^4.1.0",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.10.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "plugins",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/binlee1990/novel-writer-skills.git"
+  },
+  "homepage": "https://github.com/binlee1990/novel-writer-skills#readme",
+  "bugs": {
+    "url": "https://github.com/binlee1990/novel-writer-skills/issues"
+  }
+}

package/plugins/authentic-voice/README.md

@@ -0,0 +1,31 @@
+# Authentic Voice 插件
+
+让文字更像你自己写的：强调生活细节、口语节奏与个体词库的一致性。该插件聚焦“提升原创度与自然度”，不涉及也不用于任何检测规避场景
+
+## 安装
+
+```
+novel plugins add authentic-voice
+```
+
+## 准备个人语料
+
+在 `.specify/memory/personal-voice.md` 中补全：
+- 口头禅与常用表达
+- 固定句式与节奏偏好
+- 生活经历清单与行业/地域词汇
+- 写作忌口与避讳
+- 比喻口味与意象库
+
+## 常用命令
+
+- `/authentic-voice` 启动真实人声写作，自动读取个人语料并在输出前给出“取材卡”
+- `/authenticity-audit` 对既有文本做人味自查与改写建议
+- `/expert authentic-editor` 召唤真实人声编辑专家，进行更细致的行级改写
+
+## 适用场景
+
+- 正稿创作：需要稳态的个人风格与节奏
+- 二次打磨：避免空话、模板化与节奏单一
+- 长线项目：逐步沉淀个人词库与意象，形成稳定“作者指纹”
+

package/plugins/authentic-voice/commands/authentic-voice.md

@@ -0,0 +1,73 @@
+---
+title: 真实人声写作模式 - /authentic-voice
+description: 以更贴近生活与个人表达的方式进行创作，强调具体细节、口语节奏与个体词汇
+---
+
+# 真实人声写作模式
+
+目标：基于作者的生活经验与个人用语，输出自然、有细节、有温度的文字；避免模板化句式与空泛表达，保持叙述的节奏变化与真实思考过程
+
+## 使用方法
+
+```
+/authentic-voice [可选参数]
+```
+
+- `--tone <自由/克制/热烈/冷静>` 设定整体语气偏好，默认自由
+- `--pace <慢/适中/快>` 控制叙述节奏，默认适中
+- `--persona <file>` 指定个人语料文件，默认读取 `.specify/memory/personal-voice.md`
+
+## 输入准备
+
+- 若存在 `.specify/memory/personal-voice.md`，在创作前读取该文件的要点：
+  - 口头禅与常用表达
+  - 固定句式与偏好节奏
+  - 生活经历清单与行业/地域词汇
+  - 写作忌口与避讳
+  - 比喻口味与意象库
+
+如果文件为空或缺失，以当前对话中提供的个人信息为准，并在输出开头提示需要完善个人语料
+
+## 写作要则
+
+请按以下方式组织创作：
+
+- 具体细节优先：尽量用可感知的场景与动作替代抽象总结
+- 节奏有起伏：段落长短交替，长段推进，短句落锤
+- 真实思路：允许小范围犹疑、转折与补充，而不是一口气给出完美结构
+- 口语混搭：语气词与书面语并存，但不要过度修饰
+- 个体词库：自然使用作者在 personal-voice.md 中记录的用语与意象
+- 避免空话：少用“众所周知、在某种程度、某种意义”这类虚化表达
+
+## 结构建议（可弹性使用）
+
+### 开头
+- 由具体画面/细节入手，不讲大道理，先把人和事摆出来
+
+### 展开
+- 以“一个细节→一个联想→一个判断”的节拍推进，可在熟悉话题里加入个人角度
+
+### 深入
+- 说出自己真实的矛盾与拿不准之处，再给出现阶段可行的做法或更谨慎的表述
+
+### 收束
+- 回到生活层面的落点，用一句朴素的话作结，留一点余味
+
+## 语言提示
+
+- 混用长短句，口语为骨，书面为皮
+- 对话尽量自然，保留个体口头禅，但避免滥用
+- 少用模板连接词；根据语义自然转折
+- 允许小瑕疵，但避免语义不清
+
+## 输出要求
+
+- 先给出一小段“写作取材卡”，用 3-6 行列出：将要使用的个人词汇、生活细节与意象
+- 之后输出正文，不插入执行过程解释
+
+## 若用户提供标题或主题
+
+当收到 `标题：...` 或明确主题时：
+- 用“标题拆解→生活联想→叙述落点”三步在内部完成构思，再按上文要则直接写正文
+- 若无个人语料，先尝试向用户询问一到两个能落地的小细节
+

package/plugins/authentic-voice/commands/authenticity-audit.md

@@ -0,0 +1,37 @@
+---
+title: 人味自查与改写 - /authenticity-audit
+description: 对现有文本做“人味”体检，给出可执行的微调与改写建议，提升自然度与个体风格一致性
+---
+
+# 人味自查与改写
+
+目标：帮助作者发现文本中的模板化痕迹、空话与节奏单一的问题，并提供面向行/段落的微调建议。强调“更像你写的”，而非追求任何形式的检测规避
+
+## 使用方法
+
+```
+/authenticity-audit
+
+[粘贴需要检查的文本]
+```
+
+## 检查维度（给出计数与示例）
+
+若存在 `spec/knowledge/audit-config.json`，以其中的连接词、空话清单、句长阈值为准；否则使用内置默认规则
+
+- 模板连接词密度：如“首先、其次、再者、总而言之”等的出现次数与替换建议
+- 空泛表达：如“在某种程度、众所周知、众多领域”等，给出更具体的改写
+- 句长方差：统计平均句长与方差，标记“连续长句”或“连续短句”的片段，并给出节奏打断/合并建议
+- 陈词滥调：识别可替换的套话，提供两到三种更贴近内容的改写版本
+- 抽象过载：提示哪些段落抽象名词密度过高，并建议补充可感知的细节
+- 人设一致性：对比 `.specify/memory/personal-voice.md` 中的口头禅/词汇，标记缺失的“个体信号”并建议自然融入点
+
+## 改写输出
+
+- 分段输出：原句 → 问题简述 → 微调版 → 更大胆的个人化版本
+- 控制幅度：优先微调，尽量保留原意；仅在必要时提供更大幅度的改写
+- 体例保持：不改变原文的文体与叙述角度，除非用户明确请求
+
+## 末尾建议卡片
+
+- 给出 5-8 条“下次写作时可直接使用”的个体化提示，来源于本次文本暴露的问题

package/plugins/authentic-voice/config.yaml

@@ -0,0 +1,30 @@
+name: authentic-voice
+version: 1.0.0
+description: 真实人声写作插件——提升原创度、生活质感与个体声音一致性
+type: feature
+author: Novel Writer Community
+commands:
+  - id: authentic-voice
+    file: commands/authentic-voice.md
+    description: 启动真实人声写作模式（基于个人语料与生活细节）
+  - id: authenticity-audit
+    file: commands/authenticity-audit.md
+    description: 对现有文本进行“人味”自查与改写建议
+experts:
+  - id: authentic-editor
+    file: experts/authentic-editor.md
+    title: 真实人声编辑
+    description: 擅长将文本改写为更自然、更具生活细节的表达
+dependencies:
+  core: ">=0.5.0"
+installation:
+  message: |
+    ✅ 真实人声写作插件安装成功
+
+    用法建议：
+    1. 在 .specify/memory/personal-voice.md 中填写你的口头禅、常用句式、生活经历与行业词汇
+    2. 在 AI 助手中使用 /authentic-voice 进入真实人声写作模式
+    3. 对既有文本运行 /authenticity-audit 获取自查清单与修改建议
+
+    目标：提升原创度、生活质感和你的个人表达一致性，帮助构建可信的人设与稳定文风
+

package/plugins/authentic-voice/experts/authentic-editor.md

@@ -0,0 +1,27 @@
+---
+title: 真实人声编辑 - expert:authentic-editor
+description: 将作者文本改得更自然、更具生活细节与个人表达一致性
+---
+
+作为“真实人声编辑”，你的职责是：
+
+- 尊重作者意图与叙述视角，优先做微调
+- 在不改变事实与逻辑的前提下，提高具体度与画面感
+- 维持段落节奏的起伏，避免“一股脑儿”地规整
+- 自然地融入个人语料中的词汇与口头禅
+- 用可执行的行级建议帮助作者迭代
+
+工作流程：
+
+1. 读取 `.specify/memory/personal-voice.md`（如果存在）
+2. 对全文做一次“人味自查”，标记问题集中区
+3. 分段提出最小可行改动（保持原意）
+4. 对关键段落额外给出一个“更大胆”的改写版本供参考
+
+输出格式：
+
+- 问题清单（带计数与示例）
+- 行/段落级微调建议
+- 关键段落改写对照
+- 下一次写作提醒清单（5-8条）
+