升级与路线迁移

从言界 0.x 升级到 1.0

1.0 保留从v0.1.0到v0.9.0的全部已发布源码 API。多数应用只需：

1. 提交当前源码和各目标锁，保留可回滚点；
2. 把言界依赖改为v1.0.0与^1.0；直接使用言台的应用也改为其v1.0.0与^1.0；
3. 在每个目标系统与架构重新生成锁，不能复制另一目标的锁或手工替换动态库；
4. 只保留实际使用的图形、原生扩展、剪贴板和文件对话框权限；
5. 重建并验收窗口、IME、DPI、主题、屏幕阅读器、系统服务和关闭路径。

从 0.9 升级不需要源码修改。更早版本还应复核：0.4 起的帧反馈、0.5–0.6 的语义树和原生 无障碍桥、0.7 的资源配额与单向退出，以及言界 0.7 的托管计时器／图片和结构化关闭报告。 列表集合的无障碍值从 0.8 起只使用标量；选择和滚动动作属于当前可见的列表项或标签 节点，应用不能缓存旧树修订中的派生编号。

完整逐版本清单见言界的迁移证明 和言台的迁移指南。

从言窗评估言界

路线迁移不是升级前置条件。yanxu-gui已有独立的 1.0 稳定线，言台和言界不会替换它。 现有言窗应用应先锁定公开 Release 制品，再决定是否评估另一种编程模型。

概念映射

推荐步骤

1. 保留原言窗发布版本和回归测试，先完成 1.0 标签、清单和原生制品升级。
2. 用完整示例建立独立言界试验项目。
3. 先迁移数据模型和业务命令，再用行／列／网格重建布局。
4. 把立即模式条件分支改为控件属性、状态绑定和事件回调。
5. 为中文 IME、焦点顺序、快捷键、主题和 DPI 补充验收。
6. 只有当新页面满足需求时，才决定是否继续迁移其他独立窗口。

1.0 不支持在同一个原生窗口中混用言窗和言界控件树。两条路线可存在于不同应用中；不要 尝试把 egui 原生对象或平台句柄传入言台。若验收失败，应一起恢复旧清单和同一目标的旧锁 再重新构建，不能只替换原生库或继续复用新版本 YXB。