Epic Stack 2025-03-22 版本发布：原生 SQLite 支持与密码安全增强

项目简介

Epic Stack 是一个现代化的全栈 Web 开发框架，集成了 React、TypeScript、Prisma 等前沿技术，提供了开箱即用的最佳实践方案。本次更新带来了数据库层和安全性的重要改进。

核心更新内容

1. 原生 SQLite 支持替代 better-sqlite3

本次版本移除了对 better-sqlite3 的依赖，转而使用 Node.js 内置的 SQLite 支持。这一变化带来了几个显著优势：

• 减少依赖项：消除了对第三方 SQLite 绑定的依赖，简化了项目结构
• 更好的兼容性：直接使用 Node.js 原生实现，避免了可能的环境兼容性问题
• 性能优化：原生集成通常能提供更优的性能表现
• 维护简化：减少了需要跟踪更新的依赖项数量

对于开发者而言，这一变化几乎是无感知的，所有现有功能保持兼容，同时获得了更稳定的基础。

2. 渐进式密码安全检查增强

新版本引入了基于 haveibeenpwned API 的密码安全检查机制，采用"渐进式增强"策略：

• 常见密码检测：在用户注册或修改密码时，系统会检查密码是否属于已知泄露的常见密码
• 隐私保护设计：采用 k-anonymity 技术，只发送密码哈希的前缀到 API，保护用户隐私
• 渐进式反馈：提供清晰的错误提示，引导用户选择更安全的密码
• 可配置策略：允许开发者根据需求调整密码强度要求

这一功能显著提升了应用的安全性，帮助用户避免使用容易被猜测的密码，同时保持了良好的用户体验。

3. Playwright 测试配置优化

通过升级 @epic-web/config，测试配置获得了多项改进：

• 更智能的测试规则：新增了针对 Playwright 测试的专用规则集
• 错误预防：增加了防止常见测试错误的规则
• 最佳实践引导：通过 lint 规则引导开发者编写更可靠的测试
• 配置简化：预置配置减少了项目初始化的工作量

这些改进使得端到端测试更加可靠和易于维护，提升了整体测试体验。

4. Sentry 错误监控集成优化

错误监控系统获得了多项增强：

• 采样策略改进：移除了过时的 samplerate 配置，全面采用更灵活的 tracesSampler
• 错误追踪优化：改进了错误上下文收集机制
• 性能监控增强：提供了更精细的性能数据采集
• 配置简化：减少了必要的配置项，同时保持了灵活性

这些改进使得生产环境的问题诊断更加高效，同时降低了系统开销。

其他重要改进

• 图片优化文档更新：完善了关于图片优化的最佳实践指南
• OpenImg 升级：更新至 v0.6 版本，带来更好的图片处理性能
• UI 修复：解决了 Notes 页面高度问题和个人资料名称清除问题
• 监控仪表板更新：优化了 Grafana 仪表板的访问链接

升级建议

对于现有项目，建议按以下步骤升级：

1. 备份当前项目
2. 更新 package.json 中的依赖版本
3. 运行迁移脚本处理数据库变更
4. 测试关键功能，特别是与密码验证相关的流程
5. 检查测试配置是否需要调整

本次更新包含多项重要改进，特别是在安全性和基础架构方面，建议所有项目尽快升级以获取这些优势。