技术规划
产品路线图
TinyShip 项目未来发展计划和里程碑
本文档概述了 TinyShip 项目的未来发展计划和里程碑。
✅ 已完成功能
v1.2.0 - Fumadocs 文档站点 ✅
构建了一个基于 Fumadocs 的独立文档站点应用，作为 monorepo 中的新子站点。
已实现功能：
- ✅ 文档中心：完整的项目文档、API 参考和使用指南
- ✅ 博客系统：技术博客、更新日志和最佳实践分享
- ✅ 全文搜索：支持快速搜索文档内容
- ✅ 深色模式：与主站点一致的主题切换
- ✅ 响应式设计：完美适配移动端和桌面端
- ✅ 多语言支持：中英文文档同步更新
v1.3.0 - 统一云存储服务 ✅
支持多云存储服务，提供统一的文件上传和管理接口。
已支持的服务商：
- ✅ 阿里云 OSS - 国内市场首选
- ✅ AWS S3 - 国际市场标准
- ✅ Cloudflare R2 - 高性价比选择
已实现功能：
- ✅ 文件上传/下载
- ✅ 签名 URL 生成
- ✅ 元数据管理
- ✅ 目录列表
v1.4.0 - AI 时代积分支付系统 ✅
引入完整的积分支付系统，支持传统订阅与 AI 时代流行的积分模式并行运行。
已实现功能：
- ✅ 双重付费模式：传统按时间订阅 + 一次性积分充值
- ✅ 积分消耗系统：支持固定消耗和动态消耗（按 token）两种模式
- ✅ AI 模型乘数：不同 AI 模型可配置不同的积分消耗系数
- ✅ 完整交易追踪：详细的积分交易记录，支持分页查询
- ✅ Dashboard 集成：独立的积分状态标签页
- ✅ Pricing 页面优化：Tab 切换区分订阅和积分计划
v1.5.0 - AI 图片生成与功能增强 ✅
引入完整的 AI 图片生成能力，增强积分系统支持图片生成，改进 Logo 配置，并更新核心依赖。
已实现功能：
- ✅ AI 图片生成：支持多个 AI 提供商（Qwen、FAL、OpenAI）
- ✅ 积分定价系统：图片生成支持按模型配置积分成本
- ✅ 增强积分系统：统一积分系统支持聊天和图片生成
- ✅ Logo 配置增强：集中化 Logo 配置，支持自定义图标、完整 Logo 和 CSS 类
- ✅ 依赖更新：better-auth 1.4.10、vee-validate 5.0.0-beta.0
v1.6.0 - 支付宝支付支持 ✅
新增支付宝支付支持，完善中国市场支付接入能力。
已实现功能：
- ✅ 支付宝提供商：新增支付提供商实现并接入支付工厂与类型系统
- ✅ 支付能力：支持单次付费与积分充值（不支持订阅付费）
- ✅ Webhook 集成：Next.js 与 Nuxt.js 均已接入支付宝回调处理
- ✅ 沙盒与生产环境：支持网关切换与完整联调
- ✅ 文档与界面更新：仪表盘、管理端与支付文档同步更新
v1.7.0 - PayPal 支付支持 ✅
新增 PayPal 支付支持，强化国际市场支付能力。
已实现功能：
- ✅ PayPal 提供商：新增 PayPal 支付提供商实现并接入工厂与类型系统
- ✅ 双支付模式：支持单次付费（Orders + Capture）与循环订阅（Subscriptions）
- ✅ Webhook 与 Return URL：完成支付与订阅事件处理链路
- ✅ 沙盒环境支持：支持完整沙盒测试与生产环境配置
- ✅ 文档与界面更新：支付文档、订单展示与支付成功流程同步更新
v1.8.0 - AI 视频生成 ✅
新增 AI 视频生成功能，补齐 AI 页面在“对话 + 图片”之外的视频生成能力。
已实现功能：
- ✅ AI 视频生成页面：新增
/video-generate - ✅ 双模式输入：支持文生视频与首帧图片生视频
- ✅ 多提供商支持：Volcengine / 阿里云万相 / FAL (Kling)
- ✅ 积分计费接入：支持按模型配置视频生成积分成本
2026 Q1 - Q2
AI 功能扩展
在现有聊天功能的基础上，扩展更多 AI 使用场景示例：
| 场景 | 描述 | 技术方案 | 状态 |
|---|---|---|---|
| 智能对话 | 基础聊天功能增强，支持上下文记忆 | Vercel AI SDK + 多模型支持 | 进行中 |
| AI 图像生成 | 文本描述生成图像 | Qwen / FAL / DALL-E | ✅ 已完成 |
| AI 视频生成 | 文本或首帧图片生成视频 | Volcengine / 阿里云万相 / FAL (Kling) | ✅ 已完成 |
| 图像分析 | 上传图片进行内容识别和描述 | GPT-4 Vision / Claude Vision | 规划中 |
| 语音转文字 | 音频文件转录为文本 | Whisper API | 规划中 |
| 文字转语音 | 文本生成自然语音 | OpenAI TTS / ElevenLabs | 规划中 |
更多支付网关（已完成）
扩展支付能力，覆盖更多市场需求：
已新增支付方式：
- 支付宝：单次付费
- PayPal：一次性付款 + 循环订阅
现有支付方式：
- Stripe（国际信用卡，一次性付款 + 循环订阅）
- 微信支付
- Creem 支付（一次性付款 + 循环订阅）
文档站点化
将项目文档从仓库迁移至线上可访问的文档站点：
核心目标：
- 权限管理：部分文档可设置访问权限
- 在线访问：用户无需克隆仓库即可阅读
- 更好的阅读体验：专业的文档展示界面
- 实时更新：文档变更自动部署
文档分类：
| 类型 | 访问权限 | 说明 |
|---|---|---|
| 快速开始 | 公开 | 项目介绍和基础使用 |
| 用户指南 | 付费用户 | 详细功能说明 |
| API 参考 | 付费用户 | 接口文档 |
2026 Q3 - Q4
完整视频教程系列
制作完整的视频教程系列，从基础使用到高级定制，帮助开发者快速掌握 TinyShip 的各项功能和最佳实践。
入门教程
| 序号 | 主题 | 时长（预估） | 内容要点 |
|---|---|---|---|
| 01 | 项目介绍与环境搭建 | 15min | 项目结构、依赖安装、开发环境配置 |
| 02 | 快速启动你的第一个应用 | 20min | 创建页面、路由配置、基础组件 |
| 03 | 认证系统入门 | 25min | 邮箱注册、社交登录、会话管理 |
| 04 | 数据库基础操作 | 20min | Drizzle ORM、数据模型、CRUD 操作 |
| 05 | UI 组件库使用 | 20min | shadcn/ui、Magic UI、主题定制 |
| 06 | 国际化配置 | 15min | i18n 设置、多语言切换、翻译管理 |
进阶开发
| 序号 | 主题 | 时长（预估） | 内容要点 |
|---|---|---|---|
| 07 | 支付系统集成 | 30min | Stripe、微信支付、订阅管理 |
| 08 | 权限系统详解 | 25min | RBAC、CASL 配置、资源级权限 |
| 09 | 邮件与短信服务 | 20min | 多提供商配置、模板定制、发送策略 |
| 10 | AI 功能开发 | 30min | Vercel AI SDK、流式响应、多模型支持 |
| 11 | 文件存储与管理 | 25min | 云存储配置、上传组件、CDN 加速 |
部署指南
| 序号 | 主题 | 时长（预估） | 内容要点 |
|---|---|---|---|
| 12 | Vercel 部署 | 20min | 环境变量、域名配置、自动部署 |
| 13 | Docker 容器化部署 | 25min | Dockerfile、docker-compose、镜像优化 |
| 14 | 自托管服务器部署 | 30min | Nginx 配置、PM2 管理、SSL 证书 |
| 15 | 数据库部署与迁移 | 20min | PostgreSQL 部署、数据迁移、备份策略 |
| 16 | CI/CD 自动化 | 25min | GitHub Actions、测试、自动发布 |
视频特色：
- 项目驱动，边学边练
- 最佳实践和避坑指南
- 完整源码和学习资源
- 配套社区答疑支持
更新日志
| 日期 | 版本 | 更新内容 |
|---|---|---|
| 2026-02-24 | v1.8.0 | 新增 AI 视频生成能力 |
| 2026-01-29 | v1.7.0 | 新增 PayPal 支付支持（单次付费 + 循环订阅） |
| 2026-01-28 | v1.6.0 | 新增支付宝支付支持（单次付费） |
| 2026-01-10 | v1.5.0 | 标记 v1.5.0 AI 图片生成完成 |
| 2025-12-29 | v1.4.0 | 标记 v1.4.0 积分系统完成 |
| 2025-12-26 | v1.3.0 | 标记 v1.3.0 云存储完成 |
| 2025-12-23 | v1.2.0 | 标记 v1.2.0 Fumadocs 完成 |
| 2025-12 | v0.1 | 初始 Roadmap 创建 |
注意：本 Roadmap 仅代表当前规划，具体实现时间和功能可能会根据实际情况进行调整。