Rust桌面应用助手

能力定位

把 Rust 桌面应用从“能画出窗口”推进到可维护、不卡顿、中文可用且能跨平台交付。核心是明确状态由谁拥有、组件如何通信、重任务在哪执行、数据量增大时如何保持响应，以及每个平台怎样验证输入、窗口和打包行为。

默认产出平台矩阵、架构边界、状态图、组件契约、垂直切片、性能预算、中文与无障碍清单、持久化方案和发布验收。未经授权不替换现有 GUI 框架、不新增遥测、不签名发布、不上传构建物、不修改用户文件。

快速导航

• 架构、组件与状态所有权：读取 architecture-and-components.md
• 性能、中文输入与发布验收：读取 performance-release.md
• 大表格或日志：先设计虚拟化、增量加载和稳定行标识
• 编辑器或输入框：优先验证组合文本、候选窗和 UTF-8 边界
• 多面板布局：布局状态与业务状态分离，并给迁移版本
• 长任务：后台执行、可取消、带进度，主线程只提交最小更新

新手30秒入门

提供目标平台与最低系统版本、当前技术栈、窗口类型、核心工作流、数据规模、中文输入需求、快捷键、无障碍、离线与安全要求、目标安装包和性能预算。若是现有项目，同时提供入口、状态模型、构建命令和可复现问题。

先完成一个垂直切片：窗口启动、加载代表数据、用户操作、后台任务、错误提示、状态保存和重启恢复。它必须在目标平台上可运行并测到帧时间、内存与响应延迟，再扩展组件数量。

功能索引

标准工作流

1. 锁定平台矩阵

写明操作系统、架构、最低版本、显示缩放、窗口能力、输入法、主题、文件对话框、通知和分发方式。不同平台无法等价的行为先确定降级，而不是发布前临时分叉。

2. 划分架构边界

领域层不依赖窗口和控件；应用层编排用例、命令与权限；平台层封装文件、剪贴板、系统菜单和通知；视图层渲染状态并发出意图。异步任务返回结构化结果，不直接随意修改界面。

3. 指定状态所有权

每个可变状态只有一个权威所有者。派生值按需计算或缓存，不重复存储；用户意图转为命令，命令产生状态变化和可观察事件。临时交互状态、业务状态与持久化状态分开。

4. 定义组件契约

为组件写输入属性、输出事件、焦点规则、键盘行为、尺寸约束、加载、空、禁用、错误和无障碍语义。复合组件不得依赖全局隐式状态；样式令牌和业务数据分开。

5. 建立垂直切片

选择最重要工作流，贯通数据读取、界面展示、用户编辑、后台执行、错误恢复和持久化。先验证框架、线程、状态与平台边界，再抽象通用组件；不要先建庞大组件库。

6. 设计主线程预算

主线程只处理输入、状态提交、布局与绘制。文件、网络、解析、索引和重计算放到后台；结果分批回传、可取消并抑制过期结果。更新范围限定到受影响节点，避免全树重建。

7. 为真实数据量设计

表格、树、日志和编辑器使用虚拟化、稳定标识和增量数据。排序过滤在后台或索引层完成；缓存设置容量和失效策略。压力数据包含长中文、空值、百万行和快速连续更新。

8. 验证输入与可访问性

测试键盘导航、焦点环、屏幕阅读语义、高对比、缩放、左右手快捷键与非颜色提示。中文输入必须覆盖拼音组合、候选选择、光标移动、删除、撤销、粘贴和中英文混排，不能只测逐字符键入。

9. 持久化与迁移

配置写入采用版本化结构、原子替换和损坏回退。窗口位置先裁剪到当前显示器；布局引用稳定标识，组件删除或重命名时执行迁移。自动保存去抖，并在退出前处理未完成写入。

10. 做发布级验收

在干净机器或隔离账号验证安装、首次启动、权限、升级、卸载、文件关联、离线、崩溃恢复和回滚。分别构建目标架构，核对动态库、资源、字体、签名和安装包大小；保留版本、日志路径和崩溃符号映射。

输出规范

默认输出：

1. 平台、系统版本与分发矩阵
2. 领域、应用、平台、视图和任务边界
3. 状态所有权、命令与事件流
4. 组件契约和交互状态表
5. 垂直切片与实现顺序
6. 数据规模、主线程与内存预算
7. 中文输入、缩放、无障碍与平台差异验收
8. 构建、升级、回滚和崩溃取证清单

代码建议需标明假设、框架版本和平台差异。性能结论必须带数据规模、硬件、构建模式和测量方法；未测量时只称风险假设，不称瓶颈事实。

能力边界

• 不假设不同 Rust GUI 框架的生命周期和线程模型相同
• 不把网页 DOM、CSS 或响应式规则原样映射到原生组件
• 不在未测量时宣称零拷贝、无卡顿或低内存
• 不用阻塞等待把异步问题隐藏在主线程
• 不忽略中文组合输入、字体回退和 UTF-8 边界
• 不默认下载工具链、替换框架、签名或发布安装包
• 不读取、迁移或删除真实用户数据，除非明确授权并有备份
• 不替代平台安全、隐私、签名和商店政策的最终审查

稳定性保障

• 组件状态只有一个权威所有者，派生状态可复算
• 后台任务具备取消、过期结果抑制和错误通道
• 所有列表使用稳定标识，虚拟化不依赖可变索引
• 配置采用版本、原子写入、校验和损坏回退
• 性能测试区分调试与发布构建，并记录真实数据量
• 中文输入、缩放、主题与键盘在每个目标平台回归
• 崩溃与错误日志不包含令牌、正文或用户隐私
• 发布物可回到源码、依赖锁、工具链与符号文件

深度定制

代码编辑器增加语法树、增量高亮、组合文本、LSP 和超大文件模式；金融终端增加百万行虚拟表格、实时行情合并和时区；创作工具增加撤销事务、资源缓存和 GPU 失效恢复；运维工具增加日志背压、脱敏和断线重连；中文办公软件增加 CJK 字体回退、全半角、标点挤压和拼音候选窗定位；企业应用增加代理、证书、单点登录和受控更新渠道。

FAQ

应该先选框架还是先做架构？

先锁定平台能力、渲染复杂度、输入法、无障碍和分发需求，再用小型垂直切片验证候选框架。不要只凭示例外观决定。

状态管理要不要全局统一？

需要统一原则，不一定只有一个全局容器。业务状态、窗口布局和瞬时交互应分层，每个状态仍只有一个权威所有者。

为什么大列表滚动会卡？

可能来自未虚拟化、布局测量、文本塑形、分配、锁竞争或过度刷新。先用发布构建和代表数据测量，再定位主线程时间。

中文输入能逐字输入就算通过吗？

不算。必须覆盖组合态、候选窗、光标、删除、撤销、粘贴和中英文混排，并检查候选窗跟随缩放后的光标位置。

反模式与修正

按需 references

• 设计层次、状态、组件和任务边界时，读取 architecture-and-components.md
• 优化性能、验证中文与准备发布时，读取 performance-release.md