Files

T

kyugao d793d2cf35 迭代13: 盘口内存快照（QuoteSync/QuoteHub）+ 同步指示灯 + 行情列

- QuoteSync/QuoteHub 替换 MarketFeed/MarketDataHub（方案A 删除重写）:
  5s REST 同步 watch 集合 + 涨停/跌停经 /data/instrument 按交易日内存缓存
  + 读穿透走适配层 getTicks（修正旧 hub 绕适配层的层级破洞）
- WS 数据通路移除（从无生效结论；ingest 留 source 标签回归口子）
- market_quotes_cache 表退役 DROP（幂等）；价格单一入口 = QuoteHub
- 数据同步指示灯组: QMT连接｜持仓数据｜行情数据（绿/黄/灰，点击即同步/即时探测）
  + sync-status 端点（吸收 market-stats）+ sync-now；修复 runtime 漏传 positionSync 致持灯恒灰
- 策略持仓表行情列: 涨停价/跌停价/今开/最高（COLUMN_META defaultVisible=false，纯价格）
- 回归 test-quote-sync.mjs 27 项（含 DROP 幂等真实 SQLite 验证）
- 文档链: R-015 + PLAN-014 + 迭代三件套 + 技术约束-010/012变更、018新增 + 产品约束-012

需求: R-015（老师五拍板: 替换/WS移除/纯内存DROP/watch现状/指示灯）

2026-09-03 13:26:25 +08:00

3.3 KiB

Raw Permalink Blame History

迭代目标：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 数据通路本轮移除（从无生效结论，老师拍板）。

目标分解

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

3.3 KiB Raw Permalink Blame History Unescape Escape