线上 /about 白屏排查(§16):30 条路由 + 6 种环境里唯一可复现的缺陷是 webkit/chromium + prefers-reduced-motion:reduce ⇒ pageerror #418,main 内 14 个元素 opacity 恒 0(正常环境只有 3 个首屏以下的滚动入场项)。 根因:useReducedMotion 用 window.matchMedia 作 useState 初值 ⇒ SSR false、客户端首帧 true; scroll-reveal / template / page-transition 又用它决定 initial/variants/甚至早返回不同树结构, 与 SSR HTML 不一致;且 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。 修法(结构恒定,减少动效改用「时长 0」表达): - hook 首帧恒 false,挂载后 effect 同步真实偏好; - ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空; - template.tsx 与 StaggerChildren 去掉早返回裸结构,改空 variants。 回归守卫 e2e/reduced-motion-hydration.spec.ts(/about 与 /):断言 reduce 自证生效、 无 hydration 错误、h1 与末段标题 opacity=1。变异验证:hook 改回 matchMedia 初值 ⇒ 2 红,恢复 ⇒ 2 绿。 另:runbook 明确禁止对 dist/_next/static 用 --delete(回访者旧 HTML 会引用上一代 chunk); 本轮已从备份 --ignore-existing 合并回旧代 101 个文件。复算:tsc/type-check:e2e 0、 jest 35 套件 462 例 0、check:visual 0、check:motion 0、视觉 chromium-desktop 25/25。
Novalon Website 文档
欢迎来到Novalon Website项目文档中心。这里包含了项目的所有技术文档、开发指南和部署说明。
文档导航
📚 架构文档
💻 开发文档
🚀 部署文档
🧪 测试文档
🔌 API文档
📖 使用指南
项目概述
Novalon Website是四川睿新致远科技有限公司的企业官网,采用现代化的技术栈构建。
技术栈
- 框架: Next.js 16 + React 19
- 语言: TypeScript
- 样式: Tailwind CSS
- 数据库: SQLite + Drizzle ORM
- 认证: NextAuth.js
- 测试: Playwright + Jest
核心功能
- 企业展示和产品服务介绍
- 成功案例和新闻动态
- 在线咨询和联系表单
- CMS内容管理后台
- 响应式设计和SEO优化
快速链接
贡献指南
文档更新
- 确保文档内容准确、清晰
- 使用Markdown格式编写
- 添加必要的代码示例
- 更新相关链接和引用
文档审查
- 技术准确性
- 内容完整性
- 格式规范性
- 链接有效性
获取帮助
如果在使用过程中遇到问题,可以:
- 查看相关文档
- 搜索故障排查指南
- 联系开发团队
文档版本
- 版本: 1.0.0
- 更新日期: 2026-03-24
- 维护者: 开发团队
© 2026 四川睿新致远科技有限公司