所有设置参考

此页面列出了您可以在 settings.toml 中配置的所有设置，并按 TOML 部分进行了组织。有关设置文件的介绍、如何打开它以及常见的配置示例，请参阅 设置文件。

设置被分组为与 TOML 表头相对应的部分（例如 [appearance.text]）。只需包含您想要更改的设置即可 — Warp 会对所有其他设置使用内置默认值。

常规

顶层设置，用于控制 Warp 的启动行为、会话管理和窗口级偏好设置。

部分: [general]

• default_session_mode — 新终端会话的默认模式。类型：字符串。默认值："terminal"。选项："terminal"、"agent"、"cloud_agent"、"tab_config"、"docker_sandbox"。
• default_tab_config_path — 当 default_session_mode 为 "tab_config" 时使用的标签页配置路径。类型：字符串。默认值：""。
• link_tooltip — 悬停在链接上时是否显示工具提示。类型：布尔值。默认值：true。
• login_item — 登录时是否自动启动 Warp。类型：布尔值。默认值：true。
• mouse_scroll_multiplier — 鼠标滚动事件的滚动速度乘数。类型：数字。默认值：3.0。
• new_tab_placement — 新标签页在标签栏中的位置。类型：字符串。默认值："after_current_tab"。选项："after_current_tab"、"after_all_tabs"。
• quit_on_last_window_closed — 关闭最后一个窗口时是否退出 Warp。类型：布尔值。默认值：false。
• restore_session — Warp 启动时是否恢复上一个会话。类型：布尔值。默认值：true。
• should_confirm_close_session — 关闭会话时是否显示确认对话框。类型：布尔值。默认值：true。
• show_changelog_after_update — 更新后是否显示更新日志。类型：布尔值。默认值：true。
• show_warning_before_quitting — 在退出 Warp 前是否显示警告对话框。类型：布尔值。默认值：true。
• snackbar_enabled — 是否显示 snackbar 通知。类型：布尔值。默认值：true。
• user_native_preference — 是否偏好原生桌面应用程序或 Web 应用程序。类型：字符串。默认值："not_selected"。选项："not_selected"、"web"、"desktop"。

撤销关闭

部分: [general.undo_close]

• enabled — 是否启用撤销关闭功能。类型：布尔值。默认值：true。
• grace_period — 关闭标签页后可以撤销关闭的时长（秒）。类型：整数。默认值：60。

外观

可视化设置，控制 Warp 的外观，包括主题、字体、光标、标签页、窗口和布局。

部分: [appearance]

• spacing — 控制终端块之间的间距。类型：字符串。默认值："normal"。选项："normal"、"compact"。

主题

部分: [appearance.themes]

• theme — 颜色主题。类型：字符串。默认值："dark"。选项："adeberry"、"phenomenon"、"dark"、"dracula"、"fancy_dracula"、"cyber_wave"、"solar_flare"、"solarized_dark"、"willow_dream"、"light"、"dark_city"、"gruvbox_dark"、"red_rock"、"jelly_fish"、"leafy"、"koi"、"solarized_light"、"snowy"、"gruvbox_light"、"pink_city"、"marble" 或自定义主题对象。
• system_theme — 是否匹配系统浅色/深色主题。类型：布尔值。默认值：false。
• selected_system_themes — 系统浅色和深色模式使用的主题。类型：对象。默认值：{ dark = "dark", light = "light" }。

要使用自定义主题

[appearance.themes]
theme = { custom = { name = "My Theme", path = "~/.warp/themes/my-theme.yaml" } }

文本

部分: [appearance.text]

• font_name — 终端中使用的等宽字体。类型：字符串。默认值："Hack"。
• font_size — 终端中等宽字体的大小。类型：数字。默认值：13.0。
• font_weight — 等宽字体的字重。类型：字符串。默认值："normal"。选项："thin"、"extra_light"、"light"、"normal"、"medium"、"semibold"、"bold"、"extra_bold"、"black"。
• line_height_ratio — 终端文本的行高比。类型：数字。默认值：1.2。
• ligature_rendering_enabled — 是否在终端中渲染字体连字。类型：布尔值。默认值：false。
• ai_font_name — 用于 AI 生成内容的字体。类型：字符串。默认值："Hack"。
• match_ai_font — AI 字体是否自动匹配终端字体。类型：布尔值。默认值：false。
• notebook_font_size — 笔记本中使用的字体大小。类型：数字。默认值：14.0。
• match_notebook_to_monospace_font_size — 笔记本字体大小是否与终端字体大小匹配。类型：布尔值。默认值：true。
• use_thin_strokes — 是否在 macOS 上使用细字体笔触。类型：字符串。默认值："on_high_dpi_displays"。选项："never"、"on_low_dpi_displays"、"on_high_dpi_displays"、"always"。
• enforce_minimum_contrast — 是否强制执行文本可读性的最小对比度。类型：字符串。默认值："only_named_colors"。选项："never"、"only_named_colors"、"always"。

光标

部分: [appearance.cursor]

• cursor_display_type — 光标的视觉样式。类型：字符串。默认值："bar"。选项："bar"、"block"、"underline"。
• cursor_blink — 光标是否闪烁。类型：字符串。默认值："enabled"。选项："enabled"、"disabled"。

块 (Blocks)

部分: [appearance.blocks]

• show_block_dividers — 是否在终端块之间显示分隔线。类型：布尔值。默认值：true。
• show_jump_to_bottom_of_block_button — 在长命令输出中是否显示跳转到底部按钮。类型：布尔值。默认值：true。
• should_show_bootstrap_block — 终端中是否显示引导块。类型：布尔值。默认值：false。
• should_show_in_band_command_blocks — 是否显示带内命令块。类型：布尔值。默认值：false。
• should_show_ssh_block — 是否显示 SSH 连接块。类型：布尔值。默认值：false。

标签页

部分: [appearance.tabs]

• workspace_decoration_visibility — 工作区装饰（例如标签栏）何时可见。类型：字符串。默认值："hide_fullscreen"。选项："always_show"、"hide_fullscreen"、"on_hover"。
• tab_close_button_position — 标签页关闭按钮的位置。类型：字符串。默认值："right"。选项："right"、"left"。
• show_indicators_button — 是否在标签页上显示活动指示器。类型：布尔值。默认值：true。
• preserve_active_tab_color — 切换标签页时是否保留活动标签页的颜色。类型：布尔值。默认值：false。
• header_toolbar_chip_selection — 垂直标签面板标题中标题工具栏芯片的配置。类型：字符串或对象。默认值："default"。

垂直标签页

部分: [appearance.vertical_tabs]

• enabled — 是否垂直而不是水平显示标签页。类型：布尔值。默认值：false。
• view_mode — 垂直标签栏的显示模式。类型：字符串。默认值："compact"。选项："compact"、"expanded"。
• primary_info — 垂直标签页上显示的主要信息。类型：字符串。默认值："command"。选项："command"、"working_directory"、"branch"。
• compact_subtitle — 紧凑垂直标签页上显示的副标题。类型：字符串。默认值："branch"。选项："branch"、"working_directory"、"command"。
• display_granularity — 垂直标签面板中显示的行粒度。类型：字符串。默认值："panes"。选项："panes"、"tabs"。
• tab_item_mode — 垂直标签页中的标签项显示模式。类型：字符串。默认值："focused_session"。选项："focused_session"、"summary"。
• show_details_on_hover — 悬停在垂直标签页上时是否显示详细信息侧边栏。类型：布尔值。默认值：true。
• show_diff_stats — 是否在垂直标签页上显示差异统计信息。类型：布尔值。默认值：true。
• show_pr_link — 是否在垂直标签页上显示 PR 链接。类型：布尔值。默认值：true。
• use_latest_prompt_as_title — 代理对话的垂直标签页名称是否使用最新的用户提示。类型：布尔值。默认值：false。

窗格

部分: [appearance.panes]

• focus_pane_on_hover — 悬停时是否聚焦窗格。类型：布尔值。默认值：false。
• should_dim_inactive_panes — 不活动的窗格是否会被视觉调暗。类型：布尔值。默认值：false。

输入位置

部分: [appearance.input]

• input_mode — 终端输入的位置。类型：字符串。默认值："pinned_to_bottom"。选项："pinned_to_bottom"、"pinned_to_top"、"waterfall"。

全屏应用

部分: [appearance.full_screen_apps]

• alt_screen_padding — 控制全屏终端应用程序周围的填充。类型：字符串或对象。默认值：{ custom = { uniform_padding = 0.0 } }。

图标

部分: [appearance.icon]

• app_icon — 停靠栏中显示的应用程序图标。类型：字符串。默认值："default"。选项："default"、"aurora"、"classic1"、"classic2"、"classic3"、"comets"、"cow"、"glass_sky"、"glitch"、"glow"、"holographic"、"mono"、"neon"、"original"、"starburst"、"sticker"、"warp_one"。

窗口

部分: [appearance.window]

• override_opacity — 窗口背景的不透明度，从 1 到 100%。类型：整数。默认值：100。
• override_blur — 应用于窗口背景的模糊半径。类型：整数。默认值：1。
• override_blur_texture — 是否对窗口背景应用模糊纹理。类型：布尔值。默认值：false。
• zoom_level — 窗口的缩放级别（百分比）。类型：整数。默认值：100。
• open_windows_at_custom_size — 是否以自定义大小而不是默认大小打开新窗口。类型：布尔值。默认值：false。
• new_windows_num_columns — 使用自定义大小时新窗口的列数。类型：整数。默认值：80。
• new_windows_num_rows — 使用自定义大小时新窗口的行数。类型：整数。默认值：40。
• left_panel_visibility_across_tabs — 左侧面板的可见性是否在所有标签页之间共享。类型：布尔值。默认值：true。

终端

用于控制终端行为、输入和事件处理的设置。

章节: [terminal]

• copy_on_select — 文本被选中时是否自动复制到剪贴板。类型：布尔值。默认值：true。
• focus_reporting_enabled — 是否将焦点和失去焦点事件转发给全屏终端应用程序。类型：布尔值。默认值：true。
• mouse_reporting_enabled — 是否将鼠标事件转发给全屏终端应用程序。类型：布尔值。默认值：true。
• scroll_reporting_enabled — 是否将滚动事件转发给全屏终端应用程序。类型：布尔值。默认值：true。
• maximum_grid_size — 终端网格中的最大行数。类型：整数。默认值：50000。
• use_audible_bell — 发生终端铃声事件时是否播放声音。类型：布尔值。默认值：false。
• show_terminal_zero_state_block — 是否在新终端会话中显示 AI 初始状态块。类型：布尔值。默认值：true。

输入

章节: [terminal.input]

• syntax_highlighting — 终端输入中是否启用语法高亮。类型：布尔值。默认值：true。
• honor_ps1 — 是否使用你 shell 的 PS1 提示符而不是 Warp 提示符。类型：布尔值。默认值：false。
• input_box_type_setting — 终端输入样式。类型：字符串。默认值："classic"。选项："universal"（AI 优先输入），"classic"（终端优先输入）。
• alias_expansion_enabled — 输入中是否启用 shell 别名展开。类型：布尔值。默认值：false。
• command_corrections — 是否针对输错的命令提供命令纠正建议。类型：布尔值。默认值：true。
• error_underlining_enabled — 是否在输入中为命令错误添加下划线。类型：布尔值。默认值：true。
• completions_open_while_typing — 输入时补全菜单是否自动打开。类型：布尔值。默认值：false。
• classic_completions_mode — 是否启用经典补全模式。类型：布尔值。默认值：false。
• show_hint_text — 终端输入中是否显示提示文本。类型：布尔值。默认值：true。
• show_terminal_input_message_bar — 是否显示终端输入消息栏。类型：布尔值。默认值：true。
• enable_slash_commands_in_terminal — 终端输入中是否可以使用斜杠命令。类型：布尔值。默认值：true。
• at_context_menu_in_terminal_mode — 终端模式下是否可以使用 @ 上下文菜单。类型：布尔值。默认值：true。
• outline_codebase_symbols_for_at_context_menu — @ 上下文菜单中是否显示代码库符号。类型：布尔值。默认值：true。
• middle_click_paste_enabled — 中键点击是否从剪贴板粘贴。类型：布尔值。默认值：true。
• extra_meta_keys — 控制哪些额外按键被视为元键（meta keys）。类型：对象。默认值：{ left_alt = false, right_alt = false }。

自动建议

章节: [terminal.input.autosuggestions]

• enabled — 是否显示命令自动建议。类型：布尔值。默认值：true。
• keybinding_hint — 是否显示自动建议的快捷键提示。类型：布尔值。默认值：true。
• show_ignore_button — 自动建议是否显示忽略按钮。类型：布尔值。默认值：false。

智能选择

章节: [terminal.smart_select]

• enabled — 是否针对 URL、电子邮件、文件路径和标识符启用双击智能选择。类型：布尔值。默认值：true。
• word_char_allowlist — 当禁用智能选择时，双击选择被视为单词一部分的字符。类型：字符串。默认值："-.~/\"。

会话

用于控制新会话的 shell 选择和工作目录行为的设置。

章节: [session]

• startup_shell_override — Warp 启动时使用的 shell。类型：字符串或 null。默认值：null（使用系统默认值）。
• new_session_shell_override — 打开新会话时使用的 shell。类型：字符串、对象或 null。默认值：null（使用系统默认值）。选项："system_default"，{ executable = "/path/to/shell" }，{ custom = "command" }。

工作目录配置

章节: [session.working_directory_config]

• advanced_mode — 是否针对不同的会话源使用单独的设置。类型：布尔值。默认值：false。

当 advanced_mode 为 false 时，[session.working_directory_config.global] 表适用于所有会话源。当为 true 时，你可以独立配置每个源。

章节: [session.working_directory_config.global]（以及 .split_pane, .new_tab, .new_window）

• mode — 如何确定工作目录。类型：字符串。默认值："previous_dir"。选项："home_dir", "previous_dir", "custom_dir"。
• custom_dir — 自定义目录路径，在 mode 为 "custom_dir" 时使用。类型：字符串。默认值：""。

# Use a specific directory for split panes, previous directory for everything else
[session.working_directory_config]
advanced_mode = true

[session.working_directory_config.global]
mode = "previous_dir"
custom_dir = ""

[session.working_directory_config.split_pane]
mode = "custom_dir"
custom_dir = "~/projects"

[session.working_directory_config.new_tab]
mode = "previous_dir"
custom_dir = ""

[session.working_directory_config.new_window]
mode = "home_dir"
custom_dir = ""

智能体

Warp 代理的设置，包括模型行为、权限、知识、MCP 服务器和语音输入。

章节: [agents]

• cloud_conversation_storage_enabled — 对话是否存储在云端。类型：布尔值。默认值：true。

知识库

章节: [agents.knowledge]

• rules_enabled — 代理在请求期间是否使用你保存的规则。类型：布尔值。默认值：true。
• warp_drive_context_enabled — AI 请求中是否包含 Warp Drive 上下文。类型：布尔值。默认值：true。

MCP 服务器

章节: [agents.mcp_servers]

• file_based_mcp_enabled — 是否自动启动来自第三方代理的全局基于文件的 MCP 服务器。Warp 管理的全局 MCP 服务器无论此设置如何都会自动启动，项目范围的服务器必须手动启动。类型：布尔值。默认值：false。

配置文件（权限）

章节: [agents.profiles]

• agent_mode_coding_permissions — 代理的文件读取权限级别。类型：字符串。默认值："always_ask_before_reading"。选项："always_ask_before_reading", "always_allow_reading", "allow_reading_specific_files"。
• agent_mode_coding_file_read_allowlist — 代理无需询问权限即可读取的文件路径。类型：字符串数组。默认值：[]。
• agent_mode_execute_readonly_commands — 代理是否可以在不询问的情况下自动执行只读命令。类型：布尔值。默认值：false。
• agent_mode_command_execution_allowlist — 代理无需明确许可即可执行的命令（正则表达式模式）。类型：字符串数组。默认值：["cat(\\s.*)?", "echo(\\s.*)?", "find .*", "grep(\\s.*)?", "ls(\\s.*)?", "which .*"]。
• agent_mode_command_execution_denylist — 代理在执行前必须始终询问的命令（正则表达式模式）。类型：字符串数组。默认值：["bash(\\s.*)?", "fish(\\s.*)?", "pwsh(\\s.*)?", "sh(\\s.*)?", "zsh(\\s.*)?", "curl(\\s.*)?", "eval(\\s.*)?", "exec(\\s.*)?", "source(\\s.*)?", "wget(\\s.*)?", "dig(\\s.*)?", "nslookup(\\s.*)?", "host(\\s.*)?", "ssh(\\s.*)?", "scp(\\s.*)?", "rsync(\\s.*)?", "telnet(\\s.*)?", "rm(\\s.*)?"]。

Warp Agent（AI 功能）

章节: [agents.warp_agent]

• is_any_ai_enabled — 控制是否启用所有 AI 功能。类型：布尔值。默认值：true。

主动 AI

章节: [agents.warp_agent.active_ai]

• enabled — 控制是否启用诸如建议等主动 AI 功能。类型：布尔值。默认值：true。
• code_suggestions_enabled — 控制是否启用 AI 代码建议。类型：布尔值。默认值：true。
• intelligent_autosuggestions_enabled — 控制是否启用 AI 驱动的智能自动建议。类型：布尔值。默认值：true。
• agent_mode_query_suggestions_enabled — 控制是否在代理模式下显示提示建议。类型：布尔值。默认值：true。
• shared_block_title_generation_enabled — 控制共享块时是否自动生成标题。类型：布尔值。默认值：true。

输入

章节: [agents.warp_agent.input]

• ai_auto_detection_enabled — 控制 AI 是否自动检测自然语言输入。类型：布尔值。默认值：true。
• ai_command_denylist — 从 AI 自然语言自动检测中排除的命令。类型：字符串。默认值：""。
• nld_in_terminal_enabled — 控制终端输入中是否启用自然语言检测。类型：布尔值。默认值：false。
• show_model_selectors_in_prompt — 是否在输入提示符中显示 AI 模型选择器。类型：布尔值。默认值：true。
• show_agent_tips — 是否在输入中显示代理提示。类型：布尔值。默认值：true。
• include_agent_commands_in_history — 代理执行的命令是否包含在命令历史记录中。类型：布尔值。默认值：false。
• agent_toolbar_chip_selection_setting — 控制代理模式工具栏中上下文小部件的布局。类型：字符串或对象。默认值："default"。

其他

章节: [agents.warp_agent.other]

• thinking_display_mode — 控制代理思考痕迹在流式传输后的显示方式。类型：字符串。默认值："show_and_collapse"。选项："show_and_collapse", "always_show", "never_show"。
• open_conversation_layout_preference — 是否在新标签页或分割窗格中打开代理对话。类型：字符串。默认值："new_tab"。选项："new_tab", "split_pane"。
• show_conversation_history — 对话历史记录是否出现在工具面板中。类型：布尔值。默认值：true。
• show_agent_notifications — 是否显示代理通知。类型：布尔值。默认值：true。
• should_show_oz_updates_in_zero_state — 是否在代理视图中显示“最新动态”部分。类型：布尔值。默认值：true。
• should_render_use_agent_toolbar_for_user_commands — 是否为终端命令显示“使用代理”页脚。类型：布尔值。默认值：true。
• cloud_agent_computer_use_enabled — 云代理对话是否启用计算机使用功能。类型：布尔值。默认值：false。

代码审查自动生成

控制代码审查对话框中 AI 驱动的自动生成。此设置目前位于 [agents.oz.active_ai] 下，而不是与其他 [agents.warp_agent.active_ai] 设置放在一起。

章节: [agents.oz.active_ai]

• git_operations_autogen_enabled — 控制 AI 是否在代码审查对话框中自动生成提交消息以及 PR 标题和正文。类型：布尔值。默认值：true。

第三方（CLI 代理）

章节: [agents.third_party]

• should_render_cli_agent_toolbar — 是否为编码代理命令显示 CLI 代理页脚。类型：布尔值。默认值：true。
• auto_toggle_composer — CLI 代理的富文本输入（Rich Input）是否根据代理的阻塞状态自动关闭和重新打开。类型：布尔值。默认值：true。
• auto_open_composer_on_cli_agent_start — CLI 代理会话开始时，CLI 代理的富文本输入是否自动打开。类型：布尔值。默认值：false。
• auto_dismiss_composer_after_submit — 用户提交提示后，CLI 代理的富文本输入是否自动关闭。类型：布尔值。默认值：false。
• cli_agent_toolbar_chip_selection_setting — 控制 CLI 代理工具栏中上下文小部件的布局。类型：字符串或对象。默认值："default"。
• cli_agent_toolbar_enabled_commands — 将自定义工具栏命令模式映射到特定的 CLI 代理。类型：对象。默认值：{}。

语音

章节: [agents.voice]

• voice_input_enabled — 控制 AI 交互是否启用语音输入。类型：布尔值。默认值：true。
• voice_input_toggle_key — 用于切换语音输入的键。类型：字符串。默认值："none"。选项："none", "fn", "alt_left", "alt_right", "control_left", "control_right", "super_left", "super_right", "shift_left", "shift_right"。

代码

Warp 内置代码编辑器、文件处理和代码库索引的设置。

章节: [code]

编辑器

章节: [code.editor]

• open_file_editor — 用于打开文件的编辑器。类型：字符串或对象。默认值："system_default"。选项："system_default", "warp", "env_editor"，或诸如 { external_editor = "v_s_code" } 的外部编辑器对象。支持的外部编辑器：VS Code (v_s_code), VS Code Insiders (v_s_code_insiders), PyCharm (py_charm), IntelliJ IDEA (intelli_j), CLion (c_lion), RustRover (rust_rover), Sublime Text 4 (sublime4), Zed (zed), Cursor (cursor), Windsurf (windsurf) 等。
• open_code_panels_file_editor — 用于从代码面板打开文件的编辑器。类型：字符串或对象。默认值："warp"。
• open_file_layout — 在编辑器中打开文件时使用的布局。类型：字符串。默认值："split_pane"。选项："split_pane", "new_tab"。
• prefer_markdown_viewer — 打开 Markdown 文件时是否使用 Markdown 查看器。类型：布尔值。默认值：true。
• prefer_tabbed_editor_view — 是否优先以标签页编辑器视图打开文件。类型：布尔值。默认值：true。
• show_code_review_button — 是否在标签页上显示代码审查按钮。类型：布尔值。默认值：true。
• auto_open_code_review_pane_on_first_agent_change — 当代理进行首次更改时，是否自动打开代码审查窗格。类型：布尔值。默认值：false。
• show_code_review_diff_stats — 是否在代码审查按钮上显示添加/删除行数。类型：布尔值。默认值：true。
• show_project_explorer — 工具面板中是否显示项目资源管理器。类型：布尔值。默认值：true。
• show_global_search — 工具面板中是否显示全局文件搜索。类型：布尔值。默认值：true。
• use_warp_as_default_editor — Warp 是否用作默认代码编辑器。类型：布尔值。默认值：false。

索引

章节: [code.indexing]

• agent_mode_codebase_context — 是否向代理提供代码库上下文。类型：布尔值。默认值：true。
• agent_mode_codebase_context_auto_indexing — 是否启用自动代码库索引。类型：布尔值。默认值：false。

键位

键盘行为设置。

章节: [keys]

• ctrl_tab_behavior_setting — 控制 Ctrl+Tab 的行为。类型：字符串。默认值："activate_prev_next_tab"。选项："activate_prev_next_tab", "cycle_most_recent_session"。

通知

用于控制桌面通知行为的设置。

章节: [notifications]

• toast_duration_secs — 通知弹窗显示的持续时间（秒）。类型：整数。默认值：8。

偏好设置

章节: [notifications.preferences]

• mode — 通知是否启用、禁用或尚未配置。类型：字符串。默认值："unset"。选项："unset", "dismissed", "enabled", "disabled"。
• is_long_running_enabled — 长时间运行的命令完成后是否通知。类型：布尔值。默认值：true。
• long_running_threshold — 长时间运行命令通知的阈值（秒）。类型：整数。默认值：30。
• is_agent_task_completed_enabled — 代理任务完成后是否通知。类型：布尔值。默认值：true。
• is_needs_attention_enabled — 当会话需要关注时是否通知。类型：布尔值。默认值：true。
• is_password_prompt_enabled — 检测到密码提示时是否通知。类型：布尔值。默认值：true。
• play_notification_sound — 通知是否播放声音。类型：布尔值。默认值：true。

隐私

用于控制遥测、崩溃报告和机密屏蔽的设置。

章节: [privacy]

• telemetry_enabled — 是否收集匿名使用遥测数据。类型：布尔值。默认值：true。
• crash_reporting_enabled — 是否发送崩溃报告。类型：布尔值。默认值：true。
• custom_secret_regex_list — 用于检测和屏蔽机密的自定义正则表达式模式。类型：对象数组。默认值：[]。

custom_secret_regex_list 中的每个项目格式为

[[privacy.custom_secret_regex_list]]
pattern = "sk-[A-Za-z0-9]{48}"
name = "OpenAI API key"

敏感信息屏蔽

章节: [privacy.secret_redaction]

• enabled — 是否启用机密屏蔽以检测并遮蔽终端输出中的机密信息。类型：布尔值。默认值：false。
• hide_secrets_in_block_list — 是否在块列表中使用星号隐藏检测到的机密信息。类型：布尔值。默认值：false。
• secret_display_mode_setting — 控制检测到的机密信息的视觉显示方式。类型：字符串。默认值："strikethrough"。选项："asterisks", "strikethrough", "always_show"。

系统

底层系统和渲染设置。

章节: [system]

• prefer_low_power_gpu — 是否优先使用集成（低功耗）GPU。类型：布尔值。默认值：false。
• preferred_graphics_backend — 首选图形后端（Windows）。类型：字符串或 null。默认值：null。选项："dx12", "vulkan", "gl", "metal", null。
• linux_selection_clipboard — 是否使用 Linux 主选择剪贴板。类型：布尔值。默认值：true。

文本编辑

用于控制输入编辑器中文本编辑行为的设置。

章节: [text_editing]

• vim_mode_enabled — 是否启用 Vim 快捷键。类型：布尔值。默认值：false。
• vim_status_bar — 是否显示 Vim 状态栏。类型：布尔值。默认值：true。
• vim_unnamed_system_clipboard — Vim 的未命名寄存器是否使用系统剪贴板。类型：布尔值。默认值：false。
• autocomplete_symbols — 是否自动补全匹配的符号（如括号和引号）。类型：布尔值。默认值：true。

Warp Drive

Warp Drive（共享工作流、笔记本和提示词）的设置。

章节: [warp_drive]

• enabled — 是否启用 Warp Drive。类型：布尔值。默认值：true。
• sorting_choice — Warp Drive 中项目的排序顺序。类型：字符串。默认值："by_object_type"。选项："by_timestamp", "alphabetical_descending", "alphabetical_ascending", "by_object_type"。

Warpify

SSH 会话和子 shell 中 Warp 功能的设置。

SSH

章节: [warpify.ssh]

• enable_ssh_warpification — 是否在 SSH 会话中启用 Warp 功能。类型：布尔值。默认值：true。
• enable_legacy_ssh_wrapper — SSH 会话是否启用旧版 SSH 封装器。类型：布尔值。默认值：true。
• use_ssh_tmux_wrapper — 是否使用基于 tmux 的封装器进行 SSH Warp 化。类型：布尔值。默认值：false。
• ssh_extension_install_mode — 控制 SSH 扩展安装行为。类型：字符串。默认值："always_ask"。选项："always_ask"（安装前始终提示），"always_install"（自动安装并连接，不提示），"never_install"（回退到旧版 Warp 化）。
• ssh_hosts_denylist — 不应触发 Warp 化提示的 SSH 主机。类型：字符串数组。默认值：[]。

子 shell

章节: [warpify.subshells]

• added_subshell_commands — 应被识别为子 shell 的命令的额外正则表达式模式。类型：字符串数组。默认值：[]。
• subshell_commands_denylist — 不应触发子 shell Warp 化提示的命令。类型：字符串数组。默认值：[]。

工作流

工作流行为的设置。

章节: [workflows]

• show_global_workflows_in_universal_search — 是否在通用搜索结果中显示全局工作流。类型：布尔值。默认值：false。

辅助功能

屏幕阅读器支持的设置。

章节: [accessibility]

• accessibility_verbosity — 屏幕阅读器播报的详细程度。类型：字符串。默认值："verbose"。选项："verbose"（包含帮助字符串），"concise"（仅数值）。

账户

与你的 Warp 账户相关的设置。

章节: [account]

• is_settings_sync_enabled — 设置是否通过云端在不同设备间同步。类型：布尔值。默认值：false。

云平台

第三方 API 密钥集成和云模型配置的设置。

第三方 API 密钥

章节: [cloud_platform.third_party_api_keys]

• aws_bedrock_credentials_enabled — Warp 是否应使用你的本地 AWS 凭证进行 Bedrock 启用请求。类型：布尔值。默认值：false。
• aws_bedrock_profile — 用于 Bedrock 凭证的 AWS 配置文件名称。类型：字符串。默认值："default"。
• aws_bedrock_auto_login — Bedrock 凭证过期时是否自动运行 AWS 登录命令。类型：布尔值。默认值：false。
• aws_bedrock_auth_refresh_command — 用于刷新 Bedrock 的 AWS 凭证而运行的命令。类型：字符串。默认值："aws login"。
• can_use_warp_credits_with_byok — 提供自己的 API 密钥时是否仍可使用 Warp 额度。类型：布尔值。默认值：false。

全局热键

全局激活快捷键和专用快捷键窗口（Quake 模式）的设置。

切换所有窗口

章节: [global_hotkey.toggle_all_windows]

• enabled — 切换所有窗口可见性的快捷键是否启用。与 global_hotkey.dedicated_window.enabled 互斥。类型：布尔值。默认值：false。
• keybinding — 全局激活快捷键的按键绑定。格式：修饰键和按键以 - 连接，例如 "cmd-shift-a" 或 "alt-enter"。类型：字符串或 null。默认值：null。

专用窗口（雷神模式）

章节: [global_hotkey.dedicated_window]

• enabled — 是否启用专用快捷键窗口。与 global_hotkey.toggle_all_windows.enabled 互斥。类型：布尔值。默认值：false。

章节: [global_hotkey.dedicated_window.settings]

• active_pin_position — 快捷键窗口固定的屏幕边缘。类型：字符串。选项："top", "bottom", "left", "right"。
• hide_window_when_unfocused — 失去焦点时是否隐藏快捷键窗口。类型：布尔值。
• keybinding — 切换快捷键窗口的键盘快捷键。类型：字符串或 null。
• pin_screen — 快捷键窗口固定的显示器。类型：字符串、对象或 null。选项："primary", { external = 1 }, null。

窗口大小百分比按固定位置进行配置

[global_hotkey.dedicated_window]
enabled = true

[global_hotkey.dedicated_window.settings]
active_pin_position = "top"
hide_window_when_unfocused = true
keybinding = "ctrl-`"

[global_hotkey.dedicated_window.settings.pin_position_to_size_percentages.top]
width = 100
height = 30

[global_hotkey.dedicated_window.settings.pin_position_to_size_percentages.bottom]
width = 100
height = 30

[global_hotkey.dedicated_window.settings.pin_position_to_size_percentages.left]
width = 40
height = 100

[global_hotkey.dedicated_window.settings.pin_position_to_size_percentages.right]
width = 40
height = 100