Mercury Agent

具备权限强化工具、代币预算管理及多通道访问的“灵魂驱动”型 AI Agent。

能够记住重要信息。在执行操作前进行确认。支持通过 CLI、Telegram 或 Web 7x24 小时全天候运行。内置 31 种工具、看板（Kanban）、可扩展技能，以及基于 SQLite 的“第二大脑”记忆系统。

🔖 当前稳定版：v1.1.9

English | 简体中文

---

快速开始

一行代码安装（无需 Node.js） — 为您的操作系统下载最新的独立二进制文件：

# macOS / Linux
curl -fsSL https://mercuryagent.sh/install.sh | sh

# Windows
irm https://mercuryagent.sh/install.ps1 | iex

如果您已安装 Node.js 20+，也可以通过 npm 安装：

npx @cosmicstack/mercury-agent

或者全局安装 npm 包：

npm i -g @cosmicstack/mercury-agent
mercury

首次运行将触发设置向导（包括名称、模型提供商、可选的 Telegram 设置）。配置完成后，Mercury 会打开 Ink TUI 启动界面，并在聊天开始前询问您的权限模式（“询问我”或“全部允许”）。

后续如需重新配置（更改密钥、名称、设置）：

mercury doctor
mercury doctor --platform

为什么选择 Mercury？

每个 AI Agent 都能读取文件、运行命令和抓取 URL。但大多数 Agent 执行时悄无声息。Mercury 会先行询问，并记住重要事项。

• 权限强化 — 包含 Shell 黑名单（永远不会执行 sudo、rm -rf / 等命令）。支持文件夹级别的读写范围控制。具备待审批流程。支持按会话设定“询问我”或“全部允许”。绝无意外操作。
• 第二大脑 — 持久化、结构化的记忆存储，基于 SQLite + FTS5 全文搜索。支持 10 种记忆类型、自动提取、冲突解决和自动整合。Mercury 会在无需手动录入的情况下学习您的偏好、目标和习惯。
• 灵魂驱动 — 个性由您拥有的 Markdown 文件定义（soul.md、persona.md、taste.md、heartbeat.md）。拒绝千篇一律的官方模板。
• 代币感知 — 强制执行每日代币预算。当使用量超过 70% 时自动精简内容。支持通过 /budget 命令查看、重置或覆盖限额。
• 实时流式传输 — 在 CLI 上支持实时代币流式输出，带有光标保存/恢复和 Markdown 重新渲染功能。Telegram 端支持可编辑的状态消息。
• 全天候运行 — 可作为后台守护进程在任何操作系统上运行。支持崩溃自动重启、开机自启、Cron 定时任务、心跳监控以及主动通知。
• 可扩展性 — 通过单条命令即可安装社区技能。可将技能调度为定期任务。基于 Agent Skills 规范构建。

Mercury 现在会在首次运行时，于 ~/.mercury/skills/web-search/SKILL.md 中自动配置默认的 web-search 技能。

守护进程模式 (Daemon Mode)

一条命令让 Mercury 持续运行：

mercury up

此命令会安装系统服务（如果尚未安装）、启动后台守护进程，并确保 Mercury 正在运行。建议将其作为您的首选命令。

如果 Mercury 已经在运行，mercury up 将仅确认状态并显示 PID。

其他守护进程命令

mercury restart      # 重启后台进程
mercury stop         # 停止后台进程
mercury start -d     # 在后台启动（不安装服务）
mercury logs         # 查看最近的守护进程日志
mercury status       # 显示守护进程运行状态

守护进程模式内置了崩溃恢复机制——如果进程崩溃，它会自动以指数退避策略进行重启（每分钟最多重启 10 次）。

系统服务（开机自启）

mercury up 会自动安装服务。您也可以手动管理：

mercury service install

平台	方式	需要管理员权限
macOS	LaunchAgent (~/Library/LaunchAgents/)	否
Linux	systemd user unit (~/.config/systemd/user/)	否 (需 linger 支持以实现开机自启)
Windows	任务计划程序 (schtasks)	否

mercury service status     # 检查服务运行状态
mercury service uninstall  # 卸载系统服务

在守护进程模式下，Telegram 成为您的主要交互渠道——因为没有终端用于输入，CLI 仅作为日志查看工具。

CLI 命令

命令	描述
mercury up	推荐。 安装服务 + 启动守护进程 + 确保运行
mercury	启动 Agent（同 mercury start）
mercury start	在前台启动
mercury start -d	在后台启动（守护进程模式）
mercury restart	重启后台进程
mercury stop	停止后台进程
mercury logs	查看最近的守护进程日志
mercury doctor	重新配置设置（名称、提供商、通道、权限默认值）
mercury doctor --platform	显示跨平台终端/守护进程兼容性诊断
mercury setup	重新运行设置向导
mercury status	显示配置和守护进程状态
mercury help	显示完整手册
mercury upgrade	升级到最新版本
mercury telegram list	列出已批准和待审批的 Telegram 用户
mercury telegram approve	批准配对码或待审批请求