性能: 共享httpx连接池/设置缓存/复合索引自动补建/GZip/分页 ; 商业化v1: APIKey(sha256+scope+限流)/用量账本/版本化端点

This commit is contained in:
zhiqui
2026-11-15 01:37:59 +08:00
parent 18ae7e1f9d
commit 495083f9b4
7 changed files with 283 additions and 32 deletions
+15
View File
@@ -33,3 +33,18 @@ OMO_FIRST_ADMIN_PASS=maopaoya-admin
- 数据库切换只需改 DATABASE_URL(可选依赖: `uv sync --extra mysql` 或 `--extra postgres`)
- 数据访问统一走 `app/db/repos.py` 仓储层
- Alembic 迁移: `uv run alembic init migrations` 后接入 `app.db.session.Base.metadata`
## 商业化 API(v1 稳定契约)
- 前缀 `/v1`,独立于 `/api` 演进;契约只加字段不改语义
- 认证:`X-API-Key` 头(sha256 落库,明文仅创建时返回一次)
- scope:`chat`(仅对话)/ `full`(含角色读取);每 key 独立限流(req/min)
- 端点:`GET /v1/ping`、`POST /v1/keys`、`GET /v1/keys`、`DELETE /v1/keys/{id}`、
`GET /v1/usage`(用量账本,计费底座)、`GET /v1/characters`、`POST /v1/chat`
- 多实例部署时限流换 Redis(现为进程内滑动窗口)
## 性能
- 全局 httpx 连接池复用(不再每请求握手)
- 站点设置进程内缓存(写时失效)
- 复合索引覆盖热查询路径(消息/记忆/朋友圈/会话),旧表启动时自动补建
- GZip 响应压缩(>1KB)
- 部署建议:`uvicorn app.main:app --workers 2` 或 nginx 反代 + 多 worker;量大切 PG