[JiTianYu391]

改了什么

把 docs/ 官网 11 个页面的视觉整体改成深色科技风，并加入一套滚动和交互动画。

样式

• 配色改为近黑底 + 紫→青渐变，标题改为无衬线粗体；默认深色，浅色仍可切换并会被记住
• 玻璃质感卡片、首屏极光与网格背景、渐变标题、终端窗口栏、卡片鼠标跟随高光、状态徽标呼吸点
• 所有颜色 token 通过 WCAG AA 对比度检查（check_tokens_contrast.py）

动画（新文件 docs/js/motion.js，基于 GSAP + ScrollTrigger + SplitText + Lenis）

• 平滑滚动、阅读进度条、页眉向下滚收起 / 向上滚出现
• 首屏标题逐行 / 逐字入场；首页三层示意图逐层拼装，连线描边后变成流动虚线
• 小节标题逐字浮现、卡片 3D 翻入、条形图生长、数字滚动、终端逐行打出
• 项目卡片 3D 倾斜、按钮磁吸、导航跟随滑块、页脚超大字标
• 主题切换用 View Transitions 圆形展开；同站跳转有跨页面转场（Firefox 正式版暂不支持，照常跳转）

依赖

• GSAP 3.15.1、Lenis 1.3.27 放在 docs/js/vendor/ 本地加载，不依赖 CDN；版本与许可见 docs/js/vendor/README.md（GSAP 为其 Standard "No Charge" License，Lenis 为 MIT）
• tools/sync_docs_chrome.py 新增 VENDOR_SCRIPTS，统一写入各页页脚

CI 规则调整

• tools/checks/check_design_layer.py：@keyframes 内和白名单中的装饰伪元素（.spot 高光）可以使用 opacity；静态内容使用透明度仍然会被拦下

兜底

• 没有 JavaScript、脚本加载失败（3 秒后自动放弃）、或系统开启"减少动态效果"时，页面都退回静态，内容不会被隐藏

验证

• check_tokens_contrast.py、check_design_layer.py、check_docs_html.py、check_ota_manifest.py、sync_docs_chrome.py --check、ruff check tools/ 全部通过
• 用 Playwright（Chromium）在 1440 和 390 宽度、深浅两套主题下逐页检查：无控制台报错、无横向滚动、滚到底后无内容被隐藏；无 JS 与减少动态效果两种情况页面完整显示
• 未在 Safari / Firefox / 真机上测试

---

Generated by Claude Code