Recipes(产品配方)
用 tinyship-recipe 把 TinyShip starter 塑成具体 SaaS 产品
用 tinyship-recipe 把 starter 塑成一个具体产品(生图站、视频生成站、导航站、数字产品售卖站、waitlist 等)。它是 playbook,不是仓库里再放一套硬子模版。
设计理念
每多一个「子模版」,三个框架就要各维护一份,主模版一更新就容易过时。所以:
- Skill 里定死契约:表结构、迁移名、积分扣费规则、导航隐藏/保留、验收检查
- 实现交给 agent:首页文案、页面细节、品牌相关按你的产品改
- 复用现有模块:鉴权、支付、积分、AI 页面等,不重复造轮子
框架(Next / Nuxt / TanStack)和数据库(PG / SQLite / D1)仍由你或 tinyship-setup 选,recipe 不替你选。
安装与触发
与其它 Agent Skills 相同:
npx skills add TinyshipCN/tinyship-skills对 AI 说例如:
- 「用 recipe 做导航站」
- 「做 AI 生图站」
- 「做一个 AI 视频生成站」
- 「做一个 waitlist」
- 「做数字产品售卖站」
- 「用 TinyShip 快速创建模版」
会走 tinyship-recipe 交互式向导:先认项目 → 选配方 →(必要时)setup → 问范围/品牌/文案 → 应用 → 验收。
已有配方
| ID | 产品 | 说明 |
|---|---|---|
ai-image | AI 生图站 | 复用 /image-generate + 积分 + 套餐 |
ai-video | AI 视频站 | 复用 /video-generate + 积分 + 套餐;生成失败退回积分 |
ai-chat | AI 对话 / GPT wrapper | 复用 /ai + 积分 + 套餐 |
membership-content | 付费会员内容 | 复用博客、定价、高级会员页 |
waitlist | 预发布注册 | 主打注册;隐藏支付与演示入口 |
directory | 导航 / 目录站 | 新表 + 提交/审核;积分上架与广告位 |
digital-product | 数字产品售卖站 | 多产品目录;真钱 one_time 购买 + 下载权;v1 无 license |
复杂配方(如 directory、digital-product)会新建表与页面,并带验收脚本;简单配方主要是改导航与文案、指向已有能力。
各配方简介
ai-image
AI 生图站。用户登录后在 /image-generate 花积分出图,再通过套餐充值。导航隐藏其它演示入口,突出「生成」。应用后用 tinyship-ai 配置生图服务商密钥。
ai-video
AI 视频站,模式同上,主页面是 /video-generate。需要较新的 starter:视频任务存入 ai_video_task 表(项目里有 libs/ai/video-task-service.ts),这样生成失败才能退回积分。项目太旧时,配方会停下来,提示你先更新 starter。
应用后用 tinyship-ai 配置视频服务商密钥(FAL_API_KEY、QWEN_API_KEY 或 VOLCENGINE_ACCESS_KEY_ID)。模型与按模型计费见 AI 视频生成配置。
配方只做最小可用版本:一个生成页 + 积分 + 套餐。结束时 agent 会列出可选扩展(「我的视频」列表、任务详情页、后台视频列表、失败提示文案),你说要才做。
ai-chat
AI 对话 / GPT wrapper。复用 /ai + 积分 + 套餐;导航突出「对话」,隐藏生图/视频等演示入口。应用后用 tinyship-ai 配置对话模型密钥。
membership-content
付费会员内容站。博客公开可读,付费套餐解锁会员页(如 /premium-features)。主 CTA 指向 /pricing;导航保留博客与定价。支付用 tinyship-payment 配置。
waitlist
预发布注册站。注册本身就是名单(Better Auth,不再单独建 waitlist 表);导航隐藏定价与演示入口。产品正式上线后再换别的 recipe。
directory
导航 / 目录站(复杂配方)。首页变成条目列表;登录用户提交、管理员审核;用积分买上架与广告位。会新建表、迁移和验收脚本,并带后台 Directory 入口。
digital-product
数字产品售卖站(复杂配方)。多产品目录;详情页真钱 one_time 下单;交付是购买凭证 + 文件下载(v1 不含 license key)。导航隐藏定价、Demos、博客。会新建表,并在约定的支付挂钩点发货/撤销;不改各个 payment provider。验收用假订单,不打真实支付通道。
怎么用(验收要点)
应用完成后,在运行中的站点检查(中文默认与 /en):
- 首页是你的产品定位,而不是 TinyShip 三框架宣传语
- 主 CTA 落到配方约定的页面(如生图、提交条目、注册、产品详情)
- 该隐藏的演示入口在 header / footer(含移动端)都已去掉,路由文件仍保留
- 登录 / 注册页标题用产品名
- 复杂配方:配方要求的页面能打开,迁移与 seed 按文档跑通
Logo 文案可能仍是 TinyShip,那是 tinyship-brand 的事,不算 recipe 失败。
和其它 skill 怎么分工
| 需求 | Skill |
|---|---|
| 环境、数据库、框架清理 | tinyship-setup |
| 应用名、Logo、主题 | tinyship-brand |
| OAuth / 短信 | tinyship-auth |
| 支付提供商 | tinyship-payment |
| AI 提供商密钥 | tinyship-ai |
| 塑成某类产品 | tinyship-recipe |
| 全新业务表/页面 | tinyship-feature |
| 部署 | tinyship-deploy / tinyship-cloudflare |
更完整的产品方向见 路线图;版本说明见更新日志 2.7.0。