cloudflare/computer

Cloudflare 官方 AI Agent 计算环境 SDK，给 Agent 一台虚拟”电脑”。核心设计：SQLite 支撑的虚拟文件系统（Durable Object）+ 三个插拔式后端执行引擎，让 Agent 拥有文件读写、命令执行、代码解释三种能力。

核心架构

dofs (@cloudflare/dofs) — 权威数据源存储在 Durable Object 的 SQLite，暴露给三个后端去挂载/交互。支持 sync protocol、@platformatic/vfs provider for Node。

用户按需选择，通过 workspace.runtime.exec(source, { backend }) 调用：

后端	运行环境	特点	入场景景
Container	Sandbox 容器（真实 Linux）	完整 userland、真实二进制、真实网络。`computerd` daemon FUSE mount SQLite state，RPC 同步回 Durable Object	npm install、编译、运行本地工具链
Isolate shell	Dynamic Worker（Cloudflare Workers 轻量运行时）	just-bash 运行 shell 命令，Workers RPC 无第二数据源、无 sync 往返	快速 shell 脚本执行、无编译依赖的命令
Isolate JavaScript	Dynamic Worker	ESM 模块 + `node:fs/promises`（Workspace 支撑的假 fs）+ `ws:git`/`ws:artifacts` 模块	JavaScript/TypeScript 脚本、无需沙盒隔离、纯逻辑计算

RPC 层（capnweb）处理 Durable Object ↔ computerd / Dynamic Worker 通信。

包	职责
dofs	SQLite 虚拟文件系统本体 + sync protocol building blocks + Platformatic VFS provider
rpc	capnweb wire types + server/client 辅助（Durable Object ↔ computerd 通信契约）
computerd	FUSE daemon + HTTP/WebSocket RPC 服务器，运行在容器内
computer	顶层消费包（从 Durable Object 中使用），对外 API 入口
computer-computerd-linux-x64	预编译 Docker 镜像（私有），computerd 的发布物

示例	用途演示
container	`write` / `read` / `exec` HTTP surface，Container 后端挂载 Workspace
worker-shell	同样 HTTP surface，但用 just-bash 在 Dynamic Worker（无容器）
worker-javascript	Mirror worker-shell，但 `exec` 在 Dynamic Worker 里跑 ESM module
think	Agent 以 Workspace 作工作目录，从终端 reachable（@cloudflare/think chat agent）
think-compare-runtimes	Web UI 对比 container vs worker 后端在同一任务上的表现
tutorial	循序渐进：写 markdown → 在容器跑 `pandoc` → 生成 PDF
artifacts	在 Workspace 生成 Worker 项目 + 发布到 Cloudflare Artifacts 成 clone-ready repo
assets	用 Workers AI 生图 → 写进 Workspace → 返回 shareable link（@cloudflare/computer/assets 支撑）

fs-bench 对标：computerd FUSE mount 在 metadata-heavy 工作中超过真实磁盘，在大文件顺序 I/O 时略逊（见 docs/19_performance.md）
前向设计：docs/ 中的规范是 forward-looking，treat as intent not description
RPC 契约：docs/08_capnweb_interface.md 是 Durable Object ↔ computerd 的权威通信协议