股市守望者 · stock-guardian

📡 设好阈值，到点检查，触发提醒。不做荐股，只做守望。

技能简介

stock-guardian 是一个轻量级股票涨跌监控提醒工具。支持多只股票监控、自定义涨跌阈值、目标价提醒、多渠道分级通知。根据AI平台能力自动适配三档监控模式（秒级实时~30分钟巡逻），适合炒股需及时掌握异动的场景。

适用场景：炒股需及时掌握异动、盯盘不想一直看手机、设好阈值等通知

不做什么：荐股、买卖信号、自动交易

核心功能

一、监控配置

1.1 添加监控

添加监控 600519 +3%/-2%
监控 00700.HK 跌2%提醒
添加 TSLA 涨5%通知到飞书

• 支持A股（6/0/3开头）、港股（.HK后缀）、美股（字母代码）
• 可单独设上涨阈值、下跌阈值，或双向都设
• 首次添加自动识别股票名称

1.2 目标价提醒

监控 600519 目标价1850
监控 002594 止损价290

• 涨到目标价 → 止盈提醒
• 跌到止损价 → 止损提醒
• 可与涨跌幅阈值共存

1.3 监控时段

• 默认仅交易时段检查（A股 9:30-15:00，港股 9:30-16:00，美股 21:30-次日4:00 北京时间）
• 可设置盘前提醒（集合竞价异动）
• 可设置盘后提醒（收盘涨跌统计）
• 非交易时段自动跳过检查

1.4 冷却机制

• 同一只股票触发提醒后，默认60分钟内不重复提醒
• 冷却期可自定义（激进模式5分钟，保守模式120分钟）
• 价格反转时（先触发涨再触发跌）立即突破冷却
• 紧急止损永远突破冷却

二、三档监控模式

根据AI平台能力自动适配，也可手动指定：

| 模式 | 粒度 | 适用平台 | 实现方式 | |------|------|----------|----------| | 🟢 实时模式 realtime | 秒级 | 有云服务器/长驻进程的AI | WebSocket连接行情源，变动实时触发 | | 🟡 高频模式 high-freq | 1-5分钟 | 支持细粒度cron的AI | 定时轮询行情API | | 🔵 巡逻模式 patrol | 10-30分钟 | 调度粒度有限的AI（如扣子） | 心跳/日程定期检查 |

自动检测逻辑：

1. 尝试启动WebSocket → 成功则用实时模式
2. 尝试创建1分钟cron → 成功则用高频模式
3. 以上都不可用 → 回退巡逻模式

巡逻模式的调度方案（扣子平台）：

• 交易时段：日程任务每小时检查（9:30/10:30/11:30/13:30/14:30）
• 心跳兜底：每30分钟检查一次
• 非交易时段：心跳跳过检查

三、行情获取

3.1 数据源优先级

1. 新浪财经API（A股/港股，免费，准实时）
2. 腾讯财经API（A股/港股，免费，准实时）
3. Yahoo Finance API（美股，免费，延迟15分钟）
4. 搜索引擎兜底（所有市场，延迟较大）

3.2 获取策略

• 优先用API直连，速度快、数据准
• API不可用时降级为搜索获取
• 记录上次获取价格，用于计算相对变动

四、提醒触发

4.1 触发条件

| 类型 | 条件 | 示例 | |------|------|------| | 上涨提醒 | 当日涨幅 ≥ 设定阈值 | 涨3%提醒 | | 下跌提醒 | 当日跌幅 ≥ 设定阈值 | 跌2%提醒 | | 止盈提醒 | 当前价 ≥ 目标价 | 1850止盈 | | 止损提醒 | 当前价 ≤ 止损价 | 290止损 | | 新高提醒 | 创N日新高（可选） | 创30日新高 | | 新低提醒 | 创N日新低（可选） | 创30日新低 | | 反转提醒 | 冷却期内价格反转方向 | 先涨后跌 |

4.2 通知格式

📈 贵州茅台(600519) 上涨提醒
当前价：1856.00  涨幅：+3.52%
超过阈值 +3%  |  冷却60分钟

📉 比亚迪(002594) 止损提醒
当前价：288.50  跌幅：-2.18%
已跌破止损价 290.00

🔔 腾讯控股(00700.HK) 新高提醒
当前价：398.20  涨幅：+1.85%
创30日新高

五、通知渠道体系

5.1 渠道能力矩阵

| 渠道 | 扣子AI实现 | 其他AI实现 | 延迟 | 适合场景 | |------|-----------|-----------|------|----------| | 扣子对话 | 直接回复 | - | 秒级 | 日常查看 | | 飞书消息 | lark_cli | 飞书API/webhook | 秒级 | 工作时段 | | 邮件 | email_request | SMTP | 1-5分钟 | 重要止损/日报 | | 微信 | 微信渠道推送 | 企业微信API | 秒级 | 随时查看 | | 手机推送 | 扣子APP推送 | 平台推送 | 秒级 | 即时感知 |

5.2 通知分级策略

按紧急程度分级，不是所有提醒都全渠道轰炸：

| 级别 | 场景 | 默认渠道 | 说明 | |------|------|----------|------| | 🔴 紧急 | 止损触发、暴跌超5%、跌停 | 全渠道（对话+飞书+邮件+微信） | 不怕打扰，怕漏掉 | | 🟡 重要 | 常规涨跌阈值触发 | 对话+飞书 | 工作时段看得到 | | 🟢 一般 | 盘后报告、新高新低 | 对话 | 空了再看 |

用户可自定义每只股票的通知级别和渠道偏好。

5.3 通知聚合

避免短时间内多只股票触发时刷屏：

• 5分钟内的多个非紧急提醒合并为一条汇总：

📊 股票异动汇总 (10:30-10:35)
📈 贵州茅台 +3.52%  |  📉 比亚迪 -2.18%
🔔 腾讯控股 创30日新高

• 紧急止损不合并，单独立即推送
• 聚合窗口可配置（默认5分钟）

5.4 日报与周报

• 盘后日报：15:10自动发送，包含所有监控股收盘涨跌 + 当日触发汇总 + 次日关注
• 周报：周五收盘后，本周涨跌排行 + 触发统计 + 下周待关注事项
• 日报/周报通过用户设定的默认渠道发送

六、K线分析

6.1 趋势判断

分析 600519 K线
600519 现在什么走势
茅台支撑压力位在哪

• 识别当前趋势：上升/下降/震荡
• 自动标注关键支撑位和压力位
• 输出简明解读，不说黑话

6.2 形态识别

| 形态 | 含义 | 提醒级别 | |------|------|----------| | 大阳线 | 涨幅超4%的实体长阳 | 🟡重要 | | 大阴线 | 跌幅超4%的实体长阴 | 🟡重要 | | 十字星 | 开盘≈收盘，多空分歧 | 🟢一般 | | 锤子线 | 下影线长，可能反转 | 🟡重要 | | 射击之星 | 上影线长，可能见顶 | 🟡重要 | | 吞没形态 | 前后两根K线反包 | 🟡重要 | | 跳空缺口 | 开盘价与前日收盘有间隙 | 🟡重要 |

用法：

监控 600519 锤子线提醒
监控 002594 大阴线 + 十字星
监控 TSLA 所有形态

6.3 量价配合

• 放量突破 → 可能加速上涨
• 缩量上涨 → 上涨动力不足
• 放量下跌 → 抛压较大
• 地量地价 → 可能见底

6.4 综合解读

输出一段简明分析，例如：

📊 贵州茅台(600519) K线解读
趋势：震荡上行，5日线上方运行
支撑：1820（20日线）/ 压力：1880（前高）
形态：昨日锤子线，今日放量突破5日线
量价：放量上涨，多头力量增强
结论：短线偏多，关注1880压力突破情况

七、行情回测

7.1 阈值回测

回测 600519 涨3%跌2% 最近30天

• 模拟按设定阈值触发买入/卖出，计算收益
• 输出：触发次数、模拟收益率、最大回撤
• 帮你判断阈值设得合不合理

7.2 触发频率统计

600519 涨3% 过去一个月触发几次

• 统计阈值历史触发频率
• 频率太高 → 阈值可以放宽
• 频率太低 → 可能错过机会

7.3 形态胜率

600519 锤子线胜率

• 统计某形态出现后N天的涨跌概率
• 辅助判断形态信号的可靠程度

7.4 参数调优建议

我的监控阈值合理吗

• 基于历史数据，建议阈值调整方向
• 输出：当前阈值评价 + 推荐参数 + 理由

定位：回测是帮你验证想法，不是替你做决策。分析归分析，买卖归你。

八、监控管理命令

查看监控        → 列出所有监控股票及当前状态
删除 600519     → 移除监控
暂停 600519     → 暂停不删除
恢复 600519     → 恢复监控
修改 600519 +5% → 修改阈值
监控报告        → 查看当日触发记录
通知设置        → 配置通知渠道和分级

数据结构

配置文件 config.json

{
  "mode": "auto",
  "stocks": [
    {
      "code": "600519",
      "name": "贵州茅台",
      "market": "A",
      "threshold_up": 3,
      "threshold_down": -2,
      "target_price_up": null,
      "target_price_down": null,
      "new_high_days": null,
      "cooldown_minutes": 60,
      "alert_level": "important",
      "notify_channels": ["coze", "feishu"],
      "trading_hours_only": true,
      "last_check_price": null,
      "last_check_time": null,
      "last_trigger_time": null,
      "last_trigger_type": null,
      "active": true
    }
  ],
  "notify": {
    "default_channels": ["coze"],
    "urgent_channels": ["coze", "feishu", "email", "wechat"],
    "important_channels": ["coze", "feishu"],
    "normal_channels": ["coze"],
    "aggregate_window_minutes": 5,
    "daily_report": true,
    "weekly_report": true
  },
  "schedule": {
    "pre_market": false,
    "after_market": true
  }
}

触发记录 history.jsonl

2026-05-10T10:30:00|600519|up|important|+3.52%|1856.00|coze,feishu
2026-05-10T14:00:00|002594|stop_loss|urgent|-2.18%|288.50|coze,feishu,email,wechat

文件结构

stock-guardian/
├── SKILL.md              ← 本文件（技能说明）
├── scripts/
│   ├── stock_quote.py    ← 行情获取（多数据源自动降级）
│   ├── kline.py          ← K线数据获取与形态识别
│   ├── analysis.py       ← K线分析（趋势/支撑压力/量价/综合解读）
│   ├── backtest.py       ← 行情回测（阈值回测/形态胜率/参数调优）
│   ├── threshold.py      ← 阈值判断与触发逻辑
│   ├── notify.py         ← 通知分发（多渠道+分级+聚合）
│   ├── scheduler.py      ← 调度模式检测与管理
│   ├── config_manager.py ← 配置增删改查
│   └── history.py        ← 触发记录管理
├── templates/
│   ├── notify_up.md      ← 上涨提醒模板
│   ├── notify_down.md    ← 下跌提醒模板
│   ├── notify_target.md  ← 目标价提醒模板
│   ├── notify_urgent.md  ← 紧急止损提醒模板
│   ├── daily_report.md   ← 日报模板
│   └── weekly_report.md  ← 周报模板
└── data/
    ├── config.json       ← 监控配置（自动生成）
    └── history.jsonl     ← 触发记录（自动生成）

使用流程

快速开始

1. AI读取本SKILL.md，了解能力
2. 执行 添加监控 600519 +3%/-2% 添加第一只股票
3. 自动检测监控模式，创建调度
4. 触发时按分级策略通知用户

每次检查执行流程

1. 读取 config.json 获取监控列表
2. 判断当前是否在交易时段（非交易时段跳过）
3. 逐只获取行情数据（API优先，搜索降级）
4. 计算涨跌幅，比对阈值和目标价
5. 检查冷却期，判断是否触发
6. 确定提醒级别（urgent/important/normal）
7. 触发则按级别选择渠道，聚合非紧急提醒
8. 发送通知，更新 history.jsonl
9. 更新 last_check_price/time

日报流程

1. 15:10 触发日报日程
2. 读取 history.jsonl 当日记录
3. 获取所有监控股收盘价
4. 生成日报，通过默认渠道发送

注意事项

1. 数据延迟：免费行情API有15分钟延迟，实时模式依赖WebSocket付费源
2. 非投资建议：本技能仅提供价格监控提醒和K线形态分析，不构成任何投资建议
3. 风控意识：止损提醒不能保证及时到达，不应作为唯一风控手段
4. 合规边界：不提供荐股、不预测走势、不自动交易
5. 冷却机制：防止同一信号反复打扰，但反转和紧急止损会突破冷却
6. 多市场时差：A股9:30-15:00，港股9:30-16:00，美股21:30-次日4:00(北京时间)，需正确处理跨日
7. 通知聚合：5分钟内多个非紧急提醒合并，避免刷屏；紧急止损永远单独推送
8. 回测局限：历史表现不代表未来，回测结果仅供参数调优参考
9. K线形态：形态识别是辅助观察工具，单一形态不构成交易依据