清理 Gemini 缓存和配置文件
快速备份和清理 Google Gemini 的本地配置和缓存文件。
快速清理
macOS/Linux
使用 npx 直接运行（推荐）：
# 方式 1: 交互式清理（推荐，选择 gemini 选项）
npx aihezu clear
# 方式 2: 直接指定服务
npx aihezu clear gemini或全局安装后使用：
npm install -g aihezu
aihezu clear geminiWindows
在命令提示符或 PowerShell 中运行：
# 方式 1: 交互式清理（推荐，选择 gemini 选项）
npx aihezu clear
# 方式 2: 直接指定服务
npx aihezu clear gemini其他维护命令（新增）
# 只修改配置（不清理缓存）
npx aihezu config gemini
# 检查配置状态（配置文件 + 环境变量）
npx aihezu check gemini
# 手动备份 / 恢复 / 重置
npx aihezu backup gemini
npx aihezu recover gemini
npx aihezu reset gemini功能特性
- 一键清理 Gemini 的缓存数据（保留配置）
- 自动备份所有被修改的文件（带时间戳）
- 安全可靠，不会丢失数据
- 支持 npx 直接运行，无需安装
清理内容
该工具会执行以下操作：
清理 Gemini 缓存
清理的缓存文件和文件夹：
~/.gemini/cache/- 缓存文件~/.gemini/logs/- 日志文件
保留的配置：
~/.gemini/.env- 环境变量配置（包括 API Key）~/.gemini/settings.json- 设置文件（如果存在）
所有清理操作都会创建带时间戳的备份，不会直接删除数据。配置文件会被保留，清理后可以继续使用 Gemini 而无需重新配置。
恢复备份
备份文件保存在 ~/.gemini/ 目录下，文件名格式为 原文件名-backup-时间戳.tar.gz。
如需恢复之前的缓存，可解压对应的备份包：
# macOS/Linux - 恢复目录示例
tar -xzf ~/.gemini/cache-backup-20250113120000.tar.gz -C ~/.gemini
tar -xzf ~/.gemini/logs-backup-20250113120000.tar.gz -C ~/.gemini
# Windows PowerShell - 恢复目录示例
tar -xzf "$env:USERPROFILE\.gemini\cache-backup-20250113120000.tar.gz" -C "$env:USERPROFILE\.gemini"
tar -xzf "$env:USERPROFILE\.gemini\logs-backup-20250113120000.tar.gz" -C "$env:USERPROFILE\.gemini"由于配置文件（.env 和 settings.json）不会被清理，通常不需要恢复这些内容。
使用场景
- Gemini 出现异常需要重置
- 清理大量累积的缓存和日志
- 切换不同的配置环境
- 重新初始化 Gemini 环境
清理后使用
由于配置文件（.env）被保留，清理后可以直接使用 Gemini，无需重新配置。
如果需要重新配置，可以参考安装指南：Mac/Linux / Windows
系统要求
- Node.js >= 14.0.0
- macOS / Linux / Windows
- 不需要管理员权限
常见问题
遇到问题请查看：