返回资讯中心
外部精选
软件工程
#开发者实时流

Replica 为 macOS 上的 AI agent 提供 100 毫秒写时复制工作区

来源标题:Show HN: 100ms copy-on-write workspaces for AI agents on macOS

Replica 为每次 AI agent 运行创建独立且已完整安装的项目副本,利用 APFS 写时复制在约 100 毫秒内完成,每个副本都是真实的 git checkout,并自动清理以控制磁盘占用。在 Apple M1 Max 上,1700 文件项目单次创建约 100 毫秒,10 个并发约 230 毫秒,而 git clone 加安装需数秒。

Hacker News 最新gabrielfonseca2026/11/18 · 今天25 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Replica 为每次 agent 运行提供项目的一份完整安装副本,借助 APFS copy-on-write 在毫秒级创建完成。每份副本都是真正的 git checkout,自动清理则让总磁盘占用保持有界。

cd "$(replica new --ttl 2h --name fix-login)" # 就绪的工作区;路径输出到 stdout
git checkout -b agent/fix-login && git commit -am "fix login" && git push -u origin agent/fix-login
replica rm <id> # 完事;也可以等 TTL 过期

为什么需要它

Agent 的工作负载以创建和删除小文件为主(一次 checkout、node_modules、构建产物),而这恰恰是 macOS 最慢的地方。一次全新的安装需要几秒到几分钟,之后 agent 才能真正开始干活。

Replica 只构建一次 base:一个装好依赖的 git clone。每次 replica new 通过一次 clonefile(2) 调用克隆这个 base。在文件发生变化之前,数据块始终与 base 共享,因此新工作区几乎立刻就能就绪。在 Apple M1 Max 上实测,对包含 1,700 个文件的项目执行 replica new,N = 1 时约需 100 ms,N = 10 个并发工作区时约需 230 ms,而 git clone 加一次安装则需要数秒。

数据与方法见文末。

快速工作区。 克隆一个包含 1,700 个文件的项目,N = 1 时约需 100 ms(10 个并发工作区时约 230 ms),而 git clone 加一次安装需要数秒。具体数值会随机器负载波动;完整表格与方法见 docs/BENCHMARKS.md。

真正的 git。 每个工作区都是完整的 git checkout。它可以建分支、提交、推送,而 base 保持不变。详见下文。

磁盘占用有界。 TTL 过期、最近最少使用淘汰、字节上限,以及一个可选的、带配额 dedicated APFS 卷。

更新成本低。 replica base refresh 能让 base 与其 remote 同步,无需完整重建。详见下文。

为 agent 而生。 稳定的 CLI,支持 --json 输出、有文档说明的退出码,以及面向 Claude Code、Cursor、Copilot、Zed 和 Aider 的 skills。

并发经过测试。 tests/concurrency.rs 运行 10 个同时进行的 replica new/use/rm 循环,零 SQLite busy 错误、无损坏,所有工作区都成功创建并删除。replica gc 会跳过租约仍新鲜的工作区(.replica/lease),因此每 10 分钟运行一次的 launchd gc 绝不会删掉 agent 正在使用的工作区。

环境要求

APFS 卷上的 macOS。Replica 使用 clonefile(2),而 Linux 不提供该调用。已在 macOS 26.6(Apple M1 Max)上测试。

base 树和每个工作区必须位于同一个 APFS 卷上。克隆无法跨卷,Replica 会直接拒绝,而不是悄悄复制。

安装

已发布适用于 Apple Silicon(arm64)和 Intel(x86_64)的 macOS 二进制文件。另有一个 universal binary 同时覆盖两者。

# Homebrew 暂不可用;见 HOMEBREW.md。
# 安装脚本:用 sha256sums.txt 校验下载内容
curl -fsSL https://raw.githubusercontent.com/gabrielvfonseca/replica/main/scripts/get-replica.sh | sh
# 从源码安装(需要 Rust 工具链,https://rustup.rs)
git clone https://github.com/gabrielvfonseca/replica.git && cd replica
make release && PREFIX=$HOME/.local make install 

运行 replica help 查看引导式概览,或运行 replica help quickstart 快速上手。

1. 选择一个卷。 带配额的 dedicated APFS 卷是最稳妥的方案,因为克隆永远不可能占满你的主磁盘。

diskutil apfs list # 找到你的 APFS container
./scripts/setup-volume.sh disk3 100g Work # 创建 /Volumes/Work,并关闭该处的 Spotlight 索引
export REPLICA_ROOT=/Volumes/Work/replica 

任意 APFS 目录也可以。加上 REPLICA_MAX_BYTES 来限制其大小。取舍详见 DISK_SAFETY。

replica base build --repo https://github.com/you/proj.git --setup "npm ci"
replica base check # 找出克隆后会出问题的构建产物 

3. 创建、使用和删除工作区。

cd "$(replica new --ttl 4h --name feature-x)" # 路径输出到 stdout,状态输出到 stderr
eval "$(replica env <id>)" # 每个工作区独立的 TMPDIR 和共享缓存
replica touch <id> # 让长会话免于被 LRU 淘汰
replica list # 表格;加 --json 便于脚本处理
replica rm <id> # 删除一个(幂等) 

不同 lockfile 的分支。 如果你要基于某个分支创建工作区,而该分支的 lockfile 与 base 不同,请使用 --ref:

replica new --ref my-feature-branch 

Replica 会将该分支的 lockfile 哈希与 base 记录的哈希进行比较。如果一致,工作区会被直接克隆。如果不一致,Replica 会克隆 base、checkout my-feature-branch,然后运行 setup 命令(一次增量安装),让工作区获得正确的依赖,并报告 lockfile drift on branch my-feature-branch; running incremental install。CLI 总会告诉你它走的是哪条路径。

npx skills add gabrielvfonseca/replica # skills.sh CLI:全部六个 skill
replica setup --dry-run # 查看 setup 会为 Claude Code、Cursor、Copilot、Zed、Aider 写入什么
replica setup # 写入 

Git:在工作区里建分支、提交和推送

可以。工作区是完整的 git 仓库,不是只读副本:

对于需要开 pull request 的 agent,流程是:replica new,在分支上修改并提交,push,用 gh pr create 开 PR,然后 replica rm。

当 remote 有了新提交,replica base refresh 会更新 base。它不会从零重建:

因此,一个不涉及依赖的上游提交,代价只是一次 fetch 和一次 checkout。lockfile 变化的代价则大致相当于 setup 命令本身。如果快速路径因任何原因失败,refresh 会回退到完整重建。

用 replica base status 检查新鲜度,并用 replica new --require-fresh 拒绝使用过期的 base。

磁盘空间

创建时,工作区会为其包含的每个文件和目录添加 APFS 元数据。对于基准测试 fixture(约 1,700 个文件),这大约是 1.4 MB。数据块与 base 共享。

agent 工作之后,它修改的每个文件都会占用真实空间,因为 APFS 会复制发生变化的块。重写 500 MB 构建产物就要花 500 MB,一次重写 node_modules 的 npm rebuild 同样如此。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →