快速开始

挑一个最贴近你的使用场景，下面会自动展开对应的完整步骤。如果不确定怎么选，留在 🖥️ 桌面 App · 本机一键这条路上 — 绝大多数新用户最快上手的姿势。

你打算怎么用 MIRA?

👆 点上面任意一张卡，下面会展开完整步骤。你的选择会记住在本浏览器里，下次刷新还在；URL 会带上 #scenario-xxx，方便分享。

版本提示（2026-10-12）：稳定版是引擎 0.3.4 / UI 0.4.4。本次新增的实验执行模式、额外输入路径、对话批量操作与引擎启停对应 引擎 0.3.5rc1 / UI 0.4.5rc1，均为预发布版。下文截图以当前源码界面为准；releases/latest 下载稳定版。更多见 本次更新。

通用前置

不管走哪条路，至少需要：

• macOS 12+ / Windows 10+ / Linux x86_64 一台
• 至少一种可用的模型接入：API key、支持的 OAuth 登录，或已运行的本地模型服务
• 想跑本地模型：先装好 Ollama 并 ollama pull qwen2.5:14b

---

Provider 高级配置文件参考

使用 MiraUI 时优先使用 模型供应商界面。以下示例仅用于纯 CLI、批量部署或界面未提供的字段。OAuth 凭据不能手写 API Key，应使用专用登录引导；完整 CLI 可运行 mira onboard --wizard。

选项 A：OpenRouter（最简单，一把钥匙调全家）

{
  "agents": {
    "defaults": {
      "provider": "openrouter",
      "model": "anthropic/claude-sonnet-4-5",
      "maxTokens": 8192,
      "temperature": 0.1,
      "maxToolIterations": 60
    }
  },
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-..."
    }
  }
}

选项 B：直接 OpenAI + Anthropic 双账号

{
  "agents": {
    "defaults": {
      "provider": "auto",
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "providers": {
    "openai":    { "apiKey": "sk-..." },
    "anthropic": { "apiKey": "sk-ant-..." }
  }
}

provider: "auto" 会按 model 字段自动匹配：anthropic/... → anthropic，openai/... → openai。

选项 C：OAuth（OpenAI Codex / GitHub Copilot）

OAuth provider 不在 config.json 里写 API key：

mira onboard --wizard
# 选择 openai-codex 或 github-copilot，按提示在浏览器登录

登录后 token 由专用 OAuth 状态目录托管。常见 agents.defaults 字段：

{
  "agents": {
    "defaults": {
      "provider": "openai_codex",
      "model": "openai-codex/gpt-5.3-codex"
    }
  }
}

选项 D：本地 Ollama（无需 API key）

先装 Ollama 并 ollama pull qwen2.5:14b，然后：

{
  "agents": {
    "defaults": {
      "provider": "ollama",
      "model": "qwen2.5:14b"
    }
  },
  "providers": {
    "ollama": {
      "apiBase": "http://localhost:11434"
    }
  }
}

完整 Provider / 模型 / 候选参数：Provider 与运行时参数、模型选择与候选回退。

下一步去哪

用得更顺手

• 核心概念 — 弄清楚 project / ModuleRun / experiment / Artifact 的边界。
• UI 功能总览 — 把每个面板的快捷键和按钮过一遍。
• 运行模式与 Profile — 区分 Profile、实验执行模式和模块衔接。

调优

• Provider 与运行时参数 — 切模型、调温度、改回合上限。
• 模型选择与候选回退 — 配置默认模型、候选与团队角色。
• Skills 与 Tools — 看看还有哪些 skill 可用，怎么挂自定义 MCP 工具。

扩展

• Channel 配置 — 把 Agent 接到飞书 / Slack / Telegram。
• 自托管部署 — 把后端搬到团队服务器。
• 本地服务（mira-engine） — 让引擎像系统服务一样常驻。

出问题了

• FAQ 与故障排查