stock_chan_analyzer

1. 当前项目包含什么

• 缠论图页面：支持分型、笔、中枢、预警点位展示。
• 四联页：用来同时查看日线 / 高级别 / 当前周期 / 低级别。
• 后台实时预警：即使用户不打开页面，程序也会持续轮询并写入预警。
• 统一预警文件：实时预警与回测预警统一写入同一条结果链路。
• 对外简洁 API：输出当前 watchlist 各股票最新预警的文字摘要。

2. 页面入口

• /combined：当前主要页面入口，默认是 5m 四联页。
• /frame/chan：单个缠论图 iframe 页面。
• /help：当前帮助页。

人看页面时，优先使用 /combined。

3. 四联页当前能力

• 页面顶部支持股票代码切换。
• 支持 MA / Boll 开关。
• 支持简洁模式切换。
• 图上会显示预警点，统一使用上下三角。
• 图窗之外的预警不会强行映射到图内。

4. 预警点当前口径

• 时间位置：使用触发预警对应 K 线的 bar_datetime。
• 横向映射：按当前交易 K 线序列映射，不按自然时间连续缩放。
• 纵向映射：按当前 raw K 线位置归属到当前笔，再投到该笔对应位置。
• 样式：低点向上转折用上三角，高点向下转折用下三角。

5. 后台实时预警怎么运行

• 程序启动后，会自动拉起后台预警线程。
• 后台线程默认每 60 秒轮询一次。
• 即使用户不打开页面，后台也会继续拉数据并生成实时预警。
• 实时预警写入 alert_cache.db 和统一预警文件 alert_feed.jsonl。

6. watchlist 怎么设置

• 推荐方式：直接在 /combined 页面最下端的“后台实时预警监控”区域修改。
• 输入格式：股票代码用逗号分隔，例如 600547, 601899。
• 也可以手动修改本地文件：data/alert_watchlist.json。
• 保存后，后台线程会在下一轮轮询时自动读取新 watchlist。

7. 当前对外 API

• /api/alerts/latest：当前唯一对外主接口。
• /api/health：仅用于健康检查与接口列表说明。

当前项目的对外输出已经收口为“简洁预警播报”，不再对外暴露旧的详细分析 JSON 作为正式接口。

8. 对外 API 返回什么

• ok：请求是否成功。
• watchlist：当前后台监控的股票列表。
• text：人可以直接看的最新预警简洁播报。

9. 对外 API 示例

{
  "ok": true,
  "watchlist": ["600547", "601899"],
  "text": "600547：1m 向上转折预警（2026-04-07 10:48），5m 向上转折预警（2026-04-07 10:08）。601899：暂无预警。"
}

10. 当前推荐使用方式

• 人工核验：使用 /combined。
• 程序读取最新预警：使用 /api/alerts/latest。
• 后台监控股票：在综合页底部直接设置 watchlist。
• 如果只是做预警播报，不要解析 HTML 页面，直接读取 JSON。