watchy

Watchy 是一个基于 TradingAgents 多智能体 LLM 交易框架构建的自托管股票监控守护进程。它监控用户自定义的自选列表，并向 Telegram 推送持仓感知指导。它明确是一个决策支持系统：从不下单，也不声称能预测收益或产生 alpha。 双层设计。第一层是零成本技术扫描（默认每 30 分钟一次，仅限美股常规交易时段，通过 exchange_calendars 正确处理夏令时），通过 yfinance 获取 OHLCV 并用不调用 LLM 的方式计算指标。它检测 11 种信号类型，包括带移动平均阶梯确认的金叉/死叉、RSI 极值、MACD 交叉、布林带突破、成交量异常和 ATR 突增。第二层运行完整的四分析师 TradingAgents 流水线（市场、情绪、新闻、基本面），包含多空辩论和风险管理，其深度在每周第一个交易日升级为完整的三方风险辩论。 Watchy 2.0（v2.0.0-rc.1）转向每周计划加事件驱动监控。每周完整运行会要求顾问给出严格的 WEEKLY PLAN 区块（决策、紧迫性、论点、买入区间、追高上限、失效水平/条件、减仓条件、阻力位、止盈价、指导，以及具体的“不要做”）。计划在激活前会经过验证；无效输出会被存储以供诊断，且永远不会成为可执行内容。每次扫描都会根据计划对价格进行分类，并且仅在状态转换时通知，状态会被持久化，因此重启不会重复告警。一个纯路由器将触发条件映射为 TAKE_PROFIT、TRIGGERED_RISK、FAST_RECHECK、NOTIFY_ONLY 或 NO_ACTION 之一，在影子模式（默认发布配置）下、当某只股票不在允许列表中时，或当每只股票/全局会话预算耗尽时，付费路由会降级为提醒。确定性状态标签（ACT NOW、WAIT FOR LIMIT、DO NOT CHASE、RISK REVIEW、PLAN INVALID、STALE、INFORMATION ONLY）不能被 LLM 覆盖。设置 tier2_schedule: daily 可恢复 1.x 行为。 其他已记录功能：价格接近度门控，会跳过对远离入场目标的仅观察股票进行昂贵分析，同时始终分析持仓；可选的 ATR 自适应区间及校准脚本；止盈/防往返路径，会为超过收益下限的持仓盈利股注入充满事实的指令，并根据股数调整建议（整股分批、全部退出、零股市场减仓）；分层持仓来源（Schwab API 实时、缓存快照、手动 YAML），带时间标注和令牌过期告警；以及通过日志行、route_log 表和 scripts/watchy_ctl.py 命令进行可观测性管理，用于状态、计划检查、干跑路由/预览、强制每周运行和只读路由回放。 部署通过 systemd 完成，配置分为可提交的 config.yaml 和被 git 忽略的 secrets.yaml。需要 Python 3.11+，MIT 许可。