docs: 记录 AI 降级与有效学习时间两条优化项
This commit is contained in:
+33
-2
@@ -179,6 +179,16 @@
|
||||
- **影响**:一个搁置数月的暂停会话会阻止开始任何新任务(所有任务入口都撞同一个守卫),用户必须先找回那个任务手动结束。
|
||||
- **验收**:存在陈旧活跃会话时,用户可在一次交互内开始新任务。✅ 已用交互式集成测试覆盖五个出口分支(前往继续 / 结束并开始 / 放弃 / 放弃失败 / 取消)
|
||||
|
||||
### 会话-06(2026‑10‑22 新需求)结束会话时无法修正有效学习时间
|
||||
|
||||
- [ ] 未完成
|
||||
- **涉及仓库**:`lpt-fe` + `lpt-be`
|
||||
- **依据**:结束会话弹窗(`lpt-fe/src/components/StartTask.vue` 的「结束会话总结」)只让用户填写报告三段,有效学习时间由后端按 `lpt.study-time.*` 口径自动结算(`StudySessionsServiceImpl`),用户没有任何修正入口。现实里「学完忘了点结束」会让时间虚高,而现有出口只有 会话-04 的 2 小时硬兜底与 25 分钟遗忘截断(`last_start_time + 25 分钟`),只能兜住极端情况。
|
||||
- **影响**:任务累计有效学习时长与复习总览的数字和真实投入不一致,用户无法自行纠正;虚高还会连带影响学习报告的「预期达成判断」。
|
||||
- **建议**:在结束会话界面上增加「有效学习时间」可编辑项,**只允许调小**(`0 < 新值 ≤ 服务端结算值`),随结束会话请求提交;服务端校验上限并用新值覆盖结算结果,超出上限**直接拒绝**而不是静默截断(否则用户以为改了却没生效)。界面需同时显示服务端结算值与上限。
|
||||
- **待确认**:① 是否允许调到 0(等价于本次不计入);② 会话-决策01 的「少于 10 分钟不计入总学习时间」是否按修正后的值重新判定;③ 是否需要留痕(审计/报告中标注「已手动下调」)。
|
||||
- **验收**:结束会话时可下调有效学习时间且立即反映到任务累计时长;提交大于服务端结算值的值被拒绝并给出明确提示;不做修正时行为与现在完全一致。
|
||||
|
||||
### 报告-01(原 LPT-08)学习报告与知识碎片不可修订
|
||||
|
||||
- [x] 已完成
|
||||
@@ -309,6 +319,27 @@
|
||||
- **对外语义已明确**:提交接口返回的是**任务状态**(`AiTaskResponse`),不再是可能为 null 的实体;前端据此展示「正在生成」。
|
||||
- **验收**:多副本场景下同一任务不会并发生成;生成中重复请求返回明确的进行中状态。✅ 单测覆盖「同一目标重复提交返回同一任务标识」,集成测试覆盖重复提交复用
|
||||
|
||||
### AI-05(2026‑10‑22 新发现)AI 不可用时静默降级为内置规则,用户以为内容由 AI 整理
|
||||
|
||||
- [ ] 未完成
|
||||
- **涉及仓库**:`lpt-be` + `lpt-ai`(概念口径需同步 `lpt-docs`)
|
||||
- **依据**:`MindMapOutlineGenerator.generate()` 在 AI 客户端返回空时降级到 `BuiltinMindMapGenerator`(`isAvailable()` 恒为 `true`),任务照常 `SUCCEEDED`;`RemoteAiMindMapClient.isAvailable()` 只看 `lpt.ai-service.url` 是否配置,**不探测服务是否真的可达**。因此 lpt-ai 没启动时,点「补充新碎片」走完全程弹的是 `ElMessage.success("新碎片已整理进标签导图")`(`lpt-fe/src/components/TagReview.vue`),导图内容实际由内置规则拼接。
|
||||
- **现状清单(全工作区的降级路径)**:
|
||||
| 链路 | AI 不可用时的行为 | 用户看到 |
|
||||
|---|---|---|
|
||||
| 任务导图 / 标签导图生成 | 降级 `BuiltinMindMapGenerator` | 成功提示 |
|
||||
| 学习报告草稿 | 降级为按序拼接(`StudySessionsServiceImpl`) | 成功提示 |
|
||||
| 回忆对比(任务 / 标签) | 降级为内置文本相似度匹配(`StandardMindMapServiceImpl`) | 成功提示 |
|
||||
| 学习引导 | 无降级,直接失败 | 错误提示(唯一一条) |
|
||||
- **影响**:
|
||||
1. 用户无法区分「AI 整理的结构」与「按会话分组的规则拼接」,对内容质量产生错误信任;
|
||||
2. 降级结果会写库(`review_standard_mind_maps` / `review_tag_mind_maps` / 报告表),AI 恢复后不会自动纠正,要用户再手动重建一次;
|
||||
3. `AiServiceTaskFailedException`(例如 LLM 402 余额不足这类确定性原因)在 `AiServiceClient.generateMindMap()` 的 `catch (Exception)` 里被一并吞掉降级,同样不可见;
|
||||
4. 来源标签与事实不符:`lpt-fe/src/components/TagMindMapList.vue` 把 `BUILTIN` 显示成「AI 生成」,而「补充新碎片」之后 generator 又被强制写成 `USER_MERGE`,显示成「含手动编辑」。
|
||||
- **建议**:**删除全部内置规则降级路径**(导图生成、报告草稿、回忆对比),AI 不可用或调用失败时任务直接失败并给出可定位的原因,**不做任何数据改动**(不写新导图、不覆盖旧导图、不落报告)。前端来源标签需要能如实区分生成来源。
|
||||
- **已排除的替代方案(待维护者确认)**:保留降级但在结果里带 `degraded: true` + 原因,前端改用警告提示。
|
||||
- **验收**:lpt-ai 未启动时点「补充新碎片」,任务失败且界面提示 AI 服务不可用;库中导图内容与生成时间均未变化;AI 恢复后同一操作能正常成功。
|
||||
|
||||
---
|
||||
|
||||
## 7. P3 检索与数据增长
|
||||
@@ -492,10 +523,10 @@
|
||||
|
||||
同一模块内的条目触碰同一批表结构、口径或配置,建议一个模块一次性改完,避免出现双口径并存的中间态。
|
||||
|
||||
1. **学习会话生命周期**:会话-01/02/03 已完成;会话-04 + 会话-05 已完成(收敛方式取「惰性 + 定时并用」,出口取「结束并开始新任务 + 放弃」)。本模块已收口。
|
||||
1. **学习会话生命周期**:会话-01/02/03 已完成;会话-04 + 会话-05 已完成(收敛方式取「惰性 + 定时并用」,出口取「结束并开始新任务 + 放弃」)。**会话-06 是本次(2026‑10‑22)新增的待办,本模块重新开启。**
|
||||
2. **内容归属与报告**:归属-01 + 报告-01 + 标记-01 均已一次改完(碎片表拆分归属、报告结构化、导图待更新标记、检索口径),学习引导的来源标记随之落地。本模块已收口。
|
||||
3. **复习**:复习-01 六项结论已落;复习-02 / 复习-03 / 复习-04 / 复习-05 / 复习-06 / 复习-07 均已完成。本模块已收口。
|
||||
4. **AI 链路**:AI-01 / AI-02 / AI-03 / AI-04 均已完成。本模块已收口。
|
||||
4. **AI 链路**:AI-01 / AI-02 / AI-03 / AI-04 均已完成。**AI-05 是本次(2026‑10‑22)新增的待办(移除内置规则降级),本模块重新开启。**
|
||||
5. **数据与检索 + 导出**:数据-01 / 数据-02 / 数据-03 / 导出-01 均已完成;数据-04 / 数据-05 是本次实现过程中新发现并已修的既有缺陷(主键生成方式不一致、逻辑删除标签占唯一键)。本模块已收口。
|
||||
6. **安全与运维清理**:安全-02 / 安全-03 / 安全-04 已完成;安全-01 与运维-01 由维护者决定暂缓(见条目内记录);清理-01 已完成。
|
||||
7. **学习录音(已暂停)**:模块整体挂起,重启前先定 §12「路线分叉」(依赖 OBS / 自研原生)。
|
||||
|
||||
Reference in New Issue
Block a user