4.1 KiB
4.1 KiB
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。本次探针在收盘后执行，最后一条记录可能只是最近一个交易日的收盘数据；仅凭收盘后的单次探测，不能判定接口存在延迟，也不能据此标记为实时行情。
结论
- AKShare 确实具备分时能力；当前内网 AKTools 已能通过
stock_zh_a_minute返回个股和主要指数分钟序列。 stock_zh_a_hist_min_em、index_zh_a_hist_min_em、行业板块和概念板块分钟接口均依赖东方财富上游，本次环境中出现 HTTP 500 或重复不稳定，暂不具备上线条件。- 新浪接口的字段结构与现有详情页 TDX K 线模型不同；本次收盘后探测不足以确认盘中时效，不能直接替换 TDX，也不能在页面上未经状态判断标记为实时分时。
- FEAT-MO-004 当前
availableViews.intraday=false的行为保持不变。本报告不授权新增接口或修改数据源优先级。
推荐后续方案
如需继续接入分时，应另立功能并先完成以下边界设计：
- 个股/指数可考虑新浪分钟接口作为分时补充，但状态必须依据交易时段探测结果判断，并记录数据源和最后数据时间；收盘后的单次结果不能直接标记为
delayed或fresh。 - 板块分时暂不接入 AKShare，除非先解决东方财富上游 500、板块代码映射和重试限流问题。
- 不把 AKTools 原始接口暴露给浏览器；由 Nest 服务端固定白名单、超时、响应体上限、字段校验和错误脱敏。
- 继续保留 TDX 作为实时/盘中主数据源；任何补充源都不能覆盖 TDX 的新鲜数据。
- 上线前需要在交易时段连续观测至少一个完整交易日，比较最后时间、更新时间延迟、缺口率、请求成功率和重复数据率；收盘后的结果只用于确认收盘记录是否完整。
限制与残余风险
- 探针在本机内网环境执行，结果受当前网络代理、东方财富/新浪上游状态和交易日影响，不能代表生产可用性。
- 未保存原始返回载荷，避免把行情快照和上游异常细节写入仓库；仅保存接口、状态码、字段和时间摘要。
- 未验证授权、再分发和长期 7×24 稳定性；在这些事项完成前不得把接口标为生产数据源。