有「灵魂」的 AI 助手——Mercury Agent

一个跑在你本机、记得你、懂你、还会在做危险操作前先问你的开源 AI Agent

项目地址：https://github.com/cosmicstack-labs/mercury-agent

大多数 AI Agent 的问题不是”不够聪明”，而是”不够可信可控”——它不记得你是谁，不知道边界在哪，一旦给它权限就可能做出你不期待的事。Mercury Agent试图从根本上解决这件事。

它是什么

Mercury Agent 是一个以”灵魂”为核心设计理念的开源 AI Agent，基于 TypeScript + Node.js 构建，可通过 CLI 或 Telegram 在你的本地机器上 7×24 小时后台运行。

它的与众不同之处在于：它有记忆，有人格，有边界感，还有兜底方案——用了哪个 LLM 不重要，挂了自动换下一个。

# 一行命令，立即启动npx @cosmicstack/mercury-agent# 或全局安装后使用npm i -g @cosmicstack/mercury-agentmercury up

七个让它与众不同的特性

1. 权限优先设计：Shell 命令有阻止列表，文件读写受目录作用域限制，危险操作进入待审批流程，不会悄悄替你做你没想清楚的事。

2. Second Brain 记忆：基于 SQLite + FTS5 的结构化持久记忆，每轮对话自动提取事实，下次再聊它还记得你是谁、你在做什么项目、你有什么偏好。

3. 灵魂驱动人格：人格由你本地的 Markdown 文件定义，包括 soul.md、persona.md、taste.md、heartbeat.md，真正属于你的 AI 助手。

4. Token 预算管理：内置每日 Token 预算，超阈值后自动切换简洁回复模式，还支持 /budget查看、重置和临时覆盖，用得明白，花得清楚。

5. 实时流式输出：CLI 支持实时 Token 流和 Markdown 重渲染，Telegram 支持可编辑状态消息，用起来流畅自然。

6. 守护进程 + 自愈：可作为后台守护进程运行，崩溃后自动重启，支持开机自启和定时任务，macOS、Linux、Windows 全覆盖。

7. 多模型兜底：配置多个 LLM 提供商，主力挂了自动切备用，再也不怕某家 API 抽风影响工作流。

Second Brain 记忆系统详解

这是 Mercury 最有意思的部分。它不是简单地把对话塞进上下文窗口，而是构建了一套真正的”第二大脑”。

10 种记忆类型：

身份（identity）、偏好（preference）、目标（goal）、项目（project）、习惯（habit）、决策（decision）、约束（constraint）、关系（relationship）、事件（episode）、反思（reflection）

自动提取：每轮对话后提取 0–3 条事实，记录置信度、重要性和持久性权重。

相关召回：每次提问前注入最相关的前 5 条记忆，默认 900 字符预算，不会撑爆上下文。

冲突处理：按置信度和时间新旧处理互相矛盾的记忆，不会让旧认知干扰新理解。

自动整理：每 60 分钟生成个人资料摘要和反思，低价值记忆自动衰减过期。

本地存储，零上传：所有数据存在 ~/.mercury/memory/，不经过任何云端，隐私完全在自己手里。

三步快速上手

第一步：安装并启动运行 npx @cosmicstack/mercury-agent，首次运行会启动配置向导。

第二步：完成配置向导输入你的名字、选择模型提供商和 API Key。

第三步：以守护进程方式持续运行执行 mercury up，安装系统服务，Mercury 从此开机自启、后台常驻、崩溃自愈。

mercury up        # 推荐：安装服务并启动mercury status    # 查看运行状态mercury logs      # 查看近期日志mercury restart   # 重启进程

如果你需要一个支持本地文件操作、命令执行、长期记忆、定时任务和多模型兜底的个人 AI 助手，Mercury Agent 可能是目前开源生态里设计最完整的选项之一。

它不追求把 AI 做成一个黑盒——你可以看到它在干什么，控制它能做什么，甚至通过编辑 Markdown 文件来定义它是谁。这正是它叫做”有灵魂”的 Agent 的原因。

✨ 有任何问题欢迎随时联系缪斯