股票池盘中异动监控 — Pool Monitor v2.0

📌 本文档同时是 AI 助手的执行手册。一切命令由助手后台代跑，用户只需说需求。

快速开始

本 Skill 零依赖（纯 Python 标准库），安装即用。首次使用需 neodata Token（自动缓存 12h）：

python pool_monitor.py me      # 连通性自检
python pool_monitor.py scan --check-time 10:00   # 10:00扫描
python pool_monitor.py scan --check-time 14:00   # 14:00扫描
python pool_monitor.py report --date 2026-07-25 --time 10:00  # 生成HTML面板

三大功能

🔍 盘中扫描

输入：无需输入，自动读取 unified_stock_pool.json 中 active 个股
输出：实时进度播报（百分比+阶段）→ 告警JSON + 记忆日志追加 + stdout汇总
使用示例（用户可以这样说）：
- 「盘中监控」
- 「异动扫描 14:00」
- 「检查异动涨跌阈值改8%」
- 用户得到：进度条实时推进 → 异动个股逐条列出 → 告警JSON绝对全路径

📊 可视化面板

输入：已有告警JSON文件
输出：深色主题 HTML 告警面板（按级别分组卡片 + 统计仪表）
使用示例：
- 「生成今天10点的异动报告」
- 「把昨天的告警做成HTML面板」
- 用户得到：HTML面板绝对全路径，可离线打开

⚙️ 阈值管理

输入：thresholds 子命令查看/修改
输出：当前阈值配置 / 修改确认
使用示例：
- 「修改异动阈值急涨改8%」
- 「查看当前监控阈值」
- 用户得到：阈值已更新确认

6类异动检测

| 类型 | 触发条件 | 级别 | 置信度 | |------|---------|------|--------| | 急涨 | 涨超 +5% | 🔴 red | 高（实时行情） | | 急跌 | 跌超 -5% | 🔴 red | 高 | | 放量 | 量比 > 2 | 🟠 orange | 中（依赖历史均值） | | 高换手 | 换手率 > 15% | 🟠 orange | 高 | | 盘中急拉/急跌 | 开盘→现价 > 3% | 🔴 red | 高 | | 5日趋势 | 5日累计 > 15% | 🟡 yellow | 中 | | 持仓异动 | 相对入池价 > 5% | 🔴/🟠 | 高 |

错误码速查

| 错误码 | 含义 | exit code | |:--|:--|:--| | token_missing | Token 未缓存，需先触发 neodata 查询 | 3 | | token_expired | Token 过期，需刷新 | 3 | | pool_not_found | 股票池文件不存在 | 2 | | pool_empty | 无 active 个股 | 0 | | all_queries_failed | 全部查询失败 | 4 |

输出产物

| 产物 | 路径 | 何时生成 | |------|------|---------| | 告警 JSON | {ALERT_DIR}/{DATE}_{HHMM}.json | 有异动时 | | 告警 HTML | 按需 | 用户要求时 | | 记忆日志 | 自动追加到 .workbuddy/memory/{DATE}.md | 有异动时 |

配置

凭证/路径优先级：环境变量 > config.json > 默认值

| 环境变量 | 用途 | 默认值 | |:--|:--|:--| | CLAW_ROOT | 工作区根目录 | ~/WorkBuddy/work/Claw | | POOL_MONITOR_POOL_PATH | 股票池JSON路径 | {CLAW_ROOT}/data/unified_stock_pool.json | | POOL_MONITOR_ALERT_DIR | 告警输出目录 | {CLAW_ROOT}/data/stock_pool/alerts/ | | POOL_MONITOR_THRESHOLDS | 阈值JSON字符串 | 默认阈值 |

版本历史

| 版本 | 日期 | 变更 | |------|------|------| | 2.0.0 | 2026-07-25 | 工程化升级：统一CLI入口(scan/me/thresholds/report)、错误码中文引导、凭证三级回退、进度百分比播报、版本自检、stdout结构化JSON输出、HTML报告内置 | | 1.5.0 | 2026-07-17 | 能力边界前置+FAQ+超时重试+输出精确定义 | | 1.0.0 | 2026-07-17 | 初始版本 |

免责声明

本技能仅提供异动检测和告警通知，不构成买卖建议。所有阈值可自定义，用户自行承担交易决策风险。