Firefly 主题魔改（KeMiaoBlog）

动态说说系统#

• Memos 实时数据源 - 动态页通过同源代理 /api/memos.json 对接自部署 Memos 实例，支持用户过滤、标签预筛与正文标签隐藏
• 说说卡片 - 标签点击筛选、全文搜索、年份归档、图片画廊、锚点分享
• 行内评论 - 每条说说卡片内嵌评论区，与主评论系统共用配置
• 说说点赞 - 接入自部署 star-vote 实例，localStorage 防重复点赞、乐观更新、明暗模式自适应

社交与互动页面#

• 朋友圈（FCircle）重构 - 统计面板、随机漫游卡片、列表卡片三种视图，可独立开关
• 友链系统增强 - 远程友链自动同步、友链墓碑、访客友链申请表单
• 更新日志时间线 - 独立 changelog 内容集合，版本时间线展示
• 纪念倒计时页 - 十周年倒计时页面，支持配置目标日期

站点体验#

• 自定义右键菜单 - 全站自研右键菜单，样式与功能可配置
• AI 文章摘要 - 构建时生成文章摘要，角标交互展开
• 外链中转 - go 跳转页 + rehype 外链处理插件，防来源泄露
• 欢迎提示与时钟 - 访客 IP 欢迎 Toast、侧栏欢迎时钟（接入和风天气）
• 页脚翻页时钟 - 建站时长翻页钟组件
• FPS 帧率监视器 - 可选的帧率悬浮监控
• GitHub 卡片管理器 - 构建时拉取仓库信息并缓存，正文实时渲染仓库卡片
• 首页推荐轮播与聚光灯 - 首页特色内容轮播、Spotlight 布局增强
• Umami 统计 - 接入 Umami 分析与侧栏统计组件，兼容 GA / Clarity / 51la

工程化#

• SWPP 缓存 - Service Worker 增量缓存与版本更新
• 构建流水线 - 字体子集化、内联脚本压缩、LQIP 占位图生成、VNDB 封面预取、Pagefind 索引
• 多平台部署 - Vercel / Cloudflare Workers / EdgeOne 配置与 CI 就绪

环境要求#

• Node.js ≥ 22
• pnpm ≥ 11

本地开发#

1
git clone https://github.com/kmoretti/Firefly.git
2
cd Firefly
3
pnpm install
4
pnpm dev

博客将在 http://localhost:4321 可用，站点功能通过 src/config/ 目录下的配置文件自定义。

构建与部署#

1
pnpm build
2
pnpm preview

仓库内置 Vercel（vercel.json）、Cloudflare Workers（wrangler.jsonc）与 EdgeOne 部署配置，主流平台可直接导入并自动识别 Astro 框架预设，构建命令 pnpm build、输出目录 dist。