go-stock 项目研究站 · 预警与推送
go-stock 预警与推送：三类价格预警、飞书卡片与每日操作计划
go-stock 有两条预警链路：一条盯「AI 推荐股票的买入/止盈/止损价」，一条盯「每日操作计划的情景触发价与两档目标价」。两者都支持系统通知 + 飞书/钉钉推送，并带冷却与去重机制，避免刷屏；再配合交易日志，形成「计划 → 预警 → 执行 → 复盘」的闭环。
生成操作计划
触及价位推送
手动记交易日志
AI 对照复盘
依据官方《预警功能说明》与《交易日志与每日操作计划 AI 实战指南》整理的闭环示意；非官方界面截图。
两套预警体系的区别
先搞清楚你需要的到底是哪一套：一套跟 AI 推荐记录绑定，一套跟你的每日操作计划绑定。
| 维度 | AI 推荐股票预警 | 每日操作计划预警 |
|---|---|---|
| 预警对象 | AI 推荐过的股票及其建议价位 | 你自己（或 AI 生成后确认）的当日操作计划 |
| 预警类型 | 买入、止盈、止损三类 | 情景触发、止损、目标一达成、目标二达成四类 |
| 开关粒度 | 每条推荐记录独立开关（可按预警状态筛选） | 每个计划独立设置预警开关与通知渠道 |
| 检查节奏 | 官方文档：每 60 秒检查一次，仅在 A股/港股/美股开市时执行 | 交易时段内监控（A/港/美任一市场开市即生效） |
| 去重策略 | 同一股票同一类型 5 分钟内不重复发送 | 止损 30 分钟去重；情景触发离开区间再进入才重推；目标当日只推一次 |
| 通知渠道 | Windows 系统通知 + 钉钉群 | 软件内通知与快讯弹窗 + 飞书 + 钉钉 |
go-stock AI 推荐股票的三类预警
表内容来自官方 docs/预警功能说明.md。
| 类型 | 触发条件 | 通知内容 | 使用场景 |
|---|---|---|---|
| 买入预警 | 当前价格 ≤ AI 建议买入价区间下沿 | 股票名称、代码、当前价格、建议买入价范围、推荐时间 | 股价回落到建议买入区间时提醒关注 |
| 止盈预警 | 当前价格 ≥ AI 建议止盈价区间下沿 | 股票名称、代码、当前价格、建议止盈价范围、推荐时间 | 达到预期收益目标时提醒考虑兑现 |
| 止损预警 | 当前价格 ≤ AI 建议止损价 | 股票名称、代码、当前价格、建议止损价、推荐时间 | 跌破风险控制位时提醒处理 |
开启与筛选
在「股票推荐记录」页面，每条记录都有独立预警开关；搜索栏的「预警状态」下拉支持「全部 / 已开启预警 / 未开启预警」三种筛选。通知内容使用 Markdown 格式，便于在钉钉中清晰展示；预警标识按「股票代码:预警类型:推荐日期」计算，用于冷却去重。
go-stock 每日操作计划的四类预警
来自官方《交易日志与每日操作计划 AI 实战指南》。计划里的触发价、止损价、目标价由 AI 结合行情生成，也可手动微调。
| 预警 | 触发条件 | 计划中的建议动作 |
|---|---|---|
| 情景触发 | 实时价进入设定区间 | 按计划动作 / 仓位建仓 |
| 止损预警 | 实时价 ≤ 止损价 | 离场（官方标注为无条件离场） |
| 目标一达成 | 实时价 ≥ 目标一价位 | 按计划减仓 1/2 |
| 目标二达成 | 实时价 ≥ 目标二价位 | 按计划全部止盈 |
| 计划字段 | 含义 | 注意点 |
|---|---|---|
| scenarios（情景） | 低开/平开/高开等多情景预案，含触发价区间 | 要在提问里明确要求「同时填量化价位字段」，否则可能只给文字建议 |
| stopLossPriceNum | 止损价（数值） | 止损触发后该情景不再判断其它条件，但仍需人工执行 |
| target1 / target2 | 目标一/目标二价位区间 | 目标当日只推一次，避免重复打扰 |
| discipline（纪律） | 仓位控制与止损纪律条款 | 建议 2-3 条并写清可执行动作 |
| enableAlert / notifyChannels | 是否开启预警、通知渠道（软件内/飞书/钉钉） | 计划日期必须是当天、状态为待执行/执行中才会推送 |
通知渠道怎么配
系统通知适合在电脑前，飞书适合外出，钉钉适合团队群。
| 渠道 | 配置方式 | 特点 |
|---|---|---|
| 系统通知 | Windows 系统通知；macOS 首次运行需在弹窗中允许通知权限 | 离屏幕最直接；macOS 上裸二进制在通知设置里可能显示为文件名 |
| 软件内快讯 | 无需配置 | 盘中以红色弹窗提示，点击可跳转计划详情 |
| 钉钉 | 设置 → 钉钉推送 → 开启 → 填机器人 Webhook 地址 | 通知为 Markdown 格式，适合群内共享 |
| 飞书 | 配置飞书应用机器人（需 App ID/Secret） | 手机端 AI 助手：AI 运行期间先发进度占位卡片，实时显示分析步骤、工具调用次数与用时，完成后回填结论；支持多轮记忆开关 |
本项目的计划—预警—记录—复盘闭环
这是 go-stock 相对普通看盘软件更特别的地方：把交易纪律做成可追溯的流程。
| 阶段 | 时间 | 动作 | 用到的工具/功能 |
|---|---|---|---|
| ① 盘前计划 | 前一晚 / 开盘前 | 让 AI 生成次日多情景操作计划 | AddDailyOperationPlan |
| ② 盘中预警 | 交易时段 | 触及价位自动通知（软件内 / 飞书 / 钉钉） | 自动监控，无需手动操作 |
| ③ 执行记录 | 盘中 / 盘后 | 手动录入交易日志（价格、数量、手续费、交易原因、持仓心态） | 交易日志（AI 不代填） |
| ④ 当日复盘 | 收盘后 | AI 对照「计划 vs 实际成交」偏差，检查纪律执行 | GetDailyOperationPlanList + GetTradingRecordList |
| ⑤ 周期复盘 | 周末 / 月末 | 统计买卖次数、累计盈亏、胜率，并按「持仓心态」分组识别心理偏差 | GetTradingRecordStatistics |
预警与推送排查表
整理自官方 docs 的故障排查与常见问题章节。
| 现象 | 原因 | 处理 |
|---|---|---|
| 预警通知不发送 | 推送未开启、Webhook 错误、系统通知未授权，或该记录预警开关未打开 | 逐项检查：钉钉推送开关 / Webhook 地址 / 系统通知权限 / 记录开关 |
| 预警状态筛选不生效 | 数据库缺少 enable_alert 字段 | 按官方文档执行字段迁移后重启应用 |
| 盘中没收到计划预警 | 计划状态不是待执行/执行中、预警开关未开、计划日期不是今天，或该市场非交易时段 | 核对计划日期与状态、检查开关与通知渠道 |
| AI 没生成量化价位 | 提问里没要求填数值字段 | 明确写出「同时填写 triggerPriceMin/Max、stopLossPriceNum、target1Min/Max 等数值字段」 |
| 复盘时 AI 找不到交易记录 | 还没手动录入交易日志（AI 只能读取已存在的记录） | 先补录交易日志，再让 AI 做统计与心态分析 |
| 飞书收不到通知 | 飞书 App ID / Secret 配置不正确 | 检查设置中的飞书应用配置；必要时按 MCP 指南接入飞书机器人作为替代通道 |
| 交易日志无法查看 K 线 | 该功能需 VIP2 及以上赞助等级 | 以 README 的赞助说明为准；不依赖该功能也能做文字与数值复盘 |
常见问题
go-stock 会自动帮我下单吗？
不会。官方文档明确 AI 只生成计划与提醒，不自动下单、也不自动写入交易日志；预警触发后需要你自己在券商端执行。这是有意的设计，交易记录涉及真金白银，必须由本人确认。
非交易时段会推送预警吗？
不会。官方说明预警监控仅在 A股、港股、美股开市时执行；非交易时段价格不变化，也就不会触发条件。
为什么同一条预警只提醒一次？
这是去重设计：AI 推荐预警同一类型 5 分钟冷却；计划预警止损 30 分钟去重、情景触发需离开区间后再次进入才重推、目标价当日只推一次，避免连续刷屏。
预警价位可以手动改吗？
可以。计划生成后进入「研究中心 → 每日操作计划」可查看并微调触发价、止损价与目标价，确认状态为待执行、预警开关已开启即可。
交易日志能自动从券商导入吗？
官方文档没有导入券商流水的说明，交易日志由用户手动录入；AI 侧只能查询与统计已有记录。想批量分析，可先按格式逐笔补录。
这些提醒能替代 EasyClaw 的盯盘技能吗？
两者思路不同：本项目是本地客户端按价位轮询推送；EasyClaw 技能走自然语言任务与结果返回。两者无已证实集成，也没有互相替代的官方说法，选型见对比页。