Changelog · 项目更新日志

Changelog

记录每次发布的新特性、问题修复与重构。遵循 语义化版本 规范。

2 Major
11 Minor
0 Patch
Release Timeline
  1. v2.6.0Minor
    • 🌐 SEO 全方位优化：robots.txt 详细爬虫指令 + sitemap.xml 增强 + Schema.org 结构化数据（Blog 类型）
    • 📊 访问量统计重构：主统计切换为不蒜子（busuanzi，PV/UV 全云持久化），localStorage 作为降级方案
    • 🔤 字体加载优化：引入 @fontsource/inter + @fontsource/jetbrains-mono，font-display: swap 消除 FOIT
    • 🖼️ 图片资源优化：ArticleCard 全面使用 OptimizedImage 组件，WebP 格式 + 懒加载 + aspect-ratio 16:9 防 CLS
    • ✨ 动画效果增强：列表项交错渐入动画（stagger 80ms）、spring 缓动函数、统一 hover 微交互
    • 🍞 面包屑导航：新增 Breadcrumbs 组件，内容页显示完整导航路径
    • 🎨 视觉层次优化：统一间距系统（--space-*）+ 阴影层级（--shadow-*）+ 导航链接底部高亮条
    27 commits
    • Feature`.vitepress/config.mts` SEO 全面增强：title/description 长度优化融入高搜索量关键词，新增 Schema.org Blog 结构化数据 JSON-LD，head 数组补充 robots / canonical / author 等 meta 标签
    • Feature新增 `public/robots.txt`：明确允许/禁止目录、User-agent 分类、Host、Sitemap 入口
    • Feature`.vitepress/theme/components/SiteFooter.vue` 重构：移除本地站点访问量统计，改用不蒜子（busuanzi）标签 `busuanzi_site_pv` / `busuanzi_site_uv` 显示站点总 PV/UV，添加 `mounted` 状态避免 Hydration Mismatch
    • Feature`.vitepress/theme/components/PostPage.vue` 改造：移除本地文章浏览量统计，改用不蒜子标签 `busuanzi_page_pv` 显示页面 PV
    • Feature`.vitepress/theme/utils/viewCount.ts` 重构：主统计切换为 busuanzi（云持久化，PV/UV 全平台共享），降级方案保留 localStorage（每篇文章 +1，session 去重），新增 `isBusuanziLoaded()` / `waitBusuanzi()` 检测函数
    • Feature`.vitepress/config.mts` 注入不蒜子脚本：`<script src="//cdn.busuanzi.cc/busuanzi/3.6.9/busuanzi.abbr.min.js" async>`
    • Feature`.vitepress/theme/styles/fonts.css` 引入 `@fontsource/inter` + `@fontsource/jetbrains-mono`：self-host 字体，配置 `font-display: swap` 消除字体加载期间的 FOIT（不可见文字闪烁），多字重（300/500/600/700/800）
    • Feature`.vitepress/theme/components/ArticleCard.vue` 全面优化：原生 `img` 标签替换为 `OptimizedImage` 组件，支持 WebP 格式、懒加载、priority 优先级（首页前 3 篇）、16:9 比例容器、hover 缩放（1.04）
    • Feature`.vitepress/theme/types/blog.ts` + `utils/posts.ts` 新增 `coverWidth` / `coverHeight` 字段：文章 frontmatter 支持自定义封面图宽高，避免图片加载时布局偏移（CLS）
    • Feature`.vitepress/theme/components/Breadcrumbs.vue` 新增：面包屑导航组件，Home 图标 + 路径解析 + 当前页高亮，集成到 `AppLayout.vue` 内容页
    • Feature`.vitepress/theme/components/AppLayout.vue` 集成面包屑：非宽页面（文章/分类/标签/归档）自动显示，宽页面（首页/博客列表/友链等）不显示
    • Feature`.vitepress/theme/styles/index.css` 添加设计令牌：统一间距系统（`--space-xs` 到 `--space-3xl`，8 阶）+ 阴影层级（`--shadow-sm` 到 `--shadow-xl`，4 阶）
    • Feature`.vitepress/theme/styles/index.css` 新增 `fade-up-stagger` 动画：列表项按 80ms 索引延迟依次渐入，配合 `animation-delay` 实现交错效果
    • Feature`.vitepress/theme/components/HeaderNav.vue` 增强：导航链接添加底部高亮条（`::after` 伪元素），hover 60% 宽度、激活 80% 宽度，使用 `--ease-out-soft` 缓动
    • FixB014：Hydration mismatch — 不蒜子标签在 SSR 阶段无值，客户端注入后产生 SSR/CSR 内容不一致 → 通过 `v-if="mounted"` 控制客户端渲染
    • FixB015：api.countapi.xyz 域名 DNS 解析失败导致访问量统计请求报错 → 移除 countapi.xyz 依赖，迁移至不蒜子（云持久化）+ localStorage 降级
    • FixB016：Schema.org 脚本标签将 innerHTML 作为属性传入导致 JSON 未正确嵌入 → 改为 VitePress 标准 HeadConfig 三元组格式 `["script", { type: "application/ld+json" }, JSON.stringify(...)]`
    • FixB017：`pnpm add @fontsource/*` 在工作区根目录添加依赖提示 ERR_PNPM_ADDING_TO_ROOT → 使用 `-w` 标志明确工作区根安装
    • FixB018：字体包版本 5.x 不提供 `variable-full.css` 路径 → 改用标准导入 `@import "@fontsource/inter"` + 字重子 CSS 文件（300/500/600/700/800）
    • Refactor`.vitepress/theme/utils/viewCount.ts` 注释完整化：清晰区分主统计（busuanzi）与降级统计（localStorage）职责，列出所有存储键命名空间
    • Refactor`.vitepress/theme/components/ArticleCard.vue` 使用统一设计令牌：所有 `transition` 改用 `--duration-base` + `--ease-spring`，hover 上移距离从 4px 提升至 6px，新增 8px 圆角
    • Refactor`gui/src/utils/wordAndView.ts` 移除 `getTotalViewCount()` 函数，更新注释说明 busuanzi 主统计逻辑；`DashboardView` / `FilesView` 浏览量改用文章浏览量累加
    • Chore新增依赖：`@fontsource/inter@^5.2.8`、`@fontsource/jetbrains-mono@^5.2.8`
    • Chore项目版本号升级 2.5.0 → 2.6.0（package.json），GUI 子包 0.4.0 → 0.5.0
    • DocsREADME 全面更新至 v2.6 视角：核心特性新增 SEO / 不蒜子 / 字体 / 图片 / 动画 / 面包屑 / 视觉层次 7 大模块，技术栈新增 @fontsource，目录结构新增 Breadcrumbs
    • Docs更新 `docs/DEPLOYMENT.md` / `docs/DIRECTORY_STRUCTURE.md` / `docs/FAQ.md` / `docs/COMMENTS.md` / `docs/发布全流程指南.md` 至 v2.6
    • Docs更新 `logs/PROJECT_ITERATION_SUMMARY.md`：新增 v2.6 变更总览、SEO 优化详解、访问量重构详解、UI/UX 优化详解
  2. v2.5.0Minor
    • 🔍 全局全文搜索：Cmd+K / Ctrl+K 快捷唤起，搜索标题+内容+标签，高亮匹配，键盘导航
    • 🌐 SEO 增强：Open Graph + Twitter Card 全站 meta 标签，静态 + 动态（transformHead）每页独立标题/描述/图片
    • ⚡ 搜索零依赖：基于 posts.data 构建期数据，客户端实时搜索，自动索引，无需外部服务
    7 commits
    • Feature新增 `.vitepress/theme/components/SearchModal.vue`：全局搜索弹窗组件，搜索标题/描述/正文/标签，加权评分排序，关键词高亮，↑↓ 键盘导航 + Enter 跳转
    • Feature`.vitepress/theme/components/HeaderNav.vue` 桌面导航栏 + 移动端抽屉各新增 Search 搜索按钮，点击唤起搜索弹窗
    • Feature`.vitepress/theme/components/AppLayout.vue` 挂载 `<SearchModal>`，全局 Cmd+K/Ctrl+K 快捷键监听
    • Feature`.vitepress/config.mts` `head` 数组新增 og:type / og:site_name / og:locale / twitter:card / twitter:site 静态 meta
    • Feature`.vitepress/config.mts` 新增 `transformHead` 钩子：根据每页 title/description/page 动态生成 og:title / og:description / og:url / og:image + twitter 对应标签
    • Refactor`SearchModal.vue` 搜索索引直接从 `posts.data` 构建（零外部依赖），150ms 防抖，自动提取正文 snippet 高亮
    • Chore项目版本号升级 2.4.0 → 2.5.0（package.json），GUI 子包 0.3.0 → 0.4.0
  3. v2.4.0Minor
    • 🌐 访问量统计升级为全局实时计数（countapi.xyz），所有访客看到同一真实访问量
    • 📜 所有文章底部新增 CC BY-NC-ND 4.0 专业版权声明模块（结构化三段式布局 + 交互按钮）
    • 📄 Blog 页面自动分页（12 篇/页）+ 智能页码导航 + 搜索/标签筛选联动
    • 🏷️ 标签筛选器自动折叠（超过 12 个标签时仅显示前 12 个，支持展开/收起）
    7 commits
    • Feature`.vitepress/theme/utils/viewCount.ts` 新增 `hitGlobalViewCount()` / `fetchGlobalViewCount()`：基于 countapi.xyz 的全局实时计数器，sessionStorage 防同一会话重复 hit，API 不可用时降级为 localStorage
    • Feature`.vitepress/theme/components/PostPage.vue` 新增 CC BY-NC-ND 4.0 版权声明模块：三段式编号布局（版权归属/授权范围/署名要求）+ ✓✗ 清单 + 双 CTA 按钮
    • Feature`.vitepress/theme/components/BlogPage.vue` 新增分页系统：12 篇/页、搜索/标签变化自动重置页码、分页总数减少时自动修正、页码省略号导航
    • Feature`.vitepress/theme/components/TagFilter.vue` 新增标签折叠：>12 个标签时仅显示前 12 个，展开/收起按钮带隐藏数量提示
    • Refactor`viewCount.ts` 文章 session 去重键改名为 `fpb:article-session:v1`，与全局 hit 键 `fpb:global-hit:v1` 彻底隔离
    • Refactor`incrementViewCount()` 内新增异步 `hitGlobalViewCount()` 调用，用户访问任意文章时自动 hit 全局计数器
    • Chore项目版本号升级 2.3.0 → 2.4.0（package.json），GUI 子包 0.2.0 → 0.3.0
  4. v2.3.0Minor
    • 🐛 修复 Markdown 解析器死循环（4 反引号代码块导致 OOM）
    • 🐛 修复中文 slug 文章加载失败（API 双重编码）
    • 🐛 修复编辑器加载大文章时主线程同步阻塞
    • ⚡ GUI 浏览量计算优化（单次读取替代逐篇累加）
    • 🔄 浏览量实时同步：GUI 工作台/文件管理 + 5s 定时轮询
    • 👁️ 站点前端 SiteFooter 显示站点总访问量（Eye 图标 + 10s 自动刷新）
    12 commits
    • FixB011：Markdown 解析器死循环 → 段落检测排除正则匹配到 ````markdown（4 反引号），触发空段落 + 未递增 i → 死循环耗尽 2GB 内存 → 新增加空 p 防御守卫
    • FixB012：中文 slug 文章 API 返回数据正常但前端加载卡住 → `api/index.ts` 中 `getPost`/`updatePost` 错误使用 `decodeURIComponent(slug)` 导致双重编码 → 移除冗余解码
    • FixB013：编辑器加载大文章时界面卡死 → `fromPost()` 内同步调用 `updatePreviewSync()` 阻塞主线程 → 改为 `schedulePreviewUpdate()` 走防抖机制
    • FixGUI 浏览量不刷新：storage 事件仅在跨标签页触发，同标签页内不更新 → DashboardView + FilesView 新增 5s 定时轮询 `setInterval`
    • PerfGUI 总浏览量计算：DashboardView/FilesView 原来逐篇调 `getViewCount(slug)` 每次都读 localStorage → `getTotalViewCount()` 一次读取聚合
    • Feature新增 `gui/src/utils/wordAndView.ts` 的 `getTotalViewCount()` / `getAllViewCounts()` / `formatViewCount()` 导出
    • Feature新增 `.vitepress/theme/utils/viewCount.ts` 的 `getTotalViewCount()` 导出，供前端 SiteFooter 使用
    • Feature`.vitepress/theme/components/SiteFooter.vue` 新增站点总访问量显示（`Eye` 图标 + `formatViewCount` 格式化数字），每 10s 自动刷新
    • Feature新增文章 `springboot-kafka-integration.md`：Spring Boot 集成 Kafka 全链路实战（Docker 环境、Producer/Consumer、死信队列、事务、监控运维）
    • Refactor`gui/src/utils/wordAndView.ts` 重写：统一与 `viewCount.ts` 相同的存储键与 `load()` 逻辑，消除两处读取不一致的隐患
    • Chore项目版本号升级 2.2.0 → 2.3.0（package.json），GUI 子包 0.1.0 → 0.2.0
    • ChoreGUI 新增 `onBeforeUnmount` 清理定时器（DashboardView / FilesView），防止内存泄漏
  5. v2.2.0Minor
    • 🖥️ 新增 GUI 管理后台（`gui/`）：纯 Web SPA 版博客管理工作台
    • 🆕 新增 `MermaidChart.vue`：Markdown 代码块图表 SSG 预渲染为 SVG
    • 🆕 新增 `viewCount.ts`：浏览量统计（localStorage + sessionStorage）
    • 🆕 新增 `migrate-summary-to-description.mjs`：frontmatter 字段迁移工具
    • 🆕 新增 `mermaid` 依赖（^11.15.0）：图表渲染引擎
    • 🎨 GUI 优化：仪表盘精简 / 编辑器简化 / 文件管理一行布局 / 停止态修正
    • 📝 README 全面更新至项目实际状态（GUI 章节 + 目录结构修正）
    26 commits
    • Feature新增 `gui/` 子包：Web SPA 管理后台（Vue 3 + Vite 5 + Pinia + Tailwind CSS）
    • FeatureGUI 五大核心模块：📊 工作台 / ✏️ Markdown 编辑器 / 📁 文件管理 / 🚀 一键部署 / 👀 本地预览
    • FeatureGUI 部署面板新增四态机：`running` / `success` / `error` / `stopped`，主动停止不会污染失败语义
    • FeatureGUI 编辑器：分栏编辑/预览、实时统计（字数/阅读时长）、目录大纲、Mermaid 渲染、快捷插入、自动保存草稿
    • Feature新增 `gui/server/index.mjs`：纯 Node.js http server（~504 行），路由表 + SSE + 进程管理
    • Feature新增 `gui/src/api/index.ts`：fetch + EventSource 封装
    • Feature新增 `gui/src/stores/index.ts`：Pinia 状态管理（posts / logs / toast / deploy）
    • Feature新增 `gui/src/utils/markdown.ts`：自研零依赖 Markdown 渲染器（161 行）
    • Feature新增 `gui/src/utils/editorStats.ts`：字数 / 阅读时长 / 标题大纲
    • Feature新增 `gui/src/utils/wordAndView.ts`：字数与浏览量聚合
    • Feature新增 `.vitepress/theme/components/MermaidChart.vue`：检测 mermaid 代码块并渲染为 SVG
    • Feature新增 `.vitepress/theme/utils/viewCount.ts`：浏览量统计（localStorage 持久化 + sessionStorage 防重复）
    • Feature新增 `scripts/migrate-summary-to-description.mjs`：批量迁移 frontmatter summary → description
    • Feature新增 `pnpm gui:dev` / `pnpm gui:build` / `pnpm gui:start` 脚本别名
    • Feature新增 `mermaid` 依赖（^11.15.0），支持 Markdown 图表 SSG 预渲染
    • FixGUI 部署/预览停止按钮：修复停止后状态显示为 error → 新增 `stopped` 态并在 SSE done 事件中丢弃覆盖
    • FixGUI 编辑器加载卡住：API 成功但数据异常时 loading 未重置 → 增加 10 秒超时 + `ok:false` 检测
    • FixGUI Mermaid 图表未渲染：MarkdownRenderer 未识别 mermaid 代码块 → 检测 `language === "mermaid"` 渲染 MermaidChart
    • RefactorGUI 仪表盘移除 7 天活动柱图和 Top 10 浏览榜，精简页面布局
    • RefactorGUI 编辑器移除 Frontmatter 智能补全（分类/标签），简化界面
    • RefactorGUI 文件管理筛选区改为一行布局（分类/标签/状态/排序 flex-wrap）
    • RefactorGUI 部署面板移除最近 20 条部署历史列表，精简界面
    • Chore项目版本号升级 2.1.0 → 2.2.0（package.json + README + ChangelogPage）
    • Docs新增 `gui/README.md`：GUI 完整文档（功能 / 架构 / API / CLI 映射 / 安全 / 状态机）
    • Docs更新 `README.md`：新增 GUI 章节 + 技术栈（Mermaid）+ 目录结构修正（移除 clean.mjs、加 MermaidChart.vue / viewCount.ts / migrate-summary）
    • Docs更新 `logs/PROJECT_ITERATION_SUMMARY.md`：新增 v2.2 变更总览章节
  6. v2.1.0Minor
    • 🆕 集成 Giscus 评论系统（GitHub Discussions 驱动）
    • 🆕 新增自定义 404 错误页（NotFoundPage.vue）
    • 🆕 新增 sitemap.xml 自动生成器（`pnpm sitemap`）
    • 🐛 修复 Giscus CI 部署后 `repo=undefined` 报错
    • 🐛 修复本地 .env 文件未被自动加载
    • 🎨 简化 CommentSection：从 272 行精简到 112 行（-59%）
    • 📝 新增 docs/COMMENTS.md Giscus 配置文档
    17 commits
    • Feature新增 `.vitepress/theme/components/CommentSection.vue`：Giscus 评论组件，懒加载、自动跟随主题、SPA 路由感知
    • Feature新增 `.vitepress/theme/components/NotFoundPage.vue` + `404.md`：友好 404 错误页，含返回/推荐入口
    • Feature新增 `scripts/generate-sitemap.mjs`：扫描 content/posts 生成 sitemap.xml，已串联进 `pnpm dev` 与 `pnpm build`
    • Feature新增 `pnpm sitemap` 脚本别名，纳入构建流水线
    • Feature新增 `docs/COMMENTS.md`：Giscus 5 步配置指南 + 常见问题排查
    • Feature新增 `.env.example`：Giscus 环境变量模板
    • FixB007：CI 部署后 Giscus 显示 `repo=undefined` → 在 `.github/workflows/deploy.yml` 的 Build env 中注入 `VITE_GISCUS_*` 变量，敏感 ID 走 GitHub Secrets
    • FixB008：本地开发时 `.env` 文件未被 VitePress 自动加载 → `config.mts` 增加轻量级 .env 解析器，注入到 `process.env` 后再走 `vite.define`
    • FixB009：404 页面未生效仍显示默认页 → 移除 `404.md` 中 `layout: page` 等冲突配置
    • FixB010：sitemap URL 默认值 `https://example.com` 与生产不符 → 改为 `https://dcyyd.github.io`
    • Refactor`CommentSection.vue` 移除响应式状态机（idle/loading/ready/error）、轮询逻辑、手动主题切换；信任 Giscus 原生能力
    • Refactor`CommentSection.vue` 改用 `setAttribute` 直接构建 script 元素，避免 URLSearchParams 拼接导致参数丢失
    • Refactor`CommentSection.vue` 移除 `enabled` / `loadingText` props 与未启用降级 UI；改用 `v-if="ready"` 直接控制是否渲染
    • Perf`pnpm build` 流水线调整为 `typecheck → rss → sitemap → vitepress build`，sitemap 在构建前生成
    • Chore项目版本号升级 2.0.0 → 2.1.0（package.json）
    • Docs重写 `README.md`：v2.1 视角，补充评论系统与 sitemap 章节
    • Docs更新 `logs/PROJECT_ITERATION_SUMMARY.md`：新增 v2.1 变更记录
  7. v2.0.0Major
    • 🆕 新增 `deploy` 一键部署命令 `pnpm post d`（预检 → 构建 → 推送 → 清理）
    • 🆕 新增 `clean` 独立清理命令 `pnpm post c`
    • 🆕 新增短选项 `-m`（message）/ `-p`（port）/ `-h`（host）
    • 🆕 新增 `sitemap.xml` 自动生成器（`scripts/generate-sitemap.mjs`）
    • 🆕 新增自定义 404 错误页（`NotFoundPage.vue` + `404.md`）
    • 🐛 修复 6 个 BUG（B001-B006），详见下方修复记录
    • 🎨 CLI 输出重构：步骤化进度、diff 预览、错误降级、构建透传、SSH 软预检
    • 📝 文档体系重写：README / DEPLOYMENT / FAQ / 发布全流程指南 / CLI readme / 迭代总结
    24 commits
    • Feature新增 `scripts/post-cli/deploy.mjs`：构建 + 推送 dist 到 gh-pages 分支
    • Feature新增 `scripts/post-cli/clean.mjs` 独立清理命令（原 deploy 内部清理逻辑外提）
    • Feature新增 `scripts/generate-sitemap.mjs`：扫描 content/posts 生成 sitemap.xml，已串联进 `pnpm build`
    • Feature新增 `.vitepress/theme/components/NotFoundPage.vue` + `404.md`：友好 404 错误页，含返回/推荐入口
    • Feature在 `scripts/post-cli.mjs` 注册 `-m` / `-p` / `-h` 短选项，覆盖到 deploy / serve / clean
    • Feature在 `package.json` 新增脚本别名：`pd` / `pl` / `pr` / `ps` / `pc` / `sitemap`
    • FixB001：`execFile` 使用 `shell:true` 导致含空格的 commit message 被拆分 → 改为 `shell:false`，args 原样传数组
    • FixB002：Windows 下 `pnpm post d` 报 `Could not create directory /home/root/.ssh` → 注入 `HOME=C:/Users/Administrator` + `GIT_SSH_COMMAND` 指定密钥
    • FixB003：中文分类 / 标签 URL 二次编码 404 → 改用中文原字符作为 slug，移除 `encodeURIComponent`
    • FixB004：Node 20 警告 `DEP0190 DeprecationWarning: shell:true` → 统一改为 `shell:false`，Windows 可执行文件自动加 `.exe`
    • FixB005：`-m` 短选项被误判为 boolean flag → 在 `SHORT_FLAGS` 注册 `m: message`，并校验类型为 string
    • FixB006：系统级 `url.https://FilePress · Blog/.insteadof` 强制 SSH 转 HTTPS → 改为按调用上下文注入 `GIT_SSH_COMMAND`，不污染全局 git config
    • Refactor`scripts/post-cli/deploy.mjs` 重构为四阶段步骤：① 预检 ② 构建 ③ 推送 ④ 清理，每阶段独立可跳过（`--skip-*`）
    • Refactor`scripts/post-cli/ui.mjs` 新增 `info/success/warn/error/heading/step/diff/hint` 等高亮辅助函数
    • Perf`pnpm build` 流水线调整为 `typecheck → rss → sitemap → vitepress build`，确保构建前静态资源已生成
    • Docs重写 `README.md`：v2.0 视角，新增「快速开始」「架构图」「CLI 一览」「部署方案」「BUG 修复表」
    • Docs重写 `docs/DEPLOYMENT.md`：5 套部署方案，重点介绍 `pnpm post d` 一键部署、选项、环境变量、故障排查
    • Docs重写 `docs/FAQ.md`：覆盖开发、构建、部署、文章管理、CLI 错误、BUG 修复、自定义与安全
    • Docs重写 `docs/DIRECTORY_STRUCTURE.md`：同步新文件节点、新增核心设计原则与数据流向图
    • Docs重写 `docs/发布全流程指南.md`：端到端整合 `pnpm post d` 流程、4 类工作流场景
    • Docs重写 `scripts/readme.md`：新增 § 5.5 `deploy` 章节、§ 5.5.7 已知 BUG 与修复、§ 12 v2.0 摘要
    • Docs重写 `logs/PROJECT_ITERATION_SUMMARY.md`：v2.0 全量变更、技术决策、新功能详解、BUG 记录、构建分析、部署选型
    • Chore统一项目名称为 `FilePress Blog (filepress-blog)`、版本 `2.0.0`、作者 `窦长友 <dcyyd_kcug@yeah.net>`
    • Chore`scripts/generate-rss.mjs` 生成器标识更新为 `filepress-blog rss generator`
  8. v1.5.0Minor
    • 新增按年归档页面 /archives
    • 新增分类系统：一篇文章归属唯一分类，分类页 /categories 与单分类页 /categories/[slug]
    • 首页去除「继续探索」「探索标签」按钮，原位置替换为「订阅 RSS」
    • 页脚简化为单行版权信息，版本号位置改为「回到顶部」按钮
    9 commits
    • Feature新增 ArchivePage.vue 按年份分组的时间轴视图与 archives.md 入口
    • Feature新增 CategoriesPage.vue 分类总览 + CategoryPage.vue 单分类页 + categories/[category] 动态路由
    • Featureutils/posts.ts 新增 getAllCategories / getPostsByCategorySlug / getYearArchives
    • Featuredata/ 新增 categories.data.ts 与 archives.data.ts 构建期数据源
    • FeatureArticleCard / PostPage 显示分类胶囊，关联到分类详情页
    • RefactorHomePage 去除「继续探索」「探索标签」两个 CTA，替换为 RSS 订阅按钮
    • RefactorBlogPage 左栏精简：仅保留搜索 + 标签筛选，去除「热门标签」侧栏
    • RefactorSiteFooter 重构：仅保留版权行 + 回到顶部按钮（原 v1.0.0 版本号已迁移至 Changelog）
    • Docs全项目版本号同步至 1.5.0：package.json / scripts/post-cli/ui.mjs / scripts/readme.md / HomePage
  9. v1.4.0Minor
    • 新增 Blog 导航与全文章时间轴页面
    • 首页 UI/UX 大幅重构，支持更宽画布与特性展示
    • 新增项目更新日志与友链页面
    7 commits
    • Feature新增 BlogPage 组件：搜索 + 标签筛选 + 按年份时间轴分组
    • Feature新增 ChangelogPage 与 FriendsPage 页面与对应 Markdown 入口
    • FeatureHeaderNav 加入「博客 / 更新日志 / 友链」三个新导航项
    • Feature首页 Hero 升级为左右分栏布局，加入特性卡片 + 最新文章 + 热门标签
    • RefactorAppLayout 重构为路由感知：宽页 88rem，文章页 max-w-5xl 紧凑阅读
    • RefactorSiteFooter 链接区更新，加入 Blog / Changelog / Friends 入口
    • Docsscripts/readme.md CLI 完整文档
  10. v1.3.0Minor
    • 构建期 MD → SafeAST 安全渲染管线
    • 上线 CLI 命令 `post new / update / list / read / help`
    5 commits
    • Feature新增 .vitepress/theme/utils/markdown.ts，将 MD 编译为受控 SafeAST
    • Featurescripts/post-cli/* 完整实现：new / update / list / read / help 五条命令
    • Featurefrontmatter 顺序固定：title → description → date → author → category → tags → cover → draft
    • FixPOST 落盘后 HMR 自动捕获，无需重启 dev server
    • Docs在 docs/ACCEPTANCE_REPORT.md 记录验收清单
  11. v1.2.0Minor
    • 上线 Tag 标签页与上下篇导航
    • 引入现代设计令牌系统（设计语言：Indigo → Violet → Cyan）
    4 commits
    • FeatureTagFilter 组件：选中态用品牌渐变，悬浮 scale 1.05
    • FeaturePostPage 上下篇导航：左上一篇 / 右下一篇，不存在则占位
    • Feature设计系统：CSS 变量统一管理色彩 / 圆角 / 阴影 / 动效
    • Perfrollup 手动拆分：katex → math chunk，lucide → icons chunk
  12. v1.1.0Minor
    • 站点初始上线：ArticleCard、HomePage、AppLayout、HeaderNav、SiteFooter 全部到位
    • Tech Stack：VitePress 1.4 + Vue 3 + TypeScript strict + Tailwind
    4 commits
    • Featurecontent/posts/ 第一批 8 篇文章落地
    • FeatureArticleCard 卡片：渐变边框 + 悬浮上浮 + 装饰光斑
    • FeatureSiteFooter 三列布局：品牌 / 导航 / 技术栈
    • Chore开启 lastUpdated、cleanUrls、appearance 主题切换
  13. v1.0.0Major
    • 项目初始化：从零搭建 vitepress-file-blog 仓库
    3 commits
    • FeatureVitePress 1.4 + Vue 3 + TypeScript strict 脚手架
    • Featuretailwind.config.js 接入 @tailwindcss/typography
    • Docsdocs/DEPLOYMENT.md / DIRECTORY_STRUCTURE.md / FAQ.md 初始版本