Files
one_divine_lot/docs/04-迭代记录/19-指示灯状态自适应探测/迭代目标.md
T

33 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 迭代目标:19-指示灯状态自适应探测(QMT 健康灯 + MCP 灯)
## 目标
会话头部两只「连接类」指示灯(QMT连接 / MCP)改为**结果驱动自适应探测**:
健康/已连接时维持 5 分钟稳态探测(低开销),异常/未知时每 10 秒快速重试,
使 QMT Bridge 与其 MCP 服务启动/恢复后指示灯 ≤20s 自动回绿,不再等满 5 分钟。
## 目标描述
- **背景**:两只灯的数据分别来自 QmtHealthMonitor / QmtMcpManager 的内存状态缓存,刷新机制均为
固定/缺失低频定时回路——QMT 健康缓存固定每 5 分钟探测一次(R-022),MCP 状态缓存只在
挂载/切换/手动探测时刷新、无定时回路(R-023)。持仓(10s)/ 行情(5s)灯靠各自定时同步秒级自愈;
唯独两只连接灯恢复感知滞后,老师实测反馈「QMT连接灯一直没亮」「MCP 灯也不自动恢复」(2026-09-09)。
- **范围**:只改 QmtHealthMonitorR-022)与 QmtMcpManagerR-023)的探测调度;前端指示灯组件、
sync-status / qmt-health / mcp-status 端点零改动;健康稳态间隔 5 分钟不变;不新增配置项。
- **验收线**:两灯异常/未知态 ≤10s 重试;健康/已连接态维持 5 分钟不空转;服务恢复后缓存回正常态
沿快速重试被感知;无激活连接与 dispose 后停止调度。对应需求 R-022 + R-023。
## 目标讨论过程
1. 老师报告症状(2026-09-09):Bridge 启动后其他三灯自动点亮,QMT 灯不亮 → 定位为健康缓存固定 5 分钟探测。
2. AI 提议自适应节奏(健康 5min / 异常 10s),老师确认方向,迭代 19 实施(R-022)。
3. 老师复查发现 MCP 灯同样不自动恢复(R-023)→ 确认 QmtMcpManager 状态缓存无定时回路,
dsh-mcp-client 重连只恢复真实连接、不刷新本类缓存 → 同模式加自适应探测,并入本次迭代。
4. 决策点见 R-022 / R-023 决策记录。
## 对老师(项目主理人)的配合需求
- 确认 R-022 / R-023 定稿与迭代 19 验收(核实标准见验收标准.md);
- 真实环境人工验收:停/启 QMT Bridge → QMT 灯 ≤20s 回绿、MCP 灯 ≤20s 回绿;点击灯/「检测 MCP」仍即时探测;
插件重载后灯按缓存秒回并正常。