生态桌面应用
故障排查
定位依赖锁、权限、显示会话、ABI、绘制、资源和输入法问题。
包无法解析或原生库不匹配
确认依赖使用存在的v0.1.0标签，删除手工复制的动态库，再在目标平台运行yanbao 装。检查言序.lock中的目标、ABI、SHA-256 和大小；不要复用另一架构的锁。
权限错误
- 创建应用失败：需要
图形界面和原生扩展； - 剪贴板失败：增加
剪贴板； - 文件选择失败：增加
文件对话框。
稳定错误代码以PLATFORM_PERMISSION_*开头。图形权限不会隐式授予系统服务。
Linux 没有窗口
确认存在 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表示从非所有者事件循环使用资源；把操作投递回应用事件泵。
报告问题时附上系统、架构、言序／言包／言界／言台版本、协议查询、能力查询和最小可复现源码，不要附带私密路径或剪贴板内容。