SuperAPI AI 工具集

cmux-custom-sidebar

通用与其它

查看项目

更新于 10-16 00:05

技能介绍

用途:根据用户用自然语言描述的结果(如“显示我的工作区并能跳转”),为其编写 cmux 自定义侧边栏,无需 Xcode、构建或签名。

主要能力:侧边栏由 ~/.config/cmux/sidebars/<name>.swift 中的单个 SwiftUI 风格视图表达式渲染,保存即热重载,绑定实时 cmux 状态(workspaces、tabs、git、PRs、clock),点击行可执行真实 cmux 命令。支持 stacks、Group、List、Section、网格、ScrollView、HSplitView 等容器,Text、Label、Image、Button、Menu、ProgressView、Gauge 等内容,以及排版、颜色、布局、背景、手势、禁用等修饰符;语言支持 let、函数、for/ForEach、if/else、三元、字符串插值、数组方法。

使用方式:先在 Settings > Beta features 启用 Custom sidebars(customSidebars.beta.enabled)。写入文件后用 cmux sidebar validate <name> 校验、cmux sidebar select <name> 选择,也可右键侧边栏切换按钮选择。保存自动热重载,cmux sidebar reload 可强制刷新。完整编写契约见 cmux docs sidebars,命令:curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/docs/custom-sidebars.md

限制:尚不支持 @State 与输入控件(TextField、Toggle、Slider、Picker)、自定义 struct/View、导航(sheet/popover)、AsyncImage;双向编辑不可用,但执行 cmux(...) 的点击可用。不支持的语法会被优雅跳过而非崩溃。侧边栏约每秒重新求值一次,长列表应过滤排序并限制数量(如 .prefix(20))。可选字段缺失时需用 if let 或三元判断。若未出现在选择器中,先检查 beta 开关与文件路径;渲染空白或部分空白时运行 validate 查看内联错误。