stock-sdk 2.3.0 → 2.4.0

package/dist/{sdk-CtqVdrof.d.ts → sdk-DGgSDZRx.d.ts}

@@ -1,6 +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.js';
 import { b as ChipDistributionOptions, d as ChipDistributionItem } from './chip-BbA23rr1.js';
 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.js';
+import { a as Signal } from './types-7n5rSHbd.js';
 
 interface HostHealthState {
     host: string;
@@ -321,7 +322,8 @@ interface HKQuote {
     totalMarketCap: number | null;
     currency: string;
     market: 'HK';
-    assetType: 'stock';
+    /** 命中特殊指数注册表(HSI/HSCEI/HSTECH)的行标 'index'(港股真码恒为数字,无碰撞面) */
+    assetType: 'stock' | 'index';
     source: ProviderName;
 }
 /**
@@ -373,7 +375,8 @@ interface USQuote {
     /** 52周最低价 */
     low52w: number | null;
     market: 'US';
-    assetType: 'stock';
+    /** 命中特殊指数注册表(DJI/INX/IXIC)的行标 'index'，code 归一为注册表规范形 */
+    assetType: 'stock' | 'index';
     source: ProviderName;
 }
 /**
@@ -1571,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` */
@@ -2023,18 +2029,6 @@ interface GetUSCodeListOptions {
  */
 type GetAllHKQuotesOptions = Omit<GetAllAShareQuotesOptions, 'market'>;
 
-/**
- * 腾讯 Smartbox 搜索接口
- * 支持浏览器（JSONP）和 Node.js（fetch）双端
- */
-
-/** 全局变量声明（浏览器环境）*/
-declare global {
-    interface Window {
-        v_hint?: string;
-    }
-}
-
 /**
  * 东方财富 - A 股 K 线
  */
@@ -2357,6 +2351,55 @@ 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>;
 }
 
 /**
@@ -2489,6 +2532,13 @@ declare class StockSDK {
      * 也可以通过 `providerPolicies` 为不同数据源覆盖请求治理策略而不影响既有 API。
      */
     constructor(options?: RequestClientOptions);
+    /**
+     * 清空本实例的全部内部缓存（代码表 / 交易日历 / 板块名称映射 / us-secid 解析）。
+     *
+     * R7-11 起这些缓存按实例隔离，模块级 `clearSharedCaches()` 对它们不再生效
+     * —— 长驻进程需要强刷时用本方法。
+     */
+    clearCaches(): void;
     private readonly _ns;
     private memoNs;
     /** 实时行情 */
@@ -2529,6 +2579,7 @@ 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(): {

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

@@ -1,6 +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;
@@ -321,7 +322,8 @@ interface HKQuote {
     totalMarketCap: number | null;
     currency: string;
     market: 'HK';
-    assetType: 'stock';
+    /** 命中特殊指数注册表(HSI/HSCEI/HSTECH)的行标 'index'(港股真码恒为数字,无碰撞面) */
+    assetType: 'stock' | 'index';
     source: ProviderName;
 }
 /**
@@ -373,7 +375,8 @@ interface USQuote {
     /** 52周最低价 */
     low52w: number | null;
     market: 'US';
-    assetType: 'stock';
+    /** 命中特殊指数注册表(DJI/INX/IXIC)的行标 'index'，code 归一为注册表规范形 */
+    assetType: 'stock' | 'index';
     source: ProviderName;
 }
 /**
@@ -1571,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` */
@@ -2023,18 +2029,6 @@ interface GetUSCodeListOptions {
  */
 type GetAllHKQuotesOptions = Omit<GetAllAShareQuotesOptions, 'market'>;
 
-/**
- * 腾讯 Smartbox 搜索接口
- * 支持浏览器（JSONP）和 Node.js（fetch）双端
- */
-
-/** 全局变量声明（浏览器环境）*/
-declare global {
-    interface Window {
-        v_hint?: string;
-    }
-}
-
 /**
  * 东方财富 - A 股 K 线
  */
@@ -2357,6 +2351,55 @@ 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>;
 }
 
 /**
@@ -2489,6 +2532,13 @@ declare class StockSDK {
      * 也可以通过 `providerPolicies` 为不同数据源覆盖请求治理策略而不影响既有 API。
      */
     constructor(options?: RequestClientOptions);
+    /**
+     * 清空本实例的全部内部缓存（代码表 / 交易日历 / 板块名称映射 / us-secid 解析）。
+     *
+     * R7-11 起这些缓存按实例隔离，模块级 `clearSharedCaches()` 对它们不再生效
+     * —— 长驻进程需要强刷时用本方法。
+     */
+    clearCaches(): void;
     private readonly _ns;
     private memoNs;
     /** 实时行情 */
@@ -2529,6 +2579,7 @@ 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(): {

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.3.0",
+  "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": {