magicEngine 是一个轻量 Go 网络框架,当前主要包含三类能力:

• HTTP 服务、路由、中间件、静态资源、上传、代理
• SSE 服务端和客户端
• TCP Server / Client / Endpoint

• http/: HTTP 框架主实现
• sse/: Server-Sent Events
• tcp/: TCP 接入和连接封装
• example/: HTTP / SSE / TCP 示例
• docs/: 当前实现说明和测试说明
• .agents/skills/: 面向 Codex 的项目 skill

• docs/design-http.md
• docs/design-realtime.md
• docs/testing-guide.md

• HTTP 默认注册 logger 和 recovery 中间件
• RouteRegistry 支持 API version、动态路径参数 :id 和通配 **
• 静态资源支持文件系统和 embed 两种方式
• SSE 支持 holder 注册、心跳、事件推送和客户端重试
• TCP 基于 magicCommon/execute 做连接回调调度

• RemoveRoute(...) 现在能正确删除 method 下的尾部路由
• serveStaticFile(...) 的目录回退不会再错误复用文件句柄
• SSE 服务端输出现在符合完整事件帧格式,包含结束空行
• SSE 客户端会正确继承调用方 context.Context,并保留配置的 retryWait

GOCACHE=/tmp/magicengine-gocache go test ./... -count 1

详细说明见 docs/testing-guide.md。