心是桃源，处处水云

1. 配置与隐私：Umami 统计从“硬编码”切换为“环境变量”#

这次最大的方向之一，是把统计相关的敏感信息从仓库源码里移走。

2. 构建性能：Rollup 手动拆包（manualChunks）#

为了让首屏与缓存更稳定，本次在 astro.config.mjs 增加了 rollupOptions.output.manualChunks，将部分重依赖从 node_modules 中拆出来。

3. 页面体验：主题默认值更贴近系统偏好#

在布局（src/layouts/Layout.astro）里，主题读取逻辑做了增强：

• 如果本地没有存储 theme，会读取系统 prefers-color-scheme。
• 让首次访问的默认主题更符合用户系统设置。

4. 轮播稳定性：统一清理 interval，避免切页后残留#

同样是在 src/layouts/Layout.astro，轮播逻辑引入了全局 interval 状态与 cleanupCarousel()：

• 在初始化轮播前先清理可能存在的旧定时器。
• 在触摸暂停、鼠标悬停、以及页面跳转（swup）等时机主动清理。

这类改动的目标很明确：避免轮播重复启动、多个 interval 叠加、切页后仍在后台运行。

5. 订阅输出：Atom/RSS 生成更健壮（XML 转义）#

在 src/pages/atom.xml.ts 新增了 escapeXml()，并对 title/subtitle/summary/author/category 等字段做 XML 转义。

6. 搜索组件：事件与定时器清理 + 样式隔离，减少“残留”和安全风险#

src/components/Search.svelte 做了两类增强：

7. 移动目录（MobileTOC）：滚动节流 + 监听器可正确移除#

src/components/MobileTOC.svelte 的改动重点是性能与可维护性：

• 新增 throttle() 对滚动更新做节流（降低滚动时的计算频率）。
• popstate 监听使用可复用引用，卸载时能正确移除。
• scroll 监听使用 { passive: true }，更友好。

8. 加密文章：密钥派生从 bcrypt 子串切换为 SHA256(password)#

这是一项“行为层面”的改动，涉及：

• src/pages/posts/[...slug].astro（服务端加密）
• src/components/PasswordProtection.astro（前端解密）

现在加密/解密都使用：

• CryptoJS.SHA256(password).toString()

9. 评论 Twikoo：重试加上上限，避免无限循环#

src/components/comment/Twikoo.astro 增加了最大重试次数：

• 最多重试 20 次（约 10 秒）
• 超时后停止初始化并输出 warn

10. 图片加载：ImageWrapper 支持 loading/decoding#

src/components/misc/ImageWrapper.astro 新增参数：

• loading（默认 lazy）
• decoding（默认 async）

让你在需要“首屏必须立刻显示”的图片场景，可以显式切到 eager。

11. 外链安全：补齐 noopener/noreferrer#

多个页面与组件对 target="_blank" 的外链补充或统一了 rel="noopener noreferrer"，覆盖范围包括：

• License、Profile、friends/projects/timeline 等页面/组件

目的是避免 window.opener 带来的潜在安全风险。

12. 音乐播放器与樱花特效：统一解决“监听器移除失败”与资源清理#

• src/components/widget/MusicPlayer.svelte
  • 将匿名监听器改为可追踪 handler，并在销毁时统一移除。
• src/utils/sakura-manager.ts
  • 缓存 resize handler 引用，确保 removeEventListener 有效。

这类改动通常不“显眼”，但对长时间使用、频繁切页的站点非常关键。

部署前自检清单（建议）#

• Umami
  • UMAMI_API_KEY 是否已在环境变量配置？
  • UMAMI_WEBSITE_ID 是否已在环境变量配置？
• 加密文章
  • 是否存在历史加密文章？如果有，确认是否需要重新加密/迁移。
• 构建与缓存
  • 拆包后 chunk 名称变化，CDN 缓存/预加载策略是否仍然匹配？
• 订阅
  • 用一个 RSS/Atom 阅读器（或在线校验工具）验证 atom.xml 是否可解析。

如果你希望我把这篇文章的语气改得更“叙事化”（更像你 01/18 那种文风），或者需要我顺手加一张封面图字段 image: "./1.png" 并放入图片文件，我也可以继续帮你补齐。