diff --git a/docs/tutorial/run/run-app-harmony.md b/docs/tutorial/run/run-app-harmony.md
index 95e54a32ff85f09340ba6df2ca462c8a73125b5d..9bc347f65545ea694064352dd1ab34b51c5ef9f0 100644
--- a/docs/tutorial/run/run-app-harmony.md
+++ b/docs/tutorial/run/run-app-harmony.md
@@ -96,6 +96,12 @@ HX 里面有两个专门与鸿蒙相关的功能入口：
 有记录显示，在 Windows 系统下，运行到鸿蒙时如果选择模拟器作为运行设备，可能会出现超时的情况，原因尚不清楚，有可能与模拟器系统里存在以前安装的相同包名的应用有关，
 如遇这种情况，可以尝试手工在模拟器里面删除旧的应用然后重试。
 
+### 报错 `检测到App真机运行插件出现破损`@launcher-damaged
+
+由于未知原因导致【App真机运行】插件出现破损，需要重新安装。
+请在 HX 主菜单中选择【工具>插件安装】，找到【App真机运行】插件并点击卸载，然后在主菜单中选择【运行>运行到手机或模拟器>下载真机运行插件】重新安装。
+如果安装过【App真机运行(uni-app x)】插件，需要先卸载掉，否则无法卸载【App真机运行】插件。
+
 ## 关于数字签名证书的配置@signing
 
 ### 调试用的数字签名证书@signing-debug