Delete docs/HUGGINGFACE_DOCKER_SPACE.md

docs/HUGGINGFACE_DOCKER_SPACE.md

@@ -1,154 +0,0 @@
-# Hugging Face Docker Space 部署指南
-
-本文档说明如何使用 Hugging Face 的 Docker Space 技术栈部署 GCLI2API。
-
-## 1. 选择 Docker 方式的适用场景
-
-选择 **Docker** 而不是 Gradio 技术栈的场景：
-- 需要完全自定义运行环境
-- 需要更快的冷启动或更可控的依赖
-- 不需要额外 UI，仅提供 API 服务
-- 需要使用系统级扩展、构建工具或自定义脚本
-
-## 2. 准备代码仓库
-
-仓库已包含优化后的 `Dockerfile`，特点：
-- 多阶段构建（减小最终镜像体积）
-- 使用 `tini` 作为 init 进程，优雅处理信号
-- 非 root 用户运行（安全）
-- 支持 Hugging Face 自动注入的 `PORT` 环境变量
-- 支持健康检查（`/keepalive`）
-
-## 3. 创建 Docker Space
-
-1. 打开 https://huggingface.co/spaces
-2. Create New Space → 选择 `Docker` 技术栈
-3. 填写 Space 名称与可见性
-4. 创建后把本项目代码推送到该 Space（或者直接在 Space 网页上传文件）
-
-## 4. Dockerfile 说明
-
-当前项目内的 `Dockerfile` 默认启动命令：
-```dockerfile
-CMD ["python","app.py"]
-```
-app.py 会：
-- 启动 FastAPI 主应用 (web.py)
-- 提供可选的 Gradio 信息界面（若需要）
-
-如仅需 API，可改为：
-```dockerfile
-CMD ["python","web.py"]
-```
-
-## 5. 配置环境变量
-
-在 Space 设置（Settings → Variables）中添加：
-
-| 变量 | 说明 | 是否必需 |
-| ---- | ---- | -------- |
-| API_PASSWORD | API 访问密码 | 是 |
-| PANEL_PASSWORD | 控制面板密码 | 是（或使用 PASSWORD） |
-| AUTO_LOAD_ENV_CREDS | 启用环境变量凭证载入 | 否 |
-| GCLI_CREDS_* | 提供 Google OAuth 凭证 | 依使用方式决定 |
-
-可选性能优化：
-```bash
-CALLS_PER_ROTATION=10
-RETRY_429_ENABLED=true
-RETRY_429_MAX_RETRIES=5
-ANTI_TRUNCATION_MAX_ATTEMPTS=3
-COMPATIBILITY_MODE=true
-```
-
-## 6. 初次部署流程
-
-1. 推送代码后 Space 会自动构建镜像
-2. 构建完成后自动运行容器
-3. 查看 Logs 确认输出中包含：`GCLI2API Lightspeed - Hugging Face Spaces Edition`
-4. 访问：`https://<space-id>.hf.space/auth` 登录控制台
-5. 上传或配置凭证
-6. 通过 `/v1/models` 验证 API 可用
-
-## 7. API 访问示例
-
-```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": "介绍一下你自己"}
-    ]
-  }'
-```
-
-健康检查：
-```bash
-curl -I "https://<space-id>.hf.space/keepalive"
-```
-
-## 8. 自定义与扩展
-
-### 更换 Python 版本
-修改 `FROM python:3.13-slim` 为其他受支持版本（建议 >=3.11）。
-
-### 添加系统依赖
-在 `Base Stage` 中：
-```dockerfile
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    ffmpeg libmagic1 && rm -rf /var/lib/apt/lists/*
-```
-
-### 修改启动参数
-使用环境变量：
-```bash
-PORT=7860 HOST=0.0.0.0 LOG_LEVEL=INFO
-```
-
-或修改 Dockerfile：
-```dockerfile
-CMD ["python","-m","web"]
-```
-
-## 9. 故障排查
-
-| 症状 | 可能原因 | 解决方案 |
-| ---- | -------- | -------- |
-| Space 构建失败 | 依赖缺失/语法错误 | 查看构建日志，确认 requirements 正常安装 |
-| 401 Unauthorized | 密码错误 | 确认 API_PASSWORD 与请求头一致 |
-| 503 Service Unavailable | 无有效凭证 | 上传 Google OAuth 凭证或配置 GCLI_CREDS_* |
-| 模型名称报错 | 模型名带前缀/后缀拼写错误 | 参考 README_HF.md 中模型命名规则 |
-| 流式响应无输出 | 客户端不支持 SSE | 使用 假流式/ 前缀模型 |
-| 截断 | 输出过长 | 使用 流式抗截断/ 前缀模型 |
-
-## 10. 升级策略
-
-更新代码并推送 -> Space 自动重建 -> 验证功能。
-如需保留持久凭证，可改用外部数据库（Redis/MongoDB/Postgres）。
-
-## 11. 使用外部 Redis (示例)
-
-在 Variables 中配置：
-```bash
-REDIS_URI=rediss://default:token@xxx.upstash.io:6379
-REDIS_DATABASE=0
-```
-
-## 12. 使用 MongoDB Atlas (示例)
-```bash
-MONGODB_URI=mongodb+srv://user:pass@cluster.mongodb.net
-MONGODB_DATABASE=gcli2api
-```
-
-## 13. 切换到 web.py 纯 API 模式
-
-编辑 Dockerfile：
-```dockerfile
-CMD ["python","web.py"]
-```
-并删除 `app.py` 中的 Gradio 依赖（如不需要 UI）。
-
----
-如需 CI 自动同步到 Space，可添加 GitHub Action 使用 `huggingface-cli` 推送更新。