https://docs.cncf.vip/go-zeus/reference/index.htmlAPI 稳定性 — 🔒稳定 / 🧪实验 / 🔬内部分级 插件 BOM — 依赖版本治理策略 优化与路线图 — 业界标杆横向对比 + P0/P1/P2 路线图 变更日志 — 每版本变更记录 治理文件 贡献指南 安全政策 行为准则Hugozhhttps://docs.cncf.vip/go-zeus/reference/optimization-plan/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://docs.cncf.vip/go-zeus/reference/optimization-plan/index.html基于 go-zero / kratos / kitex / dapr / gin 等业界标杆框架的横向对比，识别 zeus 当前能力缺口并提出补充建议。 一、能力对照矩阵 维度 go-zero kratos kitex dapr zeus 当前 评估 服务发现/注册 ✓ ✓ ✓ ✓ ✓(memory/etcd) 持平 负载均衡 ✓ ✓ ✓(高级) ✓ ✓(random/round_robin) 持平 熔断 ✓ ✓ ✓ ✗ ✓(counter+cluster) 领先 限流 ✓ ✓ ✓ ✓ ✓(token+cluster) 领先 重试 ✓ ✓ ✓ ✗ ✓(exponential+cluster) 领先 链路追踪 ✓OTel ✓OTel ✓OTel ✓OTel ✓OTel 持平 指标 ✓Prom ✓Prom ✓Prom ✓Prom ✓Prom 持平 日志 ✓ ✓ ✓ ✓ ✓slog 持平 反向代理 ✗ ✗ ✗ ✗ ✓(HTTP/WS/SSE/gRPC) 领先 集群路由 ✗ ✗ ✗ ✗ ✓(X-Zeus-Cluster) 原创 配置中心 ✓ ✓ ✓ ✓ ✓(file/etcd/k8s) 持平 MQ 抽象 ✗ ✗ ✗ ✓(BuildingBlock) ✓(memory/kafka/nats) 持平 任务调度 ✗ ✗ ✗ ✗ ✓(interval/cron) 领先 数据库抽象 ✓sqlx ✓(data) ✗ ✓ ✓(sql/mysql/postgres/sqlite) 持平 缓存抽象 ✓ ✓ ✗ ✓ ✓(memory/redis) 持平 跨进程事务 ✗ ✗ ✗ ✓(workflow) ✓(tx_id 透传) 领先 TLS / mTLS ✓ ✓ ✓ ✓ ✓ ✅ 已实现 pprof 自动注册 ✓ ✓ ✓ ✗ ✓ ✅ 已实现 业务错误码 ✓ ✓(errors) ✓ ✗ ✓ ✅ 已实现 参数校验 ✗ ✗ ✗ ✗ ✓ ✅ 已实现 通用 batch ✓ ✗ ✗ ✗ ✓ ✅ 已实现 分布式 ID ✓ ✗ ✗ ✗ ✓ ✅ 已实现 testutil ✓ ✓ ✗ ✗ ✓ ✅ 已实现 分页辅助 ✗ ✗ ✗ ✗ ✓ ✅ 已实现 二、优化优先级 ✅ P0：生产硬伤（已完成） 1. TLS / mTLS 支持 ✅ 现状：已完成 server/http.TLS(cfg *tls.Config) Option — 服务端 HTTPS / mTLS server/http.TLSFiles(certFile, keyFile string) Option — 从文件加载证书 client.WithTLS(cfg *tls.Config) Option — 客户端 TLS（含 mTLS） client.WithTransport(rt http.RoundTripper) Option — 自定义连接池 测试：server/http/tls_test.go 覆盖 4 个场景（默认/WithConfig/WithFiles/mTLS） 用法： 1// HTTPS server 2srv := http.NewHTTP(http.TLS(&tls.Config{Certificates: []tls.Certificate{cert}})) 3 4// mTLS server（双向校验） 5srv := http.NewHTTP(http.TLS(&tls.Config{ 6 Certificates: []tls.Certificate{cert}, 7 ClientAuth: tls.RequireAndVerifyClientCert, 8 ClientCAs: clientCAs, 9})) 10 11// HTTPS client 12c := client.NewClient(client.WithTLS(&tls.Config{InsecureSkipVerify: true})) 2. pprof 诊断端点自动注册 ✅ 现状：已完成 app.WithPprof(port int) AppOption — 独立端口的 pprof server 端点：/debug/pprof/{cmdline,profile,symbol,trace,heap,goroutine,allocs,block,mutex} 安全设计：独立端口隔离（生产可在防火墙层屏蔽），不影响业务流量 用法： 1a := app.NewApp( 2 app.AddServer(http.NewHTTP()), 3 app.WithPprof(6060), // pprof 独立端口 4) ✅ P1：业务高频（已完成） 3. errors 包（Kratos 风格业务错误码）✅ 现状：已实现 errors/ 包 API：errors.New(reason, msg, code) / errors.Is / errors.As / FromError 特性：业务错误码 + HTTP 状态码映射 + Metadata 4. validation 泛型校验 ✅ 现状：已实现 validation/ 包 API：链式 validation.New().Add(field, val, rules...).Validate() 规则：Required / MinLen / MaxLen / Min / Max / Email / Regex 等 5. testutil 测试辅助 ✅ 现状：已实现 testutil/ 包 API：WaitUntil / NewMockRegistry / NewHTTPTestServer 等 6. snowflake 分布式 ID ✅ 现状：已实现 snowflake/ 包 特性：含时钟回拨保护 ✅ P2：增强（已完成） 7. batch 通用批处理 ✅ 现状：已实现 batch/ 包 API：batch.New(maxSize, maxWait, do).Add(item) 用途：DB bulk insert / HTTP 调用聚合 8. page 分页辅助 ✅ 现状：已实现 page/ 包 API：page.Page / page.Sort / page.Result[T] 三、不补充的能力（与 zeus 哲学冲突） 能力 原因 API DSL / 代码生成（.api / .proto → server） 违反"内部复杂 + 外部简单"原则；与 4 层渐进暴露冲突 ORM / Schema Migration 业务工具域，与"薄封装 stdlib"原则冲突 Stream 抽象（RxGo 风格） SSE/WebSocket 已覆盖实际场景 分布式事务协调器 业务侧选 Seata/TCC/Saga，仅保留 tx_id 透传 Hot Reload 配置热更已有（config 包），代码热更交给 air/reflex GraphQL / gRPC-Web 按需补充，非主流 四、实施路径 P0 阶段（生产硬伤） ├─ server/http: TLS Option + 测试 ├─ client: TLS / Transport Option + 测试 └─ app/options.go: WithPprof() Option + 测试 P1 阶段（业务高频） ├─ errors 包: Error 类型 + HTTP/gRPC 映射 + 测试 ├─ validation 包: 链式 API + 内置规则 + 测试 ├─ testutil 包: mock + builder + helper + 测试 └─ snowflake 包: Generator + 时钟回拨保护 + 测试 P2 阶段（增强） ├─ batch 包: Batcher + 测试 └─ page 包: Page + Sort + Filter + Result + 测试 五、与现有架构的兼容性 所有新增功能都通过 Option 模式接入，不破坏 L1-L4 现有 API 主仓零依赖原则不变（TLS 用标准库 crypto/tls；pprof 用 net/http/pprof） 中文注释、Go 1.22+ 泛型、所有新代码必须有测试 与 utils 包现有的工具集风格一致（命名、Option 模式、文档注释）