巧的是，笔者自己的博客在 2026-09-12 也刚把评论系统从 Giscus 迁到了自建后端。所以看到这篇教程时，与其说是”学新东西”，不如说是拿到一份现成的对照样本——同样的起点（逃离 Giscus）、同样的栈（Astro + Svelte），却走了不同的存储与部署路线。下面先整理原作者怎么做，再逐项和笔者的方案比。

侧边栏那张 AI 生成的紫鸟头像挂了几个月，越看越不搭；顺带想把站点名字换成手写签名。这篇记录整轮返工：从公共图库选图、发现头像框其实是圆角方形、用 sharp 裁切上色，到用 opentype.js 取字形轮廓做签名、借 CSS mask 让签名颜色跟随主题色，最后补上「短横 + 一句话」的落款。附三个真踩到的坑。

GitHub 账号被风控，Giscus 评论连同历史数据一起消失。索性自己造一个——用 Cloudflare Workers + D1 写了套评论后端，访客不用登录任何账号就能留言，支持引用回复，数据握在自己手里。

Fuwari 首页的文章卡片默认会把过长的标题和摘要直接截断（ellipsis / line-clamp），看不全又没处展开。这篇记录我对卡片组件做的两个小魔改：标题超出一行时默认暂停、悬停才像跑马灯一样滚出全文；摘要被截断时悬停弹出固定定位浮层展示完整内容。全部在 src/components/PostCard.astro 一个文件里完成，并重点讲清楚 Swup 无刷新导航下不失效、暗色模式文字不丢色、以及躲开 overflow:hidden 裁剪这几个坑。

博客右侧竖排的五个悬浮按钮——回到顶部、回首页、随机一篇、目录、跳转评论区。原版 Fuwari 只有一个孤零零的回顶部按钮，这篇文章记录我如何把它改造成五合一工具栏：fixed 定位的两层 pointer-events 处理、全走主题变量的暗色适配、SSR 预判显隐、抽屉式目录，以及在 Swup 无刷新导航下不失控的一堆细节。

逛博客看到别人侧边栏有个「距离」卡片，能显示访客离博主多远。拆解后发现原站用的是付费 IP 接口，而免费的公共 API 一个接一个挂掉。于是换了个思路：在自家评论 Worker 上加个端点，直接读 Cloudflare 边缘自带的地理数据。后来又发现边缘数据在中国常常只到市级、还会把整段 IP 判错，于是再给服务端补了一层国内 IP 库，精度补到区级。

博客默认字体看腻了？本文记录如何在 Fuwari（Astro 5 + Tailwind 3）里把全局正文字体换成自己喜欢的字体（以霞鹜文楷为例）——从放字体文件、写 @font-face、改 Tailwind 配置到代码块字体一并讲清，并修正原教程里的几个过时坑。

从照着开源项目搭一个 PV/UV 计数器，到把它换成零依赖的自研 Workers + D1 后端，再给侧边栏加一张三格统计卡。中间还经历了一次真实事故：后端域名悄悄下线两天、埋点全程静默失败——而数据其实一条没丢。含表结构、三个统计口径、Swup 接入与三个只有踩过才知道的坑。