Cloudflare Computer 实战教程容器里跑 pandoc 把 Markdown 变成 PDF5 步搞定【免费下载链接】computerGive your agent a computer 项目地址: https://gitcode.com/GitHub_Trending/computer1/computer概要Cloudflare Computer 是一个跑在 Durable Object 里的虚拟文件系统能把容器变成 Agent 的专属电脑。本实战带你用它的官方 tutorial 示例 走完完整流程在容器里跑 pandoc把 Agent 写好的 Markdown 一键转换成 PDF并通过 R2 签名链接分享出去。这个示例能做什么examples/tutorial 是一个菜谱卡片Agent你 POST 一道菜名比如spaghetti bologneseAgent 联网查菜谱在宿主机侧把 Markdown 卡片写入/workspace/card.mdAgent 通过bash在容器里执行pandoc把 Markdown 转成 PDFPDF 同步回宿主机文件系统上传 R2返回一个 24 小时有效的签名链接。关键点在于宿主机的write和容器里的pandoc操作的是同一个文件系统——没有任何拷文件的步骤。这正是 Cloudflare Computer 的核心能力。原理一个文件系统两个世界上图展示了它的分层结构Durable Object内部有一个 SQLite 存储它是文件系统的唯一真相源容器里的computerd守护进程把这份状态挂载为 FUSE 文件系统落在/workspace中间的Sync Protocol保证两边的视图一致宿主机写入的 Markdown容器里能当普通文件读pandoc生成的 PDF命令结束后也能同步回宿主机。这意味着 Agent 的文件工具写文件和 Shell 工具跑命令可以无缝接力——这正是给 Agent 一台电脑Give your agent a computer 的含义。第 1 步准备容器镜像DockerfileDockerfile 是理解容器里跑 pandoc的关键要点只有三条基础要求computerd必须是容器里的 PID 1ENTRYPOINT [/usr/local/bin/computerd]它负责挂载 workspace安装 pandoc 3.10 和 typsttypst 被选作 PDF 引擎因为它只是一个约 30 MB 的单文件二进制而安装 LaTeX 会让镜像膨胀几百 MB——这是生产环境选型的实用技巧FUSE_MOUNTauto在 Cloudflare Containers 上用真实内核 FUSE本地wrangler dev下自动回退到用户态 shim一个镜像两地通用。第 2 步给 Worker 配置三个绑定wrangler.jsonc 里只有三个核心绑定缺一不可绑定作用aiWorkers AI提供 Agent 用的模型containers为RecipeAgent这个 Durable Object 类配套一个容器每个实例一台私有 Linux 小盒子r2_buckets存放成品 PDF 的桶recipe-cards另外记得先把桶建出来wrangler r2 bucket create recipe-cardswrangler 不会代劳。第 3 步把 Workspace 接到 Agent 上在 src/index.ts 中Durable Object 通过withWorkspaceContainer混入容器生命周期并用CloudflareContainerBackend告诉 Workspace 你的文件就挂在这个容器里readonly #backend new CloudflareContainerBackend({ container: () this, workspace: { binding: RecipeAgent, id: this.ctx.id.toString() }, egress: { mode: direct }, // 容器需要联网查菜谱不需要网络时改为 none });egress: { mode: direct }显式保留容器的出站访问——Agent 要访问菜谱网站如果你的命令不需要网络用{ mode: none }更安全。第 4 步Agent 写 Markdown、容器跑 pandoc系统提示词getSystemPrompt把工具编排成四拍查 sitemap → 挑菜谱 → 写卡片 → 转 PDF。真正在容器里执行的转换命令只有一行pandoc /workspace/card.md -o /workspace/card.pdf --pdf-enginetypst宿主机写入的card.md经 FUSE 挂载出现在容器磁盘上pandoc像读本地文件一样读它命令结束card.pdf原路同步回来。全程零拷贝。第 5 步PDF 上传 R2返回签名链接card()方法在 Agent 回合完成后做两件事用createAssets把/workspace/card.pdf流式传到 R2 并签发一个 24 小时有效的 GET 链接然后finally里workspace.close()关掉一次性容器会话。桶保持私有、Worker 不碰文件字节、链接到期自动失效——分享链路非常干净。本地跑起来本地运行需要 Docker首次构建会拉取computerd基础镜像并安装 pandoc/typst。clone 仓库后git clone https://gitcode.com/GitHub_Trending/computer1/computer cd computer npm install npm run build --workspace cloudflare/computer npm run dev --workspace example/computer-tutorial然后发请求要一张卡片curl -X POST http://localhost:8787/prompt \ -H content-type: application/json \ -d {prompt:spaghetti bolognese}响应是 JSON一句总结 一个 R2 签名链接。注意第一次请求会比较慢——容器要先启动等computerd就绪后第一个bash才能真正执行。相关文件索引文件说明examples/tutorial/README.md从空目录逐段构建完整示例的官方教程examples/tutorial/src/index.ts单文件 Worker 实现Agent Workspace 分享链路examples/tutorial/Dockerfilepandoc typst 容器镜像定义examples/tutorial/wrangler.jsoncAI / Container / R2 绑定配置examples/container/README.md更底层的 write/read/exec HTTP 示例docs/19_performance.mdFUSE 文件系统性能基准数据小结这个示例用不到 150 行代码演示了 Cloudflare Computer 最核心的工作流Durable Object 管状态、容器跑真实二进制、FUSE 挂载让两边共享一个文件系统。当你想让 Agent 执行 pandoc、ffmpeg、node 这类真实 Linux 二进制时这套架构就是最直接的落地方案。想继续深入可以从 packages/computer 的 README 入手。【免费下载链接】computerGive your agent a computer 项目地址: https://gitcode.com/GitHub_Trending/computer1/computer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考