更新日志

⚡ 缓存

• Cloudflare KV Cache：为 TanStarter 新增可选的 KV 缓存能力，用于读多写少的 server data。
• Newsletter 状态缓存：Newsletter 订阅状态检查现在可以复用缓存读取，避免每次都调用 provider。
• 缓存文档：新增简短说明，解释什么时候启用 KV cache，以及它在模板技术栈中的位置。

🔐 认证与安全

• Better Auth 1.6 升级：升级至 Better Auth 1.6 并接入 API Key 插件，附带 D1 迁移，将 API Key 从 user_id 迁移为 reference_id。
• API Key 分页：API Key 列表改为服务端分页，并返回准确的总数。
• CSRF 防护：为 server functions 新增 CSRF 防护中间件。

🧪 E2E 与质量工具

• 生产环境冒烟测试：新增 pnpm e2e:production，针对生产构建验证 SSR 和 API 响应；并新增 verify:upgrade，一次跑完检查、构建和两套 E2E。
• Stripe 沙箱 E2E：新增基于 Stripe CLI 的沙箱结账流程测试，以及 webhook 单元测试和更清晰的 webhook 错误日志。
• 覆盖范围扩展：新增设置页（API Key、文件管理、安全）和路由边界错误处理的 E2E 用例。

🚀 依赖与运行时升级

• Cloudflare 工具链：升级 Wrangler 与 Cloudflare Vite 插件，并按最新 workerd 版本重新生成 worker 类型。
• 核心依赖：更新 TanStack Start/Router/Query、React 和 Playwright，server function 校验统一改用新的 .validator() API。
• Base UI 更新：升级 Base UI，并将抽屉组件从 Vaul 迁移到 Base UI Drawer，支持滑动操作。

🎨 UI/UX 优化

• 侧边栏状态记忆：仪表盘侧边栏的折叠状态现在会在多次访问之间保持。
• 导航栏与移动端导航：稳定导航栏认证加载状态、在桌面端隐藏移动导航，并精简语言切换菜单。
• 视觉细节：优化图表配色、删除账号卡片边框和管理员用户详情布局。

🌐 国际化

• 国际化支持：基于 Paraglide 新增完整国际化能力，包含本地化文案、中文内容页、中文博客和更新日志，以及语言路由中间件。
• 多语言路由：更新认证、结账、客户门户、站点地图和 robots 路由，使它们能够正确处理不同语言的访问路径。
• 界面文案本地化：将大量界面文案迁移到英文和中文消息文件，并清理未使用的仪表盘翻译。

💳 支付与认证流程更新

• 本地化结账流程：为 Stripe 结账和客户门户会话新增语言支持。
• 认证回调地址：更新登录、注册和社交登录的回调地址处理，确保跳转后保留当前语言路径。
• 可选 SSR 处理：修复语言编译和邮件开发脚本，使其在可选 SSR 配置下运行更可靠。

🤖 AI 体验更新

• Llama 3.2 模型：更新 AI 模型配置、说明文案、文档和 AI 功能卡片，补充 Llama 3.2 支持。
• 选择器标签优化：为图片、翻译和语音合成组件中的模型、语言和发音人选择器增加更清晰的标签。

🧪 E2E 与质量工具

• E2E 用户管理 API：新增仅本地可用的 E2E 用户管理接口，让认证和设置相关测试更稳定。
• Playwright 覆盖范围：新增并更新 E2E 测试数据和用例，覆盖公开页面、受保护页面、认证流程和个人资料设置流程。
• Knip 配置：新增项目专用的 Knip 配置和忽略规则，用于检查未使用的依赖和导出。

📦 存储与服务加固

• 目录路径清理：新增目录路径清理工具，并更新 R2 存储服务，统一使用清理后的对象路径。
• Newsletter 服务缓存：优化 Newsletter 服务的创建与缓存逻辑。
• 存储文档修正：更新存储文档中的函数名称，保持文档与代码一致。

🔎 SEO 与元数据改进

• SEO 基础能力：优化页面元数据、Open Graph 信息、博客结构化数据、应用清单配置和 Logo 渲染，提升搜索收录与社交分享效果。
• 博客 SEO：增强博客元数据支持，改进规范链接处理，并让发布内容的元数据更完整。

⚡ 性能优化

• 字体本地化：将 Bricolage Grotesque 改为本地托管资源，并优化字体加载，减少外部依赖。
• 延迟加载客户端脚本：将非关键客户端脚本延迟到浏览器空闲后执行。
• Crisp 聊天加载优化：将 Crisp 初始化改为延迟执行和动态导入，改善页面启动性能。

📦 存储与文件访问

• 公开目录支持：增强文件访问路由，支持公开目录，同时保留受保护文件的访问控制。
• 文件路由加固：改进存储文件路由的处理逻辑，让公开文件和私有文件的分发更安全。

🎨 UI 与组件更新

• Base UI 1.5.0：升级 Base UI 组件，并更新侧边栏和切换按钮组的集成方式。
• 表格分隔线：修复数据表格筛选器和操作栏中分隔线的高度与对齐问题。
• 导航可访问性：修正导航栏的角色属性使用方式，提升可访问性。

🚀 部署与开发体验

• 手动部署工作流：支持手动触发 GitHub Actions 部署流程。
• Cloudflare 凭据配置：将 Cloudflare 部署凭据上移到工作流环境变量中，让部署配置更清晰。
• 无端口 DevTools：更新 DevTools 配置，支持本地开发使用的无端口事件总线。

💳 支付 Provider 扩展

• Creem Integration：新增完整 Creem payment provider 支持，包含 SDK 集成、webhook handling，以及通过环境变量配置 product pricing。
• Payment Toggle：允许通过设置空环境变量来关闭支付功能，为不同部署场景提供更高灵活性。

📧 多邮件 Provider 支持

• Resend Email Provider：集成 Resend 作为替代 mail provider，提供完整文档和完整邮件功能。
• Cloudflare Email Service：新增 Cloudflare Email API 支持，使用 account ID 和 API token 进行认证。
• Email Preview Fix：修复开发模式下预览邮件功能。

📰 Newsletter 集成

• Beehiiv Support：在已有 Resend 集成之外，新增 Beehiiv 作为可选 newsletter provider，让用户有更多邮件列表管理选择。

🔐 认证改进

• Session Validation：为登录和注册路由添加 session checks 和 redirects，提升安全流程。
• Guest Route Middleware：实现 guestRouteMiddleware，替代 websiteConfig checks，让认证逻辑更清晰。

⚡ 数据库与存储细化

• Public Folder Handling：泛化 public folder handling，让文件管理更灵活。
• Content-Type Validation：强制执行 content-type validation 和安全文件下载。

🎨 UI 与组件更新

• Shadcn UI Upgrade：升级 shadcn/ui components 到最新版本，获得更好的功能表现。
• Admin UI Improvements：简化 admin interface 中 ban/unban button 逻辑，并改进表单结构。

🛠️ 开发体验

• Secret Sync Scripts：新增同步 GitHub 和 worker secrets 的脚本，以及 GitHub Actions 环境变量管理能力。
• DevTools Optimization：将 devtools 合并到 lazy-loaded DevTools component 中，提高性能。

🔧 Bug 修复

• Webhook Security：修复 webhook handling，在缺少 payload 或 signature 时返回 400。
• Price ID Fallback：修复 price IDs 上的 non-null assertion，改为更合适的 fallback。
• Payment Verification：通过 auth middleware 和 user scope check 修复支付完成验证。
• Mail Error Handling：通过改进 renderer fallback logic 修复邮件错误处理。

🔧 Shadcn v4 升级

• 升级到 Shadcn v4：将整个 UI component library 迁移到 Shadcn v4，带来更好的组件架构、更新后的 styling primitives，以及基于新 primary color tokens 的增强 dark mode 支持。

⚡ 性能优化

• LCP 与 Lazy Loading：通过为首页区块实现 lazy loading、修复图片 aspect ratio 问题，并优化整体页面加载表现，改善 Largest Contentful Paint。

♿ 可访问性与 UI 加固

• A11y 与一致性修复：修复对比度问题，统一各页面 spacing 和结构距离，并确保模板整体符合可访问性标准。

🎨 首页重设计

• 视觉重构：重设计首页，加入 animations，刷新 hero section intro，更新 navbar 和 footer 配色，调整 integration blocks 与 blog card 样式，并移除冗余 feature sections，让布局更清爽。

🔗 自定义域名与环境配置

• Custom Domain Support：新增自定义域名配置能力，更新 .env.example 以覆盖更完整的配置变量，并改进环境变量类型，提升校验质量。

🚀 GitHub 部署工作流

• CI/CD Automation：新增 GitHub Actions 部署工作流，用于自动构建和部署，同时在 package.json 中固定 pnpm 版本，提升构建可复现性。

📱 移动端体验

• Mobile Login Fix 与 Avatar Optimization：修复移动设备上的登录流程，并优化用户头像组件，提高跨设备渲染和性能表现。

💳 Pricing 与订阅修复

• Auto-Subscribe Fix：修复用户注册后的自动订阅功能，移除 pricing config 中的 trial days，并更新 blog post card 样式，提高视觉一致性。

🛠️ 开发体验

• Code Quality & Tooling：应用 polish、normalize 和 harden patterns 来优化组件与布局，并新增 @better-auth/cli 作为 dev dependency，用于生成 auth schema。

📝 文档与配置

• Environment 与 Worker Config Updates：更新 worker 配置文件，新增远程数据库环境变量，并改进 .env.example 文档，补充 local base URL 和更清晰的变量说明。

🚀 项目初始化与核心框架

• TanStack Start + Cloudflare Workers：基于 TanStack Start、TanStack Router 和 React 19 初始化全栈项目，运行在 Cloudflare Workers 上，并配置了自定义 server entry、表单处理和文件路由。

🔐 认证与授权

• Better Auth 集成：构建完整认证系统，包含账号密码登录、Google OAuth、密码找回、session 管理、API key 支持、管理员角色，以及带角色过滤的路由保护 middleware 和侧边栏。

🗄️ 数据库与存储

• Cloudflare D1 + Drizzle ORM + R2 Storage：将 Drizzle ORM 与 Cloudflare D1 集成，用于类型安全的数据库操作（用户、sessions、accounts、API keys），并接入 Cloudflare R2 处理文件上传、头像管理，以及带校验和清理逻辑的安全文件访问。

💳 Stripe 支付与账单

• Stripe Payment Processing：集成 Stripe，支持 pricing plans、checkout sessions、customer portal、webhook handling 和 billing card component，并改进错误处理、客户管理，以及支付事件通知。

🏠 Landing Page 与首页区块

• 完整首页：构建包含 Hero、Features、Integrations、FAQs、Testimonials、Call-to-Action、Pricing 和 Newsletter 的完整 landing page，并添加用于 SEO 的 structured data（JSON-LD）。

📝 博客、内容与法律页面

• 博客系统与内容页面：基于 Content Collections 实现博客、Markdown 渲染、分页和 SEO。新增 About、Contact、Waitlist、Privacy Policy、Terms of Service 和 Cookie Policy 页面，并通过文件路由暴露。

🎨 主题与 UI 组件

• Theme System & Internationalization：构建 light/dark/system 主题切换，支持 SSR-safe 渲染（ScriptOnce），添加中文翻译以支持本地化，并提供 Chart、Drawer、Table、Tabs 等丰富 UI 组件。

📊 SEO、分析与通知

• SEO 与多 Provider 分析：实现动态 sitemap.xml、robots.txt、canonical URLs、PWA manifest，以及统一的分析集成（Ahrefs、Clarity、Google、Plausible、Umami）。新增 Discord 和 Feishu webhook notification providers。

📧 邮件与 Newsletter

• Resend Email 与 Newsletter Subscription：集成 Resend 发送事务邮件（密码找回、邮箱验证）并配合 Toaster 通知，同时加入 newsletter subscribe/unsubscribe APIs，以及注册后自动订阅能力。

🛠️ Admin Dashboard 与开发体验

• Admin Dashboard 与 DX Tooling：构建 admin user management，支持列表、排序、筛选和账单。新增 T3 Environment 类型安全环境变量、AGENTS.md 文档、EditorConfig、Biome linting config 和 Crisp Chat 集成。