港股持仓监控系统 (HK Stock Monitor)

一套完整的港股自动化监控系统，基于 富途 OpenAPI (FutuOpenD) 实现。

功能概述

1. 持仓监控 (scripts/monitor.py)

• 止损检测: 正股(趋势/抄底)、杠杆ETF、窝轮，多品种分类止损
• 止盈检测: 四级阶梯止盈 + 技术面止盈(放量滞涨/长上影线/RSI超买)
• 手数感知: 根据实际持仓手数自动调整操作建议（1手不可分批/2-3手粗略分批/4手+正常阶梯）
• 品种识别: 自动区分正股、杠杆ETF、窝轮、普通ETF
• 技术面分析: MA均线、RSI、量能分析

2. 买入机会扫描 (scripts/scanner.py)

6大策略动态筛选 + 综合10分制评分:

1. 深度超跌反弹 — 从52周高点跌>25%且有盈利
2. 放量突破 — 量比>2且5分钟趋势向上
3. 低估值高股息 — PE<10且接近52周低点
4. 恒科急跌联动 — 恒科指数急跌时龙头联动低吸
5. 异常放量急跌（恐慌抄底）— 日内跌>5%且量比>3
6. 行业龙头观察池 — 40+只龙头股信号监控

仓位感知: 根据现金比例动态调整推送门槛(轻仓6分/中仓7分/满仓停推)

3. 个股价格报警 (scripts/price_alert.py)

• 多级报警: 预警 → 警告 → 触发止损
• 日内异常跌幅检测
• 止盈目标到达提醒
• 不重复轰炸: 同级别只推一次，升级才推新消息

4. 企业微信推送 (scripts/notifier.py)

• 支持 Markdown 富文本消息
• 内置去重和频率限制
• 止损/止盈/买入信号/早午盘报告/系统告警

5. 定时调度 (scripts/scheduler.py)

• 基于 APScheduler 的定时执行框架
• 早盘/午盘监控 + 高频买入扫描
• 交易时段自动感知

6. 一键云端部署 (scripts/deploy.sh)

• Ubuntu 服务器一键部署
• systemd 服务管理（自动重启）
• 含 FutuOpenD 网关部署指南

前提条件

1. 富途证券账户 + FutuOpenD 网关 (免费，需下载安装)
• 下载地址: https://www.futunn.com/download/OpenAPI
• FutuOpenD 需在本地或云端运行，监听 TCP 端口（默认 11111）
2. Python 3.8+
3. 企业微信群 (用于接收推送通知)
• 在群中添加机器人，获取 Webhook URL

安装和配置

Step 1: 复制脚本到工作目录

将 scripts/ 目录下的所有 .py 文件、requirements.txt、deploy.sh 和 systemd/ 目录复制到项目工作目录。

Step 2: 安装依赖

pip install -r requirements.txt

Step 3: 编辑配置文件

复制 scripts/config.example.yaml 为 config.yaml，填入以下信息:

# 必填项:
futu:
  host: "127.0.0.1"   # FutuOpenD 地址
  port: 11111          # FutuOpenD 端口

account:
  acc_id: YOUR_ACC_ID  # 富途交易账户ID (在富途App中查看)

wechat_bot:
  webhook_url: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"
  enabled: true

所有止损/止盈参数、观察池、扫描器配置均在 config.yaml 中，可按需调整。

Step 4 (可选): 云端部署

# 上传文件到服务器
scp -r scripts/* user@your-server:/opt/hk-monitor/

# SSH 登录服务器执行部署
ssh user@your-server
cd /opt/hk-monitor
sudo bash deploy.sh

部署详情参见 references/deploy_guide.md。

使用方式

本地运行

# 启动完整调度器(早盘/午盘/扫描全自动)
python scheduler.py

# 单独执行持仓检查
python -c "
import yaml
from monitor import PositionMonitor
from notifier import WeChatBotNotifier
config = yaml.safe_load(open('config.yaml'))
notifier = WeChatBotNotifier(config['wechat_bot']['webhook_url'])
pm = PositionMonitor(config, notifier)
report = pm.run_position_check()
print(report)
"

配合 WorkBuddy 自动化任务

推荐创建以下自动化:

• 早盘监控 (周一至周五 09:30): 查持仓+实时报价+技术面分析+止盈止损建议
• 午盘监控 (周一至周五 14:00): 日内波动+止损线检查+大盘环境
• 买入扫描 (交易日 09:00-15:30 每30分钟): 6大策略+观察池+评分

止损/止盈纪律标准

详细的止损止盈纪律体系参见 references/risk_discipline.md，核心规则:

止损

止盈 (正股阶梯)

核心铁律

• 单笔亏损 ≤ 总本金 3%
• 总风险敞口 ≤ 10%
• 现金 ≥ 15%

futu API 技术备注

关键踩坑记录参见 references/futu_api_notes.md，避免重复踩坑:

• pl_ratio 是百分比值(如 -3.52 表示 -3.52%)，需除以100
• request_history_kline 有额度限制，优先使用 subscribe + get_cur_kline
• SimpleFilter 不支持 CHANGE_RATE、VOLUME 等常用字段
• 快照不含 price_change_rate_%，需手动计算

文件清单

scripts/
├── config.example.yaml   # 配置模板（需复制为 config.yaml 并填入你的信息）
├── scheduler.py          # 主调度器
├── monitor.py            # 持仓监控核心（止损/止盈/技术面）
├── scanner.py            # 买入机会扫描器 v2（6大策略）
├── notifier.py           # 企业微信推送模块
├── price_alert.py        # 个股价格报警器
├── requirements.txt      # Python 依赖
├── deploy.sh             # 一键部署脚本
└── systemd/
    ├── futud.service      # FutuOpenD systemd 服务
    └── hk-monitor.service # 监控系统 systemd 服务

references/
├── deploy_guide.md       # 云端部署详细指南
├── risk_discipline.md    # 止损/止盈纪律手册
└── futu_api_notes.md     # futu API 踩坑笔记