SuperAPI AI 工具集

gpui

写作与研究

查看项目

更新于 10-15 16:52

技能介绍

用途:为使用 GPUI 框架编写桌面应用提供规范与最佳实践参考,适用于编写 GPUI 视图或组件、用 Entity 实现状态管理、处理事件与键盘快捷键、编写异步任务与后台工作、构建表单/列表/对话框、使用类 Tailwind API 设置样式以及测试 GPUI 应用。

主要能力:包含 40+ 条规则,按 8 个类别与优先级组织,规则前缀分别为 core-(核心概念,CRITICAL)、render-(渲染,CRITICAL)、state-(状态管理,HIGH)、event-(事件处理,HIGH)、async-(异步与并发,MEDIUM-HIGH)、style-(样式,MEDIUM)、comp-(组件,MEDIUM)、anti-(反模式,CRITICAL)。核心要点包括:理解单一所有权模型、正确使用 read/update/observe/subscribe、用 WeakEntity 打破循环引用;区分 Render 与 RenderOnce;状态变更后调用 cx.notify();用 cx.observe() 响应 Entity 变化、cx.subscribe() 处理类型化事件;用 cx.listener() 绑定视图事件;任务需存储或 detach、用 background_spawn 处理 CPU 密集工作;用 h_flex()/v_flex() 布局、cx.theme() 取色;避免静默丢弃错误、丢弃 Task 或订阅、循环引用、漏调 notify() 和 unwrap()。

使用方式:按需查阅各规则文件,如 rules/core-ownership-model.md、rules/render-render-vs-renderonce.md、rules/anti-silent-error.md。每个规则文件包含重要性说明、错误代码示例及解释、正确代码示例及解释,以及补充背景与参考。

适用场景:GPUI 桌面应用的开发、审查与重构,尤其是状态、事件与异步部分。

限制:本资料为规则索引与摘要,未提供安装命令、版本要求、收费信息或官方文档链接;具体 API 细节需查阅各规则文件原文。