桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载导读在 Warp 的编排Orchestration配置界面中plan card 与 run_agents 确认卡允许用户为子 Agent 选择执行引擎Harness与模型。本指南以 QUALITY-643 技术规格为核心深入剖析该功能的两大痛点——harness 选择器硬编码、模型选择器始终展示 Warp 内部 LLM 目录——以及对应的六项改造方案覆盖从HarnessAvailabilityModel数据源、共享 picker 逻辑到 Claude Code 的ANTHROPIC_MODEL环境变量与 Codex 的~/.codex/config.toml模型写入的完整调用链。读完本文你将掌握 Warp 如何在桌面端与 Web 端保持一致、如何让第三方 harness CLI 真正收到所选模型以及本地/云执行模式下模型传递的差异与安全约束。一、背景编排配置 UI 的 Harness 与模型选择现状1.1 两张共享逻辑的卡片编排配置 UI 由两个界面构成plan cardapp/src/ai/document/orchestration_config_block.rs用于规划阶段配置子 Agent 的执行参数run_agents 确认卡app/src/ai/blocklist/inline_action/run_agents_card_view.rs在真正启动子 Agent 前进行最终确认。两张卡片共用app/src/ai/blocklist/inline_action/orchestration_controls.rs中的选择器逻辑包括populate_harness_picker()约 L380、populate_model_picker_for_harness()约 L314、is_model_in_filtered_choices()约 L353、first_filtered_model_id()约 L368、sync_picker_selections()约 L508与matches_harness_filter()约 L299。1.2 两个核心问题规格文档明确指出现状的两个缺陷Harness 选择器硬编码为[Oz, Claude, Codex]——既没有读取服务端下发的availableHarnesses列表也没有包含 Gemini更不尊重管理员在组织设置中的启用/禁用状态模型选择器始终展示 Warp 内部 LLM 目录并按 Provider 过滤Anthropic 对应 Claude、OpenAI 对应 Codex。这些内部 ID如claude-4-6-opus-high无法被第三方 harness CLI 识别。服务端其实维护着各 harness 各自的模型目录桌面客户端也已经在HarnessAvailabilityModel中拉取并缓存了这些数据但编排 UI 一直没有使用。1.3 模型 ID 无法送达子进程除了 UI 层的问题模型 ID 还存在两条“断链”Claude Code收不到ANTHROPIC_MODEL环境变量Codex通过~/.codex/config.toml传递模型但这只适合云端/远程环境文件系统隔离本地子 Agent 绝不能触碰它——详见app/src/pane_group/pane/local_harness_launch.rsL143 附近的注释本地 Codex 子进程必须依赖用户已有的本地配置否则会覆盖用户全机器的~/.codex/config.toml并与并行 Agent 产生竞态。二、数据源HarnessAvailabilityModel与展示元数据2.1 服务端目录的客户端缓存app/src/ai/harness_availability.rs中的HarnessAvailabilityModel是单例SingletonEntity负责向服务端拉取并缓存可用 harness 列表pub struct HarnessAvailability { pub harness: Harness, pub display_name: String, pub enabled: bool, pub available_models: VecHarnessModelInfo, } pub struct HarnessModelInfo { pub id: String, pub display_name: String, pub reasoning_level: OptionString, }其核心 API 包括available_harnesses()→[HarnessAvailability]完整 harness 列表harness、display_name、enabled、available_modelsmodels_for(harness)→Option[HarnessModelInfo]某 harness 的模型列表id、display_name当列表为空时返回Noneis_harness_enabled(harness)→bool判断某 harness 是否被管理员启用变更时发出HarnessAvailabilityEvent::Changed事件。值得注意的缓存策略源码依据缓存键为AvailableHarnesses序列化写入 private user preferencesfn cache/fn get_cached服务端尚未响应时使用default_harnesses()兜底仅含Harness::Ozenabledtrue保证 UI 在预取阶段即可用网络从离线恢复NetworkStatusEvent::NetworkStatusChanged、登录完成AuthManagerEvent::AuthComplete、团队变更UserWorkspacesEvent::TeamsChanged都会触发refresh()重新拉取refresh()成功后若列表有变化会使缓存失效并发出HarnessAvailabilityEvent::Changed供 UI 重新填充选择器normalize_harness_display_names()会强制将 Oz 的 display_name 固定为客户端侧的harness_display::display_name()返回值。此外should_show_harness_selector()依据FeatureFlag::AgentHarness且已知 harness 数量 1 来决定是否展示 harness 选择器has_any_enabled_harness()则用于判断是否至少存在一个可用的 harness影响云 Agent 能否启动配合cloud_agent_start_blocker的NoEnabledHarnesses判定。2.2 展示元数据图标、品牌色与显示名app/src/ai/harness_display.rs为每个Harness变体提供统一的展示元数据确保多个 UI 面下拉框、会话侧栏不会漂移pub fn display_name(harness: Harness) - static str { match harness { Harness::Oz Warp Agent, Harness::Claude Claude Code, Harness::OpenCode OpenCode, Harness::Gemini Gemini CLI, Harness::Codex Codex, Harness::Unknown Unknown, } }icon_for()返回对应的品牌图标Oz→Agent、Claude→ClaudeLogo、Codex→OpenAILogo、Gemini→GeminiLogobrand_color()返回品牌色调Claude 橙色、Gemini 蓝色、OpenAI 色并提供了圆形象底circle_background与圆上图标填充色icon_fill_on_circle等更精细的渲染辅助。三、改造方案一Harness 选择器改为服务端数据驱动3.1 替换硬编码列表populate_harness_picker()orchestration_controls.rs中原本硬编码的[Harness::Oz, Harness::Claude, Harness::Codex]迭代L392 附近将被替换为读取HarnessAvailabilityModel::as_ref(ctx).available_harnesses()。对每个HarnessAvailability条目图标使用harness_display::icon_for()与harness_display::brand_color()已覆盖包括 Gemini 在内的所有变体标签使用harness_display::display_name()服务端的display_name字段也可用但客户端名称与服务端返回前保证非空且二者一致若!entry.enabled渲染为禁用项不可选中、文字置灰。MenuItemFieldsAPI 支持.with_disabled(true)并可为禁用原因附加 tooltip已启用条目排在禁用条目之前。从源码看该改造在populate_harness_picker的 row→menu item 映射中已有雏形row.disabled_reason为Some(reason)时调用with_disabled(true).with_tooltip(reason)否则注册harness_changed(row.id)选中动作——改造的关键是把 row 的来源从硬编码清单切换为harness_snapshot背后的服务端数据。3.2 订阅变更事件两张卡片视图需要同时订阅HarnessAvailabilityEvent::Changed在服务端列表更新时重新填充 harness 选择器。这一订阅与两张卡片已有的LLMPreferencesEvent::UpdatedAvailableLLMs订阅并存相互独立。对应行为清单PRODUCT.md behaviors 1–5harness 列表来源、品牌图标、禁用态、排序、选中项被禁用时的保留与提示。四、改造方案二模型选择器切换为 Harness 专属模型 Default model 入口4.1 按执行模式与 Harness 分支populate_model_picker_for_harness()需要新增is_local: bool参数或直接传入当前RunAgentsExecutionMode使选择器具备执行模式感知能力替代当前按 Provider 过滤LLMPreferences的逻辑let harness Harness::parse_orchestration_harness(harness_type); match harness { Some(Harness::Oz) | None { // 维持现状LLMPreferences 按 Provider 过滤 } Some(Harness::Codex) if is_local { // 本地 Codex只有 Default model 入口无法传递模型 } Some(harness) { // 1. 始终在最前加 Default model 入口值为空字符串 // 2. 读取 HarnessAvailabilityModel::as_ref(ctx).models_for(harness) // 3. Some(models)每个 HarnessModelInfo 追加为菜单项 // display_name 作标签id 作为 model_changed 动作值 // 4. None仅展示 Default model加载中/空状态 } }Default model 入口使用标签Default model并发出A::model_changed(String::new())空字符串与 Web UI 的行为一致Web 端同样以值添加该入口。4.2 各类 Harness 的模型目录内容结合 PRODUCT.md 的行为定义Oz或未设置展示 Warp LLM 目录单 Agent 模式下同一套模型此行为不得回归Claude Code顶部Default model其后为服务端提供的 Claude Code 模型目录如best、opus、sonnet、haiku、opus (1M context)、sonnet (1M context)以及opus 4.7、sonnet 4.6等 pinned 版本CodexCloud 模式顶部Default model其后为服务端提供的 Codex 模型目录如default、GPT-5.5、GPT-5.4、GPT-5.4 mini。注意其中default条目与服务端约定为“不写 model 键”与 Default model 的实际效果相同但为 Codex 专属语义CodexLocal 模式只展示Default model。理由已在 1.3 节说明Codex CLI 从全局共享的~/.codex/config.toml读取模型子 Agent 写入会破坏用户已有配置并与并行 Agent 竞争Gemini当前对编排禁用遵循同一模式——顶部Default model其后是服务端提供的 Gemini 模型如有。每个模型条目展示服务端目录中的display_name原始id如opus、gpt-5.4则作为选中后的 model_id 存下来并最终传给 harness 进程。harness 模型条目不带 Provider 图标或模型规格侧边信息这些元数据不存在。4.3 同步改造三处辅助函数is_model_in_filtered_choices()非 Oz harness 时将 model_id 对照HarnessAvailabilityModel::models_for()校验或接受空字符串对应 Default model 入口本地 Codex 时仅空字符串有效first_filtered_model_id()非 Oz harness 时返回Some(String::new())即 Default model 入口作为默认值sync_picker_selections()非 Oz harness 时从HarnessAvailabilityModel::models_for()查找 display_name而非LLMPreferences并将空 model_id 映射为 Default model 标签。4.4 执行模式切换与 Harness 变更时的重置当执行模式在 Local 与 Cloud 之间切换时HarnessChanged/ExecutionModeToggled处理器必须重新填充模型选择器——因为 Codex 的可用模型取决于执行模式。用户切换 harness 时 model_id 会重置各 harness 模型目录互不相交非 Oz harness 重置为 Default model空字符串Oz 重置为第一个可用的 Warp LLM唯一的例外是空字符串本身Default model可以在非 Oz harness 之间保留。对应行为清单behaviors 6–10各 harness 模型目录内容、11–14默认值、重置、加载/空状态、15–16跨 UI 一致性、sync 逻辑。五、改造方案三双卡片订阅 Harness 模型到达事件两张卡片视图orchestration_config_block.rs、run_agents_card_view.rs已有LLMPreferencesEvent::UpdatedAvailableLLMs订阅需要新增对HarnessAvailabilityModel的订阅harness 列表变化时 → 重新填充harness 选择器behaviors 1–5harness 模型目录到达时 → 重新填充模型选择器但仅当当前 harness 为非 Oz 时执行behavior 15。这一机制同时覆盖两种边界情况PRODUCT.md behaviors 13–14加载态用户切换到非 Oz harness 时模型目录尚未拉取完选择器只显示 Default model目录到达后自动补全完整列表并保持 Default model 处于选中状态空态服务端返回空模型列表时选择器只显示 Default modelmodel_id 保持为空。六、改造方案四向本地 Claude Code 子进程传递ANTHROPIC_MODEL6.1 环境变量注入点app/src/pane_group/pane/local_harness_launch.rs的prepare_local_harness_child_launch()L159新增model_id: OptionString参数在基于task_env_vars()构建出env_vars后Claude合并harness_model_env_vars(harness, model_id.as_deref())的返回值即当 model_id 非空时设置ANTHROPIC_MODELCodex本地子进程不注入任何模型覆盖——UI 层保证本地 Codex 的 model_id 为空behavior 8因此此处无需动作现有代码也刻意跳过prepare_codex_environment_config()L143 附近的注释说明本地 Codex 必须依赖用户已有的本地认证与会话状态不能运行共享的 Codex 环境准备流程否则会向~/.codex/auth.json播种OPENAI_API_KEY并重写全机器的~/.codex/config.toml。6.2harness_model_env_vars的底层实现app/src/ai/agent_sdk/driver/harness/mod.rs的harness_model_env_vars()L473实现如下关键语义// 文档注释我们使用 ANTHROPIC_MODEL 环境变量而非 --model CLI 标志 // 因为环境变量是最可靠的机制且能避免与 Claude Code settings.json 的优先级冲突。 let Some(model_id) third_party_harness_model_config .map(|config| config.model_id.as_str()) .filter(|id| !id.is_empty()) else { return env_vars; }; match selected_harness { Harness::Claude { env_vars.insert(OsString::from(ANTHROPIC_MODEL), OsString::from(model_id)); } Harness::Oz | Harness::OpenCode | Harness::Gemini | Harness::Codex | Harness::Unknown {} }即在本地 Claude 子进程启动时prepare_local_harness_child_launch中env_vars.extend(harness_model_env_vars(harness, harness_model_config.as_ref()))L272–275模型 ID 会进入隐藏子 pane 的环境而对 Codex 等其它 harness 返回空 map。6.3 调用点更新terminal_pane.rs的launch_local_harness_child()L1302 附近中调用prepare_local_harness_child_launch()L1325 附近时需传入model_id值。注意terminal_pane.rs中apply_child_model_id_override目前只设置 Oz 的 LLM 偏好——这正是需要被新链路补充/修正的部分。对应行为清单behaviors 17Claude Code 模型送达、20Default model 时不注入任何覆盖。七、改造方案五Cloud/Remote 路径下写入 Codex 的config.toml7.1 写入规则app/src/ai/agent_sdk/driver/harness/codex.rs的prepare_codex_config_toml()L815新增模型处理在set_codex_openai_base_url()之后——若model_id为Some(id)且 id 非空、且不等于default写入doc[model] toml_edit::value(id)否则None、空串或字面量default执行doc.remove(model)清除任何既有键。对应常量CODEX_MODEL_KEY: str modelL580。set_codex_model()的过滤条件!id.is_empty() *id ! default与set_codex_model_reasoning_effort()的reasoning_level处理一同构成完整的模型写入逻辑。7.2 附带逻辑模型迁移条目与启动提示抑制set_codex_model()在写入model键后还会调用set_codex_model_migration()L924——Codex 的 TUI 会在会话启动时提示用户升级旧模型即使model键已被固定。通过在[notice.model_migrations]表中按所选模型 ID 盖章迁移条目将迁移目标映射到自身如gpt-5.4 gpt-5.4可抑制该提示。规格注释特别说明客户端不维护模型版本清单因此无需随 Anthropic/OpenAI 淘汰模型而发布客户端更新。7.3 测试证据codex_tests.rs中已有与新行为完全对应的测试用例prepare_codex_config_toml_writes_model_when_specified非 default 模型 ID 写入顶层model键并断言notice.model_migrations中的自映射条目prepare_codex_config_toml_writes_model_migration_for_older_model旧模型同样写入并盖章迁移条目prepare_codex_config_toml_skips_model_for_default_sentinel字面量default哨兵表示“让 Codex 自选默认模型”不得写入model键或任何迁移条目prepare_codex_config_toml_skips_model_when_none未提供模型 ID 时不写入model键或[notice.model_migrations]条目prepare_codex_config_toml_writes_model_reasoning_effort_when_specified与..._removes_stale_model_reasoning_effort_when_nonemodel_reasoning_effort的写入与清理。规格还要求更新codex_tests.rs:201附近的既有测试——该测试原用于验证预先存在的model键会被保留需改为验证新的写/删行为同时所有用例都必须保证既有的非模型键openai_base_url、projects、mcp_servers在任何情况下都被保留。7.4 调用链codex.rs中build_runner()调用prepare_codex_environment_config()时需透传model_idlocal_harness_launch.rs无需改动——本地 Codex 子进程不调用该函数、也不接收模型覆盖。对应行为清单behavior 18Cloud 模式写入 /default不写 / Local 模式不写。八、改造方案六远程启动路径无需改动远程启动路径已通过StartAgentExecutionMode::Remote { model_id }run_agents_to_start_agent_mode()将model_id传给服务端。当 UI 开始存储 harness 原生 ID或 Default model 对应的空字符串后服务端无需任何翻译即可收到正确值。Claude Code 远程 Agent 的模型由服务端注入对应ANTHROPIC_MODELCodex 远程 Agent 的模型在云端环境内的~/.codex/config.toml写入云端文件系统隔离因此写入安全。对应行为清单behaviors 17remote、18remote。九、测试与验证策略9.1 单元测试计划orchestration_controls 新增测试harness 选择器从HarnessAvailabilityModel填充禁用 harness 可见但不可选behaviors 1–4populate_model_picker_for_harnessharnessclaude顶部 Default model其后为HarnessAvailabilityModel中的模型behavior 7harnesscodexcloud 模式顶部 Default model其后为 Codex 模型behavior 8harnesscodexlocal 模式仅 Default modelbehavior 8harnessoz维持 Warp LLM 目录behavior 6is_model_in_filtered_choices非 Oz harness 时 Warp ID 返回 false、空字符串返回 truebehavior 12first_filtered_model_id非 Oz harness 返回空字符串behavior 11harness 从 Claudemodelopus切到 Oz模型重置为第一个 Warp LLMbehavior 12。local_harness_launch 新增测试harness 为 Claude 且提供 model_id 时ANTHROPIC_MODEL合并进 env_varsbehavior 17model_id 为 None 或空时不设置ANTHROPIC_MODELbehavior 20。codex_tests.rs 更新测试如 7.3 节所列覆盖写键、default删除、None删除与既有键保留behaviors 18、20。orchestration_config_tests既有测试必须继续通过behavior 21——matches_active_config对 harness 专属 model_id 与 Warp model_id 一视同仁按请求 model_id 与配置 model_id 的精确字符串匹配决定是否自动启动。9.2 预提交检查规格要求 PR 前运行cargo fmt、cargo clippy与./script/presubmit。9.3 手工验证清单打开 plan card 上的编排配置 → harness 选择器展示 Oz、Claude Code、Codex服务端若返回 Gemini 也会出现可能处于禁用态选中 Claude Code → 模型选择器顶部为 Default model其后为best、opus、sonnet等选中 CodexCloud 模式→ 顶部 Default model其后为default、GPT-5.5、GPT-5.4等选中 CodexLocal 模式→ 仅 Default model选中 Codex 后将执行模式从 Local 切到 Cloud → 模型选择器补全为完整 Codex 目录选中 Oz → 模型选择器回到 Warp LLM 目录将 harness 从 Claude选中 opus切到 Oz → 模型重置本地启动 Claude Code opus → 子进程环境中存在ANTHROPIC_MODELopus本地启动 Claude Code Default model → 子进程环境中无ANTHROPIC_MODEL云端启动 Codex gpt-5.4 → 云环境内~/.codex/config.toml中存在model gpt-5.4云端启动 Codex default →~/.codex/config.toml中无model键。十、并行化建议不推荐并行规格文档明确建议不进行并行化各改动间耦合紧密——harness 选择器改造一与模型选择器改造二在orchestration_controls.rs中共享状态卡片视图的订阅改造三同时依赖两个选择器启动侧改动四、五又依赖从选择器流出的 model_id 格式正确。总范围约 7 个文件、每处中等规模改动非常适合由单个 Agent 顺序执行。附相关源码路径速查关注点文件共享选择器逻辑orchestration_controls.rsplan card 视图orchestration_config_block.rsrun_agents 确认卡run_agents_card_view.rsHarness 可用性与模型数据harness_availability.rsHarness 展示元数据harness_display.rs模型环境变量注入harness/mod.rs本地 harness 子进程启动local_harness_launch.rs本地子进程调用点terminal_pane.rsCodex config.toml 写入codex.rsCodex 配置测试codex_tests.rs产品行为规格PRODUCT.md赞分享桌面应用开发者工具人工智能AI 应用AI Agent代码智能体【免费下载链接】warpWarp is an agentic development environment, born out of the terminal.项目地址https://gitcode.com/GitHub_Trending/wa/warp点击查看免费下载相关推荐HCCL 环境变量 HCCL_INTRA_PCIE_ENABLE 详解Server 内 PCIe 通信链路的选择与配置HCCL 环境变量 HCCL_INTRA_PCIE_ENABLE 详解Server 内 PCIe 通信链路的选择与配置 本篇技术指南聚焦 CANN/HCCL通信高性能计算人工智能AscendCANNCAI 环境变量完全参考从模型选择到 CTF、记忆与安全护栏的配置实战CAI 环境变量完全参考从模型选择到 CTF、记忆与安全护栏的配置实战 CAICybersecurity AI以环境变量作为核心配置入口本指南基于 do人工智能AI Agent网络安全渗透测试工具调用AI 评测Wolverine环境变量配置详解OPENAI_API_KEY与模型选择终极指南Wolverine环境变量配置详解OPENAI_API_KEY与模型选择终极指南 想要让你的Python脚本拥有自我修复能力吗Wolverine正是这样一个AI 应用开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考