chore:ci&readme updates

.github/workflows/docker-image.yml

@@ -3,7 +3,7 @@ name: Build and Publish Docker Image
 on:
   push:
     branches:
-      - main
+      - master
     tags:
       - 'v*'
   workflow_dispatch:

README.md

@@ -1,60 +1,106 @@
 # zai-proxy
 
-zai-proxy 是一个基于 Go 语言的代理服务，将 z.ai 网页聊天转换为 OpenAI API 兼容格式。用户使用自己的 z.ai token 进行调用。
+zai-proxy 是一个基于 Go 语言的代理服务，将 z.ai 网页聊天转换为 **OpenAI API** 和 **Anthropic Messages API** 兼容格式。用户使用自己的 z.ai token 或 `free` 匿名令牌进行调用。
 
 ## 功能特性
 
-- OpenAI API 兼容格式
-- 支持流式和非流式响应
-- 支持多种 GLM 模型
+- OpenAI `/v1/chat/completions` 兼容
+- Anthropic `/v1/messages` 兼容（支持 Claude SDK 直连）
+- 支持流式 (SSE) 和非流式响应
+- 支持多种 GLM 模型，Claude 模型名自动映射
 - 支持思考模式 (thinking)
 - 支持联网搜索模式 (search)
-- 支持内置工具调用 (tools)
+- 支持工具/函数调用 (function calling)
 - 支持多模态图片输入
 - 支持匿名 Token（免登录）
-- **自动生成签名**
-- **自动更新签名版本号**
+- 自动生成请求签名
+- 自动跟踪前端版本号
 
 ## 快速开始
 
-### 安装运行
+### 从源码运行
+
+要求 Go 1.21+：
 
 ```bash
-# 克隆项目
-git clone https://github.com/kao0312/zai-proxy.git
+git clone https://github.com/yurika0211/zai-proxy.git
 cd zai-proxy
-
-# 安装依赖
 go mod download
-
-# 运行服务
 go run main.go
 ```
 
-### Docker 一键部署
+编译为可执行文件：
+
+```bash
+go build -o zai-proxy .
+./zai-proxy
+```
+
+### Docker 部署
+
+#### 使用预构建镜像
 
 ```bash
-docker run -d -p 8000:8000 ghcr.io/kao0312/zai-proxy:latest
+docker run -d --name zai-proxy -p 8000:8000 ghcr.io/yurika0211/zai-proxy:latest
 ```
 
 自定义端口和日志级别：
 
 ```bash
-docker run -d -p 8080:8000 -e LOG_LEVEL=debug ghcr.io/kao0312/zai-proxy:latest
+docker run -d --name zai-proxy \
+  -p 8080:8000 \
+  -e LOG_LEVEL=debug \
+  ghcr.io/yurika0211/zai-proxy:latest
+```
+
+> 镜像支持 `linux/amd64` 和 `linux/arm64` 双平台。
+
+#### 可用镜像标签
+
+| 标签 | 说明 |
+|------|------|
+| `latest` | 默认分支的最新构建 |
+| `v*`（如 `v1.0.0`） | 语义化版本发布 |
+| `<commit-sha>` | 特定 commit 的构建 |
+
+#### 自行构建镜像
+
+```bash
+docker build -t zai-proxy .
+docker run -d --name zai-proxy -p 8000:8000 zai-proxy
+```
+
+#### Docker Compose
+
+```yaml
+services:
+  zai-proxy:
+    image: ghcr.io/yurika0211/zai-proxy:latest
+    ports:
+      - "8000:8000"
+    environment:
+      - LOG_LEVEL=info
+    restart: unless-stopped
+```
+
+```bash
+docker compose up -d
 ```
 
 ## 环境变量
 
 | 变量名 | 说明 | 默认值 |
 |--------|------|--------|
-| PORT | 监听端口 | 8000 |
-| LOG_LEVEL | 日志级别 | info |
+| `PORT` | 监听端口 | `8000` |
+| `LOG_LEVEL` | 日志级别 (`debug` / `info` / `warn` / `error`) | `info` |
+
+支持 `.env` 文件自动加载。
 
 ## 获取 z.ai Token
 
 ### 方式一：使用匿名 Token（免登录）
 
-直接使用 `free` 作为 API key，服务会自动获取一个匿名 token：
+直接使用 `free` 作为 API key，服务会自动获取匿名 token：
 
 ```bash
 curl http://localhost:8000/v1/chat/completions \
@@ -71,52 +117,104 @@ curl http://localhost:8000/v1/chat/completions \
 4. 在 Cookies 中找到 `token` 字段
 5. 复制其值作为 API 调用的 Authorization
 
-## 支持的模型
+## API 端点
 
-| 模型名称 | 上游模型 |
-|----------|----------|
-| GLM-4.5 | 0727-360B-API |
-| GLM-4.6 | GLM-4-6-API-V1 |
-| GLM-4.7 | glm-4.7 |
-| GLM-4.5-V | glm-4.5v |
-| GLM-4.6-V | glm-4.6v |
-| GLM-4.5-Air | 0727-106B-API |
+### `GET /v1/models`
 
-### 模型标签
+返回可用模型列表（OpenAI 兼容格式）。
 
-模型名称支持以下后缀标签（可组合使用）：
+### `POST /v1/chat/completions`
 
-- `-thinking`: 启用思考模式，响应会包含 `reasoning_content` 字段
-- `-search`: 启用联网搜索模式
-- `-tools`: 自动注入内置工具定义，模型会返回 `tool_calls` 进行函数调用
-- (TODO) `-deepsearch`: 启用多轮搜索，深入研究分析
+OpenAI 兼容的聊天补全接口。
 
-标签可任意组合，顺序不限：
+**认证方式：** `Authorization: Bearer <token>` 或 `x-api-key: <token>`
 
-示例：
+```bash
+curl http://localhost:8000/v1/chat/completions \
+  -H "Authorization: Bearer YOUR_ZAI_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "GLM-4.7",
+    "messages": [{"role": "user", "content": "hello"}],
+    "stream": true
+  }'
+```
 
-- `GLM-4.7-thinking`
-- `GLM-4.7-search`
-- `GLM-4.7-thinking-search`
-- `GLM-4.7-tools`
-- `GLM-4.7-tools-thinking`
+### `POST /v1/messages`
 
-## 使用示例
+Anthropic Messages API 兼容接口，可直接使用 Anthropic SDK 连接。
 
-### curl 测试
+**认证方式：** `x-api-key: <token>` 或 `Authorization: Bearer <token>`
 
 ```bash
-curl http://localhost:8000/v1/chat/completions \
-  -H "Authorization: Bearer YOUR_ZAI_TOKEN" \
+curl http://localhost:8000/v1/messages \
+  -H "x-api-key: free" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "GLM-4.7",
+    "model": "claude-sonnet-4-6",
+    "max_tokens": 1024,
     "messages": [{"role": "user", "content": "hello"}],
     "stream": true
   }'
 ```
 
-### 多模态请求：
+支持的 Anthropic 特性：
+- `system` 字段（字符串或内容块数组）
+- `thinking` 推理模式（`{"type": "enabled"}`）
+- `tools` / `tool_choice` 工具调用
+- 流式 SSE 事件（`message_start` / `content_block_delta` / `message_stop` 等）
+- 非流式 JSON 响应
+
+## 支持的模型
+
+### GLM 模型
+
+| 模型名称 | 上游模型 | 说明 |
+|----------|----------|------|
+| `GLM-4.5` | 0727-360B-API | |
+| `GLM-4.6` | GLM-4-6-API-V1 | |
+| `GLM-4.7` | glm-4.7 | 最新 |
+| `GLM-4.5-V` | glm-4.5v | 视觉 |
+| `GLM-4.6-V` | glm-4.6v | 视觉（最新） |
+| `GLM-4.5-Air` | 0727-106B-API | 轻量 |
+
+### Claude 模型名映射
+
+通过 `/v1/messages` 端点使用 Claude 模型名时，会自动映射到对应的 GLM 模型：
+
+| Claude 模型 | 映射到 | 备注 |
+|-------------|--------|------|
+| `claude-opus-4-6` | GLM-4.7 | 自动启用 thinking |
+| `claude-opus-4-5-20250514` | GLM-4.7 | 自动启用 thinking |
+| `claude-sonnet-4-6` | GLM-4.7 | |
+| `claude-sonnet-4-5-20241022` | GLM-4.7 | |
+| `claude-haiku-4-5` | GLM-4.5-Air | |
+| `claude-haiku-4-5-20251001` | GLM-4.5-Air | |
+| `claude-3-5-sonnet-20241022` | GLM-4.7 | |
+| `claude-3-5-haiku-20241022` | GLM-4.5-Air | |
+
+> Opus 系列模型始终自动启用 thinking 模式。未识别的模型名会回退到 GLM-4.7。
+
+### 模型标签
+
+模型名称支持以下后缀标签（可组合使用，顺序不限）：
+
+| 标签 | 说明 |
+|------|------|
+| `-thinking` | 启用思考模式，响应包含 `reasoning_content` 字段 |
+| `-search` | 启用联网搜索，搜索结果自动转换为 markdown 引用 |
+| `-tools` | 自动注入内置工具定义，模型可进行函数调用 |
+
+组合示例：
+- `GLM-4.7-thinking`
+- `GLM-4.7-search`
+- `GLM-4.7-thinking-search`
+- `GLM-4.7-tools`
+- `GLM-4.7-tools-thinking`
+
+## 使用示例
+
+### 多模态请求
 
 ```json
 {
@@ -133,24 +231,59 @@ curl http://localhost:8000/v1/chat/completions \
 }
 ```
 
-### 支持的图片格式：
+支持的图片格式：
 - HTTP/HTTPS URL
-- Base64 编码 (data:image/jpeg;base64,...)
+- Base64 编码 (`data:image/jpeg;base64,...`)
 
-## 工具调用 (Function Calling)
+### Anthropic SDK (Python)
+
+```python
+import anthropic
+
+client = anthropic.Anthropic(
+    api_key="free",
+    base_url="http://localhost:8000",
+)
 
-使用 `-tools` 后缀时，代理会自动注入 6 个内置工具定义。模型会根据用户输入决定是否调用工具。
+message = client.messages.create(
+    model="claude-sonnet-4-6",
+    max_tokens=1024,
+    messages=[{"role": "user", "content": "hello"}],
+)
+print(message.content[0].text)
+```
+
+### Anthropic SDK 思考模式
+
+```python
+message = client.messages.create(
+    model="claude-opus-4-6",
+    max_tokens=8192,
+    thinking={"type": "enabled", "budget_tokens": 4096},
+    messages=[{"role": "user", "content": "解释量子纠缠"}],
+)
+
+for block in message.content:
+    if block.type == "thinking":
+        print("思考:", block.thinking)
+    elif block.type == "text":
+        print("回答:", block.text)
+```
+
+## 工具调用 (Function Calling)
 
 ### 内置工具
 
-| 工具名 | 描述 |
-|--------|------|
-| `get_current_time` | 获取当前时间 |
-| `calculate` | 执行数学计算 |
-| `search_web` | 搜索网络信息 |
-| `query_database` | 执行SQL查询 |
-| `file_operations` | 文件读写列表 |
-| `call_external_api` | 调用外部API |
+使用 `-tools` 后缀时，代理会自动注入以下 6 个内置工具定义：
+
+| 工具名 | 描述 | 主要参数 |
+|--------|------|----------|
+| `get_current_time` | 获取当前时间 | `timezone`, `format` |
+| `calculate` | 执行数学计算 | `expression` |
+| `search_web` | 搜索网络信息 | `query`, `num_results` |
+| `query_database` | 执行 SQL 查询 | `sql`, `database` |
+| `file_operations` | 文件读写列表 | `operation`, `path`, `content` |
+| `call_external_api` | 调用外部 API | `url`, `method`, `headers`, `body` |
 
 ### 基本调用
 
@@ -217,4 +350,83 @@ curl http://localhost:8000/v1/chat/completions \
 }
 ```
 
+`tool_choice` 支持：
+- `"auto"` — 模型自行决定是否调用工具
+- `"required"` — 强制调用工具
+- `"none"` — 禁用工具调用
+- `{"type": "function", "function": {"name": "xxx"}}` — 强制调用指定工具
+
 两者可混合使用：`-tools` 模型名 + 自定义 `tools` 字段。**客户端自带的同名工具优先**，不会被内置工具覆盖。
+
+### Anthropic 格式工具调用
+
+通过 `/v1/messages` 端点同样支持工具调用：
+
+```bash
+curl http://localhost:8000/v1/messages \
+  -H "x-api-key: free" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-sonnet-4-6",
+    "max_tokens": 1024,
+    "messages": [{"role": "user", "content": "北京天气怎么样？"}],
+    "tools": [{
+      "name": "get_weather",
+      "description": "获取天气信息",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "city": {"type": "string", "description": "城市名称"}
+        },
+        "required": ["city"]
+      }
+    }]
+  }'
+```
+
+`tool_choice` 映射关系：
+
+| Anthropic | OpenAI 等价 |
+|-----------|-------------|
+| `{"type": "auto"}` | `"auto"` |
+| `{"type": "any"}` | `"required"` |
+| `{"type": "none"}` | `"none"` |
+| `{"type": "tool", "name": "xxx"}` | `{"type": "function", ...}` |
+
+## 项目结构
+
+```
+zai-proxy/
+├── main.go                     # 入口，路由注册
+├── internal/
+│   ├── auth/                   # 认证与签名
+│   │   ├── anonymous.go        # 匿名 token 获取
+│   │   ├── jwt.go              # JWT 解码
+│   │   └── signature.go        # HMAC-SHA256 请求签名
+│   ├── config/                 # 配置加载 (.env)
+│   ├── filter/                 # 响应处理过滤器
+│   │   ├── prompttool.go       # 提取 prompt 注入的 tool call
+│   │   ├── toolcall.go         # 解析 JSON 格式的 tool call
+│   │   ├── thinking.go         # 思考/推理内容处理
+│   │   └── search.go           # 搜索结果引用转换
+│   ├── handler/                # HTTP 处理器
+│   │   ├── chat.go             # /v1/chat/completions
+│   │   ├── anthropic.go        # /v1/messages
+│   │   └── models.go           # /v1/models
+│   ├── logger/                 # 日志系统
+│   ├── model/                  # 类型定义
+│   │   ├── types.go            # OpenAI 兼容类型
+│   │   ├── anthropic.go        # Anthropic API 类型
+│   │   └── mapping.go          # 模型名映射与解析
+│   ├── tools/                  # 内置工具定义
+│   │   ├── builtin.go          # 6 个内置工具
+│   │   └── prompt.go           # 工具系统提示词构建
+│   ├── upstream/               # 上游 z.ai 客户端
+│   │   ├── client.go           # 请求构建与发送
+│   │   └── upload.go           # 图片上传
+│   └── version/                # 前端版本号跟踪
+├── scripts/
+│   └── test_tool_call.sh       # 工具调用集成测试
+├── Dockerfile
+└── .github/workflows/          # CI/CD
+```