AI 开发排障

先把当前错误交给 AI

请检查当前 PXA 工作区的环境、版本和最近失败日志，定位并修复失败的这一步，然后继续原目标。保留应用身份、存档和已有代码；不要重装整个环境，不修改 SDK、PXA 接口或板子代码。告诉我实际通过了哪些检查。

提供失败时正在做什么、预期结果和报错即可。不要把私钥、令牌、完整环境变量或账号密码粘贴到聊天里。

环境没有准备好

在工作区执行 .pxa/pxa doctor，Windows 使用 .pxa\pxa.cmd doctor。诊断会报告工具、SDK 和执行方式；它不等于应用已经运行通过。

编译失败或 AI 找不到接口

先确认使用 C 还是 C++，再查当前锁定版本的声明：

.pxa/pxa context apps/my-app --query ui --language cpp
.pxa/pxa build apps/my-app

把 apps/my-app 换成实际应用目录。C 项目用 --language c。先修复第一个相关编译错误，再构建；不要因某个接口没有搜到就改 SDK、猜测新接口或删除锁文件。需要平台新增能力时另开系统任务。

如果提示签名身份不同，恢复原来的私钥或选择正确的签名文件。重新生成密钥会改变发布者身份，不能用来修复现有应用升级。

编译通过，但画面或操作不对

.pxa/pxa verify apps/my-app --profiles pai-touch

先验证出问题的屏幕，实际操作并检查截图；修复后再覆盖所需的其他分辨率。手柄输入要在操作后释放。无窗口模式也运行真实 Guest，结果位于工作区的 local/artifacts/。

runtime_passed 只说明程序和检查流程成功；还需看原图，确认文字、颜色、布局和输入反馈。模拟器截图不能证明设备 FPS 或音频延迟。

串口、安装或固件升级失败

重新发现设备并读取 INFO，核对端口、板型和 CPU。端口占用时，先确认是自己的哪个调试任务；不要停止别人的任务或反复抢串口。重连后端口可能变化。

应用必须包含目标设备匹配的 AOT。现有设备优先保留数据升级；分区不兼容时先备份，明确允许清除数据后才能完整重装。参见 网页烧录说明 和 设备调试。

商城截图或上架没有完成

使用 Agent Kit 0.3.1 及以上，从真实模拟器拍摄：

.pxa/pxa verify apps/my-app --profiles pai-touch --store-screenshots

该模式在启动前隐藏模拟器底部导航，并记录原始图片摘要。上传前逐张检查原图，确保性能浮层、手势条、三按键导航都已关闭；不能裁剪或修图代替关闭界面。如果应用自己绘制了性能信息，也要先关闭。

授权过期时在商城重新确认本应用授权，不在聊天里传递令牌。服务器返回 pending_review 表示提交成功、等待审核；还没有公开显示是正常的。详见 上架教程。

工具报告任务范围之外的修改

先查看被指出的文件与差异。保留原本就有的用户改动，只纠正当前任务造成的越界修改，再运行 scope check。不要通过清除记录、重设基线或重置整个仓库掩盖问题。

应用任务只改当前应用；适配新板只改新板目录和对应 Profile。SDK、ABI 与公共运行时代码的修改需要单独的系统维护任务。参见 AI 工具参考。

返回之前修改过的应用时，可用 scope begin --mode app --project apps/my-app --adopt 采纳该应用目录内的现有改动，原审计仍归档保留。SDK 或其他应用的越界修改仍会阻断；不要手工编辑审计基线。

设备没被 AI 找到

先接上 USB 数据线并正常开机，打开设备的「设置 → PXADB 调试」开关。参考系统界面若未显示该项，进入「设置 → 设备信息」，快速点按「系统版本」7 次，再向下找到「开发者 → PXADB 调试」；不同产品菜单可能有所不同，关闭其他串口工具，再请 AI 执行 .pxa/pxa device-profile。选定端口后执行 .pxa/pxa device-profile --port COM7，Linux 使用发现的 /dev/ttyACM… 或 /dev/ttyUSB…。该工具只读取信息，不安装、不重启、不刷机。

它会给出 CPU、设备报告的分辨率、调试输入及传感器信息，旧固件没有报告的字段保留为未知。请补充真实操作方式，以及是否需要适配横竖屏、圆屏、圆角和不同屏幕尺寸。BOOT/RESET 进入烧录模式，不是开启 PXADB；安装应用时正常开机即可。