Paneflow 的 Settings 面板是常用偏好的人工 UI。它不是完整的配置参考。 用它调整你经常改的内容：editor、shell、theme、shortcuts、notifications、 terminal display、workspace templates、agent launchers、AI access 和 MCP setup。
TL;DR. 大多数 Settings 行会写入 paneflow.json，并在文件保存后热重载。
Plugins 不同：它会在受支持的 agent config 中安装或修复 Paneflow 的
MCP bridge。高级键仍然可以在
paneflow.json 中使用。
Settings map
| Page | 控制内容 | 写入位置 | 生效方式 |
|---|---|---|---|
| General | 新 terminal pane 的默认外部 editor 和默认 shell。 | external_editor, default_shell | 新启动时生效。正在运行的 terminal 保持当前进程。 |
| Themes | Light、Dark、System，以及可用时专用于 Windows 和 macOS 的 sidebar material controls。 | theme, windows_chrome_material, macos_chrome_material | theme 和 material 更改会热重载。 |
| Keyboard Shortcuts | action bindings 和重置为 defaults。 | shortcuts | config 保存后重新加载。 |
| Notifications | 等待中 agent 的原生 OS notifications。 | agent_panel.notify_when_agent_waiting | 热重载。 |
| Terminal | cursor shape 和 color、font family、font size、font weight、line height、cell width、integrated glyphs、color emoji、minimum contrast、Windows terminal material。 | terminal.cursor_shape, terminal.cursor_color, font_family, font_size, font_weight, line_height, cell_width, terminal.integrated_glyphs, terminal.color_emoji, terminal.minimum_contrast, windows_terminal_material | display controls 会热重载。cursor shape 应用于下一个新 terminal。 |
| Workspaces | 可复用 workspace templates，包含 panes、agents、shell commands、cwd、env 和 prompt prefill。 | commands[].workspace | templates 通过与 paneflow up 相同的 workspace launch path 启动。 |
| Worktrees | Paneflow 创建的 worktree 的根目录、带保留上限的自动删除、带删除操作的受管 worktree 列表，以及删除前拍下的快照及其恢复和删除操作。 | worktrees.dir, worktrees.auto_remove, worktrees.keep_limit | 热重载。根目录对之后创建的 worktree 生效。 |
| Agents | launcher 显示哪些 agents 及其已安装版本、自定义 agent profiles、Claude Code full access、AI free access 和 injection fence。 | *_button_visible, agent_profiles, claude_code_bypass_permissions, ai_unrestricted, ai_injection_fence | launcher 和 access 更改会热重载。 |
| Plugins | 为 Claude Code、Codex、Gemini 和 opencode 安装或修复内置 paneflow-mcp bridge。 | agent config files，不是 paneflow.json | Paneflow 更新后或 agent config 变更后重新运行。 |
AI access vs MCP
Agents 页面控制 Paneflow 如何启动 agents，以及可信 conductor 可以执行多少自动化。
claude_code_bypass_permissions 只影响 Claude Code 启动。启用后，Paneflow
会用 --permission-mode bypassPermissions 启动 Claude Code。它不会改变
Codex、OpenCode、Gemini 或 MCP 的行为。
Plugins 是单独的运维页面。它注册内置的 paneflow-mcp server，让受支持
的 agents 可以 list、read 和 search Paneflow panes。它会修改 agents 自己的
config files，并且可以安全地再次运行。
Config-only controls
如果你需要的设置被有意留在主 Settings UI 之外，请使用
paneflow.json。
常见示例：
terminal.scrollback_lines，用于每个 terminal 的 scrollback history。terminal.ligatures、terminal.cursor_blink、terminal.env和terminal.scroll_multiplier，用于高级 terminal behavior。Paneflow 的每个 build 都使用单一的固定版本、静态链接的libghostty-vt引擎来模拟面板，因此没有可供 选择的引擎。- 不是 workspace templates 的
commands[]entries。 - profiles、telemetry、window-decoration 和 agent-panel options。
Paneflow 会通过 watcher 重新加载有效的 config 变更。如果 JSON 格式错误， 正在运行的 app 会保留上一个有效 config，而不是回退到 defaults。JSON Schema 会在 editors 中标记未知键；runtime 保持宽松，这样旧 build 可以忽略新键。
另请参阅
- Configuration - file location、schema setup 和 runtime behavior。
- Schema - 每个 key、type、default 和 stability。
- Shortcuts and actions -
shortcutsoverrides 的 action names。 - Themes - 内置 theme names 和 hot-reload behavior。