Cloudflare Computer本地验证三件套：run-harness、run-computerd与wrangler dev
Cloudflare Computer本地验证三件套run-harness、run-computerd与wrangler dev【免费下载链接】computerGive your agent a computer 项目地址: https://gitcode.com/GitHub_Trending/computer1/computerCloudflare Computer 让 AI Agent 拥有一台虚拟电脑SQLite 驱动的虚拟文件系统VFS 容器内守护进程 computerd Worker 侧运行时。想动手改代码或跑通示例本地验证三件套——run-harness.sh、run-computerd.sh 与 wrangler dev——就是最短路径。本文带你快速看懂三者的分工5 分钟内跑通端到端验证。三件套分工谁负责什么 工具位置职责run-computerd.shpackages/computer/test-harness/run-computerd.sh拉起真实的 computerd Docker 容器挂载 FUSE轮询/health后打印可访问 URLrun-harness.shpackages/computer/test-harness/run-harness.sh编排整个流程先启动容器再把 URL 注入 Worker 绑定最后跑 vitest 集成测试wrangler dev各 examples 的dev脚本在本地 Miniflare 中运行 Worker Durable Object Container供你交互式开发一句话概括run-computerd 负责起服务run-harness 负责跑测试wrangler dev 负责日常开发。第一步run-computerd.sh 快速拉起真实 daemon run-computerd.sh 做四件事检查docker可用、computerd-linux-x64二进制已构建缺了会提示先跑npm run build:bin自动构建一个预装libfuse2的中间镜像computerd-harness:libfuse2以特权模式启动容器--device /dev/fuseSYS_ADMIN让 computerd 真正完成 FUSE 挂载随机映射宿主机端口每 0.5 秒轮询http://127.0.0.1:port/health健康即输出 URL。设计亮点URL 走 stdout容器 ID 走 stderr方便上层脚本一边捕获地址、一边记录容器号用于清理。第二步run-harness.sh 一键跑通端到端测试 ✅在 packages/computer 目录下执行npm run test:harness # 默认 run 模式 npm run bench:harness # bench 模式压测run-harness.sh 的编排逻辑非常清晰调run-computerd.sh拿到地址写入环境变量COMPUTERD_HARNESS_URL由 vitest 配置注入 Worker 绑定用trap监听 EXIT/INT/TERM任何退出路径都会docker kill容器不留垃圾若本机没有 Docker则优雅降级为跳过容器直接跑测试不会让无 Docker 的开发者卡住。测试 Worker 本身由 packages/computer/test-harness/wrangler.jsonc 定义Workspace 跑在 Worker 内Durable ObjectTestStorageDO为每个测试提供全新的ctx.storage见 test-harness-worker.ts而 computerd 容器则是兄弟进程通过 URL 互通——这正是生产架构的本地镜像。第三步wrangler dev 做交互式本地开发 三件套之外日常写示例代码靠wrangler dev。每个 examples 都把dev脚本定义为wrangler dev例如 examples/containercd examples/container npm run dev # 终端 1本地 Miniflare默认 http://127.0.0.1:8787 ./script/run # 终端 2四步 smoke testscript/run 是一个极佳的本地验证范本四步闭环证明文件 API 与容器内 exec 看到的是同一棵树通过文件 HTTP APIPUT写文件在容器内cat读回验证 API 写入对 exec 可见在容器内echo写文件再通过 APIGET读回验证 exec 写入对 API 可见。双向 round-trip 全绿即输出OK — both directions round-tripped through the VFS.关键细节同一镜像为何两种环境都能跑 这是本地验证能如此顺滑的核心computerd 镜像通过环境变量FUSE_MOUNTauto自动探测——Cloudflare Containers生产/dev/fuse可达走真实内核 FUSE 后端wrangler dev本地无/dev/fuse透明降级为用户态 shim。一份 Dockerfile 同时覆盖开发与生产见 examples/container/Dockerfile 与 docs/01_vfs.md。类似地docs/12_worker_backend.md 提醒了wrangler dev日志中 just-bash 的 PATH 探测会产生 Uncaught 噪音这属于正常诊断输出不必惊慌。常见卡点速查 ⚡现象原因与解法computerd binary not found先执行npm run build:bin --workspace cloudflare/computerd容器起不来 / FUSE 报错确认 Docker 可用且支持特权容器脚本依赖libfuse2中间镜像本机无 Dockerrun-harness.sh会自动跳过容器单测照常跑测试后端口残留脚本已用trap兜底docker kill可docker ps -a复查小结 验证computerd 本体直接用 run-computerd.sh秒级拿到健康实例验证Worker computerd 全链路npm run test:harness一键完成容器自动清理验证示例应用行为wrangler dev examples/container/script/run 的四步 smoke test。掌握这三件套你就能像项目维护者一样在本地快速、可信地验证 Cloudflare Computer 的每一次改动。【免费下载链接】computerGive your agent a computer 项目地址: https://gitcode.com/GitHub_Trending/computer1/computer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考