配置
用一个 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),这样你的编辑器会在保存前标出
拼写错误。运行时则有意保持宽容。