@dshtrading/connector-eastmoney 0.6.3 → 0.7.0

package/README.md

@@ -43,7 +43,16 @@
   是派生值而非交易所开价（证据 `spikes/impl-five-day-1m-fetch/EVIDENCE.md`）。
 - **取价必须按行的 `f1` 除**：`price = f2 / 10^f1`。CN ETF 行的 `f1` 是 3，套市场级 ÷100 会把 1.059 元读成 10.59 元。
 - 未收录的 secid 在响应里**整行缺席**（不报错）→ `TRADING_SYMBOL_NOT_FOUND`；批量路径按契约由调用方回落单取。
-- 错误映射：非 2xx → `TRADING_UPSTREAM_ERROR`，不可达 → `TRADING_NETWORK`，非 JSON → `TRADING_EXCHANGE_ERROR`。
+- 错误映射：非 2xx → `TRADING_UPSTREAM_ERROR`，不可达/超时 → `TRADING_NETWORK`，非 JSON → `TRADING_NETWORK`
+  （后两者里只有「不可达/超时」可重试）。
+- **请求通道的硬上界**：只有网络级失败才重试，最多 3 枪、重试间**固定 200 ms** 冷却（不退避）；
+  单枪超时与整通硬截止（含冷却与全部枪，到点不续命）**按域分两档**——行情域（push2 /
+  push2his / searchapi）单枪 2 s、整通 3 s（「快速判别空回」）；报表域（datacenter-web，分页
+  整表、报文几百 KB）单枪 8 s、整通 20 s（3 s 会把可达端点判成故障）。两档都盖住建连、响应头
+  与**响应体解析**整段：200 头已回但 body 挂住同样在单枪超时内终结。整通失败后把**该主机**
+  静置 30 s（熔断，push2 / push2his / searchapi / datacenter-web 各自独立）：窗口内零网络请求、
+  立即抛 `TRADING_NETWORK`，消息带 `circuit open` 与剩余毫秒，到期自愈、任一成功清零。
+  HTTP 非 2xx 与坏 JSON 不重试、也不打开熔断。
 
 ## 能力面
 
@@ -61,6 +70,10 @@
 - **`/api/qt/stock/get` 路径级空回**（2026-10-14）：同一时刻、同域、同 UA 的 `ulist.np/get`、`trends2`、
   `kline/get` 全部正常，只有该路径传输层空回（`curl` 对照 `(52) Empty reply from server`）。
   报价因此改走 `ulist.np/get`。
+- **空回的归因是代理链路，不是东财边缘**（2026-10-23 16 枪二次实测）：连败时 connect 均 3 ms 级
+  成功、total 0.15-0.31 s、`curl (52) Empty reply from server` / `http=000 bytes=0`，而 `remote_ip`
+  全是本机代理 fake-ip `198.18.0.167`（系统代理 `127.0.0.1:7890`）；同刻 push2 与 push2his 一起
+  空回、腾讯 200。东财边缘在失败时刻的行为未验证，换东财主机/域名无效。
 - **对突发并发极敏感**：2026-10-14 实测在飞 4 就触发「TCP+TLS 建连成功、服务端约 70 ms 后直接断连、
   无 HTTP 响应」，且失效面会从路径级扩到 `push2` 域全路径、持续 ≥12 分钟；2026-09-08 另有整 IP
   断开约 20 分钟的先例。客户端轮询应保持 ≥60 s 量级，**不要拿它跑批量探测**。

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-import { EASTMONEY_KLINE_MAX_BARS, EastmoneyMarket, EastmoneyRestClient, EastmoneyRestOptions, INTERVAL_VOCABULARY, Interval, Kline, Ticker, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs } from "./rest.js";
+import { EASTMONEY_KLINE_MAX_BARS, EastmoneyMarket, EastmoneyRestClient, EastmoneyRestOptions, INTERVAL_VOCABULARY, Interval, Kline, Ticker, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyNetworkLimits, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs } from "./rest.js";
 import { Context, Service } from "@deepseek-ai/cordis";
 import Schema from "@deepseek-ai/schemastery";
 import { Disposable, Interval as Interval$1, Kline as Kline$1, KlineCapability, MarketDataService, SouthboundHoldingHistory, Ticker as Ticker$1 } from "@dshtrading/api";
@@ -42,4 +42,4 @@ declare const ROUTER_PROVIDER = "eastmoney";
 declare function routeAllows(ctx: Context, config: Config, market: 'cn' | 'hk'): boolean;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, EASTMONEY_KLINE_MAX_BARS, EastmoneyMarket, EastmoneyMarketDataService, EastmoneyRestClient, EastmoneyRestOptions, INTERVAL_VOCABULARY, type Interval, type Kline, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, TRADING_HK_MARKET_DATA_KEY, type Ticker, TradingServiceError, apply, eastmoneyKlineCapabilities, eastmoneyPriceScale, mapIntervalToKlt, marketDataKey, name, parseIntervalMs, parseReportDateToUtcMs, routeAllows, toEastmoneySecid, utc8WallTimeToEpochMs };
+export { Config, EASTMONEY_KLINE_MAX_BARS, EastmoneyMarket, EastmoneyMarketDataService, EastmoneyRestClient, EastmoneyRestOptions, INTERVAL_VOCABULARY, type Interval, type Kline, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, TRADING_HK_MARKET_DATA_KEY, type Ticker, TradingServiceError, apply, eastmoneyKlineCapabilities, eastmoneyNetworkLimits, eastmoneyPriceScale, mapIntervalToKlt, marketDataKey, name, parseIntervalMs, parseReportDateToUtcMs, routeAllows, toEastmoneySecid, utc8WallTimeToEpochMs };

package/lib/index.js

@@ -1,4 +1,4 @@
-import { EASTMONEY_KLINE_MAX_BARS, EastmoneyRestClient, INTERVAL_VOCABULARY, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs } from "./rest.js";
+import { EASTMONEY_KLINE_MAX_BARS, EastmoneyRestClient, INTERVAL_VOCABULARY, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyNetworkLimits, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs } from "./rest.js";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import Schema from "@deepseek-ai/schemastery";
@@ -125,4 +125,4 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { Config, EASTMONEY_KLINE_MAX_BARS, EastmoneyMarketDataService, EastmoneyRestClient, INTERVAL_VOCABULARY, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, TRADING_HK_MARKET_DATA_KEY, TradingServiceError, apply, eastmoneyKlineCapabilities, eastmoneyPriceScale, mapIntervalToKlt, marketDataKey, name, parseIntervalMs, parseReportDateToUtcMs, routeAllows, toEastmoneySecid, utc8WallTimeToEpochMs };
+export { Config, EASTMONEY_KLINE_MAX_BARS, EastmoneyMarketDataService, EastmoneyRestClient, INTERVAL_VOCABULARY, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, TRADING_HK_MARKET_DATA_KEY, TradingServiceError, apply, eastmoneyKlineCapabilities, eastmoneyNetworkLimits, eastmoneyPriceScale, mapIntervalToKlt, marketDataKey, name, parseIntervalMs, parseReportDateToUtcMs, routeAllows, toEastmoneySecid, utc8WallTimeToEpochMs };

package/lib/resilience.d.ts

@@ -0,0 +1,15 @@
+//#region src/resilience.d.ts
+/**
+ * @dshtrading/connector-eastmoney/resilience
+ * 请求通道的韧性缝：注入式时钟（固定冷却与整通硬截止）+ 按主机的短期熔断（负缓存）。
+ * 只有 rest.ts 的 requestJson 消费它——一个事实只有一个家。
+ */
+/** 注入式时钟：冷却等待与整通硬截止都读它，单测据此断言而不真等。 */
+interface EastmoneyClock {
+  /** 当前时刻（ms）。 */
+  now(): number;
+  /** 等待 ms 毫秒。 */
+  sleep(ms: number): Promise<void>;
+}
+//#endregion
+export { EastmoneyClock };

package/lib/resilience.js

@@ -0,0 +1,46 @@
+//#region src/resilience.ts
+/** 生产用时钟：真实时间与真实 timer。 */
+const systemClock = {
+	now: () => Date.now(),
+	sleep: (ms) => new Promise((resolve) => {
+		setTimeout(resolve, ms);
+	})
+};
+/**
+* 熔断键：URL → 主机。粒度按 host，即 push2 / push2his / searchapi / datacenter-web 各自独立
+* ——按 host 是最小诚实的粒度，不会让数据中心接口被行情故障连坐。构造出来的 URL 都能解析；
+* 解析失败时退回原串，不把两个无法解析的 URL 静默并成同一个键。
+*/
+function hostOf(url) {
+	try {
+		return new URL(url).host;
+	} catch {
+		return url;
+	}
+}
+/**
+* 按主机的短期负缓存（熔断）：一次整通网络级失败把该主机记成不可用，窗口内对该主机的调用
+* 零网络请求直接失败，到期自动恢复（读时即过期，不需要定时器），任一成功即清零。
+*/
+var HostCircuitBreaker = class {
+	/** 主机 → 熔断到期时刻（ms，与注入时钟同源）。 */
+	openUntil = /* @__PURE__ */ new Map();
+	/** 熔断中返回剩余毫秒数（>0）；未熔断或窗口已过返回 undefined。 */
+	remaining(host, now) {
+		const until = this.openUntil.get(host);
+		if (until === void 0) return void 0;
+		const leftMs = until - now;
+		if (leftMs > 0) return leftMs;
+		this.openUntil.delete(host);
+	}
+	/** 打开该主机的熔断窗口：now + ttlMs 之前对该主机一律零请求失败。 */
+	trip(host, now, ttlMs) {
+		this.openUntil.set(host, now + ttlMs);
+	}
+	/** 任一成功即清零：在飞的兄弟请求成功可推翻另一个请求刚为同一主机打开的窗口。 */
+	clear(host) {
+		this.openUntil.delete(host);
+	}
+};
+//#endregion
+export { HostCircuitBreaker, hostOf, systemClock };

package/lib/rest.d.ts

@@ -1,3 +1,4 @@
+import { EastmoneyClock } from "./resilience.js";
 import { Interval as Interval$1, Kline as Kline$1, KlineCapability, SouthboundHoldingHistory, Ticker as Ticker$1, TradingErrorCode } from "@dshtrading/api";
 //#region src/rest.d.ts
 declare class TradingServiceError extends Error {
@@ -58,6 +59,14 @@ declare function toEastmoneySecid(symbol: string, market?: EastmoneyMarket): {
   canonical: string;
   market: EastmoneyMarket;
 };
+/**
+ * 按域取网络口径：报表域（datacenter-web）用 DATACENTER_*，其余主机用行情那套。
+ * 导出是为了让用例直接断言这条分界，而不必等真实 8 s 计时。
+ */
+declare function eastmoneyNetworkLimits(host: string, dataCenterHost: string): {
+  timeoutMs: number;
+  budgetMs: number;
+};
 interface EastmoneyRestOptions {
   baseUrl?: string;
   historyBaseUrl?: string;
@@ -67,6 +76,15 @@ interface EastmoneyRestOptions {
   fetchImpl?: typeof fetch;
   /** 本实例服务的市场（形态解析与价格倍率都按它分流；缺省 cn）。 */
   market?: EastmoneyMarket;
+  /** 单枪超时（ms），缺省 2000：挂住的请求到点 abort 成 TRADING_NETWORK，不存在无上界的等待。 */
+  timeoutMs?: number;
+  /**
+   * 显式覆盖「一次取数整通硬截止」（ms）。不传时按域取缺省：行情域 3000、报表域
+   * （datacenter-web）20000——分界理由见 DATACENTER_* 常量。
+   */
+  requestBudgetMs?: number;
+  /** 时钟注入（固定冷却的 sleep 与整通硬截止计时都读它）；缺省真实 timer。 */
+  clock?: EastmoneyClock;
 }
 declare class EastmoneyRestClient {
   readonly baseUrl: string;
@@ -77,9 +95,46 @@ declare class EastmoneyRestClient {
   /** 本实例的市场（cn/hk 单包双实例；形态解析必须与注册市场一致）。 */
   readonly market: EastmoneyMarket;
   private readonly fetchImpl;
+  /** 单枪超时的显式覆盖（ms）；未给时按域取缺省。 */
+  private readonly timeoutMsOverride;
+  /** 整通硬截止的显式覆盖（ms）；未给时按域取缺省。 */
+  private readonly requestBudgetMsOverride;
+  /** 请求通道时钟（冷却与整通截止）。 */
+  private readonly clock;
+  /** 按主机的短期熔断（一次整通网络级失败后该主机静默 CIRCUIT_OPEN_MS）。 */
+  private readonly circuit;
   /** 降级派生快照的 60s TTL 缓存（键=secid；只在降级分支读写，见 DERIVED_QUOTE_TTL_MS）。 */
   private readonly derivedQuoteCache;
   constructor(options?: EastmoneyRestOptions);
+  /**
+   * 单次 GET + JSON，带**单枪超时**：超时盖的是**整枪**——建连、响应头与**响应体解析**合成一个
+   * promise 与超时竞速（照 connector-tencent 的 #fetchWithTimeout 的 timeoutMs + AbortController
+   * 范式，并补上那边只盖到 fetch 返回、没盖住 body 读取的缺口）。到点以 TRADING_NETWORK +
+   * `request timed out after <n>ms` 终结这一枪且保持可重试，故「200 头已到、body 永不结束」这类
+   * 挂住同样受 3 枪上界与整通硬截止约束，不存在无上界的等待。
+   *
+   * 网络级异常（undici `fetch failed` / 服务端收到即断的空回 / 超时）抛 TRADING_NETWORK 并标为
+   * 可重试；HTTP 非 2xx 抛 TRADING_UPSTREAM_ERROR、解析失败抛 TRADING_NETWORK（后两者不可重试
+   * ——4xx/5xx 与 WAF/HTML 错误页不是主机抖动）。
+   */
+  private requestOnce;
+  /** 该主机的网络口径：显式覆盖优先，其次按域（报表域 datacenter-web 见 DATACENTER_* 常量）。 */
+  private networkLimits;
+  /**
+   * 取 JSON：**有界重试 + 按主机短期熔断**（2026-10-23 二次实测口径）。
+   *
+   * 实测形态是「连接建立之后的 HTTP 空回」（connect 3ms 级成功、total 0.15-0.31s、curl (52)
+   * Empty reply / http=000 bytes=0），不是 connect 失败也不是超时；最长连败 6 枪跨 22.7 秒，
+   * 恢复一次后又再度失败。故：
+   *   - 只有网络级可重试失败才重试，最多 MAX_ATTEMPTS 枪（硬上界 3）；
+   *   - 重试之间是**固定**冷却 RETRY_COOLDOWN_MS（不是退避、不递增）；
+   *   - 一次取数整通有硬截止（含冷却与全部枪）：行情域 REQUEST_BUDGET_MS、报表域
+   *     DATACENTER_BUDGET_MS（2026-10-27 起按域分口径，见该常量注释）；剩不下「一次冷却 +
+   *     下一枪」就直接收尾，枪不会越过截止点，也就不存在续命；
+   *   - 整通失败后把**该主机**记进熔断窗口 CIRCUIT_OPEN_MS，窗口内对该主机的调用零网络请求
+   *     立即抛 TRADING_NETWORK，到期自动恢复，任一成功即清零；
+   *   - HTTP 非 2xx 与 JSON 解析失败不可重试、也**不打开**熔断（一个 404/WAF 页不是主机故障）。
+   */
   private requestJson;
   getTicker(symbol: string): Promise<Ticker$1>;
   /**
@@ -165,4 +220,4 @@ declare class EastmoneyRestClient {
   getSouthboundHoldings(symbol: string): Promise<SouthboundHoldingHistory>;
 }
 //#endregion
-export { EASTMONEY_KLINE_MAX_BARS, EastmoneyMarket, EastmoneyRestClient, EastmoneyRestOptions, INTERVAL_VOCABULARY, type Interval$1 as Interval, type Kline$1 as Kline, type Ticker$1 as Ticker, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs };
+export { EASTMONEY_KLINE_MAX_BARS, EastmoneyMarket, EastmoneyRestClient, EastmoneyRestOptions, INTERVAL_VOCABULARY, type Interval$1 as Interval, type Kline$1 as Kline, type Ticker$1 as Ticker, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyNetworkLimits, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs };

package/lib/rest.js

@@ -1,3 +1,4 @@
+import { HostCircuitBreaker, hostOf, systemClock } from "./resilience.js";
 //#region src/rest.ts
 var TradingServiceError = class extends Error {
 	code;
@@ -217,6 +218,39 @@ function toEastmoneySecid(symbol, market = "cn") {
 	};
 }
 /**
+* 请求通道的硬上界（2026-10-23 实测口径，见 .agents/notes/implemented/bug-fix/
+* 2026-10-23-tencent-kline-host-fallback-and-eastmoney-network-retry.md）：单枪超时、枪数上界、
+* 固定冷却、一次取数整通硬截止、熔断窗口。每个都是硬数字，不随负载或失败次数变化。
+*/
+const DEFAULT_TIMEOUT_MS = 2e3;
+const MAX_ATTEMPTS = 3;
+const RETRY_COOLDOWN_MS = 200;
+const REQUEST_BUDGET_MS = 3e3;
+const CIRCUIT_OPEN_MS = 3e4;
+/**
+* 报表域（datacenter-web）单独一套口径，与行情域的 2s/3s 分开。
+*
+* 报表端点是分页整表：pageSize 上限 1000、报文几百 KB，比行情响应大两个数量级。用行情
+* 那套「快速判别空回」的 2s/3s 会把可达端点判成故障——2026-10-27 CI 实测：GitHub runner
+* 上首枪就吃满 2000ms 单枪上限、剩 772ms 的第二枪又超时；而 400 KB 报文在 1 Mbps 链路上
+* 本身就要约 3.2 s，弱网终端同样过不去。行情域口径不变（空回判别靠快）。
+*/
+const DATACENTER_TIMEOUT_MS = 8e3;
+const DATACENTER_BUDGET_MS = 2e4;
+/**
+* 按域取网络口径：报表域（datacenter-web）用 DATACENTER_*，其余主机用行情那套。
+* 导出是为了让用例直接断言这条分界，而不必等真实 8 s 计时。
+*/
+function eastmoneyNetworkLimits(host, dataCenterHost) {
+	return host === dataCenterHost ? {
+		timeoutMs: DATACENTER_TIMEOUT_MS,
+		budgetMs: DATACENTER_BUDGET_MS
+	} : {
+		timeoutMs: DEFAULT_TIMEOUT_MS,
+		budgetMs: REQUEST_BUDGET_MS
+	};
+}
+/**
 * 东财数据中心「返回数据为空」业务码（2026-10-13 实测）：非港股通标的与
 * pageNumber 越界都返回 `{ result: null, success: false, code: 9201,
 * message: "返回数据为空" }`，HTTP 200。它不是故障，是「该标的无此序列」，
@@ -270,6 +304,14 @@ var EastmoneyRestClient = class {
 	/** 本实例的市场（cn/hk 单包双实例；形态解析必须与注册市场一致）。 */
 	market;
 	fetchImpl;
+	/** 单枪超时的显式覆盖（ms）；未给时按域取缺省。 */
+	timeoutMsOverride;
+	/** 整通硬截止的显式覆盖（ms）；未给时按域取缺省。 */
+	requestBudgetMsOverride;
+	/** 请求通道时钟（冷却与整通截止）。 */
+	clock;
+	/** 按主机的短期熔断（一次整通网络级失败后该主机静默 CIRCUIT_OPEN_MS）。 */
+	circuit = new HostCircuitBreaker();
 	/** 降级派生快照的 60s TTL 缓存（键=secid；只在降级分支读写，见 DERIVED_QUOTE_TTL_MS）。 */
 	derivedQuoteCache = /* @__PURE__ */ new Map();
 	constructor(options = {}) {
@@ -279,19 +321,125 @@ var EastmoneyRestClient = class {
 		this.dataCenterBaseUrl = options.dataCenterBaseUrl ?? "https://datacenter-web.eastmoney.com";
 		this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
 		this.market = options.market ?? "cn";
+		this.timeoutMsOverride = options.timeoutMs;
+		this.requestBudgetMsOverride = options.requestBudgetMs;
+		this.clock = options.clock ?? systemClock;
 	}
-	async requestJson(url, referer = "https://quote.eastmoney.com/") {
+	/**
+	* 单次 GET + JSON，带**单枪超时**：超时盖的是**整枪**——建连、响应头与**响应体解析**合成一个
+	* promise 与超时竞速（照 connector-tencent 的 #fetchWithTimeout 的 timeoutMs + AbortController
+	* 范式，并补上那边只盖到 fetch 返回、没盖住 body 读取的缺口）。到点以 TRADING_NETWORK +
+	* `request timed out after <n>ms` 终结这一枪且保持可重试，故「200 头已到、body 永不结束」这类
+	* 挂住同样受 3 枪上界与整通硬截止约束，不存在无上界的等待。
+	*
+	* 网络级异常（undici `fetch failed` / 服务端收到即断的空回 / 超时）抛 TRADING_NETWORK 并标为
+	* 可重试；HTTP 非 2xx 抛 TRADING_UPSTREAM_ERROR、解析失败抛 TRADING_NETWORK（后两者不可重试
+	* ——4xx/5xx 与 WAF/HTML 错误页不是主机抖动）。
+	*/
+	async requestOnce(url, referer, timeoutMs) {
+		/** 超时口径的唯一出口：可重试，消息带毫秒数，便于把事故归因到本枪。 */
+		const timedOut = () => ({
+			ok: false,
+			retryable: true,
+			error: new TradingServiceError("TRADING_NETWORK", `Eastmoney network error: request timed out after ${timeoutMs}ms`)
+		});
+		const controller = new AbortController();
+		const attempt = async () => {
+			let res;
+			try {
+				res = await this.fetchImpl(url, {
+					headers: {
+						"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko)",
+						"Referer": referer
+					},
+					signal: controller.signal
+				});
+			} catch (err) {
+				if (controller.signal.aborted) return timedOut();
+				return {
+					ok: false,
+					retryable: true,
+					error: new TradingServiceError("TRADING_NETWORK", `Eastmoney network error: ${err instanceof Error ? err.message : String(err)}`, err)
+				};
+			}
+			if (!res.ok) return {
+				ok: false,
+				retryable: false,
+				error: new TradingServiceError("TRADING_UPSTREAM_ERROR", `Eastmoney HTTP request failed: status ${res.status} ${res.statusText}`)
+			};
+			try {
+				return {
+					ok: true,
+					body: await res.json()
+				};
+			} catch (err) {
+				if (controller.signal.aborted) return timedOut();
+				return {
+					ok: false,
+					retryable: false,
+					error: new TradingServiceError("TRADING_NETWORK", `Eastmoney network error: ${err instanceof Error ? err.message : String(err)}`, err)
+				};
+			}
+		};
+		let timer;
+		const timeout = new Promise((resolve) => {
+			timer = setTimeout(() => {
+				controller.abort(new DOMException(`request timed out after ${timeoutMs}ms`, "TimeoutError"));
+				resolve(timedOut());
+			}, timeoutMs);
+		});
 		try {
-			const res = await this.fetchImpl(url, { headers: {
-				"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko)",
-				"Referer": referer
-			} });
-			if (!res.ok) throw new TradingServiceError("TRADING_UPSTREAM_ERROR", `Eastmoney HTTP request failed: status ${res.status} ${res.statusText}`);
-			return await res.json();
-		} catch (err) {
-			if (err instanceof TradingServiceError) throw err;
-			throw new TradingServiceError("TRADING_NETWORK", `Eastmoney network error: ${err instanceof Error ? err.message : String(err)}`, err);
+			return await Promise.race([attempt(), timeout]);
+		} finally {
+			clearTimeout(timer);
+		}
+	}
+	/** 该主机的网络口径：显式覆盖优先，其次按域（报表域 datacenter-web 见 DATACENTER_* 常量）。 */
+	networkLimits(host) {
+		const byHost = eastmoneyNetworkLimits(host, hostOf(this.dataCenterBaseUrl));
+		return {
+			timeoutMs: this.timeoutMsOverride ?? byHost.timeoutMs,
+			budgetMs: this.requestBudgetMsOverride ?? byHost.budgetMs
+		};
+	}
+	/**
+	* 取 JSON：**有界重试 + 按主机短期熔断**（2026-10-23 二次实测口径）。
+	*
+	* 实测形态是「连接建立之后的 HTTP 空回」（connect 3ms 级成功、total 0.15-0.31s、curl (52)
+	* Empty reply / http=000 bytes=0），不是 connect 失败也不是超时；最长连败 6 枪跨 22.7 秒，
+	* 恢复一次后又再度失败。故：
+	*   - 只有网络级可重试失败才重试，最多 MAX_ATTEMPTS 枪（硬上界 3）；
+	*   - 重试之间是**固定**冷却 RETRY_COOLDOWN_MS（不是退避、不递增）；
+	*   - 一次取数整通有硬截止（含冷却与全部枪）：行情域 REQUEST_BUDGET_MS、报表域
+	*     DATACENTER_BUDGET_MS（2026-10-27 起按域分口径，见该常量注释）；剩不下「一次冷却 +
+	*     下一枪」就直接收尾，枪不会越过截止点，也就不存在续命；
+	*   - 整通失败后把**该主机**记进熔断窗口 CIRCUIT_OPEN_MS，窗口内对该主机的调用零网络请求
+	*     立即抛 TRADING_NETWORK，到期自动恢复，任一成功即清零；
+	*   - HTTP 非 2xx 与 JSON 解析失败不可重试、也**不打开**熔断（一个 404/WAF 页不是主机故障）。
+	*/
+	async requestJson(url, referer = "https://quote.eastmoney.com/") {
+		const host = hostOf(url);
+		const openForMs = this.circuit.remaining(host, this.clock.now());
+		if (openForMs !== void 0) throw new TradingServiceError("TRADING_NETWORK", `Eastmoney ${host}: circuit open, ${openForMs}ms remaining`);
+		const limits = this.networkLimits(host);
+		const deadlineAt = this.clock.now() + limits.budgetMs;
+		let lastError;
+		for (let shot = 1; shot <= MAX_ATTEMPTS; shot += 1) {
+			const remainingMs = deadlineAt - this.clock.now();
+			if (remainingMs <= 0) break;
+			const result = await this.requestOnce(url, referer, Math.min(limits.timeoutMs, remainingMs));
+			if (result.ok) {
+				this.circuit.clear(host);
+				return result.body;
+			}
+			if (!result.retryable) throw result.error;
+			lastError = result.error;
+			if (shot === MAX_ATTEMPTS) break;
+			if (deadlineAt - this.clock.now() <= RETRY_COOLDOWN_MS) break;
+			await this.clock.sleep(RETRY_COOLDOWN_MS);
 		}
+		this.circuit.trip(host, this.clock.now(), CIRCUIT_OPEN_MS);
+		throw lastError ?? new TradingServiceError("TRADING_NETWORK", `Eastmoney ${host}: request budget exhausted`);
 	}
 	async getTicker(symbol) {
 		const { secid, canonical, market } = toEastmoneySecid(symbol, this.market);
@@ -600,4 +748,4 @@ var EastmoneyRestClient = class {
 	}
 };
 //#endregion
-export { EASTMONEY_KLINE_MAX_BARS, EastmoneyRestClient, INTERVAL_VOCABULARY, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs };
+export { EASTMONEY_KLINE_MAX_BARS, EastmoneyRestClient, INTERVAL_VOCABULARY, TradingServiceError, eastmoneyKlineCapabilities, eastmoneyNetworkLimits, eastmoneyPriceScale, mapIntervalToKlt, parseIntervalMs, parseReportDateToUtcMs, toEastmoneySecid, utc8WallTimeToEpochMs };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-eastmoney",
   "description": "东方财富公开行情连接器（cn + hk 单包双市场）：经 push2 / push2his 公共 REST 提供 tradingCnMarketData / tradingHkMarketData 与 <market>_get_ticker / <market>_get_klines 工具，免密、无官方授权，纯行情无交易通道。",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,12 +21,12 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.6.3"
+    "@dshtrading/api": "^0.7.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": ">=4.0.0",
-    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.2",
-    "@deepseek-ai/schemastery": ">=3.18.0"
+    "@deepseek-ai/cordis": ">=4.1.0",
+    "@deepseek-ai/dsh-tools": ">=0.2.2-rc.1",
+    "@deepseek-ai/schemastery": ">=3.19.0"
   },
   "devDependencies": {
     "tsdown": "^0.22.0",