大多数后端项目的 API 层是"人肉维护的目录"：路由注册、参数解析、错误码映射、文档注释——四份东西描述同一个事实，靠人保证一致，于是永远不完全一致。RushWind Admin 把这层做成了编译产物：Protobuf 是唯一契约，构建期确定性生成路由、错误映射、服务接口与绑定计划——203 条路由、441 条错误状态映射、198 个服务接口方法，零手写；前端 TypeScript 客户端同源于契约，三套前端字节相同。本文拆解这条生成流水线的设计与治理，以及三个真实踩到的暗礁——每一个都值得写成生成器作者的检查清单。