Cloudflare Computer执行追踪器详解:并发exec状态跟踪的完整设计指南
Cloudflare Computer执行追踪器详解并发exec状态跟踪的完整设计指南【免费下载链接】computerGive your agent a computer 项目地址: https://gitcode.com/GitHub_Trending/computer1/computerCloudflare Computer 是一个为 AI Agent 提供一台计算机的开源项目Give your agent a computer 它把虚拟文件系统和可插拔的执行后端封装在 Durable Object 中。当多个exec命令同时在不同后端容器、Worker Shell、Worker JavaScript上并发运行时系统如何准确跟踪每个执行execution属于哪个运行时runtime答案就是ExecutionRuntimeTracker执行追踪器——本文带你用最短的时间理解它的状态跟踪设计。Cloudflare Computer 的整体架构Durable Object 持有权威状态执行面可插拔为什么并发 exec 需要执行追踪器一个 Workspace 可以同时注册多个后端workspace.runtime.exec()是唯一的执行入口。每条命令执行后系统会拿到一个executionId后端容器可能随时被替换reconnect、重建。这时候有两个经典问题后续操作该发给谁对某条 exec 执行killExec、disposeExec、拉取事件流getExec时必须确认它当前所在的运行时运行时被换了怎么办如果容器已重建旧 exec 已经丢失系统要快速、明确地报错而不是把命令发到错误的运行时上。执行追踪器就是为这两个问题设计的记录最近活跃的执行 → 所属运行时的映射关系。双层结构有界内存 LRU SQLite 持久化追踪器的核心实现非常克制只有 100 行左右位于 execution-runtime-tracker.ts。层级实现作用内存层Map实现的有界 LRU默认1024条快速命中避免无界增长持久层SqlExecutionRuntimeStoreSQLite 表computer_execution_runtimeDurable Object 重启/缓存淘汰后恢复所有权几个关键设计点LRU 淘汰#touch()方法在读取时把条目重新插入到 Map 末尾利用 Map 的插入顺序把最久未访问的键淘汰——最近活跃的执行永远不会先被挤出去持久兜底内存命中不了时回查 SQLite查到的映射会被回填进内存缓存乐观删除delete(key, expectedRuntimeId)只有当前值与期望的 runtimeId 一致时才真正删除防止并发场景下晚到的旧操作误删新执行刚写入的映射。Workspace 构造时这样装配追踪器见 workspace.tsthis.#executionRuntimes new ExecutionRuntimeTracker( 1_024, new SqlExecutionRuntimeStore(this.#db), );一次并发 exec 的完整状态跟踪流程整个闭环体现在 workspace.ts 的命令适配层中流程大致是exec 返回时记忆每条命令的返回信封envelope自带runtimeId通过#rememberExecutionRuntime()写入追踪器键由JSON.stringify([backendId, executionId])组合天然区分不同后端下的同号执行 ID后续操作前查表getExec/killExec/disposeExec先查追踪器拿到期望的 runtimeId断言校验真正下发前assertExecutionRuntime()会把期望值与当前运行时对比。若容器已被替换立即抛出WorkspaceExecutionLostError错误码EEXEC_LOST明确告知这条执行在运行时替换时丢失了清理收尾disposeExec成功后用带期望值的乐观删除清理映射避免脏数据残留。这样即使缓存被淘汰、甚至 Durable Object 整体重建新的 Workspace incarnation持久层也能把谁属于哪个运行时的信息恢复回来——测试用例 execution-runtime-tracker.test.ts 覆盖了 LRU 淘汰、持久回退、跨实例恢复和乐观删除全部场景。设计亮点小结✅有界内存LRU 上限固定缓存占用不随 Durable Object 生命周期无限增长✅持久兜底SQLite 保证跨实例incarnation的所有权连续性✅失败即明确运行时不匹配时报EEXEC_LOST而不是静默执行到错误环境✅并发安全乐观删除 键中携带后端 ID双保险防并发误操作。相关资料追踪器实现packages/computer/src/execution-runtime-tracker.tsWorkspace 集成packages/computer/src/workspace.ts行为测试packages/computer/src/execution-runtime-tracker.test.ts运行时接口规范docs/05_runtime_interface.md同步协议含并发变更说明docs/02_sync_protocol.md可运行示例examples/container、examples/worker-shell【免费下载链接】computerGive your agent a computer 项目地址: https://gitcode.com/GitHub_Trending/computer1/computer创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

API 稳定性与供应商风险:从连接报错到 Anthropic IPO 的工程思考

API 稳定性与供应商风险:从连接报错到 Anthropic IPO 的工程思考

周五下午,我在一个自动化任务里连续看到三次 unable to connect to anthropic services ,切到浏览器想查状态页,第一屏反而是“Anthropic 考虑 IPO 允许内部人分批套现”的新闻。两个信息放在一起,有点荒诞,但恰好是…

2026/11/3 4:43:45 阅读更多 →
多智能体安全实战:如何防止“GO”指令覆盖“停止”状态

多智能体安全实战:如何防止“GO”指令覆盖“停止”状态

多智能体系统正在快速从论文走向生产环境。但 OpenAI 对一次 AI 智能体攻击 Hugging Face 平台事件的安全复盘,暴露了一个容易被忽视的问题:多个智能体协同执行任务时,真正危险的可能不是“模型能力过强”,而是控制信号互相冲突时…

2026/10/26 12:42:36 阅读更多 →
lightningpixel/modly解析:AI绘画与模型微调的模块化工程实践

lightningpixel/modly解析:AI绘画与模型微调的模块化工程实践

作为一个经常在 GitHub 上逛开源项目的开发者,我最近反复看到 lightningpixel 和 modly 两个名字出现在 AI 绘画和模型微调相关的讨论里。这两个词组合在一起,既像是一个组织名称,又像是一套工具链的代号。但问题来了:很多人看…

2026/10/26 12:42:37 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻