stock-sdk 2.2.2 → 2.4.0

package/dist/{sdk-BOfyUDzu.d.cts → sdk-RzQ-drS4.d.cts}

@@ -1,5 +1,7 @@
 import { c as SdkErrorCode, R as RetryOptions, d as RateLimiterOptions, C as CircuitBreakerOptions, P as ProviderName, a as ProviderRequestPolicy, S as SdkError } from './index-mlzPfoON.cjs';
+import { b as ChipDistributionOptions, d as ChipDistributionItem } from './chip-BbA23rr1.cjs';
 import { n as MarketTz, v as TodayTimelineResponse, I as IndicatorOptions, H as HistoryKline, s as MinuteTimeline, t as MinuteKline, w as HKHistoryKline, y as HKMinuteTimeline, x as HKMinuteKline, U as USHistoryKline, E as USMinuteTimeline, z as USMinuteKline, K as KlineWithIndicators, A as AnyHistoryKline } from './addIndicators-_V3HEi0q.cjs';
+import { a as Signal } from './types-7n5rSHbd.cjs';
 
 interface HostHealthState {
     host: string;
@@ -320,7 +322,8 @@ interface HKQuote {
     totalMarketCap: number | null;
     currency: string;
     market: 'HK';
-    assetType: 'stock';
+    /** 命中特殊指数注册表(HSI/HSCEI/HSTECH)的行标 'index'(港股真码恒为数字,无碰撞面) */
+    assetType: 'stock' | 'index';
     source: ProviderName;
 }
 /**
@@ -372,7 +375,8 @@ interface USQuote {
     /** 52周最低价 */
     low52w: number | null;
     market: 'US';
-    assetType: 'stock';
+    /** 命中特殊指数注册表(DJI/INX/IXIC)的行标 'index'，code 归一为注册表规范形 */
+    assetType: 'stock' | 'index';
     source: ProviderName;
 }
 /**
@@ -1102,13 +1106,95 @@ interface StockChangeItem {
     code: string;
     /** 股票名称 */
     name: string;
-    /** 异动类型 */
-    changeType: StockChangeType;
-    /** 异动类型对应的中文标签 */
+    /** 异动类型(由响应 t 码反查;服务端新增的未知码为 'unknown',原始码见 typeCode) */
+    changeType: StockChangeType | 'unknown';
+    /** 原始类型码(服务端 t 字段) */
+    typeCode: string;
+    /** 异动类型对应的中文标签(未知码为空串) */
     changeTypeLabel: string;
     /** 相关信息（来自原始接口） */
     info: string;
 }
+/**
+ * 个股盘口异动事件(个股按日接口,字段比全市场接口更丰富)
+ */
+interface IndividualStockChangeItem {
+    /** 发生时间 HH:MM:SS */
+    time: string;
+    /** 原始类型码(个股接口会返回 22 类之外的码,如 8219) */
+    typeCode: string;
+    /** 异动类型(未知码为 'unknown') */
+    changeType: StockChangeType | 'unknown';
+    /** 中文标签(未知码为空串) */
+    changeTypeLabel: string;
+    /** 触发价(元) */
+    price: number | null;
+    /** 触发时涨跌幅(%) */
+    changePercent: number | null;
+    /** 相关信息（来自原始接口,CSV 格式因类型而异） */
+    info: string;
+    /** 上游未文档化字段(疑似异动量级),原样透传 */
+    v: number | null;
+}
+/**
+ * 个股单个交易日的异动数据
+ */
+interface IndividualChangesDay {
+    /** 交易日 YYYY-MM-DD */
+    date: string;
+    /**
+     * 服务端该交易日是否有数据。false = 无数据(changes 恒为空),与
+     * "当日无异动"(true + 空数组)区分。
+     *
+     * 注意:服务端仅保留约最近数周(实测 1 个月左右),且窗口**不保证连续**
+     * ——实测存在个别日期空洞(更早的日期反而有数据)。永远以逐日返回的
+     * available 为准,不要按固定天数推断。
+     */
+    available: boolean;
+    /** 股票代码 */
+    code: string;
+    /** 股票名称(超窗时为空串) */
+    name: string;
+    /** 异动事件流(服务端顺序,最新在前) */
+    changes: IndividualStockChangeItem[];
+}
+/**
+ * 单个异动类型的计数(IndividualChangesHistory.stats 的值)
+ */
+interface ChangeTypeCount {
+    /** 出现次数 */
+    count: number;
+    /** 中文标签(未知类型码为空串) */
+    label: string;
+}
+/**
+ * 个股近 N 天异动历史(逐交易日聚合)
+ */
+interface IndividualChangesHistory {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 请求的自然日跨度 */
+    requestedDays: number;
+    /** 实际覆盖情况 */
+    coverage: {
+        /** 请求窗口起点(自然日)YYYY-MM-DD */
+        from: string;
+        /** 请求窗口终点(北京时间今天)YYYY-MM-DD */
+        to: string;
+        /** 窗口内首个有数据的交易日(其后仍可能有个别空洞日);全部无数据时为 null */
+        availableFrom: string | null;
+    };
+    /** 逐交易日数据(按日期升序;available=false 表示服务端该日无数据) */
+    days: IndividualChangesDay[];
+    /**
+     * 异动类型计数概览(仅统计 available 日)。
+     * key 为**原始类型码**(typeCode,稳定、可跨会话程序化比较),
+     * 中文标签见值内 label(未知码为空串)。
+     */
+    stats: Record<string, ChangeTypeCount>;
+}
 /**
  * 板块异动项
  */
@@ -1488,8 +1574,11 @@ interface FundNavPoint {
     date: string;
     /** 净值日期对应的毫秒时间戳（数据源原值，UTC 当日 00:00） */
     timestamp: number | null;
-    /** 单位净值 */
-    nav: number;
+    /**
+     * 单位净值；上游该行净值缺失 / 非数值时为 `null`
+     * （v2.4.0 起从 `number` 放宽，与 accNav / dailyReturn 的可空口径一致）
+     */
+    nav: number | null;
     /** 累计净值；与单位净值数组按 timestamp 对齐，无法对齐时为 `null` */
     accNav: number | null;
     /** 日增长率（%）；无值时为 `null` */
@@ -1940,18 +2029,6 @@ interface GetUSCodeListOptions {
  */
 type GetAllHKQuotesOptions = Omit<GetAllAShareQuotesOptions, 'market'>;
 
-/**
- * 腾讯 Smartbox 搜索接口
- * 支持浏览器（JSONP）和 Node.js（fetch）双端
- */
-
-/** 全局变量声明（浏览器环境）*/
-declare global {
-    interface Window {
-        v_hint?: string;
-    }
-}
-
 /**
  * 东方财富 - A 股 K 线
  */
@@ -2274,6 +2351,91 @@ interface KlineWithIndicatorsOptions {
      * - 完整选项参见 `IndicatorOptions`
      */
     indicators?: IndicatorOptions;
+    /**
+     * 窗口前额外保留的 bar 数（内部选项，信号闭环用；默认 0）。
+     * `getKlineSignals` 传 1：交叉识别需要窗口首日的前一根做锚点，按**下标**多留
+     * 一根已算好指标的 bar —— 对任意长度的停牌缺口都精确（区别于按天数回推的
+     * 启发式）。仅 `startDate` 存在时生效；保留的 bar 日期早于 startDate。
+     */
+    leadingBars?: number;
+}
+/**
+ * `getKlineSignals` 的请求参数。
+ *
+ * 复用 K 线的取数选项（market / period / adjust / startDate / endDate），
+ * 额外用 `maFast` / `maSlow` 指定 MA 金叉/死叉的快慢线周期。其余信号族
+ * （MACD / KDJ / RSI / BOLL / SAR）用固定的常用默认阈值，一次性全部识别。
+ */
+interface KlineSignalsOptions {
+    /** 市场类型；不传由 `symbol` 自动识别（同 {@link KlineWithIndicatorsOptions.market}） */
+    market?: MarketType;
+    /** K 线周期，默认 `'daily'` */
+    period?: 'daily' | 'weekly' | 'monthly';
+    /** 复权方式：`''` 不复权 / `'qfq'` 前复权 / `'hfq'` 后复权 */
+    adjust?: '' | 'qfq' | 'hfq';
+    /**
+     * 起始日期（`YYYYMMDD` 或 `YYYY-MM-DD`）。
+     * 不传则在全部历史上识别信号；只关心近期请传起始日期收窄窗口。
+     */
+    startDate?: string;
+    /** 结束日期（`YYYYMMDD` 或 `YYYY-MM-DD`） */
+    endDate?: string;
+    /** MA 金叉/死叉快线周期，默认 5（须为正整数且小于 `maSlow`） */
+    maFast?: number;
+    /** MA 金叉/死叉慢线周期，默认 20（须为正整数且大于 `maFast`） */
+    maSlow?: number;
+}
+/**
+ * 一条识别出的指标信号 —— 在原始 {@link Signal} 上补充**日期与收盘价**，
+ * 让 LLM / 调用方无需回查 K 线即可解读（如「MACD 金叉 · 2026-06-15 · 收 1720」）。
+ */
+interface KlineSignal {
+    /** 信号类型（14 种：MA/MACD/KDJ 金叉死叉、KDJ/RSI 超买超卖、BOLL 突破、SAR 反转） */
+    type: Signal['type'];
+    /** 信号发生 K 线的日期（原始 `date`，通常 `YYYY-MM-DD`） */
+    date: string;
+    /** 信号发生 K 线的时间戳（epoch 毫秒，= {@link Signal.at}） */
+    timestamp: number;
+    /** 信号发生 K 线的收盘价 */
+    close: number | null;
+    /** 附加信息（如金叉的快慢周期、超买超卖的指标值） */
+    detail?: Record<string, number>;
+}
+
+/**
+ * 筹码分布 Service:拉取对应市场日 K 线(含暖机段)→ 本地计算 → 裁剪返回。
+ * 计算本体在 `src/indicators/chip.ts`(纯函数,零网络),本 service 只做编排。
+ */
+
+/** `chips.cn / hk / us` 的请求参数 */
+interface ChipDistributionRequestOptions extends Pick<ChipDistributionOptions, 'range' | 'includeHistogram' | 'decimals'> {
+    /**
+     * 返回最近多少个交易日的筹码分布序列。
+     * @default 90
+     */
+    days?: number;
+    /**
+     * 复权方式(与对应市场 `kline.*` 一致,默认 `'qfq'` 前复权)。
+     * 分布数值随复权口径变化;需对齐 akshare `stock_cyq_em` 默认输出时传 `''`。
+     * @default 'qfq'
+     */
+    adjust?: '' | 'qfq' | 'hfq';
+}
+
+/** `marketEvent.individualChanges` 的请求参数 */
+interface IndividualChangesOptions {
+    /** 交易日 YYYYMMDD 或 YYYY-MM-DD;不传为北京时间今天 */
+    date?: string;
+}
+/** `marketEvent.individualChangesHistory` 的请求参数 */
+interface IndividualChangesHistoryOptions {
+    /**
+     * 最近 N 个自然日(1~60)。内部按 A 股交易日历枚举其中的交易日逐日请求。
+     * 注意服务端仅保留约最近数周(且可能存在个别日期空洞),
+     * 无数据的日期返回 available: false。
+     * @default 7
+     */
+    days?: number;
 }
 
 /**
@@ -2356,6 +2518,7 @@ declare class StockSDK {
     private readonly futuresService;
     private readonly optionsService;
     private readonly indicatorService;
+    private readonly chipService;
     private readonly fundFlowService;
     private readonly northboundService;
     private readonly marketEventService;
@@ -2369,6 +2532,13 @@ declare class StockSDK {
      * 也可以通过 `providerPolicies` 为不同数据源覆盖请求治理策略而不影响既有 API。
      */
     constructor(options?: RequestClientOptions);
+    /**
+     * 清空本实例的全部内部缓存（代码表 / 交易日历 / 板块名称映射 / us-secid 解析）。
+     *
+     * R7-11 起这些缓存按实例隔离，模块级 `clearSharedCaches()` 对它们不再生效
+     * —— 长驻进程需要强刷时用本方法。
+     */
+    clearCaches(): void;
     private readonly _ns;
     private memoNs;
     /** 实时行情 */
@@ -2409,6 +2579,13 @@ declare class StockSDK {
         us: (symbol: string, options?: USKlineOptions) => Promise<USHistoryKline[]>;
         usMinute: (symbol: string, options?: USMinuteKlineOptions) => Promise<USMinuteTimeline[] | USMinuteKline[]>;
         withIndicators: (symbol: string, options?: KlineWithIndicatorsOptions) => Promise<KlineWithIndicators<AnyHistoryKline>[]>;
+        signals: (symbol: string, options?: KlineSignalsOptions) => Promise<KlineSignal[]>;
+    };
+    /** 筹码分布（A 股 / 港股 / 美股,基于日 K + 换手率本地计算） */
+    get chips(): {
+        cn: (symbol: string, options?: ChipDistributionRequestOptions) => Promise<ChipDistributionItem[]>;
+        hk: (symbol: string, options?: ChipDistributionRequestOptions) => Promise<ChipDistributionItem[]>;
+        us: (symbol: string, options?: ChipDistributionRequestOptions) => Promise<ChipDistributionItem[]>;
     };
     /** 板块（行业 / 概念） */
     get board(): {
@@ -2477,8 +2654,10 @@ declare class StockSDK {
     /** 涨停 / 盘口异动 */
     get marketEvent(): {
         ztPool: (type?: ZTPoolType, date?: string) => Promise<ZTPoolItem[]>;
-        stockChanges: (type?: StockChangeType) => Promise<StockChangeItem[]>;
+        stockChanges: (type?: StockChangeType | StockChangeType[] | "all") => Promise<StockChangeItem[]>;
         boardChanges: () => Promise<BoardChangeItem[]>;
+        individualChanges: (symbol: string, options?: IndividualChangesOptions) => Promise<IndividualStockChangeItem[]>;
+        individualChangesHistory: (symbol: string, options?: IndividualChangesHistoryOptions) => Promise<IndividualChangesHistory>;
     };
     /** 龙虎榜 */
     get dragonTiger(): {
@@ -2527,4 +2706,4 @@ declare class StockSDK {
     search(keyword: string): Promise<SearchResult[]>;
 }
 
-export { type ConceptBoard as $, type AShareMarket as A, type BlockTradeDateOptions as B, type ConceptBoardKlineOptions as C, type DragonTigerDateOptions as D, type ExternalLink as E, FundService as F, type GetAllAShareQuotesOptions as G, type HistoryKlineOptions as H, type IndustryBoardKlineOptions as I, type FundFlow as J, type HKQuote as K, type USQuote as L, type MarketType as M, type NorthboundHoldingRankOptions as N, type FundQuote as O, type PanelLargeOrder as P, type Quote as Q, type RequestClientOptions as R, StockSDK as S, TradingCalendarService as T, type USMarket as U, type IndustryBoard as V, type IndustryBoardSpot as W, type IndustryBoardConstituent as X, type IndustryBoardKline as Y, type IndustryBoardMinuteTimeline as Z, type IndustryBoardMinuteKline as _, RequestClient as a, type FundAssetAllocation as a$, type ConceptBoardSpot as a0, type ConceptBoardConstituent as a1, type ConceptBoardKline as a2, type ConceptBoardMinuteTimeline as a3, type ConceptBoardMinuteKline as a4, type FuturesExchange as a5, type FuturesKline as a6, type GlobalFuturesQuote as a7, type FuturesInventorySymbol as a8, type FuturesInventory as a9, type ZTPoolItem as aA, type StockChangeType as aB, type StockChangeItem as aC, type BoardChangeItem as aD, type DragonTigerPeriod as aE, type DragonTigerDetailItem as aF, type DragonTigerStockStatItem as aG, type DragonTigerInstitutionItem as aH, type DragonTigerBranchItem as aI, type DragonTigerSeatItem as aJ, type BlockTradeMarketStatItem as aK, type BlockTradeDetailItem as aL, type BlockTradeDailyStatItem as aM, type MarginAccountItem as aN, type MarginTargetItem as aO, type FundDividendRank as aP, type FundSortDirection as aQ, type FundDividendListOptions as aR, type FundDividend as aS, type FundDividendListResult as aT, type FundNavPoint as aU, type FundNavHistory as aV, type FundEstimate as aW, type FundRankPoint as aX, type FundRankHistory as aY, type FundHolding as aZ, type FundBondHolding as a_, type ComexInventory as aa, type IndexOptionProduct as ab, type OptionTQuote as ac, type OptionTQuoteResult as ad, type OptionKline as ae, type OptionMinute as af, type ETFOptionMonth as ag, type ETFOptionExpireDay as ah, type ETFOptionCate as ai, type CFFEXOptionQuote as aj, type OptionLHBItem as ak, type SearchResultType as al, type DividendDetail as am, type StockFundFlowDaily as an, type FundFlowRankItem as ao, type SectorFundFlowItem as ap, type MarketFundFlow as aq, type NorthboundDirection as ar, type NorthboundMarket as as, type NorthboundRankPeriod as at, type NorthboundMinuteItem as au, type NorthboundFlowSummary as av, type NorthboundHoldingRankItem as aw, type NorthboundHistoryItem as ax, type NorthboundIndividualItem as ay, type ZTPoolType as az, type SearchResult as b, type FundPositionPoint as b0, type FundManager as b1, type FundPerformanceEvaluation as b2, type FundHolderStructure as b3, type FundScaleChange as b4, type FundBuySedemption as b5, type FundStageReturns as b6, type FundSameTypePeer as b7, type FundSameType as b8, type ThemeFundSort as b9, type ThemeFundOrder as ba, type ThemeCategory as bb, type GetThemeListOptions as bc, type GetHotThemesOptions as bd, type ThemeFundRankSort as be, type GetThemeFundsOptions as bf, type ThemeFund as bg, type ThemeFundListResult as bh, type HotThemesResult as bi, type ThemeFundItem as bj, type ThemeFundItemList as bk, type GetAShareCodeListOptions as c, type GetUSCodeListOptions as d, type GetAllUSQuotesOptions as e, type MarketStatus as f, type SupportedMarket as g, type FundProfile as h, type MinuteKlineOptions as i, type HKKlineOptions as j, type HKMinuteKlineOptions as k, type USKlineOptions as l, type USMinuteKlineOptions as m, type IndustryBoardMinuteKlineOptions as n, type ConceptBoardMinuteKlineOptions as o, type FuturesKlineOptions as p, type GlobalFuturesSpotOptions as q, type GlobalFuturesKlineOptions as r, type FuturesInventoryOptions as s, type ComexInventoryOptions as t, type CFFEXOptionQuotesOptions as u, type FundFlowOptions as v, type FundFlowRankOptions as w, type NorthboundHistoryOptions as x, type FullQuote as y, type SimpleQuote as z };
+export { type IndustryBoardKline as $, type AShareMarket as A, type NorthboundHistoryOptions as B, type ChipDistributionRequestOptions as C, type BlockTradeDateOptions as D, type ExternalLink as E, FundService as F, type GetAllAShareQuotesOptions as G, type HistoryKlineOptions as H, type IndividualChangesOptions as I, type DragonTigerDateOptions as J, type FullQuote as K, type SimpleQuote as L, type MarketType as M, type NorthboundHoldingRankOptions as N, type FundFlow as O, type PanelLargeOrder as P, type HKQuote as Q, type RequestClientOptions as R, StockSDK as S, TradingCalendarService as T, type USMarket as U, type USQuote as V, type FundQuote as W, type Quote as X, type IndustryBoard as Y, type IndustryBoardSpot as Z, type IndustryBoardConstituent as _, RequestClient as a, type FundNavPoint as a$, type IndustryBoardMinuteTimeline as a0, type IndustryBoardMinuteKline as a1, type ConceptBoard as a2, type ConceptBoardSpot as a3, type ConceptBoardConstituent as a4, type ConceptBoardKline as a5, type ConceptBoardMinuteTimeline as a6, type ConceptBoardMinuteKline as a7, type FuturesExchange as a8, type FuturesKline as a9, type NorthboundHistoryItem as aA, type NorthboundIndividualItem as aB, type ZTPoolType as aC, type ZTPoolItem as aD, type StockChangeType as aE, type StockChangeItem as aF, type IndividualStockChangeItem as aG, type IndividualChangesDay as aH, type ChangeTypeCount as aI, type IndividualChangesHistory as aJ, type BoardChangeItem as aK, type DragonTigerPeriod as aL, type DragonTigerDetailItem as aM, type DragonTigerStockStatItem as aN, type DragonTigerInstitutionItem as aO, type DragonTigerBranchItem as aP, type DragonTigerSeatItem as aQ, type BlockTradeMarketStatItem as aR, type BlockTradeDetailItem as aS, type BlockTradeDailyStatItem as aT, type MarginAccountItem as aU, type MarginTargetItem as aV, type FundDividendRank as aW, type FundSortDirection as aX, type FundDividendListOptions as aY, type FundDividend as aZ, type FundDividendListResult as a_, type GlobalFuturesQuote as aa, type FuturesInventorySymbol as ab, type FuturesInventory as ac, type ComexInventory as ad, type IndexOptionProduct as ae, type OptionTQuote as af, type OptionTQuoteResult as ag, type OptionKline as ah, type OptionMinute as ai, type ETFOptionMonth as aj, type ETFOptionExpireDay as ak, type ETFOptionCate as al, type CFFEXOptionQuote as am, type OptionLHBItem as an, type SearchResultType as ao, type DividendDetail as ap, type StockFundFlowDaily as aq, type FundFlowRankItem as ar, type SectorFundFlowItem as as, type MarketFundFlow as at, type NorthboundDirection as au, type NorthboundMarket as av, type NorthboundRankPeriod as aw, type NorthboundMinuteItem as ax, type NorthboundFlowSummary as ay, type NorthboundHoldingRankItem as az, type SearchResult as b, type FundNavHistory as b0, type FundEstimate as b1, type FundRankPoint as b2, type FundRankHistory as b3, type FundHolding as b4, type FundBondHolding as b5, type FundAssetAllocation as b6, type FundPositionPoint as b7, type FundManager as b8, type FundPerformanceEvaluation as b9, type FundHolderStructure as ba, type FundScaleChange as bb, type FundBuySedemption as bc, type FundStageReturns as bd, type FundSameTypePeer as be, type FundSameType as bf, type ThemeFundSort as bg, type ThemeFundOrder as bh, type ThemeCategory as bi, type GetThemeListOptions as bj, type GetHotThemesOptions as bk, type ThemeFundRankSort as bl, type GetThemeFundsOptions as bm, type ThemeFund as bn, type ThemeFundListResult as bo, type HotThemesResult as bp, type ThemeFundItem as bq, type ThemeFundItemList as br, type IndividualChangesHistoryOptions as c, type GetAShareCodeListOptions as d, type GetUSCodeListOptions as e, type GetAllUSQuotesOptions as f, type MarketStatus as g, type SupportedMarket as h, type FundProfile as i, type MinuteKlineOptions as j, type HKKlineOptions as k, type HKMinuteKlineOptions as l, type USKlineOptions as m, type USMinuteKlineOptions as n, type IndustryBoardKlineOptions as o, type IndustryBoardMinuteKlineOptions as p, type ConceptBoardKlineOptions as q, type ConceptBoardMinuteKlineOptions as r, type FuturesKlineOptions as s, type GlobalFuturesSpotOptions as t, type GlobalFuturesKlineOptions as u, type FuturesInventoryOptions as v, type ComexInventoryOptions as w, type CFFEXOptionQuotesOptions as x, type FundFlowOptions as y, type FundFlowRankOptions as z };

package/dist/signals.d.cts

@@ -1,45 +1,6 @@
 import { K as KlineWithIndicators, A as AnyHistoryKline } from './addIndicators-_V3HEi0q.cjs';
-
-/**
- * 指标信号层类型（v2 B1）
- */
-/** 信号类型 */
-type SignalType = 'ma_golden_cross' | 'ma_death_cross' | 'macd_golden_cross' | 'macd_death_cross' | 'kdj_golden_cross' | 'kdj_death_cross' | 'kdj_overbought' | 'kdj_oversold' | 'rsi_overbought' | 'rsi_oversold' | 'boll_break_upper' | 'boll_break_lower' | 'sar_reversal_up' | 'sar_reversal_down';
-/** 单条信号 */
-interface Signal {
-    type: SignalType;
-    /** 对应 K 线的 timestamp（恒非空：calcSignals 跳过 timestamp 为 null 的 K 线） */
-    at: number;
-    /** 对应 K 线在输入数组中的下标 */
-    index: number;
-    /** 附加信息（如金叉的快慢周期、超买超卖的指标值） */
-    detail?: Record<string, number>;
-}
-/** 信号计算选项；只为传入的指标计算信号 */
-interface SignalOptions {
-    /** MA 金叉/死叉：fast 上穿/下穿 slow */
-    ma?: {
-        fast: number;
-        slow: number;
-    };
-    /** MACD 金叉/死叉：DIF 上穿/下穿 DEA */
-    macd?: boolean;
-    /** KDJ 金叉死叉 + 超买超卖（默认 80/20） */
-    kdj?: {
-        overbought?: number;
-        oversold?: number;
-    };
-    /** RSI 超买超卖（默认 period=6，70/30） */
-    rsi?: {
-        period?: number;
-        overbought?: number;
-        oversold?: number;
-    };
-    /** BOLL 收盘突破上/下轨 */
-    boll?: boolean;
-    /** SAR 趋势反转 */
-    sar?: boolean;
-}
+import { S as SignalOptions, a as Signal } from './types-7n5rSHbd.cjs';
+export { b as SignalType } from './types-7n5rSHbd.cjs';
 
 /**
  * 指标信号层（v2 B1）
@@ -57,4 +18,4 @@ type Kline = KlineWithIndicators<AnyHistoryKline>;
  */
 declare function calcSignals(klines: Kline[], options?: SignalOptions): Signal[];
 
-export { type Signal, type SignalOptions, type SignalType, calcSignals };
+export { Signal, SignalOptions, calcSignals };

package/dist/signals.d.ts

@@ -1,45 +1,6 @@
 import { K as KlineWithIndicators, A as AnyHistoryKline } from './addIndicators-_V3HEi0q.js';
-
-/**
- * 指标信号层类型（v2 B1）
- */
-/** 信号类型 */
-type SignalType = 'ma_golden_cross' | 'ma_death_cross' | 'macd_golden_cross' | 'macd_death_cross' | 'kdj_golden_cross' | 'kdj_death_cross' | 'kdj_overbought' | 'kdj_oversold' | 'rsi_overbought' | 'rsi_oversold' | 'boll_break_upper' | 'boll_break_lower' | 'sar_reversal_up' | 'sar_reversal_down';
-/** 单条信号 */
-interface Signal {
-    type: SignalType;
-    /** 对应 K 线的 timestamp（恒非空：calcSignals 跳过 timestamp 为 null 的 K 线） */
-    at: number;
-    /** 对应 K 线在输入数组中的下标 */
-    index: number;
-    /** 附加信息（如金叉的快慢周期、超买超卖的指标值） */
-    detail?: Record<string, number>;
-}
-/** 信号计算选项；只为传入的指标计算信号 */
-interface SignalOptions {
-    /** MA 金叉/死叉：fast 上穿/下穿 slow */
-    ma?: {
-        fast: number;
-        slow: number;
-    };
-    /** MACD 金叉/死叉：DIF 上穿/下穿 DEA */
-    macd?: boolean;
-    /** KDJ 金叉死叉 + 超买超卖（默认 80/20） */
-    kdj?: {
-        overbought?: number;
-        oversold?: number;
-    };
-    /** RSI 超买超卖（默认 period=6，70/30） */
-    rsi?: {
-        period?: number;
-        overbought?: number;
-        oversold?: number;
-    };
-    /** BOLL 收盘突破上/下轨 */
-    boll?: boolean;
-    /** SAR 趋势反转 */
-    sar?: boolean;
-}
+import { S as SignalOptions, a as Signal } from './types-7n5rSHbd.js';
+export { b as SignalType } from './types-7n5rSHbd.js';
 
 /**
  * 指标信号层（v2 B1）
@@ -57,4 +18,4 @@ type Kline = KlineWithIndicators<AnyHistoryKline>;
  */
 declare function calcSignals(klines: Kline[], options?: SignalOptions): Signal[];
 
-export { type Signal, type SignalOptions, type SignalType, calcSignals };
+export { Signal, SignalOptions, calcSignals };

package/dist/symbols.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkT5CH7H3Xcjs = require('./chunk-T5CH7H3X.cjs');require('./chunk-4Q7UQ5Q3.cjs');require('./chunk-4VDLQK6F.cjs');exports.EXCHANGE_TO_SECID_PREFIX = _chunkT5CH7H3Xcjs.g; exports.FUTURES_EXCHANGES = _chunkT5CH7H3Xcjs.b; exports.extractVariety = _chunkT5CH7H3Xcjs.c; exports.inferAShareExchange = _chunkT5CH7H3Xcjs.a; exports.marketOf = _chunkT5CH7H3Xcjs.f; exports.normalizeSymbol = _chunkT5CH7H3Xcjs.e; exports.toEastmoneySecid = _chunkT5CH7H3Xcjs.i; exports.toPlainCode = _chunkT5CH7H3Xcjs.j; exports.toTencentSymbol = _chunkT5CH7H3Xcjs.h;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkUSZUOBM2cjs = require('./chunk-USZUOBM2.cjs');require('./chunk-4Q7UQ5Q3.cjs');require('./chunk-4VDLQK6F.cjs');exports.EXCHANGE_TO_SECID_PREFIX = _chunkUSZUOBM2cjs.h; exports.FUTURES_EXCHANGES = _chunkUSZUOBM2cjs.b; exports.extractVariety = _chunkUSZUOBM2cjs.c; exports.inferAShareExchange = _chunkUSZUOBM2cjs.a; exports.marketOf = _chunkUSZUOBM2cjs.g; exports.normalizeSymbol = _chunkUSZUOBM2cjs.f; exports.toEastmoneySecid = _chunkUSZUOBM2cjs.j; exports.toPlainCode = _chunkUSZUOBM2cjs.k; exports.toTencentSymbol = _chunkUSZUOBM2cjs.i; exports.tryToTencentSymbols = _chunkUSZUOBM2cjs.l;

package/dist/symbols.d.cts

@@ -1,5 +1,5 @@
-import { E as Exchange, M as Market } from './adapters-BiH4keVd.cjs';
-export { A as AssetType, d as EXCHANGE_TO_SECID_PREFIX, N as NormalizedSymbol, a as SymbolInput, S as SymbolRef, m as marketOf, n as normalizeSymbol, b as toEastmoneySecid, c as toPlainCode, t as toTencentSymbol } from './adapters-BiH4keVd.cjs';
+import { E as Exchange, M as Market } from './adapters-CZUNRbxi.cjs';
+export { A as AssetType, e as EXCHANGE_TO_SECID_PREFIX, N as NormalizedSymbol, a as SymbolInput, S as SymbolRef, T as TencentSymbolBatch, m as marketOf, n as normalizeSymbol, b as toEastmoneySecid, c as toPlainCode, t as toTencentSymbol, d as tryToTencentSymbols } from './adapters-CZUNRbxi.cjs';
 
 /**
  * 纯代码的市场 / 交易所推断（收编原 core/utils.ts 的 getMarketCode 语义）

package/dist/symbols.d.ts

@@ -1,5 +1,5 @@
-import { E as Exchange, M as Market } from './adapters-BiH4keVd.js';
-export { A as AssetType, d as EXCHANGE_TO_SECID_PREFIX, N as NormalizedSymbol, a as SymbolInput, S as SymbolRef, m as marketOf, n as normalizeSymbol, b as toEastmoneySecid, c as toPlainCode, t as toTencentSymbol } from './adapters-BiH4keVd.js';
+import { E as Exchange, M as Market } from './adapters-CZUNRbxi.js';
+export { A as AssetType, e as EXCHANGE_TO_SECID_PREFIX, N as NormalizedSymbol, a as SymbolInput, S as SymbolRef, T as TencentSymbolBatch, m as marketOf, n as normalizeSymbol, b as toEastmoneySecid, c as toPlainCode, t as toTencentSymbol, d as tryToTencentSymbols } from './adapters-CZUNRbxi.js';
 
 /**
  * 纯代码的市场 / 交易所推断（收编原 core/utils.ts 的 getMarketCode 语义）

package/dist/symbols.js

@@ -1 +1 @@
-import{a,b,c,e as d,f as e,g as f,h as g,i as h,j as i}from"./chunk-ZZ2IBUMV.js";import"./chunk-UBIQBXQ7.js";import"./chunk-WOT6VMZA.js";export{f as EXCHANGE_TO_SECID_PREFIX,b as FUTURES_EXCHANGES,c as extractVariety,a as inferAShareExchange,e as marketOf,d as normalizeSymbol,h as toEastmoneySecid,i as toPlainCode,g as toTencentSymbol};
+import{a,b,c,f as d,g as e,h as f,i as g,j as h,k as i,l as j}from"./chunk-4RN7AVFQ.js";import"./chunk-UBIQBXQ7.js";import"./chunk-WOT6VMZA.js";export{f as EXCHANGE_TO_SECID_PREFIX,b as FUTURES_EXCHANGES,c as extractVariety,a as inferAShareExchange,e as marketOf,d as normalizeSymbol,h as toEastmoneySecid,i as toPlainCode,g as toTencentSymbol,j as tryToTencentSymbols};

package/dist/types-7n5rSHbd.d.cts

@@ -0,0 +1,42 @@
+/**
+ * 指标信号层类型（v2 B1）
+ */
+/** 信号类型 */
+type SignalType = 'ma_golden_cross' | 'ma_death_cross' | 'macd_golden_cross' | 'macd_death_cross' | 'kdj_golden_cross' | 'kdj_death_cross' | 'kdj_overbought' | 'kdj_oversold' | 'rsi_overbought' | 'rsi_oversold' | 'boll_break_upper' | 'boll_break_lower' | 'sar_reversal_up' | 'sar_reversal_down';
+/** 单条信号 */
+interface Signal {
+    type: SignalType;
+    /** 对应 K 线的 timestamp（恒非空：calcSignals 跳过 timestamp 为 null 的 K 线） */
+    at: number;
+    /** 对应 K 线在输入数组中的下标 */
+    index: number;
+    /** 附加信息（如金叉的快慢周期、超买超卖的指标值） */
+    detail?: Record<string, number>;
+}
+/** 信号计算选项；只为传入的指标计算信号 */
+interface SignalOptions {
+    /** MA 金叉/死叉：fast 上穿/下穿 slow */
+    ma?: {
+        fast: number;
+        slow: number;
+    };
+    /** MACD 金叉/死叉：DIF 上穿/下穿 DEA */
+    macd?: boolean;
+    /** KDJ 金叉死叉 + 超买超卖（默认 80/20） */
+    kdj?: {
+        overbought?: number;
+        oversold?: number;
+    };
+    /** RSI 超买超卖（默认 period=6，70/30） */
+    rsi?: {
+        period?: number;
+        overbought?: number;
+        oversold?: number;
+    };
+    /** BOLL 收盘突破上/下轨 */
+    boll?: boolean;
+    /** SAR 趋势反转 */
+    sar?: boolean;
+}
+
+export type { SignalOptions as S, Signal as a, SignalType as b };

package/dist/types-7n5rSHbd.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 指标信号层类型（v2 B1）
+ */
+/** 信号类型 */
+type SignalType = 'ma_golden_cross' | 'ma_death_cross' | 'macd_golden_cross' | 'macd_death_cross' | 'kdj_golden_cross' | 'kdj_death_cross' | 'kdj_overbought' | 'kdj_oversold' | 'rsi_overbought' | 'rsi_oversold' | 'boll_break_upper' | 'boll_break_lower' | 'sar_reversal_up' | 'sar_reversal_down';
+/** 单条信号 */
+interface Signal {
+    type: SignalType;
+    /** 对应 K 线的 timestamp（恒非空：calcSignals 跳过 timestamp 为 null 的 K 线） */
+    at: number;
+    /** 对应 K 线在输入数组中的下标 */
+    index: number;
+    /** 附加信息（如金叉的快慢周期、超买超卖的指标值） */
+    detail?: Record<string, number>;
+}
+/** 信号计算选项；只为传入的指标计算信号 */
+interface SignalOptions {
+    /** MA 金叉/死叉：fast 上穿/下穿 slow */
+    ma?: {
+        fast: number;
+        slow: number;
+    };
+    /** MACD 金叉/死叉：DIF 上穿/下穿 DEA */
+    macd?: boolean;
+    /** KDJ 金叉死叉 + 超买超卖（默认 80/20） */
+    kdj?: {
+        overbought?: number;
+        oversold?: number;
+    };
+    /** RSI 超买超卖（默认 period=6，70/30） */
+    rsi?: {
+        period?: number;
+        overbought?: number;
+        oversold?: number;
+    };
+    /** BOLL 收盘突破上/下轨 */
+    boll?: boolean;
+    /** SAR 趋势反转 */
+    sar?: boolean;
+}
+
+export type { SignalOptions as S, Signal as a, SignalType as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stock-sdk",
-  "version": "2.2.2",
+  "version": "2.4.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -23,6 +23,7 @@
     "build:docs": "pnpm docs:meta && DOCS_BASE=/ vitepress build website",
     "build:pages": "pnpm docs:meta && DOCS_BASE=/stock-sdk/ vitepress build website",
     "gen:llms": "tsx ./scripts/generate-llms.ts",
+    "gen:indicator-baseline": "tsx ./scripts/gen-indicator-baseline.ts",
     "prepare": "node ./scripts/install-git-hooks.js"
   },
   "exports": {