v1.0.0 — Initial public 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 withpnpm dev, kept out of git remotes until you graduate a post - Dual authoring paths: Obsidian →
ob2blog, or session/Knowledge →knowledge-output, both finishing withsite-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-postskill: 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 as6.15.3) - Seasonal gift hover wiggle slowed for a gentler invite
Fixed
- Posts content loader excludes non-post markdown (
_draftbox/README.md, sidecar docs underimages/) 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.md、docs/agents/workflow.md dynamic-postskill:人话评论公式、正文 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。本版无发行附件。