GitHub 技术参考
以下入口由 sync/contract.json 生成,指向 octafuse-gateway 仓库内的权威技术文档。官网只维护面向使用者的轻量指南;API、部署、迁移、架构和行为语义以 gateway 仓库为准。
快速开始 Docker 与 Cloudflare 本地 D1 的最小启动路径。
用户侧 API OpenAI / Anthropic / Gemini 兼容入口、模型列表、预算状态。
Admin HTTP API Provider、模型、路由、用户、密钥、配置和日志自动化接口。
Docker / 自托管 Docker 镜像、Compose、GHCR、Postgres / MySQL 和 Zeabur 注意事项。
| Doc | 内容 |
|---|---|
| 文档总入口 | 按使用者、开发者、运维者和维护者组织的入口。 |
| 快速开始 | Docker 与 Cloudflare 本地 D1 的最小启动路径。 |
| Admin 配置指南 | 部署后配置 Provider、Route、用户和 API Key。 |
开发者与集成
Section titled “开发者与集成”| Doc | 内容 |
|---|---|
| 系统集成指南 | 门户、后台或 SaaS 接入 Gateway 的边界、Key 类型和常见流程。 |
| API 总览 | Proxy / Admin 的 Base URL、认证方式和错误形态。 |
| 用户侧 API | OpenAI / Anthropic / Gemini 兼容入口、模型列表、预算状态。 |
| Admin HTTP API | Provider、模型、路由、用户、密钥、配置和日志自动化接口。 |
| 本地开发与测试 | D1、Node + Postgres、Node + MySQL、Docker 和冒烟脚本组合。 |
架构与行为语义
Section titled “架构与行为语义”| Doc | 内容 |
|---|---|
| 运行时与数据存储架构 | Cloudflare / Node 与 D1 / Postgres / MySQL 的组合矩阵。 |
| Proxy 请求生命周期 | 鉴权、路由、限流、熔断、粘性、failover 和异步记账。 |
| 用户与 API Key 数据模型 | User、API Key、预算、请求日志和审计日志的关系与约束。 |
| 流式计费与取消 | 流式 Chat、客户端取消、usage 解析和扣费状态。 |
| 时间与时区 | UTC 存储、API 输出、Admin 显示和业务日界。 |
| Doc | 内容 |
|---|---|
| 部署模式索引 | Cloudflare、Hybrid、Full self-hosted、MySQL 和 Zeabur 模式总览。 |
| Cloudflare 部署 | Worker、Admin、D1、Build variables、Workers Builds 和迁移顺序。 |
| Docker / 自托管 | Docker 镜像、Compose、GHCR、Postgres / MySQL 和 Zeabur 注意事项。 |
| D1 ↔ Postgres 切换 | ETL、对账、灰度、切换和回滚要点。 |
| Cloudflare 命令速查 | Cloudflare 本地、dev 演示和生产 Git 自动部署命令清单。 |
维护者与规范
Section titled “维护者与规范”| Doc | 内容 |
|---|---|
| 版本治理与发版 | Changesets、Version PR、tag、GitHub Release 和 GHCR 镜像。 |
| 文档边界与敏感信息规范 | 仓内文档分层、官网边界、占位符和禁止值。 |
| curl 最小示例 | 健康检查、用户推理和 Admin 配置接口的最小 curl。 |