SuperAPI AI 工具集

tab-configs

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:该技能是 Warp 标签页配置 TOML 文件的参考规范,用于创建或更新标签页配置,也为 create-tab-config、update-tab-config 等技能提供共享上下文。

文件位置:标准版 Warp 的配置位于 ~/.warp/tab_configs/;非稳定版(如预览或预发布通道)使用通道专属目录,例如 ~/.warp-<channel>/tab_configs/。不要使用 ~/Library/Application Support/。可用 ~/.warp* 目录判断当前生效的数据目录。每个 .toml 文件定义一个标签页布局,显示在“+”菜单中;选择后 Warp 会按配置打开新标签页并运行指定命令。

结构:顶层字段有 name(必填,菜单显示名)、title(可选,支持 {{param}} 模板变量)、color(可选,取值 black、red、green、yellow、blue、magenta、cyan、white)。所有窗格写在扁平 [[panes]] 数组中,第一项为根节点。叶子节点字段:id、type(terminal、agent、cloud)、directory、commands、is_focused、shell;其中 directory、commands、shell 仅适用于 terminal 与 agent。拆分节点字段:id、split(horizontal 左右排列或 vertical 上下排列)、children(子窗格 ID 列表,至少 2 项,顺序即视觉顺序)。同一拆分内各子项等分尺寸,没有弹性或比例值。

参数:通过 [params.<name>] 声明,在 directory、commands、title 中用 {{name}} 引用。每项可设 type(text 默认、branch、repo)、description、default。{{autogenerated_branch_name}} 为保留变量,引用时每次打开自动生成唯一 worktree 分支名。

校验规则:children 中每个 ID 必须对应存在的 [[panes]] 项;窗格树不得有环;叶子节点不得含 children 或 split;叶子必须含 type;拆分节点 children 至少 2 项;最多一个 is_focused = true;所有 id 唯一;首项为根。

限制:资料未提供该技能的具体安装命令与调用接口;若用户请求缺少布局、目录、命令、焦点窗格或参数等关键信息,应先澄清而非猜测。新建配置建议使用描述性窗格 ID(如 editor、server)与 snake_case 文件名,更新时先读取原文件并尽量保留原有结构。