简介
探索 MuseMVP，轻松开启你的第一个产品之旅！🎉
欢迎查阅 MuseMVP 官方文档。这里是你了解项目结构、核心特性以及如何基于本项目开发应用的起点。
什么是 MuseMVP？
MuseMVP 这个名字来源于 Muse（灵感）与 MVP（最小可行性产品）。我们希望这套全栈启动套件 (Starter Kit) 能够帮助独立开发者和小团队用更少的配置，快速将灵感落地为可上线的个人产品 MVP。
旨在帮助开发者快速构建带有用户认证、持续付费、AI 对话及内容管理 (CMS) 等常见功能的现代 Web 产品。 通过在架构设计上保持平台无关性，MuseMVP 允许你在不修改任何业务逻辑的前提下，将同一套代码部署到不同的计算平台，从而避免平台锁定 (Vendor Lock-in)。
核心理念
MuseMVP 遵循以下设计原则：
- AI 友好 (AI Native) - 项目目录和代码组织方式专为 LLM 优化。使得 Cursor 或 Copilot 等 AI 工具能更快地理解应用上下文，辅助生成业务逻辑。
- 随处部署 (Deploy Anywhere) - 保持架构的灵活性，同一套代码基础可以顺滑地部署到当前主流的各类宿主环境。
- 极度定制化 (Highly Customizable) - 提供完备功能模块的同时，坚持零黑盒封装与高度模块化的极简配置（如 Tailwind CSS v4 与 shadcn/ui），便于二次开发。
购买 MuseMVP 后，你马上得到什么？
一次购买，立即解锁：源码仓库访问 + 手册全量内容 + 私有社区交流。
1) 获取 MuseMVP 源码
通过 GitHub 源码仓库 获取访问权限，直接 clone，马上开始二次开发与部署。
2) 访问 MuseMVP 手册所有内容
访问 /manual 解锁手册全量章节与持续更新内容，不再受付费内容遮罩限制。
3) 专属 License Key 权益
在 /app/settings/license 获取专属许可证密钥，用于解锁后续推出的 AI 自动化服务与 MCP 组件。
4) 进入私有交流社区
通过 Discord 邀请链接 填写购买 MuseMVP 的邮箱，审核通过后加入私有社区；也可在 GitHub Discussions 持续交流。
- 拿到 源码 后可以直接改业务，不用从 0 搭基础架构。
- 拿到 MuseMVP 手册 全量内容后有完整路径，不用靠碎片信息试错。
- 通过 Discord 提交购买邮箱并审核通过后入群，或在 GitHub Discussions 直接交流。
登录 MuseMVP 官网 前往 购买页面 完成购买。
获取 musemvp · GitHub 邀请链接 与 MuseMVP 手册 全量访问权限。
通过 Discord 入口 提交购买邮箱，审核通过后加入私有社区；或在 GitHub Discussions 交流。
问题咨询
有任何问题或咨询，可通过 联系我们 或发送邮件至 support@musemvp.com 联系我们。
一句话总结
你买到的是「可运行的源码 + 可复用的方法 + 可交流的圈子」，目标是更快做出并上线你的产品。
主要特性
在深入技术细节之前，以下是 MuseMVP 提供的开箱即用的核心模块：
一次编写，到处部署 (Deploy Anywhere)
这也是 MuseMVP 的核心特点：同一套代码库，不需要修改就可以部署到 Vercel、Cloudflare Workers 边缘节点，以及普通的 Docker 容器环境。
基础架构
全栈架构
基于 Next.js 16 (React 19) 和 Hono 搭建，前后端同构。
类型安全数据层
使用 Drizzle ORM 和 PostgreSQL。建表、查询、迁移具备完整的 TypeScript 类型提示。
UI 与设计系统
基于 Tailwind CSS v4 和 shadcn/ui (Radix Primitives)，内置 Framer Motion 动画与暗黑模式支持。
安全与表单
整合 Zod 数据校验、React Hook Form 表单处理及 Cloudflare Turnstile 防爬虫。
身份认证 (Authentication)
会话管理
深度集成 Better Auth，提供完整的注册、登录、登出和 Session 状态管理。
邮箱密码登录
完整的邮箱 + 密码注册/登录流程，含输入校验与密码强度检测。
邮箱验证码登录 (OTP)
支持通过邮箱验证码（一次性密码）完成无密码登录与注册，提升注册转化率。
第三方社交登录 (OAuth)
预配置 Google 与 GitHub 一键第三方 OAuth 授权登录，开箱即用。
双重认证 (2FA)
内置基于 TOTP 的双重身份验证（2FA），用户可在个人设置中自助开启，显著提升账号安全性。
密码重置
完整的重置密码流程，含 Token 验证与安全时效控制。
连接社交账户管理
用户可在设置页查看并管理已绑定的第三方社交账号（如 Google、GitHub）。
用户设置 (Settings)
个人资料管理
用户可修改显示名称、上传或裁剪头像，所有变更即时生效。
邮箱变更
提供安全的邮箱修改流程，需邮件验证确认后生效。
密码设置
支持修改密码（针对密码账户）以及为社交账户单独设置密码的流程。
API Key 管理
用户可在设置中心创建、查看、测试和撤销 API Key，并支持配置过期时间与访问权限范围。
注销账户
用户可在设置页自助完成账户注销，含二次确认弹窗防止误操作。
支付与订阅 (Billing)
计费模块
Muse Billing 模块，统一处理应用内的定价策略和账单状态同步。
收费模式
支持灵活的计费方式，包括周期性订阅（按月/年 SaaS 模式）及一次性买断（LTD）。
客户门户
集成支付网关内置的客户自助门户，用户可自行管理账单、下载收据、取消订阅。
订阅状态同步
Webhook 实时同步订阅状态变更，确保用户权限与付费状态始终保持一致。
手动升级用户（管理员）
管理员可在后台手动为指定用户升级或更改订阅计划，无需用户自行操作。
AI 能力
Vercel AI SDK
底层集成 Vercel AI SDK，高效处理大模型流式文本输出及 React 组件渲染。
预设对话界面
提供开箱即用的 aichat 聊天 UI，天然支持多轮对话上下文保留。
记录持久化
用户的 AI 聊天记录自动持久化至数据库，保障刷新页面的会话连续性。
CMS、文档与国际化
内容管理 (CMS)
融合 Fumadocs 与 Content Collections，提供专业级的开发文档与博客系统。
付费可见机制
拓展原生 Markdown 渲染器，支持通过特制代码块实现内容细粒度权限管控。非付费用户将看到内容遮罩与付费引导，是知识付费产品的理想基础。
博客系统
内置完整的博客模块，支持分类、标签、RSS 订阅及 MDX 内容渲染。
更新日志 (Changelog)
产品更新日志页面，可记录版本历史，增加产品透明感，提升用户留存。
全球化 (i18n)
基于 next-intl 实现全站国际化支持。所有落地页、控制台、文档和博客均支持多语言平滑切换。
落地页与营销
营销落地页
内置一套设计精良的产品落地页，含 HeroSection、Features、PricingTable、FAQ 等完整Sections。
定价页面
预置与 Muse Billing 深度绑定的定价展示模块，支持多档计划、按年/月切换及特价折扣展示。
联系表单
带有 Cloudflare Turnstile 防垃圾保护的联系表单，消息可通过邮件转发至指定收件箱。
法律页面
预置隐私政策 (Privacy Policy)、服务条款 (Terms of Service)、社区行为准则 (Community Guidelines) 等法律合规页面模板，可直接修改使用。
Newsletter 订阅
内置 Newsletter 订阅接口，支持收集用户邮箱，配合邮件服务进行定期推送。
SEO 支持
自动生成 sitemap.xml、配置 robots.txt，所有页面内置 meta 标签与 Open Graph 信息，对搜索引擎和社交分享均友好。
主题定制 (Theming)
多套预设主题
内置 10+ 精心设计的主题预设，包含 MuseMVP 默认、T3 Chat、Twitter、Catppuccin、Mocha Mousse、Graphite、Bubblegum 等风格各异的配色方案。
暗黑模式
每套主题均原生支持亮色/暗色双模式，并能自动跟随系统偏好设置。
完整设计系统
基于 CSS 变量驱动的设计 Token，可轻松覆盖主色、背景色、圆角大小、字体等所有样式属性，主题定制无需改动任何组件代码。
管理后台 (Admin)
用户列表管理
管理员可搜索、过滤、分页浏览全部注册用户，支持按关键词实时检索。
用户操作
管理员可对任意用户执行以下操作：重发验证邮件、分配/撤销管理员角色、执行用户删除、为用户手动升级订阅。
数据分析 (Analytics)
Google Analytics
内置 Google Analytics (GA4) 集成，开箱即用，可追踪页面浏览、用户行为与自定义事件。
百度统计
同时集成百度统计，适合面向中国市场的产品，无需额外工程接入。
自定义事件追踪
提供统一的 useAnalytics hook，一行代码即可向多个分析平台同步发送埋点事件。
后端设施
对象存储
封装通用 S3 文件上传接口，无缝兼容 AWS、Cloudflare R2 或自建 MinIO。
邮件收发
集成 Resend 接口及 React Email 邮件模板，涵盖登录验证码、密码重置、欢迎通知等多种场景。
OpenAPI 文档
后端 API 路由自动生成 OpenAPI 文档，方便前后端协作与外部接口调用。
管理后台
内置管理界面 Dashboard，提供用户数据总览与权限管理能力，管理员专属路由保护。
推荐阅读路径
我们为您准备了以下渐进式阅读指引，助您快速上手：