FastAPI应用层驱动四类监控，盘中实时弹窗语音播报并推送飞书

方案简介

TSP 的监控与通知配方由应用层 FastAPI 服务驱动：在本地量化工作台中运行策略/个股信号/价格/异动四类监控规则，支持多条件 AND/OR 组合，触发时通过盘中实时弹窗、语音播报（播报个股名称与信号）与飞书推送三种方式触达用户，触发记录持久化可回溯。它解决的痛点是：本地策略与信号计算（Polars 毫秒级扫全 A 股）产出后，研究者不可能全天盯盘，需要一个可靠的实时通知链路。适合自托管本工作台、需要在交易时段及时获知自选与策略信号的个人量化研究者。

亮点与能力

• 四类监控规则：策略/个股信号/价格/异动四类规则统一在监控中心管理。
• 多条件组合：规则支持多条件 AND/OR 组合，并可限定自选分组作用域。
• 实时触达：盘中实时弹窗 + 语音播报（播报个股名称与信号）+ 飞书推送。
• 触发可追溯：触发记录持久化，便于事后核查。
• 持仓联动：记录个股/ETF 买入批次，自动生成止盈止损/到期监控规则。
• 流式反馈：回测等长任务使用 SSE 流式进度反馈。

组成与分工

• FastAPI：应用层服务框架，承载数据/策略/监控/回测等接口与页面后端。
• Polars：底层计算引擎，为监控规则提供毫秒级信号与指标计算能力。
• 飞书：外部推送渠道，监控触发及盘后复盘可推送到飞书。
• 语音播报：本地通知方式，触发时播报个股名称与信号。
• SSE：服务端向页面流式推送任务进度（如回测进度）。

实施步骤

1. 准备数据面

按上一配方完成数据源接入与 enriched Parquet 落盘，确保策略/信号可计算。

2. 配置实时监控

进入「设置」页，配置实时监控相关项与推送渠道。

3. 创建监控规则

在「监控中心」创建策略/个股信号/价格/异动四类规则，组合多条件 AND/OR，可按自选分组限定作用域。

4. 验证成功

盘中观察是否出现实时弹窗、听到语音播报（播报个股名称与信号），并确认触发记录已持久化；如配置了飞书，检查推送是否到达。

使用与配置要点

• 日常交易时段保持工作台运行，监控规则按档位分流实时刷新（自选股按档位分流刷新实时指标）。
• 复盘任务可定时执行、推送飞书、下载 Markdown。
• 持仓提醒页可记录个股/ETF 买入批次，自动生成止盈止损/到期监控规则，与监控中心联动。

注意事项与常见问题

• 项目明确不作为投资软件或看盘软件，监控通知仅辅助研究。
• 异动监控中「竞价异动」的全市场竞价扫描为待采集任务，能力尚未完整。
• 部分页面（个股分析、复盘）为 Beta 状态。

优缺点

• ✓ 盘中实时弹窗+语音播报
• ✓ 触发记录持久化可追溯
• ✕ 仅本地自托管使用
• ✕ 需自行配置推送渠道

出处

本方案挖掘自开源项目 shy3130/tick-stock-panel，方案内容与实施命令均来自其 README 原文。