diff --git a/apps/ai-game-creator-shell/src/features/resource-canvas/resourceVersionReplacementModel.ts b/apps/ai-game-creator-shell/src/features/resource-canvas/resourceVersionReplacementModel.ts
index 98febadae..b1508be6e 100644
--- a/apps/ai-game-creator-shell/src/features/resource-canvas/resourceVersionReplacementModel.ts
+++ b/apps/ai-game-creator-shell/src/features/resource-canvas/resourceVersionReplacementModel.ts
@@ -291,18 +291,18 @@ export function resourceVersionReplacementErrorMessage(error: unknown): string {
   return message;
 }
 
-/** 画布点选态点到的资源卡，能不能作为这次替换的目标。 */
+/** 在画布上点到的资源卡，能不能作为这次替换的目标。 */
 export type ResourceReplacementPickResolution =
   | { status: 'replace'; replacementResourceId: string }
   | { status: 'rejected'; message: string };
 
 /**
- * 「点选替换」：把画布上点到的那张卡解析成写入目标，或给出「为什么不能替换」。
+ * 画布点选：把画布上点到的那张卡解析成**面板里的当前替换目标**，或给出「为什么不能替换」。
  *
- * 判据与候选弹窗**同源**，不重算兼容性：目标必须是 manifest 资产、必须在后端给出的权威
+ * 判据与面板里的候选列表**同源**，不重算兼容性：目标必须是 manifest 资产、必须在后端给出的权威
  * 候选里（源素材已被后端排除）、且硬门禁通过（`resourceReplacementBlockedReason`）。
  * 拒绝文案也走同一条翻译路径（`resourceVersionReplacementErrorMessage` 认的就是 Rust 那几种
- * 错误形状），所以点选与列表两条入口对同一件事永远说同一句话。
+ * 错误形状），所以画布点选与面板候选列表对同一件事永远说同一句话。
  */
 export function resolveResourceReplacementPick({
   manifestAssetId,