用途：在用户已用 npm run dev 启动 Metro、并在设备或模拟器打开原生应用后，监控运行中的移动应用，发现运行时错误、打包错误以及「静默失败」（如列表为空、白屏、错误被吞掉），并自动修复。
主要能力：读取项目本地 .powernative/metro-logs/ 下由 metro.config.js 写入的日志；分类错误并编辑受影响文件修复，或转交对应技能（如 Dataverse 架构、auth 注册）；对静默失败可在数据路径边界注入临时 console.log，仅读取新增日志字节，定位后清理痕迹。
用法：/debug-app（默认，基于项目日志）、/debug-app "<症状>"（症状驱动，如 "todos not appearing on home screen"）、/debug-app status、/debug-app stop、/debug-app version。可附选项：--working-dir <path>、--port <1-65535>、--platform <ios|android>、--cycles <1-50>（默认 3）、--timeout <duration>（默认 5m）、--no-fix（只观察不修改）。
限制与规则：须先启动 Metro 并加载原生应用；仅面向原生 dev client，不探测 Web 或直接请求 Metro/localhost；一次只修一个问题；不得编辑 node_modules 或以补丁方式绕过 @microsoft/power-apps-native-* 包缺陷，应记录报告并转交 /report-issue；--no-fix 下不修改项目、不注入日志、不安装依赖。运行状态保存在 .powernative/debug-app/。部分具体行为细节资料中未提供。