Skip to content

v1.0.0 — Initial public release

Choose a tag to compare

@Aafff623 Aafff623 released this 08 Aug 01:22
· 248 commits to master since this release

What's new

First public product release of threetwoa's blog — a standalone Astro site based on the Firefly theme (not an official mirror). Configuration-driven blogging with an Agent-assisted publishing workflow.

Live site: https://fork-firefly.vercel.app

Added

Publishing

  • Markdown / MDX posts with drafts, pinning, password posts, RSS, Sitemap, Open Graph, and Pagefind search
  • Local draftbox (posts/_draftbox/): preview with pnpm dev, kept out of git remotes until you graduate a post
  • Dual authoring paths: Obsidian → ob2blog, or session/Knowledge → knowledge-output, both finishing with site-cascade (stats, tags, heatmap, optional “new note” dynamic)
  • Rich content: KaTeX, Mermaid diagrams, PlantUML, wiki links, code groups, and directives

Reading & appearance

  • List / grid / waterfall layouts, Index-First TOC, related posts, and reading-time metadata
  • Display controls: light / dark / system / time-based theme, hue, and wallpaper modes
  • Smooth page transitions (Swup) with Svelte islands where interaction needs them

Personal surfaces

  • Dynamic short-post timeline (local content; optional Memos) with kind/year filters
  • Dynamic location on publish (city-level; home fallback 山西 · 运城)
  • Dynamic page: first-batch SSR + infinite scroll lazy load; inline comments with first visible / rest folded + red badge count
  • Gallery with accordion albums and an infinite-canvas mode
  • About, Friends, Guestbook, Anime, and curated collections
  • Sidebar widgets: heatmap, calendar, seasonal surprise-gift announcement, tags, site stats, and SpritePet desk pet

Integrations (defaults)

  • Comments: Waline (emoji packs, GIF search; sticker suggest wired but off by default)
  • Agent collaborator personas with circular brand avatars (Claude Code / Cursor / OpenCode / Codex / Kimi Code / Pi)
  • Music: local library by default (no public Meting dependency)
  • Icons via Iconify (Lucide-first); Fancybox lightbox; optional comment image upload via COS proxy

Delivery

  • Vercel-first deploy; public GitHub Template for Use this template / clone
  • Maintainer docs for agent workflow and ship checklist (AGENTS.md, docs/agents/workflow.md)
  • dynamic-post skill: human-tone comment formula, emoji/kaomoji body rules, location publish rules

Changed

  • Product versioning starts at 1.0.0 (separate from upstream Firefly theme version numbers such as 6.15.3)
  • Seasonal gift hover wiggle slowed for a gentler invite

Fixed

  • Posts content loader excludes non-post markdown (_draftbox/README.md, sidecar docs under images/) so production builds do not fail schema validation

Credits

  • Built on the Firefly / Fuwari Astro blog theme lineage — thanks to upstream authors and contributors

Full Changelog: https://github.com/Aafff623/fork-Firefly/commits/v1.0.0


中文 · 本版说明

threetwoa's blog 的第一个对外产品版本。基于 Firefly 主题的 standalone 二次开发站(非官方镜像),配置驱动发文,并带 Agent 辅助发布流水线。

线上:https://fork-firefly.vercel.app

新增

发文

  • Markdown / MDX:草稿、置顶、密码文、RSS、Sitemap、Open Graph、Pagefind 搜索
  • 本地草稿箱posts/_draftbox/):pnpm dev 可预览,不进远端,出箱后再发
  • 双路径成帖:Obsidian → ob2blog,或会话/Knowledge → knowledge-output,收尾都走 site-cascade(统计、标签、热力图,可选「新笔记」动态)
  • 富文本:KaTeX、Mermaid、PlantUML、Wiki Link、代码组、directive

阅读与外观

  • 列表 / 网格 / 瀑布流,Index-First TOC、相关文章、阅读时长
  • 显示控制:亮 / 暗 / 系统 / 按时段主题、色相、壁纸模式
  • Swup 页面过渡 + 需要交互处的 Svelte 岛屿

个人页面

  • 动态时间线(本地内容;可选 Memos)+ 类型/年份筛选
  • 发布时写入定位(市级;回落 山西 · 运城
  • 动态页:首批 SSR + 触底懒加载;评论首条展示 / 其余折叠 + 红点计数
  • 相册:手风琴专辑 + 无限画布模式
  • About / 友链 / 留言板 / 追番,以及人工策展合集
  • 侧栏:热力图、日历、节日惊喜礼盒、标签、站点统计、SpritePet 桌宠

默认集成

  • 评论:Waline(表情包、GIF;梗图建议已接线默认关)
  • Agent 协作者圆形品牌头像(Claude Code / Cursor / OpenCode / Codex / Kimi Code / Pi)
  • 音乐:默认本地曲库(不依赖公共 Meting)
  • 图标 Iconify(Lucide 为主);Fancybox 灯箱;评论大图可选 COS 代理

交付

  • 默认 Vercel 部署;GitHub Template 可 Use this template / clone
  • 维护文档:AGENTS.mddocs/agents/workflow.md
  • dynamic-post skill:人话评论公式、正文 emoji/颜文字、定位发布约定

变更

  • 产品版本从 1.0.0 起算(与上游主题 6.15.3 等版本号分离)
  • 礼盒悬停晃动放慢,邀请感更自然

修复

  • posts 收集器排除非正文 md(草稿箱 README、帖内 images/ 旁白),避免线上构建 schema 校验失败

致谢

  • 基于 Firefly / Fuwari Astro 博客主题血统,感谢上游作者与贡献者

完整提交历史https://github.com/Aafff623/fork-Firefly/commits/v1.0.0

Release 讲能力;架构与目录细节见 README。本版无发行附件。