hahaju/aiagents-stock
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

仿alphaarena项目增加A股ai自动量化

Browse Source
This commit is contained in:
oficcejo
2025-10-26 10:02:55 +08:00
parent b9f0368d25
commit 16071f81e8
21 changed files with 6218 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/Tushare积分获取指南.md
+350
View File
@@ -0,0 +1,350 @@
# Tushare积分获取指南
## 📋 问题说明
在使用智能盯盘的数据源降级功能时，您可能会看到以下提示：
```
Tushare获取失败: 抱歉，您没有接口访问权限
⚠️ Tushare资金流向接口需要120积分，当前积分不足
```
这是因为Tushare的某些接口需要**积分权限**才能访问。
---
## 🎯 Tushare积分体系
### 接口积分要求
| 接口类型 | 所需积分 | 说明 |
|---------|---------|------|
| **股票列表** | 0 | 免费 |
| **日线行情** | 0-120 | 基础行情免费，高级字段需积分 |
| **分钟线** | 2000 | 需要较高积分 |
| **资金流向** | 120 | ⭐ 智能盯盘使用 |
| **财务数据** | 不同 | 根据字段不同 |
智能盯盘主要使用：
- ✅ **日线行情**（0积分）- 作为降级方案
- ⚠️ **资金流向**（120积分）- 可选，没有也能运行
---
## 💡 快速获取120积分
### 方法一：完善个人信息（+100积分）⭐ 推荐
1. **登录Tushare**
- 访问：https://tushare.pro/
- 登录您的账号
2. **进入个人中心**
- 点击右上角用户名
- 选择"个人中心"
3. **完善资料**
- 填写真实姓名
- 填写手机号并验证
- 填写邮箱并验证
- 完善职业信息
- **一次性获得100积分**
### 方法二：每日签到（每天+1积分）
1. **登录后签到**
- 每天访问 https://tushare.pro/
- 点击"每日签到"按钮
- 获得1积分
2. **累积积分**
- 连续签到30天 = 30积分
- 配合方法一，总计130积分（够用！）
### 方法三：社区互动
1. **发表文章**
- 分享使用经验
- 数据分析案例
- 获得5-20积分/篇
2. **回答问题**
- 在社区帮助其他用户
- 获得1-5积分/次
3. **推荐新用户**
- 邀请好友注册
- 获得积分奖励
---
## 🚀 推荐方案（最快）
### 5分钟获取120积分
**第1步：完善个人信息（3分钟）**
```
1. 填写姓名
2. 验证手机号
3. 验证邮箱
4. 填写职业
→ 立即获得100积分
```
**第2步：连续签到20天**
```
每天登录签到 × 20天 = 20积分
100 + 20 = 120积分（满足要求！）
```
**或者：发表1篇文章（10分钟）**
```
1. 写一篇使用心得
2. 分享到社区
3. 获得10-20积分
→ 100 + 20 = 120积分（完成！）
```
---
## 🔍 查看当前积分
1. **登录Tushare**
- 访问：https://tushare.pro/user/token
2. **查看积分余额**
```
页面会显示：
- 当前积分
- 可用接口
- 积分明细
```
3. **检查接口权限**
- 查看"资金流向"是否可用
- 如果显示"不可用"，说明积分不足
---
## ⚙️ 智能盯盘的降级策略
### 当前实现的多层降级
```
Level 1: AKShare（主数据源）
↓ 失败
Level 2: Tushare基础接口（免费，0积分）
├─ daily_basic（基础日线）
├─ pro_bar（社区版）
└─ stock_basic（股票列表）
↓ 成功 → 返回行情数据（无资金流向）
↓ 失败
Level 3: Tushare高级接口（需120积分）
└─ moneyflow（资金流向）
↓ 成功 → 返回完整数据
↓ 失败 → 返回部分数据（无资金流向）
```
### 没有120积分的影响
| 功能 | 是否受影响 | 说明 |
|-----|----------|------|
| AI决策 | ✅ 正常 | 使用行情数据即可 |
| 实时行情 | ✅ 正常 | 使用免费接口 |
| 技术指标 | ✅ 正常 | 本地计算 |
| 主力资金 | ⚠️ 受限 | 缺少资金流向数据 |
| 自动交易 | ✅ 正常 | 不依赖资金流向 |
| 通知发送 | ✅ 正常 | 独立功能 |
**结论：没有120积分也能正常使用，只是缺少主力资金流向数据！**
---
## 📊 实际测试结果
### 场景一：0积分（仅Token）
```bash
# 日志输出
✅ Tushare备用数据源初始化成功
AKShare获取失败，尝试降级到Tushare
✅ Tushare降级成功（pro_bar接口），获取到数据
⚠️ Tushare资金流向接口需要120积分，当前积分不足
# 结果
- 行情数据：✅ 成功获取
- 技术指标：✅ 正常计算
- 主力资金：❌ 无数据
- AI决策：✅ 正常运行
```
### 场景二：120+积分
```bash
# 日志输出
✅ Tushare备用数据源初始化成功
AKShare获取失败，尝试降级到Tushare
✅ Tushare降级成功（基础接口），获取到数据
✅ Tushare降级成功，获取到资金流向
# 结果
- 行情数据：✅ 成功获取
- 技术指标：✅ 正常计算
- 主力资金：✅ 完整数据
- AI决策：✅ 更准确
```
---
## 🎓 Tushare积分详细规则
### 积分获取途径
| 方式 | 获得积分 | 频率 | 难度 |
|-----|---------|------|------|
| 完善个人信息 | +100 | 一次性 | ⭐ 简单 |
| 每日签到 | +1 | 每天 | ⭐ 简单 |
| 发表文章 | +5~20 | 不限 | ⭐⭐ 中等 |
| 回答问题 | +1~5 | 不限 | ⭐⭐ 中等 |
| 推荐新用户 | +10 | 不限 | ⭐⭐⭐ 较难 |
| 捐赠支持 | 不同 | 不限 | ⭐⭐⭐ 较难 |
### 积分使用规则
- ✅ 积分不会过期
- ✅ 一次获取永久有效
- ✅ 调用接口不扣积分
- ⚠️ 仅用于开通接口权限
### 积分查询方式
**方法一：网页查询**
```
https://tushare.pro/user/token
```
**方法二：API查询**
```python
import tushare as ts
ts.set_token('your_token')
pro = ts.pro_api()
# 查询积分（需要token）
print("当前积分:", pro.query('user', fields='id,nick,credits'))
```
---
## ❓ 常见问题
### Q1: 我填写了信息但没有得到100积分？
**A:** 需要完成以下所有项：
- ✅ 真实姓名
- ✅ 手机号验证
- ✅ 邮箱验证
- ✅ 职业信息
- ✅ 点击"提交"保存
### Q2: 签到在哪里？
**A:**
1. 登录 https://tushare.pro/
2. 右上角会显示"每日签到"按钮
3. 点击即可获得1积分
### Q3: 积分够了为什么还是提示权限不足？
**A:**
1. 退出重新登录Tushare官网
2. 检查积分是否真的到账
3. 等待5-10分钟，系统可能有延迟
4. 重新获取Token并更新.env配置
### Q4: 不想获取积分，有其他办法吗？
**A:**
- ✅ 继续使用AKShare主数据源（大多数时候能用）
- ✅ 不配置Tushare Token（智能盯盘仍可正常运行）
- ⚠️ 但稳定性会降低（~70% vs ~95%）
### Q5: 积分会扣除吗？
**A:**
- ❌ 不会！调用接口不扣积分
- ✅ 积分仅用于开通接口权限
- ✅ 一次获取，永久有效
---
## 🔧 配置建议
### 推荐配置（最佳体验）
```env
# .env配置
TUSHARE_TOKEN="your_token_here" # 已获取120+积分
```
**优点：**
- ✅ 数据获取成功率95%+
- ✅ 包含主力资金流向
- ✅ AI决策更准确
### 最小配置（基础功能）
```env
# .env配置
TUSHARE_TOKEN="your_token_here" # 0积分也可以
```
**优点：**
- ✅ 仍有降级保护
- ✅ 基础行情可获取
- ⚠️ 缺少资金流向
### 不配置（仅AKShare）
```env
# 不设置Tushare
```
**优点：**
- ✅ 无需注册Tushare
- ⚠️ 稳定性较低（~70%）
---
## 📚 相关链接
- **Tushare官网**: https://tushare.pro/
- **积分规则**: https://tushare.pro/document/1?doc_id=13
- **接口权限**: https://tushare.pro/document/1?doc_id=108
- **个人中心**: https://tushare.pro/user/token
- **积分获取**: https://tushare.pro/document/1?doc_id=13
---
## 💡 总结
### 建议操作步骤
**Step 1**: 完善Tushare个人信息（获得100积分）
**Step 2**: 连续签到20-30天（获得20-30积分）
**Step 3**: 总计120+积分，解锁所有功能
**Step 4**: 享受95%+的数据获取成功率！
### 如果不想获取积分
- ✅ 也可以正常使用智能盯盘
- ✅ AI决策、自动交易都不受影响
- ⚠️ 只是缺少主力资金流向数据
- ⚠️ 网络问题时降级效果打折扣
**我们仍然推荐获取120积分，提升系统稳定性！**
---
**更新时间**: 2025-10-25
**版本**: v1.0
docs/智能盯盘使用指南.md
+219
View File
@@ -0,0 +1,219 @@
# 🤖 智能盯盘使用指南
## 📖 项目简介
**智能盯盘**是基于 DeepSeek AI 的A股自动化交易决策系统，支持：
- ✅ **DeepSeek AI决策** - 利用DeepSeek-V3强大的推理能力进行股票分析
- ✅ **A股T+1适配** - 完全遵循A股交易规则
- ✅ **miniQMT集成** - 支持实盘自动交易
- ✅ **实时监控** - 24/7持续监控股票并自动决策
- ✅ **邮件/Webhook通知** - 及时接收交易信号
## 🚀 快速开始
### 1. 环境配置
在项目根目录的 `.env` 文件中添加以下配置：
```bash
# DeepSeek API配置
DEEPSEEK_API_KEY=your_deepseek_api_key_here
# miniQMT配置
QMT_ACCOUNT_ID=your_qmt_account_id
USE_SIMULATOR=true # true=模拟交易, false=实盘交易
# 通知配置（可选）
NOTIFY_EMAIL=your_email@example.com
NOTIFY_WEBHOOK=https://your.webhook.url
```
### 2. 安装依赖
智能盯盘需要以下额外依赖：
```bash
pip install akshare # A股数据获取
pip install xtquant # miniQMT交易接口（可选，如使用实盘交易）
```
### 3. 启动程序
```bash
streamlit run app.py
```
进入主界面后，点击左侧菜单 **"策略分析"** → **"智能盯盘"**
## 💡 功能说明
### 📊 实时分析
输入股票代码（如：600519），点击"开始分析"，AI会：
1. **获取实时行情数据**
- 当前价格、涨跌幅
- 成交量、换手率
- 技术指标（MA、MACD、RSI、KDJ、布林带等）
- 主力资金流向（如有数据）
2. **AI决策分析**
- 综合技术面、资金面判断
- 给出 **买入(BUY)** / **卖出(SELL)** / **持有(HOLD)** 建议
- 提供详细的决策理由（200-300字）
- 建议仓位、止损位、止盈位
3. **自动执行（可选）**
- 勾选"自动交易"，AI决策后自动下单
- 支持T+1规则检查（今天买入的股票明天才能卖）
### 🎯 监控任务
添加监控任务后，系统会定期（如每5分钟）自动分析目标股票：
**添加任务步骤：**
1. 点击"添加新监控任务"
2. 填写任务名称、股票代码
3. 设置检查间隔（建议300秒）
4. 选择是否自动交易
5. 点击"添加任务"
**任务管理：**
- ▶️ **启动/停止** - 控制任务运行
- 🗑️ **删除** - 移除监控任务
- 查看运行状态
### 📈 持仓管理
查看当前持仓：
- 持仓列表：代码、名称、数量、成本价、现价、盈亏
- 快速操作：AI分析、卖出（需符合T+1规则）
- 账户概览：总资产、可用资金、总盈亏
### 📜 历史记录
- **AI决策历史** - 查看所有AI分析记录
- **交易记录** - 查看买入/卖出记录及盈亏
- **通知记录** - 查看发送的通知
## ⚙️ 系统设置
### DeepSeek API配置
1. 访问 [DeepSeek官网](https://www.deepseek.com) 注册账号
2. 获取API Key
3. 在系统设置中填写API Key
### miniQMT配置
**使用模拟交易（推荐新手）：**
- 勾选"使用模拟交易"
- 无需真实QMT账户
- 所有交易仅记录，不实际执行
**使用实盘交易（需要miniQMT）：**
1. 下载并安装 [miniQMT](https://www.xtp-mini.com/)
2. 启动miniQMT客户端
3. 获取账户ID
4. 在系统设置中填写账户ID
5. 取消勾选"使用模拟交易"
### 通知配置
**邮件通知：**
- 填写接收通知的邮箱地址
- 需在 `config.py` 中配置SMTP服务器
**Webhook通知：**
- 支持钉钉、企业微信、飞书等
- 填写Webhook URL
- 可自定义关键词触发
## 📚 AI决策逻辑说明
### 交易时段判断
系统会根据北京时间自动判断交易时段：
- **集合竞价** (9:00-9:30) - 不可交易，可观察
- **上午盘** (9:30-11:30) - 波动大，交易活跃
- **午间休市** (11:30-13:00) - 不可交易
- **下午盘** (13:00-14:30) - 波动趋缓
- **尾盘** (14:30-15:00) - 波动大，谨慎操作
- **盘后/周末** - 不可交易
### 买入信号（必须满足至少3个）
1. ✅ 趋势向上：价格 > MA5 > MA20 > MA60
2. ✅ 量价配合：成交量 > 5日均量的120%
3. ✅ MACD金叉：MACD > 0 且DIF上穿DEA
4. ✅ RSI健康：RSI在50-70区间
5. ✅ 突破关键位：突破前期高点或重要阻力位
6. ✅ 主力资金：净流入为正
### 卖出信号（满足任一立即卖出）
1. 🔴 止损触发：亏损 ≥ -5%
2. 🟢 止盈触发：盈利 ≥ +10%
3. 🔴 趋势转弱：跌破MA20/MA60，MACD死叉
4. 🔴 放量下跌：成交量放大但价格下跌
5. 🔴 技术破位：跌破重要支撑位
### T+1规则说明
⚠️ **关键限制**：
- 今天买入的股票，**今天不能卖出**
- 必须等到下一个交易日才能卖出
- 系统会自动检查并提示T+1限制
## ⚠️ 风险提示
1. **股市有风险，投资需谨慎**
2. AI决策仅供参考，不构成投资建议
3. 建议先使用模拟交易测试
4. 严格设置止损，控制单笔仓位（建议≤30%）
5. 不要投入超过承受能力的资金
## 🔧 故障排除
### Q: 提示"DeepSeek API调用失败"
**A:**
- 检查API Key是否正确
- 检查网络连接
- 确认API账户余额充足
### Q: 提示"获取行情数据失败"
**A:**
- 检查网络连接
- akshare数据源可能暂时不可用
- 尝试更换股票代码测试
### Q: 提示"miniQMT未连接"
**A:**
- 如使用模拟交易，勾选"使用模拟交易"
- 如使用实盘，确保miniQMT客户端已启动
- 检查账户ID是否正确
### Q: 买入/卖出失败
**A:**
- 检查是否在交易时间（9:30-15:00）
- 检查资金是否充足
- 卖出时检查是否有可卖数量（T+1限制）
- 买入数量必须是100的整数倍
## 📞 技术支持
遇到问题或建议？
- 📧 邮箱：support@example.com
- 💬 Issue：在GitHub上提交Issue
- 📖 文档：查看 `docs/` 目录下的其他文档
---
**祝您交易顺利！🚀**
docs/智能盯盘持仓管理功能说明.md
+432
View File
@@ -0,0 +1,432 @@
# 智能盯盘 - 持仓管理功能说明
## 🎯 功能概述
智能盯盘现已支持**持仓管理功能**，您可以在添加监控任务时：
- ✅ 标记是否已持仓该股票
- ✅ 填入持仓成本和数量
- ✅ 实时查看持仓盈亏
- ✅ AI决策时考虑持仓情况
这对于已经持有股票并希望智能监控的用户非常实用！
---
## 🆕 新增功能
### 1. 添加任务时设置持仓信息
在"添加新监控任务"表单中，新增了持仓信息输入：
**📊 持仓信息区域：**
- **已持仓该股票** - 勾选表示您已持有该股票
- **持仓成本(元)** - 填入买入时的成本价格
- **持仓数量(股)** - 填入当前持有的股票数量
**示例：**
```
任务名称: 茅台盯盘
股票代码: 600519
检查间隔: 300秒
📊 持仓信息:
☑ 已持仓该股票
持仓成本: 1650.50元
持仓数量: 200股
```
### 2. 任务列表显示盈亏
任务列表现在会实时显示持仓盈亏：
**显示内容：**
- 📊 持仓信息（数量和成本）
- 💰 实时盈亏金额和百分比
- 颜色标识：
- 🟢 绿色 - 盈利
- 🔴 红色 - 亏损
- ⚪ 灰色 - 持平
**示例显示：**
```
任务名称: 茅台盯盘
600519 - 间隔300秒
✅ 已启用
🤖 自动交易
📊 持仓: 200股 @ 1650.50元
▶️ 运行中
💰 +5,240.00元 (+15.86%)
```
### 3. AI决策考虑持仓情况
当您设置了持仓信息后，AI决策会：
**针对已持仓股票：**
- ✅ 显示当前盈亏状态
- ✅ 建议止盈/止损时机
- ✅ 评估是否加仓机会
- ✅ 考虑持仓天数（T+1规则）
**AI决策示例：**
```
[POSITION] 当前持仓（600519） ⭐ 重要
═══════════════════════════════════════
持仓数量: 200股
成本价: ¥1650.50
当前价: ¥1676.70
持仓市值: ¥335,340.00
浮动盈亏: ¥5,240.00 (+1.59%)
⚠️ T+1限制: 该股票可以卖出（不受T+1限制）
💡 决策建议：
- 如果盈利且技术指标转弱 → 建议止盈卖出
- 如果亏损超过止损线（通常-5%）→ 建议止损卖出
- 如果技术指标强势且未到止盈位 → 建议继续持有
- 如果盈利且看好后市 → 可考虑加仓（但注意仓位控制）
```
---
## 📊 使用场景
### 场景1: 已持仓股票监控
**适用情况：**
- 您已经买入某只股票
- 希望AI帮您监控卖出时机
- 需要实时了解盈亏情况
**操作步骤：**
1. 点击"添加新监控任务"
2. 填写股票代码
3. ☑ 勾选"已持仓该股票"
4. 填入持仓成本和数量
5. 可开启"自动交易"（AI建议卖出时自动执行）
6. 点击"添加任务"
**结果：**
- ✅ 任务列表实时显示盈亏
- ✅ AI决策会考虑您的持仓成本
- ✅ 触发卖出信号时及时通知
- ✅ 自动交易可自动止盈/止损
### 场景2: 未持仓股票监控
**适用情况：**
- 您还没买入该股票
- 希望AI帮您监控买入时机
**操作步骤：**
1. 点击"添加新监控任务"
2. 填写股票代码
3. ❌ 不勾选"已持仓该股票"
4. 设置仓位百分比（新建仓位时使用）
5. 可开启"自动交易"
6. 点击"添加任务"
**结果：**
- ✅ AI决策会寻找买入机会
- ✅ 触发买入信号时及时通知
- ✅ 自动交易可自动建仓
### 场景3: 分批建仓/加仓
**适用情况：**
- 已有一部分持仓
- 希望在合适时机加仓
**操作步骤：**
1. 设置已持仓信息（当前持仓）
2. 保持"仓位百分比"设置（加仓时使用）
3. 开启自动交易
4. AI会评估：
- 如果技术强势 → 建议加仓
- 如果技术转弱 → 建议减仓
---
## 🔍 功能详解
### 持仓成本的作用
**在AI决策中：**
1. **计算盈亏** - 当前价 vs 成本价
2. **止损判断** - 是否达到止损线（如-5%）
3. **止盈判断** - 是否达到止盈线（如+10%）
4. **加仓评估** - 是否适合补仓或加仓
**示例分析：**
```
持仓成本: ¥50.00
当前价格: ¥47.50
盈亏: -5.00% (达到止损线)
AI决策: SELL (止损卖出)
理由: 亏损已达到-5%止损线，技术指标转弱，
建议止损以避免更大亏损
```
### 持仓数量的作用
**在AI决策中：**
1. **仓位计算** - 当前持仓占比
2. **风险评估** - 是否过度集中
3. **加仓空间** - 还能加多少仓位
**示例分析：**
```
账户总资产: ¥100,000
持仓市值: ¥30,000 (30%)
仓位状态: 适中
AI决策: 可以考虑小幅加仓
理由: 仓位未超过30%警戒线，技术面强势，
可适当增加仓位
```
---
## 💡 最佳实践
### 1. 准确填写持仓信息
**重要提示：**
- ✅ 填写真实的成本价（不是当前价）
- ✅ 填写实际持有数量
- ❌ 不要虚高或虚低填写
**为什么：**
- 准确的持仓信息 → 准确的盈亏计算
- 准确的盈亏 → 更合理的AI决策
- 合理的决策 → 更好的交易结果
### 2. 及时更新持仓
**需要更新的情况：**
- ✅ 手动买入/卖出后
- ✅ 自动交易执行后
- ✅ 分批建仓/减仓后
**如何更新：**
1. 删除旧任务
2. 添加新任务（填写新的持仓信息）
3. 或手动编辑数据库（高级用户）
### 3. 合理设置自动交易
**建议：**
- 🟢 **已持仓** + 自动交易 = 自动止盈/止损
- 🟡 **未持仓** + 自动交易 = 谨慎使用
- 🔴 新手建议先不开启自动交易
**原因：**
- 已持仓：主要是卖出决策，相对安全
- 未持仓：涉及买入决策，需要更谨慎
- 新手：先观察AI决策准确性
### 4. 设置合理止损止盈
**默认建议：**
- 止损线：-5%（可根据风险承受能力调整）
- 止盈线：+10%（可根据预期收益调整）
**调整建议：**
- 高风险股票：止损-3%，止盈+8%
- 稳健股票：止损-7%，止盈+15%
- 根据实际情况灵活调整
---
## 📈 实际案例
### 案例1: 止盈卖出
**背景：**
```
股票: 600519 贵州茅台
持仓成本: ¥1,650.00
持仓数量: 100股
当前价格: ¥1,815.00
浮动盈亏: +10.00% (+¥16,500)
```
**AI决策：**
```
决策: SELL (止盈卖出)
信心度: 85%
理由:
- 盈利已达10%止盈线
- MACD出现死叉信号
- RSI(6)=78 进入超买区
- 成交量明显萎缩
建议: 止盈卖出，落袋为安
```
### 案例2: 止损卖出
**背景：**
```
股票: 000001 平安银行
持仓成本: ¥12.50
持仓数量: 1000股
当前价格: ¥11.88
浮动盈亏: -4.96% (-¥620)
```
**AI决策：**
```
决策: SELL (止损卖出)
信心度: 90%
理由:
- 亏损接近-5%止损线
- 技术面全面转弱
- MA5下穿MA20死叉
- 主力资金持续流出
建议: 及时止损，避免更大亏损
```
### 案例3: 持有观望
**背景：**
```
股票: 300750 宁德时代
持仓成本: ¥180.00
持仓数量: 200股
当前价格: ¥183.50
浮动盈亏: +1.94% (+¥700)
```
**AI决策：**
```
决策: HOLD (继续持有)
信心度: 75%
理由:
- 盈利未达止盈线
- 技术面保持强势
- MACD金叉持续
- 主力资金持续流入
- 量价配合良好
建议: 继续持有，等待更大收益
```
---
## ⚙️ 技术实现
### 数据库结构
新增字段到 `monitor_tasks` 表：
```sql
has_position INTEGER DEFAULT 0 -- 是否已持仓
position_cost REAL DEFAULT 0 -- 持仓成本
position_quantity INTEGER DEFAULT 0 -- 持仓数量
position_date TEXT -- 建仓日期
```
### AI决策逻辑
```python
def analyze_stock_and_decide(
stock_code: str,
market_data: Dict,
account_info: Dict,
has_position: bool = False,
position_cost: float = 0,
position_quantity: int = 0
) -> Dict:
# 计算实时盈亏
current_price = market_data['current_price']
profit_loss = (current_price - position_cost) * position_quantity
profit_loss_pct = (profit_loss / (position_cost * position_quantity)) * 100
# 构建包含持仓信息的Prompt
prompt = build_prompt_with_position(
stock_code, market_data, account_info,
has_position, position_cost, position_quantity,
profit_loss, profit_loss_pct
)
# 调用DeepSeek AI
decision = call_deepseek_api(prompt)
return decision
```
---
## 🔧 故障排查
### 问题1: 盈亏显示不准确
**可能原因：**
- 持仓成本填写错误
- 持仓数量填写错误
- 获取实时价格失败
**解决方案：**
1. 检查持仓信息是否正确
2. 重新创建监控任务
3. 查看日志确认数据获取情况
### 问题2: AI决策未考虑持仓
**可能原因：**
- 持仓信息未勾选
- 持仓数量为0
- 持仓成本为0
**解决方案：**
1. 确认勾选"已持仓该股票"
2. 确认填写了正确的成本和数量
3. 查看日志确认参数传递
### 问题3: 任务列表不显示盈亏
**可能原因：**
- 数据获取失败
- 网络问题
- 数据源不可用
**解决方案：**
1. 刷新页面重试
2. 检查网络连接
3. 查看终端日志
---
## 📚 相关文档
- [智能盯盘快速测试](./智能盯盘快速测试.md)
- [智能盯盘配置说明](./智能盯盘配置说明.md)
- [智能盯盘数据源降级说明](./智能盯盘数据源降级说明.md)
- [智能盯盘集成说明](./智能盯盘集成说明.md)
---
## ✅ 总结
持仓管理功能的优势：
1. **✅ 精准决策** - AI考虑您的实际持仓情况
2. **✅ 实时盈亏** - 一目了然的盈亏显示
3. **✅ 止盈止损** - 自动触发止盈止损信号
4. **✅ 风险控制** - 基于持仓的仓位管理
5. **✅ 便捷管理** - 集中管理所有持仓监控
**开始使用：** 立即添加您的持仓股票，让AI为您智能盯盘！
---
**更新时间：** 2025-10-25
**版本：** v1.0
docs/智能盯盘配置说明.md
+263
View File
@@ -0,0 +1,263 @@
# 智能盯盘 - 配置说明
## 📋 配置概览
智能盯盘使用主程序的**统一配置管理系统**，与其他功能模块共享配置。所有配置项通过主程序的 **"环境配置"** 页面进行管理。
---
## 🔧 配置项说明
### 1. 🤖 DeepSeek AI配置（必需）
智能盯盘的AI决策引擎，用于分析市场数据并做出交易决策。
| 配置项 | 环境变量 | 说明 | 是否必需 |
|--------|---------|------|---------|
| DeepSeek API Key | `DEEPSEEK_API_KEY` | DeepSeek API密钥 | ✅ 是 |
| DeepSeek API地址 | `DEEPSEEK_BASE_URL` | API服务地址（默认官方） | ❌ 否 |
**获取方式：**
1. 访问 [DeepSeek官网](https://platform.deepseek.com/)
2. 注册账号并创建API密钥
3. 在主程序"环境配置"中填入
---
### 2. 🔌 MiniQMT配置（可选）
用于实盘交易，如不配置则使用模拟交易。
| 配置项 | 环境变量 | 说明 | 默认值 |
|--------|---------|------|--------|
| 启用MiniQMT | `MINIQMT_ENABLED` | 是否启用实盘交易 | `false` |
| MiniQMT账户ID | `MINIQMT_ACCOUNT_ID` | QMT交易账户ID | 无 |
| MiniQMT服务器 | `MINIQMT_HOST` | QMT服务地址 | `127.0.0.1` |
| MiniQMT端口 | `MINIQMT_PORT` | QMT服务端口 | `58610` |
**说明：**
- `MINIQMT_ENABLED=false`: 使用模拟交易（安全，推荐新手）
- `MINIQMT_ENABLED=true`: 使用实盘交易（需要miniQMT环境）
**实盘交易要求：**
1. 已安装并运行miniQMT客户端
2. 已配置交易账户
3. 账户有足够资金和权限
4. 详见：`docs/MINIQMT_INTEGRATION_GUIDE.md`
---
### 3. 📧 邮件通知配置（可选）
用于接收交易决策和执行结果的邮件通知。
| 配置项 | 环境变量 | 说明 | 示例 |
|--------|---------|------|------|
| 启用邮件通知 | `EMAIL_ENABLED` | 是否启用邮件 | `true` |
| SMTP服务器 | `SMTP_SERVER` | 邮件服务器地址 | `smtp.qq.com` |
| SMTP端口 | `SMTP_PORT` | 邮件服务器端口 | `587` |
| 发件人邮箱 | `EMAIL_FROM` | 发送邮件的邮箱 | `your@qq.com` |
| 邮箱授权码 | `EMAIL_PASSWORD` | SMTP授权码 | `xxx` |
| 收件人邮箱 | `EMAIL_TO` | 接收通知的邮箱 | `notify@qq.com` |
**配置参考：**
- 详见：`docs/邮件配置指南.md`
---
### 4. 🔔 Webhook通知配置（可选）
支持钉钉、飞书机器人推送交易通知。
| 配置项 | 环境变量 | 说明 | 示例 |
|--------|---------|------|------|
| 启用Webhook | `WEBHOOK_ENABLED` | 是否启用Webhook | `true` |
| Webhook类型 | `WEBHOOK_TYPE` | `dingtalk`或`feishu` | `dingtalk` |
| Webhook地址 | `WEBHOOK_URL` | 机器人Webhook URL | `https://...` |
| 自定义关键词 | `WEBHOOK_KEYWORD` | 钉钉安全验证关键词 | `aiagents通知` |
**配置参考：**
- 钉钉：`docs/Webhook钉钉关键词快速配置指南.md`
- 飞书：`docs/Webhook通知配置指南.md`
---
## 🚀 配置步骤
### 步骤1: 打开环境配置
在主程序左侧菜单中，点击 **"环境配置"** 按钮。
### 步骤2: 填写必需配置
至少需要配置：
- ✅ **DeepSeek API Key** （必需）
- 其他配置项可选
### 步骤3: 保存配置
点击 **"保存配置"** 按钮，配置将保存到 `.env` 文件。
### 步骤4: 验证配置
1. 返回 **"智能盯盘"** 页面
2. 点击 **"系统设置"** 标签
3. 查看配置状态是否正常
### 步骤5: 刷新页面
如果修改了配置：
- 点击 **"重新加载配置"** 按钮
- 或按 `Ctrl+R` 刷新浏览器
---
## 📊 配置示例
### 最小配置（仅AI决策 + 模拟交易）
```env
# DeepSeek AI（必需）
DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxx"
# 其他默认值
MINIQMT_ENABLED="false" # 使用模拟交易
EMAIL_ENABLED="false" # 不发送邮件
WEBHOOK_ENABLED="false" # 不发送Webhook
```
### 完整配置（实盘 + 通知）
```env
# DeepSeek AI
DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxx"
DEEPSEEK_BASE_URL="https://api.deepseek.com/v1"
# MiniQMT实盘交易
MINIQMT_ENABLED="true"
MINIQMT_ACCOUNT_ID="888888888"
MINIQMT_HOST="127.0.0.1"
MINIQMT_PORT="58610"
# 邮件通知
EMAIL_ENABLED="true"
SMTP_SERVER="smtp.qq.com"
SMTP_PORT="587"
EMAIL_FROM="yourmail@qq.com"
EMAIL_PASSWORD="smtp_auth_code"
EMAIL_TO="notify@qq.com"
# 钉钉通知
WEBHOOK_ENABLED="true"
WEBHOOK_TYPE="dingtalk"
WEBHOOK_URL="https://oapi.dingtalk.com/robot/send?access_token=xxx"
WEBHOOK_KEYWORD="aiagents通知"
```
---
## ⚠️ 注意事项
### 1. 配置安全
- ❌ 不要将 `.env` 文件提交到版本控制
- ✅ API Key和密码要妥善保管
- ✅ 定期更换重要凭证
### 2. 实盘交易风险
- ⚠️ 首次使用建议用模拟模式测试
- ⚠️ 实盘交易有资金风险，谨慎操作
- ⚠️ 建议设置合理的止损止盈参数
### 3. 配置变更
- 修改配置后需要重新加载或重启程序
- 部分配置（如miniQMT连接）可能需要重启服务
### 4. 通知频率
- 实时监控会产生较多通知
- 建议根据需要开启/关闭通知渠道
- 可以通过监控频率控制通知数量
---
## 🔍 故障排查
### 问题1: DeepSeek API调用失败
**症状：** 分析时提示API错误
**解决：**
1. 检查API Key是否正确
2. 检查网络连接
3. 检查API额度是否充足
4. 查看 `logs/` 目录下的日志
### 问题2: miniQMT连接失败
**症状：** 提示miniQMT连接失败
**解决：**
1. 确认miniQMT客户端已运行
2. 检查账户ID是否正确
3. 检查服务地址和端口
4. 查看miniQMT客户端状态
### 问题3: 邮件发送失败
**症状：** 通知未收到邮件
**解决：**
1. 检查SMTP配置是否正确
2. 确认使用授权码而非密码
3. 检查邮件服务器端口（587/465）
4. 查看日志中的错误信息
### 问题4: Webhook通知失败
**症状：** 钉钉/飞书未收到消息
**解决：**
1. 检查Webhook URL是否正确
2. 钉钉需要配置自定义关键词
3. 测试Webhook是否可访问
4. 检查机器人是否被禁用
---
## 📚 相关文档
- [智能盯盘快速测试](./智能盯盘快速测试.md)
- [智能盯盘集成说明](./智能盯盘集成说明.md)
- [MiniQMT集成指南](./MINIQMT_INTEGRATION_GUIDE.md)
- [邮件配置指南](./邮件配置指南.md)
- [Webhook通知配置指南](./Webhook通知配置指南.md)
- [环境配置快速指南](./环境配置快速指南.md)
---
## 💡 最佳实践
1. **循序渐进**
- 先用最小配置（仅DeepSeek + 模拟交易）测试
- 验证AI决策逻辑后再启用实盘
- 逐步开启通知功能
2. **风险控制**
- 设置合理的仓位比例（建议≤30%）
- 设置止损止盈参数
- 小资金测试后再加大投入
3. **监控管理**
- 定期查看决策历史
- 分析AI决策准确率
- 根据效果调整策略
4. **配置备份**
- 定期备份 `.env` 文件
- 记录重要配置参数
- 测试环境与生产环境分离
---
**更新时间：** 2025-10-25
**版本：** v1.0