快速开始

桌面版

内置独立运行时与 Metis CLI / Server，无需另行安装 Node.js：

• macOS（Apple 芯片）：从最新 GitHub Release 下载 Metis-*-macos-arm64.dmg，将 Metis.app 拖入应用程序。
• Windows（x64）：从最新 GitHub Release 下载 Metis-*-win-x64-setup.exe 安装包或 .zip 解压使用。

需要 Node.js >=22.19.0。

npm install -g @wholiver_hu/metis
metis

在任意项目目录中直接运行：

metis "解释这个代码仓库"
metis @src/main.ts "检查这个文件"
git diff | metis -p "审查这个 diff"

支持的订阅 Provider 可通过 /login 登录，也可配置 API Key。完整使用指南见快速入门。

基准评测与主流 Agent 对比

Terminal-Bench 2.1 实测对比

在相同模型（DeepSeek V4 Flash）、相同 89 个真实编程任务、相同成本预算与执行环境下进行严格对比测试：

| Agent 框架 | 评测模型 | 评测基准 | 解决率 (准确率) | 架构与 Harness 核心优势 | | :--- | :--- | :--- | :---: | :--- | | 🏆 Metis | DeepSeek V4 Flash | Terminal-Bench 2.1 (89 任务) | 73 / 89 (82.02%) | ✅ 递归 5 角色多智能体 + SQLite 持久记忆 + Plan/Build 分离 | | OpenCode | DeepSeek V4 Flash | Terminal-Bench 2.1 (89 任务) | 60 / 89 (67.42%) | ⚠️ 单线程扁平工具执行流 | | 📈 提升幅度 | 同等模型与预算 | 完全一致的执行环境 | +14.6% (+13 项任务) | 🚀 纯 Agent Harness、记忆与验证门禁带来的性能跃升 |

全维度特性对比矩阵

| 核心能力 | Metis | Claude Code | OpenCode | Cursor / Cline | | :--- | :---: | :---: | :---: | :---: | | 开源许可与费用 | ✅ MIT ($0 免费) | ❌ 闭源商业 | ✅ MIT ($0 免费) | ⚠️ 商业增值 | | 模型生态自由度 | ✅ 任意模型 / OrcaRouter | ❌ 仅限 Anthropic | ✅ 多 Provider | ⚠️ 受限 / BYOK | | 客户端界面 | ✅ 终端 TUI + React 桌面端 | ⚠️ 仅终端 | ⚠️ 仅终端 | ⚠️ 仅 IDE 插件 | | 工作流控制 | ✅ Plan 规划 ↔ Build 构建 | ⚠️ 单一线性流 | ⚠️ 单一线性流 | ⚠️ 对话/行内 | | 多智能体架构 | ✅ 递归 L0→L4 (5 具名角色) | ⚠️ 扁平子 Agent | ⚠️ 基础支持 | ❌ 无 | | 持久记忆系统 | ✅ SQLite 状态 + 向量检索 | ❌ 临时上下文 | ❌ 临时上下文 | ⚠️ 代码 Embeddings | | 验证与证据门禁 | ✅ 测试门禁 + 视频证据 | ⚠️ 手工 Bash | ⚠️ 手工 Bash | ⚠️ 基础 Linter | | 无头基准评测 | ✅ Python 适配器 + 全链路 Trace | ❌ 无原生适配 | ⚠️ 部分支持 | ❌ 无 |

核心特性

• Plan 与 Build 双工作流 — 在只读 Plan 模式中安全调查并生成方案；在 Build 模式下按已确认方案与动态清单可靠执行。
• 终端 TUI 与桌面端双界面 — 既可在终端使用交互式全功能 TUI，也可在 macOS 和 Windows 上使用基于 React/Vite 的可视化桌面工作区。
• 原生命名递归多智能体体系 — 内置具名 Agent 角色（coordinator、planner、implementer、reviewer、verifier），支持 L0→L4 递归委派与 Git Worktree 隔离。
• 持久记忆与会话恢复 — 跨重载、上下文压缩与分支操作，在 SQLite 中持久保留项目经验与决策结论。
• 全模型自由与高可扩展性 — 支持 OpenAI、Anthropic、DeepSeek、OrcaRouter、Gemini、Groq、Ollama 等任意端点，支持 TypeScript 插件、Agent Skills 与 MCP。
• 评测级可靠性与验证门禁 — 自动化验证检查、视频证据分析，全面适配 Terminal-Bench 2.1 与 Harbor 自动化评测。

文档

| 主题 | 指南 | | --- | --- | | 安装、认证与首次运行 | 快速入门 | | 命令与终端界面 | 使用 Metis · TUI | | Provider 与自定义模型 | Providers · Custom models · Custom providers | | 具名多智能体体系 | 多智能体与递归委派 | | 基准评测与无头模式 | TerminalBench 与 Harbor 适配 | | 会话与上下文压缩 | Sessions · Compaction | | Extensions、Skills 与 Packages | Extensions · Skills · Packages | | Prompt 与界面定制 | Prompt templates · Themes · Keybindings | | 程序化集成 | SDK · RPC · JSON | | 视频检查 | Video tool | | 安全与配置 | Security · Settings | | 平台与隔离 | Windows · Termux · tmux · Containers |

全部指南见文档索引。

npm run build                 # 编译 TypeScript 并复制运行时资源
npm test                      # 运行 Vitest 测试套件
npm run clean                 # 删除编译输出
npm run build:binary          # 构建独立二进制文件
npm --prefix desktop run dev  # 启动 React/Vite Desktop 开发环境
npm --prefix desktop run build # 构建 Renderer 与 Electron Artifact

软件包从 @wholiver_hu/metis 导出 Node.js SDK，并从 @wholiver_hu/metis/rpc-entry 导出 RPC 入口。

参与贡献

欢迎参与 Metis 开发。开发流程、Extension 与 Package 接入、测试及 AI 辅助贡献说明见 CONTRIBUTING.zh-CN.md。

许可证

本项目使用 MIT License。