SuperAPI AI 工具集

examples

编程与开发

查看项目

更新于 10-15 19:50

技能介绍

用途:examples/ 目录收录可端到端运行 Sandbox SDK 的示例应用,既作为集成冒烟测试,也作为用户参考材料。

运行方式:进入某个示例目录(如 examples/minimal/)后执行 npm run dev,启动 wrangler dev;首次运行会构建 Docker 镜像,因此较慢,之后会复用镜像,除非 SDK 或 Dockerfile 发生变化。若改动了容器运行时或 SDK,需先在仓库根目录执行 npm run docker:rebuild,再运行 npm run dev。

示例清单:minimal(最小 Sandbox SDK 配置)、authentication(带鉴权的沙箱访问)、claude-code(在沙箱内运行 Claude Code)、code-interpreter(CodeInterpreter API + Workers AI)、codex / codex-app-server(OpenAI Codex 集成模式)、collaborative-terminal(多用户终端共享)、openai-agents(OpenAI Agents SDK + Sandbox)、opencode(OpenCode 集成)、time-machine(快照/恢复模式)、typescript-validator(对用户代码运行 tsc)、vite-sandbox(通过预览 URL 代理 Vite 开发服务器)、websocket-tunnel(WebSocket 传输/端口暴露)、alpine(基于 Alpine 的容器变体)。

EXPOSE 指令:Cloudflare 容器原语不要求 EXPOSE,本地开发与生产环境所有端口均可访问。示例 Dockerfile 中仍建议保留 EXPOSE,用于记录应用使用的端口(Docker 惯例),不要指望它控制访问。

新增示例:复制 examples/minimal/ 作为起点;更新 package.json 名称及 wrangler 配置(wrangler.jsonc)中的类名、DO 绑定、容器镜像标签;添加带 # H1 标题的 README.md(README 扫描器会读取该标题)并简述示例内容;确保示例可构建且干净检出后 npm run dev 可用;若展示新 SDK 能力,请在 packages/sandbox/README.md 中链接。

本地开发提示:示例通过 workspace 链接 @cloudflare/sandbox,SDK 改动需在仓库根目录执行 npm run build 后生效;容器改动需 npm run docker:rebuild 才生效;若遇到镜像陈旧问题,可删除容器镜像(docker images | grep sandbox)后重新运行 npm run dev。