AI 辅助建站复盘：从零上线到博客改造

经历：一条从「作品站」到「博客」的路#

• 2025-12 起步：第一版只有首页、画廊、关于三块，Astro 纯静态输出，接 Cloudflare Pages，暗色玻璃基调定下来；紧接着配了一套基于 Chrome DevTools Protocol 的回归测试。
• 2026 上半年：平稳迭代，把 Cloudflare Pages 自动构建踩过的坑记了下来（见下）。
• 2026-09 密集迭代：分类筛选、图片瘦身、首页接真实数据、动效 / SEO / RSS、三栏侧栏、一次三十来处的大改版、导航与强调色预设……
• 方向修正：最初定位是「作品档案」，写着写着发现真正持续在产出的是文字。9 月 19 日把作品库下线，改成按年归档的博客，旧文章继续留在时间线里。

现在这个站长这样——首页是「hero 壁纸 + 三栏布局」，左栏个人资料、中栏文章流、右栏动态时间线：

文章详情页是核心阅读场景，标题、日期、标签和正文沿用主题的卡片式容器：

「作品」并没有完全消失，复刻的 RhineLab 三维终端作为第一个「复刻」项目收进了项目页：

日记是最近新增的独立模块，挂在「文章」导航下：

雷点：AI 快速踩过、又补回来的坑#

构建与部署

• lockfile 平台依赖：Windows 生成的 lock 缺平台可选依赖，云端 Linux npm ci 报 Missing @emnapi/*；解法是 lock 不提交、走 npm install。
• 浮动版本：react 解到 19.3 撞上 >=19 <19.3 的 peer 区间，构建期 ERESOLVE；锁 19.2.8 + legacy-peer-deps。
• 「推送成功但线上没变」：判断上线别比对 chunk 哈希（本地与云端依赖解析差异会让哈希不同），要把这次改动的内容特征拿到线上搜。

资源与网络

• 180MB PNG 转 webp，压到 3MB 出头。
• jsDelivr 国内不稳，图床换回本地相对路径。
• MiSans 字体外链上游 404，从未生效却一直阻塞渲染，删掉。

前端交互

• 软导航后汉堡菜单失效：监听器没跟着 DOM 重建，改 document 级事件委托。
• 粒子背景鼠标移动抛 RangeError：合成事件冒泡回 window 又触发监听器，加 isTrusted 判断。
• 背景高度写死 670px：补 resize 重测 + ResizeObserver。
• 作品卡浅色下没轮廓：边框沿用了深色主题写法。

视觉与可访问性

• 三级文字对比度 2.49<1> → 4.87<1> 才过 WCAG AA，主题默认改为夜间。

教训：AI 快在写代码，稳在自己兜底#

1. 断言要「会红」：几何断言优于肉眼；新断言先证明它在缺陷态会变红，否则就是恒真断言、绿灯给人假安心。
2. 字段少而稳：posts 只留 title/date/tags/summary/link 五个字段，schema 用 zod 收编，写错直接构建报错。
3. 一个人也写交接文档：CODEX.md 把硬规则和构建注意事项写下来，是「当时的自己留给现在」的说明。
4. 锁版本、本地化资源：依赖精确锁、图床改本地，把环境差异和第三方稳定性提前填掉。
5. 方向顺应真正在持续产出的事：作品档案是低频橱窗，文字才是高频产出，该改就改。

借助 AI 做站，最大的价值是把「写」的成本降下来，让十个月能完成三十来处改版；但 AI 不会替你记住坑——线上验证的顺序、可执行的断言、沉淀成文档的教训，得自己一条条守住，才守得住这个站。