# 迭代目标：13-盘口内存快照（QuoteSync/QuoteHub + 同步指示灯）

> 迭代编号：13 ｜ 创建：2026-09-02 ｜ 状态：已实施，待验收
> 依据计划：PLAN-014 ｜ 需求：R-015（已定稿，2026-09-02）

## 目标描述

把盘口（市场行情）数据收敛为与持仓（迭代 12）对称的「定时同步 + 内存快照」模式：新建 QuoteSync（取数）与 QuoteHub（存查）两个工具类，`market_quotes_cache` 表退役（DROP），价格单一入口 = QuoteHub；扩展涨停价/跌停价（/data/instrument 按交易日缓存）；会话头部新增「持仓/盘口」同步指示灯（绿黄灰，点击即同步）。WS 数据通路本轮移除（从无生效结论，老师拍板）。

## 目标分解

1. **QuoteSync**（src/market/QuoteSync.js）：启动 prime（持仓盘口）+ 5s 定时刷 watch 集合（分批 50）+ 涨停跌停按交易日懒拉缓存（watch 新 code → /data/instrument，日切失效）+ 热切换重置 + stats；失败保留内存不动；WS 不迁移；
2. **QuoteHub**（src/market/QuoteHub.js）：内存快照 Map + watchCodes Set（维持现状只进不出）+ 合约信息缓存 + 读穿透（走 dataSource.getTicks，不再自 fetch）+ 防抖 3s 写盘逻辑删除（无落库）+ 对外 getQuote/getQuotes/getByCodes/watch/stats；
3. **数据源**：QmtBridgeRestDataSource 新增 getTicks(codes)（/data/tick 批量语义化，带 updatedAt/time 原始时间）；
4. **存储清理**：SqliteStore 删行情表方法 + `DROP TABLE IF EXISTS market_quotes_cache`（幂等）+ migrateJson 行情段/isEmpty 联动收缩；DataStore 删 loadMarket/getMarketQuote(s)/setMarketQuotes；
5. **API**：market-snapshot 值对象扩展 {lastPrice,lastClose,upStopPrice,downStopPrice,updatedAt}；新增 sync-status（持仓/盘口/QMT 三域状态，吸收 market-stats）+ sync-now {domain: position|quote}；
6. **前端**：SyncIndicators 组件（QmtHealthIndicator 旁两圆点：持●行●，10s 轮询 sync-status，绿黄灰 + 悬停详情 + 点击调 sync-now）；MarketDataProvider 删 wsInfo 残留；QmtConnectionChip 挂载；
7. **回归**：scripts/test-quote-sync.mjs（纯内存 mock）+ typecheck + build + 存量回归；
8. **策略持仓表行情列**（老师确认并入）：列设置新增 涨停价/跌停价/今开/最高 4 列（COLUMN_META 登记，kind=base，defaultVisible: false 默认隐藏）；renderDataCell 取值 getPrice(code)?.{upStopPrice|downStopPrice|open|high}；纯价格展示（无距离百分比）；归一化缺省显隐跟随 defaultVisible；

## 指示灯规格（老师采纳 AI 推荐逻辑）

- 阈值：持仓 30s 内绿 / 超过黄、从未灰（周期 10s）；盘口 15s 内绿 / 超过黄、从未灰（周期 5s）——**绿黄灰三态，不引入红**（红留给 QMT 健康灯表达连接层故障，同步灯表达数据层陈旧）；
- 悬停 title：状态 + 最近同步时间 + 快照量 + 失败次数 + lastError 摘要；
- 点击：立即触发该域 syncNow（不等下个周期），灯自动刷新。

## 对老师的配合需求

- 人工验收（真实环境）：重载插件 → 指示灯绿、悬停信息正确 → 停 QMT 后两灯渐黄且页面价格保持旧值 → 恢复 QMT ≤5s 回绿 → 点击指示灯立即同步 → 涨停/跌停列数据正确（对比券商软件）。