AI_CONFIGURATION_GUIDE.md

AI 配置指南：开启 DeepSeek-V3 智能对话

本项目集成了 SiliconFlow (硅基流动) 的 API 服务，让您可以直接调用强大的 DeepSeek-V3 大模型进行智能金融对话。

如果您发现 AI 只能回答简单的预设问题（Mock 模式），说明您还没有配置 API Key。请按照以下步骤操作。

1. 什么是 SiliconFlow 和 DeepSeek-V3？

• DeepSeek-V3: 当前最强大的开源大模型之一，在金融分析、代码生成和逻辑推理方面表现出色。
• SiliconFlow: 一个提供高性能大模型推理服务的平台，兼容 OpenAI 接口格式，速度快且稳定。

2. 获取 API Key

1. 访问 SiliconFlow 官网 并注册账号。
2. 进入 API 密钥 管理页面。
3. 点击 创建新密钥。
4. 复制生成的以 sk- 开头的密钥字符串。

3. 配置指南

方式一：本地开发环境 (Local)

1. 在项目根目录找到或创建 .env 文件。

2. 添加以下内容：

   # .env 文件
   SILICONFLOW_API_KEY=sk-your-actual-api-key-here
   

3. 重启后端服务：

   # 停止当前运行的 python 进程 (Ctrl+C)
   source venv/bin/activate
   python app.py
   

方式二：Hugging Face Spaces 部署

如果您将项目部署在 Hugging Face Spaces 上：

1. 进入您的 Space 页面。
2. 点击上方的 Settings 选项卡。
3. 找到 Repository secrets 部分。
4. 点击 New secret。
5. 填写信息：
   • Name: SILICONFLOW_API_KEY
   • Value: (粘贴您的 sk-密钥)
6. 点击 Save。Space 会自动重启并应用新配置。

4. 验证是否生效

1. 打开聊天界面。
2. 如果您看到页面顶部提示 **(Powered by SiliconFlow)**，且没有出现 "演示模式" 字样，说明配置可能已生效。
3. 尝试问一个复杂的问题，例如：“分析一下目前的美联储降息对黄金价格的影响”。
4. 如果 AI 给出了详细、逻辑清晰的回答，恭喜您，智能对话已开启！