# vendor/ — 第三方源码依赖

本目录存放项目编译所需的第三方 Rust crate 源码,确保项目在任意机器上无需外部网络即可编译。

## 内容

### ferro-ta-main/

- **来源**: https://github.com/pratikbhadane24/ferro-ta (v1.2.0)
- **用途**: 提供 `ferro_ta_core` crate — 80+ 技术指标的 Rust 原生实现
- **使用方式**: 主项目 [Cargo.toml](../Cargo.toml) 通过 path 依赖引用:
  ```toml
  ferro_ta_core = { path = "vendor/ferro-ta-main/crates/ferro_ta_core", default-features = false }
  ```
- **我们只用**: `crates/ferro_ta_core/` 子 crate (纯 Rust, 无 PyO3 依赖)
- **未使用部分**: ferro-ta-main 根目录的 Python 包、benchmark、fuzz、docs 等保留但未集成

## 维护规则

1. **必须随项目提交**: 换电脑/部署新环境时,这是编译依赖的唯一来源
2. **不要修改 vendor/ 下的源码**: 如需修改,在主项目代码中通过 wrapper 适配
3. **更新依赖时**: 替换整个 ferro-ta-main/ 目录,并同步更新本 README 的版本号
4. **编译产物自动忽略**: ferro-ta-main/.gitignore 已排除 target/、*.pyd、*.so 等