func register(r *server.Hertz, handler *apis.APIHandler) {
	router.GeneratedRegister(r, handler)   // 路① 由 IDL 生成，占绝大多数
	customizedRegister(r)                  // 路② 手写，目前只有一个 /ping
}

GeneratedRegister 实际上就是 backend/api/router/coze/loop/apis/coze.loop.apis.go 里的 Register 函数——文件头写得很直白：

而 backend/api/router.go 的 customizedRegister 才是给你自由发挥的地方：

func customizedRegister(r *server.Hertz) {
	r.GET("/ping", handler.Ping)
	// your code ...
}

backend/api/router_gen.go 里，中间件按路由分组一层套一层。最外层是所有请求都会经过的 rootMw：

func rootMw(handler *apis.APIHandler) []app.HandlerFunc {
	return []app.HandlerFunc{
		middleware.CtxCacheMW(),                          // 请求级缓存上下文
		middleware.AccessLogMW(),                          // 访问日志
		middleware.LocaleMW(),                              // 解析语言 Cookie
		middleware.PacketAdapterMW(handler.GetTranslater()), // 响应包裹 + 国际化
	}
}
func _apiMw(handler *apis.APIHandler) []app.HandlerFunc {
	return []app.HandlerFunc{
		middleware.SessionMW(session.NewSessionService(), louser.NewLocalUserService(handler)),
	}
}

coze.loop.apis.go:20-24 能看到分组是怎么嵌套注册的：

root := r.Group("/", rootMw(handler)...)
{
	_api := root.Group("/api", _apiMw(handler)...)   // 所有 /api/* 都要过 SessionMW
	{
		_auth := _api.Group("/auth", _authMw(handler)...)
		// ... 每一层 Group 都可以再挂自己的中间件
	}
}

backend/api/router/coze/loop/apis/middleware/session.go 的核心逻辑：

func SessionMW(ss session.ISessionService, us userservice.Client) app.HandlerFunc {
	return func(ctx context.Context, c *app.RequestContext) {
		path := string(c.Path())
		if path == "/api/foundation/v1/users/login_by_password" ||
			path == "/api/foundation/v1/users/register" {
			c.Next(ctx)   // 登录/注册接口特判放行，不需要已有 session
			return
		}
		sess, err := ss.ValidateSession(ctx, string(c.Cookie(session.SessionKey)))  // 校验 Cookie
		if err != nil { c.Abort(); return }
		resp, err := us.GetUserInfo(ctx, &user.GetUserInfoRequest{UserID: ptr.Of(sess.UserID)}) // 查用户信息
		ctx = session.WithCtxUser(ctx, &session.User{ID: sess.UserID, Name: ..., Email: ...})   // 写回 ctx
		c.Next(ctx)
	}
}

语言处理则简单得多，middleware/locale.go：

func LocaleMW() app.HandlerFunc {
	return func(ctx context.Context, c *app.RequestContext) {
		c.Next(contexts.WithLocale(ctx, parseLocale(c)))   // 从 Cookie 取语言，塞进 ctx
	}
}

拿"新建 Prompt"这个动作举例，coze.loop.apis.go:406-413：

_prompt := _api.Group("/prompt", _promptMw(handler)...)
_v15 := _prompt.Group("/v1", _v15Mw(handler)...)
_v15.POST("/prompts", append(_promptsMw(handler), apis.CreatePrompt)...)

拼出来的完整路径就是 POST /api/prompt/v1/prompts，一次请求要依次穿过：

✋ 动手 5 分钟

# 1. 看路由汇合点
cat backend/api/router.go

# 2. 数一数生成代码里到底有多少条路由
grep -c "append(.*Mw(handler)" backend/api/router/coze/loop/apis/coze.loop.apis.go

# 3. 定位 CreatePrompt 的完整路由链路
grep -n "prompt\b" backend/api/router/coze/loop/apis/coze.loop.apis.go | grep -i prompts

# 4. 看 IDL 里的路由注解源头
grep -n "api.post\|api.get" idl/thrift/coze/loop/prompt/coze.loop.prompt.manage.thrift | head