# 🚀 5分钟快速开始 - 使用免费API

## 步骤1: 获取免费API Key (2分钟)

### 方式1: 硅基流动 (推荐) ⭐

1. 访问: https://cloud.siliconflow.cn
2. 点击"免费注册"
3. 使用微信或手机号注册
4. 进入控制台 → API密钥
5. 点击"创建新密钥"
6. 复制密钥（格式: `sk-xxxxxx`）

**免费额度**: 每月免费Token，足够测试使用！

### 方式2: DeepSeek (备选)

1. 访问: https://platform.deepseek.com
2. 注册账号
3. 充值10元（可用很久）
4. 获取API Key

## 步骤2: 配置API Key (1分钟)

打开文件: `ry-xinli-admin/src/main/resources/application.yml`

找到这一行：
```yaml
api-key: sk-your-api-key-here
```

替换为你的API Key：
```yaml
api-key: sk-abcdefghijklmnopqrstuvwxyz123456
```

**完整配置示例**:
```yaml
rag:
  mode: openai
  openai:
    base-url: https://api.siliconflow.cn/v1
    api-key: sk-你的密钥  # ⚠️ 修改这里
    embed-model: BAAI/bge-large-zh-v1.5
    generate-model: deepseek-ai/DeepSeek-V3
```

## 步骤3: 启动应用 (2分钟)

```bash
cd ry-xinli-admin
mvn spring-boot:run
```

等待启动完成，看到：
```
Started XinliAdminApplication in X seconds
```

## 步骤4: 测试功能 (1分钟)

### 测试1: 健康检查

浏览器访问:
```
http://localhost:8080/psychology/rag-test/health
```

应该看到：
```json
{
  "code": 200,
  "data": {
    "overall_status": "HEALTHY"
  }
}
```

### 测试2: 向量化测试

```bash
curl -X POST "http://localhost:8080/psychology/rag-test/test-embedding" \
  -d "text=测试文本"
```

### 测试3: 文本生成测试

```bash
curl -X POST "http://localhost:8080/psychology/rag-test/test-generation" \
  -d "prompt=什么是心理学？"
```

## ✅ 完成！

现在你可以：

1. **上传文档**: 通过API上传心理学文档
2. **智能问答**: 基于知识库回答问题
3. **生成报告**: 生成AI增强的心理评估报告

## 📚 下一步

- 查看完整API文档: `RAG-API-EXAMPLES.md`
- 了解更多免费服务: `RAG-FREE-SERVICES-GUIDE.md`
- 开发前端页面: 参考API示例

## ❓ 遇到问题？

### 问题1: API Key无效

**错误**: `401 Unauthorized`

**解决**: 
1. 检查API Key是否正确复制
2. 确认没有多余的空格
3. 确认API Key以`sk-`开头

### 问题2: 连接超时

**错误**: `Connection timeout`

**解决**:
1. 检查网络连接
2. 确认可以访问 https://api.siliconflow.cn
3. 尝试使用VPN（如果在特殊网络环境）

### 问题3: 免费额度用完

**解决**:
1. 等待下月刷新
2. 充值少量金额（通常几元即可）
3. 切换到其他免费服务

## 💡 省钱小技巧

1. **减少检索数量**: 
```yaml
retrieval:
  top-k: 3  # 默认5，改为3
```

2. **使用更小的模型**:
```yaml
generate-model: Qwen/Qwen2.5-7B-Instruct  # 更快更便宜
```

3. **提高相似度阈值**:
```yaml
similarity-threshold: 0.75  # 默认0.7，提高到0.75
```

---

**需要帮助？** 查看详细文档: `RAG-FREE-SERVICES-GUIDE.md`