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: activeapiKey 支持 ${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 Claude | Native SDK | Haiku 4.5 · Sonnet 4.6 · Opus 4.8 · Fable 5 |
| OpenAI | OpenAI Compat | GPT-5.5 · GPT-5.4 · GPT-5.3 Codex · GPT-6 Astra |
| Google Gemini | OpenAI Compat | 3.0 Flash · 3.0 Pro · 2.5 Pro |
| DeepSeek | OpenAI Compat | V4 Pro · V4 Flash |
| Kimi (月之暗面) | OpenAI Compat | Kimi Latest · Moonshot v1 (8K/32K/128K) |
| 豆包 (字节跳动) | OpenAI Compat | Seed 2.0 Pro/Code · 1.6 Flash |
| 腾讯混元 | OpenAI Compat | 2.0 Think · T1 Vision · Hy3 Preview |
| 通义千问 | OpenAI Compat | Qwen Max · Qwen Plus |
| MiniMax 国内 | OpenAI Compat | M2.7 · M2 · Text 01 |
| MiniMax 国际 | OpenAI Compat | M2.7 · M2 · Text 01 |
| Ollama 本地 | OpenAI Compat | 任意本地模型(自动发现) |
| MiphamAI | OpenAI Compat | om-V5-Flash · Pro · Visual · Apex |
资源链接
开始使用
安装只需一条命令,启动后交互式向导引导配置。
npm install -g @miphamai/cli && mipham