AI / WEB / ENGINEERING NOTES
写代码，
也写下为什么。
这里没有宏大的技术叙事，只有可以在下一个工作日用上的小经验：怎么让 AI 真正帮忙、怎么把页面做稳，以及那些踩过一次就该记住的坑。
LATEST NOTE / 01
最近在写
从“能生成代码”到“能一起完成任务”，中间还隔着上下文、检查清单和一点耐心。
FIELD NOTES / 02—10
开发手记
每篇只解决一个具体问题。可以顺着读，也可以挑一个正在遇到的主题。
不用复杂框架，做一个够用的小型 RAG
从文档切片、向量检索到回答引用，用最少的组件理解 RAG 的基本流程。
阅读全文把常用提示词写成模板之后
与其收藏一百条神奇指令，不如固定角色、输入、约束和输出格式四个位置。
阅读全文我开始更常使用 TypeScript 的 satisfies
既检查对象是否符合类型，又保留更具体的推断，配置对象尤其顺手。
阅读全文容器查询终于用在了真实页面里
组件关心自己的宽度，比猜它会被放在哪个页面更自然，也更容易复用。
阅读全文一次大文件上传，让我重新理解 Node.js Stream
先别急着背 API，理解“数据分段流动”和背压，很多代码自然就通了。
阅读全文把 Web Vitals 当成排查线索，而不是分数
三项指标分别在提醒什么，以及一个普通内容页能先做哪些便宜的优化。
阅读全文表单做完以后，我会再走一遍这份清单
标签、焦点、错误提示和键盘操作，十分钟检查能挡住不少真实问题。
阅读全文让 AI 补测试，最有用的不是覆盖率数字
它很擅长补边界清单，但测试意图和断言质量仍然需要人来把关。
阅读全文只做一张离线页，也值得用 Service Worker
先从最小缓存策略开始，不让离线支持变成另一套难维护的系统。
阅读全文服务端组件和客户端组件，边界画在哪里
不追求“全服务端”，而是让数据留在服务端、交互停在最小的客户端岛屿。
阅读全文静态站放进 Docker 前，我会确认的十件事
从缓存头、健康检查到只读文件系统，一份不复杂的上线前清单。
阅读全文INDEX / BY TOPIC
常写的主题
- 01 / 04AI 工具与应用
- 02 / 04浏览器与 CSS
- 03 / 04Node.js 工程
- 04 / 04部署与性能