从这一篇开始，系列进入“二次开发实战”阶段。前面三十五篇主要是在读 FastGPT 已经存在的系统：聊天入口、工作流、知识库、插件、MCP、沙盒、对象存储、部署、安全、性能与稳定性。接下来几篇会换一个视角：如果我们要在 FastGPT 上做扩展，应该沿着哪些源码路径动手？这一篇先从最常见的需求开始：新增一个 API。在 FastGPT 里，新增 API 不是简单地在projects/app/src/pages/api目录下写一个 Next.js 路由文件。一个完整 API 通常会同时涉及：packages/global/openapi下的请求和响应 schema。packages/global/openapi/**/index.ts下的 OpenAPI path 注册。projects/app/src/pages/api下的 Next API route。parseApiInput请求入参解析。权限校验和业务 service/controller 调用。局部单元测试或接口测试。这套流程看起来比直接写 handler 麻烦，但它带来三个收益：运行时校验 请求进来时可以被 Zod schema 兜住。 类型推导 handler、前端调用、测试可以复用 sche