# igapi-rs LLM 索引

> 本文件只作为面向模型的入口索引。实际 API 摘要按使用面拆分维护，避免 Rust / Python / CLI 互相覆盖或漂移。

## 必读文件

正式版线上直链（默认推荐）：

- `https://igapi-rs.es007.com/latest/llms-rust.txt` — Rust core / `igapi-core` API 速查。
- `https://igapi-rs.es007.com/latest/llms-python.txt` — Python binding / `igapi-rs` / `import igapi` API 速查。
- `https://igapi-rs.es007.com/latest/llms-cli.txt` — CLI / `igapi-cli` / `ig-cli` 命令速查。
- `https://igapi-rs.es007.com/latest/llms-full.txt` — 面向模型的维护规则与三份摘要文件的职责说明。

版本固定直链（用于复现某个发布版本的 API）：

- `https://igapi-rs.es007.com/{version}/llms-rust.txt`
- `https://igapi-rs.es007.com/{version}/llms-python.txt`
- `https://igapi-rs.es007.com/{version}/llms-cli.txt`
- `https://igapi-rs.es007.com/{version}/llms-full.txt`

开发预览直链（仅对应当前开发文档，可能早于或晚于 PyPI 正式版）：

- `https://igapi-rs.es007.com/dev/llms-rust.txt`
- `https://igapi-rs.es007.com/dev/llms-python.txt`
- `https://igapi-rs.es007.com/dev/llms-cli.txt`
- `https://igapi-rs.es007.com/dev/llms-full.txt`

仓库源码路径：

- `docs/llms-rust.txt`
- `docs/llms-python.txt`
- `docs/llms-cli.txt`
- `docs/llms-full.txt`

## 同步规则

- 文件名即职责边界：`llms-rust.txt` 对应 Rust，`llms-python.txt` 对应 Python，`llms-cli.txt` 对应 CLI。
- Rust core 新增、删除或修改用户级能力时，必须先更新 `llms-rust.txt`。
- Python 绑定新增、删除或修改用户级能力时，必须更新 `llms-python.txt`。
- CLI 命令、参数、help 或“库 API only”范围变化时，必须更新 `llms-cli.txt`。
- 不允许用 `llms-python.txt` 代替 Rust 或 CLI 摘要，也不允许把三端 API 合并回 `llms.txt`。
- 若某个 Rust 能力不暴露到 Python，必须在 `llms-python.txt` 写明原因。
- 若某个用户操作能力不进入 CLI，必须在 `llms-cli.txt` 标注 `库 API only` 或说明不适合 CLI 的理由。