docs(FEAT-MO-004): 修正收盘后分时时效结论

2026-08-25 00:51:58 +08:00
parent 86de51f184
commit a1b4d8c591
1 changed files with 4 additions and 4 deletions
@@ -23,24 +23,24 @@
 | 行业板块 | `stock_board_industry_hist_min_em` | `symbol=小金属&period=1/5` | 500 | 当前环境不可用；接口内部还依赖板块名称映射 |
 | 概念板块 | `stock_board_concept_hist_min_em` | `symbol=长寿药&period=1/5` | 500 | 当前环境不可用；接口内部还依赖概念名称映射 |

-新浪分钟接口返回的最新时间均为 `2026-08-24 15:00:00`，而探针日期为 `2026-08-25`。因此它只能标记为历史/延迟数据，不能标记为实时行情。
+新浪分钟接口返回的最新时间为 `2026-08-24 15:00:00`。本次探针在收盘后执行，最后一条记录可能只是最近一个交易日的收盘数据；仅凭收盘后的单次探测，不能判定接口存在延迟，也不能据此标记为实时行情。

 ## 结论

 1. AKShare 确实具备分时能力；当前内网 AKTools 已能通过 `stock_zh_a_minute` 返回个股和主要指数分钟序列。
 2. `stock_zh_a_hist_min_em`、`index_zh_a_hist_min_em`、行业板块和概念板块分钟接口均依赖东方财富上游，本次环境中出现 HTTP 500 或重复不稳定，暂不具备上线条件。
-3. 新浪接口的字段结构与现有详情页 TDX K 线模型不同，且数据时效落后一个交易日，不能直接替换 TDX，也不能在页面上伪装成实时分时。
+3. 新浪接口的字段结构与现有详情页 TDX K 线模型不同；本次收盘后探测不足以确认盘中时效，不能直接替换 TDX，也不能在页面上未经状态判断标记为实时分时。
 4. FEAT-MO-004 当前 `availableViews.intraday=false` 的行为保持不变。本报告不授权新增接口或修改数据源优先级。

 ## 推荐后续方案

 如需继续接入分时，应另立功能并先完成以下边界设计：

- 个股/指数可考虑新浪分钟接口作为“延迟分时”补充，状态必须明确为 `delayed`，并记录数据源和最后数据时间。
+- 个股/指数可考虑新浪分钟接口作为分时补充，但状态必须依据交易时段探测结果判断，并记录数据源和最后数据时间；收盘后的单次结果不能直接标记为 `delayed` 或 `fresh`。
 - 板块分时暂不接入 AKShare，除非先解决东方财富上游 500、板块代码映射和重试限流问题。
 - 不把 AKTools 原始接口暴露给浏览器；由 Nest 服务端固定白名单、超时、响应体上限、字段校验和错误脱敏。
 - 继续保留 TDX 作为实时/盘中主数据源；任何补充源都不能覆盖 TDX 的新鲜数据。
- 上线前需要在交易时段连续观测至少一个完整交易日，比较最后时间、更新时间延迟、缺口率、请求成功率和重复数据率。
+- 上线前需要在交易时段连续观测至少一个完整交易日，比较最后时间、更新时间延迟、缺口率、请求成功率和重复数据率；收盘后的结果只用于确认收盘记录是否完整。

 ## 限制与残余风险