核心功能
stock-monitor 是一款面向个人投资者的轻量级股价监控技能，通过调用 Yahoo Finance API 获取实时行情数据，支持多市场（A股、港股、美股）股票的同时监控。核心机制围绕「基准价对比+阈值预警」展开，用户配置持仓股票及其参考价格后，系统自动按设定频率（建议 5 分钟）轮询价格变化。
显著优点
1. 多市场覆盖：完整支持 A 股（.SS/.SZ）、港股（.HK）、美股无后缀代码，满足跨境投资者需求
2. 灵活预警机制：首次预警阈值（默认 2%）与续警阈值（1%）分离，避免频繁打扰的同时捕捉持续波动
3. 状态持久化：自动保存预警状态至本地 JSON，跨重启保持连续性，每日自动重置基准价为前收
4. 低耦合设计：纯 Python 脚本，依赖仅 yfinance，易于集成到 crontab 或各类自动化框架
局限性与风险
- 数据源依赖：Yahoo Finance 为非官方商业数据，存在延迟（通常 15-20 分钟）、临时封 IP、或中国境内访问不稳定的问题
- 无交易功能：仅监控提醒，不支持程序化下单，需人工决策
- 精度限制：未处理除权除息、拆股等公司行为，长期持仓需手动调整
base_price - 续警逻辑粗糙：1% 续警阈值在极端行情下可能触发过密，缺乏时间冷却机制
适合人群
- 持仓 5-20 只股票的长期投资者，需要「被动盯盘」而非高频交易
- 跨境持仓（港+美+A）用户，希望统一监控入口
- 已使用 OpenClaw 生态，希望将股价提醒接入 Discord/钉钉等现有通知渠道
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据延迟 | 免费 API 非实时，极速行情场景不适用 | 短线交易者应选用券商 Level-2 数据 |
| API 稳定性 | Yahoo 可能限流或调整接口 | 本地缓存+失败重试，准备备用数据源 |
| 配置泄露 | `stocks_config.json` 含持仓信息 | 确保 `~/.openclaw/workspace/memory/` 权限 600 |
| 误报漏报 | 阈值设置不当或状态文件损坏 | 定期检查 `stocks_alert.json` 完整性 |