企业官网建设流程全解析

Antigravity Conversation Fix是一款开源修复工具，专门解决 Google Antigravity 中对话历史消失、排序错乱、标题变成占位符、工作区丢失等问题。本文面向新手，手把手教你在macOS、Linux 和 WSL上从零开始运行 Antigravity Conversation Fix——不需要 Windows 专属的.exe，直接用自带的 Python 脚本 rebuild_conversations.py 即可，全程免费、开箱即用。🎯

Antigravity 对话丢失？这个工具能修复什么

如果你遇到以下任何一种情况，说明 Antigravity 的侧边栏索引（sidebar index）损坏了——对话文件还在磁盘上，只是"目录"丢了：

💡 核心原理：Antigravity 把数据存在两个地方——对话文件（*.pb/*.db）和侧边栏索引（一个 SQLite 数据库state.vscdb）。本工具只重建索引，从不改动对话文件本身，因此安全、幂等、可重复运行。

运行前唯一要记住的事：先完全关闭 Antigravity

这是整个教程里最重要的一步，只需记住一句话：运行工具前，彻底退出 Antigravity（File → Exit）。

原因很简单：如果 Antigravity 还在后台运行，它退出时可能会把旧索引写回去，直接覆盖你的修复结果。工具虽然会检测进程并给出警告，但最稳妥的做法仍然是先关闭它。

macOS / Linux 一键源码运行步骤

第 1 步：确认 Python 3 环境

工具只依赖 Python 3.7+，不需要安装任何第三方包。打开终端确认版本：

python3 --version

⚠️ 为什么用python3而不是python？在 macOS 12.3+ 和大多数 Linux 发行版上，python命令可能不存在，或指向老旧的 Python 2。用python3最保险。

别担心输错：脚本内置了Python 版本保护，如果你误用 Python 2 启动，它会自动用python3重新启动自己；如果系统里完全没有 Python 3，会打印清晰的安装指引。

第 2 步：获取项目

克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/an/antigravity-conversation-fix cd antigravity-conversation-fix

项目只有 4 个文件，结构一目了然：

• rebuild_conversations.py — 核心脚本，跨平台路径检测、索引重建全在这里
• README.md — 官方说明文档，含完整的修复清单与 FAQ
• run.bat — Windows 专用的快捷启动脚本（macOS / Linux 用不上）
• LICENSE — MIT 许可证，可自由使用、分享和修改

第 3 步：执行修复

python3 rebuild_conversations.py

脚本会自动完成：

1. 检测操作系统并找到正确的数据目录（自动识别antigravity、antigravity-ide等各种命名变体，新旧版本都能找到）
2. 扫描对话文件：macOS / Linux 上位于~/.gemini/antigravity/（或antigravity-ide/），SQLite 索引位于~/Library/Application Support/Antigravity IDE/.../state.vscdb（macOS）或~/.config/Antigravity IDE/.../state.vscdb（Linux）
3. 重建索引并按日期排序，同时恢复标题与工作区映射
4. 打印修复结果报告

第 4 步：选择工作区分配方式

运行到最后会提示你选择工作区分配策略：

• 按 Enter 或输入 1— 仅自动分配（从 brain 文件推断，推荐）
• 输入 2— 自动分配后，再对剩余未映射的对话逐条手动指定

小技巧：手动分配时支持输入all批量处理，快速完成设置。

第 5 步：重新打开 Antigravity

大多数情况下直接关闭再打开 Antigravity 就能看到修复结果；如果没生效，重启电脑是最保险的方式。修复后的对话会按日期降序排列，整齐地回到侧边栏。🎉

WSL 用户：原生支持，无需手动拷贝文件

很多教程会教你把文件从 Windows 侧拷到 WSL 再跑——Antigravity Conversation Fix不需要这么做（v1.05+ 原生支持 WSL）：

python3 rebuild_conversations.py

它的 WSL 工作方式是：

1. 调用cmd.exe /c echo %APPDATA%直接解析Windows 侧的%APPDATA%路径，并用wslpath转换，从而访问 Windows 侧的 Antigravity 数据库
2. 对话与 brain 数据则从Linux 侧的~/.gemini/antigravity/读取
3. 如果主方法失败，会回退扫描/mnt/c/Users/下已安装 Antigravity 的目录

进程检测同样做了双端处理：同时检查 Windows 宿主（tasklist.exe）和 Linux 进程（pgrep），确保不会在 Antigravity 运行时误写数据库。

另外，如果你的工作区本身就是 WSL / SSH / Docker 远程工作区（vscode-remote://URI），v1.04+ 也完整支持，自动分配和手动分配都无需本地路径校验。

看懂运行输出：结果图例速查

脚本运行时会在每条对话前打印标记，方便你判断修复质量：

看到[?]不要慌——这说明该对话既没有 brain 工件，数据库里也没有旧标题。以后 Antigravity 自己生成的标题会在下次运行时被保留。

安全性说明：你的数据会不会被改坏？

简短回答：不会。官方承诺了四重保护（详见 README.md）：

• 🛡️自动备份— 修改前会把当前索引存为trajectorySummaries_backup.txt
• 🛡️非破坏性— 对话文件（*.pb/*.db）只读不动，只重建侧边栏索引
• 🛡️保留元数据— 工作区分配、时间戳等内部状态原样保留（v1.01+）
• 🛡️幂等— 可以安全地重复运行多次，不会越修越乱

常见问题（FAQ）

Q：一定要重启电脑吗？A：不一定。大多数情况下关闭并重新打开 Antigravity 即可；重启只是"最保险"的兜底方案。

Q：可以一边开着 Antigravity 一边运行吗？A：工具检测到 Antigravity 在运行会发出警告，但仍建议先关闭，避免退出时被覆盖。

Q：之前误跑过 v1.0 导致工作区对话被移除，还能救回来吗？A：可以。v1.03+ 会扫描 brain 工件文件，自动恢复大部分工作区映射；跑完按 Enter（选项 1）即可，个别没推断出来的选选项 2 手动指定。

Q：升级 Antigravity 后数据文件夹改名了怎么办？A：v1.05+ 会自动检测Antigravity/Antigravity IDE等所有新旧命名变体；v1.06+ 还会把antigravity-ide、antigravity、antigravity-backup多个文件夹的对话合并去重（最新文件夹优先），并同时写入所有存在的 Antigravity 数据库——独立 agent 和 IDE 两个变体一次全修好。

总结：3 步跑通 Antigravity Conversation Fix

工具采用MIT 许可证（见 LICENSE），源码完全开放，任何疑虑都可以直接审查 rebuild_conversations.py 的实现。修好了对话？记得回仓库点个 ⭐，帮助更多人找到这个免费的好工具。