更新日志

• UI 模板：$19。全部已上线落地页模板（当前九套，持续新增）。
• MuseMVP：$69。全栈 SaaS 模板：同一仓库内的 Next.js + Node 与 Next.js + Cloudflare 两个应用。
• All in One：$79。MuseMVP 加全部 UI 模板。

在定价页对比各方案，并阅读商业许可。不订阅、不单套购买、不提供自助升级；如需更换方案请联系支持。

本次条目按模板 main 的 85730ea（2026-10-12）记录当前状态，覆盖 9 月 30 日之后的 monorepo 改造；不改写历史发布说明。

两个应用与共享包

• apps/web 部署到 Vercel/Docker，apps/web-cloudflare 部署到 Cloudflare Workers。
• 数据库、认证、API、计费、邮件、存储、配置、i18n、UI 与纯工具提取到 packages/*。
• 页面仍各自完整保留，pnpm apps:parity 检查对齐；driver、env 与部署配置保留平台差异。
• 翻译归 packages/i18n，default.json 深合并 mvp.json；MDX 源归各应用的 content/。

Workers 原生资源

• Workers 从旧 Hyperdrive/Postgres 路径迁为 D1 DB，存储为原生 R2 R2_BUCKET，生产邮件使用 Cloudflare Email Sending。
• 头像/资产经同源 /files/avatars/* 校验会话与所有权；Node 保留 S3 签名直传。
• D1 独立 schema、迁移与 SQL 哈希记录；远端迁移先备份/克隆演练，cf:deploy 检查待执行迁移后发布。
• 当前 main 已移除实验性的 EdgeOne 应用，不把尝试过的部署目标当作稳定模板能力。

配置与起步

• 删除后台运行时设置，支付、Node 存储、Turnstile 与邮件凭据使用环境变量。
• muse:init 初始化应用文件、签名密钥与本地迁移；muse:doctor 检查工具链；本地 seed 提供 admin/user 账号。
• Next.js 依赖升级至 16.4 系列，OpenNext 1.20.9 保留对应补丁；以仓库锁文件为实际安装依据。

验证与升级

• 新增测试包、覆盖率下限、双应用 parity，以及 unit/API/Playwright 分层流程。
• 数据库重整为新安装基线；已有生产库需要自行设计增量迁移，不能直接重放新基线。
• Node/Workers 外部服务仍需真实验收；现有 Cloudflare Playwright 启动配置不替代 Wrangler 绑定验证。

升级顺序见 升级到最新 Monorepo，上线核查见 发布检查清单。

官网文档现在按应用独立组织：

• Web 对应 Vercel 与 Docker、PostgreSQL 和 S3 兼容对象存储。
• Web Cloudflare 对应 Workers、原生 D1 与 R2，以及 Cloudflare Email Sending。
• 文档选择器始终打开所选应用的概览，顶部资源卡片说明各自的基础设施与适用场景。
• 每篇文章提供复制 Markdown 和 ChatGPT、Claude、Cursor 打开菜单，并导出按应用与语言独立的 Markdown 内容。
• 模块统一使用配置、身份认证、计费与支付、文档系统等正式名称，移除原有的大分组标题。
• Header 选择器前往对应应用落地页。Web Cloudflare 新增 /web-cloudflare 地址，暂时复用 Web 落地页内容；定价、模板、博客与更新日志保持共用。

现有文档链接通过兼容页面继续可用。快速开始、环境变量、数据库、存储、邮件、测试与部署指南仅展示当前应用的操作命令。

模板改为带 Turborepo 的 pnpm workspace。共享行为放在 @musemvp/* 包里。页面代码在两个应用之间复制，并由 pnpm apps:parity 检查。

应用

• apps/web 是给 Vercel 和 Docker 用的 Node 应用。把 Vercel 的 Root Directory 设为 apps/web。
• apps/cloudflare 是 Workers 应用。用 pnpm cf:deploy 部署。
• DATABASE_CONNECTION_STRATEGY 已删除。Node 应用使用连接池。Workers 应用按请求使用 Hyperdrive。

配置

• 支付、存储、Turnstile 和新闻订阅签名都是环境变量。
• /app/admin/settings 和 MUSE_SETTINGS_SECRET 已移除。迁移 0002_drop_app_settings.sql 会删除 app_setting 和 app_setting_revision。
• pnpm muse:settings:export 可以把旧的加密记录打印成环境变量。
• pnpm muse:init 和 pnpm muse:doctor 用来初始化本地应用。

测试

• 包测试放在各自的包旁边。覆盖率下限只能提高。
• pnpm test:e2e 覆盖 Node 应用。pnpm test:e2e:cf 覆盖 Cloudflare 应用。

这次把模板的直接依赖更新到当前版本，删掉不再使用的包，并把三项配置从环境变量挪到后台运行时设置。

依赖

• Next.js 与 @next/third-parties 为 16.3.7。@opennextjs/cloudflare 为 1.20.7。Wrangler 为 4.144。Better Auth 为 1.7.6。
• 其余直接依赖在同一次更新里也升到了当前版本。
• 0001_better_auth_1_7_6.sql 对齐 Better Auth 1.7.6：account.issuer 改为可空，two_factor 增加 verified、failed_verification_count 和 locked_until。已有数据库需要执行 pnpm drizzle:migrate。

清理

• package.json 里未使用的依赖已删除。
• src/components/ui 里未使用的组件已删除。
• pnpm drizzle:status 可以查看已应用和待应用的迁移。Drizzle 脚本通过 dotenv run -f .env 读取 .env。

运行时设置

• 头像公开读域名不再使用 NEXT_PUBLIC_AVATARS_PROXY_URL。在「存储」标签填写。已登录客户端从 /api/auth/get-session 的 avatarsFileProxyUrl 读取。后台留空时，使用 src/config/storage.ts 里的 AVATARS_FILE_PROXY_URL_FALLBACK。
• 邮件退订签名单独放在「邮件」标签。密钥留空时继续使用 BETTER_AUTH_SECRET。保存新密钥后，已经发出去的退订链接会失效。
• Cloudflare Turnstile 单独放在「验证码」标签。忘记密码页在服务端读出站点密钥，再传给表单。站点密钥和密钥都保存之后，页面才会显示验证码，服务端才会校验令牌。
• .env.local.example 已去掉 NEXT_PUBLIC_AVATARS_PROXY_URL、NEWSLETTER_TOKEN_SECRET、NEXT_PUBLIC_TURNSTILE_SITE_KEY 和 CAPTCHA_SECRET_KEY。

Cloudflare 官方宣布全面取消 3MB/10MB 的 Worker gzip 压缩体积限制，无论免费还是付费计划均统一放宽至 64 MiB 未压缩代码包。

调整内容

• 移除付费计划限制：原部署文档中关于需订阅每月 $5 Workers Paid 计划的提示已全面移除。MuseMVP 的构建包已完全适配免费计划配额，无需任何额外支出即可直接部署上线。
• 文档与博文同步发布：
  • 查看官方更新日志原文：Cloudflare Changelog: Deploy larger Workers — up to 64 MiB for both free and paid plans
  • 阅读我们的博客解读：Cloudflare Workers 体积上限放宽至 64MB：MuseMVP 现已完全支持免费计划直接部署
  • 查阅最新指引：Cloudflare Worker 部署指南

历史方案已停止新售。现行两商品价格与权益见定价页。本文保留当时发布记录。

Muse Collection 现已扩充至九套生产级落地页。全新 UI 模板 Kanna 正式加入货架与模板库。

Kanna 是一套专为开发者打造的纯端侧神经元二次元伴侣、伴生式 Daemon 进程与深夜夜航控制台落地页。在线演示已部署在 https://kanna.musemvp.cn/。

本期发布 UI 模板

视觉与核心特性

• 高对比度暖白纸感（默认亮色）：以 #faf8f5 暖白纸感为基底，搭配深墨黑 #0b0f17 高对比度字形与电光钴蓝 #3b82f6 点缀，并支持一键切入深渊深色模式（Void Dark #080b11）。
• 棱角分明的 HUD 线条与 45° 倒角：告别圆角药丸，采用 45 度倒角切角按键（.chamfer-button）、十字准星、标尺边框与直角包角（┌ ┐ └ ┘），搭配英文字体 Chakra Petch、Chivo 与 Share Tech Mono。
• Cindy 风格不可变身份锁定：6 大核心特征不可变锁定（海军黑发 #161B26、电蓝挑染 #3D6BFF、琥珀金瞳 #F59E0B、护符发夹、高冷浅笑）与 4 种测光舱动态切换。
• 悬停视频播放定价矩阵：四档商业化定价卡片，支持由 Flora 顶级模型 Seedance 2.5 生成的高清视频悬停平滑循环播放。
• 完整的技术博客与开发手册：内含 8 篇深度 Dispatch 架构长文与 8 章 Codex 技术手册，全静态 MDX 驱动，配合代码复制与高亮组件。
• 现代技术栈：基于 Next.js 16 (App Router + Turbopack)、React 19、Tailwind CSS 4、严格模式 TypeScript 与纯演示型安全认证弹窗。

浏览全部 UI 模板

Muse Collection 目前共包含 9 套上线中的生产级落地页模板。点击任一卡片可进入目录与体验演示：

怎么获取

• 创始许可 — $99：包含 MuseMVP starter、手册、社区，以及终身 Collection 模板库（包含 Kanna 在内的全部已上线 9 套 UI 模板，以及未来发布的每一套模板）。
• 模板库 — $79（原价 $129）：终身覆盖包含 Kanna 在内的全部已上线 UI 模板和之后每一套模板。
• 单套模板 — $29：一份 Kanna 落地页源码授权。
• 已购用户：如果你已经购买了 MuseMVP 或 Collection 模板库，Kanna 源码已经自动包含在你的授权内，源码仍通过 GitHub 和 Discord 渠道获取。

在线体验：https://kanna.musemvp.cn/ | 完整目录：/templates

历史方案已停止新售。现行两商品价格与权益见定价页。本文保留当时发布记录。

Muse Collection 生产级落地页模板库迎来重磅更新。全新 UI 模板 Solis 正式加入货架与模板库。

Solis 是一套专为光学物理仿真、6500K 标准日光（CIE D65）与实验室科学 SaaS 仪器打造的瑞士现代主义风格落地页。在线演示已部署在 https://solis.musemvp.cn/。

本期发布 UI 模板

视觉与核心特性

• 6500K Clean Room 纯白无尘室首发：以无菌级 ISO 光学校准室为设计基底，辅以 Darkroom（零杂散光暗房）双模式切换。
• 光学色散物理仿真：首屏全画幅 Hero D 光学校准台，集成实时波长可调光谱仪（380nm–780nm）、Sellmeier 色散系数曲线与三棱镜连续色散展示。
• 丰富的学术与工程内容：内含 8 篇深度光学物理 Journal 论文与 8 章 Spec 规范技术手册，全部基于 MDX 驱动，配合 server-only 安全隔离。
• 实验室级家具界面：提供实验室风格的登录与注册陈列界面，即开即用。
• 现代技术栈：基于 Next.js 16 (App Router + Turbopack)、React 19、Tailwind CSS 4、严格模式 TypeScript 与 Chivo / Plus Jakarta Sans / Martian Mono 精密排版。

浏览全部 UI 模板

Muse Collection 目前共包含多套上线中的生产级落地页模板。点击任一卡片可进入目录与体验演示：

怎么获取

• 创始许可 — $99：包含 MuseMVP starter、手册、社区，以及终身 Collection 模板库（包含 Solis 在内的全部已上线 UI 模板，以及未来发布的每一套模板）。
• 模板库 — $79（原价 $129）：终身覆盖包含 Solis 在内的全部已上线 UI 模板和之后每一套模板。
• 单套模板 — $29：一份 Solis 落地页源码授权。
• 已购用户：如果你已经购买了 MuseMVP 或 Collection 模板库，Solis 源码已经自动包含在你的授权内，源码仍通过 GitHub 和 Discord 渠道获取。

在线体验：https://solis.musemvp.cn/ | 完整目录：/templates

历史方案已停止新售。现行两商品价格与权益见定价页。本文保留当时发布记录。

货架上不再只有 starter。Muse Collection 是一套持续出版的 UI 落地页模板库：创始许可期内与 MuseMVP 打包出售，窗口关闭后作为独立目录售卖。

怎么买

• 创始许可 — $99。 包含 MuseMVP starter、手册、社区，以及终身 Collection 模板库：当前全部已上线 UI 模板，以及你购买之后发布的每一套模板。窗口结束后拆开卖：starter $149，模板库 $79。
• 模板库 — $79（原价 $129）。终身覆盖当前已上线 UI 模板和之后每一套模板。不含 MuseMVP starter。
• 单套模板 — $29。 一套落地页源码授权。不含后续模板。
• 已经购买 MuseMVP 的用户自动包含模板库。源码仍走原来的 GitHub 和 Discord 渠道，不用再买一次。

创始许可限 30 席，当前截止到 2026 年 8 月 26 日（北京时间 23:59）。目录在 /templates。

UI 模板库

多套生产级 UI 模板已上线，另有新模板持续制作中。点击任一套卡片即可进入详情与在线演示：

模板库或创始许可在 Vesper 与 Folio 上线时已经覆盖。

为什么和 starter 一起卖

MuseMVP 仍是生产基线：认证、计费、国际化、多端部署。Collection 是铺在这条基线上的公开表面——可以只买一种面貌，可以锁整库，也可以在 starter 与模板拆开售卖之前拿下创始打包。

对已有 fork 这是一次破坏性配置变更：网关密钥和 S3 凭证运行时不再从环境变量读取。

为什么改模板

• 支付和存储密钥以前和邮件、OAuth 一起放在 .env 里。轮换密钥就要重建部署，把启动必需的配置和日常运维混在了一起。
• 运行时对支付和 S3 只读 app_setting 表。把本地残留值导入之后，没有环境变量回退。

你必须设置的项

• 增加 MUSE_SETTINGS_SECRET（至少 32 个字符）。它用 HKDF-SHA256 + AES-256-GCM 包装加密设置，绝不入库。生产运行时缺少它会在启动时直接失败。
• 执行迁移 0001_dry_terror.sql，确保存在 app_setting 与 app_setting_revision（pnpm drizzle:migrate）。
• 创建管理员后打开 后台 → 运行时设置（/app/admin/settings）。保存网关凭证、结账产品 ID 和 S3 设置。上线前先点 测试连接。
• 可选一次性操作：pnpm muse:settings:import 把本地残留的网关/存储凭证写入数据库。之后运行时不再读取这些 env。结账产品 ID 在后台填写，不走环境变量。

计费与结账

• 公开定价页仍使用稳定套餐 ID（pro_monthly、pro_yearly、lifetime）。支付商产品 ID 存在 billing.productMap。
• Direct checkout 模式已移除。付费套餐一律通过 Muse Billing，走后台保存的默认网关（Creem、Stripe、Dodo 或 Waffo）。
• 后台支付页顶部是默认网关卡片。每个服务商默认收起；展开后在同一面板填写凭证和该网关的产品 ID。标题右侧会显示「默认」「已配置 / 未配置」、已映射产品 ID 数量，以及未保存时的「未保存」。

存储与部署

• S3 access key、secret、endpoint 和头像 bucket 都在后台设置。NEXT_PUBLIC_AVATARS_PROXY_URL 仍留在环境变量，因为浏览器要靠它拼接头像 URL。
• Docker、Vercel、Cloudflare Workers 和 EdgeOne 的生产环境变量清单现在都要求 MUSE_SETTINGS_SECRET，不再把网关或 S3 密钥当作环境变量。

本次更新让每个用户对自己的存储文件拥有可见性与控制权，并重构了 API key 管理体验。

Storage 资产管理页

• 新增 Settings > Storage 页面，用户可管理自己在 S3 兼容存储中的文件：列出已上传文件并显示用量统计、预览资产、生成 presigned 下载链接、单个或批量删除。
• 底层为新的鉴权 /assets Hono 路由，所有操作严格限定在用户自己的存储前缀内，带完整 key 校验与 300+ 行 service 测试。

API Key 与登录体验

• API key 设置页围绕表格重构，每个 key 有独立操作菜单（详情、测试、删除），并新增在线验证 dialog，无需离开页面即可确认新建的 key 真实可用。
• OTP 登录表单布局优化，密码输入框与忘记密码链接的对齐更清晰。

本次更新以部署稳定性与依赖维护为主。

更新内容

• wrangler.jsonc 新增 300,000 ms 的 CPU limit，Cloudflare Workers 部署上的重请求不再触发默认 CPU 上限。
• 修复 cookie@2 的 breaking change（parse 更名为 parseCookie）导致的构建失败，模板在最新依赖下保持可构建。
• 六月通过 Dependabot 批量合并保持依赖树最新（四组合并、约 125 个包升级）。

本次更新完成了一轮针对认证、计费与基础设施的安全审计，并整体提升了工程质量基线。

安全修复

• 修复支付绕过漏洞：Creem 与 Stripe webhook 在未配置 secret 时不再回退解析未验签请求体，生产环境强制要求 webhook secret（与既有的 Dodo 防护一致），并附 gateway 安全测试。
• 修复 newsletter 退订页的反射型 XSS，退订 token 改为 HMAC-SHA256 签名（常量时间比较），退订链接不再可被伪造利用。
• 所有路由默认下发基线安全响应头：HSTS、X-Frame-Options SAMEORIGIN、nosniff、Referrer-Policy 与严格的 Permissions-Policy。

可靠性与工程质量

• 服务端环境变量在启动时校验，配置错误的部署会快速失败并给出明确报错，而不是在请求中途崩溃。
• App Router 三层 error boundary（route/app/global）展示本地化错误页；auth 邮件（OTP、magic link、密码重置）发送失败时返回真实错误，而非静默成功；Hono API 新增统一 error handler 与请求体大小限制。
• CI workflow 在每次 push 运行 type-check/lint/unit，Playwright e2e 改为针对 production build 运行并带重试，webhook 到 entitlement 授权链路新增回归测试。

本次更新确立了衍生产品定制文案的工程规范，让基于模板的项目与上游更新长期共存。

更新内容

• 衍生产品的所有自定义文案统一写入 mvp.json（en/zh 成对），不再改动上游翻译文件——后续模板更新可以干净合并，不再产生 i18n 冲突。
• landing-page map 与 brand-adaptation 参考文档大幅扩充，为改造公开页面品牌提供更清晰的成文路径。

本次更新对模板做减法：移除使用率低、维护成本高的内置功能，让购买者从更精简的基线起步。

移除 AI Chat

• 移除内置 AI chat 工作台——页面、Hono API 路由、数据库查询、UI 组件及 AI SDK 依赖——不做 AI 功能的项目不再背负多余代码、依赖与攻击面（package.json 减少 8 项依赖，删除约 3,000 行功能代码）。
• Breaking change：migration 0005 会删除 ai_chat_conversation 与 ai_chat_message 数据表（CASCADE），使用过 AI chat 的衍生项目升级前请先导出会话数据。

移除 fortress 布局

• 删除不再维护的 fortress 账户布局变体（约 300 行），default 布局成为唯一内置路径，减少定制时的困惑；需要其他形态可按文档新增自定义布局变体。

本次更新将 Admin 面板升级为完整的用户运维中心，日常账号操作不再需要直接接触数据库。

Admin 用户管理

• 创建用户、编辑资料、封禁/解封（支持封禁原因与期限）、设置密码、查看并吊销活跃 session 均可通过专用 dialog 完成。
• 新增 impersonate 模拟登录以复现用户问题，常驻的 ImpersonationBanner 明确提示当前处于模拟状态并支持一键退出。
• 用户列表附带计费合约信息，渲染增加 fallback 文本与头像样式兜底。

配套工具与测试

• 新增带交互式提示的批量建号 CLI 脚本，快速灌入演示或团队账号；data-table 分页现在显示准确的总行数。
• 整套功能附带新的 contract 测试、单元测试与 admin 路由 e2e smoke 测试。

本次更新完善了落地页的社区入口与默认品牌资产。

更新内容

• 落地页 header（桌面端与移动端菜单）新增由 config 驱动的 Discord 按钮，一条配置即可展示自己的社区入口。
• 默认 favicon、应用图标、OG 图与 hero 图全部以更高分辨率重绘，新部署开箱即有完成度。
• locale 处理重构为 enum 并改进默认 locale 解析，降低衍生项目 i18n 配置出错的风险。

本次更新围绕订阅关系管理：用户可以自助控制订阅邮件，Billing 新增免集成的 direct checkout 模式。

订阅偏好设置

• 新增 Settings > Subscriptions 页面，用户可自助管理订阅邮件偏好，退订不再需要人工支持；底层新增 muse_subscribe_enabled 字段并附带 migration。
• Admin 用户列表新增订阅状态列与筛选，可快速审计已退订用户。

Direct Checkout 计费模式

• 定价方案可配置为直接跳转支付服务商托管的 checkout 或 portal 页面，并通过 DirectCheckoutBillingNotice 说明订阅由外部管理，适合不在应用内接结账流程的场景。
• checkout mode 解析逻辑附带单元测试，保证配置行为可预期。

本次更新将 Dodo Payments 接入 Muse Billing 统一计费层，团队可与 Creem、Stripe 一样完成结账、Webhook 同步与客户门户跳转。

Dodo Payments 集成

• 新增 muse_dodo 网关，支持 checkout session 发起、Webhook 签名校验、合约状态同步与客户门户链接。
• 扩展产品目录与环境变量模板，覆盖 Dodo API 密钥、Webhook 密钥、运行环境模式，以及月付/年付/终身产品 ID 配置项。
• 在 Muse Billing 编排层注册网关，并补充网关行为、映射逻辑与权益解析的单元测试和 API 覆盖。

本次更新新增了 EdgeOne 作为部署目标，与 Cloudflare、Docker、Vercel 并列支持，同时全面升级了项目依赖，所有测试均已通过。

新功能

• 新增 EdgeOne 部署平台支持，包含完整配置和演示 URL。

依赖升级

• 全面升级项目依赖至最新版本。
• 所有单元测试、API 测试、e2e 测试均已通过。

优化改进

• 精简部署描述文案，优化 UI 样式。
• 更新深色和浅色主题下的 Hero 图片。
• 替换 Cloudflare、Docker、Vercel 的部署图片，与新增的 EdgeOne 保持一致。

本次发布强化了邮件发送管道的多服务商支持与容错能力，清理了认证表单的视觉样式，并将依赖树更新至最新版本。

产品

• 邮件配置支持多服务商（Resend 和 Cloudflare），同步更新了环境变量示例文件
• 改进邮件发送逻辑，在联系和订阅路由中增加回复地址支持，并优化投递失败的错误处理
• 移除认证表单标题中的装饰性星号（登录、注册、忘记密码、重置密码、两步验证），界面更简洁
• 新增联系路由、订阅路由和邮件发送逻辑的完整单元测试

工程

• 批量更新 26 个依赖，包括 Next.js 16.2.5、React 19.2.6、fumadocs-mdx 15.0.0、Zod 4.4.3、Wrangler 4.89.1
• 将 next.config.ts 重命名为 next.config.mts，显式使用 TypeScript 模块配置并支持 Cloudflare 和 MDX

本周以依赖更新、布局响应式改进和贡献者文档完善为主。

依赖更新

• 对 monorepo 中 15 个包进行了版本升级至最新兼容版本
• 额外升级了 22 个包，涵盖核心框架及工具库
• 处理了 Dependabot PR #52 的合并冲突

UI 与布局

• 重构默认布局组件，改用 flexbox 以提升跨屏幕尺寸的响应式表现

文档与技能

• 更新了技能文件路径并增强了 brainstorming 工作流文档
• 改进了 Claude 配置文档，补充了上下文管理和验证流程说明

相关提交

• 9c2cc37 chore(deps): bump the npm-all group across 1 directory with 15 updates
• 3df380e chore(skills): update skill paths and enhance brainstorming documentation
• 77e8153 docs(claude): enhance documentation for context management and verification processes
• eb381cf chore(deps): bump the npm-all group across 1 directory with 22 updates
• e029b50 refactor(layout): enhance component structure with flexbox for improved responsiveness

本次发布聚焦于后台运营控制能力和认证链路质量提升。

更新内容

• 新增管理员对用户的封禁与解封功能。
• 增加封禁功能对应的设计说明文档。
• 为认证与设置相关组件补充 data-testid，提升端到端测试稳定性。
• 优化认证重定向处理逻辑，并增强相关类型安全。
• 优化 Changelog 时间线布局对齐，并恢复日期的 sticky 吸附效果。

关联提交

• 91260b7 feat(admin-users): implement user ban and unban functionality
• e29f9b1 docs(spec): add admin user ban design
• 45bf4ef feat(two-factor-auth): enhance TwoFactorVerifyForm with data-testid attributes for improved testability
• d655ee4 feat(password-input): refactor PasswordInput component to use forwardRef and improve type safety
• 91be374 feat(settings): add data-testid attributes for improved testability in confirmation and delete account components
• e470adb refactor(auth): streamline redirect handling and enhance type safety

头像上传流程现已具备端到端可用能力，可直接用于生产环境。

更新内容

• 实现基于签名 URL 的头像上传主流程。
• 增加并重构真实 API 测试，覆盖 URL 校验与错误处理场景。
• 优化测试初始化与动态路径生成，提升测试稳定性。
• 补充存储相关环境变量与上传链路文档说明。

关联提交

• dc08c88 feat: implement avatar upload functionality with signed URL generation
• 0f69648 feat(api): implement avatar upload with signed URL and enhance test coverage
• f866e80 test: refactor avatar upload real API tests for improved structure and functionality
• 1f27df3 test: enhance avatar upload URL validation in real API tests
• 3349f8f test: bootstrap environment for avatar upload tests and improve error messaging
• 07c1a48 refactor: enhance avatar upload tests with dynamic path generation
• f5170d8 docs: enhance documentation for storage environment variable checks and avatar upload URL generation

本次更新重点补齐了对开发者和运营都更实用的产品能力。

更新内容

• 新增 API Token 功能，并支持按配置条件渲染。
• 新增头部 hideBorderX 配置项，提升页面头部样式灵活性。
• 简化默认布局头部结构，让导航区域更清晰。
• 更新工具配置，将 skills 目录排除在 Biome 与 TypeScript 检查之外。

关联提交

• d563264 feat: implement API tokens feature with conditional rendering
• 546c9a0 feat: add hideBorderX configuration option for header
• 90bec07 refactor: simplify header structure in default layout
• ddac416 chore: update biome and tsconfig to exclude skills directory

当前规划范围内的 SaaS 功能已全部完成。

MuseMVP 现已具备完整的一体化 SaaS 能力，团队可以把精力集中在业务差异化，而不是重复建设基础设施。

已完成范围

• 认证全流程、账户初始化与用户管理能力。
• 支付与订阅相关的计费配置能力。
• 管理后台与设置中心等运营面板能力。
• 文档、博客、法务页面与更新日志等公开内容系统能力。

MuseMVP 已于 2026-03-10 正式发布。

从这一版本开始，项目已经可以作为真实 SaaS 产品的基础，而不只是启动模板。

相关链接

• 文档：https://musemvp.com/zh/docs
• 功能：https://musemvp.com/zh/features
• MuseMVP 文档：https://musemvp.com/zh/docs

相关提交（节选）

• 91260b7 feat(admin-users): implement user ban and unban functionality
• e29f9b1 docs(spec): add admin user ban design
• 45bf4ef feat(two-factor-auth): enhance TwoFactorVerifyForm with data-testid attributes for improved testability
• d655ee4 feat(password-input): refactor PasswordInput component to use forwardRef and improve type safety
• 91be374 feat(settings): add data-testid attributes for improved testability in confirmation and delete account components
• e470adb refactor(auth): streamline redirect handling and enhance type safety
• 8a9bc25 refactor: enhance muse-billing module with improved documentation (#45)
• 9050bb6 feat(agents): enhance feature delivery and testing guidelines (#41)
• 36eb81d chore(deps): update package versions in package.json and pnpm-lock.yaml
• 0f69648 feat(api): implement avatar upload with signed URL and enhance test coverage (#40)
• dc08c88 feat: implement avatar upload functionality with signed URL generation
• 383e1c0 chore: enhance API key management and update related tests
• 6cf1d0d feat: add test framework module + optimize AI rules file + update nextjs and better-auth. (#31)
• 43175cd refactor: restructure blog and legal related pages; optimize landing page rendering (#29)
• cbc4963 feat: introduce MuseMVP skill for customizing SaaS app home route
• 7f96f88 refactor: migrate from content-collections to Fumadocs MDX and update related configurations
• a0ac45f feat: enable conditional display of DeleteAccountForm based on configuration
• d563264 feat: implement API tokens feature with conditional rendering
• 546c9a0 feat: add hideBorderX configuration option for header
• 50855ce feat: add new skills and documentation for brainstorming and better-auth practices
• fd14861 refactor: restructure landing page components for improved modularity
• ec953dc fix: update pricing section configuration based on billing settings
• dfc11be feat: add discount code functionality to pricing and error handling
• ···