Warp 自定义工具栏命令绑定 CLI Agent:从 Unknown 会话到完整 Agent 体验

发布时间:2026/11/22 10:39:29

Warp 自定义工具栏命令绑定 CLI Agent:从 Unknown 会话到完整 Agent 体验 桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载自定义命令如公司内部脚本uber-cli、my-claude-wrapper在 Warp 中匹配工具栏规则后过去只能得到CLIAgent::Unknown会话缺失图标、品牌色、Rich Input 提交策略、技能与插件监听等专属体验。本篇文章基于 Warp 开源仓库中的 APP-4060 产品规格 与技术规格 TECH.md结合源码实现完整讲解「一条自定义工具栏命令绑定一个 CLI Agent」的配置方式、底层数据结构、检测链路与插件生命周期。读完后你将掌握如何在设置界面为自定义命令选择 Agent、其配置如何持久化与云同步、命令检测如何携带 Agent 信息以及自定义命令如何获得与原生检测 Agent 完全一致的体验。背景与问题自定义命令为何总是沦为 Unknown 会话Warp 会把长时间运行的命令超过LONG_RUNNING_COMMAND_DURATION_MS阈值后与具体 CLI Agent 关联从而在终端底部显示对应 Agent 的工具栏Toolbar。对于原生命令claude、codex、gemini等CLIAgent::detect 可以直接通过命令前缀识别。但现实中很多用户会通过包装脚本或别名调用 CLI Agent例如 Uber 团队使用的aifx agent run claude或者形如my-claude-wrapper的自定义别名。这类命令无法被前缀规则命中只能依靠用户在设置中添加正则模式Commands that enable the toolbar来启用工具栏。问题在于旧实现中正则匹配只返回一个布尔值命中的会话被无条件标记为CLIAgent::Unknown于是工具栏显示通用外观没有 Agent 的图标与品牌色会话被标记为CLIAgent::Unknown导致不会创建插件监听器没有富状态、Rich Input 的自动显隐Rich Input 提交策略退化为默认的Inline而不是该 Agent 最合适的策略斜杠菜单中缺少该 Agent 专属的 skill provider通知消息缺少 Agent 的显示名与图标。产品规格PRODUCT.md的核心目标就是给「正则模式 → CLI Agent」之间架起一座桥让用户显式告诉 Warp 某个自定义模式代表哪个 Agent。目标与非目标目标允许用户为每条自定义工具栏命令模式指定一个具体 CLI Agent模式命中后会话表现与原生检测到的 Agent 完全一致图标、品牌、插件监听资格、Rich Input 策略、技能、通知保持aifx agent run claude对 Uber 团队成员的既有 Claude 检测逻辑不变。非目标不改变已知 Agent 的自动检测逻辑不支持一个模式绑定多个 Agent一个模式 一个 Agent不新增新的 CLI Agent 类型不改变自定义命令的插件安装/更新流程现有 install chip 逻辑已按 Agent 做插件检查。设置界面为每条命令选择 Agent行布局设置列表中每条命令新增一个右侧下拉框整体布局为[命令正则文本] [Agent Dropdown ▼] [× 移除]命令文本左对齐且可收缩等宽字体下拉框固定宽度并与命令文本同组靠左移除按钮右对齐。折叠状态下下拉框顶部栏直接显示已选 Agent 的名称。下拉项下拉菜单列出所有已知 CLI Agent每一项展示Agent 图标来自CLIAgent::icon()Agent 显示名来自CLIAgent::display_name()如 Claude Code、Gemini、Codex首个默认项 CLI Agent无图标新添加的模式默认选中它。CLIAgent::Unknown不会作为可选项目出现在下拉中——它被 CLI Agent 这个默认项所代表。产品规格中默认项文案为 CLI Agent而当前仓库落地实现cli_agents_page.rs将其命名为 Other并把菜单头部文案覆盖为 Select coding agent语义一致。添加 / 移除 / 修改添加通过文本输入框提交新命令后以默认 CLI Agent空值加入列表用户随后可用下拉框修改移除删除命令时其 Agent 映射一并从底层设置中清理同一 HashMap 条目内模式与 Agent 共存天然无孤儿数据修改选择下拉中的某个 Agent 会立即持久化并通过与其他 AI 设置相同的机制同步到云端。从当前源码看该设置项定义在 app/src/settings/ai.rs 的cli_agent_footer_enabled_commandsTOML 路径agents.third_party.cli_agent_toolbar_enabled_commands其sync_to_cloud为Globally(RespectUserSyncSetting::Yes)即遵循用户云同步开关进行全局同步。下拉框的源码级实现设置页的每个下拉框由create_cli_agent_dropdowns创建cli_agents_page.rs核心配置包括set_top_bar_max_width(160.)紧凑的顶部栏宽度set_menu_width(180.)容纳「图标 名称」的菜单宽度set_main_axis_size(MainAxisSize::Min)按内容宽度自适应菜单项遍历enum_iterator::all::CLIAgent()跳过Unknown为每个 Agent 构造MenuItemFields::new(agent.display_name()).with_icon(agent.icon())选中后派发SetCLIAgentForCommand { pattern, agent }动作通过set_selected_by_name依据当前保存值空值显示为 Other恢复选中状态。下拉组件本身是通用的Dropdownview_components/dropdown.rs菜单项支持with_iconmenu.rs。底层数据结构ToolbarCommandMap 与旧数据迁移产品与技术规格要求把设置类型从VecString升级为「模式 → Agent」的映射结构。当前仓库以ToolbarCommandMap实现app/src/settings/ai.rs/// 键为命令正则模式保序值为序列化的 CLIAgent 名如 Claude。 /// 空字符串值表示 CLI Agent即 CLIAgent::Unknown。 pub struct ToolbarCommandMap(IndexMapString, String);两个关键设计1. 用IndexMap而非HashMap保序。技术规格的风险章节明确提到HashMap不保证迭代顺序、可能导致设置列表乱序落地实现选择了IndexMap使设置界面列表顺序确定按插入序。2. 向后兼容的反序列化。旧的设置格式是字符串数组[pattern1, pattern2]新格式是映射{pattern1: Claude, pattern2: }。ToolbarCommandMap通过#[serde(untagged)]枚举同时兼容两种格式#[derive(Deserialize)] #[serde(untagged)] enum MapOrVec { Map(IndexMapString, String), Vec(VecString), } // Map 格式直接使用Vec 格式逐项转为空值键 // [pattern1, pattern2] - {pattern1: , pattern2: }SettingsValue::from_file_value也遵循同样的双格式逻辑先尝试对象map解析再回退数组legacy解析。由于用户不会降级只需前向迁移。若 TOML 值既不是字符串数组也不是映射损坏配置则回退到默认空映射与既有损坏设置的处理行为一致。三个设置操作方法对应 app/src/settings/ai.rs 中的三个方法add_cli_agent_footer_enabled_command(command)trim 后判空、去重以空字符串值插入键remove_cli_agent_footer_enabled_command(command)shift_remove删除键Agent 映射随键一并消失set_cli_agent_for_command(pattern, agent: OptionCLIAgent)None写空字符串Some(agent)写agent.to_serialized_name()仅当键已存在时更新。to_serialized_name/from_serialized_name定义于 cli_agent.rs是CLIAgent与字符串之间的序列化互转空字符串反序列化回CLIAgent::Unknown。对应的 TOML 示例设置界面之外直接查看/配置底层文件时[agents.third_party] # 新格式模式 - Agent 序列化名空字符串表示 CLI Agent cli_agent_toolbar_enabled_commands { my-claude-wrapper Claude, uber-cli Codex, legacy-cmd }检测链路matched_agent 如何携带 Agent技术规格TECH.md把检测链路的改造作为核心让bool匹配升级为「携带 Agent 的匹配」。编译后的正则单例CompiledCommandsForCodingAgentToolbar是缓存编译正则的单例模型将ToolbarCommandMap编译为「正则 Agent」对pub struct CompiledCommandsForCodingAgentToolbar { regexes: Vec(Regex, CLIAgent), }其parse遍历设置映射编译键为正则失败则跳过值经CLIAgent::from_serialized_name解析为具体 Agent。单例注册时订阅AISettingsChangedEvent::CLIAgentToolbarEnabledCommands变更事件任何增删改都会触发正则重建。匹配入口matched_agent返回OptionCLIAgentpub fn matched_agent(app: AppContext, command: str) - OptionCLIAgent { Self::as_ref(app) .regexes .iter() .find(|(regex, _)| regex.is_match(command)) .map(|(_, agent)| *agent) }is_match针对完整命令字符串进行匹配因此正则需要能覆盖包装脚本的整条命令例如.*my-claude-wrapper.*或直接写命令名。终端侧的检测顺序终端视图的detect_cli_agent_from_modeluse_agent_footer/mod.rs在命令成为长期运行命令后被调用检测顺序如下先走原生检测CLIAgent::detect解析命令首词支持跳过FOO1这类环境变量前缀、按 shell 别名表解析别名、再与各 Agent 的command_prefixes()比对同时检查aifx agent run claude特例若原生检测返回None回退到CompiledCommandsForCodingAgentToolbar::matched_agent命中用户自定义模式则返回该模式绑定的具体 Agent若返回的 Agent 来自自定义模式函数还会顺带返回自定义命令前缀命令首词供后续 UI 使用。这样模式命中不再无条件返回CLIAgent::Unknown而是把用户在设置中选择的 Agent 一路传递到会话创建。会话创建与完整 Agent 体验检测结果最终传给CLIAgentSessionsModel::set_session存储在CLIAgentSession.agent字段cli_agent_sessions/mod.rs。所有下游消费方都从这个会话读取 Agent工具栏渲染使用session.agent的图标、显示名与品牌色。品牌色在 cli_agent.rs 中定义例如 Claude 橙色、Gemini 蓝、Grok 近黑等Rich Input 提交策略由rich_input_submit_strategy(agent)选择use_agent_footer/mod.rs当前实现如下Agent提交策略Codex、OhMyPi、HermesBracketedPaste括号粘贴CopilotBracketedPasteDelayedEnter括号粘贴 延迟回车Claude、OpenCode、Gemini、Auggie、Grok、CursorCliDelayedEnter延迟回车Amp、Droid、Pi、Kiro、Goose、Vibe、Antigravity、WarpTui、UnknownInline直接写入斜杠菜单技能supported_skill_providers()决定 Rich Input 斜杠菜单展示哪些 skill provider例如 Claude 只显示SkillProvider::ClaudeCodex 显示 Agents/Claude/Codex 三个Unknown 为空通知会话携带 Agent 后通知可显示正确的显示名与图标。需要说明的是产品规格中描述的提交策略映射与当前源码实现存在细微差异如规格将 Claude 归为Inline、Copilot 归为DelayedEnter而源码实际为 Claude →DelayedEnter、Copilot →BracketedPasteDelayedEnter本文章以仓库当前代码为准。插件监听器与安装/更新芯片自定义模式一旦绑定到具体 Agent插件生命周期将自动生效无需额外改动OSC 777 哨兵路径插件发送warp://cli-agent的SessionStart事件时view.rs中约 10960 行register_listener被调用。只要is_agent_supported(CLIAgent::Claude)为真listener/mod.rs 当前对 Claude、OpenCode、Codex、Gemini、Auggie、Droid、Pi、OhMyPi、Grok、WarpTui 均返回 true监听器即注册成功而Unknown永远不会创建监听器Codex 主动注册Codex 使用 OSC 9 纯文本通知检测到CLIAgent::Codex后立即调用register_cli_agent_listener约 10069 行——自定义模式绑定 Codex 同样触发该路径安装/更新芯片plugin_manager_for(agent)plugin_manager/mod.rs返回对应 Agent 的插件管理器从而显示插件安装/更新 chip。简言之只要detect_cli_agent_from_model返回具体 Agent会话就会携带它整条插件链路注册监听器、安装 chip、更新 chip、富状态自动按该 Agent 运行与原生检测完全一致。aifx agent run claude 特例CLIAgent::detect中的is_aifx_agent_run_claude判断cli_agent.rs做了两件事命令以aifx agent run claude开头且用户属于 Uber 团队工作区团队 UID 匹配UBER_TEAM_UID。命中即返回CLIAgent::Claude无需任何配置。该特例保持原样、不随本次改动变化非 Uber 用户若希望获得相同效果只需添加自定义模式并绑定到 Claude。验证清单从设置到运行的一整套检查结合产品规格的 Validation 与成功标准推荐按以下清单验证设置界面每条命令的行内都出现下拉框下拉包含 CLI Agent无图标与除Unknown外的全部 Agent正确图标 显示名默认值新添加的命令默认 CLI Agent绑定验证添加my-claude-wrapper模式并绑定 Claude在终端运行该命令检查工具栏显示 Claude 图标与品牌、Rich Input 使用 Claude 的提交策略、插件未安装时出现安装 chip、通知显示 Claude Code插件监听绑定 Claude/Codex/OpenCode 的模式命中后插件生命周期install chip、update chip、监听器注册与原生检测一致持久化修改选择后重启 Warp下拉框仍保持所选状态设置随其他 AI 设置云端同步移除清理删除命令后重新添加同一条命令应恢复为默认 CLI Agent默认行为兼容不绑定 Agent 的既有模式仍产生CLIAgent::Unknown会话工具栏外观与旧版一致aifx 无回归Uber 团队成员运行aifx agent run claude仍识别为 Claude。风险与注意事项设置迁移自定义Deserialize必须同时处理旧VecString与新HashMap两种格式损坏值回退为空映射迭代顺序产品规格时代使用HashMap时列表顺序可能不保证当前实现改用IndexMap已解决此问题设置界面展示顺序稳定孤儿条目模式与 Agent 同处一个映射条目删除模式必然清除其 Agent 绑定无需额外清理逻辑。综上该方案通过「设置类型升级VecString→ 模式→Agent 映射 编译正则单例携带 Agentmatched_agent 检测链路传递detect_cli_agent_from_model 现有会话/插件机制复用」四步改造让自定义工具栏命令获得与原生 CLI Agent 完全一致的开箱体验。相关实现细节可继续在仓库中追溯settings/ai.rs、terminal/cli_agent.rs、terminal/view/use_agent_footer/mod.rs、terminal/cli_agent_sessions/listener/mod.rs 与 settings_view/cli_agents_page.rs。赞分享桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载相关推荐Warp 自定义工具栏命令与 CLI Agent 关联从 CLIAgent::Unknown 到完整插件生命周期的设计实践Warp 自定义工具栏命令与 CLI Agent 关联从 CLIAgent::Unknown 到完整插件生命周期的设计实践 导读 本文以 specs/APP桌面应用开发者工具人工智能AI 应用AI Agent代码智能体为 omp-coding-agent 编写自定义工具Custom Tools从工厂模式到会话状态管理的完整实践指南为 omp coding agent 编写自定义工具Custom Tools从工厂模式到会话状态管理的完整实践指南 自定义工具Custom Tools人工智能AI Agent代码智能体工具调用CLIMCP Clientsclaude-agent-sdk-python 自定义 Agent 完整指南从 Markdown 文件到 AgentDefinition 编程式定义claude agent sdk python 自定义 Agent 完整指南从 Markdown 文件到 AgentDefinition 编程式定义 本指南以人工智能AI Agent工具调用MCP Clients大模型创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/23 1:22:16

先认证后授权怎么落地:安当OTP 在解耦架构里的角色

一、为什么"认证"和"授权"必须解耦 很多系统的安全隐患,根源不在加密算法不够强,而在流程上把"你是谁"和"你能做什么"粘在了一起。一个典型的老式做法是:用户提交账号密码,应用校验通过后…

2026/11/23 1:17:45

去哪里申请国际电工证培训机构怎么选

许昌电工去哪申请国际电工证?值不值得考你必须知道的3个真相 怕考不过白交培训费?许昌的电工朋友,你们是不是也在犹豫要不要考国际电工证?别急,今天这波干货,就告诉你: 去哪里申请国际电工证…

2026/11/23 1:17:45

低压电工证表内部消息:报名避坑指南+继续教育全解析

低压电工证表内部消息:报名避坑指南+继续教育全解析 你是不是还在为不知道去哪报名低压电工证表而发愁?怕被那些打着“包过”旗号的中介坑钱?其实你不是一个人,很多人在考证路上都踩过坑。今天我就来给你讲讲内部消息,告诉你怎么报名不被坑,还能顺利拿…

2026/11/23 1:17:45

台州黄岩电工证复审必须知道的良心建议

台州黄岩电工证复审必须知道的良心建议 证书过期了不知道怎么复审延期?别急,这事儿我见过太多人踩坑,尤其是像你这样在一线干了几年的电工,真到了要复审的时候才发现流程复杂、材料繁多,甚至被一些“代办机构”忽悠得团团转。 台州黄岩电工证复审…

2026/11/23 1:17:45

工程电工证报名费内部消息:洛阳涧西区电工从业者避坑指南

工程电工证报名费内部消息:洛阳涧西区电工从业者避坑指南 你是不是正愁不知道去哪报名工程电工证,怕被中介骗钱?别急,我这有 内部消息 ,专为洛阳涧西区市政公用工程从业者准备的,帮你避开报名陷阱,少花冤枉钱,还能搞清楚这证到底值不值得考。…

2026/11/23 1:17:45

瑞昌在哪里考电工证多少钱?别被中介坑了

瑞昌在哪里考电工证多少钱?别被中介坑了 你是不是也跟很多同行一样, 不知道去哪报名怕被中介坑 ,尤其是看到【瑞昌在哪里考电工证多少钱】这样的问题,心里直打鼓?别急,今天我就从 鹤壁中小施工企业负责人…

2026/11/23 1:12:32

酒泉哪儿办电工证?2026河南最新政策下实操考试心里没底怕挂科

酒泉哪儿办电工证?2026河南最新政策下实操考试心里没底怕挂科 实操考试心里没底怕挂科?你不是一个人。特别是像河南、酒泉这样的地区,越来越多的电工从业者开始关注“酒泉哪儿办电工证”这个问题,因为2026年河南最新政策对特种作业操作证的考试流…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/23 0:26:19

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/23 0:01:38

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了 不知道去哪报名怕被中介坑?南宁哪里可以学电工证值不值得考?这是很多想考电工证的朋友最关心的问题。现实中,不少人在选择培训机构时被各种五花八门的广告信息搞得晕头转向,甚至被坑了钱还没拿…

2026/11/23 0:01:38

建设局特种工证怎么查全国通用的复审流程

建设局特种工证怎么查全国通用的复审流程 证书过期了不知道怎么复审延期,这是很多特种作业从业者常遇到的问题。尤其是在洛阳涧西区从事水利工程工作的你,特种作业操作证不仅是上岗的“通行证”,更是保障安全作业的法律底线。如果操作证过期了,不仅影响工…

2026/11/23 0:01:38

电工证跨考政策值不值得考?学历不高也能考的真相

电工证跨考政策值不值得考?学历不高也能考的真相 你是不是也觉得学历不够,报电工证怕被拒?别急,国家安全生产考试网明文规定, 电工证跨考政策 对学历门槛没有硬性限制,只要你年满18岁,身体健康,能通过实操考试,就能报考。关键是, 值不值得考…

2026/11/22 9:39:14

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/22 5:39:03

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑