Halro 文档

一个 Go 单二进制，在应用与上游模型服务之间统一处理凭据、预算、路由、脱敏、审计和用量核算。

v0.8.5 → v0.9 升级指南配置迁移、单向数据升级、磁盘历史、模型发现、幂等与 v0.9.1 补丁边界。

核心对象模型Credential → Provider → Deployment → Route → Project → Gateway Key；Provider 可选绑定独立出站代理。

首次配置 Admin Console从上游凭据、模型能力和价格，一直配置到 Project、Gateway Key 与首个受控请求。

版本化定价与成本治理组合 Price Version、Project 硬边界、Token Guard 和 experimental Run 预算。

认证、请求头与错误Key、治理 Scope、Run 归因请求头、限流与错误处理。

接入运行治理从 Work Unit、Run、模型调用到业务 Outcome 和单位成功成本。

交接 FinOps生成并验证 Usage 与 Governance 本地导出，处理水位、幂等和 partial。

生产运维与恢复健康检查、完整性工具、告警、备份恢复、Master Key 与事故处置入口。

媒体与资源 API按当前构建可用性调用媒体、Files 与 Batches，并正确处理幂等和资源归属。

最佳实践案例库按真实场景组合 Project、路由、预算、Run、延迟响应、安全与运维能力。

Run Governance API生命周期、幂等、权限、请求字段、修订和失败语义。

Chat Completions字段表、Provider 覆盖矩阵与已声明的偏差，由兼容性契约生成。

实验性端点一览由当前 Halro 兼容性契约生成的实验性端点、语义与偏差。