aiagents-stock/docs/环境配置快速指南.md

环境配置快速指南

📋 配置步骤

1. 创建配置文件

如果您是首次使用，请复制模板文件：

# Windows PowerShell
Copy-Item .env.example .env

# Linux/Mac
cp .env.example .env

2. 配置必填项

✅ DeepSeek API配置（必填）

1. 访问 DeepSeek Platform
2. 注册/登录账号
3. 创建API密钥
4. 在.env文件中填写：

DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. 配置可选项

📧 邮件通知配置（推荐）

配置示例（163邮箱）：

EMAIL_ENABLED=true
SMTP_SERVER=smtp.163.com
SMTP_PORT=465
EMAIL_FROM=your_email@163.com
EMAIL_PASSWORD=your_authorization_code
EMAIL_TO=receiver@qq.com

获取邮箱授权码：

1. 163邮箱

   • 登录163邮箱网页版
   • 设置 → POP3/SMTP/IMAP
   • 开启"POP3/SMTP服务"
   • 点击"生成授权码"
   • 复制授权码（16位字符）

2. QQ邮箱

   • 登录QQ邮箱网页版
   • 设置 → 账户
   • 找到"POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务"
   • 开启"POP3/SMTP服务"
   • 点击"生成授权码"
   • 按提示完成验证

常用SMTP配置：

邮箱类型	SMTP服务器	SSL端口	TLS端口
163邮箱	smtp.163.com	465	587
QQ邮箱	smtp.qq.com	465	587
Gmail	smtp.gmail.com	465	587
126邮箱	smtp.126.com	465	587

📱 Webhook通知配置（可选）

钉钉机器人配置：

1. 在钉钉群中添加自定义机器人
2. 安全设置选择"自定义关键词"
3. 关键词必须设置为：aiagents通知
4. 复制Webhook地址
5. 在.env文件中填写：

WEBHOOK_ENABLED=true
WEBHOOK_TYPE=dingtalk
WEBHOOK_URL=https://oapi.dingtalk.com/robot/send?access_token=xxxxxx

飞书机器人配置：

1. 在飞书群中添加自定义机器人
2. 复制Webhook地址
3. 在.env文件中填写：

WEBHOOK_ENABLED=true
WEBHOOK_TYPE=feishu
WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxx

📊 Tushare数据接口（可选）

1. 访问 Tushare官网
2. 注册账号
3. 获取Token
4. 在.env文件中填写：

TUSHARE_TOKEN=your_tushare_token_here

💹 MiniQMT量化交易（可选）

如果您使用MiniQMT进行量化交易：

MINIQMT_ENABLED=true
MINIQMT_ACCOUNT_ID=your_account_id
MINIQMT_HOST=127.0.0.1
MINIQMT_PORT=58610

🧪 配置测试

配置完成后，运行测试工具验证配置：

# Windows
.\venv\Scripts\python.exe test_notification_config.py

# Linux/Mac
python test_notification_config.py

测试结果示例：

============================================================
通知配置测试工具
============================================================

[邮件] 测试邮件配置
  - 启用状态: [已启用]
  - SMTP服务器: smtp.163.com
  - 配置完整性: [完整]
[成功] 测试邮件发送成功！

[Webhook] 测试Webhook配置
  - 启用状态: [已启用]
  - Webhook类型: dingtalk
  - 配置完整性: [完整]
[成功] 钉钉Webhook测试成功！

============================================================
测试结果汇总
============================================================
邮件通知: [OK] 正常
Webhook通知: [OK] 正常

⚠️ 常见问题

Q1: 邮件发送失败 - 认证错误

问题：SMTPAuthenticationError

解决方案：

• 确认使用的是授权码，不是登录密码
• 检查邮箱是否开启了POP3/SMTP服务
• 163邮箱授权码需要在邮箱设置中生成

Q2: 钉钉消息发送失败 - 关键词不匹配

问题：关键词不匹配

解决方案：

• 确保钉钉机器人的自定义关键词设置为：aiagents通知
• 或者修改机器人安全设置为"加签"或"IP地址"

Q3: 网络连接失败

问题：getaddrinfo failed 或 Connection timeout

解决方案：

• 检查网络连接
• 检查防火墙设置
• 确认SMTP服务器地址正确
• 尝试使用不同的端口（465或587）

Q4: .env文件中文乱码

问题：编辑器显示中文乱码

解决方案：

• 使用UTF-8编码打开文件
• VS Code：右下角点击编码 → 选择"UTF-8"
• 记事本：另存为时选择"UTF-8"编码

📁 配置文件说明

.env.example    # 配置模板（提交到版本控制）
.env           # 实际配置（不提交到版本控制，包含敏感信息）

🔐 安全建议

1. 不要提交.env文件到版本控制系统

   • .env文件已在.gitignore中
   • 只提交.env.example模板

2. 定期更换密钥

   • 建议定期更换API密钥和授权码
   • 如发现泄露，立即更换

3. 权限控制

   • 限制.env文件的访问权限
   • 不要在公开场合分享配置信息

📚 相关文档

• 邮件配置指南.md - 详细的邮件配置说明
• Webhook通知配置指南.md - Webhook配置详解
• 通知功能修复说明.md - 问题排查指南

🆘 需要帮助？

如遇到问题：

1. 运行测试工具查看详细错误信息
2. 查看相关文档
3. 检查系统日志
4. 参考常见问题解答

---

更新时间: 2025-10-14
版本: v1.0