分享日常杂记、技术笔记的极简博客。
在线阅读: https://blog.950922.xyz/ · 基于 Astro 构建,GitHub Pages 托管
- 框架: Astro v7
- 样式: 纯 CSS(无框架依赖)
- 搜索: Pagefind + Fuse.js
- 部署: GitHub Actions → GitHub Pages
- 评论: Giscus(基于 GitHub Discussions)
src/
├── layouts/ # 布局组件
├── pages/ # 页面路由
├── content/posts/ # 博客文章 (MD)
├── data/ # 数据文件
components/ # - (页面内联组件)
public/
├── css/ # 全局样式
├── js/ # JavaScript 功能
└── sw.js # Service Worker
npm install
npm run dev # http://localhost:4321
npm run build:all # 构建生产版本、搜索索引和版本化离线缓存
npm run verify # 类型检查、生产构建、浏览器回归测试- ⌘K 命令面板(Ctrl+K 搜索)
- 🌓 暗色模式 + 切换动画
- 📱 PWA 离线支持
- 📊 写作统计热力图
- 🔍 模糊搜索 + 静态索引
- 📡 RSS Feed + Sitemap
- 🎨 50+ 项视觉动效
推送到 main 分支自动触发 GitHub Actions 构建并部署到 gh-pages 分支。
首次运行测试需要本机安装 Chrome,或执行 npx playwright install chrome。
npm run check 执行 Astro/TypeScript 检查,npm test 对已构建的 dist 运行浏览器回归测试。
npm audit 检查依赖漏洞。PR 和 main 推送都会运行检查,仅 main 推送或手动运行会部署。
页面采用标准浏览器导航,每个页面独立初始化交互。跨页过渡动画已移除,避免路由切换后的监听器和动画残留。
Service Worker 在生产构建结束后按产物内容生成版本,在线重新请求资源,断网时读取已缓存资源。
图片及 robots.txt 等公开资源必须放入 public/;站点图标实际尺寸为 256×256。
2026-10-29 出现过一次:页面样式和交互都失效,但服务端返回 200、CSS 和 JS 都能正常下载。
根因没有完全复现(倾向于浏览器里仍在使用上一版 HTML,而它引用的 _astro/*.js 已被新构建改名并删除)。
按这个顺序查,能在 1 分钟内区分是服务端问题还是本地缓存问题:
- 无痕窗口打开同一地址。正常 → 本地缓存问题,跳第 2 步;仍然坏 → 服务端,跳第 3 步
Ctrl+F5硬刷新;还不行就清除该站点数据(DevTools → Application → Storage → Clear site data)。 站点注册了 Service Worker,普通刷新不一定会让它失效- 服务端确认(都不需要浏览器):
gh-pages分支的产物树是否有 404 引用:gh api repos/lccccc1024/lccccc1024.github.io/git/trees/gh-pages?recursive=1- 样式是否被改动:对比
css/global.css的 blob sha,未变即为零变化 - 缓存版本是否更新:
sw.js里的const CACHE = 'xianhua-<hash>'每次构建都会变; 版本变了说明新构建已生效,旧缓存会在activate时清掉
代码侧的保障:sw.js 由 scripts/version-sw.cjs 按产物内容生成版本号,在线时走网络优先,
断网才读缓存,因此不会长期停留在旧版本。
详见 修复后审查报告。