diff --git a/apps/ai-game-creator-shell/src/features/project-workspace/resourceReferences.ts b/apps/ai-game-creator-shell/src/features/project-workspace/resourceReferences.ts
index ed1d22f45..bc4e0dfb6 100644
--- a/apps/ai-game-creator-shell/src/features/project-workspace/resourceReferences.ts
+++ b/apps/ai-game-creator-shell/src/features/project-workspace/resourceReferences.ts
@@ -435,7 +435,8 @@ function countMentionTokenOccurrences(value: string, token: string) {
 /**
  * 粘贴文本 → canonical content（粘贴侧的唯一解析口径）。
  *
- * 候选由宿主注入的 provider 枚举（`ReferenceProvider.candidates`），token 就是
+ * 候选来自调用方传入的引用清单（输入区给的是 `ReferenceProvider.lookup()` 此刻就绪的全量
+ * 候选），token 就是
  * `chatReferenceMentionToken`——与显示口径逐字同一个字符串，所以「从气泡复制再粘贴」不需要
  * 任何兼容别名：`@显示名` / `$名称` 认得出，`@hero.png`、resourceId、大小写变体一律不认。
  *