From 39efbb661275b1862197a5bf988237e946b7362f Mon Sep 17 00:00:00 2001 From: cat-shark Date: Fri, 9 Oct 2026 15:08:14 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=20AI=20=E4=BB=BB?= =?UTF-8?q?=E5=8A=A1=E7=9A=84=E5=BC=82=E6=AD=A5=E6=8F=90=E4=BA=A4=E4=B8=8E?= =?UTF-8?q?=E6=9F=A5=E8=AF=A2=E5=8F=A3=E5=BE=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/concepts/README.md | 2 +- docs/concepts/ai-task.md | 12 ++++++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/concepts/README.md b/docs/concepts/README.md index ecfb9b2..58fe82e 100644 --- a/docs/concepts/README.md +++ b/docs/concepts/README.md @@ -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) | diff --git a/docs/concepts/ai-task.md b/docs/concepts/ai-task.md index 2884b34..98de8c2 100644 --- a/docs/concepts/ai-task.md +++ b/docs/concepts/ai-task.md @@ -23,6 +23,18 @@ AI 是增强能力,而不是单点依赖。AI 不可用时,系统应能用 例外:学习引导不提供降级形态。它不属于核心闭环,AI 不可用时该功能整体不可用。 +## 任务的形态:提交与等待分离 + +AI 能力按「异步任务」组织,而不是让页面同步等一份结果: + +- 用户确认发起后,系统立即可回一个任务标识;任务在后台执行,页面根据标识查询进度与结果。 +- **结果属于任务,不属于页面**:同一个任务标识可以反复查询,结果不会因为用户刷新、关页或切走而丢失,也不会因为“已经算过一次”而需要重新消耗 AI。 +- **完成时间不由用户承担**:生成期间用户可以去别处继续学习,回来时接着看结果。 +- **同一目标的重复发起不重复消耗**:如果同一个对象已经有进行中的任务,再次发起得到的是那个任务的状态,而不是又一次生成。对外呈现的是“正在生成中”,而不是一个尚不存在的成品。 +- **读取不产生副作用**:查看一个任务的导图、看一份报告,不会顺带触发一次 AI 生成;需要生成时必须是一个明确的发起动作。 + +任务有四种状态(等待执行、正在执行、已完成、失败),失败时用户可见的是可理解的原因,并且可以重新发起。 + ## 相关概念 - 学习报告:AI 聚合碎片的产出。