@yivan-lab/pretty-please 1.4.0 → 1.5.1

package/dist/src/shell-hook.js

@@ -5,6 +5,7 @@ import chalk from 'chalk';
 import { CONFIG_DIR, getConfig, setConfigValue } from './config.js';
 import { getHistory } from './history.js';
 import { getCurrentTheme } from './ui/theme.js';
+import { detectShell as platformDetectShell, } from './utils/platform.js';
 // 获取主题颜色
 function getColors() {
     const theme = getCurrentTheme();
@@ -20,19 +21,36 @@ const SHELL_HISTORY_FILE = path.join(CONFIG_DIR, 'shell_history.jsonl');
 // Hook 标记，用于识别我们添加的内容
 const HOOK_START_MARKER = '# >>> pretty-please shell hook >>>';
 const HOOK_END_MARKER = '# <<< pretty-please shell hook <<<';
+/**
+ * 将 platform 模块的 ShellType 转换为本地 ShellType
+ */
+function toLocalShellType(platformShell) {
+    switch (platformShell) {
+        case 'zsh':
+            return 'zsh';
+        case 'bash':
+            return 'bash';
+        case 'powershell5':
+        case 'powershell7':
+            return 'powershell';
+        case 'cmd':
+        case 'fish':
+        case 'unknown':
+        default:
+            return 'unknown';
+    }
+}
 /**
  * 检测当前 shell 类型
+ * 使用 platform 模块进行跨平台检测
  */
 export function detectShell() {
-    const shell = process.env.SHELL || '';
-    if (shell.includes('zsh'))
-        return 'zsh';
-    if (shell.includes('bash'))
-        return 'bash';
-    // Windows PowerShell
-    if (process.platform === 'win32')
-        return 'powershell';
-    return 'unknown';
+    const platformShell = platformDetectShell();
+    // CMD 不支持 Hook，提示用户
+    if (platformShell === 'cmd') {
+        return 'unknown';
+    }
+    return toLocalShellType(platformShell);
 }
 /**
  * 获取 shell 配置文件路径
@@ -55,6 +73,35 @@ export function getShellConfigPath(shellType) {
             return null;
     }
 }
+/**
+ * 生成命令统计的公共 shell 函数
+ * 用于 zsh 和 bash，避免代码重复
+ */
+function generateStatFunction() {
+    return `
+# 统计命令频率（公共函数）
+__pls_record_stat() {
+  local cmd_name="$1"
+  local stats_file="${CONFIG_DIR}/command_stats.txt"
+
+  # 确保文件存在
+  touch "$stats_file"
+
+  # 更新统计（纯 shell 实现，不依赖 jq）
+  if grep -q "^$cmd_name=" "$stats_file" 2>/dev/null; then
+    # 命令已存在，次数 +1
+    local count=$(grep "^$cmd_name=" "$stats_file" | cut -d= -f2)
+    count=$((count + 1))
+    # macOS 和 Linux 的 sed -i 不同，使用临时文件
+    sed "s/^$cmd_name=.*/$cmd_name=$count/" "$stats_file" > "$stats_file.tmp" 2>/dev/null
+    mv "$stats_file.tmp" "$stats_file" 2>/dev/null
+  else
+    # 新命令，追加
+    echo "$cmd_name=1" >> "$stats_file"
+  fi
+}
+`;
+}
 /**
  * 生成 zsh hook 脚本
  */
@@ -64,6 +111,7 @@ function generateZshHook() {
     return `
 ${HOOK_START_MARKER}
 # 记录命令到 pretty-please 历史
+${generateStatFunction()}
 __pls_preexec() {
   __PLS_LAST_CMD="$1"
   __PLS_CMD_START=$(date +%s)
@@ -79,6 +127,11 @@ __pls_precmd() {
     echo "{\\"cmd\\":\\"$escaped_cmd\\",\\"exit\\":$exit_code,\\"time\\":\\"$timestamp\\"}" >> "${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"
+
+    # 统计命令频率
+    local cmd_name=$(echo "$__PLS_LAST_CMD" | awk '{print $1}')
+    __pls_record_stat "$cmd_name"
+
     unset __PLS_LAST_CMD
   fi
 }
@@ -98,6 +151,7 @@ function generateBashHook() {
     return `
 ${HOOK_START_MARKER}
 # 记录命令到 pretty-please 历史
+${generateStatFunction()}
 __pls_prompt_command() {
   local exit_code=$?
   local last_cmd=$(history 1 | sed 's/^ *[0-9]* *//')
@@ -107,6 +161,10 @@ __pls_prompt_command() {
     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 ${limit} "${CONFIG_DIR}/shell_history.jsonl" > "${CONFIG_DIR}/shell_history.jsonl.tmp" && mv "${CONFIG_DIR}/shell_history.jsonl.tmp" "${CONFIG_DIR}/shell_history.jsonl"
+
+    # 统计命令频率
+    local cmd_name=$(echo "$last_cmd" | awk '{print $1}')
+    __pls_record_stat "$cmd_name"
   fi
 }
 
@@ -118,15 +176,26 @@ ${HOOK_END_MARKER}
 }
 /**
  * 生成 PowerShell hook 脚本
+ * 使用 PowerShell 原生路径处理，避免跨平台路径问题
  */
 function generatePowerShellHook() {
     const config = getConfig();
     const limit = config.shellHistoryLimit || 10; // 从配置读取
+    // 使用 PowerShell 原生路径变量，而不是嵌入 Node.js 路径
     return `
 ${HOOK_START_MARKER}
 # 记录命令到 pretty-please 历史
+# 使用 PowerShell 原生路径
+$Global:__PlsDir = Join-Path $env:USERPROFILE ".please"
+$Global:__PlsHistoryFile = Join-Path $Global:__PlsDir "shell_history.jsonl"
+$Global:__PlsStatsFile = Join-Path $Global:__PlsDir "command_stats.txt"
 $Global:__PlsLastCmd = ""
 
+# 确保目录存在
+if (-not (Test-Path $Global:__PlsDir)) {
+    New-Item -Path $Global:__PlsDir -ItemType Directory -Force | Out-Null
+}
+
 function __Pls_RecordCommand {
     $lastCmd = (Get-History -Count 1).CommandLine
     if ($lastCmd -and $lastCmd -ne $Global:__PlsLastCmd) {
@@ -136,10 +205,38 @@ function __Pls_RecordCommand {
         $timestamp = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
         $escapedCmd = $lastCmd -replace '\\\\', '\\\\\\\\' -replace '"', '\\\\"'
         $json = "{\`"cmd\`":\`"$escapedCmd\`",\`"exit\`":$exitCode,\`"time\`":\`"$timestamp\`"}"
-        Add-Content -Path "${CONFIG_DIR}/shell_history.jsonl" -Value $json
+        Add-Content -Path $Global:__PlsHistoryFile -Value $json
         # 保持文件不超过 ${limit} 行（从配置读取）
-        $content = Get-Content "${CONFIG_DIR}/shell_history.jsonl" -Tail ${limit}
-        $content | Set-Content "${CONFIG_DIR}/shell_history.jsonl"
+        $content = Get-Content $Global:__PlsHistoryFile -Tail ${limit} -ErrorAction SilentlyContinue
+        if ($content) {
+            $content | Set-Content $Global:__PlsHistoryFile
+        }
+
+        # 统计命令频率
+        $cmdName = $lastCmd -split ' ' | Select-Object -First 1
+
+        # 确保统计文件存在
+        if (-not (Test-Path $Global:__PlsStatsFile)) {
+            New-Item -Path $Global:__PlsStatsFile -ItemType File -Force | Out-Null
+        }
+
+        # 更新统计
+        $stats = Get-Content $Global:__PlsStatsFile -ErrorAction SilentlyContinue
+        $found = $false
+        $newStats = @()
+        foreach ($line in $stats) {
+            if ($line -match "^$cmdName=(\\d+)$") {
+                $count = [int]$matches[1] + 1
+                $newStats += "$cmdName=$count"
+                $found = $true
+            } else {
+                $newStats += $line
+            }
+        }
+        if (-not $found) {
+            $newStats += "$cmdName=1"
+        }
+        $newStats | Set-Content $Global:__PlsStatsFile
     }
 }
 
@@ -177,6 +274,18 @@ export async function installShellHook() {
     const colors = getColors();
     if (!configPath) {
         console.log(chalk.hex(colors.error)(`❌ 不支持的 shell 类型: ${shellType}`));
+        // CMD 特殊提示
+        if (shellType === 'unknown') {
+            const platformShell = platformDetectShell();
+            if (platformShell === 'cmd') {
+                console.log('');
+                console.log(chalk.hex(colors.warning)('⚠️  CMD 不支持 Shell Hook 功能'));
+                console.log(chalk.hex(colors.secondary)('建议使用 PowerShell 获得完整体验：'));
+                console.log(chalk.hex(colors.secondary)('  1. 按 Win 键搜索 "PowerShell"'));
+                console.log(chalk.hex(colors.secondary)('  2. 在 PowerShell 中运行 pls hook install'));
+                console.log('');
+            }
+        }
         return false;
     }
     const hookScript = generateHookScript(shellType);
@@ -434,39 +543,60 @@ export function displayShellHistory() {
     console.log('');
 }
 /**
- * 当 shellHistoryLimit 变化时，自动重装 Hook
- * 返回是否成功重装
+ * 重新安装 Shell Hook（通用函数）
+ * 用于版本升级、配置变更等场景
+ *
+ * @param options.silent 是否静默模式（不输出日志）
+ * @param options.reason 重装原因（用于日志显示）
+ * @returns 是否成功重装
  */
-export async function reinstallHookForLimitChange(oldLimit, newLimit) {
+export async function reinstallShellHook(options) {
     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...'));
+    const { silent = false, reason } = options || {};
+    if (!silent) {
+        console.log('');
+        if (reason) {
+            console.log(chalk.hex(colors.primary)(reason));
+        }
+        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';
+    if (!silent) {
+        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('');
     }
-    console.log(chalk.gray(`  source ${configFile}`));
-    console.log('');
     return true;
 }
+/**
+ * 当 shellHistoryLimit 变化时，自动重装 Hook
+ * 返回是否成功重装
+ */
+export async function reinstallHookForLimitChange(oldLimit, newLimit) {
+    // 值没有变化，不需要重装
+    if (oldLimit === newLimit) {
+        return false;
+    }
+    return reinstallShellHook({
+        reason: `检测到 shellHistoryLimit 变化 (${oldLimit} → ${newLimit})`,
+    });
+}
 /**
  * 清空 shell 历史
  */

package/dist/src/sysinfo.d.ts

@@ -1,19 +1,48 @@
+import { type ProjectContext } from './project-context.js';
 /**
- * 系统信息
+ * 静态系统信息（缓存 7 天）
  */
-export interface SystemInfo {
-    os: NodeJS.Platform;
+export interface StaticSystemInfo {
+    os: string;
     arch: string;
     shell: string;
-    packageManager: string;
-    cwd: string;
     user: string;
+    systemPackageManager: string;
+    availableCommands: string[];
+}
+/**
+ * 动态系统信息（每次实时获取）
+ */
+export interface DynamicSystemInfo {
+    cwd: string;
+    project: ProjectContext | null;
+}
+/**
+ * 完整系统信息
+ */
+export interface SystemInfo extends StaticSystemInfo, DynamicSystemInfo {
 }
 /**
- * 收集系统信息
+ * 获取静态系统信息（带缓存）
+ */
+export declare function getStaticSystemInfo(): StaticSystemInfo;
+/**
+ * 获取动态系统信息（每次实时）
+ */
+export declare function getDynamicSystemInfo(): Promise<DynamicSystemInfo>;
+/**
+ * 获取完整系统信息（主接口）
+ */
+export declare function getSystemInfo(): Promise<SystemInfo>;
+/**
+ * 格式化系统信息为字符串（供 AI 使用）
+ */
+export declare function formatSystemInfo(info: SystemInfo): string;
+/**
+ * 显示系统信息（CLI 美化版）
  */
-export declare function collectSystemInfo(): SystemInfo;
+export declare function displaySystemInfo(info: SystemInfo): void;
 /**
- * 将系统信息格式化为字符串（供 AI 使用）
+ * 强制刷新缓存
  */
-export declare function formatSystemInfo(): string;
+export declare function refreshSystemCache(): void;

package/dist/src/sysinfo.js

@@ -1,10 +1,66 @@
 import os from 'os';
-import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { detectProjectContext, formatProjectContext } from './project-context.js';
+import { getConfig, CONFIG_DIR } from './config.js';
+import { getCurrentTheme } from './ui/theme.js';
+import { detectShell, getShellCapabilities, commandExists, batchCommandExists, isWindows, } from './utils/platform.js';
 /**
- * 检测包管理器
+ * 要检测的命令列表（45 个）
+ */
+const COMMANDS_TO_CHECK = {
+    // 现代 CLI 工具（ls/find/grep/cat 等的替代品）
+    modern: [
+        'eza', 'lsd', 'exa', // ls 替代
+        'fd', 'fdfind', // find 替代
+        'rg', 'ag', 'ack', // grep 替代
+        'bat', 'batcat', // cat 替代
+        'fzf', 'skim', // 模糊搜索
+        'jq', 'yq', 'fx', // JSON/YAML 处理
+        'delta', 'diff-so-fancy', // diff 替代
+        'zoxide', 'z', 'autojump', // cd 替代
+        'tldr', 'tealdeer', // man 替代
+        'dust', 'duf', 'ncdu', // du 替代
+        'procs', 'bottom', 'htop', // ps/top 替代
+        'sd', // sed 替代
+        'hyperfine', // benchmark
+    ],
+    // 包管理器
+    node: ['pnpm', 'yarn', 'bun', 'npm'],
+    python: ['uv', 'rye', 'poetry', 'pipenv', 'pip'],
+    rust: ['cargo'],
+    go: ['go'],
+    ruby: ['gem', 'bundle'],
+    php: ['composer'],
+    // 容器/云工具
+    container: ['docker', 'podman', 'nerdctl'],
+    k8s: ['kubectl', 'k9s', 'helm'],
+    // 版本控制
+    vcs: ['git', 'gh', 'glab', 'hg'],
+    // 构建工具
+    build: ['make', 'cmake', 'ninja', 'just', 'task'],
+    // 其他常用工具
+    misc: ['curl', 'wget', 'aria2c', 'rsync', 'ssh', 'tmux', 'screen'],
+};
+// 缓存文件路径
+const CACHE_FILE = path.join(CONFIG_DIR, 'system_cache.json');
+/**
+ * 检测系统包管理器
  */
 function detectPackageManager() {
-    const managers = [
+    // Windows 包管理器
+    if (isWindows()) {
+        const windowsManagers = ['winget', 'scoop', 'choco'];
+        for (const mgr of windowsManagers) {
+            if (commandExists(mgr)) {
+                return mgr;
+            }
+        }
+        return 'unknown';
+    }
+    // Unix 包管理器
+    const unixManagers = [
         { name: 'brew', command: 'brew' },
         { name: 'apt', command: 'apt-get' },
         { name: 'dnf', command: 'dnf' },
@@ -13,40 +69,208 @@ function detectPackageManager() {
         { name: 'zypper', command: 'zypper' },
         { name: 'apk', command: 'apk' },
     ];
-    for (const mgr of managers) {
-        try {
-            execSync(`which ${mgr.command}`, { stdio: 'ignore' });
+    for (const mgr of unixManagers) {
+        if (commandExists(mgr.command)) {
             return mgr.name;
         }
-        catch {
-            // 继续检测下一个
-        }
     }
     return 'unknown';
 }
 /**
- * 获取当前 Shell
+ * 检测可用命令（跨平台版本）
+ * 使用 platform 模块的 batchCommandExists 函数
  */
-function getCurrentShell() {
-    return process.env.SHELL || 'unknown';
+function detectAvailableCommands() {
+    const allCommands = Object.values(COMMANDS_TO_CHECK).flat();
+    return batchCommandExists(allCommands);
 }
 /**
- * 收集系统信息
+ * 检测所有静态信息（纯同步，不需要 async）
  */
-export function collectSystemInfo() {
+function detectStaticInfo() {
+    // 使用 platform 模块检测 Shell
+    const shell = detectShell();
+    const capabilities = getShellCapabilities(shell);
     return {
         os: os.platform(),
         arch: os.arch(),
-        shell: getCurrentShell(),
-        packageManager: detectPackageManager(),
-        cwd: process.cwd(),
+        shell: capabilities.displayName,
         user: os.userInfo().username,
+        systemPackageManager: detectPackageManager(),
+        availableCommands: detectAvailableCommands(),
+    };
+}
+/**
+ * 获取静态系统信息（带缓存）
+ */
+export function getStaticSystemInfo() {
+    const config = getConfig();
+    // 确保配置目录存在
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    if (fs.existsSync(CACHE_FILE)) {
+        try {
+            const cache = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf-8'));
+            // 缓存未过期
+            const expireDays = config.systemCacheExpireDays || 7;
+            const age = Date.now() - new Date(cache.cachedAt).getTime();
+            if (age < expireDays * 24 * 60 * 60 * 1000) {
+                return cache.static;
+            }
+        }
+        catch {
+            // 缓存文件损坏，重新检测
+        }
+    }
+    // 首次或过期，重新检测
+    const info = detectStaticInfo();
+    // 保存缓存
+    const cache = {
+        version: 1,
+        cachedAt: new Date().toISOString(),
+        expiresInDays: config.systemCacheExpireDays || 7,
+        static: info,
+    };
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
+    return info;
+}
+/**
+ * 获取动态系统信息（每次实时）
+ */
+export async function getDynamicSystemInfo() {
+    return {
+        cwd: process.cwd(),
+        project: await detectProjectContext(process.cwd()),
+    };
+}
+/**
+ * 获取完整系统信息（主接口）
+ */
+export async function getSystemInfo() {
+    return {
+        ...getStaticSystemInfo(),
+        ...(await getDynamicSystemInfo()),
     };
 }
 /**
- * 将系统信息格式化为字符串（供 AI 使用）
+ * 辅助函数：分类命令
  */
-export function formatSystemInfo() {
-    const info = collectSystemInfo();
-    return `OS: ${info.os}, Arch: ${info.arch}, Shell: ${info.shell}, PkgMgr: ${info.packageManager}, CWD: ${info.cwd}`;
+function categorizeCommands(commands) {
+    const modern = ['eza', 'lsd', 'exa', 'fd', 'fdfind', 'rg', 'ag', 'ack', 'bat', 'batcat', 'fzf', 'jq', 'yq', 'delta'];
+    const packageManagers = ['pnpm', 'yarn', 'bun', 'npm', 'uv', 'poetry', 'cargo', 'go'];
+    const containers = ['docker', 'podman', 'kubectl', 'k9s', 'helm'];
+    return {
+        modern: commands.filter(cmd => modern.includes(cmd)),
+        packageManagers: commands.filter(cmd => packageManagers.includes(cmd)),
+        containers: commands.filter(cmd => containers.includes(cmd)),
+        others: commands.filter(cmd => !modern.includes(cmd) &&
+            !packageManagers.includes(cmd) &&
+            !containers.includes(cmd)),
+    };
+}
+/**
+ * 格式化系统信息为字符串（供 AI 使用）
+ */
+export function formatSystemInfo(info) {
+    const parts = [];
+    // 基础信息
+    parts.push(`OS: ${info.os}, Arch: ${info.arch}, Shell: ${info.shell}, User: ${info.user}`);
+    parts.push(`Package Manager: ${info.systemPackageManager}, CWD: ${info.cwd}`);
+    // 可用工具（分类展示）
+    if (info.availableCommands.length > 0) {
+        const categorized = categorizeCommands(info.availableCommands);
+        const lines = [];
+        if (categorized.modern.length > 0) {
+            lines.push(`现代工具: ${categorized.modern.join(', ')}`);
+        }
+        if (categorized.packageManagers.length > 0) {
+            lines.push(`包管理器: ${categorized.packageManagers.join(', ')}`);
+        }
+        if (categorized.containers.length > 0) {
+            lines.push(`容器工具: ${categorized.containers.join(', ')}`);
+        }
+        if (categorized.others.length > 0) {
+            lines.push(`其他: ${categorized.others.join(', ')}`);
+        }
+        if (lines.length > 0) {
+            parts.push(`【用户终端可用工具】（非完整列表）`);
+            parts.push(...lines);
+            //parts.push(`注: 为确保兼容性和输出捕获，建议优先使用标准命令（ls/find/grep/cat/ps）`)
+        }
+    }
+    // 项目上下文
+    if (info.project && info.project.types.length > 0) {
+        parts.push(formatProjectContext(info.project));
+    }
+    return parts.join('\n');
+}
+/**
+ * 显示系统信息（CLI 美化版）
+ */
+export function displaySystemInfo(info) {
+    const theme = getCurrentTheme();
+    console.log(chalk.bold('\n系统信息:'));
+    console.log(chalk.hex(theme.text.muted)('━'.repeat(50)));
+    // 基础信息
+    console.log(`  ${chalk.hex(theme.primary)('操作系统')}:          ${info.os}`);
+    console.log(`  ${chalk.hex(theme.primary)('架构')}:              ${info.arch}`);
+    console.log(`  ${chalk.hex(theme.primary)('Shell')}:             ${info.shell}`);
+    console.log(`  ${chalk.hex(theme.primary)('用户')}:              ${info.user}`);
+    console.log(`  ${chalk.hex(theme.primary)('系统包管理器')}:      ${info.systemPackageManager}`);
+    console.log(`  ${chalk.hex(theme.primary)('当前目录')}:          ${chalk.hex(theme.text.secondary)(info.cwd)}`);
+    // 可用工具
+    if (info.availableCommands.length > 0) {
+        console.log(`  ${chalk.hex(theme.primary)('可用命令数')}:        ${chalk.hex(theme.success)(info.availableCommands.length)}`);
+        const categorized = categorizeCommands(info.availableCommands);
+        if (categorized.modern.length > 0) {
+            console.log(`    ${chalk.hex(theme.text.secondary)('现代工具')}: ${categorized.modern.join(', ')}`);
+        }
+        if (categorized.packageManagers.length > 0) {
+            console.log(`    ${chalk.hex(theme.text.secondary)('包管理器')}: ${categorized.packageManagers.join(', ')}`);
+        }
+        if (categorized.containers.length > 0) {
+            console.log(`    ${chalk.hex(theme.text.secondary)('容器工具')}: ${categorized.containers.join(', ')}`);
+        }
+        if (categorized.others.length > 0) {
+            console.log(`    ${chalk.hex(theme.text.secondary)('其他工具')}: ${categorized.others.join(', ')}`);
+        }
+    }
+    // 项目信息
+    if (info.project && info.project.types.length > 0) {
+        console.log(chalk.hex(theme.text.muted)('  ──────────────────────────────────────────────────'));
+        console.log(`  ${chalk.hex(theme.primary)('项目类型')}:          ${info.project.types.join(', ')}`);
+        if (info.project.packageManager) {
+            console.log(`  ${chalk.hex(theme.primary)('包管理器')}:          ${info.project.packageManager}`);
+        }
+        if (info.project.git) {
+            const statusColor = info.project.git.status === 'clean' ? theme.success : theme.warning;
+            const statusText = info.project.git.status === 'clean' ? '干净' : info.project.git.status === 'dirty' ? '有改动' : '未知';
+            console.log(`  ${chalk.hex(theme.primary)('Git 分支')}:          ${info.project.git.branch} (${chalk.hex(statusColor)(statusText)})`);
+        }
+        if (info.project.scripts && info.project.scripts.length > 0) {
+            console.log(`  ${chalk.hex(theme.primary)('可用脚本')}:          ${info.project.scripts.join(', ')}`);
+        }
+    }
+    console.log(chalk.hex(theme.text.muted)('━'.repeat(50)));
+    console.log(chalk.hex(theme.text.muted)(`缓存文件: ${CACHE_FILE}\n`));
+}
+/**
+ * 强制刷新缓存
+ */
+export function refreshSystemCache() {
+    const config = getConfig();
+    const info = detectStaticInfo();
+    const cache = {
+        version: 1,
+        cachedAt: new Date().toISOString(),
+        expiresInDays: config.systemCacheExpireDays || 7,
+        static: info,
+    };
+    // 确保配置目录存在
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
+    console.log('✓ 系统信息缓存已刷新');
 }

package/dist/src/system-history.d.ts

@@ -4,6 +4,11 @@ import type { ShellHistoryItem } from './shell-hook.js';
  * 用于没有安装 shell hook 的情况
  *
  * 限制：系统历史文件不记录退出码，所以 exit 字段都是 0
+ *
+ * 支持的 Shell：
+ * - Unix: zsh, bash, fish
+ * - Windows: PowerShell 5.x, PowerShell 7+ (通过 PSReadLine)
+ * - 不支持: CMD (无持久化历史)
  */
 export declare function getSystemShellHistory(): ShellHistoryItem[];
 /**