Shepherd的vcs-core面向可执行世界的溯源原生版本控制CoW分叉比docker commit快约5倍【免费下载链接】shepherdA runtime substrate that turns an agents execution into a reversible, Git-like trace, so meta-agents can observe, fork, replay, and revert any run. Couples agent and environments in a copy-on-write fork ~5x faster than docker commit, with ~95% KV-cache reuse on replay. Framework built for meta-agents to supervise, optimize, and train other agents项目地址: https://gitcode.com/gh_mirrors/shepherd16/shepherdShepherd是一个让元智能体Meta-Agent监督、优化和训练其他 Agent 的运行时基座而其核心模块vcs-core正是整套机制的底座它把 Agent 的每一次执行记录为可逆的、Git 风格的执行轨迹execution trace并基于写时复制CoWCopy-on-Write实现工作区分叉——比docker commit快约 5 倍重放时还能获得约 95% 的 KV-cache 复用。换句话说传统 Git 只管代码文本而 vcs-core 管理的是整个可执行世界文件、进程副作用、Agent 的运行历史全部可观察、可分叉、可重放、可回滚。为什么 Agent 需要“溯源原生”的版本控制 普通 Git 解决的是代码怎么变但 Agent 真正改变的是运行时状态装了什么依赖、改了哪些文件、生成了什么产物。传统做法是每跑一步就用docker commit给容器打个镜像快照问题很直接慢全量镜像提交动辄数秒到数十秒Agent 高频分叉如 best-of-N、自动重试时开销巨大黑盒镜像里没有这步是谁、为什么、基于哪个状态做出的这类溯源信息重放贵回滚后重跑模型侧缓存全部失效token 成本翻倍。vcs-core 的思路是把 Git 的溯源provenance思想下沉到执行层每个变更都挂在一条操作历史operation history上状态是纯增量的提交commit而不是整包快照。核心概念Store、Scope 与溯源历史 vcs-core 用一套裸 Git 仓库通过 pygit2作为存储层对外暴露三个关键概念概念类比 Git说明Store仓库对象库所有状态提交都落在一个裸 Git 仓库里天然不可变、可校验Scope分支一个隔离的工作区视野Agent 在其中自由修改Operation提交记录一次执行/变更的完整溯源单元含证据与前后状态底层实现集中在几个模块存储模型在 store.py协调与生命周期在 vcscore.py文件系统集成在 substrates.py代码地图见 ARCHITECTURE.md。与 Git 一样历史是原生的、可审计的vcs-core log会列出Init、ScopeMerge、DiscardSnapshot等结构化生命周期记录而不只是文件 diff——这就是溯源原生的含义。CoW 分叉如何做到比 docker commit 快约5倍 ⚡关键在写时复制分叉时不复制任何数据只建立指向基底的指针真正发生写入时才把被写的那一页或那个文件复制到上层。Linux基于内核 overlayfs 或 fuse-overlayfs 作为 CoW 后端见 _kernel_overlay.py 与 _fuse_overlay.pymacOS用 APFS clonefile 做 CoW 克隆见 _clonefile_carrier.py通用回退没有 CoW 后端时使用可移植的复制载体 _copy_carrier.py。对比之下docker commit需要把容器的整个联合文件系统差异层打包成新镜像层复杂度与体积随环境增长而 CoW 分叉的代价近似O(1)——这正是约 5 倍速度差的来源。更妙的是分叉出的工作区与基底共享底层内容Agent 从相同前缀状态重放时模型推理侧可以复用约 95% 的 KV-cache重放既快又省 token。3分钟上手init → 分叉 → 合并或丢弃 ✍️vcs-core 提供了完整的交互式隔离 shell 工作流详见 vcs-core/packages/core/README.mdvcs-core init . --adopt git-head --all # 初始化工作区接管 Git 状态 vcs-core session start # 启动会话守护进程 vcs-core session shell --scope task --create # 进入 CoW 隔离工作区 # —— 在隔离区里让 Agent 放手操作 —— vcs-core merge task # 满意把变更合并回主线 # vcs-core discard task # 不满意一键丢弃主线零污染 vcs-core session stop vcs-core push整个过程对 Agent 而言就是随便试试砸了就 discard。因为分叉便宜、丢弃免费元智能体可以放心地做 best-of-N 探索、失败重试和方案对比——每一条尝试都保留在溯源历史里随时可以复查或重放。安全与边界只管工作区不越界 ️工作区边界vcs-core 只管理初始化根目录内的状态主机环境的其他部分系统服务、全局包、云端 API是透传的不在可逆契约内见 vcs-core/README.md 的 Workspace Boundary 一节权限隔离Linux 上支持 Landlock/overlay 捕获可对会话命令做文件系统级取证--capture模式把每次命令的文件副作用关联到对应的 Operation 上测试充分fork / merge / discard / push全生命周期在真实 overlayfs/FUSE 后端上有集成测试覆盖目录见 tests/container/。谁适合用 vcs-core场景收益元智能体监督子 Agent观察、fork、重放、回滚任意一次 run高风险自动改代码试错免费失败即 discardAgent 训练与评估溯源轨迹 高 KV-cache 复用显著降低重放成本容器快照替代CoW 分叉替代docker commit速度快一个数量级入门建议先读 vcs-core/README.md 了解项目结构再跟 packages/core/README.md 的 store-first 路径走一遍make smoke5 分钟即可跑通第一个可逆执行循环。 一句话总结Git 记住了代码的历史vcs-core 记住了世界的历史——而 CoW 分叉让回到过去的成本几乎为零。【免费下载链接】shepherdA runtime substrate that turns an agents execution into a reversible, Git-like trace, so meta-agents can observe, fork, replay, and revert any run. Couples agent and environments in a copy-on-write fork ~5x faster than docker commit, with ~95% KV-cache reuse on replay. Framework built for meta-agents to supervise, optimize, and train other agents项目地址: https://gitcode.com/gh_mirrors/shepherd16/shepherd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考