Delete docs/HUGGINGFACE_DEPLOY.md

docs/HUGGINGFACE_DEPLOY.md

@@ -1,130 +0,0 @@
-# Hugging Face Spaces 部署指南
-
-本文档介绍如何将 GCLI2API 部署到 Hugging Face Spaces。
-
-## 1. 部署方式选择
-
-推荐使用 **Gradio (Python) Space** 进行部署。
-
-## 2. 必要文件说明
-
-已添加以下适配文件：
-
-| 文件 | 作用 |
-| ---- | ---- |
-| `app.py` | Hugging Face Space 启动入口，启动 FastAPI 服务并提供 Gradio 信息页 |
-| `README_HF.md` | Hugging Face Space 展示 README，用于空间首页说明 |
-| `requirements.txt` | 依赖列表，已加入 gradio 与 requests |
-| `.env.example` | 环境变量示例文件 |
-| `README.md` | 已添加 front matter 以支持 HF Metadata |
-
-## 3. 创建 Hugging Face Space
-
-1. 打开 https://huggingface.co/spaces
-2. 点击 "Create new Space"
-3. 选择技术栈：`Gradio`
-4. 填写名称，例如：`your-username/gcli2api`
-5. 选择可见性：`Public` 或 `Private`
-6. 创建后，将当前仓库代码推送到新建 Space 或在 Space 内手动上传文件
-
-## 4. 设置环境变量 (Settings → Variables)
-
-最少需要配置：
-
-| 名称 | 说明 | 是否必需 |
-| ---- | ---- | -------- |
-| `API_PASSWORD` | API 请求认证密码 | 是（或用 PASSWORD） |
-| `PANEL_PASSWORD` | 控制面板登录密码 | 是（或用 PASSWORD） |
-| `PASSWORD` | 通用密码（设置后覆盖上面两个） | 否 |
-| `AUTO_LOAD_ENV_CREDS` | 是否自动加载环境变量凭证 | 否 |
-
-凭证（任选其一方式）：
-
-1. 在 Web 控制面板上传 credential JSON 文件
-2. 设置 `AUTO_LOAD_ENV_CREDS=true` 并添加：
-   ```bash
-   GCLI_CREDS_1={"client_id":"...","client_secret":"...","refresh_token":"...","token_uri":"https://oauth2.googleapis.com/token","project_id":"your-project"}
-   GCLI_CREDS_2={"client_id":"...","project_id":"..."}
-   ```
-
-可选优化参数：
-```bash
-CALLS_PER_ROTATION=10
-RETRY_429_ENABLED=true
-RETRY_429_MAX_RETRIES=5
-COMPATIBILITY_MODE=true
-ANTI_TRUNCATION_MAX_ATTEMPTS=3
-```
-
-## 5. Space 启动后访问
-
-| 功能 | URL 示例 |
-| ---- | -------- |
-| 控制面板 | `https://<space-id>.hf.space/auth` |
-| OpenAI 模型列表 | `https://<space-id>.hf.space/v1/models` |
-| 健康检测 | `https://<space-id>.hf.space/keepalive` |
-
-## 6. 示例请求
-
-```bash
-curl -X POST "https://<space-id>.hf.space/v1/chat/completions" \
-  -H "Authorization: Bearer ${API_PASSWORD}" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "model": "gemini-2.5-pro",
-    "messages": [
-      {"role": "user", "content": "你好"}
-    ]
-  }'
-```
-
-## 7. 常见问题与解决
-
-| 问题 | 可能原因 | 解决方案 |
-| ---- | -------- | -------- |
-| 401 Unauthorized | 密码错误 | 检查 `API_PASSWORD` 或 `PASSWORD` |
-| 503 Service Unavailable | 无有效凭证 | 上传或配置 GCLI_CREDS_* |
-| 模型列表为空 | 未正确认证 | 确认凭证刷新成功 |
-| 流式不输出 | 客户端不支持 SSE | 使用假流式模型 `假流式/` 前缀 |
-
-## 8. 模型命名速查
-
-| 模式 | 示例 |
-| ---- | ---- |
-| 基础 | `gemini-2.5-pro` |
-| 假流式 | `假流式/gemini-2.5-pro` |
-| 抗截断流式 | `流式抗截断/gemini-2.5-pro` |
-| 最大思考 | `gemini-2.5-pro-maxthinking` |
-| 无思考 | `gemini-2.5-pro-nothinking` |
-| 搜索增强 | `gemini-2.5-pro-search` |
-
-可组合：`流式抗截断/gemini-2.5-pro-maxthinking`
-
-## 9. 安全建议
-
-- 使用随机长密码（>=24字符）
-- Private Space 存放敏感凭证
-- 不要在公共 README 中泄露密码
-- 定期轮换凭证与刷新 token
-
-## 10. 维护操作
-
-| 操作 | 方法 |
-| ---- | ---- |
-| 更新代码 | 推送到 Space 触发重建 |
-| 查看日志 | Space Logs 面板 + Web 面板实时日志 |
-| 清空日志 | 面板中提供清空按钮 |
-| 添加凭证 | 面板上传或新增环境变量 |
-
-## 11. 自定义扩展 (可选)
-
-如果需要自定义依赖或系统级库，可切换到 **Docker Space**，并使用项目中现有 `Dockerfile`（如需精简可自行裁剪）。
-
-## 12. 版本升级策略
-
-- 关注上游仓库 release
-- 使用 Git Submodule 或定期同步
-- 修改前备份 `creds/` 与持久化数据库
-
----
-如需进一步自动化（CI 自动推送 Space），可添加 GitHub Actions，构建并同步至 Hugging Face。