@yivan-lab/pretty-please 1.1.0 → 1.3.0

package/dist/src/shell-hook.js

@@ -4,8 +4,19 @@ import os from 'os';
 import chalk from 'chalk';
 import { CONFIG_DIR, getConfig, setConfigValue } from './config.js';
 import { getHistory } from './history.js';
+import { getCurrentTheme } from './ui/theme.js';
+// 获取主题颜色
+function getColors() {
+    const theme = getCurrentTheme();
+    return {
+        primary: theme.primary,
+        success: theme.success,
+        error: theme.error,
+        warning: theme.warning,
+        secondary: theme.secondary,
+    };
+}
 const SHELL_HISTORY_FILE = path.join(CONFIG_DIR, 'shell_history.jsonl');
-const MAX_SHELL_HISTORY = 20;
 // Hook 标记，用于识别我们添加的内容
 const HOOK_START_MARKER = '# >>> pretty-please shell hook >>>';
 const HOOK_END_MARKER = '# <<< pretty-please shell hook <<<';
@@ -48,6 +59,8 @@ export function getShellConfigPath(shellType) {
  * 生成 zsh hook 脚本
  */
 function generateZshHook() {
+    const config = getConfig();
+    const limit = config.shellHistoryLimit || 10; // 从配置读取
     return `
 ${HOOK_START_MARKER}
 # 记录命令到 pretty-please 历史
@@ -64,8 +77,8 @@ __pls_precmd() {
     # 转义命令中的特殊字符
     local escaped_cmd=$(echo "$__PLS_LAST_CMD" | sed 's/\\\\/\\\\\\\\/g; s/"/\\\\"/g')
     echo "{\\"cmd\\":\\"$escaped_cmd\\",\\"exit\\":$exit_code,\\"time\\":\\"$timestamp\\"}" >> "${CONFIG_DIR}/shell_history.jsonl"
-    # 保持文件不超过 ${MAX_SHELL_HISTORY} 行
-    tail -n ${MAX_SHELL_HISTORY} "${CONFIG_DIR}/shell_history.jsonl" > "${CONFIG_DIR}/shell_history.jsonl.tmp" && mv "${CONFIG_DIR}/shell_history.jsonl.tmp" "${CONFIG_DIR}/shell_history.jsonl"
+    # 保持文件不超过 ${limit} 行（从配置读取）
+    tail -n ${limit} "${CONFIG_DIR}/shell_history.jsonl" > "${CONFIG_DIR}/shell_history.jsonl.tmp" && mv "${CONFIG_DIR}/shell_history.jsonl.tmp" "${CONFIG_DIR}/shell_history.jsonl"
     unset __PLS_LAST_CMD
   fi
 }
@@ -80,6 +93,8 @@ ${HOOK_END_MARKER}
  * 生成 bash hook 脚本
  */
 function generateBashHook() {
+    const config = getConfig();
+    const limit = config.shellHistoryLimit || 10; // 从配置读取
     return `
 ${HOOK_START_MARKER}
 # 记录命令到 pretty-please 历史
@@ -91,7 +106,7 @@ __pls_prompt_command() {
     local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
     local escaped_cmd=$(echo "$last_cmd" | sed 's/\\\\/\\\\\\\\/g; s/"/\\\\"/g')
     echo "{\\"cmd\\":\\"$escaped_cmd\\",\\"exit\\":$exit_code,\\"time\\":\\"$timestamp\\"}" >> "${CONFIG_DIR}/shell_history.jsonl"
-    tail -n ${MAX_SHELL_HISTORY} "${CONFIG_DIR}/shell_history.jsonl" > "${CONFIG_DIR}/shell_history.jsonl.tmp" && mv "${CONFIG_DIR}/shell_history.jsonl.tmp" "${CONFIG_DIR}/shell_history.jsonl"
+    tail -n ${limit} "${CONFIG_DIR}/shell_history.jsonl" > "${CONFIG_DIR}/shell_history.jsonl.tmp" && mv "${CONFIG_DIR}/shell_history.jsonl.tmp" "${CONFIG_DIR}/shell_history.jsonl"
   fi
 }
 
@@ -105,6 +120,8 @@ ${HOOK_END_MARKER}
  * 生成 PowerShell hook 脚本
  */
 function generatePowerShellHook() {
+    const config = getConfig();
+    const limit = config.shellHistoryLimit || 10; // 从配置读取
     return `
 ${HOOK_START_MARKER}
 # 记录命令到 pretty-please 历史
@@ -120,8 +137,8 @@ function __Pls_RecordCommand {
         $escapedCmd = $lastCmd -replace '\\\\', '\\\\\\\\' -replace '"', '\\\\"'
         $json = "{\`"cmd\`":\`"$escapedCmd\`",\`"exit\`":$exitCode,\`"time\`":\`"$timestamp\`"}"
         Add-Content -Path "${CONFIG_DIR}/shell_history.jsonl" -Value $json
-        # 保持文件不超过 ${MAX_SHELL_HISTORY} 行
-        $content = Get-Content "${CONFIG_DIR}/shell_history.jsonl" -Tail ${MAX_SHELL_HISTORY}
+        # 保持文件不超过 ${limit} 行（从配置读取）
+        $content = Get-Content "${CONFIG_DIR}/shell_history.jsonl" -Tail ${limit}
         $content | Set-Content "${CONFIG_DIR}/shell_history.jsonl"
     }
 }
@@ -157,20 +174,21 @@ function generateHookScript(shellType) {
 export async function installShellHook() {
     const shellType = detectShell();
     const configPath = getShellConfigPath(shellType);
+    const colors = getColors();
     if (!configPath) {
-        console.log(chalk.red(`❌ 不支持的 shell 类型: ${shellType}`));
+        console.log(chalk.hex(colors.error)(`❌ 不支持的 shell 类型: ${shellType}`));
         return false;
     }
     const hookScript = generateHookScript(shellType);
     if (!hookScript) {
-        console.log(chalk.red(`❌ 无法为 ${shellType} 生成 hook 脚本`));
+        console.log(chalk.hex(colors.error)(`❌ 无法为 ${shellType} 生成 hook 脚本`));
         return false;
     }
     // 检查是否已安装
     if (fs.existsSync(configPath)) {
         const content = fs.readFileSync(configPath, 'utf-8');
         if (content.includes(HOOK_START_MARKER)) {
-            console.log(chalk.yellow('⚠️  Shell hook 已安装，跳过'));
+            console.log(chalk.hex(colors.warning)('⚠️  Shell hook 已安装，跳过'));
             setConfigValue('shellHook', true);
             return true;
         }
@@ -189,9 +207,9 @@ export async function installShellHook() {
     fs.appendFileSync(configPath, hookScript);
     // 更新配置
     setConfigValue('shellHook', true);
-    console.log(chalk.green(`✅ Shell hook 已安装到: ${configPath}`));
-    console.log(chalk.yellow('⚠️  请重启终端或执行以下命令使其生效:'));
-    console.log(chalk.cyan(`   source ${configPath}`));
+    console.log(chalk.hex(colors.success)(`✅ Shell hook 已安装到: ${configPath}`));
+    console.log(chalk.hex(colors.warning)('⚠️  请重启终端或执行以下命令使其生效:'));
+    console.log(chalk.hex(colors.primary)(`   source ${configPath}`));
     return true;
 }
 /**
@@ -200,8 +218,9 @@ export async function installShellHook() {
 export function uninstallShellHook() {
     const shellType = detectShell();
     const configPath = getShellConfigPath(shellType);
+    const colors = getColors();
     if (!configPath || !fs.existsSync(configPath)) {
-        console.log(chalk.yellow('⚠️  未找到 shell 配置文件'));
+        console.log(chalk.hex(colors.warning)('⚠️  未找到 shell 配置文件'));
         setConfigValue('shellHook', false);
         return true;
     }
@@ -210,7 +229,7 @@ export function uninstallShellHook() {
     const startIndex = content.indexOf(HOOK_START_MARKER);
     const endIndex = content.indexOf(HOOK_END_MARKER);
     if (startIndex === -1 || endIndex === -1) {
-        console.log(chalk.yellow('⚠️  未找到已安装的 hook'));
+        console.log(chalk.hex(colors.warning)('⚠️  未找到已安装的 hook'));
         setConfigValue('shellHook', false);
         return true;
     }
@@ -224,8 +243,8 @@ export function uninstallShellHook() {
     if (fs.existsSync(SHELL_HISTORY_FILE)) {
         fs.unlinkSync(SHELL_HISTORY_FILE);
     }
-    console.log(chalk.green('✅ Shell hook 已卸载'));
-    console.log(chalk.yellow('⚠️  请重启终端使其生效'));
+    console.log(chalk.hex(colors.success)('✅ Shell hook 已卸载'));
+    console.log(chalk.hex(colors.warning)('⚠️  请重启终端使其生效'));
     return true;
 }
 /**
@@ -246,7 +265,7 @@ export function getShellHistory() {
             .trim()
             .split('\n')
             .filter((line) => line.trim());
-        return lines
+        const allHistory = lines
             .map((line) => {
             try {
                 return JSON.parse(line);
@@ -256,6 +275,9 @@ export function getShellHistory() {
             }
         })
             .filter((item) => item !== null);
+        // 应用 shellHistoryLimit 限制：只返回最近的 N 条
+        const limit = config.shellHistoryLimit || 15;
+        return allHistory.slice(-limit);
     }
     catch {
         return [];
@@ -361,10 +383,11 @@ export function getHookStatus() {
 export function displayShellHistory() {
     const config = getConfig();
     const history = getShellHistory();
+    const colors = getColors();
     if (!config.shellHook) {
         console.log('');
-        console.log(chalk.yellow('⚠️  Shell Hook 未启用'));
-        console.log(chalk.gray('运行 ') + chalk.cyan('pls hook install') + chalk.gray(' 启用 Shell Hook'));
+        console.log(chalk.hex(colors.warning)('⚠️  Shell Hook 未启用'));
+        console.log(chalk.gray('运行 ') + chalk.hex(colors.primary)('pls hook install') + chalk.gray(' 启用 Shell Hook'));
         console.log('');
         return;
     }
@@ -379,7 +402,7 @@ export function displayShellHistory() {
     console.log(chalk.gray('━'.repeat(50)));
     history.forEach((item, index) => {
         const num = index + 1;
-        const status = item.exit === 0 ? chalk.green('✓') : chalk.red(`✗ (${item.exit})`);
+        const status = item.exit === 0 ? chalk.hex(colors.success)('✓') : chalk.hex(colors.error)(`✗ (${item.exit})`);
         // 检查是否是 pls 命令
         const isPls = item.cmd.startsWith('pls ') || item.cmd.startsWith('please ');
         if (isPls) {
@@ -389,20 +412,20 @@ export function displayShellHistory() {
             if (plsRecord && plsRecord.executed) {
                 // 检查用户是否修改了命令
                 if (plsRecord.userModified && plsRecord.aiGeneratedCommand) {
-                    console.log(`  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${chalk.magenta('[pls]')} "${args}"`);
+                    console.log(`  ${chalk.hex(colors.primary)(num.toString().padStart(2, ' '))}. ${chalk.hex(colors.secondary)('[pls]')} "${args}"`);
                     console.log(`     ${chalk.dim('AI 生成:')} ${chalk.gray(plsRecord.aiGeneratedCommand)}`);
-                    console.log(`     ${chalk.dim('用户修改为:')} ${plsRecord.command} ${status} ${chalk.yellow('(已修改)')}`);
+                    console.log(`     ${chalk.dim('用户修改为:')} ${plsRecord.command} ${status} ${chalk.hex(colors.warning)('(已修改)')}`);
                 }
                 else {
-                    console.log(`  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${chalk.magenta('[pls]')} "${args}" → ${plsRecord.command} ${status}`);
+                    console.log(`  ${chalk.hex(colors.primary)(num.toString().padStart(2, ' '))}. ${chalk.hex(colors.secondary)('[pls]')} "${args}" → ${plsRecord.command} ${status}`);
                 }
             }
             else {
-                console.log(`  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${chalk.magenta('[pls]')} ${args} ${status}`);
+                console.log(`  ${chalk.hex(colors.primary)(num.toString().padStart(2, ' '))}. ${chalk.hex(colors.secondary)('[pls]')} ${args} ${status}`);
             }
         }
         else {
-            console.log(`  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${item.cmd} ${status}`);
+            console.log(`  ${chalk.hex(colors.primary)(num.toString().padStart(2, ' '))}. ${item.cmd} ${status}`);
         }
     });
     console.log(chalk.gray('━'.repeat(50)));
@@ -410,6 +433,40 @@ export function displayShellHistory() {
     console.log(chalk.gray(`文件: ${SHELL_HISTORY_FILE}`));
     console.log('');
 }
+/**
+ * 当 shellHistoryLimit 变化时，自动重装 Hook
+ * 返回是否成功重装
+ */
+export async function reinstallHookForLimitChange(oldLimit, newLimit) {
+    const config = getConfig();
+    // 只有在 hook 已启用时才重装
+    if (!config.shellHook) {
+        return false;
+    }
+    // 值没有变化，不需要重装
+    if (oldLimit === newLimit) {
+        return false;
+    }
+    const colors = getColors();
+    console.log('');
+    console.log(chalk.hex(colors.primary)(`检测到 shellHistoryLimit 变化 (${oldLimit} → ${newLimit})`));
+    console.log(chalk.hex(colors.primary)('正在更新 Shell Hook...'));
+    uninstallShellHook();
+    await installShellHook();
+    console.log('');
+    console.log(chalk.hex(colors.warning)('⚠️  请重启终端或运行以下命令使新配置生效:'));
+    const shellType = detectShell();
+    let configFile = '~/.zshrc';
+    if (shellType === 'bash') {
+        configFile = process.platform === 'darwin' ? '~/.bash_profile' : '~/.bashrc';
+    }
+    else if (shellType === 'powershell') {
+        configFile = '~/Documents/PowerShell/Microsoft.PowerShell_profile.ps1';
+    }
+    console.log(chalk.gray(`  source ${configFile}`));
+    console.log('');
+    return true;
+}
 /**
  * 清空 shell 历史
  */
@@ -417,7 +474,219 @@ export function clearShellHistory() {
     if (fs.existsSync(SHELL_HISTORY_FILE)) {
         fs.unlinkSync(SHELL_HISTORY_FILE);
     }
+    const colors = getColors();
     console.log('');
-    console.log(chalk.green('✓ Shell 历史已清空'));
+    console.log(chalk.hex(colors.success)('✓ Shell 历史已清空'));
     console.log('');
 }
+// ================== 远程 Shell Hook ==================
+/**
+ * 生成远程 zsh hook 脚本
+ */
+function generateRemoteZshHook() {
+    const config = getConfig();
+    const limit = config.shellHistoryLimit || 10; // 从配置读取
+    return `
+${HOOK_START_MARKER}
+# 记录命令到 pretty-please 历史
+__pls_preexec() {
+  __PLS_LAST_CMD="$1"
+  __PLS_CMD_START=$(date +%s)
+}
+
+__pls_precmd() {
+  local exit_code=$?
+  if [[ -n "$__PLS_LAST_CMD" ]]; then
+    local end_time=$(date +%s)
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    # 确保目录存在
+    mkdir -p ~/.please
+    # 转义命令中的特殊字符
+    local escaped_cmd=$(echo "$__PLS_LAST_CMD" | sed 's/\\\\/\\\\\\\\/g; s/"/\\\\"/g')
+    echo "{\\"cmd\\":\\"$escaped_cmd\\",\\"exit\\":$exit_code,\\"time\\":\\"$timestamp\\"}" >> ~/.please/shell_history.jsonl
+    # 保持文件不超过 ${limit} 行（从配置读取）
+    tail -n ${limit} ~/.please/shell_history.jsonl > ~/.please/shell_history.jsonl.tmp && mv ~/.please/shell_history.jsonl.tmp ~/.please/shell_history.jsonl
+    unset __PLS_LAST_CMD
+  fi
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec __pls_preexec
+add-zsh-hook precmd __pls_precmd
+${HOOK_END_MARKER}
+`;
+}
+/**
+ * 生成远程 bash hook 脚本
+ */
+function generateRemoteBashHook() {
+    const config = getConfig();
+    const limit = config.shellHistoryLimit || 10; // 从配置读取
+    return `
+${HOOK_START_MARKER}
+# 记录命令到 pretty-please 历史
+__pls_prompt_command() {
+  local exit_code=$?
+  local last_cmd=$(history 1 | sed 's/^ *[0-9]* *//')
+  if [[ -n "$last_cmd" && "$last_cmd" != "$__PLS_LAST_CMD" ]]; then
+    __PLS_LAST_CMD="$last_cmd"
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    # 确保目录存在
+    mkdir -p ~/.please
+    local escaped_cmd=$(echo "$last_cmd" | sed 's/\\\\/\\\\\\\\/g; s/"/\\\\"/g')
+    echo "{\\"cmd\\":\\"$escaped_cmd\\",\\"exit\\":$exit_code,\\"time\\":\\"$timestamp\\"}" >> ~/.please/shell_history.jsonl
+    tail -n ${limit} ~/.please/shell_history.jsonl > ~/.please/shell_history.jsonl.tmp && mv ~/.please/shell_history.jsonl.tmp ~/.please/shell_history.jsonl
+  fi
+}
+
+if [[ ! "$PROMPT_COMMAND" =~ __pls_prompt_command ]]; then
+  PROMPT_COMMAND="__pls_prompt_command;\${PROMPT_COMMAND}"
+fi
+${HOOK_END_MARKER}
+`;
+}
+/**
+ * 检测远程服务器的 shell 类型
+ */
+export async function detectRemoteShell(sshExecFn) {
+    try {
+        const result = await sshExecFn('basename "$SHELL"');
+        if (result.exitCode === 0) {
+            const shell = result.stdout.trim();
+            if (shell === 'zsh')
+                return 'zsh';
+            if (shell === 'bash')
+                return 'bash';
+        }
+    }
+    catch {
+        // 忽略错误
+    }
+    return 'bash'; // 默认 bash
+}
+/**
+ * 获取远程 shell 配置文件路径
+ */
+export function getRemoteShellConfigPath(shellType) {
+    switch (shellType) {
+        case 'zsh':
+            return '~/.zshrc';
+        case 'bash':
+            return '~/.bashrc';
+        default:
+            return '~/.bashrc';
+    }
+}
+/**
+ * 生成远程 hook 脚本
+ */
+export function generateRemoteHookScript(shellType) {
+    switch (shellType) {
+        case 'zsh':
+            return generateRemoteZshHook();
+        case 'bash':
+            return generateRemoteBashHook();
+        default:
+            return null;
+    }
+}
+/**
+ * 检查远程 hook 是否已安装
+ */
+export async function checkRemoteHookInstalled(sshExecFn, configPath) {
+    try {
+        const result = await sshExecFn(`grep -q "${HOOK_START_MARKER}" ${configPath} 2>/dev/null && echo "installed" || echo "not_installed"`);
+        return result.stdout.trim() === 'installed';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 在远程服务器安装 shell hook
+ */
+export async function installRemoteShellHook(sshExecFn, shellType) {
+    const colors = getColors();
+    const configPath = getRemoteShellConfigPath(shellType);
+    const hookScript = generateRemoteHookScript(shellType);
+    if (!hookScript) {
+        return { success: false, message: chalk.hex(colors.error)(`不支持的 shell 类型: ${shellType}`) };
+    }
+    // 检查是否已安装
+    const installed = await checkRemoteHookInstalled(sshExecFn, configPath);
+    if (installed) {
+        return { success: true, message: chalk.hex(colors.warning)('Shell hook 已安装，跳过') };
+    }
+    // 备份原配置文件
+    try {
+        await sshExecFn(`cp ${configPath} ${configPath}.pls-backup 2>/dev/null || true`);
+    }
+    catch {
+        // 忽略备份错误
+    }
+    // 安装 hook
+    // 使用 cat 和 heredoc 来追加内容
+    const escapedScript = hookScript.replace(/'/g, "'\"'\"'");
+    const installCmd = `echo '${escapedScript}' >> ${configPath}`;
+    try {
+        const result = await sshExecFn(installCmd);
+        if (result.exitCode !== 0) {
+            return { success: false, message: chalk.hex(colors.error)(`安装失败: ${result.stdout}`) };
+        }
+        // 确保 ~/.please 目录存在
+        await sshExecFn('mkdir -p ~/.please');
+        return {
+            success: true,
+            message: chalk.hex(colors.success)(`Shell hook 已安装到 ${configPath}`),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { success: false, message: chalk.hex(colors.error)(`安装失败: ${message}`) };
+    }
+}
+/**
+ * 从远程服务器卸载 shell hook
+ */
+export async function uninstallRemoteShellHook(sshExecFn, shellType) {
+    const colors = getColors();
+    const configPath = getRemoteShellConfigPath(shellType);
+    // 检查是否已安装
+    const installed = await checkRemoteHookInstalled(sshExecFn, configPath);
+    if (!installed) {
+        return { success: true, message: chalk.hex(colors.warning)('Shell hook 未安装，跳过') };
+    }
+    // 使用 sed 删除 hook 代码块
+    // 注意：需要处理特殊字符
+    const startMarkerEscaped = HOOK_START_MARKER.replace(/[[\]]/g, '\\$&');
+    const endMarkerEscaped = HOOK_END_MARKER.replace(/[[\]]/g, '\\$&');
+    // 在 macOS 和 Linux 上 sed -i 行为不同，使用 sed + 临时文件
+    const uninstallCmd = `
+sed '/${startMarkerEscaped}/,/${endMarkerEscaped}/d' ${configPath} > ${configPath}.tmp && mv ${configPath}.tmp ${configPath}
+`;
+    try {
+        const result = await sshExecFn(uninstallCmd);
+        if (result.exitCode !== 0) {
+            return { success: false, message: chalk.hex(colors.error)(`卸载失败: ${result.stdout}`) };
+        }
+        return {
+            success: true,
+            message: chalk.hex(colors.success)('Shell hook 已卸载'),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { success: false, message: chalk.hex(colors.error)(`卸载失败: ${message}`) };
+    }
+}
+/**
+ * 获取远程 hook 状态
+ */
+export async function getRemoteHookStatus(sshExecFn) {
+    // 检测 shell 类型
+    const shellType = await detectRemoteShell(sshExecFn);
+    const configPath = getRemoteShellConfigPath(shellType);
+    // 检查是否已安装
+    const installed = await checkRemoteHookInstalled(sshExecFn, configPath);
+    return { installed, shellType, configPath };
+}

package/dist/src/ui/theme.d.ts

@@ -1,26 +1,63 @@
-export declare const theme: {
-    readonly primary: "#00D9FF";
-    readonly secondary: "#A78BFA";
-    readonly accent: "#F472B6";
-    readonly success: "#10B981";
-    readonly error: "#EF4444";
-    readonly warning: "#F59E0B";
-    readonly info: "#3B82F6";
-    readonly text: {
-        readonly primary: "#E5E7EB";
-        readonly secondary: "#9CA3AF";
-        readonly muted: "#6B7280";
-        readonly dim: "#4B5563";
+export type ThemeName = string;
+export type BuiltinThemeName = 'dark' | 'light' | 'nord' | 'dracula' | 'retro' | 'contrast' | 'monokai';
+export interface Theme {
+    primary: string;
+    secondary: string;
+    accent: string;
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+    text: {
+        primary: string;
+        secondary: string;
+        muted: string;
+        dim: string;
     };
-    readonly border: "#374151";
-    readonly divider: "#1F2937";
-    readonly code: {
-        readonly background: "#1F2937";
-        readonly text: "#E5E7EB";
-        readonly keyword: "#C678DD";
-        readonly string: "#98C379";
-        readonly function: "#61AFEF";
-        readonly comment: "#5C6370";
+    border: string;
+    divider: string;
+    code: {
+        background: string;
+        text: string;
+        keyword: string;
+        string: string;
+        function: string;
+        comment: string;
     };
+}
+export interface ThemeMetadata {
+    name: ThemeName;
+    displayName: string;
+    description: string;
+    category: 'dark' | 'light';
+    previewColor: string;
+    author?: string;
+}
+export interface ThemeDefinition {
+    metadata: ThemeMetadata;
+    colors: Theme;
+}
+export declare const themeDefinitions: Record<ThemeName, ThemeDefinition>;
+export declare const themes: Record<ThemeName, Theme>;
+export declare function getCurrentTheme(): Theme;
+export declare function getThemeMetadata(name: ThemeName): ThemeMetadata | undefined;
+export declare function getAllThemeMetadata(): ThemeMetadata[];
+export declare function getThemeDefinition(name: ThemeName): ThemeDefinition | undefined;
+export declare function isValidTheme(name: string): name is ThemeName;
+export declare function isBuiltinTheme(name: string): boolean;
+/**
+ * 验证主题格式是否正确
+ */
+export declare function validateTheme(theme: any): theme is ThemeDefinition;
+/**
+ * 获取主题验证的详细错误信息
+ */
+export declare function validateThemeWithDetails(theme: any): {
+    valid: boolean;
+    errors: string[];
 };
-export type Theme = typeof theme;
+/**
+ * 创建主题模板
+ */
+export declare function createThemeTemplate(name: string, displayName: string, category: 'dark' | 'light'): ThemeDefinition;
+export declare const theme: Theme;