chanlun 26.6.4

基于缠论(缠中说禅)理论的量化技术分析核心库,支持流式数据处理和多周期联立分析。
Documentation
/*
 * MIT License
 *
 * Copyright (c) 2026 YuYuKunKun
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

use crate::kline::chan_kline::缠论K线;
use crate::types::分型结构;
use crate::types::相对方向;
use crate::warn;
use std::sync::Arc;
use std::sync::atomic::AtomicBool;
use std::sync::atomic::Ordering;

/// 分型模式 — True 时使用构造时缓存值(默认),False 时从 中 缠K 实时读取
pub static 分型模式: AtomicBool = AtomicBool::new(true);

/// 分型 — 由左中右三根缠论K线构成的顶/底分型。
///
/// 字段:
///   左: 左侧缠K(可能为 None,表示序列起始处分型左翼缺失)
///   中: 中间缠K(必须存在),分型的核心K线,其 `分型` 字段记录了该位置的分型结构
///   右: 右侧缠K(可能为 None,表示序列末尾处分型右翼缺失)
///   结构: 构造时从 `中.分型` 缓存的分型结构(上/下/顶/底/散)
///   时间戳: 构造时从 `中.时间戳` 缓存的时刻
///   分型特征值: 构造时从 `中.分型特征值` 缓存的值
///
/// "分型模式" 全局开关控制 时间戳/结构/分型特征值 的读取行为:
///   True(默认)— 返回构造时缓存值;False — 从 中 缠K 实时读取
#[derive(Debug, Clone)]
pub struct 分型 {
    /// 左侧缠K(序列起始处分型可能为 None)
    pub : Option<Arc<缠论K线>>,
    /// 中间缠K(必须存在)
    pub : Arc<缠论K线>,
    /// 右侧缠K(序列末尾处分型可能为 None)
    pub : Option<Arc<缠论K线>>,
    /// 构造时缓存的 分型结构(上/下/顶/底/散)
    pub 结构: 分型结构,
    /// 构造时缓存的 时间戳
    pub 时间戳: i64,
    /// 构造时缓存的 分型特征值(历史高低点极值)
    pub 分型特征值: f64,
}

impl 分型 {
    pub fn new(
        : Option<Arc<缠论K线>>, : Arc<缠论K线>, : Option<Arc<缠论K线>>
    ) -> Self {
        if let (Some(), Some()) = (&, &) {
            assert!(.时间戳.load(Ordering::Relaxed) <.时间戳.load(Ordering::Relaxed)
                    &&.时间戳.load(Ordering::Relaxed) <.时间戳.load(Ordering::Relaxed),
                "分型时间戳断言失败: 左={}, 中={}, 右={}",.时间戳.load(Ordering::Relaxed),.时间戳.load(Ordering::Relaxed),.时间戳.load(Ordering::Relaxed),
            );
        }
        let 结构 =.分型.read().unwrap_or(分型结构::);
        let 时间戳 =.时间戳.load(Ordering::Relaxed);
        let 分型特征值 =.分型特征值.get();
        Self {,,,
            结构,
            时间戳,
            分型特征值,
        }
    }

    /// 时间戳 — 根据 分型模式 决定返回缓存值(True)或实时值(False)
    pub fn 时间戳(&self) -> i64 {
        if 分型模式.load(Ordering::Relaxed) {
            self.时间戳
        } else {
            self..时间戳.load(Ordering::Relaxed)
        }
    }

    /// 结构 — 根据 分型模式 决定返回缓存值(True)或实时值(False)
    pub fn 结构(&self) -> 分型结构 {
        if 分型模式.load(Ordering::Relaxed) {
            self.结构
        } else {
            self..分型.read().unwrap_or(分型结构::) // FIXME 错误
        }
    }

    /// 分型特征值 — 根据 分型模式 决定返回缓存值(True)或实时值(False)
    pub fn 分型特征值(&self) -> f64 {
        if 分型模式.load(Ordering::Relaxed) {
            self.分型特征值
        } else {
            self..分型特征值.get()
        }
    }

    /// 左中右三组关系
    pub fn 关系组(&self) -> Option<(相对方向, 相对方向, 相对方向)> {
        let= self..as_ref()?;
        let= self..as_ref()?;
        Some((
            相对方向::分析(..get(),..get(), self...get(), self...get()),
            相对方向::分析(self...get(), self...get(),..get(),..get()),
            相对方向::分析(..get(),..get(),..get(),..get()),
        ))
    }

    /// 分型强度 — 返回 "强"/"中"/"弱"/"未知"
    pub fn 强度(&self) -> &str {
        if self.结构() != 分型结构::&& self.结构() != 分型结构::{
            return "未知";
        }
        if self..is_none() || self..is_none() {
            return "未知";
        }

        if let Some(ref 关系组) = self.关系组() {
            if self.结构() == 分型结构::{
                if 关系组.2.是否向下() {
                    return "";
                } else if 关系组.2.是否向上() {
                    return "";
                } else {
                    return "";
                }
            } else if self.结构() == 分型结构::{
                if 关系组.2.是否向上() {
                    return "";
                } else if 关系组.2.是否向下() {
                    return "";
                } else {
                    return "";
                }
            }
        }

        if let (Some(), Some()) = (&self., &self.) {
            if self.结构() == 分型结构::{
                if.标的K线.read().收盘价 >.标的K线.read().{
                    return "";
                } else if.标的K线.read().收盘价 > self..标的K线.read().{
                    return "";
                } else {
                    return "";
                }
            } else if self.结构() == 分型结构::{
                if.标的K线.read().收盘价 <.标的K线.read().{
                    return "";
                } else if.标的K线.read().收盘价 < self..标的K线.read().{
                    return "";
                } else {
                    return "";
                }
            }
        }
        "未知"
    }

    /// MACD柱子分型匹配 — 检查左中右MACD柱形成顶/底形态
    pub fn 与MACD柱子分型匹配(&self) -> bool {
        if let (Some(), Some()) = (&self., &self.) {
            if self.结构() == 分型结构::{
                let 左_k =.标的K线.read();
                let 中_k = self..标的K线.read();
                let 右_k =.标的K线.read();
                let 左_m = 左_k.指标.read();
                let 中_m = 中_k.指标.read();
                let 右_m = 右_k.指标.read();
                if let (Some(左macd), Some(中macd), Some(右macd)) =
                    (左_m.macd(), 中_m.macd(), 右_m.macd())
                {
                    return 左macd.MACD柱 > 中macd.MACD柱 && 中macd.MACD柱 < 右macd.MACD柱;
                }
            }
            if self.结构() == 分型结构::{
                let 左_k =.标的K线.read();
                let 中_k = self..标的K线.read();
                let 右_k =.标的K线.read();
                let 左_m = 左_k.指标.read();
                let 中_m = 中_k.指标.read();
                let 右_m = 右_k.指标.read();
                if let (Some(左macd), Some(中macd), Some(右macd)) =
                    (左_m.macd(), 中_m.macd(), 右_m.macd())
                {
                    return 左macd.MACD柱 < 中macd.MACD柱 && 中macd.MACD柱 > 右macd.MACD柱;
                }
            }
        }
        false
    }

    /// 判断两个分型是否匹配
    pub fn 判断分型(: &Arc<分型>, : &Arc<分型>, _模式: &str) -> bool {
        Arc::ptr_eq(,)
    }

    /// 从缠K序列中获取以指定缠K为中元素的分型
    pub fn 从缠K序列中获取分型(
        K线序列: &[Arc<缠论K线>],
        : &Arc<缠论K线>,
    ) -> Option<Self> {
        let idx = K线序列.iter().position(|k| Arc::ptr_eq(k,))?;
        let= if idx > 0 {
            Some(Arc::clone(&K线序列[idx - 1]))
        } else {
            None
        };
        let= if idx + 1 < K线序列.len() {
            Some(Arc::clone(&K线序列[idx + 1]))
        } else {
            None
        };
        Some(Self::new(, Arc::clone(),))
    }

    /// 向分型序列中添加新分型
    pub fn 向序列中添加(分型序列: &mut Vec<Arc<分型>>, 当前分型: Arc<分型>) {
        if 分型序列.is_empty() {
            if 当前分型.结构() != 分型结构::&& 当前分型.结构() != 分型结构::{
                panic!("首次添加分型不为 顶底 {:?}", 当前分型);
            }
        } else {
            let 前一个 = &分型序列[分型序列.len() - 1];
            if 前一个.结构() == 当前分型.结构() {
                panic!("分型相同无法添加 {:?} {:?}", 前一个, 当前分型);
            }
            if 前一个..is_none() {
                warn!("分型.向序列中添加, 分型异常 {:?}", 前一个);
            }
        }
        分型序列.push(当前分型);
    }

    /// 结构化相等校验 — 递归校验左/中/右缠伦K线 + 自有缓存字段,返回 (是否相等, 差异描述)
    pub fn 相等(&self, other: &Self, 浮点容差: f64) -> (bool, String) {
        match (&self., &other.) {
            (None, None) => {}
            (Some(a), Some(b)) => {
                let (eq, msg) = a.相等(b, 浮点容差);
                if !eq {
                    return (false, format!("分型: [左]缠论K线异常 >> {msg}"));
                }
            }
            (a, b) => {
                return (
                    false,
                    format!("分型: [左]空值不一致 A={},B={}", a.is_some(), b.is_some()),
                );
            }
        }
        {
            let (eq, msg) = self..相等(&other., 浮点容差);
            if !eq {
                return (false, format!("分型: [中]缠论K线异常 >> {msg}"));
            }
        }
        match (&self., &other.) {
            (None, None) => {}
            (Some(a), Some(b)) => {
                let (eq, msg) = a.相等(b, 浮点容差);
                if !eq {
                    return (false, format!("分型: [右]缠论K线异常 >> {msg}"));
                }
            }
            (a, b) => {
                return (
                    false,
                    format!("分型: [右]空值不一致 A={},B={}", a.is_some(), b.is_some()),
                );
            }
        }
        if self.结构 != other.结构 {
            return (
                false,
                format!("分型: [结构] 不等 A={},B={}", self.结构, other.结构),
            );
        }
        if self.时间戳 != other.时间戳 {
            return (
                false,
                format!("分型: [时间戳] 不等 A={},B={}", self.时间戳, other.时间戳),
            );
        }
        if (self.分型特征值 - other.分型特征值).abs() > 浮点容差 {
            return (
                false,
                format!(
                    "分型: [分型特征值] 浮点超限 A={:.10},B={:.10}",
                    self.分型特征值, other.分型特征值
                ),
            );
        }
        (true, "分型: 全部字段一致".into())
    }
}

impl crate::types::fractal::有高低 for 分型 {
    fn (&self) -> f64 {
        self...get()
    }
    fn (&self) -> f64 {
        self...get()
    }
}

impl std::fmt::Display for 分型 {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(
            f,
            "{}<{}, {}, None: {}, None: {}>",
            self.结构(),
            self.时间戳(),
            crate::utils::format_f64_g(self.分型特征值()),
            if self..is_none() { "True" } else { "False" },
            if self..is_none() { "True" } else { "False" },
        )
    }
}