diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
index abf1ad1a2..cc98da28b 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
@@ -3,7 +3,7 @@ use super::*;
 mod canvas_generation;
 mod external_generation_state;
 mod game_html_validation;
-mod loop_orchestration;
+mod llm_request;
 mod prompt_context;
 mod trace;
 
@@ -49,7 +49,7 @@ pub(in crate::agent) use external_generation_state::{
 pub(crate) use game_html_validation::{
     contains_any, fnv1a64, strip_llm_thinking_blocks, validate_game_html_smoke,
 };
-pub(crate) use loop_orchestration::{
+pub(crate) use llm_request::{
     game_creator_agent_llm_error_is_mud_points_insufficient,
     game_creator_agent_llm_error_public_summary, request_game_creator_llm_text,
 };
diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs
index caed1a652..d47ccfef5 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs
@@ -1,3 +1,9 @@
+//! LLM 文本请求与其额度 / 进度错误面：`request_game_creator_llm_text`、
+//! `emit_agent_progress` / `AgentProgressEmitter`，以及泥点（mud points）不足的判定、
+//! 消息构造与公开摘要。
+//!
+//! 多 pass 循环编排已随 Agent Runtime 退役删除，本模块只剩请求与错误面。
+
 use super::*;
 
 pub(crate) async fn request_game_creator_llm_text(