Warpai warpai DOCS
官网主页 下载安装 1 EN

配置项与外观主题

Warpai 既提供直观的可视化设置面板(macOS 上按 Cmd + ,,Windows 上按 Ctrl + ,),也支持声明式的 settings.toml 纯文本配置文件。所有设置与数据均严格保存在本地用户目录中。


配置文件路径

  • macOS / Linux:~/.config/warpai/settings.toml
  • Windows:%USERPROFILE%\.config\warpai\settings.toml

Warpai 实时监听该文件的变动。在 settings.toml 中手动修改或在 GUI 设置界面中操作,均能实现双向实时热同步,无需重启应用(界面语言切换除外)。


设置:Agent 通信开关(Agent Communication)

若要允许本地 Agent 通过内置 MCP 总线相互感知与协作:

  1. 打开 设置 > 功能(Features) > Agent communication。
  2. 将总开关切换为 开启(ON)。
  3. 勾选你本机已安装的 CLI Agent。
SHOT-20 (P2) Settings: Agent Communication Toggle

设置面板中的 Agent 通信配置页:展示 Master 开关开启状态,以及列出的 20+ 款主流 Agent 勾选清单(Claude, Codex, Gemini 等)。

建议尺寸: 1100x750 目标路径: docs/images/settings-agent-communication.png 截图待补充 · 对应表格 docs/SCREENSHOT-INVENTORY.xlsx

外观主题定制:Claude Warm Light 经典暖光 与 Ink 纯黑暗调

Warpai 原生搭载两款核心主题:默认的 Claude Warm Light(温暖纸张质感、极佳可读性的浅色暖调)与 Ink Pure Dark(纯黑极客底色、高对比度霓虹/柔光暗调)。

SHOT-21 (P2) Claude Warm Light 经典暖光浅色主题全景

默认 Claude Warm Light 经典暖光浅色主题全景展示:呈现舒适优雅的暖调质感与高对比度语法配色。

建议尺寸: 1440x810 (16:9) 目标路径: docs/images/appearance-claude-warm-light.png 截图待补充 · 对应表格 docs/SCREENSHOT-INVENTORY.xlsx
SHOT-28 (P2) Ink Pure Dark 纯黑极客暗色主题全景

Ink 纯黑经典暗色主题全景:展示 Warpai 切换至 Ink Pure Dark 主题下的深黑底色、高对比度霓虹/柔光语法高亮及暗调协同面板。

建议尺寸: 1440x810 (16:9) 目标路径: docs/images/appearance-ink-pure-dark.png 截图待补充 · 对应表格 docs/SCREENSHOT-INVENTORY.xlsx

核心常用快捷键速查表

操作指令 macOS 快捷键 Windows 快捷键
新建标签页 Cmd + T Ctrl + T
关闭当前标签页 Cmd + W Ctrl + W
左右垂直分屏 Cmd + D Ctrl + Shift + D
上下水平分屏 Cmd + Shift + D Ctrl + Shift + E
切换垂直/水平标签栏 Cmd + Shift + V Ctrl + Shift + V
全局命令面板 Cmd + P Ctrl + P
命令执行历史搜索 Cmd + R Ctrl + R
显隐项目文件树 Cmd + B Ctrl + B
打开偏好设置 Cmd + , Ctrl + ,