华安麦逄

MiphamAI · 开源核心

Mipham Code

多模型开源智能编程终端。AI 辅助代码生成、安全审计、MCP 协议集成、可扩展技能系统——统一于一个终端应用中。

国际站: mipham.ai/mipham-code  |  国内站: onemipham.com/mipham-code

安装方式

npm downloads

四种方式,任选其一。

⚠️ 从 0.85.0 及更早版本升级:请先别用 mipham update

0.84.0 及更早版本给安装步骤挂了 10 分钟超时,而包有 84 MB / 6,601 个文件 —— 慢网络(国内直连 npm 常常超过 10 分钟)下,计时器会在安装中途杀掉 npm,留下「旧版本已删、新版本没写完」:机器上连一个 mipham 都没有,连你用来重试的 mipham update 也一起没了(/upgrade 同理)。

0.85.0 修掉了那条超时路径(装前快照、装后实跑 launcher 自证、失败自动回滚),但它的回滚跑在CLI 进程里 —— 终端按 Ctrl-C 时信号发给整个前台进程组,CLI 与 npm 一起死,回滚没机会执行 ⇒ 半截树、而且这次没有人回滚。所以 0.85.0 自己也不适合用来自助升级。

请改用下面任一安装命令升级 —— 由 npm 直接在你的终端里执行,不设超时,装得再慢也不会被砍:

npm install -g @miphamai/cli

或重跑一遍上面的安装脚本(同样安全)。升到 0.85.1 后 mipham update 可正常使用(不再带超时;装前快照、装后实跑 launcher 自证、失败自动回滚;安装窗口内按 Ctrl-C 也不会再打断安装 —— 该窗口内 Ctrl-C 会被忽略,要中断请另开一个终端杀进程)。

npm(推荐)

npm install -g @miphamai/cli

curl(macOS / Linux)

curl -fsSL https://onemipham.com/install.sh | bash

中国大陆访问更快。国际用户请用 mipham.ai/install.sh

PowerShell(Windows)

irm https://onemipham.com/install.ps1 | iex

直接下载

macOS / Linux / Windows 二进制文件请访问 GitHub Releases (v0.85.13)

macOS 应用(.dmg)

原生应用包请访问 GitHub Releases(mipham-code-*.dmg)

JetBrains IDE

从 JetBrains Marketplace 安装(或从 GitHub Releases 下载插件 zip 手动安装)。

VS Code

从 Visual Studio Marketplace 安装 Mipham Code 扩展。

需要 Bun 1.2+ 或 Node.js 22+。安装后输入 mipham 即可启动。

快速配置

安装后配置 API Key 即可使用。支持 12 家模型供应商——Anthropic、OpenAI、DeepSeek、Kimi、Google Gemini、豆包、腾讯混元、通义千问、MiniMax 国内、MiniMax 国际、Ollama 本地、MiphamAI。

1. 设置环境变量

以 DeepSeek 为例,在终端执行(或加入 ~/.zshrc 永久生效):

export DEEPSEEK_API_KEY="sk-你的密钥"

2. 配置文件 ~/.mipham/config.yml

可选 —— 不写此文件也能用内置默认配置,安装向导也会代为生成。手动编写可固定默认模型或覆盖供应商。以下列出 12 家内置供应商中的 5 家,外加一个自定义供应商示例:

# 默认模型(启动时自动使用)
defaultProvider: deepseek
defaultModel: deepseek-v4-pro

providers:
  # 内置供应商:只需 `id` + `apiKey`,下方其余字段均为可选覆盖。
  # 省略 `models:` 会保留全部内置模型 —— 一旦列出 models,内置列表会被整表替换。
  - id: deepseek
    name: DeepSeek
    protocol: openai-compatible
    baseUrl: https://api.deepseek.com/v1
    apiKey: ${DEEPSEEK_API_KEY}

  - id: doubao
    name: 豆包 (字节跳动)
    protocol: openai-compatible
    baseUrl: https://ark.cn-beijing.volces.com/api/v3
    apiKey: ${DOUBAO_API_KEY}

  - id: qwen
    name: 通义千问
    protocol: openai-compatible
    baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1
    apiKey: ${QWEN_API_KEY}

  - id: anthropic
    name: Anthropic Claude
    protocol: anthropic
    apiKey: ${ANTHROPIC_API_KEY}

  - id: openai
    name: OpenAI
    protocol: openai-compatible
    baseUrl: https://api.openai.com/v1
    apiKey: ${OPENAI_API_KEY}

  # 自定义供应商(非内置):需自行声明 models,每个 model 的字段都是必填。
  - id: my-gateway
    name: My Gateway
    protocol: openai-compatible
    baseUrl: https://gateway.example.com/v1
    apiKey: ${MY_GATEWAY_API_KEY}
    models:
      - id: my-model-pro
        name: My Model Pro
        providerId: my-gateway
        contextWindow: 200000
        maxOutput: 64000
        vision: true
        status: active

apiKey 支持 ${ENV_VAR}(推荐)或直接填写密钥字符串。

3. 启动

mipham

启动后按 Ctrl+P 可随时切换模型供应商和模型。

核心特性

12 家 AI 模型

Anthropic Claude · OpenAI GPT · DeepSeek · Kimi · Google Gemini · 豆包 · 腾讯混元 · 通义千问 · MiniMax 国内 · MiniMax 国际 · Ollama 本地 · MiphamAI

138 条斜杠命令

完整 Claude Code 对标: /commit, /pr, /simplify, /lint, /loop init, /browse-plugins — 零学习成本

插件市场

/install-plugin, /browse-plugins — 从 npm 或本地安装。社区注册表含 NotebookLM MCP 集成

LoopKit 脚手架

/loop init 一键生成项目结构 — .mipham/ 配置、hooks、agents、9 领域 skills、.mcp.json

MCP 协议

完整 JSON-RPC 2.0 stdio 传输 + .mcp.json 配置。可连接 NotebookLM, filesystem, GitHub 等

28 个内置技能

22 个标准 + 6 个 Mipham 专有技能,双轨运行时。社区技能市场一键安装

安全加固

路径沙箱 · SSRF 防护 · Bash 命令黑名单 · 权限门控 · 参数校验——五重防御

跨平台

macOS · Linux · Windows,npm / curl / PowerShell / 直接下载四种安装方式

公开基准

两条公开基准各跑一轮 10 题(k=1)。下面的分数是基准 harness 报的官方分数,不是我们算的。跑的是什么、已知限制与复现命令见 benchmarks/README.md,逐条核对与成绩来源见 benchmarks/results/README.md。

Terminal-Bench

terminal-bench@2.0 · 10 题 · k=1

完成题数 4 / 8:harbor 建了 10 个 trial,8 题跑到了 agent 结果(4 题 done、4 题 deadline_exceeded),另 2 题没有结果文件。

官方分数 Mean: 0.000:8 题 reward 全为 0.0。

单题原始读数(分数不在此文件): benchmarks/results/phase1-terminal-bench.json

SWE-bench Verified

swebench-verified@1.0 · 10 题(10 个不同仓库)· k=1

完成题数 9 / 10:harbor 建了 10 个 trial,9 题跑到了 agent 结果,第 10 题在 agent 安装阶段因网络故障中断 —— 不是答错。

官方分数 Mean: 0.900:分母是 10(harbor 的 9 个 trial 加 1 个出错 trial,出错那一题按 0 分并入),9 题 reward 全为 1.0。

单题原始读数(分数不在此文件): benchmarks/results/phase2-swebench-verified.json

技术架构

Bun + React/Ink CLI · Next.js 15 Web · TypeScript Strict · pnpm Monorepo · 138 命令 · 3879 测试

Provider 层:Anthropic 原生 SDK + OpenAI Compat × 11 统一接口 · SSE 流式响应 · 工具调用编排

模型供应商

供应商协议代表模型
Anthropic ClaudeNative SDKHaiku 4.5 · Sonnet 4.6 · Opus 4.8 · Fable 5
OpenAIOpenAI CompatGPT-5.5 · GPT-5.4 · GPT-5.3 Codex · GPT-6 Astra
Google GeminiOpenAI Compat3.0 Flash · 3.0 Pro · 2.5 Pro
DeepSeekOpenAI CompatV4 Pro · V4 Flash
Kimi (月之暗面)OpenAI CompatKimi Latest · Moonshot v1 (8K/32K/128K)
豆包 (字节跳动)OpenAI CompatSeed 2.0 Pro/Code · 1.6 Flash
腾讯混元OpenAI Compat2.0 Think · T1 Vision · Hy3 Preview
通义千问OpenAI CompatQwen Max · Qwen Plus
MiniMax 国内OpenAI CompatM2.7 · M2 · Text 01
MiniMax 国际OpenAI CompatM2.7 · M2 · Text 01
Ollama 本地OpenAI Compat任意本地模型(自动发现)
MiphamAIOpenAI Compatom-V5-Flash · Pro · Visual · Apex

资源链接

开始使用

安装只需一条命令,启动后交互式向导引导配置。

npm install -g @miphamai/cli && mipham