Skip to content

v2.4.2 push2 Fallback Host

Latest

Choose a tag to compare

@chengzuopeng chengzuopeng released this 19 Aug 06:46

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.rank
    MCP get_industry_list / get_concept_list / get_industry_constituents / get_concept_constituents / get_fund_flow_rank

    push2 主机池新增 push2delay.eastmoney.com 作为兜底。实测各节点对 clist/get 端点的可用性(各打 6 次):

    节点 有效响应
    push2.eastmoney.com(代码中使用的主域) 0/6
    17.push2 2/6
    29 / 79 / 91.push2 6/6
    push2delay 6/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