diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/runtime_error.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/runtime_error.rs
index bf0d8103e..b6bfab1fc 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/runtime_error.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/runtime_error.rs
@@ -139,6 +139,9 @@ pub(crate) fn persist_agent_runtime_error(
 /// stderr，那里没有 `sanitize_diagnostic_message` 兜底，所以每个调用方给的外来文本
 /// （`summary` 按 320 字符预算）都在这里过一遍脱敏。
 ///
+/// 已经脱敏过的 `detail` 也照走同一遍流水线，不按「调用方已脱敏」走短路：截断会把
+/// `[redacted-secret]` 这类标记切开，而且这里是 `pub(crate)` 边界，不假设未来调用方一定先脱敏。
+///
 /// 拆成「身份行 + 详情行」是因为整行只要出现凭据标记就会被
 /// [`crate::sanitize_diagnostic_message`] 整体替换成脱敏占位，详情行可能因此消失；
 /// 身份行保持短小且只含摘要与引用，保证事件还能被定位。