Stock Monitor CLI v2.0 - A股价格预警监控系统（命令行版）

通达信协议直连，郑州节点极速响应（~15ms延迟）

版本定位

项目	版本	说明
stock-monitor	CLI版 v2.0	命令行工具，轻量高效
stock-monitor-web	Web版 v3.0	图形界面，开发中

特性

• 极速响应: 通达信协议直连郑州主站，平均延迟仅31.9ms，最低13.9ms
• 双数据源: 通达信协议（默认）+ 腾讯接口（备用），自动回退
• 多股监控: 支持同时监控多只股票，配置文件管理
• 本地弹窗: Windows原生弹窗提醒，零依赖
• 冷却机制: 触发后自动降频，避免反复弹窗
• 模块化设计: 数据源、监控、通知三层分离，易于扩展

版本信息

当前版本：v2.0.0

版本历史：详见 CHANGELOG.md

版本号规则：遵循 语义化版本控制（Semantic Versioning）

• 主版本号：不兼容的 API 修改
• 次版本号：向下兼容的功能性新增
• 修订号：向下兼容的问题修正

项目背景

这个项目来自 WorkBuddy 的股价监控需求。最初是作为个人交易工具开发的，现在独立出来成为开源项目。

为什么做这个？

• 通达信软件本地缓存无法直接读取（内存映射，磁盘全零）
• 需要极低延迟的实时行情监控（T0日内交易）
• 需要简单可靠的弹窗提醒机制
• 需要支持多只自选股同时监控

技术亮点：

• 使用 eltdx 库直连通达信协议服务器，绕过本地文件读取限制
• 发现郑州节点（182.118.8.4）延迟最低（3.5ms TCP握手）
• 双数据源自动回退，确保可用性
• Windows 原生弹窗，无需额外依赖

安装

# 可选：安装eltdx以获得更快的数据源（TDX协议直连）
pip install "eltdx[mcp]"

# 如果不安装eltdx，程序会自动使用腾讯接口（无需额外依赖）

快速开始

单只股票监控

# 中国能建跌破2.90提醒（默认用通达信郑州节点，~15ms）
python price_alert.py --code sh601868 --target 2.90 --dir below

# 上海建工涨破2.55提醒
python price_alert.py --code sh600170 --target 2.55 --dir above

# 双向提醒（跌破2.45或涨破2.55都提醒）
python price_alert.py --code sh600170 --target 2.45 --dir both

批量监控

# 使用配置文件监控多只股票
python price_alert.py --config watchlist_config.json

配置文件示例

{
  "interval": 5,
  "source": "tdx",
  "log": "reports/price_alert_watchlist.txt",
  "alerts": [
    {"code": "sh601868", "name": "中国能建", "target": 2.90, "dir": "below"},
    {"code": "sh600170", "name": "上海建工", "target": 2.45, "dir": "below"},
    {"code": "sh603077", "name": "和邦生物", "target": 2.00, "dir": "below"}
  ]
}

参数说明

参数	说明	默认值
--code	股票代码（如 sh601868）	-
--target	目标价格	-
--dir	方向：below/above/both	below
--interval	检查间隔（秒）	5
--source	数据源：tdx/tencent	tdx
--notify	通知方式：popup/log	popup
--config	JSON配置文件路径	-

数据源对比

数据源	延迟	说明
TDX（通达信协议）	~15ms	郑州节点直连，默认
腾讯接口	~155ms	备用，无需额外依赖

相关项目

• stock-monitor-web - Web版（v3.0，开发中）

许可证

MIT License