主题

在 Paneflow 的内置主题之间切换 - One Dark 和 PaneFlow Light - 支持热重载，无需重启。

Paneflow 今天提供两个内置主题：一个深色默认主题（One Dark）和一个浅色替代主题（PaneFlow Light）。主题驱动每一种终端表面颜色 - ANSI 调色板、光标、选区、滚动缓冲区高亮、搜索匹配。侧边栏和标题栏保持在 Paneflow 应用外观的调色板上，不受主题控制。

TL;DR。 在 paneflow.json 中设置 "theme": "PaneFlow Light" 切换到浅色主题。保存文件；正在运行的窗口会在 ~300 ms 内拾取新颜色，无需重启。

如何切换活动主题？

在 paneflow.json 中设置 theme 键：

{
  "theme": "PaneFlow Light"
}

值必须与某个内置主题名完全匹配，包括大小写。未知名称会回退到 One Dark 并在下一次解析文件时记录一条日志警告。

配置文件位于：

OS	路径
Linux	`~/.config/paneflow/paneflow.json`
macOS	`~/Library/Application Support/paneflow/paneflow.json`

Stable

名称	描述
`"One Dark"`	深色主题，默认。灵感来自 Atom 的 One Dark 调色板。
`"PaneFlow Light"`	浅色主题。为日光工作站调校的高对比度调色板。

两个主题都附带全部 16 个 ANSI 颜色槽位、前景 / 背景、光标、选区和搜索高亮颜色，预先调校以在标准提示符上满足 WCAG AA 对比度。

项目早期计划提到过六个内置主题。v0.2.x 的现实是两个。其他内置主题（Solarized、Gruvbox 和一个高对比度变体）在路线图上；关注 GitHub releases 获取公告。

当你保存 paneflow.json 时，Paneflow 会即时重新解析主题 - 不需要重启，不需要重新加载窗口。

两种机制驱动重载：

事件驱动（首选）。 安装在配置目录上的 notify 监视器在保存后几毫秒内触发。事件以 300 ms 去抖，让编辑器的保存连发（write -> fsync -> atomic-rename）只触发一次重载。
轮询回退。 不支持 inotify / FSEvents / ReadDirectoryChangesW 的文件系统（NFS 共享、锁定的沙箱、某些 WSL 路径）会回退到 500 ms 的 mtime 轮询。回退只在事件监视器启动失败时运行。

你会在监视器触发后的下一个渲染帧看到新调色板生效 - 通常在保存后 ~300 ms 内。

热重载覆盖 paneflow.json 中每一个与主题相关的字段，包括字体键（font_family、font_size、line_height）。window_decorations 是唯一在启动时一次性读取的配置字段 - 修改它需要重启 Paneflow。

用户提供的自定义主题在 v0.3.0 之后的版本路线图上。v0.2.x 只识别上面列出的内置主题名；目前还没有 theme.json 或自定义调色板格式。

如果你在等待期间想要某个特定调色板，最直接的路径是带着你想要的调色板开一个 GitHub issue。内置主题在 src-app/src/theme/builtin.rs 中调校并随每个版本交付 - 有明确使用场景的新调色板会被加速推进。

未来自定义主题键的 schema 级占位符故意尚未定义，因此今天在 paneflow.json 中添加它没有效果 - 它会被宽容的运行时静默忽略，符合配置概述。