生态桌面应用
选择 GUI 路线
根据项目阶段、控件需求、稳定性与定制程度选择言窗或言界。
言窗 1.0 和言界 1.0 都支持六个正式桌面目标。新项目使用当前言序 1.1.20 与言包 0.6.1 即可评估两条路线；选择依据是编程模型和能力边界，不是稳定／预览之分。
直接选择言窗
以下情况优先使用yanxu-gui 1.0：
- 现有应用已经上线，当前控件和主题足够；
- 希望依赖成熟的 egui 生态与立即模式开发方式；
- 需要言界 1.0 尚未提供的表格、树、富文本或代码编辑器成品控件；
- 希望直接采用 egui 已有组件和立即模式扩展方式；
- 需要由 CI 汇总并校验的 Windows、macOS、Linux 六目标原生制品。
选择言界
以下情况适合yanxu-ui 1.0：
- 新项目希望所有高级控件行为都由言序实现；
- 需要保留模式控件树、状态绑定和捕获／冒泡事件；
- 需要自定义主题、布局、语义树或绘制命令；
- 希望平台差异集中在独立的
yanxu-platform边界； - 需要叠层菜单、复杂表单、虚拟列表、动画、原生无障碍语义或可组合业务组件；
- 需要版本化运行诊断、资源配额和结构化关闭报告。
决策检查表
| 问题 | 若回答“是” |
|---|---|
| 已有言窗应用是否稳定上线？ | 保持言窗 1.x |
| 是否依赖言界 1.0 没有的成品控件？ | 选择言窗或先验证自定义控件 |
| 是否必须控制事件传播和焦点顺序？ | 选择言界 |
| 是否要用言据集中描述主题？ | 选择言界 |
| 是否要直接调用操作系统句柄？ | 两条上层路线都不适合；应贡献言台通用能力 |
选择言窗时先运行言窗 1.0 示例；评估言界时复制 完整言界示例。迁移不要求一次完成，可以让不同 应用分别使用两条路线。