配置
SeaWork 从 SeaWork 主目录中的单个 JSON 文件加载配置,并支持可选的环境变量和 CLI 覆盖。
配置文件位置
默认情况下,SeaWork 使用 ~/.seawork 作为其主目录。配置文件为:
~/.seawork/config.json
你可以通过设置 SEAWORK_HOME 或向 seawork daemon start 传递 --home 参数来更改主目录。
优先级
SeaWork 按以下顺序合并配置:
- 默认值
config.json- 环境变量
- 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 的方式。适用于 claude 和 codex。
command.mode 可以是 default、append 或 replace。使用 env 注入特定于提供商的环境变量。
语音
语音通过 features.dictation 和 features.voiceMode 配置,提供商凭证在 providers 下。
有关语音设计理念、架构和完整的本地/OpenAI 设置示例,请参阅 语音文档。
日志
守护进程日志默认使用独立的控制台和文件输出:
- 控制台:
info及以上 - 文件(
$SEAWORK_HOME/daemon.log):trace及以上 - 文件轮转:最大文件大小
10m,共保留2个文件
常用环境变量
SEAWORK_HOME— 设置 SeaWork 主目录SEAWORK_LISTEN— 覆盖daemon.listenSEAWORK_ALLOWED_HOSTS— 覆盖或扩展daemon.allowedHostsOPENAI_API_KEY— 覆盖 OpenAI provider keySEAWORK_VOICE_LLM_PROVIDER— 覆盖语音 LLM provider
Schema
用于编辑器自动补全/验证,将 $schema 设置为:
https://seawork.ai/schemas/seawork.config.v1.json
SeaWork