multiworker-gotchas - 避免 Cloudflare 多 Worker 项目的常见陷阱
提供 Cloudflare 多 Worker 应用的开发约定与排错指南，涵盖绑定、生成文件、路由、D1、Durable Objects、HMR 和 SSR。
标签
更新于: 2026-09-28能力
典型输入
典型输出
该技能可以做什么
- 检查 Worker 绑定导入
- 管理生成的数据库文件
- 导出类型化路由路径
- 重新生成并验证类型
- 检查表单操作模式
- 配置 Alchemy 与 D1
- 排查过期本地状态
- 集成 Durable Object 包
- 转发 WebSocket 升级
- 遵守 SSR 浏览器边界
输入
- 仓库源文件
- Worker 绑定和环境变量
- 路由与架构变更
- Alchemy 与部署配置
- Durable Object 包变更
输出
- 实现指导
- 生成的类型文件
- 生成的迁移文件
- 类型检查与 lint 结果
- 部署排错指导
要求
- Bun 工具链
- Cloudflare Workers 项目
- Alchemy 与 D1 配置
- React Router 应用栈
- 适用时的 Durable Objects 支持