配置

Pontia 从 $PONTIA_HOME/config.toml 读取持久配置。PONTIA_HOME 默认为 $HOME/.pontia，必须是非根目录的绝对路径，且不能包含 .. 路径穿越。

编辑持久服务设置后，用以下命令应用：

pontia up

基本配置

bind_addr = "127.0.0.1:8080"
external_api_token = "replace-with-a-long-secret"
run_migrations = true
default_client_type = "pi"

[runtime.pi]
tui_command = "pi"

[workspace_browser]
roots = [
  { root_id = "projects", label = "Projects", path = "/home/me/projects" }
]

dashboard.source 的发布版默认值是与已安装 Pontia 版本匹配的 Dashboard 归档。远程 Dashboard 归档缓存在 $PONTIA_HOME/cache/dashboard 下；刷新失败时仍可使用已有缓存提供服务。

文件选择器

文件选择器为活动 Workspace 中的 @ 建议提供支持：

[file_picker]
enabled = true
min_query_chars = 0
max_results = 100
max_candidates = 100000
timeout_ms = 1500
respect_gitignore = true
respect_ignore_files = true
respect_git_exclude = true
include_hidden = false
follow_symlinks = false
ignore_globs = [
  ".git/**",
  "node_modules/**",
  "target/**",
  "dist/**",
  "build/**",
  ".svelte-kit/**",
  ".next/**"
]

设置 follow_symlinks = true 可在搜索中包含可访问的符号链接目标，包括可见目录树之外的目标。

上传的文件

上传的文件会在保留期结束后自动删除，保留期从上传开始时计算。需要保留更久的文件，请在过期前放入你的 Workspace。

[uploads]
incomplete_retention_days = 7
completed_retention_days = 30
cleanup_interval_hours = 24

以上为默认值。三个值都必须是正整数。清理在服务启动时于后台运行，之后按配置的间隔运行，并跳过正在写入的上传。通过 pontia up 重启服务来应用更改。

环境变量覆盖

运行中的进程接受以下覆盖：

对于运行中的进程，环境变量的值优先于文件中的值。持久服务配置请使用 config.toml。已安装的服务会单独保存 PONTIA_HOME、PONTIA_AUTH_ORIGIN 和所需的 Agent Client 路径。

布尔类型的环境变量接受 1、true、yes 或 on，以及 0、false、no 或 off。

状态文件

默认状态目录包含敏感的持久数据：

请保持状态目录私有，并按照安全中的说明保护其备份。使用设备管理来轮换或撤销远程凭据。