Upload 11 files

DEPLOYMENT.md

@@ -5,10 +5,11 @@
 ## 📋 目錄
 
 1. [前置需求](#前置需求)
-2. [快速部署](#快速部署)
-3. [配置 Secrets](#配置-secrets)
-4. [使用說明](#使用說明)
-5. [常見問題](#常見問題)
+2. [構建 Go 二進制](#構建-go-二進制)
+3. [快速部署](#快速部署)
+4. [配置 Secrets](#配置-secrets)
+5. [使用說明](#使用說明)
+6. [常見問題](#常見問題)
 
 ---
 
@@ -20,7 +21,11 @@
    - 註冊地址: https://huggingface.co/join
    - 建議啟用兩步驗證以保護帳號安全
 
-2. **AI 服務提供商帳號**（至少需要一個）
+2. **Go 編譯環境**（用於構建二進制）
+   - Go 1.26 或更高版本
+   - 下載地址: https://go.dev/dl/
+
+3. **AI 服務提供商帳號**（至少需要一個）
    - [Anthropic Claude](https://console.anthropic.com/)
    - [Google AI Studio](https://aistudio.google.com/)
    - [GitHub Copilot](https://github.com/features/copilot)
@@ -32,6 +37,38 @@
 
 ---
 
+## 構建 Go 二進制
+
+**重要**：HF Spaces Dockerfile 需要預先構建的 Go 二進制文件。
+
+### 步驟 1：克隆專案
+
+```bash
+git clone https://github.com/router-for-me/CLIProxyAPI.git
+cd CLIProxyAPI
+```
+
+### 步驟 2：構建 Linux 二進制
+
+**Linux/macOS:**
+```bash
+GOOS=linux GOARCH=amd64 go build -o hf-spaces/CLIProxyAPIPlus ./cmd/server/
+```
+
+**Windows (PowerShell):**
+```powershell
+$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o hf-spaces/CLIProxyAPIPlus ./cmd/server/
+```
+
+### 步驟 3：驗證構建
+
+```bash
+ls -la hf-spaces/CLIProxyAPIPlus
+# 應該顯示一個約 20-30MB 的可執行文件
+```
+
+---
+
 ## 快速部署
 
 ### 方法一：從模板創建（推薦）

Dockerfile

@@ -1,41 +1,14 @@
 # ============================================
 # CLIProxyAPI Plus - Hugging Face Spaces Dockerfile
 # ============================================
-# 此 Dockerfile 假設所有文件都在構建上下文根目錄
-# 適合直接上傳 hf-spaces/ 內容到 HF Space
+# 此 Dockerfile 專為 HF Spaces 設計
+# 假設用戶上傳 hf-spaces/ 目錄內容到 Space 根目錄
+# 
+# 重要：Go 二進制文件需要預先構建並放入此目錄
+# 構建命令（在專案根目錄執行）：
+#   GOOS=linux GOARCH=amd64 go build -o hf-spaces/CLIProxyAPIPlus ./cmd/server/
 # ============================================
 
-# ============================================
-# Stage 1: 構建 Go 應用
-# ============================================
-FROM golang:1.26-alpine AS go-builder
-
-WORKDIR /build
-
-# 安裝構建依賴
-RUN apk add --no-cache git ca-certificates tzdata
-
-# 複製 Go 模組文件
-COPY go.mod go.sum ./
-RUN go mod download
-
-# 複製源碼並構建
-COPY . .
-
-ARG VERSION=hf-spaces
-ARG COMMIT=none
-ARG BUILD_DATE=unknown
-
-RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
-    go build -ldflags="-s -w \
-    -X 'main.Version=${VERSION}-plus' \
-    -X 'main.Commit=${COMMIT}' \
-    -X 'main.BuildDate=${BUILD_DATE}'" \
-    -o ./CLIProxyAPIPlus ./cmd/server/
-
-# ============================================
-# Stage 2: 最終運行環境
-# ============================================
 FROM python:3.11-slim-bookworm
 
 LABEL maintainer="CLIProxyAPI Plus"
@@ -59,20 +32,21 @@ RUN mkdir -p /app/go-server \
     && mkdir -p /root/.cli-proxy-api \
     && mkdir -p /app/logs
 
-# 複製 Go 二進制文件（從構建階段）
-COPY --from=go-builder /build/CLIProxyAPIPlus /app/go-server/CLIProxyAPIPlus
+# 複製 Go 二進制文件（需要預先構建）
+COPY CLIProxyAPIPlus /app/go-server/CLIProxyAPIPlus
+RUN chmod +x /app/go-server/CLIProxyAPIPlus
 
-# 複製 Streamlit 應用（文件在根目錄）
+# 複製 Streamlit 應用
 COPY streamlit_app/ /app/streamlit/
 COPY requirements.txt /app/streamlit/
 
 # 安裝 Python 依賴
 RUN pip install --no-cache-dir -r /app/streamlit/requirements.txt
 
-# 複製 Supervisor 配置（文件在根目錄）
+# 複製 Supervisor 配置
 COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
 
-# 複製啟動腳本（文件在根目錄）
+# 複製啟動腳本
 COPY entrypoint.sh /app/entrypoint.sh
 RUN chmod +x /app/entrypoint.sh
 

README.md

@@ -81,13 +81,15 @@ curl https://{your-space}.hf.space/v1/models
 
 ```
 hf-spaces/
-├── Dockerfile              # Docker 構建文件
-├── supervisord.conf        # 進程管理配置
-├── entrypoint.sh           # 容器入口腳本
-├── requirements.txt        # Python 依賴
-├── README.md               # 本文件
-└── streamlit_app/          # Streamlit 應用
-    ├── app.py              # 主程序
+├── 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    # 認證管理頁面
@@ -95,6 +97,28 @@ hf-spaces/
         └── 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 的可執行文件
+```
+
 ## 🏗️ 架構
 
 ```