Mercury Agent

项目简介

Mercury Agent 是开源、由 soul 驱动的 AI 智能体，作为本地后台服务运行。它把 Second Brain 记忆保存在磁盘上的 SQLite 中，在写入或执行命令前请求批准，并将同一智能体连接到终端、Web 仪表盘、Telegram、Discord、Slack 和 Signal。

核心功能

• 权限门控操作：读取无需提示；写入、Shell 命令、推送和范围变更需等待批准；Shell 阻止列表在任何模式下都会阻止 sudo 和 rm -rf / 等命令。
• Second Brain 记忆：本地 SQLite，支持 FTS5 全文搜索，包含 10 种记忆类型、自动提取、冲突消解、每小时整合以及 /memory 控制。
• 常驻运行时：mercury up 安装带开机启动和崩溃恢复的后台服务；支持定时计划、心跳检查、主动通知和持久任务队列。
• Mercury Code：面向仓库的编码环境，具备 AUTO 模式、实时计划清单、逐文件差异、工作区 IDE、后台子智能体，并在构建、测试或类型检查通过后确认完成。
• Mercury Bots：持久专家，拥有各自的人设、模型、记忆、权限和每日预算；机器人团队可委派任务并交付完成的文件。
• 多通道与模型灵活性：终端、Web 仪表盘、Telegram、Discord、Slack、Signal，以及 Anthropic、OpenAI、DeepSeek、Grok、Ollama 和 Mercury Cloud 等 10 多个模型提供商，支持自动回退。

适用场景

• 在仓库中使用 Mercury Code 重构代码、添加测试，并仅在类型检查或测试通过后才标记完成。
• 将 Mercury Chat 作为日常助手，从本地记忆回答，并使用约 50 个内置工具。
• 运行持久机器人或机器人团队，进行定时研究、写作并交付完成的文件。
• 在一个通道开始任务，并从另一个通道查看状态，例如从终端转到 Telegram。

快速开始

• 通过适用于 macOS 或 Linux 的一行安装器，或适用于 Windows 的 PowerShell 安装器安装；独立二进制路径不需要 Node.js。
• 或者在 Node.js 22 或更高版本上运行 npm i -g @cosmicstack/mercury-agent 安装。
• 运行 mercury 启动设置向导，填写你的名字、智能体名称、Mercury Cloud 或自己的 API 密钥，以及 Telegram 等可选通道。
• 运行 mercury up 安装并保持后台服务运行。
• 使用 mercury code . 在当前仓库打开 Mercury Code，使用 mercury doctor 更改提供商、密钥或通道，使用 mercury status 查看运行状态。

部署与要求

• Mercury Desktop 支持 macOS（Apple Silicon 和 Intel）、Windows 和 Linux；Mercury 运行时也支持独立二进制、通过 npm 在 Node.js 22+ 上运行、在 Android 上通过 Termux 运行，以及在任何云 VM 上运行。
• 独立安装器会下载适用于相应操作系统和 CPU 的二进制文件并校验其校验和；该路径不需要 Node.js。
• npm 安装需要 Node.js 22 或更高版本。
• Signal 支持使用 signal-cli；它可在 Linux 上原生运行，在 macOS 上需 Java 17+。
• Mercury Cloud 为可选项；本地运行使用 ~/.mercury 下的 SQLite 记忆，智能体不发送遥测数据。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。