如何安全删除IntelliJ的Augment Code数据库？

Question

如何安全删除IntelliJ IDEA中的Augment Code数据库以避免项目配置损坏或数据泄露？该数据库可能包含敏感的代码补全记录和本地索引信息。直接删除目录可能导致IDE异常，应如何通过IDE设置清理或安全移除相关缓存与数据文件？

Answer 1

安全删除 IntelliJ IDEA 中的 Augment Code 数据库：从机制到实践

1. 背景与核心概念解析

IntelliJ IDEA 作为主流的 Java 集成开发环境，其智能代码补全、上下文感知和本地索引功能依赖于多个缓存与数据库文件。其中，“Augment Code”并非官方术语，但通常指代由插件或 AI 辅助编码功能（如 JetBrains AI Assistant）生成的增强代码建议记录、本地模型缓存及用户行为日志。

这些数据常存储在以下路径中：

• ~/.cache/JetBrains/IntelliJIdea*/
• ~/.config/JetBrains/IntelliJIdea*/
• $PROJECT_DIR$/.idea/augment/（若存在）

该类数据库可能包含敏感信息，例如：

数据类型	潜在风险
代码片段缓存	泄露业务逻辑或API密钥
用户输入历史	暴露开发习惯与内部命名规范
本地AI模型微调数据	违反数据合规政策（如GDPR）
项目结构快照	辅助逆向工程攻击

2. 直接删除的风险分析

若未通过 IDE 内部机制清理，直接使用命令行或文件管理器删除相关目录可能导致以下后果：

1. IDE 启动失败或卡顿，因索引损坏导致重新构建耗时增加
2. 插件状态不一致，AI 助手无法恢复上下文
3. 版本控制误提交残留锁文件（如 *.lock）
4. 丢失个性化设置（尽管可通过同步恢复）

因此，必须优先采用“软清除”策略，确保原子性与一致性。

3. 安全移除流程图解

        [开始] 
          ↓
    [关闭 IntelliJ IDEA 实例]
          ↓
    [进入 File → Manage IDE Settings → Safe Delete]
          ↓
    [选择 "Clear Caches & Local History"]
          ↓
    [勾选 "AI Code Suggestions Cache" 和 "Local Indexes"]
          ↓
    [执行 Clean and Restart]
          ↓
    [验证日志输出无异常]
          ↓
    [结束]
    

4. 基于 IDE 设置的安全清理步骤

推荐操作路径如下（适用于 IDEA 2023.2+ 版本）：

1. 打开 File → Settings → Appearance & Behavior → System Settings
2. 进入 Shared Indexes / Local Caches 子项
3. 查找标记为 “Augmented Intelligence” 或 “AI-Powered Completion” 的条目
4. 点击右侧垃圾桶图标或 “Remove Locally Stored Data” 按钮
5. 确认弹窗提示，系统将异步清理关联数据库文件
6. 重启 IDE 后检查 idea.log 是否包含 Cleanup completed for augment-db

5. 手动干预的补充方案（高级用户）

当插件残留或缓存未被完全清除时，可结合以下脚本进行精准删除：

#!/bin/bash
# 安全清理 Augment Code 相关数据脚本
IDE_CACHE="$HOME/.cache/JetBrains/IntelliJIdea*"
AUGMENT_DIRS=$(find "$IDE_CACHE" -name "augment-*" -type d 2>/dev/null)

for dir in $AUGMENT_DIRS; do
    echo "Processing $dir"
    # 使用 rsync 清空而非 rm，避免 inode 占用问题
    mkdir /tmp/empty && rsync -a --delete /tmp/empty/ "$dir/" && rmdir "$dir"
done

# 清理项目级临时数据
find . -path "*/.idea/augment" -exec rm -rf {} \;
    

6. 数据泄露防护最佳实践

为防止未来数据积累引发安全问题，建议实施以下策略：

• 启用 Settings → Privacy → Do Not Send Usage Data
• 配置 IDE Encrypted Storage 对敏感缓存加密
• 定期运行 Inspect Code → Leaked Secrets Detection
• 在 CI/CD 流水线中加入 find $CACHE_DIR -name "*augment*" -delete

7. 日志验证与审计追踪

完成清理后，应检查位于 Help → Show Log in Explorer 中的日志文件，搜索关键词：

[INFO] AugmentCodeManager: Starting cleanup of suggestion database
[DEBUG] Deleting index shard: user-code-snippets.db
[INFO] LocalAICache: Removed 3.2 MB of cached context vectors
[WARNING] Some files locked by PythonAssistant plugin, skipping...
    

若发现 WARNING 级别日志，需手动终止相关后台进程后再清理。

8. 插件生态的影响评估

部分第三方插件（如 GitHub Copilot、CodeWithMe）会扩展 Augment Code 行为，需单独处理：

插件名称	数据位置	清理方式
GitHub Copilot	~/.config/gh-cli/hosts.yml	copilot auth logout
Tabnine	~/.tabnine	Settings → Manage Account → Erase Local Data
Amazon CodeWhisperer	%APPDATA%\Roaming\CodeWhisperer	AWS CLI delete-profile