Configuration — seek docs

API Key Resolution Order

API 密钥查找顺序

From highest to lowest priority:

从高到低优先级：

Environment variables — DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY. Best for CI, secret managers, one-off invocations.
环境变量——DEEPSEEK_API_KEY、ANTHROPIC_API_KEY、OPENAI_API_KEY、GEMINI_API_KEY。适合 CI、secret manager、单次调用。
~/.seek/config.json — written by the first-run wizard or hand-edited.
~/.seek/config.json——由首次运行向导写入或手动编辑。
Unconfigured — seek launches the setup wizard automatically.
空——seek 自动启动配置向导。

Environment variables always win over the config file, so CI / secret-manager invocations never accidentally pick up a stale on-disk key. 环境变量始终优先于配置文件，确保 CI 等场景不会意外读到过期的本地密钥。

Config File Format

配置文件格式

{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "api_key": "sk-..."
    },
    "anthropic": {
      "api_key": "sk-ant-..."
    }
  }
}

Field	字段	Type	类型
`default_provider`	string	Default provider (`deepseek` / `anthropic` / `openai` / `gemini`). Empty = auto-detect.	默认 provider，空字符串走自动检测。
`providers`	object	Per-provider credential config, keyed by provider name.	各 provider 的凭证配置。
`path_prompt_done`	bool	Whether the "add to PATH" prompt has been shown (Windows).	Windows 上"添加到 PATH"提示是否已显示。
`suggest_reply`	*bool	Enable/disable suggested replies. Absent = enabled.	启用/禁用建议回复。缺省 = 启用。
`push_webhooks`	array	Push notification webhook targets.	推送通知 webhook 配置。
`session_notify_seconds`	*int	Interactive turn threshold for push notification. Default 60s, 0 = disabled.	交互回合推送通知阈值秒数。缺省 60s，0 禁用。

Supported Providers

支持的 Provider

Provider	Provider	Env Variable
DeepSeek (default)	`DEEPSEEK_API_KEY`	`deepseek`
Anthropic	`ANTHROPIC_API_KEY`	`anthropic`
OpenAI	`OPENAI_API_KEY`	`openai`
Gemini	`GEMINI_API_KEY`	`gemini`

Switching Provider

切换 Provider

$ DEEPSEEK_API_KEY=sk-xxx seek       # via env var
$ seek --provider anthropic            # via CLI flag

First-Run Wizard

首次运行向导

On first launch with no API key configured, seek starts an interactive wizard:

首次运行且未配置 API 密钥时，自动启动交互式向导：

Detects already-set environment variables.
检测已设置的环境变量。
Prompts for provider selection.
提示选择 provider。
Prompts for API key (or confirms detected env var).
输入 API 密钥（或确认使用已检测到的环境变量）。
Writes ~/.seek/config.json.
写入 ~/.seek/config.json。

Storage Paths

存储路径

Platform	平台	Config Path	配置文件路径
Linux / macOS	`~/.seek/config.json`
Windows	`%USERPROFILE%\.seek\config.json`

Override ~/.seek/ location with the $SEEK_HOME environment variable.

可通过 $SEEK_HOME 环境变量覆盖 ~/.seek/ 的位置。

Configuration — API Keys & Provider Setup

配置 — API 密钥与 Provider 设置