发版记录

更新日志

MuseMVP 发版记录：新功能、模板现刊，以及 Next.js MVP 启动套件的修复。

产品2026年9月4日

Muse Collection 第 9 刊：Kanna 端侧二次元伴侣与夜航控制台

Muse Collection 正式上线第 9 套生产级落地页模板 Kanna——Cindy 风格不可变身份锁定、纯端侧亚毫秒级认知隐私与 45° 冷峻倒角 HUD 几何美学落地页。

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

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

视觉与核心特性

高对比度暖白纸感（默认亮色）：以 #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 与纯演示型安全认证弹窗。

刊面目录

九刊已上线，两刊还在制作。点任一格进入目录。

怎么获取

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

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

产品2026年9月4日

Muse Collection 第 8 刊：Solis 光学物理与 6500K 光谱标定台

Muse Collection 正式上线第 8 套生产级落地页模板 Solis——专为连续光谱光学光线追踪、6500K 标准日光仿真与高精实验室仪器打造的瑞士现代主义风格落地页。

Muse Collection 现已扩充至八套生产级落地页模板。第 8 刊 Solis 正式加入货架与模板库。

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

视觉与核心特性

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 精密排版。

刊面目录

八刊已上线，两刊还在制作。点任一格进入目录。

怎么获取

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

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

产品2026年8月23日

Muse Collection：落地页模板与 MuseMVP 一起发售

MuseMVP 现在与 Muse Collection 一起发售——七套可上线的落地页模板，可买整库、买单刊，或用创始许可一次性锁住后续全部模板。

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

怎么买

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

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

刊面

七刊已上线，两刊还在制作。三列三行。点任一格进入目录。

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

为什么和 starter 一起卖

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

里程碑2026年8月22日

运行时设置：支付与存储凭证加密入库

支付与 S3 凭证离开环境变量，加密写入数据库。生产环境必须设置 MUSE_SETTINGS_SECRET。结账使用稳定套餐 ID，后台支付页把每个网关的产品 ID 收进对应服务商面板。

对已有 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 密钥当作环境变量。

产品2026年7月2日

Storage 资产管理与 API Key 界面重构

新增 Settings > Storage 资产管理页：文件列表、用量统计、预览、presigned 下载与批量删除；API key 设置页重构为表格加在线验证 dialog；登录表单布局优化。

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

Storage 资产管理页

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

API Key 与登录体验

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

代码2026年6月30日

Cloudflare Workers 调优与依赖兼容修复

wrangler 配置新增 CPU limit，修复 cookie@2 breaking change 导致的构建失败，并批量合并六月依赖升级。

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

更新内容

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

代码2026年6月19日

安全审计与工程加固

完成一轮安全审计：修复支付 webhook 验签绕过与 newsletter XSS，新增启动环境校验、基线安全响应头、统一错误处理与三层 error boundary，并补齐 CI 与回归测试。

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

安全修复

修复支付绕过漏洞：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 授权链路新增回归测试。

代码2026年6月15日

i18n 规范：mvp.json 统一承载衍生产品文案

Agent skills 与 AGENTS.md 强制衍生产品的自定义文案只写入 mvp.json，模板更新可干净合并；品牌改造参考文档大幅扩充。

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

更新内容

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

产品2026年6月10日

模板瘦身：移除 AI Chat 与 fortress 布局

移除内置 AI chat 工作台与 fortress 账户布局，模板减少 8 项依赖与约 3,000 行功能代码；migration 0005 会删除 AI chat 数据表，升级前请注意备份。

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

移除 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 布局成为唯一内置路径，减少定制时的困惑；需要其他形态可按文档新增自定义布局变体。

产品2026年6月8日

Admin 用户管理套件

Admin 面板覆盖完整用户生命周期：创建、编辑、封禁、设置密码、session 管理与 impersonate 模拟登录，并新增批量建号 CLI 与整套测试覆盖。

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

Admin 用户管理

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

配套工具与测试

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

产品2026年5月30日

Header Discord 入口与品牌资产更新

落地页 header 新增由 config 驱动的 Discord 社区入口，favicon、应用图标与 hero 图整体重绘，locale 处理重构为 enum 并改进默认值解析。

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

更新内容

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

产品2026年5月27日

订阅偏好设置与 Direct Checkout 模式

新增用户自助订阅邮件偏好设置页与对应数据库字段，Billing 支持 direct checkout 模式直接跳转支付服务商托管页面，Admin 用户列表可按订阅状态筛选。

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

订阅偏好设置

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

Direct Checkout 计费模式

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

产品2026年5月25日

Dodo Payments 支付网关支持

Muse Billing 现已支持 Dodo Payments 订阅与一次性结账，并提供配置文档、环境变量模板，以及登录后终身版权益展示。

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

Dodo Payments 集成

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

产品2026年5月18日

EdgeOne 部署支持 & 依赖升级

新增 EdgeOne 部署目标，全面升级项目依赖，并更新了部署相关图片和 Hero 图片。

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

新功能

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

依赖升级

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

优化改进

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

产品2026年5月8日

邮件配置增强与认证界面优化

改进邮件发送基础设施，支持多服务商并增强错误处理；优化认证表单界面样式；批量更新依赖。

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

产品

邮件配置支持多服务商（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

代码2026年5月4日

周度维护与文档更新

依赖升级、布局组件优化及贡献者文档增强。

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

依赖更新

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

UI 与布局

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

文档与技能

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

更新内容

新增管理员对用户的封禁与解封功能。
增加封禁功能对应的设计说明文档。
为认证与设置相关组件补充 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

代码2026年4月16日

头像上传链路完成

完成基于签名 URL 的头像上传能力，并加强真实 API 测试与文档说明。

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

更新内容

实现基于签名 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