diff --git a/docs/dev-setup.md b/docs/dev-setup.md
index 8202b92..9ac6390 100644
--- a/docs/dev-setup.md
+++ b/docs/dev-setup.md
@@ -127,6 +127,16 @@ sh scripts/dev.sh seed S001
 # http://localhost:8888  服务器:mysql  用户:root  密码:password  库:jiu_db
 ```
 
+### Flutter 热重载
+
+在运行 `flutter run` 的终端中：
+
+| 按键 | 效果 |
+|------|------|
+| `r` | 热重载（Hot Reload）— 保留状态，秒级生效，适合 UI 调整 |
+| `R` | 热重启（Hot Restart）— 重置状态，完整重建，适合逻辑变更 |
+| `q` | 退出 |
+
 ### 仅开发后端时
 
 ```bash