第一次发帖，有点小紧张 x

以前使用 Shoka 主题，但无奈性能感觉跟不上了，再加上自己又是前端开发者，于是写了一个博客主题，感觉功能差不多了打算发一下，鞭策自己更新。

一个萌系 / 二次元 / 粉蓝配色的博客主题，适合 ACG 、前端、手账向个人站，性能优异。

命名灵感来源于 “小春日和”（こはるびより）指的是晚秋到初冬这段时期，持续的一段似春天般温暖的晴天。也就是中文中的 "小阳春"。

博客整体设计灵感来自 Hexo 的 Shoka 主题，用更现代的技术栈打造属于你的个人博客。

• 基于 Astro，静态输出，加载轻快
• 萌系 / 二次元 / 粉蓝配色，适合 ACG 、前端、手账向个人站
• 支持多分类、多标签，但不会强迫你用复杂信息架构
• 尽可能的减少性能开销
• 使用 pagefind 实现无后端的全站搜索
• LQIP （低质量图片占位符），图片加载前显示渐变色占位
• 评论组件可选 Waline / Giscus / Remark42

已经在 astro 主题商店上架啦～

主题： Koharu | Astro

我的博客： https://blog.cosine.ren

开源在 GitHub - cosZone/astro-koharu: astro-koharu 是一个萌系 / 二次元 / 粉蓝配色的 astro 主题博客，灵感来自 Hexo 的 Shoka 主题，加了很多自己的小巧思，性能优越。

是用爱发电的个人项目，喜欢的话欢迎 star 或者 fork 出去改～

持续迭代中，还有挺多 bug 在改，技术栈也挺激进的，不过我个人用起来很喜欢，毕竟就是照着自己喜欢的风格写的，还有很多小巧思不知道有没有人会探索到～

几篇关于实现过程中的技术解析文章：

• Fork 主题如何更新？基于 Ink 构建主题更新 CLI 工具
• 在 Astro 博客中实现 LQIP （低质量图片占位符）
• 为 Astro 博客添加可插拔的圣诞特效模块
• astro-koharu 使用指南

功能特性

• 基于 Astro 5.x，静态站点生成，性能优异
• 优雅的深色 / 浅色主题切换
• 基于 Pagefind 的无后端全站搜索
• 可更换评论系统：支持 Waline（推荐）、Giscus、Remark42 三种评论组件，配置文件一键切换，主题自动跟随
• 完整的 Markdown 增强功能（GFM、代码高亮、自动目录、Mermaid 图表、Infographic 信息图）
• 灵活的多级分类与标签系统
• [可开关] 多系列文章支持（周刊、书摘等自定义系列，支持自定义 URL slug）
• 响应式设计
• 草稿与置顶功能
• 阅读进度条与阅读时间估算
• 智能目录导航，支持 CSS 计数器自动编号（可按文章关闭）
• 移动端文章阅读头部（显示当前章节标题、圆形阅读进度、可展开目录）
• 友链系统与归档页面
• RSS 订阅支持
• 支持 LQIP：图片加载前显示渐变色占位，提升视觉体验
• [可开关] 基于语义相似度的智能文章推荐系统，使用 transformers.js 在本地生成文章嵌入向量，计算文章间的语义相似度
• [可开关] AI 自动摘要生成，自动生成摘要。
• [可开关] 圣诞特辑：包含雪花飘落、圣诞配色、圣诞帽装饰、灯串装饰等节日氛围效果
• 无后端站点公告系统：可通过配置文件管理公告，支持时间控制、多条公告堆叠、自定义颜色、hover 已读
• 有样式的 RSS 订阅源链接
• Koharu CLI：交互式命令行工具，支持备份 / 还原、内容生成、备份管理

Koharu CLI

博客自带交互式 CLI 工具，方便管理博客内容：

pnpm koharu              # 交互式主菜单
pnpm koharu backup       # 备份博客内容和配置
pnpm koharu restore      # 从备份恢复
pnpm koharu update       # 更新主题
pnpm koharu generate     # 生成内容资产 (LQIP, 相似度, AI 摘要)
pnpm koharu clean        # 清理旧备份
pnpm koharu list         # 查看所有备份 

备份与还原

更新主题

使用 CLI 自动更新主题（会自动备份 → 拉取 → 合并 → 安装依赖）：

# 完整更新流程（默认会先备份）
pnpm koharu update

# 仅检查更新
pnpm koharu update --check

# 跳过备份直接更新
pnpm koharu update --skip-backup

配置说明

博客配置统一使用 config/site.yaml 文件管理，包括：

• 站点基本信息（标题、副标题、作者等）
• 社交媒体链接
• 导航菜单
• 特色分类和周刊配置
• 分类映射（中文分类名 → URL slug）
• 友链列表
• 公告系统
• 评论系统（Waline / Giscus / Remark42，推荐使用 Waline）
• 数据统计（Umami）
• 圣诞特辑开关

详细配置说明请参考文档。

评论系统切换

在 config/site.yaml 中通过 comment.provider 字段一键切换评论系统：

comment: provider: waline # 'waline' | 'giscus' | 'remark42' | 'none' waline: serverURL: https://your-waline-server.vercel.app # ... 其他配置 

推荐使用 Waline：自部署简单、功能丰富（Markdown、表情、邮件通知）、带访问量统计。详细配置请参考完整使用指南。

文档

• 快速开始 - 启动你的博客
• 更新主题 - 如何安全地更新到新版本
• 完整使用指南 - 所有功能的详细配置和使用方法

性能优异：目标是 PC 的全绿，但是随着功能迭代不可避免的需要反复检查！

我的工作流是一个围绕 superpowers 插件 的 Loop，superpowers 的理念是：先思考再动手。当你提出一个需求，不会急于写代码，而是先退一步问你"你真正想要实现什么"，通过对话梳理出完整的设计方案，再分步执行。

核心设计是 master 和 worker 分离。

• 脑暴会话 (master)：专注于思考和设计，输出高质量的设计文档和执行计划
• 执行会话 (worker)：专注于代码实现，执行详细的计划

1、需求录入 - 首先我会在 Zed 上进行需求录入，采用 md 格式。这一步非常重要，我大概有 30% 的时间花在需求录入上，我会把能想到的关于此需求的背景、最终目标、可行的技术方案、风险点、外部 API 文档等等一切资源，都在需求文档中说明。对于需求文档，我不会太在意格式，会有比较多口语化的表达。

2、脑暴阶段 - 把需求 MD 喂给 Claude，调用 /superpowers:brainstorm 和 claude 进行思维碰撞。这个阶段不写任何代码，只讨论设计方案和实现细节，最终输出 design.md 和 implement.md，保证最终的实现方案是完美符合我的预期的。

3、 执行阶段 - 这里我会选择新起一个 ClaudeCode 会话，而不是在脑暴会话中进行代码实现。新会话的好处：一、原先脑暴会话已经经过多轮对话了，一般情况下上下文会比较满，新会话响应更快，并且不会“犯傻”；二、implement.md 足够详细，无需额外上下文

4、 CodeReview - 在 Zed 中进行代码审查和功能验收。关于代码审查，对于一些代码细节和实现原理，这里我会使用 zed-agent 来辅助我进行代码 review，当然，你也可以在终端新建一个 ClaudeCode 会话或者使用 Zed 的 Claude Agent。原则是尽量不在脑暴和执行会话中引入太多不必要的问题，保持这两个会话的「干净」。发现问题后，将改进项写入新的需求 MD

5、 LOOP - 改进项 MD 喂回脑暴会话，开始下一轮脑暴迭代

非常简单，但是效果超群。充分的前期设计可以提升 AI 的效率和质量，避免多次的来回拉扯。

举个真实案例：我用这套工作流将个人博客从 Quarz 框架迁移到 Astro 框架。脑暴阶段确认好设计方案后，我让 Claude 执行计划，然后就去睡午觉了。醒来发现 Claude Code 已经完美完成任务——中间零中断，一次成功，共计 5000+ 行代码变更。

之前大家做轻量级博客一般都是用像 Hugo、AcademicPages 这些 Jekyll 的框架配上 GitHub Pages + CF 加速，但这种方法编辑不方便。此外，像 AstroPages 这种新的框架动画做的非常好看，值得一试。

我的博客：~/tosaki
模板仓库地址：GitHub - t0saki/AstroPages-Bilingual

核心特色

• 优雅的阅读体验：
  
  • 极简风格，支持亮色 / 暗色模式自动切换。
  • 中文字体优化：集成了思源宋体（Source Han Serif），不管是正文还是代码块，在各种屏幕上看着都很舒服。
• 像 Notion 一样的写作后台：
  
  • 内置了 Keystatic CMS，你可以直接在浏览器里由可视化界面写文章、传图片、配置 SEO 信息。
  • 点击 “保存” 会自动同步到 GitHub，完全不用碰命令行。
• 原生双语支持：
  
  • 不是简单的机器翻译插件，而是完整的双语内容结构。中英文文章独立管理，互不干扰。站长可以借助更强大的 AI 提前翻译好文章，或者直接修改几行去掉双语支持。
• SEO 友好：
  
  • 自动生成双语 Sitemap 和 RSS 订阅源，对搜索引擎极其友好。

Firefly / 流萤，一款清新美观的高性能静态博客模板

2026/01/04 全新优化

重新优化的网格模式，以及部分细节的调整，将比之前更加清新美观
支持至多三列显示，多种布局多种配置等等
将很快推送更新，欢迎各位 star

双侧栏 - 网格
双侧栏 - 列表

单侧栏 - 列表
单侧栏 - 网格 2 列
单侧栏 - 网格 3 列

单双侧栏 - 网格瀑布

开源地址：

演示站： Firefly - Demo site
我的博客： 夏叶博客
使用文档： Firefly 博客模板文档
GitHub 地址： GitHub - CuteLeaf/Firefly: 流萤，这是一款清新美观的 Astro 博客主题模板 | a fresh and visually appealing Astro blog theme template, Secondary development based on Fuwari.