hahaju/aiagents-stock
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
main
aiagents-stock/docs/环境配置功能说明.md
T

5.5 KiB
Raw Permalink Blame History

环境配置功能说明

功能概述

新增了可视化的环境配置管理界面，用户可以通过UI界面配置系统的所有环境变量，无需手动编辑 .env 文件。

访问方式

在侧栏的"快捷导航"区域，点击 ⚙️ 环境配置 按钮即可进入配置界面。

配置项说明

1. 基本配置（必需）

DeepSeek API配置

  • API密钥 (必填)

    • 描述：DeepSeek AI引擎的API密钥
    • 获取方式：访问 https://platform.deepseek.com
    • 注意：这是系统核心功能，必须配置才能使用AI分析

  • API地址 (可选)

    • 描述：DeepSeek API服务器地址
    • 默认值：https://api.deepseek.com/v1
    • 注意：一般无需修改

2. 数据源配置（可选）

Tushare数据接口

  • Token (可选)
    • 描述：Tushare数据接口令牌
    • 获取方式：访问 https://tushare.pro
    • 作用：提供更丰富的A股财务数据
    • 注意：未配置时系统使用其他数据源

3. 量化交易配置（可选）

MiniQMT量化交易

  • 启用开关

    • 描述：是否启用MiniQMT量化交易功能
    • 默认：关闭

  • 账户ID

    • 描述：MiniQMT交易账户ID
    • 注意：仅在启用时需要配置

  • 服务器地址

    • 描述：MiniQMT服务器地址
    • 默认：127.0.0.1

  • 服务器端口

    • 描述：MiniQMT服务器端口
    • 默认：58610

  • ⚠️ 警告：量化交易涉及真实资金操作，请谨慎配置和使用！

4. 通知配置（可选）⭐新增

📧 邮件通知

  • 启用开关

    • 描述：是否启用邮件通知功能
    • 默认：关闭
    • 适用：实时监测和智策定时分析

  • SMTP服务器地址

    • 描述：邮件服务器地址
    • 示例：smtp.qq.com、smtp.163.com

  • SMTP端口

    • 描述：邮件服务器端口
    • 默认：587 (TLS) 或 465 (SSL)

  • 发件人邮箱

    • 描述：发送通知的邮箱地址
    • 示例：your-email@qq.com

  • 邮箱授权码

    • 描述：SMTP服务授权码（不是登录密码）
    • 获取：邮箱设置 → SMTP服务 → 生成授权码

  • 收件人邮箱

    • 描述：接收通知的邮箱地址
    • 示例：recipient@qq.com

📱 Webhook通知

  • 启用开关

    • 描述：是否启用Webhook通知功能
    • 默认：关闭
    • 适用：实时监测和智策定时分析

  • Webhook类型

    • 描述：选择Webhook平台
    • 选项：钉钉 (dingtalk) 或 飞书 (feishu)

  • Webhook地址

    • 描述：机器人Webhook URL
    • 钉钉示例：https://oapi.dingtalk.com/robot/send?access_token=xxxxx
    • 飞书示例：https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx
    • 获取：群设置 → 群机器人 → 添加自定义机器人

💡 提示：

  • 邮件和Webhook可以同时启用
  • 配置后建议使用测试功能验证
  • 详见《Webhook通知配置指南.md》

使用流程

  1. 进入配置页面

    • 点击侧栏的"⚙️ 环境配置"按钮

  2. 修改配置

    • 在相应标签页中填写或修改配置项
    • 必填项会有 * 标记
    • 密码类型的配置会以 **** 显示

  3. 保存配置

    • 点击"💾 保存配置"按钮
    • 系统会验证配置的有效性
    • 验证通过后保存到 .env 文件

  4. 生效配置

    • 配置保存后会自动尝试重新加载
    • 建议重启应用以确保所有配置生效

功能特性

✅ 可视化配置

  • 友好的UI界面
  • 分类标签页组织
  • 字段说明和帮助信息

✅ 安全性

  • 密码字段自动隐藏
  • API密钥部分隐藏显示
  • 配置验证功能

✅ 便捷操作

  • 实时配置预览
  • 一键保存
  • 一键重置
  • 查看当前配置文件

✅ 智能提示

  • 配置状态实时显示
  • 获取API密钥的详细步骤
  • 字段帮助信息

配置文件位置

配置保存在项目根目录的 .env 文件中：

D:\web\agentsstock1\.env

配置示例

# AI股票分析系统环境配置
# 由系统自动生成和管理

# ========== DeepSeek API配置 ==========
DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
DEEPSEEK_BASE_URL="https://api.deepseek.com/v1"

# ========== Tushare数据接口（可选）==========
TUSHARE_TOKEN=""

# ========== MiniQMT量化交易配置（可选）==========
MINIQMT_ENABLED="false"
MINIQMT_ACCOUNT_ID=""
MINIQMT_HOST="127.0.0.1"
MINIQMT_PORT="58610"

注意事项

  1. API密钥安全

    • 不要将 .env 文件提交到Git仓库
    • 不要分享你的API密钥给他人
    • 定期更换API密钥

  2. 配置生效

    • 修改配置后建议重启应用
    • 某些配置可能需要重新加载才能生效

  3. 必填项

    • DeepSeek API密钥是必填项
    • 其他配置项都是可选的

  4. 量化交易

    • 量化交易功能涉及真实资金
    • 使用前请充分测试
    • 谨慎配置交易参数

故障排查

问题1：保存配置失败

解决方案：

  • 检查文件权限
  • 确保项目目录可写
  • 检查配置格式是否正确

问题2：配置不生效

解决方案：

  • 重启应用
  • 检查 .env 文件是否存在
  • 查看控制台错误信息

问题3：API密钥验证失败

解决方案：

  • 确认API密钥正确
  • 检查API密钥是否过期
  • 确认网络连接正常

技术实现

核心文件

  1. config_manager.py

    • 配置管理器
    • 读取/保存 .env 文件
    • 配置验证

  2. app.py

    • 配置界面
    • 用户交互
    • 状态管理

  3. config.py

    • 加载环境变量
    • 提供配置访问接口

更新日期

2025年10月6日

作者

AI股票分析系统开发团队

Reference in New Issue View Git Blame Copy Permalink