Soul — UpXuu 博客的灵魂

本文件记录这个项目的「灵魂」：设计语言、核心原则与不可妥协的红线。 每次改动都要先想：它符合这个灵魂吗？

设计语言：Toy Brick Brutalism（玩具砖块粗野主义）

• 主色 #0284c7（sky-500），次级 #0ea5e9，点缀 #f59e0b，背景 #faf8f5
• 标志性元素：border-4 border-sky-500 shadow-[4px_4px_0px_0px_#0284c7] 叠影边框
• 手绘质感、粗边框、硬阴影、圆角克制——像乐高砖块一样有重量感
• 大胆但干净，可爱但不幼稚，活泼但不廉价

人格

• 一位初中生前端开发者的个人博客，主域名 upxuu.com
• 内容中文为主，SEO 元数据中英双语
• 真诚、碎碎念、热爱折腾（hardly）；口号 "逐光而上！"
• 不端着、不装，代码和文字都像真实的人写出来的

核心技术原则

• Astro 6 SSG，无 SSR，全部静态生成
• React 19 负责复杂交互岛，Svelte 5 负责轻交互岛
• Tailwind v4（CSS 配置，无 tailwind.config.js）
• 必须兼容华为旧浏览器——现代 CSS（oklch/@layer/@property）需 Lightning CSS 降级
• 本地禁止构建，服务器 Caddy + CI 负责构建部署

爬虫友好红线

• 爬虫 UA 命中 Googlebot|bingbot|Baiduspider|Sogou|360spider|Yandex|DuckDuckBot 时，Caddy 内部 rewrite 到 /bot/ 优化页（URL 不变）
• bot 页面：纯 HTML、零 JS，完整 SEO meta（title/description/canonical/OG/JSON-LD）
• bot 页 title 必须与真人页一致（用 seoConfig.titleTemplate），避免 duplicate title

性能红线

• 字体用 <link> 加载，不用 CSS @import（避免 render-blocking）
• Cloudflare：HTML max-age=60, s-maxage=0；/_astro/* immutable 1 年；ai.love7.top no-store
• 内联关键脚本放 <head>，尽量 defer / client:load / client:visible

分析

• Umami 访问统计（自建，stats.upxuu.com）
• Microsoft Clarity 热力图/录屏（uziyyjxiky）

不可妥协

1. 每次改动都要保持 Toy Brick Brutalism 视觉语言
2. 不破坏爬虫索引（bot 页、canonical、SEO meta）
3. 不引入会破坏旧浏览器兼容的 CSS
4. 不在本地构建，构建交给服务器
5. 每次改完立即提交并推送（用户明确要求）