@dshtrading/connector-hithink 0.1.0

package/LICENSE

@@ -0,0 +1,75 @@
+Copyright (c) 2026 zhu1090093659 (dsh-trading)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -0,0 +1,31 @@
+# @dshtrading/connector-hithink
+
+HiThink (同花顺/问财开放平台 OpenAPI) A 股连接器，提供基本面数据、估值快照、集合竞价与特色选股数据。
+
+## 能力边界
+
+- **数据服务 (`MarketDataService`)**：
+  - `getTicker(symbol)`：实时行情快照与最新量价；
+  - `getStockFundamentals(symbol)`：总市值、流通市值、市盈率 (PE-TTM/动/静)、市净率 (PB)、市销率 (PS)、股息率；
+  - `getAuctionSnapshot(symbol)`：早盘集合竞价匹配量、未匹配量与竞价强弱；
+  - `getLimitUpPool(date?)`：连板池、封单量与炸板分析；
+- **交易服务 (`TradeService`)**：
+  - 不提供直接委托下单通道（A 股实盘执行由本地 MiniQMT 负责，遵循铁律 #3 统一安全闸门）。
+
+## 配置项 (Config)
+
+```json
+{
+  "enabled": true,
+  "apiKey": "ref:env/HITHINK_FINANCE_API_KEY",
+  "baseUrl": "https://fuyao.aicubes.cn/openapi/v1"
+}
+```
+
+- `apiKey`：同花顺/问财开放平台认证 Token（遵循 BYOK 铁律 #5，仅支持 ref 引用或环境变量 `HITHINK_FINANCE_API_KEY`）；
+- `baseUrl`：开放平台端点网关。
+
+## 合规与条款边界 (ToS Compliance)
+
+- **个人使用**：仅供用户自主鉴权后获取个人看盘与研报所需数据；
+- **严禁再分发 (铁律 #4)**：不缓存转售、不批量扒取、不落地再分发原始行情。

package/lib/dataplane.d.ts

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

package/lib/dataplane.js

@@ -0,0 +1,24 @@
+import { HiThinkMarketDataService, TRADING_CN_MARKET_DATA_KEY } from "./index.js";
+//#region src/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 = "cn";
+function apply(ctx, config) {
+	if (!config.enabled) return;
+	const apiKey = process.env[config.apiKeyRef];
+	const registry = resolveMarketDataRegistry(ctx);
+	const opts = apiKey ? { apiKey } : {};
+	if (registry === void 0) {
+		new HiThinkMarketDataService(ctx, opts);
+		return;
+	}
+	const inner = ctx.isolate(TRADING_CN_MARKET_DATA_KEY);
+	const service = new HiThinkMarketDataService(inner, opts);
+	ctx.effect(() => registry.register(MARKET, ROUTER_PROVIDER, service));
+}
+//#endregion
+export { apply, inject };

package/lib/index.d.ts

@@ -0,0 +1,37 @@
+import { HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem } from "./types.js";
+import { HiThinkRestClient, HiThinkRestOptions, TradingServiceError, normalizeThsCode } from "./rest.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";
+//#region src/index.d.ts
+declare const name = "dsh-trading-cn-connector-hithink";
+interface Config {
+  enabled: boolean;
+  apiKeyRef: string;
+}
+declare const Config: Schema<Config>;
+declare const TRADING_CN_MARKET_DATA_KEY = "tradingCnMarketData";
+declare class HiThinkMarketDataService extends Service implements MarketDataService {
+  private readonly client;
+  constructor(ctx: Context, options?: HiThinkRestOptions, serviceName?: string);
+  getTicker(symbol: string): Promise<Ticker>;
+  getKlines(_symbol: string, _interval?: Interval, _limit?: number): Promise<Kline[]>;
+  getStockFundamentals(symbol: string): Promise<StockFundamentals>;
+  getAuctionSnapshot(symbol: string): Promise<AuctionSnapshot | undefined>;
+  getLimitUpPool(options?: {
+    dateMs?: number;
+    page?: number;
+    size?: number;
+  }): Promise<LimitUpPoolItem[]>;
+  getLimitUpLadder(): Promise<HiThinkLadderData>;
+  searchTickers(query: string): Promise<{
+    symbol: string;
+    name: string;
+  }[]>;
+  subscribeTicker(symbol: string, cb: (ticker: Ticker) => void, options?: {
+    intervalMs?: number;
+  }): Disposable;
+}
+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 };

package/lib/index.js

@@ -0,0 +1,54 @@
+import { HiThinkRestClient, TradingServiceError, normalizeThsCode } from "./rest.js";
+import { Service } from "@deepseek-ai/cordis";
+import Schema from "@deepseek-ai/schemastery";
+//#region src/index.ts
+const name = "dsh-trading-cn-connector-hithink";
+const Config = Schema.object({
+	enabled: Schema.boolean().default(true).description("是否激活同花顺连接器"),
+	apiKeyRef: Schema.string().default("HITHINK_FINANCE_API_KEY").description("同花顺 API Key 环境变量名 (BYOK)")
+});
+const TRADING_CN_MARKET_DATA_KEY = "tradingCnMarketData";
+var HiThinkMarketDataService = class extends Service {
+	client;
+	constructor(ctx, options = {}, serviceName = TRADING_CN_MARKET_DATA_KEY) {
+		super(ctx, serviceName);
+		this.client = new HiThinkRestClient(options);
+	}
+	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");
+	}
+	async getStockFundamentals(symbol) {
+		return this.client.getStockFundamentals(symbol);
+	}
+	async getAuctionSnapshot(symbol) {
+		return this.client.getAuctionSnapshot(symbol);
+	}
+	async getLimitUpPool(options) {
+		return this.client.getLimitUpPool(options);
+	}
+	async getLimitUpLadder() {
+		return this.client.getLimitUpLadder();
+	}
+	async searchTickers(query) {
+		return this.client.searchTickers(query);
+	}
+	subscribeTicker(symbol, cb, options) {
+		const ms = Math.max(options?.intervalMs ?? 5e3, 1e3);
+		const tick = () => {
+			this.getTicker(symbol).then(cb, () => {});
+		};
+		tick();
+		const timer = setInterval(tick, ms);
+		return { dispose: () => clearInterval(timer) };
+	}
+};
+function apply(ctx, config) {
+	if (!config.enabled) return;
+	const apiKey = process.env[config.apiKeyRef];
+	new HiThinkMarketDataService(ctx, apiKey ? { apiKey } : {});
+}
+//#endregion
+export { Config, HiThinkMarketDataService, HiThinkRestClient, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, apply, name, normalizeThsCode };

package/lib/rest.d.ts

@@ -0,0 +1,46 @@
+import { HiThinkLadderData, HiThinkValuationData } from "./types.js";
+import { AuctionSnapshot, LimitUpPoolItem, StockFundamentals, Ticker, TradingErrorCode } from "@dshtrading/api";
+//#region src/rest.d.ts
+declare class TradingServiceError extends Error {
+  readonly code: TradingErrorCode;
+  constructor(code: TradingErrorCode, message: string, cause?: unknown);
+}
+interface HiThinkRestOptions {
+  apiKey?: string | undefined;
+  baseUrl?: string | undefined;
+  fetchImpl?: typeof fetch | undefined;
+  timeoutMs?: number | undefined;
+}
+/** 规范化输入为标准 thscode（如 600519 -> 600519.SH, sz000001 -> 000001.SZ）。 */
+declare function normalizeThsCode(input: string): string;
+declare class HiThinkRestClient {
+  private readonly apiKey?;
+  private readonly baseUrl;
+  private readonly fetchImpl;
+  private readonly timeoutMs;
+  constructor(options?: HiThinkRestOptions);
+  private request;
+  /** 获取最新行情快照。 */
+  getTicker(symbol: string): Promise<Ticker>;
+  /** 获取标的估值快照。 */
+  getValuation(symbol: string): Promise<HiThinkValuationData['item'][0] | undefined>;
+  /** 获取综合估值指标快照（StockFundamentals 适配）。 */
+  getStockFundamentals(symbol: string): Promise<StockFundamentals>;
+  /** 获取今日或指定日期涨跌停池。 */
+  getLimitUpPool(options?: {
+    dateMs?: number;
+    page?: number;
+    size?: number;
+  }): Promise<LimitUpPoolItem[]>;
+  /** 获取连板天梯数据。 */
+  getLimitUpLadder(): Promise<HiThinkLadderData>;
+  /** 获取集合竞价快照与强弱基准。 */
+  getAuctionSnapshot(symbol: string): Promise<AuctionSnapshot | undefined>;
+  /** 模糊搜索股票代码与全称（消歧）。 */
+  searchTickers(keyword: string): Promise<Array<{
+    symbol: string;
+    name: string;
+  }>>;
+}
+//#endregion
+export { HiThinkRestClient, HiThinkRestOptions, TradingServiceError, normalizeThsCode };

package/lib/rest.js

@@ -0,0 +1,154 @@
+//#region src/rest.ts
+var TradingServiceError = class extends Error {
+	code;
+	constructor(code, message, cause) {
+		super(message);
+		this.name = "TradingServiceError";
+		this.code = code;
+		if (cause !== void 0) this.cause = cause;
+	}
+};
+/** 规范化输入为标准 thscode（如 600519 -> 600519.SH, sz000001 -> 000001.SZ）。 */
+function normalizeThsCode(input) {
+	const raw = input.trim().toUpperCase();
+	if (/^\d{6}\.(SH|SZ|BJ)$/.test(raw)) return raw;
+	const prefixMatch = /^(SH|SZ|BJ)(\d{6})$/.exec(raw);
+	if (prefixMatch && prefixMatch[1] && prefixMatch[2]) return `${prefixMatch[2]}.${prefixMatch[1]}`;
+	const codeMatch = /^(\d{6})$/.exec(raw);
+	if (codeMatch && codeMatch[1]) {
+		const code = codeMatch[1];
+		return `${code}.${code.startsWith("920") || code.startsWith("8") || code.startsWith("4") ? "BJ" : code.startsWith("6") || code.startsWith("900") ? "SH" : "SZ"}`;
+	}
+	return raw;
+}
+var HiThinkRestClient = class {
+	apiKey;
+	baseUrl;
+	fetchImpl;
+	timeoutMs;
+	constructor(options = {}) {
+		this.apiKey = options.apiKey ?? process.env.HITHINK_FINANCE_API_KEY ?? process.env.HITHINK_API_KEY;
+		this.baseUrl = (options.baseUrl ?? "https://fuyao.aicubes.cn").replace(/\/+$/, "");
+		this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+		this.timeoutMs = options.timeoutMs ?? 1e4;
+	}
+	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));
+		const headers = {
+			Accept: "application/json",
+			"User-Agent": "dsh-trading/0.1.0"
+		};
+		if (this.apiKey) headers["X-api-key"] = this.apiKey;
+		let res;
+		try {
+			res = await this.fetchImpl(url.toString(), {
+				method: "GET",
+				headers,
+				signal: AbortSignal.timeout(this.timeoutMs)
+			});
+		} catch (err) {
+			throw new TradingServiceError("TRADING_NETWORK", `HiThink request failed (${url.pathname}): ${err instanceof Error ? err.message : String(err)}`, err);
+		}
+		if (!res.ok) {
+			if (res.status === 401 || res.status === 403) throw new TradingServiceError("TRADING_AUTH_FAILED", `HiThink authentication failed (HTTP ${res.status}). Check HITHINK_FINANCE_API_KEY.`);
+			if (res.status === 429) throw new TradingServiceError("TRADING_RATE_LIMITED", `HiThink rate limited (HTTP 429). Retry later.`);
+			throw new TradingServiceError("TRADING_NETWORK", `HiThink upstream error (HTTP ${res.status})`);
+		}
+		const json = await res.json();
+		if (json.code !== 0) {
+			if (json.code === 2001 || json.code === 2003) throw new TradingServiceError("TRADING_AUTH_FAILED", `HiThink auth error (${json.code}): ${json.message}`);
+			if (json.code === 4001) throw new TradingServiceError("TRADING_RATE_LIMITED", `HiThink rate limited (${json.code}): ${json.message}`);
+			if (json.code === 3001) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `HiThink ticker not found (${json.code}): ${json.message}`);
+			throw new TradingServiceError("TRADING_UNKNOWN", `HiThink API error (${json.code}): ${json.message}`);
+		}
+		return json.data;
+	}
+	/** 获取最新行情快照。 */
+	async getTicker(symbol) {
+		const thscode = normalizeThsCode(symbol);
+		const data = await this.request("/api/a-share/prices/snapshot", { thscodes: thscode });
+		const item = data?.item?.[0];
+		if (!item) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `HiThink: no quote found for ${symbol} (${thscode})`);
+		return {
+			symbol: thscode,
+			price: item.last_price ?? item.prev_price ?? 0,
+			...item.prev_price !== void 0 ? { prevClose: item.prev_price } : {},
+			...item.price_change_ratio_pct !== void 0 ? { changePercent: item.price_change_ratio_pct } : {},
+			...item.volume !== void 0 ? { volume: item.volume } : {},
+			timestamp: data?.timestamp ?? Date.now()
+		};
+	}
+	/** 获取标的估值快照。 */
+	async getValuation(symbol) {
+		const thscode = normalizeThsCode(symbol);
+		return (await this.request("/api/a-share/valuations/snapshot", { thscodes: thscode }))?.item?.[0];
+	}
+	/** 获取综合估值指标快照（StockFundamentals 适配）。 */
+	async getStockFundamentals(symbol) {
+		const thscode = normalizeThsCode(symbol);
+		const [ticker, val] = await Promise.allSettled([this.getTicker(thscode), this.getValuation(thscode)]);
+		const tickerVal = ticker.status === "fulfilled" ? ticker.value : void 0;
+		const valItem = val.status === "fulfilled" ? val.value : void 0;
+		return {
+			symbol: thscode,
+			...typeof valItem?.pe_ttm === "number" ? { peTtm: valItem.pe_ttm } : {},
+			...typeof valItem?.pe_mrq === "number" ? { peDynamic: valItem.pe_mrq } : {},
+			...typeof valItem?.pb_mrq === "number" ? { pb: valItem.pb_mrq } : {},
+			...typeof valItem?.ps_ttm === "number" ? { ps: valItem.ps_ttm } : {},
+			timestamp: tickerVal?.timestamp ?? Date.now()
+		};
+	}
+	/** 获取今日或指定日期涨跌停池。 */
+	async getLimitUpPool(options = {}) {
+		return ((await this.request("/api/a-share/special-data/limit-up-pool", {
+			...options.dateMs !== void 0 ? { date_ms: options.dateMs } : {},
+			page: options.page ?? 1,
+			size: options.size ?? 50,
+			sort_field: "limit_up_time",
+			sort_dir: "asc"
+		}))?.item ?? []).map((item) => ({
+			symbol: item.thscode,
+			name: item.name,
+			price: item.last_price,
+			changePercent: item.price_change_ratio_pct,
+			limitType: "up",
+			...item.limit_up_time !== void 0 ? { firstLimitTime: item.limit_up_time } : {},
+			...item.seal_money !== void 0 ? { limitOrderAmount: item.seal_money } : {},
+			...item.continue_day_cnt !== void 0 ? { consecutiveBoards: item.continue_day_cnt } : {},
+			...item.limit_up_reason !== void 0 ? { sectorConcept: item.limit_up_reason } : {}
+		}));
+	}
+	/** 获取连板天梯数据。 */
+	async getLimitUpLadder() {
+		return this.request("/api/a-share/special-data/limit-up-ladder");
+	}
+	/** 获取集合竞价快照与强弱基准。 */
+	async getAuctionSnapshot(symbol) {
+		const thscode = normalizeThsCode(symbol);
+		const data = await this.request("/api/a-share/auction/snapshot", { thscodes: thscode });
+		const item = data?.item?.[0];
+		if (!item) return void 0;
+		const unmatchedSide = item.unmatched_side === "buy" || item.unmatched_side === "sell" ? item.unmatched_side : void 0;
+		const stage = item.stage === "call" || item.stage === "final" ? item.stage : void 0;
+		return {
+			symbol: thscode,
+			...item.match_price !== void 0 ? { matchPrice: item.match_price } : {},
+			...item.match_volume !== void 0 ? { matchVolume: item.match_volume } : {},
+			...item.unmatched_volume !== void 0 ? { unmatchedVolume: item.unmatched_volume } : {},
+			...unmatchedSide !== void 0 ? { unmatchedSide } : {},
+			...item.strength_index !== void 0 ? { strengthIndex: item.strength_index } : {},
+			...stage !== void 0 ? { stage } : {},
+			timestamp: data?.timestamp ?? Date.now()
+		};
+	}
+	/** 模糊搜索股票代码与全称（消歧）。 */
+	async searchTickers(keyword) {
+		return ((await this.request("/api/a-share/instruments/search", { keyword: keyword.trim() }))?.item ?? []).map((item) => ({
+			symbol: item.thscode,
+			name: item.name
+		}));
+	}
+};
+//#endregion
+export { HiThinkRestClient, TradingServiceError, normalizeThsCode };

package/lib/types.d.ts

@@ -0,0 +1,123 @@
+//#region src/types.d.ts
+/**
+ * @dshtrading/connector-hithink
+ * 同花顺官方金融数据服务 API 契约与内部数据类型。
+ */
+interface HiThinkEnvelope<T> {
+  code: number;
+  message: string;
+  request_id?: string;
+  data?: T;
+}
+interface HiThinkPriceSnapshotItem {
+  thscode: string;
+  ticker: string;
+  last_price?: number;
+  price_change?: number;
+  price_change_ratio_pct?: number;
+  open_price?: number;
+  high_price?: number;
+  low_price?: number;
+  prev_price?: number;
+  volume?: number;
+  turnover?: number;
+}
+interface HiThinkPriceSnapshotData {
+  timestamp: number | null;
+  total: number;
+  item: HiThinkPriceSnapshotItem[];
+}
+interface HiThinkValuationItem {
+  thscode: string;
+  ticker: string;
+  pe_ttm?: number | null;
+  pe_mrq?: number | null;
+  pb_mrq?: number | null;
+  ps_ttm?: number | null;
+  pcf_ttm?: number | null;
+}
+interface HiThinkValuationData {
+  timestamp: number | null;
+  total: number;
+  item: HiThinkValuationItem[];
+}
+interface HiThinkLimitUpItem {
+  thscode: string;
+  ticker: string;
+  name: string;
+  is_st?: boolean;
+  is_new?: boolean;
+  last_price: number;
+  price_change_ratio_pct: number;
+  limit_up_time?: string;
+  limit_up_reason?: string;
+  continue_day_text?: string;
+  continue_day_cnt?: number;
+  seal_money?: number;
+  max_seal_money?: number;
+}
+interface HiThinkLimitUpPoolData {
+  timestamp: number;
+  pagination?: {
+    total: number;
+    pages: number;
+    size: number;
+    page: number;
+  };
+  item: HiThinkLimitUpItem[];
+}
+interface HiThinkLadderBoardItem {
+  thscode: string;
+  ticker: string;
+  name: string;
+  board_num: number;
+  sign_level?: string;
+  seal_nextday?: string | null;
+}
+interface HiThinkLadderDayItem {
+  date: string;
+  boards: {
+    two_board?: HiThinkLadderBoardItem[];
+    three_board?: HiThinkLadderBoardItem[];
+    four_board?: HiThinkLadderBoardItem[];
+    five_board?: HiThinkLadderBoardItem[];
+    six_board?: HiThinkLadderBoardItem[];
+    seven_over?: HiThinkLadderBoardItem[];
+  };
+}
+interface HiThinkLadderData {
+  timestamp: number;
+  window?: {
+    length: number;
+    date_list: string[];
+    board_caps: Record<string, number>;
+  };
+  item: HiThinkLadderDayItem[];
+}
+interface HiThinkAuctionItem {
+  thscode: string;
+  ticker: string;
+  match_price?: number;
+  match_volume?: number;
+  unmatched_volume?: number;
+  unmatched_side?: 'buy' | 'sell' | string;
+  strength_index?: number;
+  stage?: 'call' | 'final' | string;
+}
+interface HiThinkAuctionData {
+  timestamp: number | null;
+  item: HiThinkAuctionItem[];
+}
+interface HiThinkTickerSearchItem {
+  thscode: string;
+  ticker: string;
+  name: string;
+  asset_type?: string;
+  exchange?: string;
+}
+interface HiThinkTickerSearchData {
+  total: number;
+  item: HiThinkTickerSearchItem[];
+}
+//#endregion
+export { HiThinkAuctionData, HiThinkAuctionItem, HiThinkEnvelope, HiThinkLadderBoardItem, HiThinkLadderData, HiThinkLadderDayItem, HiThinkLimitUpItem, HiThinkLimitUpPoolData, HiThinkPriceSnapshotData, HiThinkPriceSnapshotItem, HiThinkTickerSearchData, HiThinkTickerSearchItem, HiThinkValuationData, HiThinkValuationItem };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@dshtrading/connector-hithink",
+  "description": "【模板】交易所连接器插件脚手架：HiThink（hithink）v2 插件骨架 —— 市场数据服务 + 交易服务 + 三态闸门 + BYOK 凭证 ref。生成器：node scripts/new-connector.mjs --slug <exchange>",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./dataplane": {
+      "types": "./lib/dataplane.d.ts",
+      "default": "./lib/dataplane.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "dependencies": {
+    "@dshtrading/api": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.1",
+    "@deepseek-ai/schemastery": ">=3.18.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}