config.example.jsonc

{
  // 默认使用的 provider、model 和推理强度。
  // ★ provider 的值是下面 providers 里的一个 key 名（一根“指针”），不是协议名——
  //   改 provider 必须保证 providers 里有同名条目，否则启动会报“未配置凭证”。
  //   运行时用 /config 管理 Provider/模型库，用 /model 在已保存模型间切换。
  "provider": "openrouter",
  "model": "google/gemini-2.5-flash",
  // 可选。默认推理强度：off / low / medium / high / xhigh / max。
  // 省略或空字符串 = 不覆盖，沿用模型/provider 默认。
  "reasoning_effort": "medium",

  // Provider 凭证库。key 自定义，用作上面 provider 字段引用的目标。
  // 已知 provider（openai/anthropic/gemini/openrouter/deepseek/qwen/glm/grok/mimo/ollama/bedrock）
  // 可省略 type；自定义代理必须显式声明 type 指明 API 协议。
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx",
      "base_url": "https://openrouter.ai/api/v1",
      // 可选。声明 /model 面板候选及模型专属上下文窗口；旧字符串数组仍兼容。
      "models": [
        { "name": "google/gemini-3.0-flash", "context_window": 200000 },
        { "name": "google/gemini-3.1-pro", "context_window": 1000000 }
      ],
      // 可选。透传给该 provider 每次请求的额外参数（采样参数如 temperature/top_p/
      // min_p，或厂商特有键如 nvidia 开 think 的 chat_template_kwargs），逐字并入请求体。
      // 仅对 OpenAI 兼容类 provider 生效（openrouter/deepseek/qwen/glm/grok/ollama…）；
      // type:"openai" 会按官方参数白名单过滤。值由用户自负其责。
      "extra_body": { "temperature": 0.8, "min_p": 0.05 },
      // 可选。provider 级配置，透传给 HTTP 客户端层（不是请求体），用于需要
      // 自定义 User-Agent / headers / anthropic_beta 的代理。
      "extra": {
        "user_agent": "my-client/1.0",
        "headers": { "X-Custom-Client": "my-client" }
      }
    },
    "anthropic": {
      "api_key": "sk-ant-xxx",
      "models": [{ "name": "claude-sonnet-4" }, { "name": "claude-opus-4" }]
    },
    "ollama": {
      // ollama / bedrock / 显式 type 的自定义代理可以省略 api_key
      // base_url 需带 /v1（ollama 的 OpenAI 兼容端点在 /v1 下）
      "base_url": "http://localhost:11434/v1",
      "models": [{ "name": "qwen3:14b", "context_window": 32768 }],
      // 可选。流式空闲看门狗（Go duration，默认 "5m"）：LocalAI/ollama 等
      // 本地慢推理首块可超 5 分钟，按 provider 放宽，不影响其它通道
      "stream_idle_timeout": "15m"
    },
    "claude-code-proxy": {
      // 自定义 Anthropic 代理。如果上游限制只能由 Claude Code 客户端访问，
      // 用 extra 透传 user_agent / anthropic_beta / headers。
      // base_url 不需要带 /v1。
      "type": "anthropic",
      "api_key": "sk-xxx",
      "base_url": "https://proxy.example.com",
      "models": [{ "name": "claude-sonnet-4-6", "context_window": 1000000 }],
      "extra": {
        "user_agent": "claude-code/2.1.183",
        "anthropic_beta": "claude-code-20250219",
        "headers": {
          "X-Stainless-Lang": "js",
          "X-Stainless-Package-Version": "0.94.0",
          "X-Stainless-Runtime": "node"
        }
      }
    },
    "codex-proxy": {
      // 自定义 OpenAI/NewAPI 代理。如果上游限制只能由 Codex 客户端访问，
      // 用 extra 覆盖 User-Agent，并透传 Codex 识别头。
      // base_url 按代理实际地址填写；OpenAI 协议通常需要 /v1。
      "type": "openai",
      "api_key": "sk-xxx",
      "base_url": "https://proxy.example.com/v1",
      "models": [
        { "name": "gpt-5.4", "context_window": 400000 },
        { "name": "gpt-5.4-mini" },
        { "name": "MiniMax-M3", "context_window": 1000000 }
      ],
      // 可选。OpenAI 协议 endpoint：chat（默认 /v1/chat/completions）/
      // responses（/v1/responses）。Codex 类代理通常需要 responses。
      "api": "responses",
      "extra": {
        // 可选。缓存路由键 prompt_cache_key 默认只发给官方 api.openai.com——
        // 第三方兼容端对未知字段没有统一契约（Groq/Cerebras/火山等严格端会 400，
        // 重编组型中转会静默丢弃）。确认你的中转原样透传请求体到 OpenAI 时，
        // 打开此项可获得缓存路由亲和（提升命中率）。
        "prompt_cache_params": true,
        "user_agent": "codex-tui/0.142.3 (Mac OS 26.5.1; arm64) Apple_Terminal/470.2 (codex-tui; 0.142.3)",
        "headers": {
          "Originator": "codex-tui",
          "Session_id": "replace-with-random-session-id",
          "X-Codex-Turn-Metadata": "replace-with-random-turn-metadata"
        }
      }
    }
  },

  // 可选。按角色覆盖默认模型；未配的角色使用上面的 model。
  // reasoning_effort 也可按角色覆盖；未配时继承顶层 reasoning_effort。
  // 角色：architect / writer / editor。fallbacks 在主模型失败时按序尝试。
  // 注意：这里的 provider 同样是“指针”，必须指向 providers 里存在的 key。
  // "roles": {
  //   "writer": {
  //     "provider": "anthropic",
  //     "model": "claude-sonnet-4",
  //     "reasoning_effort": "high",
  //     "fallbacks": [{ "provider": "openrouter", "model": "google/gemini-3.0-pro" }]
  //   },
  //   "architect": { "provider": "openrouter", "model": "google/gemini-3.1-pro" }
  // },

  // 写作风格：default / suspense / fantasy / romance。
  "style": "default"

  // 旧版全局上下文窗口，保留作所有模型的回退。优先级低于 models[].context_window，
  // 高于模型注册表和 200k 默认值。仅影响压缩阈值，不改变 API 实际请求长度。
  // "context_window": 300000

  // 可选。单本书（output 目录）的成本预算，挂机保险丝。book_usd > 0 才启用。
  // 累计花费达到 warn_ratio 时告警不停机；达到 100% 在当前子代理任务结束后
  // 优雅停机（hard_stop=true 则越线立即停）。停机后上调 book_usd 即可恢复续跑。
  // 注意：自定义模型若注册表查不到价格且 provider 不自报 cost，预算形同虚设。
  // "budget": {
  //   "book_usd": 50,
  //   "warn_ratio": 0.8,
  //   "hard_stop": false
  // },

  // 可选。无人值守告警，缺省启用（Windows 通知 / macOS osascript / Linux notify-send）。
  // 配置 command 后改走自定义命令（手机推送走这里）：字段经环境变量
  // NOTIFY_TITLE / NOTIFY_BODY / NOTIFY_KIND / NOTIFY_LEVEL 通过环境变量传入，完整 JSON 同时写 stdin。
  // Unix shell 用 $NOTIFY_TITLE；Windows PowerShell 用 $env:NOTIFY_TITLE。
  // events 可选过滤：run_end / budget / advance_gate / stop_guard /
  // plan_start / deadlock / worker_failure；缺省全部开启。
  // "notify": {
  //   "enabled": true,
  //   // 标题/正文含中文与空格，必须经 --data-urlencode 传参，不可拼进 URL 路径或 HTTP 头。
  //   // Bark (iOS):         "command": "curl -s --data-urlencode \"title=$NOTIFY_TITLE\" --data-urlencode \"body=$NOTIFY_BODY\" https://api.day.app/<key>"
  //   // ntfy (iOS/Android): "command": "curl -s -G --data-urlencode \"title=$NOTIFY_TITLE\" --data-urlencode \"message=$NOTIFY_BODY\" ntfy.sh/<topic>/publish"
  //   "events": ["run_end", "budget", "advance_gate", "stop_guard", "plan_start", "deadlock", "worker_failure"]
  // }
}