diff --git a/ai_knowledge_base_v2/development_records/2026-07-08-concurrency-optimization-plan.md b/ai_knowledge_base_v2/development_records/2026-07-08-concurrency-optimization-plan.md index 8c41f24..58ed4ff 100644 --- a/ai_knowledge_base_v2/development_records/2026-07-08-concurrency-optimization-plan.md +++ b/ai_knowledge_base_v2/development_records/2026-07-08-concurrency-optimization-plan.md @@ -452,3 +452,25 @@ 1. 当前 Redis 缓存 TTL 仍复用进程内缓存的 5 分钟默认值。 2. 同步旧飞书链路暂未接入 Redis 缓存,用户端 async 问答链路已接入。 3. 后续可以在系统设置开放飞书缓存 TTL、缓存清理和单知识库刷新能力。 + +## 阶段 5 实施计划 + +目标:补齐生产部署时必须可调的 worker、数据库连接池和压测工具,方便后续基于数据调参。 + +实施范围: + +1. 后端启动支持 `BACKEND_WORKERS` 环境变量。 +2. SQLAlchemy 连接池支持环境变量配置: + - `DB_POOL_SIZE` + - `DB_MAX_OVERFLOW` + - `DB_POOL_TIMEOUT` + - `DB_POOL_RECYCLE` +3. `.env.example` 和 dev compose 补齐对应配置。 +4. 新增一个轻量聊天压测脚本,用于并发请求 `/chat/completions`,输出成功数、错误数、首包耗时、总耗时。 +5. 文档记录默认值和调参建议。 + +风险控制: + +1. dev 环境默认仍使用 1 个 worker,避免本地调试时多 worker 日志和热更新混乱。 +2. 生产可以通过环境变量调高 worker,不需要改代码。 +3. 压测脚本只作为研发/验收工具,不进入应用启动链路。