claude-pangu 1.7.2 → 1.7.3

package/dist/lib/error-handler.d.ts

@@ -1,11 +1,35 @@
 /**
  * 错误处理模块
- * 提供错误信息转换、日志记录等功能
+ * 提供错误信息转换、日志记录、恢复建议等功能
  */
+export interface ErrorContext {
+    operation: string;
+    filePath?: string;
+    additionalInfo?: Record<string, unknown>;
+}
+export interface RecoverySuggestion {
+    action: string;
+    command?: string;
+    description: string;
+}
+export interface EnhancedError {
+    message: string;
+    code?: string;
+    suggestions: RecoverySuggestion[];
+    helpUrl?: string;
+}
 /**
  * 将系统错误码转换为用户友好的错误信息
  */
 export declare function getUserFriendlyError(err: NodeJS.ErrnoException, filePath: string): string;
+/**
+ * 获取带恢复建议的增强错误信息
+ */
+export declare function getEnhancedError(err: NodeJS.ErrnoException, context: ErrorContext): EnhancedError;
+/**
+ * 格式化增强错误信息为可打印字符串
+ */
+export declare function formatEnhancedError(error: EnhancedError): string;
 /**
  * 脱敏处理堆栈跟踪中的敏感路径信息
  */

package/dist/lib/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBzF;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAyBlD"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoEzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,aAAa,CA8EjG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAyBhE;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAyBlD"}

package/dist/lib/error-handler.js

@@ -1,32 +1,181 @@
 /**
  * 错误处理模块
- * 提供错误信息转换、日志记录等功能
+ * 提供错误信息转换、日志记录、恢复建议等功能
  */
 import * as fs from 'fs';
 import * as os from 'os';
 import { LOG_DIR, ERROR_LOG_PATH, VERSION, GITHUB_ISSUES_URL } from './constants.js';
+// ==================== 检测语言环境 ====================
+const isChineseLocale = () => {
+    return (process.env.LANG || process.env.LC_ALL || '').toLowerCase().includes('zh');
+};
 // ==================== 错误信息转换 ====================
 /**
  * 将系统错误码转换为用户友好的错误信息
  */
 export function getUserFriendlyError(err, filePath) {
+    const isChinese = isChineseLocale();
     const errorMessages = {
-        'ENOENT': `文件或目录不存在: ${filePath}\n  请检查路径是否正确`,
-        'EACCES': `权限不足: ${filePath}\n  请尝试以管理员身份运行，或检查文件权限`,
-        'EPERM': `操作被拒绝: ${filePath}\n  可能被其他程序占用，请关闭相关程序后重试`,
-        'ENOSPC': `磁盘空间不足\n  请清理磁盘空间后重试`,
-        'EBUSY': `资源正忙: ${filePath}\n  文件可能正在被其他程序使用`,
-        'EMFILE': `打开文件过多\n  请关闭一些应用程序后重试`,
-        'EEXIST': `文件已存在: ${filePath}\n  请先删除或重命名现有文件`,
-        'EISDIR': `目标是目录而非文件: ${filePath}`,
-        'ENOTDIR': `目标不是目录: ${filePath}`,
-        'ENOTEMPTY': `目录不为空: ${filePath}\n  请先清空目录内容`,
+        'ENOENT': {
+            zh: `文件或目录不存在: ${filePath}\n  请检查路径是否正确`,
+            en: `File or directory not found: ${filePath}\n  Please check if the path is correct`
+        },
+        'EACCES': {
+            zh: `权限不足: ${filePath}\n  请尝试以管理员身份运行，或检查文件权限`,
+            en: `Permission denied: ${filePath}\n  Try running as administrator, or check file permissions`
+        },
+        'EPERM': {
+            zh: `操作被拒绝: ${filePath}\n  可能被其他程序占用，请关闭相关程序后重试`,
+            en: `Operation not permitted: ${filePath}\n  May be in use by another program, close it and retry`
+        },
+        'ENOSPC': {
+            zh: `磁盘空间不足\n  请清理磁盘空间后重试`,
+            en: `No space left on device\n  Please free up disk space and retry`
+        },
+        'EBUSY': {
+            zh: `资源正忙: ${filePath}\n  文件可能正在被其他程序使用`,
+            en: `Resource busy: ${filePath}\n  File may be in use by another program`
+        },
+        'EMFILE': {
+            zh: `打开文件过多\n  请关闭一些应用程序后重试`,
+            en: `Too many open files\n  Please close some applications and retry`
+        },
+        'EEXIST': {
+            zh: `文件已存在: ${filePath}\n  请先删除或重命名现有文件`,
+            en: `File already exists: ${filePath}\n  Please delete or rename the existing file`
+        },
+        'EISDIR': {
+            zh: `目标是目录而非文件: ${filePath}`,
+            en: `Target is a directory, not a file: ${filePath}`
+        },
+        'ENOTDIR': {
+            zh: `目标不是目录: ${filePath}`,
+            en: `Target is not a directory: ${filePath}`
+        },
+        'ENOTEMPTY': {
+            zh: `目录不为空: ${filePath}\n  请先清空目录内容`,
+            en: `Directory not empty: ${filePath}\n  Please empty the directory first`
+        },
+        'ECONNREFUSED': {
+            zh: `连接被拒绝\n  请检查网络连接或服务是否运行`,
+            en: `Connection refused\n  Please check network connection or if the service is running`
+        },
+        'ETIMEDOUT': {
+            zh: `连接超时\n  请检查网络连接后重试`,
+            en: `Connection timed out\n  Please check network connection and retry`
+        },
+        'ENOTFOUND': {
+            zh: `无法解析主机名\n  请检查 DNS 设置或网络连接`,
+            en: `Host not found\n  Please check DNS settings or network connection`
+        }
     };
-    const friendlyMessage = errorMessages[err.code || ''];
-    if (friendlyMessage) {
-        return friendlyMessage;
+    const errorInfo = errorMessages[err.code || ''];
+    if (errorInfo) {
+        return isChinese ? errorInfo.zh : errorInfo.en;
+    }
+    const helpMessage = isChinese
+        ? `如需帮助，请访问: ${GITHUB_ISSUES_URL}`
+        : `For help, please visit: ${GITHUB_ISSUES_URL}`;
+    return `${err.message}\n  ${helpMessage}`;
+}
+/**
+ * 获取带恢复建议的增强错误信息
+ */
+export function getEnhancedError(err, context) {
+    const isChinese = isChineseLocale();
+    const suggestions = [];
+    // 根据错误类型添加恢复建议
+    switch (err.code) {
+        case 'ENOENT':
+            suggestions.push({
+                action: isChinese ? '检查路径' : 'Check path',
+                command: context.filePath ? `ls -la "${context.filePath}"` : undefined,
+                description: isChinese ? '确认文件或目录路径是否正确' : 'Verify the file or directory path is correct'
+            });
+            if (context.operation === 'install') {
+                suggestions.push({
+                    action: isChinese ? '重新安装' : 'Reinstall',
+                    command: 'npx claude-pangu install',
+                    description: isChinese ? '尝试重新运行安装命令' : 'Try running the install command again'
+                });
+            }
+            break;
+        case 'EACCES':
+        case 'EPERM':
+            suggestions.push({
+                action: isChinese ? '检查权限' : 'Check permissions',
+                command: context.filePath ? `ls -la "${context.filePath}"` : undefined,
+                description: isChinese ? '查看文件权限设置' : 'View file permission settings'
+            });
+            if (os.platform() !== 'win32') {
+                suggestions.push({
+                    action: isChinese ? '使用 sudo' : 'Use sudo',
+                    command: 'sudo npx claude-pangu install',
+                    description: isChinese ? '以管理员权限运行（谨慎使用）' : 'Run with administrator privileges (use with caution)'
+                });
+            }
+            break;
+        case 'ENOSPC':
+            suggestions.push({
+                action: isChinese ? '清理空间' : 'Free space',
+                command: os.platform() === 'win32' ? 'cleanmgr' : 'df -h',
+                description: isChinese ? '清理磁盘空间后重试' : 'Free up disk space and retry'
+            });
+            break;
+        case 'ECONNREFUSED':
+        case 'ETIMEDOUT':
+        case 'ENOTFOUND':
+            suggestions.push({
+                action: isChinese ? '检查网络' : 'Check network',
+                command: 'ping github.com',
+                description: isChinese ? '确认网络连接正常' : 'Verify network connection is working'
+            });
+            suggestions.push({
+                action: isChinese ? '检查代理' : 'Check proxy',
+                description: isChinese ? '如果使用代理，请确认代理设置正确' : 'If using proxy, verify proxy settings are correct'
+            });
+            break;
+    }
+    // 添加通用建议
+    suggestions.push({
+        action: isChinese ? '查看日志' : 'View logs',
+        command: `cat ${ERROR_LOG_PATH}`,
+        description: isChinese ? '查看详细错误日志' : 'View detailed error logs'
+    });
+    suggestions.push({
+        action: isChinese ? '寻求帮助' : 'Get help',
+        description: isChinese ? '在 GitHub Issues 搜索或提交问题' : 'Search or submit issues on GitHub Issues'
+    });
+    return {
+        message: getUserFriendlyError(err, context.filePath || ''),
+        code: err.code,
+        suggestions,
+        helpUrl: GITHUB_ISSUES_URL
+    };
+}
+/**
+ * 格式化增强错误信息为可打印字符串
+ */
+export function formatEnhancedError(error) {
+    const isChinese = isChineseLocale();
+    const lines = [];
+    lines.push(`\n❌ ${error.message}\n`);
+    if (error.suggestions.length > 0) {
+        lines.push(isChinese ? '💡 建议的解决方案:' : '💡 Suggested Solutions:');
+        lines.push('');
+        error.suggestions.forEach((suggestion, index) => {
+            lines.push(`  ${index + 1}. ${suggestion.action}`);
+            lines.push(`     ${suggestion.description}`);
+            if (suggestion.command) {
+                lines.push(`     $ ${suggestion.command}`);
+            }
+            lines.push('');
+        });
+    }
+    if (error.helpUrl) {
+        lines.push(isChinese ? `📖 更多帮助: ${error.helpUrl}` : `📖 More help: ${error.helpUrl}`);
     }
-    return `${err.message}\n  如需帮助，请访问: ${GITHUB_ISSUES_URL}`;
+    return lines.join('\n');
 }
 // ==================== 脱敏处理 ====================
 /**

package/dist/lib/error-handler.js.map

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

package/dist/lib/hook-loader.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Hook 加载器模块
+ * 实现 Hook 配置的懒加载和缓存机制
+ */
+export interface HookDefinition {
+    type: 'command';
+    command: string;
+    timeout: number;
+    continueOnError: boolean;
+    description: string;
+}
+export interface HooksConfig {
+    hooks: {
+        Stop?: HookDefinition[];
+        UserPromptSubmit?: HookDefinition[];
+        PostToolUse?: HookDefinition[];
+    };
+    disabled_hooks: string[];
+    hook_config: {
+        parallel_execution: boolean;
+        log_enabled: boolean;
+        log_path: string;
+    };
+}
+export interface LoadedHook extends HookDefinition {
+    name: string;
+    event: string;
+    enabled: boolean;
+}
+declare class HookLoader {
+    private cache;
+    private cacheTimestamp;
+    private cacheTTL;
+    private configPath;
+    constructor();
+    /**
+     * 加载 Hooks 配置（带缓存）
+     */
+    loadHooks(): HooksConfig | null;
+    /**
+     * 获取特定事件的 Hooks
+     */
+    getHooksForEvent(event: 'Stop' | 'UserPromptSubmit' | 'PostToolUse'): LoadedHook[];
+    /**
+     * 获取所有启用的 Hooks
+     */
+    getAllEnabledHooks(): LoadedHook[];
+    /**
+     * 获取 Hook 统计信息
+     */
+    getHookStats(): {
+        total: number;
+        enabled: number;
+        disabled: number;
+        byEvent: Record<string, number>;
+    };
+    /**
+     * 检查特定 Hook 是否启用
+     */
+    isHookEnabled(hookName: string): boolean;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+    /**
+     * 设置缓存 TTL
+     */
+    setCacheTTL(ttl: number): void;
+    /**
+     * 检查缓存是否有效
+     */
+    private isCacheValid;
+    /**
+     * 获取配置路径
+     */
+    getConfigPath(): string;
+    /**
+     * 设置配置路径
+     */
+    setConfigPath(configPath: string): void;
+}
+/**
+ * 获取默认 Hook 加载器实例
+ */
+export declare function getHookLoader(): HookLoader;
+/**
+ * 加载 Hooks 配置
+ */
+export declare function loadHooks(): HooksConfig | null;
+/**
+ * 获取特定事件的 Hooks
+ */
+export declare function getHooksForEvent(event: 'Stop' | 'UserPromptSubmit' | 'PostToolUse'): LoadedHook[];
+/**
+ * 获取所有启用的 Hooks
+ */
+export declare function getAllEnabledHooks(): LoadedHook[];
+/**
+ * 检查 Hook 是否启用
+ */
+export declare function isHookEnabled(hookName: string): boolean;
+/**
+ * 获取 Hook 统计信息
+ */
+export declare function getHookStats(): {
+    total: number;
+    enabled: number;
+    disabled: number;
+    byEvent: Record<string, number>;
+};
+export default HookLoader;
+//# sourceMappingURL=hook-loader.d.ts.map

package/dist/lib/hook-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-loader.d.ts","sourceRoot":"","sources":["../../lib/hook-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC;QACxB,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;QACpC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;KAChC,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE;QACX,kBAAkB,EAAE,OAAO,CAAC;QAC5B,WAAW,EAAE,OAAO,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,cAAM,UAAU;IACd,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAS;;IAM3B;;OAEG;IACH,SAAS,IAAI,WAAW,GAAG,IAAI;IA2B/B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,UAAU,EAAE;IAqBlF;;OAEG;IACH,kBAAkB,IAAI,UAAU,EAAE;IAUlC;;OAEG;IACH,YAAY,IAAI;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC;IAwBD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOxC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAIxC;AAMD;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAID;;GAEG;AACH,wBAAgB,SAAS,IAAI,WAAW,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,UAAU,EAAE,CAEjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,YAAY;WA5HjB,MAAM;aACJ,MAAM;cACL,MAAM;aACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;EA2HlC;AAED,eAAe,UAAU,CAAC"}

package/dist/lib/hook-loader.js

@@ -0,0 +1,184 @@
+/**
+ * Hook 加载器模块
+ * 实现 Hook 配置的懒加载和缓存机制
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseJsonc, isJsoncFile } from './jsonc-parser.js';
+// ==================== Hook 加载器实现 ====================
+class HookLoader {
+    constructor() {
+        this.cache = null;
+        this.cacheTimestamp = 0;
+        this.cacheTTL = 30000; // 30秒缓存
+        this.configPath = path.join(process.cwd(), 'hooks', 'hooks.json');
+    }
+    /**
+     * 加载 Hooks 配置（带缓存）
+     */
+    loadHooks() {
+        // 检查缓存是否有效
+        if (this.isCacheValid()) {
+            return this.cache;
+        }
+        try {
+            if (!fs.existsSync(this.configPath)) {
+                console.warn(`Hook 配置文件不存在: ${this.configPath}`);
+                return null;
+            }
+            const content = fs.readFileSync(this.configPath, 'utf8');
+            const config = isJsoncFile(this.configPath)
+                ? parseJsonc(content)
+                : JSON.parse(content);
+            this.cache = config;
+            this.cacheTimestamp = Date.now();
+            return config;
+        }
+        catch (error) {
+            console.error('加载 Hook 配置失败:', error);
+            return null;
+        }
+    }
+    /**
+     * 获取特定事件的 Hooks
+     */
+    getHooksForEvent(event) {
+        const config = this.loadHooks();
+        if (!config)
+            return [];
+        const hooks = config.hooks[event] ?? [];
+        const disabledHooks = config.disabled_hooks ?? [];
+        return hooks.map((hook, index) => {
+            // 从命令中提取 hook 名称
+            const match = hook.command.match(/hooks\/([^.]+)\.sh/);
+            const name = match?.[1] ?? `hook-${index}`;
+            return {
+                ...hook,
+                name,
+                event,
+                enabled: !disabledHooks.includes(name)
+            };
+        }).filter(hook => hook.enabled);
+    }
+    /**
+     * 获取所有启用的 Hooks
+     */
+    getAllEnabledHooks() {
+        const events = [
+            'Stop',
+            'UserPromptSubmit',
+            'PostToolUse'
+        ];
+        return events.flatMap(event => this.getHooksForEvent(event));
+    }
+    /**
+     * 获取 Hook 统计信息
+     */
+    getHookStats() {
+        const config = this.loadHooks();
+        if (!config) {
+            return { total: 0, enabled: 0, disabled: 0, byEvent: {} };
+        }
+        const allHooks = this.getAllEnabledHooks();
+        const disabledCount = config.disabled_hooks?.length ?? 0;
+        const totalCount = allHooks.length + disabledCount;
+        const byEvent = {
+            Stop: this.getHooksForEvent('Stop').length,
+            UserPromptSubmit: this.getHooksForEvent('UserPromptSubmit').length,
+            PostToolUse: this.getHooksForEvent('PostToolUse').length
+        };
+        return {
+            total: totalCount,
+            enabled: allHooks.length,
+            disabled: disabledCount,
+            byEvent
+        };
+    }
+    /**
+     * 检查特定 Hook 是否启用
+     */
+    isHookEnabled(hookName) {
+        const config = this.loadHooks();
+        if (!config)
+            return false;
+        return !config.disabled_hooks?.includes(hookName);
+    }
+    /**
+     * 清除缓存
+     */
+    clearCache() {
+        this.cache = null;
+        this.cacheTimestamp = 0;
+    }
+    /**
+     * 设置缓存 TTL
+     */
+    setCacheTTL(ttl) {
+        this.cacheTTL = ttl;
+    }
+    /**
+     * 检查缓存是否有效
+     */
+    isCacheValid() {
+        if (!this.cache)
+            return false;
+        return Date.now() - this.cacheTimestamp < this.cacheTTL;
+    }
+    /**
+     * 获取配置路径
+     */
+    getConfigPath() {
+        return this.configPath;
+    }
+    /**
+     * 设置配置路径
+     */
+    setConfigPath(configPath) {
+        this.configPath = configPath;
+        this.clearCache();
+    }
+}
+// ==================== 单例实例 ====================
+let defaultLoader = null;
+/**
+ * 获取默认 Hook 加载器实例
+ */
+export function getHookLoader() {
+    if (!defaultLoader) {
+        defaultLoader = new HookLoader();
+    }
+    return defaultLoader;
+}
+// ==================== 便捷函数 ====================
+/**
+ * 加载 Hooks 配置
+ */
+export function loadHooks() {
+    return getHookLoader().loadHooks();
+}
+/**
+ * 获取特定事件的 Hooks
+ */
+export function getHooksForEvent(event) {
+    return getHookLoader().getHooksForEvent(event);
+}
+/**
+ * 获取所有启用的 Hooks
+ */
+export function getAllEnabledHooks() {
+    return getHookLoader().getAllEnabledHooks();
+}
+/**
+ * 检查 Hook 是否启用
+ */
+export function isHookEnabled(hookName) {
+    return getHookLoader().isHookEnabled(hookName);
+}
+/**
+ * 获取 Hook 统计信息
+ */
+export function getHookStats() {
+    return getHookLoader().getHookStats();
+}
+export default HookLoader;
+//# sourceMappingURL=hook-loader.js.map

package/dist/lib/hook-loader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pangu",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture (原名 oh-my-claude)",
   "keywords": [
     "claude-code",

package/scripts/postinstall.cjs

@@ -2,7 +2,7 @@
 
 /**
  * postinstall script for oh-my-claude
- * 在 npm install 后显示安装提示
+ * 在 npm install 后显示安装提示和引导
  */
 
 // ANSI 颜色代码 (CJS 模块不能导入 ESM logger)
@@ -12,21 +12,77 @@ const colors = {
   green: '\x1b[32m',
   yellow: '\x1b[33m',
   red: '\x1b[31m',
-  dim: '\x1b[2m'
+  dim: '\x1b[2m',
+  bold: '\x1b[1m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m'
+};
+
+// 检测语言环境
+const isChineseLocale = (process.env.LANG || process.env.LC_ALL || '').toLowerCase().includes('zh');
+
+// 双语消息
+const messages = {
+  title: isChineseLocale ? '🏔️  oh-my-claude 已下载' : '🏔️  oh-my-claude Downloaded',
+  nextSteps: isChineseLocale ? '📋 下一步操作' : '📋 Next Steps',
+  installPrompt: isChineseLocale ? '请运行以下命令完成安装:' : 'Run the following command to complete installation:',
+  orGlobal: isChineseLocale ? '或者如果你全局安装了:' : 'Or if you installed globally:',
+  quickStart: isChineseLocale ? '🚀 快速开始' : '🚀 Quick Start',
+  afterInstall: isChineseLocale ? '安装完成后，在 Claude Code 中尝试:' : 'After installation, try in Claude Code:',
+  moveMount: isChineseLocale ? '# 愚公移山模式 - 持续执行直到完成' : '# YuGong Mode - Persistent execution until completion',
+  strategy: isChineseLocale ? '# 诸葛顾问 - 架构设计建议' : '# ZhuGe Advisor - Architecture design suggestions',
+  debug: isChineseLocale ? '# 扁鹊诊断 - Bug 分析与修复' : '# BianQue Diagnosis - Bug analysis and fixes',
+  docs: isChineseLocale ? '📖 文档' : '📖 Documentation',
+  docsChinese: 'Chinese: https://github.com/ZDragon17/oh-my-claude#readme',
+  docsEnglish: 'English: https://github.com/ZDragon17/oh-my-claude/blob/main/README_EN.md',
+  features: isChineseLocale ? '✨ 特性' : '✨ Features',
+  feature1: isChineseLocale ? '• 20+ 专业化 Agent（基于中国传统文化人物）' : '• 20+ Specialized Agents (based on Chinese cultural figures)',
+  feature2: isChineseLocale ? '• 愚公移山模式 - 持续执行直到任务完成' : '• YuGong Mode - Persistent execution until task completion',
+  feature3: isChineseLocale ? '• 智能 Hook 系统 - 33+ 内置功能增强' : '• Smart Hook System - 33+ built-in enhancements',
+  feature4: isChineseLocale ? '• 内置 MCP 服务器 - Context7, Grep.app 等' : '• Built-in MCP Servers - Context7, Grep.app, etc.',
+  needHelp: isChineseLocale ? '❓ 需要帮助?' : '❓ Need Help?',
+  issuesLink: 'Issues: https://github.com/ZDragon17/oh-my-claude/issues'
 };
 
 console.log(`
-${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
-${colors.cyan}🏔️  oh-my-claude 已下载${colors.reset}
-${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+${colors.bold}${colors.cyan}${messages.title}${colors.reset}
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
 
-${colors.yellow}请运行以下命令完成安装:${colors.reset}
+${colors.yellow}${colors.bold}${messages.nextSteps}${colors.reset}
+${colors.dim}${messages.installPrompt}${colors.reset}
 
   ${colors.green}npx claude-pangu install${colors.reset}
 
-或者如果你全局安装了:
+${colors.dim}${messages.orGlobal}${colors.reset}
 
   ${colors.green}claude-pangu install${colors.reset}
 
-${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.magenta}${colors.bold}${messages.quickStart}${colors.reset}
+${colors.dim}${messages.afterInstall}${colors.reset}
+
+  ${colors.blue}/yishan ${colors.dim}${messages.moveMount}${colors.reset}
+  ${colors.blue}/zhuge  ${colors.dim}${messages.strategy}${colors.reset}
+  ${colors.blue}/bianque ${colors.dim}${messages.debug}${colors.reset}
+
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.green}${colors.bold}${messages.features}${colors.reset}
+  ${messages.feature1}
+  ${messages.feature2}
+  ${messages.feature3}
+  ${messages.feature4}
+
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.blue}${colors.bold}${messages.docs}${colors.reset}
+  ${messages.docsChinese}
+  ${messages.docsEnglish}
+
+${colors.yellow}${colors.bold}${messages.needHelp}${colors.reset}
+  ${messages.issuesLink}
+
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
 `);