Troubleshooting Hub

连接延迟测试

# 测试Google Gemini API
curl -w "%{time_total}\n" -o /dev/null -s \
  https://generativelanguage.googleapis.com/

# 测试Anthropic Claude API  
curl -w "%{time_total}\n" -o /dev/null -s \
  https://api.anthropic.com/

# 测试OpenAI API
curl -w "%{time_total}\n" -o /dev/null -s \
  https://api.openai.com/

正常情况下延迟应小于500ms。超过1000ms表明网络连接存在问题。

带宽测试

# 下载速度测试(使用大文件)
curl -w "%{speed_download}\n" -o /dev/null -s \
  https://files.pythonhosted.org/packages/large-file

# 上传速度测试(模拟代码上传)
time curl -X POST -H "Content-Type: application/json" \
  -d @large-test-file.json \
  https://httpbin.org/post

Antigravity需要稳定的上传带宽来发送代码上下文。推荐至少1Mbps上传速度。

内存监控工具

内存优化策略

• 减少上下文窗口大小（设置 → AI → Context Size）
• 禁用大型项目的全量索引（设置 → 索引 → 选择性索引）
• 关闭未使用的扩展和插件
• 定期清理缓存（设置 → 高级 → 清理所有缓存）
• 限制同时打开的文件数量

磁盘性能测试

# Windows: 使用CrystalDiskMark或命令行
fsutil file createnew testfile 1073741824
powershell "Measure-Command { Copy-Item testfile testfile2 }"

# macOS/Linux: 使用dd命令测试
dd if=/dev/zero of=testfile bs=1M count=1024 conv=fdatasync
dd if=testfile of=/dev/null bs=1M count=1024

# 检查SSD健康状态
# Windows: wmic diskdrive get status
# macOS: system_profiler SPStorageDataType
# Linux: sudo smartctl -a /dev/sda

SSD读写速度应超过100MB/s。机械硬盘可能导致明显的性能问题， 特别是在大项目中。建议将Antigravity安装在SSD上。

CPU监控方法

观察Antigravity在不同操作下的CPU使用模式：

• 项目加载时：应在30秒内降至正常水平
• 代码编辑时：应保持在20%以下
• AI推理时：可能达到50-80%，但应在10秒内完成
• 空闲时：应保持在5%以下

CPU优化配置

• 设置 → 性能 → 工作线程数量（推荐CPU核心数-2）
• 禁用实时语法检查对大文件
• 延迟AI建议触发时间（设置为500ms+）
• 限制并发AI请求数量

Windows日志位置

%APPDATA%\Antigravity\logs\
├── main.log          # 主进程日志
├── renderer.log      # 界面渲染日志  
├── extension.log     # 扩展运行日志
├── ai-service.log    # AI服务调用日志
└── crash.dmp         # 崩溃转储文件

使用PowerShell查看: Get-Content -Tail 50 main.log

macOS/Linux日志位置

~/.config/antigravity/logs/
├── main.log
├── renderer.log
├── extension.log
├── ai-service.log
└── performance.log   # 性能监控日志

使用命令查看: tail -f main.log

API连接错误

ERROR: [ai-service] Connection timeout to api.gemini.google.com
ERROR: [ai-service] HTTP 429: Rate limit exceeded
ERROR: [ai-service] HTTP 401: Invalid API key

解决方法：检查网络连接，验证API密钥，调整请求频率或切换模型。

内存不足错误

WARN: [main] High memory usage detected: 95% of 16GB
ERROR: [renderer] Out of memory while indexing large project
ERROR: [extension] Failed to load extension due to memory constraints

解决方法：减少上下文窗口，禁用选择性索引，关闭不必要的扩展。

文件系统错误

ERROR: [main] Permission denied accessing /path/to/project
ERROR: [file-watcher] Too many open files (EMFILE)
WARN: [sync] File sync conflict detected: file.js

解决方法：检查文件权限，增加文件描述符限制，解决文件冲突。

# Windows
antigravity.exe --safe-mode

# macOS  
/Applications/Antigravity.app/Contents/MacOS/Antigravity --safe-mode

# Linux
antigravity --safe-mode

手动备份脚本

# Windows PowerShell
$backupPath = "C:\Backup\Antigravity\$(Get-Date -Format 'yyyy-MM-dd')"
New-Item -ItemType Directory -Path $backupPath -Force
Copy-Item "$env:APPDATA\Antigravity\*" $backupPath -Recurse

# macOS/Linux Bash
backup_dir="$HOME/backup/antigravity/$(date +%Y-%m-%d)"
mkdir -p "$backup_dir"
cp -r ~/.config/antigravity/* "$backup_dir/"

建议每次重大配置更改前执行备份，或设置定期自动备份任务。

版本控制集成

将重要配置文件纳入Git版本控制，便于跟踪变更和团队共享。

# 创建配置仓库
git init antigravity-config
cd antigravity-config

# 添加配置文件（排除敏感信息）
cp ~/.config/antigravity/settings.json .
cp ~/.config/antigravity/keybindings.json .
# 不包含包含API密钥的文件

git add .
git commit -m "Initial Antigravity configuration"

紧急恢复步骤

1. 完全卸载： 使用官方卸载工具清除所有文件和注册表项
2. 清理残留： 手动删除配置文件夹和缓存目录
3. 重新安装： 下载最新版本进行全新安装
4. 恢复配置： 从备份中恢复经过验证的配置文件
5. 逐步验证： 分步骤恢复扩展和自定义设置

恢复验证清单