跳到主要内容

更新日志

本页汇总本 fork 相较原仓库（hooozen/hexo-theme-tranquility）的演进摘要。完整的发布说明请参考 GitHub Releases。

v1.9.0 — 归档页、樱花与音乐播放器​

v1.8.0 因发布流程失误已从 npm 弃用（deprecated），请勿安装；其内容已并入本版本。

新功能​

  • 归档页：按年份分组的时间线式文章归档页（/archives/），nav.archive 一键开启导航入口
  • 樱花飘落：全站装饰动画，纯 CSS 硬件加速实现，prefers-reduced-motion 用户自动停用、移动端自动减半，不拦截任何交互
  • 音乐播放器：APlayer 迷你模式浮动于左下角（JS/CSS 走 CDN 不增加包体积），通过 localStorage 跨页记忆曲目与播放进度，自动尝试续播

配置示例​

sakura:
  enable: true
  density: 16 # 同屏花瓣数量，移动端自动减半

music:
  enable: true
  songs:
    - name: 歌曲名
      artist: 歌手
      url: https://example.com/song.mp3
      cover: https://example.com/cover.jpg

nav:
  archive: true # 导航栏显示「归档」入口

v1.7.2 ~ v1.7.3 — 字体体积优化与版本流程修复​

  • v1.7.2：字体全面 WOFF2 化并按 GB2312 一级字集子集化，包体积 4.2MB → 1.9MB；一言仅取古诗词分类
  • v1.7.3：撤回误发的 1.8.0 npm 包（标记 deprecated），改用小版本号衔接

v1.7.1 — CDN 可靠性与数学公式修复​

CDN 可靠性（重点修复）​

  • 默认 CDN 切换为 npmmirror：jsDelivr 在部分国内网络不可达，导致数学公式与 Mermaid 图表一直卡在原始文本。默认源改为阿里国内镜像 registry.npmmirror.com，大陆直连稳定
  • 双格式自动适配：新增 URL 构造宏，根据 cdn 配置自动适配 npmmirror（/pkg/版本/files/路径）与 jsDelivr/unpkg（/pkg@版本/路径）两种格式，换源无需逐项配置
  • 脚本源单项覆盖：mermaid.url 与 mathjax（字符串形式）支持指定完整脚本 URL（本地路径或任意可达源），优先级高于 cdn 拼接
  • 加载失败可见提示：脚本源不可达时正文顶部显示失败提示（替代无限等待），原始文本保持可读

数学公式修复​

  • 行内公式：MathJax 3 默认不启用 $...$ 分隔符，主题现已在脚本加载前注入配置，开箱即用（用户自定义 window.MathJax 时不覆盖）
  • 矩阵与多行推导：修复文档说明，默认 hexo-renderer-marked 会破坏 LaTeX \\，需改用 hexo-renderer-pandoc 或自行保护公式

其他​

  • 演示站：GitHub Pages 演示站上线（每次提交自动构建），README 与文档同步收录
  • 移动端适配：技能区窄屏适配（安全边距/折行/间距）、最近更新轮播窄屏溢出修复、公告横幅对齐设计语言

v1.7.0 — 个人主页功能与安全性能增强​

新功能（个人主页）​

  • 项目展示：首页项目卡片区块（主页链接/仓库链接/技术标签）
  • 技能展示：首页分组技能区，0-100 熟练度进度条或标签两种形态
  • 公告横幅：全站可关闭公告条，localStorage 记忆关闭状态，内容更新后自动重新展示
  • 建站时长：页脚实时显示「本站已运行 X 天 X 小时 X 分 X 秒」

安全增强​

  • CSP 内容安全策略：meta 标签落地，来源白名单按已开启功能自动收集
  • Referrer-Policy / Permissions-Policy：默认防完整 URL 泄露、禁用摄像头/麦克风/定位
  • 构建期 URL 校验：拦截主题配置中 javascript: 等危险协议链接并中和
  • CI 安全扫描：CodeQL 自动扫描 + 构建冒烟测试

性能增强​

  • 资源内容指纹：css/js/图片/字体引用追加内容哈希，永久强缓存 + 自动失效
  • 字体 WOFF 输出：子集字体默认输出 WOFF，体积约为 TTF 一半
  • PWA 离线增强：离线提示页、stale-while-revalidate 策略、版本化缓存管理

v1.6.2 ~ v1.6.5 — npm 包与体积优化​

  • v1.6.2/v1.6.3：正式支持 npm 安装（npm install hexo-theme-tranquility），修复多个构建崩溃问题
  • v1.6.4：字体子集化（包体积 -73%）、安全漏洞修复、健壮性增强
  • v1.6.5：主题包体积再减半（12.15MB → 6.3MB）

v1.6.1 — 健壮性修复​

  • 4 项健壮性修复，进一步降低构建与运行时异常的风险
  • 提升配置项与外部资源（RSS / hitokoto / Service Worker）的容错能力

v1.6.0 — 新功能与 Gitalk 移除​

  • 新增 5 项功能，覆盖无障碍、加载性能与运行时深色模式等
  • 移除已废弃的 Gitalk 评论功能（原仓库归档、Gitalk 不再维护且依赖 GitHub OAuth）
  • 评论替代方案：推荐接入 giscus 或 Waline

v1.5.2 — 安全加固​

  • 完成 16 项安全修复，覆盖以下方向：
    • XSS 注入
    • </script> 注入
    • localStorage 兜底
    • 其他前端输入与输出处理

v1.5.0 — SEO 与可发现性增强​

  • Open Graph / Twitter Card 社交分享卡片
  • JSON-LD 结构化数据（Person / Article / WebSite）
  • 站点地图（sitemap.xml）
  • robots.txt
  • RSS 自动发现
  • PWA（manifest.json + Service Worker）、图片懒加载
  • 运行时深色模式四策略（light / dark / auto / time）
  • 文章搜索增强

v1.4.0 — 主题重构​

  • 一言（Hitokoto）Slogan 开关
  • 文章驱动的时间线（取代配置文件事件）
  • Hexo 原生关于页（取代配置文件内容）
  • 构建时 RSS 聚合的「最近更新」卡片
  • 删除与关于页重复的简历（CV）功能
  • 代码精简（scripts 目录 -23%）

如需了解每个版本的完整变更与升级注意事项，请查看对应的 Release 页面。升级步骤参考升级指南。