这是一次功能增强与稳定性优化的版本,聚焦部署流程、缓存策略与站点可用性体验。
文档更新
- 补充与完善自动部署和本地部署,覆盖
.github/workflows/deploy.yml与utils/deploy.sh的最新变化 - 新增/完善 PWA 与缓存策略说明,解释禁用 SW 与清理旧缓存的原因与做法
- 调整文档结构:将后端源码分析迁移并归类至
docs/views/source/code/目录(Spring 源码系列、RPC 系列、JDBC 连接池、Starter 组件等) - 新增手写源码与生产案例系列:
- Spring 源码系列补充至 15 篇(07-15)
- 手写 RPC 框架系列(01-04):含与 Spring 深度集成
- Spring Boot Starter 实战:分布式锁/防重/二级缓存/延时队列(01-02)
- Spring Gateway 宕机排查案例
- 新增/扩充专题文档:
会合冲刑害、十神心得、十神性格等 - 补充首页传送门与 Shadowrocket 页面
- 友链同步 -> 友人帐
功能更新
- 部署流程
- 使用 Node.js 20 构建与部署;启用并发控制,避免重复部署
- 构建后向 HTML 注入构建时间戳(cache busting),便于缓存失效与问题排查
- 持续收敛 GitHub Actions 权限与缓存策略,更新部署令牌配置
- 部署使用
JamesIves/[email protected],开启single-commit和clean
- 缓存与 PWA 策略
- 在
docs/.vuepress/config/plugins/index.js禁用@vuepress/pwa的serviceWorker - 新增
docs/.vuepress/public/service-worker.js:自动注销旧 SW 并清理历史缓存,避免发版后页面卡死 - 补充
docs/.vuepress/public/manifest.json并规范路径
- 在
- 可用性与体验
- 全文搜索(
vuepress-plugin-fulltext-search) - 代码复制(
vuepress-plugin-code-copy) - 站点地图(
vuepress-plugin-sitemap),并排除404.html - 显示最后更新时间(
@vuepress/last-updated+moment,东八区格式化) - 侧边栏默认展开行为可配置,移动端默认不展开;首页样式与描述优化
- 详情容器(details)样式优化;打赏组件样式与收款码资源更新
- 本地化 jQuery 加载,降低外部依赖风险
- 全文搜索(
依赖升级
- VuePress 生态
vuepress升级至 ^1.9.10@vuepress/plugin-google-analytics从 1.9.9 -> 1.9.10@vuepress/plugin-register-components从 1.9.9 -> 1.9.10
- 其他生态与主题
whatwg-fetch多次小版本提升至 3.6.20browserify-sign4.2.2(依赖安全修复)- 主题评论
valine升级至 1.5.0(主题内部)
- 运行时与构建
- Node.js 运行时在部署流程中升级至 20
问题修复
- 彻底解决历史 SW 缓存导致的 404 与页面卡死问题(禁用 SW + 清缓存 SW)
- 规范
manifest.json的start_url与图标路径,保证 GitHub Pages 场景路径一致性 - 优化构建产物缓存失效策略(HTML 注入构建时间),降低 CDN/浏览器缓存引发的加载异常
- 音乐播放器:修复
ReferenceError: navigator is not defined;引入网络触达检测后仅在满足条件时展示 - 侧边栏:修复移动端默认展开的兼容性问题,新增可配置能力
- 文档与样式若干修正(中英文空格、首页样式与描述、详情容器样式等)