docs: 补充 AI 任务的异步提交与查询口径

This commit is contained in:
cat-shark
2026-10-09 15:08:14 +08:00
parent 804d53aaca
commit 39efbb6612
2 changed files with 13 additions and 1 deletions
+1 -1
View File
@@ -26,4 +26,4 @@
| 覆盖率 | 本次对比命中节点占参与对比节点的比例 | [回忆对比](recall-review.md) |
| 复习起点 | 用户指定的对比起始节点,只复习该子树 | [回忆对比](recall-review.md) |
| 学习引导 | 用开放式问题引出回答、由 AI 纠正概念边界的复习行为 | [学习引导](learning-guidance.md) |
| AI 任务 | 系统借助 AI 完成报告聚合、导图生成和语义对比 | [AI 任务](ai-task.md) |
| AI 任务 | 系统借助 AI 完成报告聚合、导图生成和语义对比;以异步任务形态提交与查询 | [AI 任务](ai-task.md) |
+12
View File
@@ -23,6 +23,18 @@ AI 是增强能力,而不是单点依赖。AI 不可用时,系统应能用
例外:学习引导不提供降级形态。它不属于核心闭环,AI 不可用时该功能整体不可用。
## 任务的形态:提交与等待分离
AI 能力按「异步任务」组织,而不是让页面同步等一份结果:
- 用户确认发起后,系统立即可回一个任务标识;任务在后台执行,页面根据标识查询进度与结果。
- **结果属于任务,不属于页面**:同一个任务标识可以反复查询,结果不会因为用户刷新、关页或切走而丢失,也不会因为“已经算过一次”而需要重新消耗 AI。
- **完成时间不由用户承担**:生成期间用户可以去别处继续学习,回来时接着看结果。
- **同一目标的重复发起不重复消耗**:如果同一个对象已经有进行中的任务,再次发起得到的是那个任务的状态,而不是又一次生成。对外呈现的是“正在生成中”,而不是一个尚不存在的成品。
- **读取不产生副作用**:查看一个任务的导图、看一份报告,不会顺带触发一次 AI 生成;需要生成时必须是一个明确的发起动作。
任务有四种状态(等待执行、正在执行、已完成、失败),失败时用户可见的是可理解的原因,并且可以重新发起。
## 相关概念
- 学习报告:AI 聚合碎片的产出。