2026-05-09 周报

本周做了什么

1. 把个人 Wiki 从“示例站”调整成“可长期维护的知识库结构”：
   • 确定了顶层分区（debug/notes/ai/projects/growth）
   • 把模板/规范放到仓库根目录，避免污染站点内容
2. 解决了开发态反代的一些坑（Nginx WebSocket / HMR）
3. 开始整理常用速查：
   • Git rebase 救援流程
   • Docker/Compose 常用命令
   • psql 常用排查 SQL

本周学到了什么

• “路由=文件路径”的项目，一开始就把顶层分区定稳很重要：
  后期再移动目录，链接会断，整理成本会指数上升。
• 写 Debug 文时，强制“验证步骤”能显著提升复用价值：
  未来再遇到同类问题，按验证清单走很快能定位。
• 基础可靠性（timeout/retry）要尽早建立习惯：
  没有 timeout 的请求最终都会成为线上事故。

遇到的坑（记录入口）

• VitePress dev 反代到 Nginx 后 HMR 不工作（WebSocket）：
  /debug/vitepress-hmr-behind-nginx
• Docker 构建磁盘爆满排查：
  /debug/docker-no-space-left

下周计划

1. 继续填充 /notes/：
   • TypeScript 类型技巧（utility types / satisfies / infer）
   • Nginx 常见部署模板（HTTPS/HTTP2/缓存）
2. 给 wiki 增加一个“站点搜索”方案的调研与落地（如果需要）
3. 每周至少产出：
   • 1 篇 debug
   • 2 篇 notes