AI Agent 工程
MCP 工具接口设计：schema、粒度与上下文预算
2026-07-28 把 inputSchema 放开成完整 JSON Schema 2020-12，但模型侧支持的子集窄得多。工具描述怎么写、粒度怎么切、返回体多大、错误信息带什么，才能让模型少幻觉、上下文不爆。
ZoyTown Engineering
技术文章
面向全球技术读者的双语工程文章，重视清晰解释、可核查来源与真实项目语境。
让知识真正可用
最新文章
30 篇文章
数据库工程
PgBouncer 三种池化模式：transaction 模式下会坏的六类特性，与连接数怎么算
session/transaction/statement 的语义边界，transaction 模式下 SET、prepared statement、临时表、会话级 advisory lock、LISTEN 的真实行为，以及后端与前端连接数的计算方法。基于 PgBouncer 1.25.2 官方文档。
AI 搜索工程
llms.txt 与 AI 爬虫治理：哪一层真正有约束力
llms.txt 97% 零请求，Google 明确不读；真正的控制面在 robots.txt(RFC 9309)、CDN 默认值和网络层执行。逐条讲清规格状态、会咬人的地方与落地配置。
后端工程
API 的 ETag 与条件请求：乐观并发、Cache-Control 取值与 CDN 的 Vary 坑
强弱 ETag 各配哪个比较函数、前置条件的求值顺序、Authorization 的三个后门指令、Vary 在 CDN 上为什么长期不生效，以及 2025 年 10 月才发布的 RFC 9875 Cache Groups。
后端工程
Idempotency-Key 实现指南：IETF 草案已过期，那该照着谁做
IETF 的 Idempotency-Key 草案已于 2026 年 4 月过期归档，且从未进入 IANA 注册表。本文讲清标准的真实状态，以及键的作用域、并发同键的原子占位、响应快照该存什么、TTL 怎么定。
数据库工程
MongoDB 复合索引：ESR 是准则不是铁律，以及 explain 该怎么读
等值字段必须前置是硬约束，S 与 R 的先后是成本权衡；$in 在 201 个元素处换类别；覆盖查询会静默失效；8.3 起计划选择换成了多计划加 CBR 兜底。
检索工程
RAG 分块：先把 chunk 大小和重叠量出来，再谈语义分块
固定窗口、递归、语义分块的真实取舍，chunk 大小与重叠对召回和精度的实测影响，以及一套能复现的选参数实验流程——用证据代替默认值和直觉。
检索工程
HNSW 调参与量化取舍：M/efConstruction/efSearch，以及暴力检索何时更划算
三个 HNSW 参数只有一个能在线调。对照 pgvector 0.8.6、Qdrant 1.19、Lucene 10.x 的实际默认值，讲清量化的真实成本在重排、过滤与分片如何偷走召回，以及什么时候量化加暴力扫描比建图更划算。
Python
PEP 751 落地实测：pylock.toml 是安装清单，不是你的锁文件
PEP 751 已 Final，但 pip 和 uv 生成的 pylock.toml 是两种东西。实测两者差异、静默失败模式，以及 pip/uv/PDM/Poetry/packaging 的真实支持进度。
Python
asyncio 结构化并发：TaskGroup 与 timeout 的取消语义
TaskGroup 和 asyncio.timeout 都建立在取消计数之上：为什么 CancelledError 不能吞、timeout 套 TaskGroup 时 except TimeoutError 会漏、以及 Python 3.15 新增的 TaskGroup.cancel()。
数据库工程
PostgreSQL 19 Beta 迁移指南：八个破坏性变更、升级路径与上线门禁
按「会让 pg_upgrade 直接拒绝、会静默改变行为、需要重新规划配置」分类的八个不兼容变更，包括 JIT 默认关闭、TOAST 压缩改为 lz4、max_locks_per_transaction 需翻倍，以及 REPACK CONCURRENTLY 与并行 autovacuum 等值得升级的新能力。
后端工程
API 限流实战：RateLimit 响应头标准、算法选型与 Redis 原子实现
IETF 的 RateLimit 与 RateLimit-Policy 头部怎么写（注意它仍是 Internet-Draft 而非 RFC）、固定窗口与令牌桶如何取舍、为什么 INCR 加 EXPIRE 会留下永不过期的键，以及 429 与 Retry-After 的正确配合方式。