Snap-Solver 项目启动与配置教程

1. 项目目录结构及介绍

Snap-Solver 项目的主要目录结构如下所示：

Snap-Solver/
├── app.py              # 项目主程序文件
├── requirements.txt    # 项目依赖文件
├── static/             # 静态文件目录，包含 CSS、JS 和图片等
├── templates/          # HTML 模板文件目录
├── config/             # 配置文件目录
│   └── api_keys.json   # API 密钥配置文件
├── models/             # 模型文件目录
├── .gitignore          # Git 忽略文件
└── README.md           # 项目说明文件

• app.py：项目的 Flask 主程序文件，负责处理 Web 请求。
• requirements.txt：项目运行所需的 Python 包列表。
• static/：存放静态资源，如 CSS 样式表、JavaScript 文件和图片等。
• templates/：存放 HTML 模板文件，用于生成 Web 界面。
• config/：配置文件目录，用于存放 API 密钥等配置信息。
• models/：存放与项目相关的数据模型代码。
• .gitignore：配置 Git 忽略规则，避免将敏感信息提交到仓库。
• README.md：项目说明文件，包含项目介绍、使用方法和配置说明。

2. 项目的启动文件介绍

项目的主启动文件为 app.py，以下是该文件的主要内容：

from flask import Flask, render_template, request
from flask_socketio import SocketIO

app = Flask(__name__)
app.config['SECRET_KEY'] = 'secret!'
socketio = SocketIO(app)

@app.route('/')
def index():
    return render_template('index.html')

# 其他路由和函数

if __name__ == '__main__':
    socketio.run(app, debug=True)

该文件使用 Flask 框架创建了一个 Web 应用，并使用 SocketIO 实现了实时通信功能。在 if __name__ == '__main__': 部分调用 socketio.run(app, debug=True) 来启动应用。

3. 项目的配置文件介绍

项目配置文件位于 config/api_keys.json，该文件用于存储项目所需的 API 密钥信息。以下是配置文件的一个示例：

{
    "OpenAI_API_Key": "your_openai_api_key",
    "Anthropic_API_Key": "your_anthropic_api_key",
    "DeepSeek_API_Key": "your_deepseek_api_key",
    "Alibaba_API_Key": "your_alibaba_api_key",
    "Google_API_Key": "your_google_api_key",
    "Mathpix_API_Key": "your_mathpix_api_key"
}

在实际部署时，您需要将 your_openai_api_key 等占位符替换为实际的 API 密钥。

请确保配置文件中的 API 密钥安全，避免泄露。在 app.py 或其他相关文件中，您可以通过 config.from_json('config/api_keys.json') 来加载这些配置信息。