Settings 参考

<CETAS_HOME>/.cetas/settings.json 是一个 JSON 对象。Cetas 原子写入，并保留它不负责的每一个 key——别的工具（或将来版本）写进去的东西，不会因为一次切模型就被抹掉。启动时，缺失的文件会带着空的 providers 对象被创建；已存在的文件永远不会被覆盖——包括空的或坏掉的。settings 坏掉会直接报错，Cetas 不会悄悄替你修好。

顶层 key

下面按层级展开。

model / reasoning_effort / decision_model

更新选择时，无关的 key 原样保留。供应商配置变化导致原选择不可用时，Cetas 退回可用的默认值，不会卡在失效的旧选择上。

providers

条目是“供应商 id → 供应商配置”。每个条目由对应扩展解释，本页不代答：

• 内置 id 与登录方式：供应商；
• 非内置 id 会成为自定义供应商，协议由条目里的 protocol（chat_completions / responses / messages，缺省 chat_completions）声明；条目形状（base_url、protocol、auth、models、模型元数据）见自定义模型。

凭据不放 providers：那里写的 gateway_key 不会被读取，网关凭据只走共享凭据库（/login 写入）。会被忽略并给出警告的是 magpie 段里的 magpie.gateway_key——凭据写进可编辑的配置文件，本身就是错的位置。怎么录，见接入 Magpie 网关。

subagent

{
  "subagent": {
    "default_model": "zai/glm-5.3",
    "default_effort": "low",
    "limits": {
      "swarm_items": 16,
      "concurrency": 4,
      "global_concurrency": 20,
      "timeout_ms": 1800000,
      "spawn_budget": 64,
      "answer_timeout_ms": 600000
    },
    "kinds": []
  }
}

每个字段都可选；整段不存在就是“用默认值、不额外加 kind”。模型选择的优先级链：显式传参 → kind 绑定 → default_model → 父级当前选择。

workflow

控制 Board 的多任务执行循环。不写 enabled: true 就是关闭。

这一段故意严格：未知 key、类型不对、越界，都是组装错误——预算里的一个笔误，不能悄悄变成另一个预算。

model_manager / manager_selections / magpie

只属于终端入口：记住你选了哪个模型管理器、以及各自上次选了什么，切回来时能恢复原来的槽位。从启动网关到验证可用的一条主线，见接入 Magpie 网关。