Stock Monitor

核心用法

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 被临时封禁或系统资源浪费

核心用法

该Skill实现了一套完整的股票价格监控解决方案，主要面向个人投资者的股票持仓管理需求。用户通过配置stocks_config.json定义监控标的（支持A股、港股、美股），设置基准价和货币符号后，系统会以定时任务方式周期性查询股价。

预警机制设计较为精细：首次涨跌超2%触发提醒，同一交易日内若继续波动超1%则发送续警，每日自动重置基准价为前日收盘价。这种设计既避免频繁打扰，又确保重大波动不被遗漏。状态持久化到本地JSON文件，支持跨运行会话的预警记忆。

显著优点

1. 零依赖架构：仅使用Python标准库（json/os/sys/urllib），彻底消除供应链攻击风险
2. 多市场支持：通过Yahoo Finance API统一覆盖A股（.SS后缀）、港股（.HK后缀）、美股（无后缀）三大市场
3. 分级预警逻辑：2%首次阈值+1%续警阈值的设计兼顾敏感性与实用性
4. 权限最小化：文件操作严格限制在用户主目录下的指定路径，无系统级访问

潜在局限

1. 数据源单一：完全依赖Yahoo Finance API，若服务中断或限流则功能失效；A股数据通过Yahoo获取存在延迟，非Level-2实时行情
2. 无持久化数据库：仅使用JSON文件存储状态，无法处理大规模监控列表或历史数据分析
3. 配置无校验：股票代码格式未做正则验证，错误输入可能导致请求失败
4. 网络无重试：单次请求失败即跳过该周期，缺乏指数退避等容错机制

适合人群

• 持仓股票数量较少（建议≤20只）的个人投资者
• 对实时性要求不极端敏感（接受分钟级延迟）的港股/美股投资者
• 注重系统轻量、不愿安装复杂金融终端的用户

常规风险

• API服务风险：Yahoo Finance偶有调整接口策略的历史，存在未来兼容性风险
• 数据精度：免费API数据可能有15分钟延迟，不适合高频交易决策
• 本地文件安全：状态文件若权限配置不当（如共享服务器环境）可能被其他用户读取持仓信息
• 定时任务依赖：需确保宿主系统时间准确，cron配置错误可能导致监控盲区