股票池盘中异动监控 — 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 | 初始版本 |
免责声明
本技能仅提供异动检测和告警通知，不构成买卖建议。所有阈值可自定义，用户自行承担交易决策风险。
