前言#

折腾博客这件事，大概是每个技术人都逃不过的「宿命」。

从最初选择 Astro + Fuwari 搭建静态博客，到现在一步步加上各种花活儿，这个过程既痛苦又快乐。趁着记忆还新鲜，把这次升级的心路历程记录下来。

🌤️ 天气组件：让博客「知冷知热」#

这是我最喜欢的一个功能。侧边栏的天气小组件能自动根据访客的位置显示当地天气，还会贴心地给出一句问候语——

• 下雨天提醒带伞 ☔
• 大热天劝你多喝水 🧊
• 晴朗时祝你心情愉快 🌈

技术上采用了多级定位后备策略：

1. 浏览器 GPS（静默获取，不弹窗打扰）
2. localStorage 缓存（30 分钟有效）
3. Cloudflare IP 地理信息
4. 第三方 IP API 后备
5. 默认城市兜底

数据来自 Open-Meteo 的免费 API，通过 Cloudflare Worker 代理转发，完全不需要付费。

✨ AI 文章摘要：让机器帮你读#

这个功能解决了一个实际问题：有些文章我懒得写 description，但首页卡片又需要一段摘要。

解决方案是：如果文章没有手动设置描述，前端会自动调用 Cloudflare Workers AI（Llama 3.1）生成一段中文摘要，并在卡片上显示一个 ✨ AI 徽章，让读者知道这是 AI 生成的。

整个过程对有手写描述的文章零影响——优雅降级，这是我一直坚持的设计原则。

🎵 音乐播放器：写代码的 BGM#

博客左侧栏集成了一个迷你音乐播放器，数据来自网易云歌单。虽然功能不复杂，但调试 Meting API 的过程真是一言难尽……

最终的方案是配置了主备两个 API 端点，确保即使一个挂了，音乐也能继续播放。

📊 访客统计：用 Umami 替代 Google Analytics#

隐私友好是我选择 Umami 的核心原因。通过 Cloudflare Worker 代理 Umami API，在页脚实时显示：

• 当前在线人数 👁️
• 今日访问量 📈
• 本月总访问 📊

所有数据都不依赖第三方 Cookie，对访客完全透明。

🔧 其他小改进#

• 打赏组件：悬浮弹出微信/支付宝收款码
• 分享海报：一键生成精美的文章分享卡片
• 暗色模式：全站适配，包括天气组件和代码块
• 自动版权年份：页脚的 © 年份永远是最新的

写在最后#

折腾博客的过程就像装修房子，永远觉得「还差一点就完美了」。但正是这种永不满足的心态，推动我不断学习新技术、尝试新想法。

如果你也在搭建自己的博客，希望这篇文章能给你一些灵感。记住，最好的博客不是功能最多的，而是你愿意持续写下去的那个。

工具只是载体，内容才是灵魂。