diff --git a/docs/features/FEAT-MO-004-index-sector-detail/aktools-intraday-capability-probe.md b/docs/features/FEAT-MO-004-index-sector-detail/aktools-intraday-capability-probe.md index 15dc62b..47cae11 100644 --- a/docs/features/FEAT-MO-004-index-sector-detail/aktools-intraday-capability-probe.md +++ b/docs/features/FEAT-MO-004-index-sector-detail/aktools-intraday-capability-probe.md @@ -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 的新鲜数据。 -- 上线前需要在交易时段连续观测至少一个完整交易日,比较最后时间、更新时间延迟、缺口率、请求成功率和重复数据率。 +- 上线前需要在交易时段连续观测至少一个完整交易日,比较最后时间、更新时间延迟、缺口率、请求成功率和重复数据率;收盘后的结果只用于确认收盘记录是否完整。 ## 限制与残余风险