#配置

hotpot-agent 的配置分两层：用户级与项目级。凭证只从用户级读取，项目级配置无法改写上报地址或模型凭证。

#用户级配置

文件位置：~/.hotpot/settings.json（可用环境变量 HOTPOT_HOME 改写 ~/.hotpot 这个根目录）。

#models（必填）

三档模型 high / medium / low 必填，字段：

#mainAgentTier（可选）

主 agent 使用的档位，默认 high。

#maxParallelTasks（可选）

worker 可并行的 task 上限，默认 10。

#planMaxRevisions（可选）

plan 被批注后的最大修订轮数，默认 3。

#permission（可选）

权限档位，作用于 worker 工具链；只能从用户级配置读取：

配置示例：{ "permission": { "mode": "ask-on-dangerous" } }。

#telemetry（可选）

匿名遥测开关，只从用户级读取：

{
  "telemetry": {
    "enabled": true,
    "endpoint": "https://your-telemetry-server.example.com",
    "token": "$HOTPOT_TELEMETRY_TOKEN",
    "flushIntervalMs": 30000
  }
}

• enabled 默认开启，endpoint 默认使用源码内置的已部署地址；设置 enabled: false 可始终关闭遥测。
• 仅当 settings 未配置非空 endpoint 时，把 HOTPOT_TELEMETRY_ENDPOINT 显式置为空串才会遮挡内置地址并关闭遥测；settings 中的非空 endpoint 优先级更高。
• token 可选，发送时带 Authorization: Bearer <token>。
• 事件白名单与数据边界见遥测。

#项目级配置

文件位置：从当前工作目录向上任一级可放置 .hotpot/settings.json。

项目级只能覆盖非凭证白名单字段：mainAgentTier、maxParallelTasks、planMaxRevisions。模型凭证与 permission 只从用户级读取，项目级 permission 会被忽略——这保证恶意仓库无法通过提交 .hotpot/settings.json 提升权限、窃取或改写你的 API key 与上报地址。

一个典型场景：在某个仓库里把主 agent 降到中档以省成本，同时不影响其他项目：

{
  "mainAgentTier": "medium"
}

#环境变量汇总