跳转到内容
展示 生态 源码解读 文档

配置

配置

有主见的默认值，如果你坚持可以调整。

配置文件位置

级别路径优先级
项目.opencode/oh-my-openagent.json[c]最高
用户~/.config/opencode/oh-my-openagent.json[c]较低

兼容层同时识别 oh-my-openagent.json[c] 和旧的 oh-my-opencode.json[c] 文件名。现有安装仍常使用旧的文件名。

支持 JSONC — 注释和尾随逗号都可以使用。

代理配置

覆盖任何代理的模型、温度、提示词和权限：

{
  "agents": {
    "sisyphus": {
      "model": "claude-opus-4-6",
      "temperature": 0.7
    },
    "hephaestus": {
      "model": "gpt-5.4"
    },
    "prometheus": {
      "model": "claude-opus-4-6",
      "temperature": 0.6
    }
  }
}

每个代理的选项：

  • model — 使用哪个 LLM
  • temperature — 采样温度
  • prompt_append — 追加到代理系统提示词的额外指令
  • system_prompt_override — 替换整个系统提示词
  • max_tokens — 最大响应长度
  • file:// 提示词 — 从文件加载提示词文本

类别映射

Sisyphus 按类别委派。你可以定义映射到特定模型的自定义类别：

{
  "categories": {
    "visual-engineering": { "model": "claude-opus-4-6" },
    "deep": { "model": "gpt-5.4" },
    "quick": { "model": "kimi-k2.5" },
    "ultrabrain": { "model": "gpt-5.4", "reasoning_effort": "xhigh" },
    "business-logic": { "model": "claude-opus-4-6" },
    "custom": { "model": "glm-5" }
  }
}

内置类别：visual-engineering、deep、quick、ultrabrain。添加你需要的任何自定义类别。

模型回退

配置回退模型以确保可靠性：

{
  "fallback_models": {
    "default": ["claude-opus-4-6", "kimi-k2.5"],
    "hephaestus": [
      "gpt-5.4",
      { "model": "claude-opus-4-6", "reasoning_effort": "high" }
    ]
  }
}

在同一数组中混合纯模型字符串和逐回退对象。系统按顺序尝试每个回退，直到成功。

内置技能

配置内置技能：

技能描述默认
playwright浏览器自动化启用
git-master原子提交、rebase 精细操作启用
frontend-ui-ux设计优先的 UI启用

禁用技能：

{
  "skills": {
    "playwright": { "enabled": false }
  }
}

添加自定义技能：

  • 项目级：.opencode/skills/*/SKILL.md
  • 用户级：~/.config/opencode/skills/*/SKILL.md

Hooks

25 个以上内置 hooks，全部可配置。禁用特定 hooks：

{
  "disabled_hooks": [
    "comment-checker",
    "auto-format"
  ]
}

Hooks 在各个生命周期节点运行：

  • Pre-task：代理执行前
  • Post-task：代理完成后
  • On-error：发生错误时
  • On-agent-switch：切换代理时

内置 MCP 配置

三个 MCP 默认始终在线：

MCP用途可配置
websearch (Exa)网络搜索API 密钥、搜索深度
context7官方文档查询启用/禁用
grep_app (Grep.app)GitHub 代码搜索启用/禁用

可以按标准 OpenCode MCP 配置格式添加自定义 MCP 服务器。

后台任务并发

控制并行运行的代理数量：

{
  "background_tasks": {
    "max_concurrent": 5,
    "per_provider": {
      "anthropic": 3,
      "openai": 5,
      "google": 2
    }
  }
}

根据你的 API 频率限制和订阅级别进行调整。

LSP 配置

{
  "lsp": {
    "enabled": true,
    "servers": {
      "typescript": {
        "command": "typescript-language-server",
        "args": ["--stdio"]
      }
    }
  }
}

实验性功能

{
  "experimental": {
    "aggressive_truncation": true,
    "auto_resume": true
  }
}
  • aggressive_truncation — 更激进地截断上下文以保持在限制内
  • auto_resume — 从错误和上下文窗口限制自动恢复

完整配置示例

{
  // 代理模型
  "agents": {
    "sisyphus": {
      "model": "claude-opus-4-6",
      "temperature": 0.7
    },
    "hephaestus": {
      "model": "gpt-5.4"
    }
  },

  // 类别路由
  "categories": {
    "visual-engineering": { "model": "claude-opus-4-6" },
    "deep": { "model": "gpt-5.4" },
    "quick": { "model": "kimi-k2.5" },
    "ultrabrain": { "model": "gpt-5.4", "reasoning_effort": "xhigh" }
  },

  // 回退模型
  "fallback_models": {
    "default": ["claude-opus-4-6", "kimi-k2.5"]
  },

  // 技能
  "skills": {
    "playwright": { "enabled": true },
    "git-master": { "enabled": true },
    "frontend-ui-ux": { "enabled": true }
  },

  // Hooks
  "disabled_hooks": [],

  // 后台任务
  "background_tasks": {
    "max_concurrent": 5,
    "per_provider": {
      "anthropic": 3,
      "openai": 5
    }
  },

  // LSP
  "lsp": {
    "enabled": true
  },

  // 实验性
  "experimental": {
    "aggressive_truncation": true,
    "auto_resume": true
  }
}

验证

运行 doctor 来验证你的配置：

bunx oh-my-opencode doctor

它会检查插件注册、配置语法、模型可用性和环境设置。

后续步骤