docs(FEAT-MO-004): 记录AKTools分时能力探针

docs/features/FEAT-MO-004-index-sector-detail/aktools-intraday-capability-probe.md

@@ -0,0 +1,49 @@
+# AKTools 分时能力探针报告
+
+- 功能关联：FEAT-MO-004 指数与板块详情分析页
+- 探针类型：Spike（只读能力验证，不包含业务代码改动）
+- 探针时间：2026-08-25（Asia/Shanghai）
+- 服务地址：`http://127.0.0.1:8080`（仅记录地址，不记录凭据和原始载荷）
+- AKTools 版本：`1.18.88`
+
+## 验证范围
+
+验证 AKTools 暴露的 AKShare 分钟接口，覆盖个股、指数、行业板块和概念板块；同时检查新浪分钟接口是否可以作为指数/个股的备用来源。每次请求仅执行只读查询，不触发交易、账户、自选或写入操作。
+
+## 实测结果
+
+| 数据类别 | 接口 | 参数样例 | HTTP | 结果摘要 |
+| --- | --- | --- | ---: | --- |
+| 个股 | `stock_zh_a_hist_min_em` | `symbol=000001&period=1` | 500（重复探测出现过 200） | 依赖东方财富 push2his；本次重复请求不稳定，不纳入当前接入 |
+| 个股 | `stock_zh_a_minute` | `symbol=sh600519&period=1` | 200 | 返回 1,970 条；字段为 `day/open/high/low/close/volume/amount` |
+| 指数 | `stock_zh_a_minute` | `symbol=sh000001&period=1` | 200 | 返回 1,970 条；可覆盖上证指数 |
+| 指数 | `stock_zh_a_minute` | `symbol=sz399001&period=1` | 200 | 返回 1,970 条；可覆盖深证成指 |
+| 指数 | `stock_zh_a_minute` | `symbol=sz399006&period=1` | 200 | 返回 1,970 条；可覆盖创业板指 |
+| 指数 | `index_zh_a_hist_min_em` | `symbol=399006&period=1/5` | 500 | 依赖东方财富指数映射和 push2his；当前环境不可用 |
+| 行业板块 | `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`。因此它只能标记为历史/延迟数据，不能标记为实时行情。
+
+## 结论
+
+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，也不能在页面上伪装成实时分时。
+4. FEAT-MO-004 当前 `availableViews.intraday=false` 的行为保持不变。本报告不授权新增接口或修改数据源优先级。
+
+## 推荐后续方案
+
+如需继续接入分时，应另立功能并先完成以下边界设计：
+
+- 个股/指数可考虑新浪分钟接口作为“延迟分时”补充，状态必须明确为 `delayed`，并记录数据源和最后数据时间。
+- 板块分时暂不接入 AKShare，除非先解决东方财富上游 500、板块代码映射和重试限流问题。
+- 不把 AKTools 原始接口暴露给浏览器；由 Nest 服务端固定白名单、超时、响应体上限、字段校验和错误脱敏。
+- 继续保留 TDX 作为实时/盘中主数据源；任何补充源都不能覆盖 TDX 的新鲜数据。
+- 上线前需要在交易时段连续观测至少一个完整交易日，比较最后时间、更新时间延迟、缺口率、请求成功率和重复数据率。
+
+## 限制与残余风险
+
+- 探针在本机内网环境执行，结果受当前网络代理、东方财富/新浪上游状态和交易日影响，不能代表生产可用性。
+- 未保存原始返回载荷，避免把行情快照和上游异常细节写入仓库；仅保存接口、状态码、字段和时间摘要。
+- 未验证授权、再分发和长期 7×24 稳定性；在这些事项完成前不得把接口标为生产数据源。