TinyShip
TinyShip
 TinyShip
TinyShip
TinyShip 文档中心
TinyShip 用户指南快速开始Recipes(产品配方)基础配置
积分系统配置指南返利系统配置指南
存储服务配置数据库配置验证码配置
开发最佳实践本地 E2E 测试流程
用户指南

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-imageAI 生图站复用 /image-generate + 积分 + 套餐
ai-videoAI 视频站复用 /video-generate + 积分 + 套餐;生成失败退回积分
ai-chatAI 对话 / 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):

  1. 首页是你的产品定位,而不是 TinyShip 三框架宣传语
  2. 主 CTA 落到配方约定的页面(如生图、提交条目、注册、产品详情)
  3. 该隐藏的演示入口在 header / footer(含移动端)都已去掉,路由文件仍保留
  4. 登录 / 注册页标题用产品名
  5. 复杂配方:配方要求的页面能打开,迁移与 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。

快速开始

在本地环境中设置和运行 TinyShip 项目

基础配置

应用名称、Logo、主题系统和国际化配置

On this page

设计理念安装与触发已有配方各配方简介ai-imageai-videoai-chatmembership-contentwaitlistdirectorydigital-product怎么用(验收要点)和其它 skill 怎么分工