DEPLOY_GUIDE.md

# CLIProxyAPI 部署到 Hugging Face Spaces 说明

## 已完成的准备工作

已在 `c:\Users\asemx\.gemini\antigravity\playground\deep-crab` 目录下创建了以下文件：

1. **Dockerfile** - 适配 HF Spaces 的 Docker 配置
   - 使用 7860 端口（HF Spaces 要求）
   - 设置非 root 用户运行
   - 自动从 GitHub 克隆 CLIProxyAPI 源码并编译

2. **README.md** - HF Spaces 元数据配置文件
   - 设置 SDK 为 Docker
   - 包含基本说明

## 手动部署步骤

### 步骤 1：创建 HF Space

1. 访问 https://huggingface.co/new-space
2. 登录您的 Hugging Face 账户
3. 填写表单：
   - **Space name**: `CLIProxyAPI`（或其他可用名称）
   - **SDK**: 选择 `Docker`
   - **Visibility**: 按需选择
4. 点击 **Create Space**

### 步骤 2：推送代码

创建 Space 后，HF 会显示 git 仓库地址，格式类似：
```
https://huggingface.co/spaces/YOUR_USERNAME/CLIProxyAPI
```

在 PowerShell 中执行以下命令：

```powershell
cd c:\Users\asemx\.gemini\antigravity\playground\deep-crab

# 添加 HF Spaces 远程仓库（替换 YOUR_USERNAME）
git remote add origin https://huggingface.co/spaces/YOUR_USERNAME/CLIProxyAPI

# 推送代码
git push -u origin master
```

如果提示输入凭据，使用：
- 用户名：您的 HF 用户名
- 密码：您的 HF Access Token（在 https://huggingface.co/settings/tokens 生成）

### 步骤 3：等待构建

推送后，HF Spaces 会自动开始构建 Docker 镜像。您可以在 Space 页面查看构建日志。

### 步骤 4：配置环境变量（可选）

在 Space 的 Settings 页面，您可以添加以下环境变量：
- `API_KEYS`: 逗号分隔的 API 密钥列表

## 验证部署

构建完成后，访问您的 Space URL：
```
https://YOUR_USERNAME-cliproxyapi.hf.space
```

API 端点示例：
- Health check: `GET /`
- OpenAI 兼容: `POST /v1/chat/completions`