docs: 更新三份 README 文档以反映实际项目情况

README.md

@@ -13,7 +13,7 @@ nex/
 │   │   ├── service/      # 业务逻辑层
 │   │   ├── repository/   # 数据访问层
 │   │   ├── domain/       # 领域模型
-│   │   ├── protocol/     # 协议适配器（OpenAI/Anthropic）
+│   │   ├── conversion/   # 协议转换引擎（OpenAI/Anthropic 适配器）
 │   │   ├── provider/     # 供应商客户端
 │   │   └── config/       # 配置管理
 │   ├── pkg/              # 公共包（logger/errors/validator）
@@ -38,10 +38,13 @@ nex/
 ## 功能特性
 
 - **双协议支持**：同时支持 OpenAI 和 Anthropic 协议
+- **跨协议转换**：Hub-and-Spoke 架构实现 OpenAI ↔ Anthropic 双向转换
 - **统一模型 ID**：`provider_id/model_name` 格式全局唯一标识模型（如 `openai/gpt-4`）
-- **透明代理**：对 OpenAI 兼容供应商 Smart Passthrough，最小化改写保持参数保真
-- **流式响应**：完整支持 SSE 流式传输
+- **Smart Passthrough**：同协议请求零序列化开销，仅改写 model 字段
+- **流式响应**：完整支持 SSE 流式传输，包括跨协议流式转换
 - **Function Calling**：支持工具调用（Tools）
+- **Thinking / Reasoning**：支持 OpenAI `reasoning_effort` 和 Anthropic `thinking` 配置
+- **扩展接口**：支持 Embeddings 和 Rerank 接口
 - **多供应商管理**：配置和管理多个供应商（供应商 ID 仅限字母、数字、下划线）
 - **用量统计**：按供应商、模型、日期统计请求数量
 - **Web 配置界面**：提供供应商和模型配置管理
@@ -54,7 +57,7 @@ nex/
 - **ORM**: GORM
 - **数据库**: SQLite
 - **日志**: zap + lumberjack（结构化日志 + 日志轮转）
-- **配置**: gopkg.in/yaml.v3
+- **配置**: Viper + pflag（多层配置：CLI > 环境变量 > 配置文件 > 默认值）
 - **验证**: go-playground/validator/v10
 - **迁移**: goose
 
@@ -100,12 +103,19 @@ bun dev
 
 ### 代理接口（对外部应用）
 
-代理接口统一使用 `provider_id/model_name` 格式的模型 ID（如 `openai/gpt-4`）。同协议请求走 Smart Passthrough，最小化 JSON 改写保持参数保真；跨协议请求走完整 decode/encode 转换。
+代理接口统一使用 `/{protocol}/*path` 路由格式，模型 ID 使用 `provider_id/model_name` 格式（如 `openai/gpt-4`）。同协议请求走 Smart Passthrough，最小化 JSON 改写保持参数保真；跨协议请求走完整 decode/encode 转换。
 
-- `POST /v1/chat/completions` - OpenAI Chat Completions API
-- `POST /v1/messages` - Anthropic Messages API
-- `GET /v1/models` - 模型列表（本地数据库聚合，不请求上游）
-- `GET /v1/models/{provider_id}/{model_name}` - 模型详情（本地数据库查询）
+**OpenAI 协议**（`protocol=openai`）：
+- `POST /openai/chat/completions` - 对话补全
+- `GET /openai/models` - 模型列表（本地数据库聚合）
+- `GET /openai/models/{provider_id}/{model_name}` - 模型详情（本地数据库查询）
+- `POST /openai/embeddings` - 嵌入
+- `POST /openai/rerank` - 重排序
+
+**Anthropic 协议**（`protocol=anthropic`）：
+- `POST /anthropic/v1/messages` - 消息对话
+- `GET /anthropic/v1/models` - 模型列表（本地数据库聚合）
+- `GET /anthropic/v1/models/{provider_id}/{model_name}` - 模型详情（本地数据库查询）
 
 ### 管理接口（对前端）
 
@@ -131,6 +141,10 @@ bun dev
 
 ## 配置
 
+配置支持多种方式，优先级为：**CLI 参数 > 环境变量 > 配置文件 > 默认值**
+
+### 配置文件
+
 配置文件位于 `~/.nex/config.yaml`，首次启动自动生成：
 
 ```yaml
@@ -154,7 +168,28 @@ log:
   compress: true
 ```
 
-数据文件：
+### 环境变量
+
+所有配置项支持环境变量，使用 `NEX_` 前缀：
+
+```bash
+export NEX_SERVER_PORT=9000
+export NEX_DATABASE_PATH=/data/nex.db
+export NEX_LOG_LEVEL=debug
+```
+
+命名规则：配置路径转大写 + 下划线（如 `server.port` → `NEX_SERVER_PORT`）。
+
+### CLI 参数
+
+```bash
+./server --server-port 9000 --log-level debug --database-path /tmp/test.db
+```
+
+命名规则：配置路径转 kebab-case（如 `server.port` → `--server-port`）。
+
+### 数据文件
+
 - `~/.nex/config.yaml` - 配置文件
 - `~/.nex/config.db` - SQLite 数据库
 - `~/.nex/log/` - 日志目录