配置参考

虽然 PhanTerm 推荐通过 TUI 界面完成绝大部分管理工作，但所有的底层数据都采用人类可读的结构化纯文本进行持久化。这方便了极客玩家们进行备份、版本控制甚至编写外部的自动化脚本。

配置文件路径

所有的数据都在用户的私有配置目录下存储。

Windows: %APPDATA%\phanterm\
Linux/macOS: ~/.config/phanterm/

核心文件列表

文件名	用途	格式说明
`config.yaml`	全局首选项	包含语言区域、更新开关和并发度限制等基础设置。
`connections.yaml`	主机列表	您的服务器清单。密码等敏感字段如果依赖系统密钥串则显示为空或特殊引用，否则将存储强加密后的 AES 密文。
`known_hosts.yaml`	受信任的指纹库	记录了所有您曾验证过的主机地址、算法类型与 SHA-256 指纹。
`snippets.yaml`	命令片段库	存储所有的自定义命令片段与标签元数据。
`master.key`	AES 回退密钥	[极密] 请妥善保管此文件，切勿将其提交到任何公共代码仓库中。

自定义 `config.yaml`

config.yaml 提供了应用的全局行为控制。您可以手动编辑此文件来自定义 PhanTerm 的行为。如果该文件不存在，PhanTerm 会在下次启动时自动生成带有默认值的配置文件。

示范配置

以下是一个典型的 config.yaml 示范版本：

# 界面语言设置，目前支持 'en' (英文) 和 'zh' (中文)
locale: "zh"

# 自动更新通道：'stable' (稳定版) 或 'beta' (测试版)
update_channel: "stable"

# 是否在启动时自动检查更新
check_updates_on_startup: true

# Multi-Exec 并行批量执行的高级配置 [Pro]
multi_exec:
  # 当向多个保存的服务器发起临时连接时的最大并发数（默认：10，范围：1-10）
  temp_connect_concurrency: 10

  # 每台目标服务器上命令执行的最大超时时间，单位秒（默认：300，即 5 分钟）
  target_timeout_seconds: 300

可配置项说明

locale：定义 TUI 界面的显示语言。如果为空或不支持的语言，将回退到默认的英文界面。
update_channel 与 check_updates_on_startup：控制应用如何获取新版本的推送。
multi_exec：这一部分专门用于控制 Multi-Exec 功能的底层行为。您可以依据网络环境调整 temp_connect_concurrency 来控制并行建连的压力，或通过增大 target_timeout_seconds 来允许某些耗时极长的脚本（例如大文件打包或系统全量升级）顺利完成而不被强行中断。