核心用法
stock-monitor 是一款轻量级股票价格监控工具，通过 Yahoo Finance API 获取实时行情数据，为投资者提供自动化价格预警服务。用户需在指定目录配置 JSON 文件定义监控股票列表，包含股票代码、基准价及货币符号，支持 A股（.SS/.SZ 后缀）、港股（.HK 后缀）及美股（无后缀）三大市场。
运行监控脚本后，系统将按设定频率轮询股价，当单日涨跌幅度超过 2% 触发首次预警，同一交易日内若继续波动超过 1% 则触发续警，避免频繁打扰的同时确保重大波动不被遗漏。每日自动重置基准价为前一交易日收盘价，形成完整的监控闭环。用户可通过系统定时任务（如每5分钟）实现全自动值守。
显著优点
- 多市场覆盖: 一站式支持中港美三大主流市场，无需切换平台
- 智能预警分级: 首次预警与续警机制平衡及时性与降噪需求
- 零成本数据源: 依托 Yahoo Finance 免费 API，无订阅费用
- 状态持久化: 本地 JSON 文件保存监控状态，重启后无缝续跑
- 低资源占用: Python 脚本轻量运行，适合长期后台驻留
潜在缺点与局限性
- 数据源单点风险: 完全依赖 Yahoo Finance，若 API 受限、延迟或停服将直接影响功能
- 非官方实时行情: Yahoo Finance 数据存在 15-20 分钟延迟，不满足高频交易或短线盯盘需求
- 无可视化界面: 纯命令行工具，缺乏图表分析、K线查看等能力
- 本地化部署门槛: 需用户自行配置 Python 环境、定时任务及文件路径，对非技术用户不够友好
- 无交易联动: 仅监控提醒，不支持自动下单或盈亏计算
适合人群
- 中长线持仓投资者，需被动监控而非主动盯盘
- 技术背景较强的个人用户，能独立完成环境配置
- 多市场分散持仓者，希望统一监控入口
- 对延迟容忍度较高、追求零成本解决方案的用户
常规风险
1. 数据准确性风险: 免费 API 可能出现价格异常或更新滞后，不建议作为交易决策唯一依据
2. API 可用性风险: Yahoo Finance 未提供官方 SLA，存在无预警变更接口或限制访问的可能
3. 配置文件安全风险: 股票持仓信息以明文存储于本地 JSON，共享设备需注意文件权限
4. 定时任务过载: 过于频繁的轮询（如每分钟）可能导致 IP 被临时封禁或系统资源浪费