Blog

Long-form essays on engineering, AI, and craft.

AI Agent的12个核心原理:从消息数组到多Agent编排

AI Agent 的 12 个核心原理,自下而上逐层拆解:从最底层的消息数组(LLM 的工作记忆)、上下文窗口(稀缺资源管理)、系统提示词(角色设定),到中层的思维链、少样本提示、预填充、停止序列、Tool Use、RAG、ReAct,最后到上层的幻觉问题和多 Agent 编排。每条原理都回答一个问题:它是什么、为什么需要它、怎么正确使用。配有代码示例和正确/错误对比。

从手搓API到调用API:一次完整的实践复盘

上一篇 API从0-1 讲了理论,这一篇是实践复盘。我们用 Node.js 手搓了一个 30 行的 API 服务器,又用 Dog API 做了一个瀑布流画廊——两条代码加起来不到 300 行,但把「写 API」和「调 API」两端的知识都覆盖了。这篇复盘拆解每个技术决策背后的原因,把两端串成一条完整的请求-响应链路,最后提炼出 4 个不管用不用框架都成立的核心模式。

curl从0-1:Agent最常用的HTTP探针

AI Agent(Claude Code / Codex / Hermes)在终端里跑得最多的命令之一就是 curl。它不是浏览器,没有「回车就出页面」的便利——但它让 Agent 能精确控制 HTTP 请求的每一个字节,然后一字不漏地读每一个字节的响应。这一篇从 Agent 的视角讲 curl:为什么 Agent 不用 Postman、13 个核心标志怎么用、Agent 高频使用的 8 个实战模式、以及 curl 输出背后的 HTTP 协议细节。读完你能像 Agent 一样高效地探索任何 API。

Next.js 个人网站从0到1部署:7个真实踩坑全记录

用 Next.js 16 App Router + MDX 搭个人网站,从本地能跑到公网能访问,中间踩了 TypeScript 严格模式的 build 报错、中文文件名跨平台编码错乱、MDX 配置遗漏、路由组布局继承、draft/published 内容过滤、以及 Vercel 自动部署的「push即上线」风险。这篇把 7 个坑的完整因果链——从第一个报错到最终修复——全部记录下来,每个坑都附了错误信息、根因和修复方案。

Nginx从0-1:从看懂配置到自己写配置

Nginx 是全球 top 百万网站里超过 30% 在用的 Web 服务器和反向代理。但它的配置文件对新手来说像天书——`server`、`location`、`proxy_pass`、`upstream` 全是新概念。这一篇用一个「收发室」类比帮你建立心智模型,然后从 3 个最简配置开始(静态文件 / 反向代理 / SPA 兜底),深入到 location 匹配规则,最后覆盖负载均衡、限流、Gzip、日志调试等实战模式。读完你能自己写一个完整的 Nginx 配置。