README.md

---
title: CLI Proxy API Plus
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
short_description: 統一的 AI API 代理服務
---

# 🚀 CLI Proxy API Plus

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Go](https://img.shields.io/badge/Go-1.26-00ADD8?logo=go)](https://golang.org/)
[![Streamlit](https://img.shields.io/badge/Streamlit-1.28+-FF4B4B?logo=streamlit)](https://streamlit.io/)

統一的 AI API 代理服務，支援多種 AI 提供者，提供標準化的 OpenAI 兼容 API 接口。

## ✨ 功能特點

- 🔌 **統一 API 接口** - OpenAI 兼容格式，無縫整合現有工具
- 🔐 **OAuth 認證管理** - 支援多種 OAuth 認證流程
- 📊 **使用量統計** - 實時監控 API 使用情況
- 🔄 **自動 Token 刷新** - 智能管理認證憑證
- 🌐 **多提供者支援** - Claude、OpenAI、Gemini、Copilot、Kiro 等
- 🎨 **Streamlit Web UI** - 友好的圖形化管理介面

## 🤖 支援的 AI 提供者

| 提供者 | 認證方式 | 模型 |
|--------|----------|------|
| 🟠 **Claude** | OAuth | claude-3-5-sonnet, claude-3-opus |
| 🟢 **OpenAI** | API Key / OAuth | gpt-4o, gpt-4-turbo |
| 🔵 **Gemini** | API Key | gemini-1.5-pro, gemini-1.5-flash |
| ⚫ **GitHub Copilot** | OAuth | gpt-4, gpt-3.5-turbo |
| 🟡 **Kiro** | OAuth / AWS | claude-3-5-sonnet (via AWS) |
| 🟣 **Codex** | OAuth | gpt-4, gpt-3.5-turbo |

## 🚀 快速開始

### 使用 Web UI

1. 訪問此 Space 的 URL
2. 在側邊欄查看 API 狀態
3. 使用以下功能：
   - **💬 Chat** - 測試 API 請求
   - **🔑 Auth** - 管理認證憑證
   - **📊 Stats** - 查看使用統計
   - **⚙️ Settings** - 配置系統

### API 端點

```bash
# Chat Completions (OpenAI 兼容)
curl -X POST https://{your-space}.hf.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# 列出模型
curl https://{your-space}.hf.space/v1/models
```

## 🔐 配置 Secrets

在 Hugging Face Spaces 的 **Settings > Secrets** 中添加以下配置：

| Secret 名稱 | 說明 | 範例 |
|-------------|------|------|
| `API_KEYS` | API 訪問密鑰 | `["sk-xxx", "sk-yyy"]` |
| `MANAGEMENT_KEY` | 管理介面密鑰 | `your-admin-key` |
| `CLAUDE_TOKEN` | Claude OAuth Token | (JSON 格式) |
| `OPENAI_API_KEY` | OpenAI API Key | `sk-...` |
| `GEMINI_API_KEY` | Gemini API Key | `AIza...` |

## 📁 專案結構

```
hf-spaces/
├── Dockerfile           # Docker 構建文件
├── supervisord.conf     # 進程管理配置
├── entrypoint.sh        # 容器入口腳本
├── requirements.txt     # Python 依賴
├── README.md            # 本文件
├── DEPLOYMENT.md        # 詳細部署指南
├── CLIProxyAPIPlus      # Go 二進制（需預先構建）
└── streamlit_app/       # Streamlit 應用
    ├── app.py           # 主程序
    └── pages/
        ├── 1_💬_Chat.py    # API 測試頁面
        ├── 2_🔑_Auth.py    # 認證管理頁面
        ├── 3_📊_Stats.py   # 使用統計頁面
        └── 4_⚙️_Settings.py # 系統設定頁面
```

## 🔧 構建 Go 二進制

**重要**：部署前需要先構建 Go 二進制文件。

### Linux/macOS
```bash
cd /path/to/CLIProxyAPIPlus
GOOS=linux GOARCH=amd64 go build -o hf-spaces/CLIProxyAPIPlus ./cmd/server/
```

### Windows (PowerShell)
```powershell
cd C:\path\to\CLIProxyAPIPlus
$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o hf-spaces/CLIProxyAPIPlus ./cmd/server/
```

### 驗證構建
```bash
ls -la hf-spaces/CLIProxyAPIPlus
# 應該顯示一個約 20-30MB 的可執行文件
```

## 🏗️ 架構

```
┌─────────────────────────────────────────┐
│           Hugging Face Spaces            │
│  ┌─────────────────────────────────────┐ │
│  │          Docker Container           │ │
│  │  ┌─────────────┐  ┌──────────────┐  │ │
│  │  │  Streamlit  │  │  Go API      │  │ │
│  │  │  :7860      │  │  :8317       │  │ │
│  │  │  (前端UI)    │──│  (後端服務)   │  │ │
│  │  └─────────────┘  └──────────────┘  │ │
│  │         Supervisord 進程管理         │ │
│  └─────────────────────────────────────┘ │
└─────────────────────────────────────────┘
                    │
                    ▼
        ┌───────────────────────┐
        │    AI Provider APIs    │
        │  Claude/OpenAI/Gemini  │
        └───────────────────────┘
```

## 📖 使用說明

### 1. API 測試

1. 點擊左側 **💬 Chat** 頁面
2. 選擇 AI 提供者和模型
3. 輸入問題並發送請求
4. 查看響應結果

### 2. 認證管理

1. 點擊左側 **🔑 Auth** 頁面
2. 查看各提供者的認證狀態
3. 配置 OAuth 或 API Key

### 3. 查看統計

1. 點擊左側 **📊 Stats** 頁面
2. 查看請求量、Token 消耗等統計
3. 監控各提供者狀態

## ⚠️ 注意事項

1. **資源限制** - HF Spaces 免費版有 CPU 和內存限制
2. **存儲限制** - 容器重啟後數據會丟失
3. **HTTPS** - HF Spaces 強制使用 HTTPS
4. **並發限制** - 免費版並發請求有限制

## 🔗 相關連結

- [GitHub 倉庫](https://github.com/router-for-me/CLIProxyAPIPlus)
- [原版文檔](https://github.com/router-for-me/CLIProxyAPI)
- [Hugging Face Spaces](https://huggingface.co/spaces)

## 📝 授權

本專案採用 MIT 授權條款。詳見 [LICENSE](LICENSE) 文件。

---

<p align="center">
  Made with ❤️ by CLIProxyAPI Plus Team
</p>