跳到内容
Paneflow

配置

用一个 paneflow.json 文件定制 Paneflow - 默认 shell、主题、快捷键、窗口装饰等等。

Paneflow 启动时读取一个 JSON 文件:paneflow.json。每个键都是可 选的,并具有合理的默认值,因此空的 {} 是一个有效配置。完整参考 (包括每个键的类型、默认值和稳定性)位于 模式页面

paneflow.json 在哪里?

OS路径
Linux~/.config/paneflow/paneflow.json(或 $XDG_CONFIG_HOME/paneflow/paneflow.json
macOS~/Library/Application Support/paneflow/paneflow.json

如果首次启动时文件不存在,Paneflow 会用全部默认值启动。在上述路径 创建文件即可开始定制。

通过 JSON Schema 实现编辑器自动补全

固定一个 $schema 引用,即可在 VS Code、JetBrains、Zed、Helix 或 任何带有 JSON Schema 语言服务器的编辑器中获得即时自动补全和类型 检查:

{
  "$schema": "https://github.com/ArthurDEV44/paneflow/raw/main/schemas/paneflow.schema.json",
  "theme": "One Dark"
}

模式随每个版本发布,并精确追踪正在运行的构建所接受的键集合。

Paneflow 如何处理未知键?

Paneflow 在运行时是宽容的:未知的顶层键会被静默忽略,缺失的 键会解析为它们的默认值。这让你的配置在不同版本之间向前兼容 - 把 更新版本的键放进配置,永远不会让旧版本的 Paneflow 二进制文件出错。

JSON Schema 在编辑时会额外拒绝未知键 (additionalProperties: false),这样你的编辑器会在保存前标出 拼写错误。运行时则有意保持宽容。

接下来呢?

  • 包含每个键的完整模式参考:模式
  • 快捷键定制:快捷键

On this page