主题

为 Paneflow 的终端和界面选择调色板，再指定浅色、深色或跟随系统模式。 Paneflow 内置 5 种调色板：Paneflow、Vercel、Claude、 Cursor 和 Tailwind。每种都有浅色和深色版本，默认主题为 Paneflow Dark。

无论通过设置界面还是编辑 paneflow.json，主题更改都无需重启 Paneflow 即可生效。

选择主题

1. 在 Paneflow 设置中打开 Appearance。
2. 选择 Light、Dark 或 System。
3. 在 Preset 中选择调色板。

关闭并重新打开 Paneflow 后，System 模式仍会保留。系统外观更改时， Paneflow 会切换同一调色板的浅色或深色版本。

要恢复 Paneflow Dark，在 Theme 区域选择 Reset to default。

内置调色板

在 paneflow.json 的 theme 字段中使用下列名称。调色板名称在所有语言中保持一致。

名称不区分大小写。旧配置仍可使用：One Dark 对应 Paneflow Dark， PaneFlow Light 对应 Paneflow Light。旧名称 Vercel、Claude 和 Cursor 对应各自的深色版本。

在 paneflow.json 中设置主题

将 theme 设为表中的主题名，并将 theme_mode 设为对应模式。 例如，使用 Claude 的浅色调色板：

{
"$schema": "https://github.com/arthjean/paneflow/raw/main/schemas/paneflow.schema.json",
"$schemaVersion": "1.0.0",
"theme": "Claude Light",
"theme_mode": "light"
}

要跟随系统外观，将 theme_mode 改为 "system"。Paneflow 会保留 theme 指定的调色板，并根据系统外观选择浅色或深色版本。

配置文件默认保存在以下位置：

如果设置了 PANEFLOW_HOME，请编辑该目录中的文件。 所有配置项见配置参考。

如果省略 theme_mode 或将其设为 null，Paneflow 会根据主题名判断浅色或深色模式。 要恢复默认配置，删除 theme 和 theme_mode，或将两者都设为 null。

主题会更改什么

• 终端的背景、文本、光标、选区、滚动条、链接和 ANSI 颜色。
• 界面的背景、边框和文本。
• Markdown 面板和表格。
• Changes 和 Files 中的语法颜色。

部分外观设置与主题独立：

• terminal.cursor_color 覆盖终端光标颜色。设为 null 可使用主题的光标颜色。
• Interface style 控制窗口材质和透明度。参见外观设置。
• commands[].workspace.color 设置工作区模板的颜色。

主题没有更改时

编辑 paneflow.json 后保存文件。如果仍显示原来的主题，请确认修改的是当前使用的 配置文件，并检查 JSON 是否有效。重新加载时，如果新文件存在 JSON 错误， Paneflow 会保留上一次的有效配置。

如果显示的是 Paneflow Dark，而非所需的调色板，请对照上表检查主题名。 遇到未知名称时，Paneflow 会使用 Paneflow Dark，并在日志中记录警告。

更多检查步骤见配置故障排查。 主题更改无需重启，但修改 window_decorations 后需要重启。

自定义调色板

Paneflow 仅支持内置调色板，不会加载 theme.json，也不会从 paneflow.json 加载自定义调色板。

如需其他调色板，请在 GitHub 提交主题请求， 说明颜色和使用场景。如需贡献内置主题，可从桌面应用仓库的 src-app/src/theme/builtin.rs 开始。