前言¶
在 DeepSeek Harness(DSH)里开发或调试时,会话通常以侧栏里的 session.jsonl.zstd 等形式存在,便于回溯和继续。若你同时在 Google Antigravity(Gemini 侧)里跑过对话,那些记录默认落在本机 SQLite 里,格式与 DSH 并不互通,想在 Harness 里「接着看」或「导入成正式会话」,往往只能手动翻库或复制粘贴。
下面介绍社区插件 dsh-antigravity-bridge(维护者 qvsix,SkillHub 分类:记忆)。它读取 Antigravity 在本机保存的对话数据库,通过 DSH 原生工具与斜杠命令提供列表、阅读与导入,把选中的 cascade 会话挂到当前工作区侧栏,与 DSH 既有会话持久化路径对齐。
这是什么¶
dsh-antigravity-bridge 是一个 Cordis 插件:在 DSH 内打开 Google Antigravity 的对话内容。Antigravity 将每条对话存为 SQLite,并在库内用 protobuf blob 保存步骤数据;默认目录为 ~/.gemini/antigravity/conversations/<cascade_id>.db。本插件用 Python 解码这些库文件,并在 DSH 侧暴露为工具与 / 命令,其中 import 会生成符合规范的 DSH 会话日志并 attach 到工作区。
仓库:https://github.com/qvsix/dsh-antigravity-bridge
目录页:https://www.skillhub.cn/plugins/qvsix/dsh-antigravity-bridge
核心功能¶
插件在 README 中列出的能力如下(Agent 工具与斜杠命令一一对应)。
Agent 工具¶
| 工具 | 说明 |
|---|---|
antigravity_list |
最近对话(id、时间戳、步数、标题),支持 limit / offset |
antigravity_read |
读取单条对话为整理后的文本(用户提示、工具结果、摘要、后台任务输出等),支持 max_chars |
antigravity_import |
将一条对话转为 DSH 会话(session.jsonl.zstd),挂到工作区并返回 conversation:// 链接 |
斜杠命令¶
可直接执行,无需再让 Agent 代劳:
| 命令 | 说明 |
|---|---|
/antigravity-list [N] |
最近对话(便于查 ID) |
/antigravity-read <cascade_id> |
阅读一条对话 |
/antigravity-import <cascade_id \| latest> |
导入为 DSH 会话;仅输入命令时会展示最近 5 条及用法 |
导入路径与 DSH 原生流程一致:会话写在 sessions/<projectKey(cwd)>/session-<cascade_id>/session.jsonl.zstd,通过 workspaceRegistry.resolveByPath 与 attachSession 挂载;侧栏可在不重启的情况下更新。重复导入同一条对话是幂等的,会返回已有链接而非覆盖。README 说明 session_projcache 不会被改动,首次打开时由后端从 session log 物化投影。
环境与依赖¶
安装前确认本机条件(均来自 README):
- Python 3:仅标准库,无额外 pip 依赖;可用环境变量
ANTIGRAVITY_PYTHON指定解释器。 zstdCLI:用于 import 时的压缩;README 写明 DSH 宿主侧通常已带。- Antigravity 对话目录:默认
~/.gemini/antigravity/conversations;可用ANTIGRAVITY_CONVERSATIONS或参数conversations_dir覆盖。 DSH_HOME:未设置时 macOS 默认~/Library/Application Support/dsh-desktop/harness。- Node:
package.json要求node >= 22;peer 依赖@deepseek-ai/cordis、@deepseek-ai/dsh-tools。
插件当前版本在 package.json 中为 0.2.0,许可证 MIT。
安装与启用¶
官方安装命令(web profile):
dsh plugin --profile web add dsh-antigravity-bridge
若已下载源码,也可本地路径安装(无需构建,src/index.js 与 decoder/*.py 原样运行):
dsh plugin --profile web add /path/to/dsh-antigravity-bridge
DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,安装来源请以目录页与 GitHub 为准。
典型用法¶
- 先列 ID:在 Harness 输入
/antigravity-list,或让 Agent 调用antigravity_list,从输出里记下cascade_id。 - 快速浏览:
/antigravity-read <cascade_id>,或工具antigravity_read,必要时用max_chars控制长度。 - 导入侧栏会话:
/antigravity-import latest或/antigravity-import <cascade_id>;成功后使用返回的conversation://链接在侧栏打开。
开发自检(仓库 README):
npm run check # node --check + python py_compile
python3 decoder/antigravity_decode.py list --limit 5
解码实现上,decoder/antigravity_decode.py 会先把 .db 复制到临时目录再读 SQLite(避免 journal 问题),并对 steps.step_payload 做启发式 protobuf 解码(如 type 14 用户、132/15 工具、23 摘要、101 后台任务)。
适用场景与注意¶
适合谁:本机使用过 Antigravity、希望在 DSH 同一工作区里查阅或延续那些对话的开发者;需要把外部 Gemini/Antigravity 会话纳入 DSH 侧栏与持久化链路的场景。
侧栏与其它插件:README 称 import 走与原生相同的 attachSession 通道,与 dsh-better-sidebar、dsh-archived-chats、dsh-rewind-plugin 等无特殊冲突;仅在显式 import 时写入,无后台全局状态修改。
安全与权限:插件在当前 dsh 进程权限下读取 ~/.gemini 下的数据库并写入 DSH_HOME 会话目录。安装前应自行审阅 GitHub 源码 与 MIT 许可证,确认路径与环境变量符合你的机器与合规要求。
结尾¶
dsh-antigravity-bridge 把 Antigravity 本地 SQLite 会话桥接到 DSH:列表、阅读、一键导入为侧栏会话,并与 DSH sanctioned 的 attach 流程对齐。若你正在 SkillHub 或 GitHub 挑选「记忆」类插件,可按上文命令安装,用 /antigravity-list 从最近对话开始试用。