清理 Gemini 缓存和配置文件

快速备份和清理 Google Gemini 的本地配置和缓存文件。

快速清理

macOS/Linux

使用 npx 直接运行（推荐）：

# 方式 1: 交互式清理（推荐，选择 gemini 选项）
npx aihezu clear
 
# 方式 2: 直接指定服务
npx aihezu clear gemini

或全局安装后使用：

npm install -g aihezu
aihezu clear gemini

Windows

在命令提示符或 PowerShell 中运行：

# 方式 1: 交互式清理（推荐，选择 gemini 选项）
npx aihezu clear
 
# 方式 2: 直接指定服务
npx aihezu clear gemini

功能特性

一键清理 Gemini 的缓存数据（保留配置）
自动备份所有被修改的文件（带时间戳）
安全可靠，不会丢失数据
支持 npx 直接运行，无需安装

清理内容

该工具会执行以下操作：

清理 Gemini 缓存

清理的缓存文件和文件夹：

~/.gemini/cache/ - 缓存文件
~/.gemini/logs/ - 日志文件

保留的配置：

~/.gemini/.env - 环境变量配置（包括 API Key）
~/.gemini/settings.json - 设置文件（如果存在）

所有清理操作都会创建带时间戳的备份，不会直接删除数据。配置文件会被保留，清理后可以继续使用 Gemini 而无需重新配置。

恢复备份

备份文件保存在 ~/.gemini/ 目录下，文件名格式为 原文件名-backup-时间戳。

如需恢复之前的缓存，只需将备份文件重命名：

# macOS/Linux - 恢复目录示例
mv ~/.gemini/cache-backup-20250113120000 ~/.gemini/cache
mv ~/.gemini/logs-backup-20250113120000 ~/.gemini/logs
 
# Windows PowerShell - 恢复目录示例
Move-Item "$env:USERPROFILE\.gemini\cache-backup-20250113120000" "$env:USERPROFILE\.gemini\cache"
Move-Item "$env:USERPROFILE\.gemini\logs-backup-20250113120000" "$env:USERPROFILE\.gemini\logs"

由于配置文件（.env 和 settings.json）不会被清理，通常不需要恢复这些内容。

使用场景

Gemini 出现异常需要重置
清理大量累积的缓存和日志
切换不同的配置环境
重新初始化 Gemini 环境

清理后使用

由于配置文件（.env）被保留，清理后可以直接使用 Gemini，无需重新配置。

如果需要重新配置，可以参考安装指南：Mac/Linux / Windows

系统要求

Node.js >= 14.0.0
macOS / Linux / Windows
不需要管理员权限

常见问题

遇到问题请查看：

联系客服

工具源代码

查看 API 用量 🎯 学习路线