更新日志

站点样式按页型加载，非文章页首屏 CSS 减少 14 KB

2026-10-10T14:45:00+08:00

上一阶段留下的选择

阶段 A 把 2016 行的单体 custom.css 拆成 29 个分片，但构建产物仍是一个文件、每个页面全量加载。这一阶段让「只在某些页型出现的样式」只在该页型加载。

拆分依据（先量后拆）

层叠零冲突：候选页级分片与全站分片的选择器零重合，候选之间也零重合。审计工具本轮修正了一个过严的冲突判据：原先「两组声明集合不同」即算冲突，会把「B 只是 A 的子集、同值」误报；正确判据是「同一属性被赋了不同值」。
跨页共用的规则组不撕开：special-components.css 一条选择器列表同时服务 changelog / gallery / 404 / privacy / ai-news / stats 六个页型，按页拆会把一条逻辑规则撕成六份换来每页几百字节，因此刻意留在全站包（改名 components/special-pages.css）。

结构调整

规则简化为「目录决定加载范围」：

位置	加载范围
`assets/css/custom.css`	全站（聚合根：`@charset` + 23 条 `@import`）
`assets/css/custom/{foundation,layout,components}/`	全站（被聚合根内联）
`assets/css/custom/pages/<页型>.css`	只在该页型（文件名 = 主题的页型键）
`assets/css/custom/pages/post/*.css`	跟随 `pages/post.css`

主题 styles.html 新增站点页级注入点（约 13 行，与主题自己的 pages/*.css 逻辑同构）：按同一套页型键取 css/custom/pages/<键>.css，缺失即跳过，输出带 data-solitude-custom-page 标记；排在 css/custom.css 之后，保证站点覆盖层最后生效。页级包内部用 @import 组合、构建期内联，因此每个页型最多只多出一个 。

验收中发现并修掉的一个真回归

静态门（下节）抓出：pages/post/tags.css 里三条规则的选择器列表把「文末标签」和「移动端侧栏标签云」写在了一起 ——

#post .post-meta__tags,
#post .post-meta__tags .tags-punctuation,
#sidebar #sidebar-menus .card-tag-cloud a { … }

侧栏标签云在每个页面都存在，把整个分片划给文章页会让非文章页的移动端侧栏标签云掉样式。修法：按选择器把跨界规则拆开，全局部分独立成 components/tag-cloud.css（含 /tags/ 页的标签计数徽标），文章页分片只留 #post … 的部分。这是阶段 A 的分片边界留下的隐藏跨界 —— 当时按原文件的注释分区切分，而注释的粒度不等于作用域。

两道互补的机械门

按页加载只在两个方向会静默出事，各配一道门：

有效声明等价（改样式）：对每个页型，把「该页实际加载的全部产物」与「拆分前的全量产物」展开到单选择器粒度，逐属性比对最终生效声明。
- 必须展开到单选择器：压缩器会把相邻同声明规则合并成多选择器规则，按规则键比对会误报。
- 必须产物比产物：压缩器会改写颜色/数值（#ffffff→#fff），拿源码比产物同样会误报。
- 结果：文章页 392 个单选择器 / 关于页 323 / 留言板 326 / 其它页型 317，声明不一致均为 0；「仅拆分前有」的全部是该页不该加载的页级包。
不丢样式（丢样式）：逐个已构建页面检查「该页含某页级包选择器所需的类名/id，却没有加载该包」—— 判据取源码侧规则（含 @media 上下文），对每个页面 × 桌面/移动两种视口核验。结果：0 处。

外加工具侧不变式：node scripts/css-split-audit.mjs 现在会展开每个页级包的 @import 链，检查空包、与全站包冲突、页级包两两冲突。之所以必须零冲突 —— swup 无刷新切页时样式表只增不减，访问过文章页再切到关于页，pages/post.css 会一直留在 DOM 里；一旦有冲突，同一个页面的样子就会随「你从哪一页走过来」而变。

收益

页型	之前	之后
首页 / 归档 / 标签 / 友链 / 说说 / 音乐 / 隐私 / 统计 / 404 / 更新日志 / 相册 …	43.5 KB（1 个请求）	29.6 KB（1 个请求）
文章页	43.5 KB	29.6 KB + 11.7 KB（2 个并行请求）
关于页 / 留言板	43.5 KB	29.6 KB + 1.0 KB / 1.3 KB

首屏渲染阻塞 CSS 在绝大多数页型上减少约 14 KB。

其他

审计工具新增 expandCssFiles / auditPageScope / splitSelectorList / explodeDeclarations，测试 39 → 47 pass。
构建 0 error；CI 双产物断言通过；样式分片审计 [ok]；主题页级 CSS 与本轮改动零冲突。

站点样式按页面与组件拆分为分片，新增分片审计工具

2026-10-10T14:00:00+08:00

为何要拆

assets/css/custom.css 是站点纸张风格覆盖层，此前是 2016 行 / 59.4 KB 的单体文件，导航、卡片、页脚、移动端、文章排版、关于页、留言板、投票评分全混在一起。改一处字体大小要在两千行里找归属，新加页面样式也没有明确落点，几周就会继续膨胀。

拆分方式

按文件里既有的分区注释逐字节切片，落到 assets/css/custom/{foundation,layout,components,pages}/，共 29 个分片（目录分类与主题 assets/css/solitude/ 同构）。
assets/css/custom.css 退化为聚合根：只保留 @charset 与 29 条 @import，导入顺序严格等于拆分前的行序。css.Build 会把 @import 内联，因此构建产物仍是一个 css/custom..css —— 请求数、首屏字节、层叠顺序全都不变。
主题的 styles.html 一行未改（resources.Get "css/custom.css" 与 targetPath 都保持原样），改的是源文件组织方式。

为什么坚持「顺序即语义」：这条覆盖层是无 layer 的，靠「最后加载 + 不分层」压过主题全部 @layer solitude.*，中间还隔着主题里未分层的 vendor 与 overrides.css 规则。分片一旦重排或改成 @layer，同权重选择器的胜负会静默翻转 —— 所以聚合根里写明了「勿重排、勿增删、勿分层」。

等价性验证

生产产物逐字节一致：拆分前后各跑一次 hugo --minify，产物文件名（内容哈希）与 SHA-256 完全相同 —— 浏览器收到的字节没变，层叠结果可证明未变。
开发模式规则序列一致：243 条规则对 243 条，唯一差异是构建管线按 target 自动补的 -webkit-backdrop-filter（拆分前的产物里也有同一条前缀），属管线行为而非拆分差异。
无路径泄漏：生产产物确认不含开发模式的 ns-hugo-imp 批注、Windows 绝对路径与残留 @import。

新增工具：`scripts/css-split-audit.mjs`

拆分会引入一类肉眼极难发现的问题（分片漏引、文件放错位置、顺序被改），所以配了机械审计：

默认模式：查「聚合根 ↔ 分片目录」是否一一对应 —— 缺失 / 空片 / 孤儿文件 / 重复 @import / 分片内 @charset 或嵌套 @import / 聚合根里被直接写了规则。
--compare A B：比对两份 CSS 产物是否等价，先比字节，不等时退化为「有序规则序列」比对，并区分「缺规则 / 多规则 / 仅顺序不同」。
--overlap A B：列出两组分片共享的选择器。这条是为将来「真实按页加载」把关 —— 两组选择器不相交，它们的相对加载顺序才与层叠无关。

工具内置一个极简 CSS 扫描器（正确处理注释、字符串、未加引号的 url()、@media/@keyframes 嵌套），并附带 26 个 node:test 用例（含属性选择器引号、An+B 空白、函数参数内空白等易误报形态的归一化）。

兼容性与维护约定

未引入新依赖，未改主题，未改任何模板；CSS 片段内容除文件末尾补了一个换行外逐字节继承。
之后新增样式：先找归属分片，确实要新建分片就追加到聚合根 @import 末尾，并跑一次 node scripts/css-split-audit.mjs。约定与分片清单已写入 docs/agents.md。

Cookie 同意真正生效：拒绝非必要即拦截统计与访客定位

2026-10-10T13:00:00+08:00

问题

Cookie 弹窗的「拒绝非必要」此前只是写了一条 solitude_cookie_consent Cookie 就把弹窗关掉，页面上其余脚本照常加载：

Umami 统计脚本写在 hugo.yaml 的 extends.head 里，是普通的 defer 脚本，渲染在；而弹窗逻辑在 body 末尾的 js/solitude.js 里，同样是 deferred。按规范 deferred 脚本严格按文档顺序执行，统计永远先于弹窗判定跑完，事后知道用户拒绝了也没有意义。
访客定位卡（ip-welcome）在页面加载时就直接请求 60s-api、ipify、ipapi.co 等接口，完全不看同意状态。

修复

拦截前移到

extends.head 里的 Umami 标签改为惰性标记：