@dshtrading/connector-hithink 0.2.1 → 0.4.0

package/lib/dataplane.js

@@ -9,9 +9,11 @@ const ROUTER_PROVIDER = "hithink";
 const MARKET = "cn";
 function apply(ctx, config) {
 	if (!config.enabled) return;
-	const apiKey = process.env[config.apiKeyRef];
+	const apiKeyProvider = () => {
+		return (ctx.get?.("tradingMarketRouter", false))?.getCredential?.("hithink")?.apiKey || process.env[config.apiKeyRef];
+	};
 	const registry = resolveMarketDataRegistry(ctx);
-	const opts = apiKey ? { apiKey } : {};
+	const opts = { apiKeyProvider };
 	if (registry === void 0) {
 		new HiThinkMarketDataService(ctx, opts);
 		return;

package/lib/futures-dataplane.d.ts

@@ -0,0 +1,7 @@
+import { Config } from "./index.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/futures-dataplane.d.ts
+declare const inject: string[];
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { apply, inject };

package/lib/futures-dataplane.js

@@ -0,0 +1,26 @@
+import { HiThinkFuturesMarketDataService, TRADING_FUTURES_MARKET_DATA_KEY } from "./futures.js";
+//#region src/futures-dataplane.ts
+const inject = [];
+function resolveMarketDataRegistry(ctx) {
+	const candidate = ctx.get?.("tradingMarketDataRegistry", false);
+	return candidate !== void 0 ? candidate : void 0;
+}
+const ROUTER_PROVIDER = "hithink";
+const MARKET = "futures";
+function apply(ctx, config) {
+	if (!config.enabled) return;
+	const apiKeyProvider = () => {
+		return (ctx.get?.("tradingMarketRouter", false))?.getCredential?.("hithink")?.apiKey || process.env[config.apiKeyRef];
+	};
+	const registry = resolveMarketDataRegistry(ctx);
+	const opts = { apiKeyProvider };
+	if (registry === void 0) {
+		new HiThinkFuturesMarketDataService(ctx, opts);
+		return;
+	}
+	const inner = ctx.isolate(TRADING_FUTURES_MARKET_DATA_KEY);
+	const service = new HiThinkFuturesMarketDataService(inner, opts);
+	ctx.effect(() => registry.register(MARKET, ROUTER_PROVIDER, service));
+}
+//#endregion
+export { apply, inject };

package/lib/futures-plugin.d.ts

@@ -0,0 +1,8 @@
+import { Config } from "./index.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/futures-plugin.d.ts
+declare const name = "dsh-trading-futures-connector-hithink";
+declare const inject: string[];
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, apply, inject, name };

package/lib/futures-plugin.js

@@ -0,0 +1,14 @@
+import { Config } from "./index.js";
+import { HiThinkFuturesMarketDataService } from "./futures.js";
+//#region src/futures-plugin.ts
+const name = "dsh-trading-futures-connector-hithink";
+const inject = [];
+function apply(ctx, config) {
+	if (!config.enabled) return;
+	const apiKeyProvider = () => {
+		return (ctx.get?.("tradingMarketRouter", false))?.getCredential?.("hithink")?.apiKey || process.env[config.apiKeyRef];
+	};
+	new HiThinkFuturesMarketDataService(ctx, { apiKeyProvider });
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/futures.d.ts

@@ -0,0 +1,44 @@
+import { HiThinkRestOptions } from "./rest.js";
+import { Context, Service } from "@deepseek-ai/cordis";
+import { Disposable, Interval, Kline, MarketDataService, Ticker } from "@dshtrading/api";
+//#region src/futures.d.ts
+declare const TRADING_FUTURES_MARKET_DATA_KEY = "tradingFuturesMarketData";
+/** 规范化期货代码输入（大写、去空白；带/不带交易所后缀均透传，后缀歧义交由上游裁决）。 */
+declare function normalizeFuturesCode(input: string): string;
+/**
+ * 中金所(CFFEX) 8888「加权」连续码：上游代码表/检索可见，但行情端点不供数
+ * （daily 返回空 item、intraday 返回 code=5003；2026-09-14 实测 IF8888.CFE/
+ * IH8888.CFE/T8888.CFE）。其他交易所的 8888 加权码（如 RB8888.SHF）与中金所
+ * 主连 `…ZL.CFE` 均有完整数据，故只剔除 CFE 后缀的 8888。
+ * 用于列表/检索，避免用户加入无行情标的。
+ */
+declare function isUnpricedCffexWeighted(symbol: string): boolean;
+declare class HiThinkFuturesMarketDataService extends Service implements MarketDataService {
+  private readonly client;
+  constructor(ctx: Context, options?: HiThinkRestOptions, serviceName?: string);
+  /**
+   * 最新价：分时末点优先（盘中即时），回落日K最近根（收盘价）。
+   * 两者都没有数据时抛 TRADING_UNSUPPORTED_SYMBOL——上游目录里存在但行情端点
+   * 不供数的代码（实测中金所 8888 加权码）不能被伪造成 price=0 的假行情。
+   */
+  getTicker(symbol: string): Promise<Ticker>;
+  /**
+   * 期货 K 线：1d 直连日K；3d/1w/1M 由日K本地聚合；分钟周期由当日分时点聚合
+   * （上游仅提供当日分时，分钟线不覆盖历史交易日）。
+   */
+  getKlines(symbol: string, interval?: Interval, limit?: number): Promise<Kline[]>;
+  /**
+   * 期货标的名册/检索（GUI 添加自选对话框）。带 query 走跨资产检索（asset_type=futures），
+   * 无 query 返回全量代码表（过滤 last_trade_date 已过期的合约）。
+   * 两个分支都剔除上游无行情的中金所 8888 加权码（isUnpricedCffexWeighted）。
+   */
+  listInstruments(query?: string): Promise<Array<{
+    symbol: string;
+    name: string;
+  }>>;
+  subscribeTicker(symbol: string, cb: (ticker: Ticker) => void, options?: {
+    intervalMs?: number;
+  }): Disposable;
+}
+//#endregion
+export { HiThinkFuturesMarketDataService, TRADING_FUTURES_MARKET_DATA_KEY, isUnpricedCffexWeighted, normalizeFuturesCode };

package/lib/futures.js

@@ -0,0 +1,117 @@
+import { HiThinkRestClient, TradingServiceError } from "./rest.js";
+import { aggregateDailyKlines, aggregateMinutePoints, dailyBarToKline } from "./kline.js";
+import { Service } from "@deepseek-ai/cordis";
+//#region src/futures.ts
+const TRADING_FUTURES_MARKET_DATA_KEY = "tradingFuturesMarketData";
+/** 期货分钟周期 → 分时点聚合步长（分钟）。上游仅提供当日分时，分钟线仅覆盖当日。 */
+const MINUTE_INTERVAL_STEPS = {
+	"1m": 1,
+	"5m": 5,
+	"15m": 15,
+	"30m": 30,
+	"1h": 60,
+	"2h": 120,
+	"4h": 240,
+	"6h": 360,
+	"8h": 480,
+	"12h": 720
+};
+/** 规范化期货代码输入（大写、去空白；带/不带交易所后缀均透传，后缀歧义交由上游裁决）。 */
+function normalizeFuturesCode(input) {
+	return input.trim().toUpperCase();
+}
+/**
+* 中金所(CFFEX) 8888「加权」连续码：上游代码表/检索可见，但行情端点不供数
+* （daily 返回空 item、intraday 返回 code=5003；2026-09-14 实测 IF8888.CFE/
+* IH8888.CFE/T8888.CFE）。其他交易所的 8888 加权码（如 RB8888.SHF）与中金所
+* 主连 `…ZL.CFE` 均有完整数据，故只剔除 CFE 后缀的 8888。
+* 用于列表/检索，避免用户加入无行情标的。
+*/
+function isUnpricedCffexWeighted(symbol) {
+	return /^[A-Z]+8888\.CFE$/i.test(symbol.trim());
+}
+var HiThinkFuturesMarketDataService = class extends Service {
+	client;
+	constructor(ctx, options = {}, serviceName = TRADING_FUTURES_MARKET_DATA_KEY) {
+		super(ctx, serviceName);
+		this.client = new HiThinkRestClient(options);
+	}
+	/**
+	* 最新价：分时末点优先（盘中即时），回落日K最近根（收盘价）。
+	* 两者都没有数据时抛 TRADING_UNSUPPORTED_SYMBOL——上游目录里存在但行情端点
+	* 不供数的代码（实测中金所 8888 加权码）不能被伪造成 price=0 的假行情。
+	*/
+	async getTicker(symbol) {
+		const thscode = normalizeFuturesCode(symbol);
+		const dailyBars = await this.client.getFuturesDailyKlines(thscode, 2);
+		const lastDaily = dailyBars[dailyBars.length - 1];
+		const prevDaily = dailyBars.length >= 2 ? dailyBars[dailyBars.length - 2] : void 0;
+		let price = lastDaily?.close_price ?? void 0;
+		let timestamp = lastDaily?.timestamp ?? void 0;
+		try {
+			const points = ((await this.client.getFuturesIntraday(thscode))?.item ?? []).filter((p) => typeof p.timestamp === "number" && typeof p.price === "number");
+			const last = points[points.length - 1];
+			if (last) {
+				price = last.price;
+				timestamp = last.timestamp;
+			}
+		} catch {}
+		if (price === void 0 || timestamp === void 0) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `HiThink: no futures quote for ${thscode}; daily bars and intraday are both empty (upstream has no data for this code)`);
+		return {
+			symbol: thscode,
+			price,
+			...prevDaily?.close_price !== void 0 && prevDaily?.close_price !== null ? { prevClose: prevDaily.close_price } : {},
+			...lastDaily?.volume !== void 0 && lastDaily?.volume !== null ? { volume: lastDaily.volume } : {},
+			timestamp
+		};
+	}
+	/**
+	* 期货 K 线：1d 直连日K；3d/1w/1M 由日K本地聚合；分钟周期由当日分时点聚合
+	* （上游仅提供当日分时，分钟线不覆盖历史交易日）。
+	*/
+	async getKlines(symbol, interval = "1d", limit = 100) {
+		const thscode = normalizeFuturesCode(symbol);
+		const n = Math.max(1, Math.min(Number.isFinite(limit) ? Math.floor(limit) : 100, 1e3));
+		const minuteStep = MINUTE_INTERVAL_STEPS[interval];
+		if (minuteStep !== void 0) {
+			const points = ((await this.client.getFuturesIntraday(thscode))?.item ?? []).flatMap((p) => typeof p.timestamp === "number" && typeof p.price === "number" ? [{
+				timestamp: p.timestamp,
+				price: p.price,
+				volume: p.volume ?? 0
+			}] : []);
+			return aggregateMinutePoints(points, minuteStep).slice(-n);
+		}
+		const daily = (await this.client.getFuturesDailyKlines(thscode, interval === "1d" ? n : Math.min(n * 35, 1e3))).map((b) => dailyBarToKline(b.timestamp, b.open_price, b.high_price, b.low_price, b.close_price, b.volume ?? 0));
+		if (interval === "1d") return daily;
+		return aggregateDailyKlines(daily, interval).slice(-n);
+	}
+	/**
+	* 期货标的名册/检索（GUI 添加自选对话框）。带 query 走跨资产检索（asset_type=futures），
+	* 无 query 返回全量代码表（过滤 last_trade_date 已过期的合约）。
+	* 两个分支都剔除上游无行情的中金所 8888 加权码（isUnpricedCffexWeighted）。
+	*/
+	async listInstruments(query) {
+		const trimmed = query?.trim();
+		if (trimmed) return (await this.client.searchFuturesTickers(trimmed)).filter((item) => !isUnpricedCffexWeighted(item.thscode)).map((item) => ({
+			symbol: item.thscode,
+			name: item.name
+		}));
+		const items = await this.client.listFuturesTickers();
+		const todayKey = new Date(Date.now() + 288e5).toISOString().slice(0, 10);
+		return items.filter((item) => item.last_trade_date === null || item.last_trade_date === void 0 || item.last_trade_date >= todayKey).filter((item) => !isUnpricedCffexWeighted(item.thscode)).map((item) => ({
+			symbol: item.thscode,
+			name: item.name
+		}));
+	}
+	subscribeTicker(symbol, cb, options) {
+		const ms = Math.max(options?.intervalMs ?? 1e4, 3e3);
+		const tick = () => {
+			this.getTicker(symbol).then(cb, () => {});
+		};
+		tick();
+		const timer = setInterval(tick, ms);
+		return { dispose: () => clearInterval(timer) };
+	}
+};
+//#endregion
+export { HiThinkFuturesMarketDataService, TRADING_FUTURES_MARKET_DATA_KEY, isUnpricedCffexWeighted, normalizeFuturesCode };

package/lib/index.d.ts

@@ -1,5 +1,6 @@
-import { HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem } from "./types.js";
+import { HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkFuturesDailyData, HiThinkFuturesDailyItem, HiThinkFuturesIntradayData, HiThinkFuturesIntradayItem, HiThinkHistoricalData, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkMetaTickerData, HiThinkMetaTickerItem, HiThinkPriceBarItem, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem } from "./types.js";
 import { HiThinkRestClient, HiThinkRestOptions, TradingServiceError, normalizeThsCode } from "./rest.js";
+import { aggregateDailyKlines, aggregateMinutePoints, dailyBarToKline, shanghaiDateKey } from "./kline.js";
 import { Context, Service } from "@deepseek-ai/cordis";
 import Schema from "@deepseek-ai/schemastery";
 import { AuctionSnapshot, Disposable, Interval, Kline, LimitUpPoolItem, MarketDataService, StockFundamentals, Ticker } from "@dshtrading/api";
@@ -15,7 +16,12 @@ declare class HiThinkMarketDataService extends Service implements MarketDataServ
   private readonly client;
   constructor(ctx: Context, options?: HiThinkRestOptions, serviceName?: string);
   getTicker(symbol: string): Promise<Ticker>;
-  getKlines(_symbol: string, _interval?: Interval, _limit?: number): Promise<Kline[]>;
+  /**
+   * A 股 K 线。上游仅开放日线（高频分钟模块未开放外部接入）：
+   * 1d 直连 /api/a-share/prices/historical（前复权）；3d/1w/1M 由日线本地聚合；
+   * 分钟级周期抛 TRADING_UNSUPPORTED_INTERVAL（需分钟 K 时切换 cn provider 至 tencent 等）。
+   */
+  getKlines(symbol: string, interval?: Interval, limit?: number): Promise<Kline[]>;
   getStockFundamentals(symbol: string): Promise<StockFundamentals>;
   getAuctionSnapshot(symbol: string): Promise<AuctionSnapshot | undefined>;
   getLimitUpPool(options?: {
@@ -34,4 +40,4 @@ declare class HiThinkMarketDataService extends Service implements MarketDataServ
 }
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkMarketDataService, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkRestClient, HiThinkRestOptions, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, apply, name, normalizeThsCode };
+export { Config, HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkFuturesDailyData, HiThinkFuturesDailyItem, HiThinkFuturesIntradayData, HiThinkFuturesIntradayItem, HiThinkHistoricalData, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkMarketDataService, HiThinkMetaTickerData, HiThinkMetaTickerItem, HiThinkPriceBarItem, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkRestClient, HiThinkRestOptions, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, aggregateDailyKlines, aggregateMinutePoints, apply, dailyBarToKline, name, normalizeThsCode, shanghaiDateKey };

package/lib/index.js

@@ -1,4 +1,5 @@
 import { HiThinkRestClient, TradingServiceError, normalizeThsCode } from "./rest.js";
+import { aggregateDailyKlines, aggregateMinutePoints, dailyBarToKline, shanghaiDateKey } from "./kline.js";
 import { Service } from "@deepseek-ai/cordis";
 import Schema from "@deepseek-ai/schemastery";
 //#region src/index.ts
@@ -17,8 +18,17 @@ var HiThinkMarketDataService = class extends Service {
 	async getTicker(symbol) {
 		return this.client.getTicker(symbol);
 	}
-	async getKlines(_symbol, _interval = "1d", _limit = 100) {
-		throw new TradingServiceError("TRADING_NOT_IMPLEMENTED", "HiThink K-lines not supported yet");
+	/**
+	* A 股 K 线。上游仅开放日线（高频分钟模块未开放外部接入）：
+	* 1d 直连 /api/a-share/prices/historical（前复权）；3d/1w/1M 由日线本地聚合；
+	* 分钟级周期抛 TRADING_UNSUPPORTED_INTERVAL（需分钟 K 时切换 cn provider 至 tencent 等）。
+	*/
+	async getKlines(symbol, interval = "1d", limit = 100) {
+		const n = Math.max(1, Math.min(Number.isFinite(limit) ? Math.floor(limit) : 100, 1e3));
+		if (interval !== "1d" && interval !== "3d" && interval !== "1w" && interval !== "1M") throw new TradingServiceError("TRADING_UNSUPPORTED_INTERVAL", `HiThink A-share K-lines only support 1d/3d/1w/1M (upstream minute module not open); got ${interval}`);
+		const daily = (await this.client.getHistoricalDailyKlines(symbol, interval === "1d" ? n : Math.min(n * 35, 1e3))).map((b) => dailyBarToKline(b.date_ms, b.open_price, b.high_price, b.low_price, b.close_price, b.volume ?? 0));
+		if (interval === "1d") return daily;
+		return aggregateDailyKlines(daily, interval).slice(-n);
 	}
 	async getStockFundamentals(symbol) {
 		return this.client.getStockFundamentals(symbol);
@@ -47,8 +57,10 @@ var HiThinkMarketDataService = class extends Service {
 };
 function apply(ctx, config) {
 	if (!config.enabled) return;
-	const apiKey = process.env[config.apiKeyRef];
-	new HiThinkMarketDataService(ctx, apiKey ? { apiKey } : {});
+	const apiKeyProvider = () => {
+		return (ctx.get?.("tradingMarketRouter", false))?.getCredential?.("hithink")?.apiKey || process.env[config.apiKeyRef];
+	};
+	new HiThinkMarketDataService(ctx, { apiKeyProvider });
 }
 //#endregion
-export { Config, HiThinkMarketDataService, HiThinkRestClient, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, apply, name, normalizeThsCode };
+export { Config, HiThinkMarketDataService, HiThinkRestClient, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, aggregateDailyKlines, aggregateMinutePoints, apply, dailyBarToKline, name, normalizeThsCode, shanghaiDateKey };

package/lib/kline.d.ts

@@ -0,0 +1,16 @@
+import { Kline } from "@dshtrading/api";
+//#region src/kline.d.ts
+/** 东八区日期键（YYYY-MM-DD），月/周聚合与 last_trade_date 过滤用。 */
+declare function shanghaiDateKey(ms: number): string;
+/** 单位日K → 标准 Kline（closeTime = openTime + 1d - 1，与 eastmoney/tencent 约定一致）。 */
+declare function dailyBarToKline(openTime: number, open: number, high: number, low: number, close: number, volume: number): Kline;
+/** 日K序列按日历桶聚合（'3d' 按东八区日序 3 天分桶；'1w' ISO 周；'1M' 自然月）。 */
+declare function aggregateDailyKlines(daily: Kline[], interval: '3d' | '1w' | '1M'): Kline[];
+/** 分钟分桶聚合（分时点 → N 分钟 OHLC 条；volume 求和）。 */
+declare function aggregateMinutePoints(points: Array<{
+  timestamp: number;
+  price: number;
+  volume: number;
+}>, stepMinutes: number): Kline[];
+//#endregion
+export { aggregateDailyKlines, aggregateMinutePoints, dailyBarToKline, shanghaiDateKey };

package/lib/kline.js

@@ -0,0 +1,92 @@
+//#region src/kline.ts
+const DAY_MS = 864e5;
+const SHANGHAI_OFFSET_MS = 288e5;
+/** 东八区日序号（交易日零点 ms → 天数）。 */
+function shanghaiDay(ms) {
+	return Math.floor((ms + SHANGHAI_OFFSET_MS) / DAY_MS);
+}
+/** 东八区日期键（YYYY-MM-DD），月/周聚合与 last_trade_date 过滤用。 */
+function shanghaiDateKey(ms) {
+	const d = new Date(ms + SHANGHAI_OFFSET_MS);
+	return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, "0")}-${String(d.getUTCDate()).padStart(2, "0")}`;
+}
+/** ISO 周键（周一为一周起点，按东八区日界）。 */
+function isoWeekKey(ms) {
+	const d = new Date(ms + SHANGHAI_OFFSET_MS);
+	const t = Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+	const monday = t - (new Date(t).getUTCDay() + 6) % 7 * DAY_MS;
+	return String(monday);
+}
+/** 单位日K → 标准 Kline（closeTime = openTime + 1d - 1，与 eastmoney/tencent 约定一致）。 */
+function dailyBarToKline(openTime, open, high, low, close, volume) {
+	return {
+		openTime,
+		open,
+		high,
+		low,
+		close,
+		volume,
+		closeTime: openTime + DAY_MS - 1
+	};
+}
+/** 日K序列按日历桶聚合（'3d' 按东八区日序 3 天分桶；'1w' ISO 周；'1M' 自然月）。 */
+function aggregateDailyKlines(daily, interval) {
+	const buckets = /* @__PURE__ */ new Map();
+	for (const bar of daily) {
+		const key = interval === "1w" ? isoWeekKey(bar.openTime) : interval === "1M" ? shanghaiDateKey(bar.openTime).slice(0, 7) : String(Math.floor(shanghaiDay(bar.openTime) / 3));
+		const existing = buckets.get(key);
+		if (!existing) {
+			buckets.set(key, {
+				first: bar,
+				last: bar,
+				high: bar.high,
+				low: bar.low,
+				volume: bar.volume
+			});
+			continue;
+		}
+		existing.last = bar;
+		existing.high = Math.max(existing.high, bar.high);
+		existing.low = Math.min(existing.low, bar.low);
+		existing.volume += bar.volume;
+	}
+	return [...buckets.values()].map((b) => ({
+		openTime: b.first.openTime,
+		open: b.first.open,
+		high: b.high,
+		low: b.low,
+		close: b.last.close,
+		volume: b.volume,
+		closeTime: b.last.closeTime
+	}));
+}
+/** 分钟分桶聚合（分时点 → N 分钟 OHLC 条；volume 求和）。 */
+function aggregateMinutePoints(points, stepMinutes) {
+	const stepMs = stepMinutes * 6e4;
+	const buckets = /* @__PURE__ */ new Map();
+	for (const p of points) {
+		const openTime = Math.floor(p.timestamp / stepMs) * stepMs;
+		const existing = buckets.get(openTime);
+		if (!existing) {
+			buckets.set(openTime, {
+				openTime,
+				open: p.price,
+				high: p.price,
+				low: p.price,
+				close: p.price,
+				volume: p.volume
+			});
+			continue;
+		}
+		existing.high = Math.max(existing.high, p.price);
+		existing.low = Math.min(existing.low, p.price);
+		existing.close = p.price;
+		existing.volume += p.volume;
+	}
+	return [...buckets.values()].sort((a, b) => a.openTime - b.openTime).map((b) => ({
+		...b,
+		closeTime: b.openTime + stepMs - 1
+	}));
+}
+//#endregion
+export { aggregateDailyKlines, aggregateMinutePoints, dailyBarToKline, shanghaiDateKey };

package/lib/rest.d.ts

@@ -1,4 +1,4 @@
-import { HiThinkLadderData, HiThinkValuationData } from "./types.js";
+import { HiThinkFuturesDailyData, HiThinkFuturesIntradayData, HiThinkHistoricalData, HiThinkLadderData, HiThinkMetaTickerData, HiThinkValuationData } from "./types.js";
 import { AuctionSnapshot, LimitUpPoolItem, StockFundamentals, Ticker, TradingErrorCode } from "@dshtrading/api";
 //#region src/rest.d.ts
 declare class TradingServiceError extends Error {
@@ -7,6 +7,8 @@ declare class TradingServiceError extends Error {
 }
 interface HiThinkRestOptions {
   apiKey?: string | undefined;
+  /** 惰性凭证源（每次请求解析）：settings credentials 热切换与异步加载晚于插件 apply 时生效。 */
+  apiKeyProvider?: (() => string | undefined) | undefined;
   baseUrl?: string | undefined;
   fetchImpl?: typeof fetch | undefined;
   timeoutMs?: number | undefined;
@@ -15,10 +17,12 @@ interface HiThinkRestOptions {
 declare function normalizeThsCode(input: string): string;
 declare class HiThinkRestClient {
   private readonly apiKey?;
+  private readonly apiKeyProvider?;
   private readonly baseUrl;
   private readonly fetchImpl;
   private readonly timeoutMs;
   constructor(options?: HiThinkRestOptions);
+  private resolvedApiKey;
   private request;
   /** 获取最新行情快照。 */
   getTicker(symbol: string): Promise<Ticker>;
@@ -41,6 +45,19 @@ declare class HiThinkRestClient {
     symbol: string;
     name: string;
   }>>;
+  /**
+   * A 股历史日K（上游仅开放 1d，start/end 毫秒必填，窗口最长 10 年）。
+   * 以 end=now 反推覆盖窗口取数后截尾最近 limit 根（升序）。
+   */
+  getHistoricalDailyKlines(symbol: string, limit: number, adjust?: 'none' | 'forward' | 'backward'): Promise<HiThinkHistoricalData['item']>;
+  /** 期货日K（省略 start/end 返回最近 100 根；窗口模式可取更长序列）。 */
+  getFuturesDailyKlines(thscode: string, limit: number): Promise<HiThinkFuturesDailyData['item']>;
+  /** 期货当日分时点（session 缺省 intraday；非交易时段可能为空）。 */
+  getFuturesIntraday(thscode: string, session?: 'pre_market' | 'intraday' | 'post_market'): Promise<HiThinkFuturesIntradayData>;
+  /** 跨资产标的检索（期货用 asset_type=futures 过滤；q 支持 thscode/代码/中英文名称子串）。 */
+  searchFuturesTickers(keyword: string, limit?: number): Promise<HiThinkMetaTickerData['item']>;
+  /** 期货全量代码表（offset 分页取尽；由调用方过滤已到期合约）。 */
+  listFuturesTickers(): Promise<HiThinkMetaTickerData['item']>;
 }
 //#endregion
 export { HiThinkRestClient, HiThinkRestOptions, TradingServiceError, normalizeThsCode };

package/lib/rest.js

@@ -23,15 +23,20 @@ function normalizeThsCode(input) {
 }
 var HiThinkRestClient = class {
 	apiKey;
+	apiKeyProvider;
 	baseUrl;
 	fetchImpl;
 	timeoutMs;
 	constructor(options = {}) {
 		this.apiKey = options.apiKey ?? process.env.HITHINK_FINANCE_API_KEY ?? process.env.HITHINK_API_KEY;
+		this.apiKeyProvider = options.apiKeyProvider;
 		this.baseUrl = (options.baseUrl ?? "https://fuyao.aicubes.cn").replace(/\/+$/, "");
 		this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
 		this.timeoutMs = options.timeoutMs ?? 1e4;
 	}
+	resolvedApiKey() {
+		return this.apiKeyProvider?.() ?? this.apiKey;
+	}
 	async request(path, params = {}) {
 		const url = new URL(path, this.baseUrl);
 		for (const [k, v] of Object.entries(params)) if (v !== void 0) url.searchParams.set(k, String(v));
@@ -39,7 +44,8 @@ var HiThinkRestClient = class {
 			Accept: "application/json",
 			"User-Agent": "dsh-trading/0.1.0"
 		};
-		if (this.apiKey) headers["X-api-key"] = this.apiKey;
+		const apiKey = this.resolvedApiKey();
+		if (apiKey) headers["X-api-key"] = apiKey;
 		let res;
 		try {
 			res = await this.fetchImpl(url.toString(), {
@@ -149,6 +155,64 @@ var HiThinkRestClient = class {
 			name: item.name
 		}));
 	}
+	/**
+	* A 股历史日K（上游仅开放 1d，start/end 毫秒必填，窗口最长 10 年）。
+	* 以 end=now 反推覆盖窗口取数后截尾最近 limit 根（升序）。
+	*/
+	async getHistoricalDailyKlines(symbol, limit, adjust = "forward") {
+		const thscode = normalizeThsCode(symbol);
+		const end = Date.now();
+		const windowDays = Math.min(Math.ceil(limit * 1.7) + 7, 3650);
+		return ((await this.request("/api/a-share/prices/historical", {
+			thscode,
+			interval: "1d",
+			start: end - windowDays * 864e5,
+			end,
+			adjust
+		}))?.item ?? []).filter((b) => typeof b.date_ms === "number" && typeof b.close_price === "number").slice(-limit);
+	}
+	/** 期货日K（省略 start/end 返回最近 100 根；窗口模式可取更长序列）。 */
+	async getFuturesDailyKlines(thscode, limit) {
+		const end = Date.now();
+		const windowDays = Math.min(Math.ceil(limit * 1.7) + 7, 3650);
+		return ((await this.request("/api/futures/prices/daily", {
+			thscode,
+			...limit > 100 ? {
+				start: end - windowDays * 864e5,
+				end
+			} : {}
+		}))?.item ?? []).filter((b) => typeof b.timestamp === "number" && typeof b.close_price === "number").slice(-limit);
+	}
+	/** 期货当日分时点（session 缺省 intraday；非交易时段可能为空）。 */
+	async getFuturesIntraday(thscode, session) {
+		return this.request("/api/futures/prices/intraday", {
+			thscode,
+			...session !== void 0 ? { session } : {}
+		});
+	}
+	/** 跨资产标的检索（期货用 asset_type=futures 过滤；q 支持 thscode/代码/中英文名称子串）。 */
+	async searchFuturesTickers(keyword, limit = 50) {
+		return (await this.request("/api/meta/tickers/search", {
+			q: keyword.trim(),
+			asset_type: "futures",
+			limit
+		}))?.item ?? [];
+	}
+	/** 期货全量代码表（offset 分页取尽；由调用方过滤已到期合约）。 */
+	async listFuturesTickers() {
+		const all = [];
+		const pageSize = 1e4;
+		for (let offset = 0; offset < 1e5; offset += pageSize) {
+			const page = (await this.request("/api/meta/tickers/list", {
+				asset_type: "futures",
+				limit: pageSize,
+				offset
+			}))?.item ?? [];
+			all.push(...page);
+			if (page.length < pageSize) break;
+		}
+		return all;
+	}
 };
 //#endregion
 export { HiThinkRestClient, TradingServiceError, normalizeThsCode };

package/lib/types.d.ts

@@ -119,5 +119,66 @@ interface HiThinkTickerSearchData {
   total: number;
   item: HiThinkTickerSearchItem[];
 }
+/** A 股历史日K条目（/api/a-share/prices/historical，date_ms 为东八区交易日零点）。 */
+interface HiThinkPriceBarItem {
+  date_ms?: number | null;
+  open_price?: number | null;
+  high_price?: number | null;
+  low_price?: number | null;
+  close_price?: number | null;
+  volume?: number | null;
+  turnover?: number | null;
+}
+interface HiThinkHistoricalData {
+  timestamp: number | null;
+  item: HiThinkPriceBarItem[];
+}
+/** 期货日K条目（/api/futures/prices/daily，timestamp 为毫秒；与 A 股的 date_ms 字段名不同）。 */
+interface HiThinkFuturesDailyItem {
+  timestamp?: number | null;
+  open_price?: number | null;
+  high_price?: number | null;
+  low_price?: number | null;
+  close_price?: number | null;
+  volume?: number | null;
+  turnover?: number | null;
+}
+interface HiThinkFuturesDailyData {
+  timestamp: number | null;
+  thscode: string;
+  interval: string;
+  item: HiThinkFuturesDailyItem[];
+}
+/** 期货当日分时点（/api/futures/prices/intraday；价格点序列，非 OHLC）。 */
+interface HiThinkFuturesIntradayItem {
+  timestamp?: number | null;
+  price?: number | null;
+  volume?: number | null;
+  turnover?: number | null;
+}
+interface HiThinkFuturesIntradayData {
+  timestamp: number | null;
+  thscode: string;
+  date: string;
+  session: string;
+  item: HiThinkFuturesIntradayItem[];
+}
+/** 跨资产代码表条目（/api/meta/tickers/list|search，日期为 yyyy-MM-dd 或 null）。 */
+interface HiThinkMetaTickerItem {
+  thscode: string;
+  ticker: string;
+  name: string;
+  exchange?: string | null;
+  asset_type: string;
+  currency?: string | null;
+  list_date?: string | null;
+  end_date?: string | null;
+  last_trade_date?: string | null;
+  last_delivery_date?: string | null;
+}
+interface HiThinkMetaTickerData {
+  timestamp: number | null;
+  item: HiThinkMetaTickerItem[];
+}
 //#endregion
-export { HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem };
+export { HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkFuturesDailyData, HiThinkFuturesDailyItem, HiThinkFuturesIntradayData, HiThinkFuturesIntradayItem, HiThinkHistoricalData, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkMetaTickerData, HiThinkMetaTickerItem, HiThinkPriceBarItem, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-hithink",
   "description": "【模板】交易所连接器插件脚手架：HiThink（hithink）v2 插件骨架 —— 市场数据服务 + 交易服务 + 三态闸门 + BYOK 凭证 ref。生成器：node scripts/new-connector.mjs --slug <exchange>",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,6 +14,18 @@
       "types": "./lib/dataplane.d.ts",
       "default": "./lib/dataplane.js"
     },
+    "./futures": {
+      "types": "./lib/futures.d.ts",
+      "default": "./lib/futures.js"
+    },
+    "./futures-dataplane": {
+      "types": "./lib/futures-dataplane.d.ts",
+      "default": "./lib/futures-dataplane.js"
+    },
+    "./futures-plugin": {
+      "types": "./lib/futures-plugin.d.ts",
+      "default": "./lib/futures-plugin.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -21,7 +33,7 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.2.1"
+    "@dshtrading/api": "^0.4.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",