Cloudflare Computer執(zhí)行追蹤器詳解并發(fā)exec狀態(tài)跟蹤的完整設(shè)計指南【免費下載鏈接】computerGive your agent a computer 項目地址: https://gitcode.com/GitHub_Trending/computer1/computerCloudflare Computer 是一個為 AI Agent 提供一臺計算機的開源項目Give your agent a computer 它把虛擬文件系統(tǒng)和可插拔的執(zhí)行后端封裝在 Durable Object 中。當(dāng)多個exec命令同時在不同后端容器、Worker Shell、Worker JavaScript上并發(fā)運行時系統(tǒng)如何準確跟蹤每個執(zhí)行execution屬于哪個運行時runtime答案就是ExecutionRuntimeTracker執(zhí)行追蹤器——本文帶你用最短的時間理解它的狀態(tài)跟蹤設(shè)計。Cloudflare Computer 的整體架構(gòu)Durable Object 持有權(quán)威狀態(tài)執(zhí)行面可插拔為什么并發(fā) exec 需要執(zhí)行追蹤器一個 Workspace 可以同時注冊多個后端workspace.runtime.exec()是唯一的執(zhí)行入口。每條命令執(zhí)行后系統(tǒng)會拿到一個executionId后端容器可能隨時被替換reconnect、重建。這時候有兩個經(jīng)典問題后續(xù)操作該發(fā)給誰對某條 exec 執(zhí)行killExec、disposeExec、拉取事件流getExec時必須確認它當(dāng)前所在的運行時運行時被換了怎么辦如果容器已重建舊 exec 已經(jīng)丟失系統(tǒng)要快速、明確地報錯而不是把命令發(fā)到錯誤的運行時上。執(zhí)行追蹤器就是為這兩個問題設(shè)計的記錄最近活躍的執(zhí)行 → 所屬運行時的映射關(guān)系。雙層結(jié)構(gòu)有界內(nèi)存 LRU SQLite 持久化追蹤器的核心實現(xiàn)非?？酥浦挥?100 行左右位于 execution-runtime-tracker.ts。層級實現(xiàn)作用內(nèi)存層Map實現(xiàn)的有界 LRU默認1024條快速命中避免無界增長持久層SqlExecutionRuntimeStoreSQLite 表computer_execution_runtimeDurable Object 重啟/緩存淘汰后恢復(fù)所有權(quán)幾個關(guān)鍵設(shè)計點LRU 淘汰#touch()方法在讀取時把條目重新插入到 Map 末尾利用 Map 的插入順序把最久未訪問的鍵淘汰——最近活躍的執(zhí)行永遠不會先被擠出去持久兜底內(nèi)存命中不了時回查 SQLite查到的映射會被回填進內(nèi)存緩存樂觀刪除delete(key, expectedRuntimeId)只有當(dāng)前值與期望的 runtimeId 一致時才真正刪除防止并發(fā)場景下晚到的舊操作誤刪新執(zhí)行剛寫入的映射。Workspace 構(gòu)造時這樣裝配追蹤器見 workspace.tsthis.#executionRuntimes new ExecutionRuntimeTracker( 1_024, new SqlExecutionRuntimeStore(this.#db), );一次并發(fā) exec 的完整狀態(tài)跟蹤流程整個閉環(huán)體現(xiàn)在 workspace.ts 的命令適配層中流程大致是exec 返回時記憶每條命令的返回信封envelope自帶runtimeId通過#rememberExecutionRuntime()寫入追蹤器鍵由JSON.stringify([backendId, executionId])組合天然區(qū)分不同后端下的同號執(zhí)行 ID后續(xù)操作前查表getExec/killExec/disposeExec先查追蹤器拿到期望的 runtimeId斷言校驗真正下發(fā)前assertExecutionRuntime()會把期望值與當(dāng)前運行時對比。若容器已被替換立即拋出WorkspaceExecutionLostError錯誤碼EEXEC_LOST明確告知這條執(zhí)行在運行時替換時丟失了清理收尾disposeExec成功后用帶期望值的樂觀刪除清理映射避免臟數(shù)據(jù)殘留。這樣即使緩存被淘汰、甚至 Durable Object 整體重建新的 Workspace incarnation持久層也能把誰屬于哪個運行時的信息恢復(fù)回來——測試用例 execution-runtime-tracker.test.ts 覆蓋了 LRU 淘汰、持久回退、跨實例恢復(fù)和樂觀刪除全部場景。設(shè)計亮點小結(jié)?有界內(nèi)存LRU 上限固定緩存占用不隨 Durable Object 生命周期無限增長?持久兜底SQLite 保證跨實例incarnation的所有權(quán)連續(xù)性?失敗即明確運行時不匹配時報EEXEC_LOST而不是靜默執(zhí)行到錯誤環(huán)境?并發(fā)安全樂觀刪除 鍵中攜帶后端 ID雙保險防并發(fā)誤操作。相關(guān)資料追蹤器實現(xiàn)packages/computer/src/execution-runtime-tracker.tsWorkspace 集成packages/computer/src/workspace.ts行為測試packages/computer/src/execution-runtime-tracker.test.ts運行時接口規(guī)范docs/05_runtime_interface.md同步協(xié)議含并發(fā)變更說明docs/02_sync_protocol.md可運行示例examples/container、examples/worker-shell【免費下載鏈接】computerGive your agent a computer 項目地址: https://gitcode.com/GitHub_Trending/computer1/computer創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考