Augment 插件清理工具 v3.4

一款功能强大的 Augment 插件数据清理和 API 优化工具

Go Version (https://img.shields.io/badge/Go-1.23+-blue.svg) Platform (https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-green.svg) License (https://img.shields.io/badge/License-MIT-yellow.svg)

📖 项目简介

Augment 插件清理工具是一款专业的多功能工具，集成了 Augment 插件数据清理 和 API 域名优化 两大核心功能。通过智能化的交互式菜单和丰富的命令行参数，为用户提供灵活、安全、高效的使用体验。

🎯 核心功能

• 🧹 彻底清理 Augment 插件的所有跟踪数据
• 🚀 API 域名测速 和 hosts 文件优化
• 🌐 代理支持 (Clash、V2Ray、自定义代理)
• 🎛️ 交互式主菜单 和命令行双模式
• 🔒 安全模式 和干运行预览
• 📊 详细报告 和进度显示
• 🌍 跨平台兼容 (Windows、macOS、Linux)

---

⚠️ 重要注意事项

🔴 使用前必读

🖥️ 系统兼容性

---

� 快速开始

📦 安装和编译

方式一：下载预编译版本

Windows 系统：

# 下载 augment-cleaner-windows-amd64.exe
# 直接双击运行或在命令行中执行
.\augment-cleaner-windows-amd64.exe

Linux 系统：

# 下载 augment-cleaner-linux-amd64
# 添加执行权限（重要！）
chmod +x augment-cleaner-linux-amd64

# 运行程序
./augment-cleaner-linux-amd64

macOS 系统：

# 下载 augment-cleaner-darwin-amd64
# 添加执行权限（重要！）
chmod +x augment-cleaner-darwin-amd64

# 运行程序
./augment-cleaner-darwin-amd64

⚠️ 重要提示: Linux 和 macOS 系统下载后必须先添加执行权限才能运行！

Windows 系统：

# 直接运行
.\augment-cleaner.exe

# 或者使用 go run
go run .

Linux/macOS 系统：

# 添加执行权限（重要！）
chmod +x augment-cleaner

# 运行程序
./augment-cleaner

# 或者使用 go run
go run .

---

🎛️ 使用模式

本工具提供两种使用模式：

1️⃣ 交互式主菜单模式（推荐）

直接运行程序，无需任何参数：

# Windows
.\augment-cleaner.exe

# Linux/macOS
./augment-cleaner

程序将显示美观的主菜单：

🎯 请选择要执行的操作：
┌─────────────────────────────────────────────────────────────┐
│                        主菜单                              │
├─────────────────────────────────────────────────────────────┤
│ 1. 🚀 只执行 API 测速和 hosts 优化                         │
│ 2. 🧹 只执行 Augment 插件清理                              │
│ 3. 🔄 执行完整流程（清理 + API 优化）                      │
│ 4. 🚪 退出程序                                             │
└─────────────────────────────────────────────────────────────┘

!Augment Logo (https://github.com/user-attachments/assets/fd697b25-649e-4ce8-988a-2ee5ccf02fb4)

2️⃣ 命令行参数模式

适合自动化脚本和高级用户：

# 查看帮助
./augment-cleaner --help

# 只执行 API 优化
./augment-cleaner --api-only

# 只执行清理
./augment-cleaner --skip-api

# 干运行模式
./augment-cleaner --dry-run

---

📋 功能特性详解

🧹 Augment 插件清理功能

支持的 IDE

清理范围

• ✅ 配置文件: options 目录中的 Augment 相关配置
• ✅ 插件数据: 插件目录中的缓存和数据文件
• ✅ 项目数据: .idea 目录中的 Augment 文件
• ✅ 缓存文件: 各种临时和缓存文件
• ✅ 注册表项: Windows 注册表中的相关项（仅 Windows）
• ✅ 用户数据: .jetbrains 和 .augmentcode 目录

🚀 API 域名优化功能

测速范围

• 🌐 测试 d1.api.augmentcode.com ~ d20.api.augmentcode.com
• ⚡ 并发测试，每个域名测试 3 次取平均值
• 📊 智能排序，显示最快的域名列表
• 🏆 自动选择前 5 个最快域名优化 hosts

代理支持

�️ 命令行参数详解

清理相关参数

API 优化相关参数

代理配置格式

# Clash 代理
--proxy=clash

# V2Ray 代理
--proxy=v2ray

# 自定义代理
--proxy=custom:127.0.0.1:1080

# 不使用代理
--proxy=none

---

💡 使用示例

📝 注意: 以下示例中的 ./augment-cleaner 在 Linux/macOS 系统下需要先执行 chmod +x augment-cleaner 添加执行权限

基础使用

# 1. 交互式主菜单（推荐新手）
./augment-cleaner

# 2. 查看帮助信息
./augment-cleaner --help

# 3. 干运行模式（安全预览）
./augment-cleaner --dry-run

清理功能示例

# 完整清理（推荐）
./augment-cleaner

# 只清理指定IDE
./augment-cleaner --ide=IntelliJIdea

# 只清理聊天记录
./augment-cleaner --chat-only

# 详细输出模式
./augment-cleaner --verbose

# 静默模式（适合脚本）
./augment-cleaner --silent --dry-run

API 优化示例

# 只执行API优化
./augment-cleaner --api-only

# 使用Clash代理进行API优化
./augment-cleaner --api-only --proxy=clash

# 使用自定义代理
./augment-cleaner --api-only --proxy=custom:127.0.0.1:1080

# 干运行模式查看优化效果
./augment-cleaner --api-only --dry-run

组合使用示例

# 清理但跳过API优化
./augment-cleaner --skip-api

# 详细模式 + 干运行
./augment-cleaner --verbose --dry-run

# 只清理PyCharm + 详细输出
./augment-cleaner --ide=PyCharm --verbose

# 完整流程 + Clash代理（推荐）
./augment-cleaner  # 选择菜单选项3，然后选择Clash代理

📊 功能验证和效果检查

� 清理效果验证

自动验证

程序内置验证功能，会自动检查：

• ✅ 残留文件扫描
• ✅ 配置重置确认
• ✅ 清理统计报告
• ✅ 操作完整性检查

手动验证方法

Windows 系统：

# 检查配置目录
dir "%APPDATA%\JetBrains" /s | findstr augment

# 检查本地数据
dir "%LOCALAPPDATA%\JetBrains" /s | findstr augment

# 检查用户目录
dir "%USERPROFILE%\.augmentcode"

Linux/macOS 系统：

# 检查配置目录
find ~/.config/JetBrains -name "*augment*" 2>/dev/null

# 检查缓存目录
find ~/.cache/JetBrains -name "*augment*" 2>/dev/null

# 检查用户目录
ls -la ~/.augmentcode 2>/dev/null

🚀 API 优化效果验证

测速结果示例

🏆 最快的域名排行榜 (前10名):
┌────┬─────────────────────────────────────┬──────────┬─────────────────┐
│排名│              域名                   │   延迟   │       IP        │
├────┼─────────────────────────────────────┼──────────┼─────────────────┤
│  1 │ d13.api.augmentcode.com             │ 298ms    │ 34.36.152.253   │
│  2 │ d14.api.augmentcode.com             │ 299ms    │ 35.190.75.54    │
│  3 │ d9.api.augmentcode.com              │ 300ms    │ 34.8.117.179    │
└────┴─────────────────────────────────────┴──────────┴─────────────────┘

hosts 文件检查

# Windows
type C:\Windows\System32\drivers\etc\hosts | findstr Augment

# Linux/macOS
cat /etc/hosts | grep Augment

---

� 故障排除

常见问题及解决方案

🚨 IDE 运行检测错误

❌ 问题：检测到 JetBrains IDE 正在运行
✅ 解决方案：
1. 完全关闭所有 JetBrains IDE
2. 检查任务管理器/活动监视器中的相关进程
3. 如有必要，重启计算机

🔒 权限相关错误

执行权限问题（Linux/macOS）：

❌ 问题：Permission denied 或无法执行程序
✅ 解决方案：
chmod +x augment-cleaner        # 添加执行权限
./augment-cleaner               # 然后运行

管理员权限问题：

❌ 问题：无法修改 hosts 文件或删除某些文件
✅ 解决方案：
• Windows: 右键"以管理员身份运行"
• Linux/macOS: 使用 sudo 运行
  sudo ./augment-cleaner
• 检查文件是否被其他程序占用

🌐 网络连接问题

❌ 问题：API 测速失败或连接超时
✅ 解决方案：
1. 检查网络连接
2. 尝试使用代理模式
3. 确认防火墙设置
4. 检查 DNS 设置

📁 清理不完整

❌ 问题：仍有残留文件
✅ 解决方案：
1. 使用 --verbose 模式查看详细信息
2. 尝试 --unsafe 模式进行更彻底清理
3. 手动检查和删除残留文件
4. 重新运行清理程序

🆘 获取帮助

如果遇到其他问题：

1. 📖 查看 --help 获取详细参数说明
2. 🔍 使用 --verbose 模式获取详细日志
3. 🧪 使用 --dry-run 模式安全预览操作
4. 📝 查看生成的清理报告文件

---

📈 版本信息

当前版本：v3.4

🆕 新增功能

• ✨ 交互式主菜单: 用户友好的菜单驱动界面
• 🚀 API 域名优化: 集成域名测速和 hosts 优化
• 🌐 代理支持: 支持 Clash、V2Ray 和自定义代理
• 🎛️ 模块化设计: 独立的 API 优化器模块
• 📊 美化界面: 丰富的图标和表格显示