配置

SeaWork 从 SeaWork 主目录中的单个 JSON 文件加载配置,并支持可选的环境变量和 CLI 覆盖。

配置文件位置

默认情况下,SeaWork 使用 ~/.seawork 作为其主目录。配置文件为:

~/.seawork/config.json

你可以通过设置 SEAWORK_HOME 或向 seawork daemon start 传递 --home 参数来更改主目录。

优先级

SeaWork 按以下顺序合并配置:

  1. 默认值
  2. config.json
  3. 环境变量
  4. CLI 参数

示例

{
  "$schema": "https://seawork.ai/schemas/seawork.config.v1.json",
  "version": 1,
  "daemon": {
    "listen": "127.0.0.1:6767",
    "allowedHosts": ["localhost", ".localhost"],
    "mcp": { "enabled": true }
  }
}

智能体提供商运行时设置

使用 agents.providers 自定义 SeaWork 启动智能体提供商 CLI 的方式。适用于 claudecodex

command.mode 可以是 defaultappendreplace。使用 env 注入特定于提供商的环境变量。

语音

语音通过 features.dictationfeatures.voiceMode 配置,提供商凭证在 providers 下。

有关语音设计理念、架构和完整的本地/OpenAI 设置示例,请参阅 语音文档

日志

守护进程日志默认使用独立的控制台和文件输出:

  • 控制台:info 及以上
  • 文件($SEAWORK_HOME/daemon.log):trace 及以上
  • 文件轮转:最大文件大小 10m,共保留 2 个文件

常用环境变量

  • SEAWORK_HOME — 设置 SeaWork 主目录
  • SEAWORK_LISTEN — 覆盖 daemon.listen
  • SEAWORK_ALLOWED_HOSTS — 覆盖或扩展 daemon.allowedHosts
  • OPENAI_API_KEY — 覆盖 OpenAI provider key
  • SEAWORK_VOICE_LLM_PROVIDER — 覆盖语音 LLM provider

Schema

用于编辑器自动补全/验证,将 $schema 设置为:

https://seawork.ai/schemas/seawork.config.v1.json