cloudflare/computer

Give your agent a computer 👾

這是什麼

Cloudflare Computer 想解決的是：當 AI agent 或自動化程式需要「一台電腦」時，狀態、檔案與執行環境要怎麼穩定地接在一起。它的核心是一個存在於 Durable Object 裡的 虛擬檔案系統，權威狀態存放在 SQLite，外部透過 Workspace 讀寫檔案，並用 workspace.runtime.exec(source, { backend }) 作為統一執行入口。README 提到目前有三種 backend：Container 會把 SQLite 狀態投影成 sandbox container 裡的 FUSE mount，可使用完整 Linux userland；Isolate shell 則在 Dynamic Worker 中跑 just-bash；Isolate JavaScript 則在新的 Dynamic Worker 執行 ECMAScript module，並提供 Workspace-backed node:fs/promises、相對 import、以及可信的 ws:git、ws:artifacts 模組。換句話說，它不是單純的遠端 shell，而是在 Cloudflare 平台上把 持久檔案狀態 與 可插拔執行面 包成一個 Workspace。

為什麼上榜

這個專案以日榜第 1 名被選中，累積約 2,854 stars，今日新增約 796 stars，熱度非常集中。它會引人注意，主要是因為「給 agent 一台 computer」正好踩中現在 AI 工具鏈的痛點：agent 不只要聊天，還要能寫檔、跑命令、產出 artifacts，並在任務之間保留狀態。Cloudflare Computer 的差異點在於它把狀態放在 Durable Object / SQLite 裡，再讓 container、shell isolate、JavaScript isolate 以同一個 Workspace 介面存取，避免每種 runtime 都各自管理一份資料。值得注意的是 README 也明確標示這是 PREVIEW ONLY，API 不穩定、設計可能改變，適合實驗、探索與 prototype，不適合 production；這種「方向很清楚但仍在早期」的定位，也讓它更像是 Cloudflare 對 agent runtime 的公開設計草案。

適合誰，可以拿來做什麼

它最適合正在研究或建構 AI agent 執行環境、Cloudflare Workers / Durable Objects 應用、或需要把檔案系統與 sandbox runtime 串起來的開發者。README 的 examples 顯示，它可以用來做具備 write / read / exec HTTP 介面的 Worker workspace、比較 container 與 worker runtime 的 agent 任務、讓 @cloudflare/think chat agent 使用 workspace 當工作目錄，甚至產生 Worker project 並發布到 Cloudflare Artifacts。若你的情境需要完整 Linux 工具鏈，Container backend 比較接近真實機器；若想避開 container，Isolate shell 與 Isolate JavaScript 則提供較輕量的執行路徑。不過，上手門檻不低：你需要理解 Cloudflare Durable Objects、Workers、Dynamic Worker，以及至少一部分 sandbox / RPC / FUSE 的概念。

上手

README 本身沒有把完整安裝指令直接寫在主頁，而是要求要使用者安裝 @cloudflare/computer，並前往 packages/computer/README.md 查看安裝步驟、entrypoint map，以及 fs / runtime 的實作範例。因此這裡不硬補不存在的指令。主 README 建議的入口是：先看 package README，再從 examples/ 中挑一個可執行 consumer；其中 container、worker-shell、worker-javascript 都提供類似的 write / read / exec HTTP surface，可用來比較不同 backend 的行為。若是貢獻者，則需依 CONTRIBUTING.md、COLLABORATORS.md，以及 agent 相關的 AGENTS.md 與 .agents/skills/ 進入專案流程。

README 重點摘要

• Cloudflare Computer 的權威檔案狀態存於 Durable Object + SQLite，Workspace 可以單獨作為檔案系統使用，也可以接 runtime backend。
• 目前提供三類 backend：Container、Isolate shell、Isolate JavaScript；三者都透過 workspace.runtime.exec 這個單一入口執行。
• examples/ 涵蓋 container、worker shell、worker JavaScript、@cloudflare/think agent、runtime 比較 UI、tutorial、artifacts、assets 等實例。
• repo 是小型 monorepo，包含 @cloudflare/dofs、@cloudflare/computer-rpc、@cloudflare/computerd、@cloudflare/computer 等 package。
• README 明確提醒這是 preview：文件中的 docs/ 偏向前瞻設計意圖，API 與實作狀態仍可能變動。