故障排查

定位依赖锁、权限、显示会话、ABI、绘制、资源和输入法问题。

包无法解析或原生库不匹配

确认言界依赖使用v1.0.0与^1.0，锁图中的言台解析到v1.0.0。删除手工复制的动态库，再在目标平台运行yanbao 装。检查言序.lock中的系统、架构、ABI、SHA-256、大小和精确提交；不要复用另一架构的锁。升级依赖后必须重新构建 YXB 与 Bundle。

稳定错误代码以PLATFORM_PERMISSION_*开头。图形权限不会隐式授予系统服务。

确认存在 Wayland 或 X11 桌面会话以及WAYLAND_DISPLAY或DISPLAY。CI 无头运行使用xvfb-run；真实中文候选窗需要 IBus/Fcitx5 和用户桌面，Xvfb 不能替代。

正文只应消费文本输入或IME组合提交，不能再从按键推导字符。输入框要在光标变化后更新逻辑像素候选区，并在失焦时停止输入法。

PLATFORM_DRAW_MAJOR表示主版本不符；*_CORRUPT、*_LIMIT、*_UTF8和*_NUMBER分别表示损坏、超限、无效 UTF-8 或非有限数值。不要绕过验证或截断后继续解释。

PLATFORM_RESOURCE_CLOSED表示句柄代际已失效；重新获取资源，不能缓存旧编号。PLATFORM_WRONG_THREAD表示从非所有者事件循环使用资源；把操作投递回应用事件泵。

PLATFORM_QUOTA_*表示资源数量、图片／字体持有字节、帧或无障碍树达到应用配额。读取 应用.资源配额（）和诊断快照，关闭不用的资源；只能在首个子资源或首次运行前下调配额，冻结后不能提高或重新配置。应用退出后生命周期只会继续到已关闭，不能再次调用运行（）。

动画依赖匹配的帧呈现反馈。窗口隐藏、最小化或表面尺寸为零时反馈可暂停；恢复后由新的重绘继续。检查窗口诊断中的待呈现身份、提交、替换、忽略和失败计数。被替换帧不会再产生呈现事件，应用不能围绕旧帧编号持续等待。

先确认能力查询（）中的原生无障碍桥为真，后端为 UIA、NSAccessibility 或 AT-SPI。自定义控件必须保留稳定正编号、逻辑边界、标量值和实际实现的动作；处理焦点／动作请求时核对当前树修订。无头 CI 只能证明适配器与树同步，最终播报需在启用辅助技术的桌面会话验证。

报告问题时附上系统、架构、言序／言包／言界／言台版本、协议查询、能力查询、内容安全的诊断快照、结构化关闭报告和最小可复现源码，不要附带私密路径、输入内容或剪贴板内容。