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 new file mode 100644 index 0000000..15dc62b --- /dev/null +++ b/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 稳定性;在这些事项完成前不得把接口标为生产数据源。