第六版

chanlun-py/src/kline_py.rs

@@ -32,6 +32,25 @@ use crate::types_py::相对方向Py;
 
 // ========== K线 ==========
 
+/// 原始 K 线 — OHLCV 数据，可内嵌 MACD/RSI/KDJ 指标。
+///
+/// 属性（大部分可读写）:
+///   标识: str / 序号: int / 周期: int (秒) / 时间戳: int (Unix秒)
+///   高: float / 低: float / 开盘价: float / 收盘价: float / 成交量: float
+///   方向: 相对方向 (只读) — 根据开盘价vs收盘价判定
+///   MACD: 平滑异同移动平均线|None (只读)
+///   RSI: 相对强弱指数|None (只读)
+///   KDJ: 随机指标|None (只读)
+///
+/// 类方法:
+///   创建普K(标识, 时间戳, 开盘价, 最高价, 最低价, 收盘价, 成交量, 序号?, 周期?) -> K线
+///      — 快捷构造普通K线
+///   读取大端字节数组(bytes, 周期, 标识?) -> K线
+///      — 从大端字节序二进制数据反序列化（兼容 .dat/.nb 文件格式）
+///   保存到DAT文件(路径, K线序列) -> 写入 .dat 二进制文件
+///   获取MACD(K线序列, 计算方式, 快线周期?, 慢线周期?, 信号周期?) -> list[平滑异同移动平均线]
+///      — 对整个K线序列批量计算 MACD
+///   截取(序列, 起点K线, 终点K线) -> list — 按时间戳截取K线区间
 #[pyclass(name = "K线")]
 #[derive(Clone)]
 pub struct K线Py {
@@ -287,6 +306,23 @@ impl K线Py {
 
 // ========== 缠论K线 ==========
 
+/// 缠论K线 — 经包含处理后的标准化K线，有方向（向上/向下）、分型结构标记。
+///
+/// 属性 (只读):
+///   序号: int / 时间戳: int (Unix秒) / 高: float / 低: float / 周期: int / 标识: str
+///   方向: 相对方向 — K线运行方向（向上/向下）
+///   分型: 分型结构|None — 当前K线在分型中的角色
+///
+/// 类方法:
+///   时间戳对齐(缠K序列, 参照K线或时间戳) -> int
+///      — 在缠K序列中找到与参照最接近的时间戳
+///   创建缠K(普K, 指示器) -> 缠论K线
+///      — 从普通K线创建缠论K线
+///   兼并(缠K序列, 方向, 配置, 需要特定强度?) -> list[缠论K线]
+///      — 根据方向进行K线包含处理（合并）
+///   分析(缠K序列, 配置, 可以逆序包含?, 忽视顺序包含?, 可以逆序包含新?) -> (str, 分型|None)
+///      — 分析分型形成结果
+///   截取(序列, 起点分型, 终点分型) -> list — 截取分型间的缠K子序列
 #[pyclass(name = "缠论K线", unsendable)]
 #[derive(Clone)]
 pub struct 缠论K线Py {