AgentDrive 想让一个编码 Agent 接着另一个 Agent 开过的会话继续干活。要做到这一点,又不要求你手动保存任何东西,它必须在后台同步会话——安全地同步,还不能拖慢 Agent 本身。这套机制在 adrive 命令行工具和 MCP 服务器里是怎么跑起来的,可以从一条钩子说起。
每个被支持的 Agent 命令行工具都有一套生命周期钩子,AgentDrive 在每一套里注册同一条命令。Antigravity 的钩子载荷不带事件名,所以它的条目要额外加上 --event 参数。注册的命令是:
- command -v adrive 命中时直接调用 adrive hook
- 否则回退到 npx -y @adrive/cli hook
之所以保留 npx 回退,是因为从图形界面启动的 Agent 往往没有把全局 npm 可执行目录放进 PATH。adrive init 会把这些条目合并进已有的配置文件,保留你原有的钩子及其顺序,重复执行输出完全一致。Codex 只运行它信任的钩子,所以初始化时也会替你记录这份批准;在较老的 Codex 上,需要通过 /hooks 手动批准一次。
钩子是内联在 Agent 里跑的。Codex 把钩子超时卡在 3 秒,所以 adrive hook 本身几乎什么都不做:读取事件载荷(会话 id、工作目录、转录文件路径),记下会话属于哪个目录,启动一个分离的 adrive sync 进程,然后以 0 退出。钩子失败会被吞掉,因此它既不会阻塞也不会弄坏你的会话。
在会话启动事件上,如果自动上下文开着,钩子还会向 AgentDrive 询问这个项目最近的会话。它把来自其他 Agent 的最新会话排在前面,最多返回三个作为额外上下文,并附上调用 drive_resume 的提示。OpenCode 的插件接口没有注入上下文的能力,所以 OpenCode 跳过这一步。
真正干活的是那个分离出去的同步进程,它做了四件事:
- 加锁。同一时间只跑一个同步,通过 ~/.config/agentdrive/ 下的锁文件协调。被一串钩子事件触发的同步会最多等 30 秒拿锁,而不是直接放弃。
- 防抖。回合结束事件(Stop、stop、AfterAgent)对同一会话最多每两分钟重新同步一次。会话结束和压缩事件跳过防抖,保证最终状态一定落盘。OpenCode 没有会话结束事件,所以它的 session.idle 也跳过防抖。
- 扫描。每次同步还会检查每个 Agent 自上次扫描以来发生变化的会话。首次扫描回看 14 天,单次最多处理 50 个会话。在结束事件之前就被杀掉的会话,空闲 30 分钟后会被收尾。
- 读转录。每个 Agent 存会话的方式都不同:Claude Code 把 JSONL 放在 ~/.claude/projects,Codex 把 rollout 文件放在 $CODEX_HOME/sessions,Cursor 放在 ~/.cursor/projects,Antigravity 放在 ~/.gemini/ 下的 brain 和 tmp 目录,OpenCode 则通过 opencode session list 和 opencode export 暴露。每个 Agent 配一个解析器,把会话归一成回合、工具调用和触碰过的路径。
上传之前,两层规则在你的机器上先跑一遍。路径规则决定哪些文件根本不允许上传,产物同步只看该会话里 Agent 触碰过的文件,下面每一项检查都通过才会放行:
- 文件在你的主目录或会话所属项目之内。
- 不匹配内置拒绝清单。清单覆盖 .env 与 .env.*、.dev.vars、.ssh/、.aws/、.kube/、.npmrc、.netrc、*.pem、*.key、credentials.json、auth.json、shell 历史、SQLite 数据库、node_modules/、dist/ 等。拒绝清单是硬闸门,项目的 .adriveignore 无法覆盖它。
- 不匹配项目的 .adriveignore。该文件使用 gitignore 语法的一个子集:注释、! 取反、/ 锚定、* 和 **。
- 文件未被 git 跟踪且未被 git 忽略,或者位于任何仓库之外。已跟踪的文件本来就在 git 里,被 git 忽略的文件恰恰是密钥爱待的地方。如果 git status 因其他原因失败,文件被跳过。
- 文件不超过 1 MB,且不像二进制(前 8 KB 内没有 NUL 字节)。
内容脱敏负责清洗真正上传的东西。转录和每个同步文件都会过一遍基于模式的脱敏器,把 AWS 访问密钥与密钥、GCP 服务账号私钥、Stripe、GitHub、Anthropic、OpenAI、Slack 和 AgentDrive 的令牌、JWT、PEM 私钥块,以及 SOMETHING_KEY=... 形式的赋值,替换成 [redacted:github-token] 这类标记。版本消息只记录脱敏了哪些种类,从不记录具体值。
脱敏是尽力而为,它不是安全边界。模式匹配会漏掉那些看起来不像密钥的密钥。这正是路径规则要排在前面的原因,也是 Private Workspace 存在的原因。
每个会话被渲染成纯 markdown:一个带项目、工作目录、标题和回合数的头部,一份“触碰过的文件”列表,然后每个回合一个 ## user 或 ## assistant 小节,工具调用写成 > tool: 行。同步把它写到 sessions/ 下的项目目录里,文件放在 files/ 子目录。位于项目之外但在主目录之内的文件,归到 files/_external/ 下,文件名里带一段路径的短哈希。
项目键由你工作的位置推导,因此每个 Agent 都把同一个仓库归到同一个键下:有 git 远程时用归一化的远程 URL,例如 github.com__acme__api;本地仓库没有远程时用仓库文件夹名加路径短哈希;仓库之外用 local__ 加目录名。已被删除的 Claude Code worktree 里的会话,归到它的父仓库下。
工作区文件是版本化、内容寻址的,所以重复上传一个没变的文件不花任何代价。每个会话还被记录为一次运行,id 由会话 id 加时间戳构成。这次运行携带会话标题、状态(in_progress 或 success)、上传文件的 id、转录路径、触碰过的路径以及最后一回合的时间。每个请求都打上 Agent 作为其平台标记,来源信息就出自这里:时间线能显示这个文件是 Codex 写的、Claude Code 读的。
当 Agent 不带参数调用 drive_resume 时,AgentDrive 会挑这个项目里来自另一个 Agent 的最新会话。因此在 Codex 里恢复,拿到的是 Claude Code 的会话,而不是 Codex 自己上一次的运行。如果那里没有其他 Agent 的会话,就回退到最新的那个。你也可以从 drive_sessions 里传一个具体的 id。
完整转录通常太大,加载不下,所以交接简报按字符预算构建,默认 12,000 字符,可设范围从 1,000 到 50,000:
- 一行引言,点明来源 Agent 和会话,并附上“依赖之前先核对磁盘上的文件状态”的指示。
- 会话元数据。
- 目标:第一条用户消息,上限 1,500 字符,若预算更小则取预算的八分之一。
- 触碰过的文件,加上已上传副本的文件 id,好让另一台机器上的 Agent 用 drive_read 取回。
- 最近的回合,从最新往回挑直到预算用尽,再按顺序展示,并标注有多少更早的回合被略去。
如果头部太大,文件列表会先缩水,这样即使预算很小也能带上最新的回合。通过 Claude Code 里的 /agentdrive:resume 或 shell 里的 adrive resume,恢复走的是同一套逻辑。
用 adrive privacy --private-workspace on 打开 Private Workspace 后,同步会在四个方面改变:
- 转录和同步文件在上传前于本机用 AES-256-GCM 加密。数据密钥在本地生成,包裹后存在你的 AgentDrive 配置目录里,服务器只看到密文。
- 项目键被替换成哈希(p- 加 16 个十六进制字符),同步文件以哈希名存储,仓库名和文件路径不会出现在存储路径里。
- 服务器必须读取的运行元数据,会略去工作目录、标题和触碰过的路径。会话显示为“Private session”。
- MCP 服务器无法解密,所以 drive_resume 会告诉 Agent 在 shell 里运行 adrive resume,由该命令在本地解密并打印简报。
代价是服务端功能读不到加密内容。这正是设计意图。
想试的话,安装脚本是 curl -fsSL agentdrive.sh/install | sh,然后可以用 adrive sync --dry-run 只解析本地会话并报告、不上传任何东西,用 adrive privacy --show 查看当前状态。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.