zeus

零依赖、可插拔的 Go 微服务框架。现代构造器注入模式 + 内置默认装配 + 4 层渐进暴露 API。

内部复杂（灵活）+ 外部简单（默认）。

用户 5 行代码启动应用，需要时能挖到底层实现细节。

详见 CLAUDE.md - 设计目标

package main

import (
    "net/http"

    "github.com/go-zeus/zeus/app"
)

func main() {
    app.Run(&app.Config{Port: 8080}, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("hello from zeus"))
    }))
}

// curl http://localhost:8080

零配置自动启用：

• slog logger → stdout
• recovery + requestid + accesslog 中间件
• memory 注册中心 + 自动注册
• 优雅关闭（SIGTERM/SIGINT，10s 超时）

app.Run(&app.Config{
    Name:     "my-service",
    Port:     8080,
    Cluster:  "canary",                    // 灰度集群
    Registry: "etcd://localhost:2379",     // 切换到 etcd（需 import 对应 plugin）
}, handler)

a := app.NewApp(
    app.AddServer(http.NewHTTP(http.Port(8080), http.Mux(handler))),
    app.WithRegistry(memory.New()),
    app.WithMiddleware(recovery.New()),
    app.WithServiceCluster("canary"),
)
a.Run()

app := components.NewApp(
    components.NewLogComponent(slog.NewSlog()),
    components.NewRegistryComponent(memory.New()),
    components.NewServerComponent(http.NewHTTP(http.Mux(mux))),
    components.NewServiceComponent(),
)
app.Run()

各功能域支持通过 URL 字符串切换实现（与 import _ 副作用注册配合）：

go test ./...                                  # 主包测试
go test -race -coverprofile=coverage.out ./...  # 主包覆盖率
cd examples && go build ./...                   # 示例构建

CI：.github/workflows/ci.yml — lint + test + build，覆盖主包和所有 plugins。

• examples/00-app-quickstart — L4 手动装配（components.NewApp）
• examples/01-hello — L1 入门（5 行）
• examples/02-with-registry — L2 多集群路由
• examples/03-typed — L3 类型装配（双 Server + recovery middleware）
• examples/04-config-driven — L2 配置驱动（URL scheme 切 cache/mq）
• examples/05-autoapp — 自动装配最小示例
• examples/06-autoapp-full — L4 完整装配
• examples/07-autoapp-multi — 多 server（HTTP + gRPC）
• examples/08-client — HTTP 客户端（自动集群路由）
• examples/09-middleware — 中间件链
• examples/10-config — 配置加载（file loader）
• examples/11-proxy — 反向代理（HTTP/WebSocket/SSE）
• examples/12-cluster-routing — 集群路由端到端演示
• examples/13-database — 数据库抽象（事务 + tx_id 透传）
• examples/14-cache — 缓存抽象（Set/Get/TTL）
• examples/15-mq — 消息队列（pub/sub + baggage 透传）
• examples/16-job — 任务调度（interval 固定间隔）
• examples/17-job-cron — 任务调度（cron 表达式）
• examples/18-propagation — Baggage 全链路传播
• examples/19-observability — metrics + trace + log
• examples/20-full-demo — 综合演示（gateway + 多 srv + 前端）
• examples/21-registry-etcd — etcd 注册中心集成

• 💬 Discussions — 提问、想法讨论、最佳实践
• 📝 Issues — Bug 报告、功能请求
• 🤝 Contributing — 贡献指南（PR 流程 / 代码规范 / 测试要求）
• 📜 Code of Conduct — 行为准则
• 🔒 Security Policy — 安全漏洞披露流程
• 📚 设计文档 — 4 层 API 设计哲学、概念分层、组件装配
• 🌐 文档站 — Hugo 源（hugo server 本地预览 / 推 main 自动部署到 GitHub Pages）
• 🔧 API 稳定性 — 🔒稳定 / 🧪实验 / 🔬内部分级

Zeus 的设计参考了以下优秀框架，但未直接复制代码：

• kratos — BFF / 微服务架构思路
• go-zero — 工程化与代码生成
• gin — 路由与中间件链
• kitex — RPC 治理与扩展点
• Go 标准库 — net/http / database/sql / log/slog

详见 CLAUDE.md - 设计参考。

MIT