性能: 共享httpx连接池/设置缓存/复合索引自动补建/GZip/分页 ; 商业化v1: APIKey(sha256+scope+限流)/用量账本/版本化端点
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user