diff --git a/OPTIMIZATION_BACKLOG.md b/OPTIMIZATION_BACKLOG.md index 928d703..708c891 100644 --- a/OPTIMIZATION_BACKLOG.md +++ b/OPTIMIZATION_BACKLOG.md @@ -10,6 +10,9 @@ | 生成时间 | 2026-09-14 | | 代码基线 | `lpt-be` c961157 / `lpt-fe` e66bdb7 / `lpt-ai` 200f088 / `lpt-infra` 0a23075 / `lpt-docs` 9cb9c75 | | 核对方式 | 通读上述仓库源码 + 对线上 prod/dev 做只读探测(见附录 A) | +| 复核时间 | 2026-10-08 | +| 复核基线 | `lpt-be` 04d1f40 / `lpt-fe` 99a1b16 / `lpt-ai` bf56c2b / `lpt-infra` 34f2380 / `lpt-docs` a16cb4c | +| 复核结论 | P0 三条(会话-01/02/03)均仍未修;会话-04 仍无 `@Scheduled`;AI-03 已修(见条目)。新增基础设施变更:时区固定、LLM 切换为 DeepSeek(不影响本清单条目) | 若某仓库 HEAD 已明显晚于上表,先确认问题是否已被修复,再动手。 @@ -45,7 +48,7 @@ | | 复习-07 复习耗时统计 | P2 | 可直接实施(口径已定) | — | | AI 链路 | AI-01 事务内同步等 AI | P2 | 待决策 | 事务外纯读对比(小改)/ 任务表 + 异步回写 | | | AI-02 全链路同步阻塞 | P2 | 可实施(方案已定) | 若 AI-01 选任务表方案,则与 AI-01 同批 | -| | AI-03 单 worker 串行无重试 | P2 | 可直接实施 | — | +| | AI-03 单 worker 串行无重试 | P2 | 已完成 | — | | | AI-04 防并发锁是 JVM 内存锁 | P2 | 可直接实施 | 需确认「生成中」的对外语义(返回任务状态而非实体) | | 数据与检索 | 数据-01 业务主表缺索引 | P3 | 可直接实施 | — | | | 数据-02 统计聚合在内存 | P3 | 待决策 | SQL 聚合下推 / 物化统计表 | @@ -236,12 +239,19 @@ ### AI-03(原 LPT-13)`lpt-ai` 单 worker 串行且无重试 -- [ ] 未完成 +- [x] 已完成 - **涉及仓库**:`lpt-ai`(+ `lpt-be` 超时策略) +- **完成于** `lpt-ai` `bf56c2b` - **依据**:`task-queue.ts` 只有一个 `processing` 标志顺序处理;失败直接置 `failed`,无退避重试;任务记录 `TTL_MS = 1 小时`。 - **影响**:N 个并发请求时第 N 个需等待 N × LLM 耗时,超过 `lpt-be` 的 600s 超时后表现为「AI 实际成功、客户端已超时」,结果既不落库也不告知,用户重复点击导致重复计费。LLM 的 429/5xx 抖动被当成永久失败。 -- **建议**:worker pool(并发度对齐服务商限流)+ 429/5xx 退避重试 + 幂等键/结果缓存(同一导图、同一报告草稿的相同输入直接复用)。 -- **验收**:并发 N 个任务时耗时不再线性增长;可重试错误不产生失败结论。 +- **已实施**: + - **Worker 池**:并发度 `LPT_AI_CONCURRENCY`(默认 2),队列改为基于 id 的 FIFO。 + - **退避重试**:新增 `llm/retry.ts`,仅重试 408/429/5xx 与超时;4xx 客户端错误与「API Key 未配置」不重试;服务端 `Retry-After` 优先于自算退避。为此让 `LlmError` 保留上游真实状态码(原先一律记为 502,无法区分 429 与 400)。 + - **幂等与结果复用**:以 `type + params` 的稳定哈希为幂等键(支持显式 `idempotencyKey`);进行中的相同请求合并为同一任务,已完成结果在 `LPT_AI_RESULT_CACHE_MS` 窗口内复用;**失败任务不复用**,保留用户重试机会;请求体 `force: true` 可强制重新生成。 + - 队列改为可注入依赖的 `TaskQueue` 类,测试覆盖并发、重试、复用与清理。 +- **不得改动的契约**:`/ai/tasks` 必须固定返回 201(Java 端 `AiServiceClient` 把非 201 视为提交失败),复用信息放在响应体的 `reused` / `status` 字段。 +- **验收**:并发 N 个任务时耗时不再线性增长;可重试错误不产生失败结论。✅ 已用假 LLM 服务端到端验证:4 个任务× 300 ms 共用 431 ms(串行需 1200 ms+);前两次 429 后仍为 `done`;相同请求只调用 LLM 1 次。 +- **遗留**:`lpt-ai` 的部署(`lpt-infra` configmap)未设队列相关环境变量,目前走默认值;需要调优时再补。 ### AI-04(原 LPT-14)防并发锁是 JVM 内存锁