fi-pool-server 0.1.0

package/dist/utils/indicators.d.ts

@@ -0,0 +1,194 @@
+/**
+ * 技术指标计算工具模块
+ *
+ * 提供 A 股常用的技术分析指标计算函数。
+ * 所有函数接收 OHLCV 日行情数组，返回与输入等长的计算结果数组。
+ * 数据不足时对应位置填充 null。
+ *
+ * @module indicators
+ */
+/**
+ * OHLCV 日行情数据点
+ */
+export interface OHLCV {
+    /** 日期，格式 'yyyy-MM-dd' */
+    date: string;
+    /** 开盘价 */
+    open: number;
+    /** 最高价 */
+    high: number;
+    /** 最低价 */
+    low: number;
+    /** 收盘价 */
+    close: number;
+    /** 成交量（股数） */
+    volume: number;
+}
+/**
+ * 计算简单移动平均线（SMA）
+ *
+ * 公式：MA = (P₁ + P₂ + ... + Pₙ) / n
+ * 前 n-1 个位置为 null（数据不足）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - 计算周期（如 5、10、20）
+ * @returns 长度与 data 相同的数组，每个元素为对应周期的 MA 值或 null
+ *
+ * @example
+ * ```typescript
+ * const ma5 = calcMA(dailyData, 5);
+ * // ma5[4] 为第 1-5 天的平均值
+ * ```
+ */
+export declare function calcMA(data: OHLCV[], period: number): (number | null)[];
+/**
+ * 计算指数移动平均线（EMA）
+ *
+ * 公式：
+ *   multiplier = 2 / (n + 1)
+ *   EMA₁ = SMA(前 n 个 close)
+ *   EMAₜ = (closeₜ - EMAₜ₋₁) × multiplier + EMAₜ₋₁
+ *
+ * 前 n-1 个位置为 null（数据不足）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - 计算周期（如 12、26）
+ * @returns 长度与 data 相同的数组，每个元素为对应位置的 EMA 值或 null
+ */
+export declare function calcEMA(data: OHLCV[], period: number): (number | null)[];
+/**
+ * 计算 MACD 指标（指数平滑异同移动平均线）
+ *
+ * 标准参数 (12, 26, 9)：
+ *   DIF = EMA₁₂(close) − EMA₂₆(close)
+ *   DEA = EMA₉(DIF)
+ *   Histogram = 2 × (DIF − DEA)
+ *
+ * @param data - OHLCV 数组
+ * @returns 包含 DIF、DEA、Histogram 三个等长数组的对象
+ *
+ * @example
+ * ```typescript
+ * const { dif, dea, histogram } = calcMACD(dailyData);
+ * // 最后一个值为最新信号
+ * ```
+ */
+export declare function calcMACD(data: OHLCV[]): {
+    dif: (number | null)[];
+    dea: (number | null)[];
+    histogram: (number | null)[];
+};
+/**
+ * 计算相对强弱指标（RSI）
+ *
+ * 使用 Wilder 平滑法（改良指数平均）：
+ *   1. 计算每日价格变动 Δ = closeₜ − closeₜ₋₁
+ *   2. 初始平均涨幅 = 前 n 个 Δ 中正值的平均值
+ *      初始平均跌幅 = 前 n 个 Δ 中负值绝对值的平均值
+ *   3. 后续平滑：
+ *      avgGainₜ = (avgGainₜ₋₁ × (n−1) + gainₜ) / n
+ *      avgLossₜ = (avgLossₜ₋₁ × (n−1) + lossₜ) / n
+ *   4. RS = avgGain / avgLoss
+ *      RSI = 100 − 100 / (1 + RS)
+ *
+ * 前 n 个位置为 null（需要 n+1 个价格才能计算第一个 RSI 值）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - RSI 计算周期（通常为 14）
+ * @returns 长度与 data 相同的 RSI 值数组
+ *
+ * @example
+ * ```typescript
+ * const rsi14 = calcRSI(dailyData, 14);
+ * ```
+ */
+export declare function calcRSI(data: OHLCV[], period: number): (number | null)[];
+/**
+ * 计算 KDJ 指标（随机指标）
+ *
+ * 标准参数 (9, 3, 3)：
+ *   1. RSV = (close − LLV) / (HHV − LLV) × 100
+ *      其中 LLV 为最近 period 周期的最低价，HHV 为最近 period 周期的最高价
+ *   2. Kₜ = ⅔ × Kₜ₋₁ + ⅓ × RSVₜ     （初始 K = 50）
+ *   3. Dₜ = ⅔ × Dₜ₋₁ + ⅓ × Kₜ       （初始 D = 50）
+ *   4. Jₜ = 3 × Kₜ − 2 × Dₜ
+ *
+ * 前 period-1 个位置为 null（数据不足）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - 周期（默认 9，即 RSV 的观察窗口）
+ * @returns 包含 K、D、J 三个等长数组的对象
+ *
+ * @example
+ * ```typescript
+ * const { k, d, j } = calcKDJ(dailyData);
+ * ```
+ */
+export declare function calcKDJ(data: OHLCV[], period?: number): {
+    k: (number | null)[];
+    d: (number | null)[];
+    j: (number | null)[];
+};
+/**
+ * 计算布林带（Bollinger Bands）
+ *
+ * 公式（标准参数 20, 2）：
+ *   MID = SMA(close, n)
+ *   StdDev = √(Σ(close − MID)² / n)
+ *   UPPER = MID + multiplier × StdDev
+ *   LOWER = MID − multiplier × StdDev
+ *
+ * 前 n-1 个位置为 null（数据不足）。
+ *
+ * @param data       - OHLCV 数组
+ * @param period     - 计算周期（默认 20）
+ * @param multiplier - 标准差倍数（默认 2）
+ * @returns 包含 upper、mid、lower 三个等长数组的对象
+ *
+ * @example
+ * ```typescript
+ * const { upper, mid, lower } = calcBollinger(dailyData, 20, 2);
+ * ```
+ */
+export declare function calcBollinger(data: OHLCV[], period?: number, multiplier?: number): {
+    upper: (number | null)[];
+    mid: (number | null)[];
+    lower: (number | null)[];
+};
+/**
+ * 计算指定位置的振幅
+ *
+ * 振幅 = (high − low) / prevClose × 100
+ *
+ * 首日（index = 0）因无前一日收盘价，返回 0。
+ *
+ * @param data  - OHLCV 数组
+ * @param index - 目标位置（从 0 开始）
+ * @returns 振幅百分比
+ *
+ * @example
+ * ```typescript
+ * const amp = calcAmplitude(dailyData, dailyData.length - 1);
+ * // 最新一天的振幅
+ * ```
+ */
+export declare function calcAmplitude(data: OHLCV[], index: number): number;
+/**
+ * 计算指定位置的涨跌幅
+ *
+ * 涨跌幅 = (close − prevClose) / prevClose × 100
+ *
+ * 首日（index = 0）因无前一日收盘价，返回 0。
+ *
+ * @param data  - OHLCV 数组
+ * @param index - 目标位置（从 0 开始）
+ * @returns 涨跌幅百分比
+ *
+ * @example
+ * ```typescript
+ * const pct = calcPriceChangePct(dailyData, dailyData.length - 1);
+ * // 最新一天的涨跌幅
+ * ```
+ */
+export declare function calcPriceChangePct(data: OHLCV[], index: number): number;
+//# sourceMappingURL=indicators.d.ts.map

package/dist/utils/indicators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indicators.d.ts","sourceRoot":"","sources":["../../src/utils/indicators.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAuBvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAyBxE;AAgDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,KAAK,EAAE,GACZ;IAAE,GAAG,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,SAAS,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;CAAE,CA0BlF;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAgDxE;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,KAAK,EAAE,EACb,MAAM,GAAE,MAAU,GACjB;IAAE,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;CAAE,CA8CtE;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,KAAK,EAAE,EACb,MAAM,GAAE,MAAW,EACnB,UAAU,GAAE,MAAU,GACrB;IAAE,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;CAAE,CAgChF;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAalE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAavE"}

package/dist/utils/indicators.js

@@ -0,0 +1,395 @@
+/**
+ * 技术指标计算工具模块
+ *
+ * 提供 A 股常用的技术分析指标计算函数。
+ * 所有函数接收 OHLCV 日行情数组，返回与输入等长的计算结果数组。
+ * 数据不足时对应位置填充 null。
+ *
+ * @module indicators
+ */
+// ─── 移动平均线 ───────────────────────────────────────────────
+/**
+ * 计算简单移动平均线（SMA）
+ *
+ * 公式：MA = (P₁ + P₂ + ... + Pₙ) / n
+ * 前 n-1 个位置为 null（数据不足）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - 计算周期（如 5、10、20）
+ * @returns 长度与 data 相同的数组，每个元素为对应周期的 MA 值或 null
+ *
+ * @example
+ * ```typescript
+ * const ma5 = calcMA(dailyData, 5);
+ * // ma5[4] 为第 1-5 天的平均值
+ * ```
+ */
+export function calcMA(data, period) {
+    const result = new Array(data.length).fill(null);
+    if (data.length < period || period <= 0) {
+        return result;
+    }
+    // 滑动窗口求和，避免每次重新遍历
+    let sum = 0;
+    // 填充第一个窗口
+    for (let i = 0; i < period; i++) {
+        sum += data[i].close;
+    }
+    result[period - 1] = sum / period;
+    // 滑动窗口
+    for (let i = period; i < data.length; i++) {
+        sum += data[i].close - data[i - period].close;
+        result[i] = sum / period;
+    }
+    return result;
+}
+/**
+ * 计算指数移动平均线（EMA）
+ *
+ * 公式：
+ *   multiplier = 2 / (n + 1)
+ *   EMA₁ = SMA(前 n 个 close)
+ *   EMAₜ = (closeₜ - EMAₜ₋₁) × multiplier + EMAₜ₋₁
+ *
+ * 前 n-1 个位置为 null（数据不足）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - 计算周期（如 12、26）
+ * @returns 长度与 data 相同的数组，每个元素为对应位置的 EMA 值或 null
+ */
+export function calcEMA(data, period) {
+    const result = new Array(data.length).fill(null);
+    if (data.length < period || period <= 0) {
+        return result;
+    }
+    const multiplier = 2 / (period + 1);
+    // 初始 EMA = 第一个周期的 SMA
+    let sum = 0;
+    for (let i = 0; i < period; i++) {
+        sum += data[i].close;
+    }
+    let prevEma = sum / period;
+    result[period - 1] = prevEma;
+    // 递推计算后续 EMA
+    for (let i = period; i < data.length; i++) {
+        const ema = (data[i].close - prevEma) * multiplier + prevEma;
+        result[i] = ema;
+        prevEma = ema;
+    }
+    return result;
+}
+// ─── MACD ──────────────────────────────────────────────────────
+/**
+ * 从可空数组中提取有效值及其索引，计算 EMA
+ *
+ * 内部辅助函数，用于对 DIF 序列计算 DEA。
+ *
+ * @param values - 可能包含 null 的数值数组
+ * @param period - EMA 周期
+ * @returns 长度与 values 相同的 EMA 计算结果数组
+ */
+function emaOnNullable(values, period) {
+    const result = new Array(values.length).fill(null);
+    // 收集所有非 null 值及其索引
+    const valid = [];
+    for (let i = 0; i < values.length; i++) {
+        if (values[i] !== null) {
+            valid.push({ value: values[i], index: i });
+        }
+    }
+    if (valid.length < period || period <= 0) {
+        return result;
+    }
+    const multiplier = 2 / (period + 1);
+    // 初始 EMA = 第一个周期的 SMA
+    let sum = 0;
+    for (let i = 0; i < period; i++) {
+        sum += valid[i].value;
+    }
+    let prevEma = sum / period;
+    result[valid[period - 1].index] = prevEma;
+    // 递推计算后续 EMA
+    for (let i = period; i < valid.length; i++) {
+        const ema = (valid[i].value - prevEma) * multiplier + prevEma;
+        result[valid[i].index] = ema;
+        prevEma = ema;
+    }
+    return result;
+}
+/**
+ * 计算 MACD 指标（指数平滑异同移动平均线）
+ *
+ * 标准参数 (12, 26, 9)：
+ *   DIF = EMA₁₂(close) − EMA₂₆(close)
+ *   DEA = EMA₉(DIF)
+ *   Histogram = 2 × (DIF − DEA)
+ *
+ * @param data - OHLCV 数组
+ * @returns 包含 DIF、DEA、Histogram 三个等长数组的对象
+ *
+ * @example
+ * ```typescript
+ * const { dif, dea, histogram } = calcMACD(dailyData);
+ * // 最后一个值为最新信号
+ * ```
+ */
+export function calcMACD(data) {
+    const ema12 = calcEMA(data, 12);
+    const ema26 = calcEMA(data, 26);
+    const length = data.length;
+    const dif = new Array(length).fill(null);
+    // DIF = EMA12 - EMA26（两者均非 null 时有效）
+    for (let i = 0; i < length; i++) {
+        if (ema12[i] !== null && ema26[i] !== null) {
+            dif[i] = ema12[i] - ema26[i];
+        }
+    }
+    // DEA = EMA9(DIF)
+    const dea = emaOnNullable(dif, 9);
+    // Histogram = 2 * (DIF - DEA)
+    const histogram = new Array(length).fill(null);
+    for (let i = 0; i < length; i++) {
+        if (dif[i] !== null && dea[i] !== null) {
+            histogram[i] = 2 * (dif[i] - dea[i]);
+        }
+    }
+    return { dif, dea, histogram };
+}
+// ─── RSI ──────────────────────────────────────────────────────
+/**
+ * 计算相对强弱指标（RSI）
+ *
+ * 使用 Wilder 平滑法（改良指数平均）：
+ *   1. 计算每日价格变动 Δ = closeₜ − closeₜ₋₁
+ *   2. 初始平均涨幅 = 前 n 个 Δ 中正值的平均值
+ *      初始平均跌幅 = 前 n 个 Δ 中负值绝对值的平均值
+ *   3. 后续平滑：
+ *      avgGainₜ = (avgGainₜ₋₁ × (n−1) + gainₜ) / n
+ *      avgLossₜ = (avgLossₜ₋₁ × (n−1) + lossₜ) / n
+ *   4. RS = avgGain / avgLoss
+ *      RSI = 100 − 100 / (1 + RS)
+ *
+ * 前 n 个位置为 null（需要 n+1 个价格才能计算第一个 RSI 值）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - RSI 计算周期（通常为 14）
+ * @returns 长度与 data 相同的 RSI 值数组
+ *
+ * @example
+ * ```typescript
+ * const rsi14 = calcRSI(dailyData, 14);
+ * ```
+ */
+export function calcRSI(data, period) {
+    const result = new Array(data.length).fill(null);
+    if (data.length < period + 1 || period <= 0) {
+        return result;
+    }
+    // 计算每日价格变化
+    const changes = new Array(data.length - 1);
+    for (let i = 1; i < data.length; i++) {
+        changes[i - 1] = data[i].close - data[i - 1].close;
+    }
+    // 初始平均涨幅/跌幅（前 period 个变化值）
+    let avgGain = 0;
+    let avgLoss = 0;
+    for (let i = 0; i < period; i++) {
+        const change = changes[i];
+        if (change > 0) {
+            avgGain += change;
+        }
+        else {
+            avgLoss += Math.abs(change);
+        }
+    }
+    avgGain /= period;
+    avgLoss /= period;
+    // 第一个 RSI 值（位于 index = period）
+    result[period] = avgLoss === 0
+        ? 100
+        : 100 - 100 / (1 + avgGain / avgLoss);
+    // 递推计算后续 RSI
+    for (let i = period + 1; i < data.length; i++) {
+        const change = changes[i - 1]; // changes[i-1] 对应 data[i]
+        const gain = change > 0 ? change : 0;
+        const loss = change < 0 ? Math.abs(change) : 0;
+        avgGain = (avgGain * (period - 1) + gain) / period;
+        avgLoss = (avgLoss * (period - 1) + loss) / period;
+        result[i] = avgLoss === 0
+            ? 100
+            : 100 - 100 / (1 + avgGain / avgLoss);
+    }
+    return result;
+}
+// ─── KDJ ──────────────────────────────────────────────────────
+/**
+ * 计算 KDJ 指标（随机指标）
+ *
+ * 标准参数 (9, 3, 3)：
+ *   1. RSV = (close − LLV) / (HHV − LLV) × 100
+ *      其中 LLV 为最近 period 周期的最低价，HHV 为最近 period 周期的最高价
+ *   2. Kₜ = ⅔ × Kₜ₋₁ + ⅓ × RSVₜ     （初始 K = 50）
+ *   3. Dₜ = ⅔ × Dₜ₋₁ + ⅓ × Kₜ       （初始 D = 50）
+ *   4. Jₜ = 3 × Kₜ − 2 × Dₜ
+ *
+ * 前 period-1 个位置为 null（数据不足）。
+ *
+ * @param data   - OHLCV 数组
+ * @param period - 周期（默认 9，即 RSV 的观察窗口）
+ * @returns 包含 K、D、J 三个等长数组的对象
+ *
+ * @example
+ * ```typescript
+ * const { k, d, j } = calcKDJ(dailyData);
+ * ```
+ */
+export function calcKDJ(data, period = 9) {
+    const length = data.length;
+    const k = new Array(length).fill(null);
+    const d = new Array(length).fill(null);
+    const j = new Array(length).fill(null);
+    if (data.length < period || period <= 0) {
+        return { k, d, j };
+    }
+    // K/D 初始值
+    let prevK = 50;
+    let prevD = 50;
+    for (let i = period - 1; i < length; i++) {
+        // 计算周期内最高价、最低价
+        let highestHigh = -Infinity;
+        let lowestLow = Infinity;
+        for (let jj = i - period + 1; jj <= i; jj++) {
+            if (data[jj].high > highestHigh)
+                highestHigh = data[jj].high;
+            if (data[jj].low < lowestLow)
+                lowestLow = data[jj].low;
+        }
+        // RSV 计算
+        const rsv = highestHigh === lowestLow
+            ? 50
+            : ((data[i].close - lowestLow) / (highestHigh - lowestLow)) * 100;
+        // K、D、J 递推
+        if (i === period - 1) {
+            k[i] = prevK; // 初始 K = 50
+            d[i] = prevD; // 初始 D = 50
+        }
+        else {
+            const currK = (2 / 3) * prevK + (1 / 3) * rsv;
+            const currD = (2 / 3) * prevD + (1 / 3) * currK;
+            k[i] = currK;
+            d[i] = currD;
+            prevK = currK;
+            prevD = currD;
+        }
+        j[i] = 3 * k[i] - 2 * d[i];
+    }
+    return { k, d, j };
+}
+// ─── 布林带 ───────────────────────────────────────────────────
+/**
+ * 计算布林带（Bollinger Bands）
+ *
+ * 公式（标准参数 20, 2）：
+ *   MID = SMA(close, n)
+ *   StdDev = √(Σ(close − MID)² / n)
+ *   UPPER = MID + multiplier × StdDev
+ *   LOWER = MID − multiplier × StdDev
+ *
+ * 前 n-1 个位置为 null（数据不足）。
+ *
+ * @param data       - OHLCV 数组
+ * @param period     - 计算周期（默认 20）
+ * @param multiplier - 标准差倍数（默认 2）
+ * @returns 包含 upper、mid、lower 三个等长数组的对象
+ *
+ * @example
+ * ```typescript
+ * const { upper, mid, lower } = calcBollinger(dailyData, 20, 2);
+ * ```
+ */
+export function calcBollinger(data, period = 20, multiplier = 2) {
+    const length = data.length;
+    const upper = new Array(length).fill(null);
+    const mid = new Array(length).fill(null);
+    const lower = new Array(length).fill(null);
+    if (data.length < period || period <= 0) {
+        return { upper, mid, lower };
+    }
+    for (let i = period - 1; i < length; i++) {
+        // 计算 SMA
+        let sum = 0;
+        for (let j = i - period + 1; j <= i; j++) {
+            sum += data[j].close;
+        }
+        const sma = sum / period;
+        mid[i] = sma;
+        // 计算标准差（总体标准差）
+        let variance = 0;
+        for (let j = i - period + 1; j <= i; j++) {
+            const diff = data[j].close - sma;
+            variance += diff * diff;
+        }
+        const stdDev = Math.sqrt(variance / period);
+        upper[i] = sma + multiplier * stdDev;
+        lower[i] = sma - multiplier * stdDev;
+    }
+    return { upper, mid, lower };
+}
+// ─── 辅助指标 ─────────────────────────────────────────────────
+/**
+ * 计算指定位置的振幅
+ *
+ * 振幅 = (high − low) / prevClose × 100
+ *
+ * 首日（index = 0）因无前一日收盘价，返回 0。
+ *
+ * @param data  - OHLCV 数组
+ * @param index - 目标位置（从 0 开始）
+ * @returns 振幅百分比
+ *
+ * @example
+ * ```typescript
+ * const amp = calcAmplitude(dailyData, dailyData.length - 1);
+ * // 最新一天的振幅
+ * ```
+ */
+export function calcAmplitude(data, index) {
+    if (index <= 0 || index >= data.length) {
+        return 0;
+    }
+    const { high, low } = data[index];
+    const prevClose = data[index - 1].close;
+    if (prevClose === 0) {
+        return 0;
+    }
+    return ((high - low) / prevClose) * 100;
+}
+/**
+ * 计算指定位置的涨跌幅
+ *
+ * 涨跌幅 = (close − prevClose) / prevClose × 100
+ *
+ * 首日（index = 0）因无前一日收盘价，返回 0。
+ *
+ * @param data  - OHLCV 数组
+ * @param index - 目标位置（从 0 开始）
+ * @returns 涨跌幅百分比
+ *
+ * @example
+ * ```typescript
+ * const pct = calcPriceChangePct(dailyData, dailyData.length - 1);
+ * // 最新一天的涨跌幅
+ * ```
+ */
+export function calcPriceChangePct(data, index) {
+    if (index <= 0 || index >= data.length) {
+        return 0;
+    }
+    const currentClose = data[index].close;
+    const prevClose = data[index - 1].close;
+    if (prevClose === 0) {
+        return 0;
+    }
+    return ((currentClose - prevClose) / prevClose) * 100;
+}
+//# sourceMappingURL=indicators.js.map

package/dist/utils/indicators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indicators.js","sourceRoot":"","sources":["../../src/utils/indicators.ts"],"names":[],"mappings":"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"}

package/dist/utils/signals.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 信号检测工具模块
+ *
+ * 基于技术指标识别买入/卖出信号。
+ * 用于在流水线中生成每日分析报告的 signals 字段。
+ *
+ * @module signals
+ */
+import { type OHLCV } from './indicators.js';
+/**
+ * 信号检测结果
+ *
+ * 包含常见的技术信号标记和辅助数值，
+ * 最终会被序列化为 JSON 存入 daily_analysis_report.signals 字段。
+ */
+export interface Signals {
+    /** 金叉：MA5 上穿 MA10 */
+    goldenCross: boolean;
+    /** 死叉：MA5 下穿 MA10 */
+    deadCross: boolean;
+    /** 超买：RSI14 > 80 */
+    overbought: boolean;
+    /** 超卖：RSI14 < 20 */
+    oversold: boolean;
+    /** 放量：当日成交量 > 前 5 日均量 × 2 */
+    volumeSpike: boolean;
+    /** 量比：当日成交量 / 前 5 日均量 */
+    volumeRatio: number;
+}
+/**
+ * 检测技术信号
+ *
+ * 综合判断金叉/死叉、超买/超卖、放量等信号。
+ *
+ * 金叉/死叉判断逻辑：
+ *   计算 MA5 和 MA10 完整序列，取最后一个有效值及其前一个值进行比较。
+ *   金叉条件：前值 MA5 ≤ MA10 且 现值 MA5 > MA10
+ *   死叉条件：前值 MA5 ≥ MA10 且 现值 MA5 < MA10
+ *
+ * 量比逻辑：
+ *   取最后 5 个交易日（不含当日）成交量的平均值作为基准，
+ *   量比 = 当日成交量 / 基准均量。
+ *
+ * @param data        - 完整 OHLCV 数组（按日期升序排列）
+ * @param latestMA    - 当前最新的 MA5 与 MA10 值（由调用方预计算传入）
+ * @param latestRSI14 - 当前最新的 RSI14 值（由调用方预计算传入）
+ * @returns 信号检测结果
+ *
+ * @example
+ * ```typescript
+ * const ma5 = calcMA(data, 5);
+ * const ma10 = calcMA(data, 10);
+ * const rsi14 = calcRSI(data, 14);
+ * const signals = detectSignals(
+ *   data,
+ *   { ma5: ma5[ma5.length - 1], ma10: ma10[ma10.length - 1] },
+ *   rsi14[rsi14.length - 1]
+ * );
+ * ```
+ */
+export declare function detectSignals(data: OHLCV[], latestMA: {
+    ma5: number | null;
+    ma10: number | null;
+}, latestRSI14: number | null): Signals;
+//# sourceMappingURL=signals.d.ts.map

package/dist/utils/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/utils/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAU,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIrD;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,qBAAqB;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,KAAK,EAAE,EACb,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACrD,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAaT"}