From c8d0584f11c0b644f82588b7e69b8bf8a13967af Mon Sep 17 00:00:00 2001
From: cat-shark <1716967236@qq.com>
Date: Mon, 3 Aug 2026 23:08:08 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E7=94=A8=E6=88=B7?=
 =?UTF-8?q?=E6=8F=90=E7=A4=BA=E8=A7=84=E8=8C=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/AGENTS.md b/AGENTS.md
index 4fabb83..417d8de 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -73,6 +73,7 @@ lpt-be/src/main/java/com/guo/learningprogresstracker/
 - 业务错误：`CommonResult.error(msg)`，code=400，HTTP 200。
 - 未登录：`GlobalExceptionHandler.handleNotLogin()`，HTTP 401 + code=401。
 - 参数校验失败：`MethodArgumentNotValidException`，code=400。
+- 用户可见错误文案必须口语化、可理解，避免“无法生成”“不存在”等技术化表述；技术细节写入日志。例如无学习报告时应提示“这个任务还没开始学习哦，学习后产生学习报告后再来吧”，而不是“没有学习报告，无法生成思维导图”。
 
 ## DTO 转换