关于 gpui
gpui 是面向 GPUI 开发者的参考技能,按开发任务提供对应的 API 文档索引。内容涵盖界面元素、实体状态、事件、异步任务和测试等主题。
主要功能
- 01按主题定位参考文档
- 02涵盖动作与快捷键
- 03提供元素和实体管理资料
- 04包含测试参考与示例
适用场景
- 01查找 GPUI 特定 API 的参考
- 02实现键盘操作或异步任务
- 03为实体状态管理编写测试
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ longbridge/ gpui-kit --skill gpui安装后在 Claude Code 中输入/gpui确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/action.mdasync.mdcontext.mdelement-advanced.mdelement-api.mdelement-best-practices.mdelement-examples.mdelement-id.mdelement-patterns.mdelement.mdentity-advanced.mdentity-api.mdentity-best-practices.mdentity-patterns.mdentity.mdevent.mdfocus-handle.mdglobal.mdlayout-style.mdtest-examples.mdtest-reference.mdtest.md详细介绍
导航
根据任务加载相关参考文件:
| 主题 | 文件 | 加载时机 |
|---|---|---|
| 操作与按键绑定 | action.md | actions!、bind_keys、on_action、key_context |
| 异步与后台任务 | async.md | cx.spawn、background_spawn、Task、异步 I/O |
| 上下文管理 | context.md | App、Window、Context<T>、AsyncApp |
| 自定义元素(底层) | element.md | Element trait、request_layout、prepaint、paint |
| 实体状态 | entity.md | Entity<T>、WeakEntity、状态管理 |
| 事件与订阅 | event.md | cx.emit、cx.subscribe、cx.observe |
| 焦点与键盘导航 | focus-handle.md | FocusHandle、track_focus、Tab 导航 |
| 全局状态 | global.md | Global trait、cx.set_global、应用级配置 |
| 布局与样式 | layout-style.md | div()、h_flex()、v_flex()、flexbox、溢出、定位 |
| ElementId | element-id.md | ElementId、.id()、唯一性规则、有状态元素 |
| 测试 | test.md | #[gpui::test]、TestAppContext、VisualTestContext |
扩展参考
深入了解相关主题时,可查阅其他参考文件:
Element trait:
- element-api.md — 完整 API、命中框系统、事件处理
- element-patterns.md — 文本、交互、容器、复合模式
- element-examples.md — 完整示例:文本、交互、复杂元素
- element-best-practices.md — 性能、状态、常见陷阱
- element-advanced.md — 瀑布流/环形布局、异步更新、虚拟列表
实体管理:
- entity-api.md — 完整 Entity API、方法、生命周期
- entity-patterns.md — 模型-视图、跨实体通信、观察者
- entity-best-practices.md — 内存、性能、生命周期
- entity-advanced.md — 集合、注册表、防抖、状态机
测试:
- test-examples.md — 测试示例与模式
- test-reference.md — 完整测试 API 参考
评论
支持 Markdown