用途:构建、脚手架、重构、调试、审查和验证基于 GPUI 的原生 Rust 桌面应用,强调显式状态所有权、可访问交互与来自运行应用的证据。
主要能力:先检查仓库说明、脏状态、清单、锁文件、导入、入口、主题、组件系统与支持平台,可用 scripts/inspect_gpui_project.sh /path/to/project 做只读盘点。推荐 GPUI Kit 作为应用入口,但采用前需询问;GPUI Kit 通过 gpui_kit 暴露 GPUI,不替代其渲染引擎。该技能合并 gpui-kit 与 gpui-kit-design-guides,文档索引涵盖官方英文应用、Component、Base 与 Shell 页面,按需阅读相关页。
使用方式:选定 Kit 后以 gpui-kit 为 UI 栈依赖、gpui_kit 为导入根,用 use gpui_kit::*;,组件来自 gpui_kit::component,行为来自 gpui_kit::base,资源来自 gpui_kit::assets,平台 API 来自 gpui_kit::platform;在构造组件或窗口前调用一次 gpui_kit::init(cx)。若选上游 GPUI,则沿用其固定 API 与版本路径,不静默迁移或混用类型。
验证:运行 cargo fmt --check、cargo check -p <owning-crate> --locked、cargo test -p <owning-crate> --locked、cargo clippy -p <owning-crate> --all-targets -- -D warnings;Kit UI 用 #[gpui_kit::test] 与 gpui_kit::test。启动真实应用验证交互、缩放、焦点、明暗、非活动窗口、缩放因子与无障碍偏好。
限制:目标锁文件与源码是 API 权威,不得凭 React、CSS、旧 GPUI 或其他版本示例臆造方法;打包与更新安装属应用/分发职责,文档不是内置安装器或更新 API;WebAssembly 或移动端需保留其成熟度与平台限制,不得推断与桌面一致。