From 12d30cc128a15185b33d8fc2526be97c111d5f46 Mon Sep 17 00:00:00 2001
From: cocos02 <cocos02@163.com>
Date: Sun, 7 Jun 2026 19:50:45 +0800
Subject: [PATCH] docs: add QTE explanation comment in QTESystem

---
 engine/systems/QTESystem.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/engine/systems/QTESystem.ts b/engine/systems/QTESystem.ts
index aea6915..9098347 100644
--- a/engine/systems/QTESystem.ts
+++ b/engine/systems/QTESystem.ts
@@ -4,6 +4,9 @@ type QTEUpdateCallback = (remaining: number, total: number) => void
 type QTEResultCallback = (success: boolean) => void
 
 export class QTESystem {
+  // QTE (Quick Time Event / 快速反应事件):
+  // 视频播放到特定时间点时弹出按键提示，玩家在倒计时内按下指定按键，
+  // 成功/失败/超时分别导向不同剧情分支，并应用对应的 effects 效果。
   private timerId: ReturnType<typeof setInterval> | null = null
   private timeoutId: ReturnType<typeof setTimeout> | null = null
   private keyHandler: ((e: KeyboardEvent) => void) | null = null