配置参考

配置文件结构

所有配置集中在一个文件：~/.thincoder/config.json。CLI 与 VS Code 扩展共用——任一处修改，另一处立即生效。也可以在 TUI 里用 /config、/provider、/model 命令管理。

{
  "providers": [
    { "name": "deepseek", "apiKey": "sk-…", "baseURL": "https://api.deepseek.com",
      "model": "deepseek-v4-pro", "thinking": { "type": "enabled" },
      "reasoningEffort": "max", "maxTokens": 393216 }
  ],
  "activeProvider": "deepseek",
  "activeModel": null,
  "agent": {
    "maxTurns": 100,
    "subagentTurns": 100,
    "subagentModel": null,
    "subagentModels": {},
    "goalTurns": 200,
    "compactThreshold": 100000,
    "verifyGuard": false,
    "engineering": false,
    "consultModels": [
      { "provider": "kimi", "model": "kimi-k3", "effort": "high" },
      { "provider": "deepseek", "model": "deepseek-v4-pro" }
    ],
    "consultTurns": 40,
    "consultTimeoutMs": 600000
  },
  "advisor": { "enabled": true, "provider": null, "model": null },
  "proxy": null,
  "mcp": { "servers": [] },
  "embedding": { "baseURL": "https://api.siliconflow.cn/v1", "model": "BAAI/bge-m3" },
  "shell": null
}

配置项说明

providers[]（提供商列表）

• name — 提供商标识（内置预设名或自定义名）
• apiKey — API Key（也可以用环境变量 THINCODER_API_KEY）
• baseURL — 端点地址（兼容 OpenAI API 的任何端点）
• model — 默认模型
• thinking — 思考模式（如 {"type":"enabled"} / {"type":"adaptive"} / null 关闭）
• reasoningEffort — 推理力度（max / high 等，按模型支持）
• maxTokens — 上下文上限
• proxy — 该提供商单独走代理（true）

agent（Agent 行为）

• maxTurns — 单轮对话最大工具循环数（默认 100）
• subagentTurns — 子代理轮次上限（默认 100；explore 角色更低）
• subagentModel / subagentModels — 子代理默认模型 / 按角色覆盖
• goalTurns — 长期目标轮次上限（默认 200）
• compactThreshold — 上下文压缩阈值（默认 100000 token）
• verifyGuard — 改文件后强制 verify（默认关闭，opt-in）
• engineering — 工程模式（设计先行 + 强制评审闸门）
• consultModels — 会诊 / 飞刀候选池（[{ provider, model, effort? }]，最多 5 个；缺省空 = 未启用）
• consultTurns — 每个会诊顾问的工具轮数预算（默认 40）
• consultTimeoutMs — 会诊墙钟上限（默认 600000ms = 10 分钟）

advisor（独立评审）

• enabled — 启用评审系统（代码修改后自动触发）
• provider / model — 评审用独立的提供商/模型（缺省用主 Agent 的）
• thinking / reasoningEffort — 评审模型的思考配置
• guard — 设 false 关闭修改后强制评审的打回

其他

• proxy — 全局代理（或使用环境变量 HTTPS_PROXY）
• mcp.servers — MCP 服务器列表（command / url 两种启动方式），TUI 里用 /mcp 管理
• embedding — 嵌入服务端点与模型（可选；缺省时记忆检索降级为关键词匹配）
• shell — bash 工具使用的 shell 覆盖

VS Code 扩展设置

三个扩展设置项（VS Code 设置里搜索 thincoder.）：

• thincoder.providers — 提供商配置（面板里管理更直观）
• thincoder.autoApprove — 自动批准工具调用（默认关闭——安全模式）
• thincoder.mcpServers — MCP 服务器配置（扩展本地管理）

更多架构细节见 ARCHITECTURE.md。