用途:在 Warp GUI 桌面客户端中创建一次性启动弹窗(launch modal),用于功能发布公告、新手引导等场景,如 "Orchestrate any agent, anywhere" 或 "Warp is now open-source" 那类公告。
适用范围:仅限 GUI 桌面前端(app/ crate,基于 WarpUI pixel/GPU 框架),不适用于无头 TUI 前端(crates/warp_tui)。TUI 相关工作应改用 tui-ui-guidelines、tui-testing、tui-verify-change 技能。
参考实现:app/src/workspace/view/orchestration_launch_modal/ 是该模式最权威、最新的示例。
主要步骤:在 warp_features/src/lib.rs 添加功能开关;在 app/src/settings/ai.rs 添加设置字段;在 app/src/workspace/one_time_modal_model.rs 添加触发逻辑;在 app/src/workspace/view/<name>_launch_modal/ 添加视图文件;在 app/src/workspace/view.rs 与 mod.rs 做工作区接线;在 app/src/workspace/action.rs 添加调试动作;主图放 app/assets/async/png/onboarding/<name>_launch_banner.png;自定义图标加到 crates/warp_core/src/ui/icons.rs 并在 app/assets/bundled/svg/ 提供 SVG。
关键细节:新用户需在 AuthComplete 的 !is_existing_user 分支预先标记为已关闭,否则会在引导后第二次启动时看到弹窗;颜色优先使用 Warp 主题 token,终端色强调用 terminal_colors(),避免硬编码 hex;主图宽高比大于 MODAL_WIDTH/HERO_HEIGHT(420/92)时需用 Clipped::new 包裹,防止横向溢出;URL 一律用 https://;弹窗触发受功能开关、全局同步设置与 Channel::Integration 检查控制,同一用户跨设备只显示一次。
限制:官方资料未提供价格、收费或效果数据;具体实现需参照上述参考实现与检查清单。