模块索引
Basalt 按包组织 API。每个模块一页，页内按类型分组，类型下依次列出构造器、方法与字段。
| 模块 | 公开类型 | 职责 |
|---|---|---|
basalt | 11 | 统一门面：一次创建上下文，取张量、模块、优化器，并转发经典模型入口。 |
basalt.core | 16 | 基础数据层：行主序矩阵、布局标记、原生经典核、模型容器读写原语。 |
basalt.data | 6 | BasaltD 数据管线：流式与内存映射两条读取路径、标准化参数。 |
basalt.io | 7 | 模型持久化：.bsl v2 容器（magic + kind + 长度 + CRC32C）。 |
basalt.ml | 102 | 经典机器学习：线性模型、近邻、SVM、树、梯度提升、聚类、降维、朴素贝叶斯、指标与切分。 |
basalt.nn | 36 | 手写神经网络层：Dense / Conv2D / RNN / LSTM / GRU / 注意力、序列训练与序列化。 |
basalt.nativebridge | 8 | 原生桥接专家层：上下文、张量句柄、128 字节指令队列、自动求导入口。 |
basalt.torch | 39 | PyTorch 风格 eager API：动态张量、Module 组合、原生 autograd、优化器与损失。 |
basalt.concurrent | 1 | 批量推理编排：虚拟线程 + 信号量限流。 |
阅读顺序建议
先读
jsl门面，确认创建上下文与取模块的方式。张量训练走
basalt.torch；经典模型走basalt.ml。需要手写算子或排查生命周期时读
basalt.nativebridge。