v2.4.2 是一次 上游节点失效修复 版本:东财 push2 主域近期不可用,导致板块与资金流排行相关方法取数失败;本版补充兜底主机。另补齐各数据集的时效口径说明。无破坏性变更,升级无需改代码。
修复
-
板块列表 / 成分股 / 资金流排行取数失败(#71,感谢 @Cossack9989 提交):东财
push2.eastmoney.com主域近期不可用,导致下列方法失败——端 受影响 SDK sdk.board.industry.list/sdk.board.concept.list/sdk.board.industry.constituents/sdk.board.concept.constituents/sdk.fundFlow.rankMCP get_industry_list/get_concept_list/get_industry_constituents/get_concept_constituents/get_fund_flow_rankpush2 主机池新增
push2delay.eastmoney.com作为兜底。实测各节点对clist/get端点的可用性(各打 6 次):节点 有效响应 push2.eastmoney.com(代码中使用的主域)0/6 17.push22/6 29 / 79 / 91.push26/6 push2delay6/6
兜底节点排在最后,不会让你静默拿到过期行情
push2delay 是延迟行情镜像,数据滞后于实时节点。盘中同一时刻取同一份板块数据实测:
29.push2 (实时) 焦炭Ⅲ 5.95% 厨卫电器 4.73%
push2delay 焦炭Ⅲ 5.91% 厨卫电器 4.72% ← 落后
5 秒后实时节点数值已变动,而 push2delay 仍停在原值。
因此它被放在全部实时节点之后,只有实时节点都不可用时才启用。这一点很关键:主机回退的失败阈值是 1 次、冷却 30 秒,若把延迟镜像放在前面,任何一次网络抖动都会让接下来 30 秒的请求静默切到过期数据——而此时 29 / 79 / 91 三个实时节点其实完全健康。
文档
-
补充各数据集的时效口径(#68):此前文档从未说明数据发布时点,盘中查当日龙虎榜拿到空结果容易被误认为接口故障。现按各自实测口径分别标注,而非一刀切:
数据集 口径 龙虎榜 / 大宗交易 / 日度资金流 盘后数据,当日数据需等收盘后发布 融资融券 滞后一个交易日(交易所次日公布) 北向资金 沪深股通净额已停止实时披露(可能恒为 0),南向仍有值 涨停池 / 盘口异动 盘中实时,同一天不同时点查询条数会变化 同步写入对应 MCP 工具的
description,并指示模型「如实说明时效,不要报错或臆测原因」——接 MCP 的客户端读不到网页文档,只读工具描述。 -
文档站导航「演练场」改为「演示」下拉框,新增 A 股看板、K 线图表两个示例站入口。
升级
- 安装:
npm i stock-sdk(latest → 2.4.2)。 - 无破坏性变更,无需改动代码。若此前遇到板块 / 资金流排行取数为空,升级即可恢复。
Full Changelog: v2.4.1...v2.4.2