50 lines
3.9 KiB
Markdown
50 lines
3.9 KiB
Markdown
# 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 稳定性；在这些事项完成前不得把接口标为生产数据源。
|