shipwords-dev/shipwords

shipwords 是一个 MIT 许可的 TypeScript 框架，用于在 Cloudflare 上运营一组“一个关键词一个站”的 AI 图片和视频站点。共享部分——账户、支付、积分和生成运行时——在核心包里只写一次；每个站点保留自己的页面、外观、域名、数据库、存储和支付账户，并独立部署，因此上线或下线一个站不会影响其他站 shipwords README。

一个站点包含什么

每个站点是运行在独立 Cloudflare Worker 上的 TanStack Start + React 19 应用，使用 D1、R2 和 Workflows。仓库自带的模板（templates/ai-site）就是一个可用的 AI 图片站，含首页、定价、账户、登录、政策页以及 sitemap.xml、robots.txt、llms.txt。tinydeskai.io 的完整源码也作为视频效果示例提供：上传照片填入模板槽位，一遍完成整段视频替换；如果原始人脸仍残留，任务判定失败并退回积分 README、示例站点源码。

共享核心如何运作

packages/core 包含 D1 + Drizzle、幂等积分账本、Stripe 与 PayPal 计费（积分包、订阅、退款、争议）、Better Auth、带 reCAPTCHA v3 的访客配额、SEO/GEO 辅助和统计代理。packages/jobs 是基于 Workflow 的生成运行时，带单向任务状态机、失败任务自动退款、上游适配器接口、Yir 适配器和本地 mock 上游。README 称重复扣款、重复或乱序的支付事件以及退款均有测试覆盖 README。

两种起步路径及各自条件

文档中的主要方式是脚手架：pnpm new-site <dir> --domain <domain>，然后把本地密钥放在仓库外并链接进来，执行本地 D1 迁移并 pnpm dev。要求 Node 24、pnpm 10，Windows 上还需 Git Bash 或 WSL README 快速开始。模板默认使用 mock 上游，邮箱登录验证码会打印在终端，所以本地开发不需要模型密钥。真实生成需要 Yir API key；收款需要 Stripe 测试 key 并运行 webhook 转发脚本；访客免费试用需要 reCAPTCHA 密钥，没有它则访客必须先登录。Google 登录是可选的。正式上线还需要 Cloudflare 账户以及 Stripe 或 PayPal 账户 README。

README 还记录了 Agent 辅助路径：把关键词交给 Claude Code、Codex 或 Cursor，读取 shipwords.dev/llms.txt 并遵循 AGENTS.md 规则。这依赖 AI 编程 Agent，是脚手架之外的替代方式，而非所有路径的必需条件 README、Agent 规则。

成本与边界

代码在 MIT 下免费，允许商业使用，但域名、Cloudflare 用量、支付手续费和按请求计费的模型调用需要自付；每个任务的模型成本上限在 site.models.ts 中设置。需要拼接视频片段的站点使用 Cloudflare Containers，并要求 Workers 付费计划 README 成本说明。README 中的可靠性和测试覆盖说法来自作者，材料中没有独立验证。