配置

服务商管理

未配置服务商时，min-agent 会使用内置的 OpenRouter 模型（openrouter/free），无需任何配置即可使用。运行 min-agent setup 可添加或切换你自己的服务商：

min-agent setup --type ollama
min-agent setup --type openai-compatible --url https://api.example.com/v1 --api-key "$KEY" --name groq --default-model llama-3.1-70b
min-agent setup --switch ollama
min-agent setup --remove groq        # 删除服务商
min-agent setup --context-window 8192 # 设置上下文窗口

• --type 支持 openai-compatible、openai、ollama
• 未指定参数时进入交互式引导

写在 ~/.min-agent/config.json 里的配置优先于内置预设。

配置文件

全局配置存放在 ~/.min-agent/config.json：

配置	说明
activeProvider	当前生效的服务商
defaultModel	默认模型
sampling	采样参数
permission	确认模式
thinking	思考强度
memory	记忆开关
sandbox	隔离策略
compaction	压缩策略
agent	其他代理设置

密钥只存在 ~/.min-agent/config.json，不会写入项目配置。

项目级配置

在某个项目下运行 min-agent init 初始化 .min-agent/config.json，即可为该目录单独配置。项目有值则覆盖全局；min-agent 不会自行创建 .min-agent/ 目录。

min-agent init                 # 在项目根目录初始化
min-agent --permission ask --project   # 将确认模式写入项目配置

项目配置字段

• disabledSkills / enabledSkills：启用/禁用技能
• 可选：activeProvider / defaultModel / sampling / permission / thinking / memory / sandbox / compaction / agent

常用配置命令

命令	说明
min-agent setup	添加、切换或删除服务商
min-agent init	初始化项目级 .min-agent/
min-agent permission	查看/设置确认模式
min-agent sandbox	查看/设置隔离策略
min-agent think	查看/设置思考强度
min-agent memory	查看/设置记忆开关
min-agent ctx	查看/设置 Ollama 上下文窗口
min-agent rules	查看/编辑规则文件
min-agent models	查看可用模型