股市守望者

它解决什么问题

盯盘时最烦的不是看价格，而是关键波动被错过：涨超阈值、跌到止损、盘前异动、收盘后还要人工汇总。stock-guardian 的定位是价格守望，而不是交易建议：把 config.json 里监控股票、阈值、目标价和通知渠道配置清楚，由平台调度按周期检查行情并在触发时提醒。

它如何工作

核心链路是：读取 config.json → 判断交易时段 → 拉取行情 → 计算涨跌 → 比对阈值/目标价 → 判断冷却期与提醒级别 → 聚合通知 → 写入 history.jsonl。它按 AI 平台能力选择三档模式：realtime 走 WebSocket，high-freq 用细粒度 cron，patrol 用心跳/日程兜底。数据源优先使用 新浪财经API、腾讯财经API、Yahoo Finance API，API 不可用时降级搜索。

边界与注意点

它只做监控、提醒、K线观察和历史回测，不提供荐股、买卖信号或自动交易。免费行情可能延迟，止损提醒不能当作唯一风控手段；紧急止损会突破冷却并单独推送，普通提醒默认 5 分钟聚合，避免刷屏。