如何快速解锁 Antigravity CLI 完整转录?agy-reader 配合 AgentsView 实战指南
【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview
AgentsView是一款本地优先(local-first)的 AI 编码代理会话分析工具,为 Claude Code、Codex 以及 Antigravity CLI 等 20 多款代理提供会话搜索、成本分析与 token 用量统计。而agy-reader则能配合 AgentsView 解锁 Antigravity CLI 的加密完整转录,让原本只能看到摘要的会话变成全量结构化记录——工具调用、结果、推理过程和代码 diff 一目了然。
一、AgentsView 是什么?为什么值得装?
一句话概括:一个二进制、无账号、数据全部留在本地。
- 🖥️本地数据库:自动发现本机所有受支持代理的会话,同步进本地 SQLite,并启动 Web UI(
http://127.0.0.1:8080) - 🔍全文搜索与语义搜索:跨代理检索历史会话、工具调用与代码改动
- 💰成本与 token 统计:按天、按代理、按模型查看消耗
安装后只需三条命令即可上手:
agentsview serve # 前台启动服务 agentsview daemon start # 或后台守护进程方式启动 agentsview usage daily # 查看每日成本汇总完整说明见项目根目录的 README.md。
二、痛点:Antigravity CLI 的转录为什么是"锁着"的?
Antigravity CLI 的会话存放在~/.gemini/antigravity-cli/下,存在两种磁盘格式:
| 格式 | 位置 | 说明 |
|---|---|---|
| SQLite 数据库 | conversations/<uuid>.db | 新版 CLI 使用 |
| AES-GCM 加密文件 | conversations/<uuid>.pb、implicit/<uuid>.pb | 旧版 CLI 使用 |
| 明文辅助文件 | brain/<uuid>/*.md、history.jsonl | 计划文档与用户提示词日志 |
没有解密通道时,AgentsView 只能退回到摘要模式(Summary Mode):从.db中启发式解出提示词和工具调用名,或读取history.jsonl与brain/下的明文。此时会话详情页头部会出现一个 "Summary mode" 徽标——这就是"转录被锁住"的信号。
解析逻辑可参考源码:internal/parser/antigravity_cli.go 与加密处理模块 internal/parser/antigravity_crypto.go。
三、核心操作:用 agy-reader 解锁完整转录
agy-reader 的工作方式很直接:它连接本机的Antigravity daemon,解密每个会话,并在源文件旁写出一份<uuid>.trajectory.json旁路文件(sidecar)。AgentsView 的文件监听器会自动检测到这份 sidecar 并就地解析——无需重启 AgentsView。
1️⃣ 安装 agy-reader
go install github.com/mjacobs/agy-reader@latest2️⃣ 为已有会话批量生成 sidecar
agy-reader --sync3️⃣ 边工作边保持转录最新
agy-reader --watch⚙️ 小提示:agy-reader 会通过解析~/.gemini/antigravity-cli/cli.log自动发现 Antigravity daemon 的地址。如果日志已轮转导致发现失败,命令会打印当前平台的排查步骤,手动定位端口并导出ANTIGRAVITY_DAEMON_URL即可。
四、AgentsView 的转录源优先级:四档保真度
生成 sidecar 后,AgentsView 会按以下顺序选择信息量最丰富的来源(详见 docs/configuration.md):
- 解密后的 trajectory sidecar(agy-reader 产出)→ 完整消息、工具调用、结果、推理、diff,保真度最高 ✅
- SQLite trajectory 数据库:只读打开
.db直接解码,但只能恢复提示词与工具名(摘要模式) - 进程内
.pb解密:设置ANTIGRAVITY_KEY(base64 编码的 AES 密钥)后可自行解密旧版.pb文件 - 明文摘要模式:仅读取
history.jsonl与brain/摘要
也就是说,装了 agy-reader 后,无论新旧格式都能拿到全量结构化转录,且该模式下 AgentsView 本身甚至不需要ANTIGRAVITY_KEY。
五、解锁后的体验与隐私说明
- 🏷️徽标消失:sidecar 覆盖的会话不再显示 "Summary mode" 徽标,详情页直接呈现完整转录
- 👀自动感知:文件监听器检测到新 sidecar 立即重解析,同步链路无需人工干预
- 🔒数据不出本机:sidecar 只写在本机,AgentsView 不发起任何外部请求来生成或读取它们,并一律将 sidecar 视为不可信的结构化输入处理(信任模型见 SECURITY.md)
- 📊顺带解锁统计:sidecar 中的
gen_metadata还能带来 token 用量数据,让 Antigravity CLI 的会话也能进入成本统计
六、延伸阅读与模块导航
| 资源 | 路径 |
|---|---|
| Antigravity CLI 解析器 | internal/parser/antigravity_cli.go |
.pb文件解密逻辑 | internal/parser/antigravity_crypto.go |
| 代理目录与转录源配置说明 | docs/configuration.md |
| 官方命令速查 | docs/commands.md |
| 会话格式与数据来源考证 | docs/internal/session-format-sources.md |
| 更新日志(Antigravity 相关条目) | docs/changelog.md |
💡总结:想要 Antigravity CLI 的高保真完整转录,配方只有一行——装好agy-reader,跑一次
--sync(或常驻--watch),剩下的交给AgentsView的文件监听器。全程本地完成,隐私无忧。
【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考