update README.md file

README.md

@@ -56,7 +56,9 @@ exchangeRates/
 
 ## 🚀 快速开始
 
-### 1. 克隆项目
+### 本地部署
+
+#### 1. 克隆项目
 
 ```bash
 cd C:\Users\Eleven\Desktop\exchangeRates
@@ -108,6 +110,64 @@ uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
 - 📚 **API 文档**: http://localhost:8000/docs
 - 📖 **ReDoc**: http://localhost:8000/redoc
 
+### Hugging Face Spaces 部署
+
+本项目支持一键部署到 Hugging Face Spaces。
+
+#### 1. 创建 README.md 头部配置
+
+在项目根目录的 README.md 文件顶部添加以下 YAML 配置：
+
+```yaml
+---
+title: Exchange Rates Service
+emoji: 💱
+colorFrom: blue
+colorTo: green
+sdk: docker
+pinned: false
+license: mit
+---
+```
+
+#### 2. 创建 Dockerfile
+
+项目需要包含 Dockerfile 用于 Spaces 部署：
+
+```dockerfile
+FROM python:3.9-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 7860
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]
+```
+
+#### 3. 配置环境变量
+
+在 Hugging Face Spaces 设置中添加 Secrets：
+- `API_KEYS`: 你的 ExchangeRate-API Keys（逗号分隔）
+- `BASE_CURRENCY`: 基准货币（默认 CNY）
+- `CACHE_UPDATE_INTERVAL`: 缓存更新间隔（默认 3600）
+
+#### 4. 部署步骤
+
+1. 在 [Hugging Face](https://huggingface.co/) 创建新的 Space
+2. 选择 Docker SDK
+3. 上传项目文件或连接 Git 仓库
+4. 在 Settings 中配置 Secrets
+5. Space 将自动构建和部署
+
+#### 5. 访问服务
+
+部署成功后，可通过 `https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME` 访问服务。
+
 ## 📡 API 接口
 
 ### 获取所有汇率
@@ -206,6 +266,19 @@ POST /api/refresh
 | MAX_RETRIES | 最大重试次数 | 3 |
 | SERVER_PORT | 服务端口 | 8000 |
 
+### Hugging Face Spaces 配置参数
+
+| 参数 | 说明 | 示例值 |
+|------|------|--------|
+| sdk | SDK 类型 | docker |
+| app_port | 应用端口（Spaces 默认 7860） | 7860 |
+| title | Space 标题 | Exchange Rates Service |
+| emoji | Space 图标 | 💱 |
+| colorFrom | 渐变起始色 | blue |
+| colorTo | 渐变结束色 | green |
+| pinned | 是否固定在个人主页 | false |
+| license | 开源协议 | mit |
+
 ## 🔑 API Key 获取
 
 1. 访问 [ExchangeRate-API](https://www.exchangerate-api.com/)