feat: load explicit configuration references and remove implicit env overlays

examples/reference/README.md

@@ -10,10 +10,10 @@
 go run ./examples/reference
 ```
 
-默认监听 `127.0.0.1:8080`，可通过环境变量调整：
+默认读取 `examples/reference/config.yaml`，监听 `127.0.0.1:8080`。文件已显式引用地址变量：
 
 ```sh
-GO_OMNI_ADDR=127.0.0.1:8081 go run ./examples/reference
+GO_OMNI_HTTP_ADDR=127.0.0.1:8081 go run ./examples/reference
 ```
 
 如果终端提示找不到 `go`，需要先把 Go 的 `bin` 目录加入 `PATH`。不要与 `examples/basic` 同时占用同一个端口。
@@ -133,14 +133,10 @@ curl -i http://127.0.0.1:8080/api/v1/users/1
 - 列表按 ID 排序、返回总数，空列表使用 `[]`。
 - 使用传入的 `context.Context` 执行查询，保留创建时间，修改时更新时间。
 
-MySQL 运行配置通过环境变量传入：
+此手写示例显式读取 `GO_OMNI_DB_DSN`；驱动固定 mysql，连接池使用 database.DefaultConfig()。项目可将数据库配置放入自己的 Config 并通过 LoadProject 统一加载（见 [配置指南](../../CONFIG.md)），框架不再自动读取数据库环境变量：
 
 ```sh
-export GO_OMNI_DB_DRIVER=mysql
 export GO_OMNI_DB_DSN='root:password@tcp(127.0.0.1:3306)/go_omni?parseTime=true&loc=UTC'
-export GO_OMNI_DB_MAX_OPEN_CONNS=10
-export GO_OMNI_DB_MAX_IDLE_CONNS=5
-export GO_OMNI_DB_PING_TIMEOUT=5s
 go run ./examples/reference
 ```