第六版

chanlun-py/src/structure_py.rs

@@ -34,6 +34,19 @@ use crate::types_py::{分型结构Py, 相对方向Py, 缺口Py};
 
 // ========== 分型 ==========
 
+/// 分型 — 由左中右三根缠论K线构成的顶/底分型。
+///
+/// 属性 (只读):
+///   左: 缠论K线|None / 中: 缠论K线 / 右: 缠论K线|None
+///   结构: 分型结构 — 上/下/顶/底/散
+///   时间戳: int / 分型特征值: float / 强度: str
+///   关系组: (相对方向, 相对方向, 相对方向)|None — 左中、中右、左右的相对方向
+///   与MACD柱子分型匹配: bool|None — MACD 柱状图是否与分型结构一致
+///
+/// 类方法:
+///   判断分型(缠K序列, 索引, 配置) -> 分型|None — 在缠K序列中指定位置尝试创建分型
+///   从缠K序列中获取分型(缠K序列, 配置) -> list[分型] — 扫描全序列提取所有分型
+///   向序列中添加(分型序列, 新分型) — 维护分型序列的顺序一致性
 #[pyclass(name = "分型", unsendable)]
 #[derive(Clone)]
 pub struct 分型Py {
@@ -177,6 +190,34 @@ impl 分型Py {
 
 // ========== 虚线 ==========
 
+/// 虚线 — 笔/线段的通用数据结构，持有一组分型端点（文=起点分型, 武=终点分型）。
+///
+/// 属性 (只读):
+///   标识: str — "笔" / "线段" / "扩展线段" 等
+///   序号: int / 级别: int / 有效性: bool / 模式: str
+///   文: 分型 — 起点分型
+///   武: 分型 — 终点分型
+///   方向: 相对方向 — 根据文/武高低判定
+///   高: float (计算) / 低: float (计算)
+///   确认K线: 缠论K线|None / 前一缺口: 缺口|None
+///   前一结束位置: 虚线|None / 短路修正: bool
+///   基础序列: list[虚线] — 构成该虚线的子级虚线序列
+///   实_中枢序列: list[中枢] / 虚_中枢序列: list[中枢] / 合_中枢序列: list[中枢]
+///   笔序列: list[虚线] (计算) — 递归获取所有笔
+///
+/// 方法:
+///   之前是(其他虚线) -> bool — 判断当前虚线是否紧接在另一虚线之前
+///   之后是(其他虚线) -> bool — 判断当前虚线是否紧接在另一虚线之后
+///   获取普K序列(普K序列) -> list[K线] — 截取该虚线的原始K线范围
+///   获取缠K序列(缠K序列) -> list[缠论K线] — 截取该虚线的缠K范围
+///   获取数据文本() -> str
+///
+/// 类方法（算法辅助）:
+///   创建笔(序号, 标识, 文, 武, 级别) / 创建线段(...)
+///   缠K买卖点模式(缠K) / 买卖点配置匹配 / 买卖点任意匹配 / 买卖点全量匹配 / 买卖点相对匹配
+///   计算MACD柱子均值 / 武之全量MACD均值 / 武之MACD均值 / 武之MACD极值
+///   计算K线序列MACD趋向背驰 / 买卖意义 / 计算MACD柱子分段
+///   密集区域按间隔 / 统计MACD行为
 #[pyclass(name = "虚线", unsendable)]
 #[derive(Clone)]
 pub struct 虚线Py {
@@ -694,6 +735,23 @@ impl 虚线Py {
 
 // ========== 线段特征 ==========
 
+/// 线段特征 — 特征序列元素构成的集合，支持 list-like 索引访问。
+///
+/// 实现 __getitem__ / __len__ / __iter__，可像 list 一样遍历。
+///
+/// 属性 (只读):
+///   文: 分型 — 特征序列的起点分型
+///   武: 分型 — 特征序列的终点分型
+///   方向: 相对方向 / 高: float / 低: float
+///
+/// 方法:
+///   添加(虚线) — 向特征序列追加虚线元素
+///   删除(虚线) — 从特征序列移除虚线元素
+///
+/// 类方法:
+///   新建(序号, 文, 武, 基础序列?) -> 线段特征
+///   静态分析(虚线序列, 配置) -> 线段特征|None
+///   获取分型序列(虚线序列, 配置) -> list[线段特征]
 #[pyclass(name = "线段特征", unsendable)]
 #[derive(Clone)]
 pub struct 线段特征Py {
@@ -881,6 +939,11 @@ impl 线段特征Py {
 
 // ========== 特征分型 ==========
 
+/// 特征分型 — 线段特征序列中的分型节点。
+///
+/// 属性 (只读):
+///   左: 线段特征|None / 中: 线段特征 / 右: 线段特征|None
+///   结构: 分型结构 — 顶/底分型判定结果
 #[pyclass(name = "特征分型", unsendable)]
 #[derive(Clone)]
 pub struct 特征分型Py {