FollowAgents AI AGENTS 目录
首页 / 全部 Agents / Mercury
效率与协作 cli-automationtelegram-botsqlite-memorykanban-boardspermission-controlstask-schedulingskill-registry

Mercury

可在命令行、Telegram 和本地网页中长期运行的权限优先个人助手。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
cosmicstack-labs/mercury-agent
Star 数
★ 3.9k
最近更新
今天
License
MIT
主语言
TypeScript
FA 评分
66/100 · 存在缺口

30 秒速览

运行形态
命令行工具聊天机器人网页应用
可在哪里用
通用 · 跨平台OpenAI API · Claude API
费用
软件免费，模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
用于 npm 安装或源码构建的 Node.js 20+LLM 提供商的 API 密钥，Ollama Local 除外Shell / 命令行网络访问本地文件系统
典型场景
需要在本机终端中让助手读取项目文件、执行受审批的命令并协助 Git 操作的独立开发者。
不适合
  • 不愿自行管理模型密钥与本地权限配置的个人
  • 需要群聊或多人群协作的 Telegram 用户（仅支持私聊）
源码审查
66/100 · 存在缺口

这个 Agent 能做什么，适合哪些场景？

Mercury 是一个以 TypeScript 和 Node.js 构建的本地运行 AI 助手，提供 CLI、Telegram 机器人和本机 Web Dashboard 三种入口。它通过 31 个内置工具处理文件、Shell、Git、网页访问、消息发送、技能、定时任务和预算查询，并以审批流程和目录作用域限制外部操作。其 Second Brain 使用 SQLite、FTS5 与 JSONL 保存和检索对话记忆；Web Dashboard 还提供看板、工作区 IDE、流式聊天和管理界面。它可前台运行，也可作为后台守护进程和系统服务启动，并支持 DeepSeek、OpenAI、Anthropic、Grok、Ollama Cloud 与 Ollama Local 的按序故障切换。适合希望自托管、跨终端和 Telegram 持续使用助手，同时愿意配置模型凭据与本地权限策略的个人或小团队。

首次运行时，Mercury 的设置向导会要求配置名称、模型提供商以及可选的 Telegram。对话中，代理可调用 read_file、write_file、edit_file、run_command、Git 工具和 fetch_url；涉及文件、Shell、网络或 Git 的操作按权限模式进入审批或作用域控制。它会在每轮对话前从 Second Brain 检索匹配记忆，并在对话后自动提取部分事实；记忆存放在 ~/.mercury/memory/second-brain/second-brain.db，使用 SQLite 与 FTS5。schedule_task 可保存一次性或 cron 定时任务到 ~/.mercury/schedules.yaml，任务结果回传到创建任务的频道；看板卡片可按依赖顺序执行并记录结果评论。mercury up 会安装并启动相应的用户级系统服务，后台模式具备 PID 管理和崩溃后的指数退避重启。

  1. 需要在本机终端中让助手读取项目文件、执行受审批的命令并协助 Git 操作的独立开发者。
  2. 希望通过 Telegram 私聊向长期运行助手提交请求，并由管理员控制成员访问的个人或小团队。
  3. 需要把偏好、目标、项目和决策保存在本机 SQLite 记忆库，并在后续对话中自动召回的知识工作者。
  4. 希望在本地 Web Dashboard 创建看板卡片、跟踪待办和依赖，并让代理顺序处理卡片的项目负责人。
  5. 需要每天定时执行提示或检查任务，并让结果返回到原始 CLI、Web 或 Telegram 频道的用户。

如何安装或部署这个 Agent？

无需 Node.js 的 macOS/Linux 安装：curl -fsSL https://mercuryagent.sh/install.sh | sh。Windows：irm https://mercuryagent.sh/install.ps1 | iex。若已安装 Node.js 20+，可直接运行 npx @cosmicstack/mercury-agent，或执行 npm i -g @cosmicstack/mercury-agent 后运行 mercury。首次启动会进入设置向导；选择并配置提供商所需的 API 密钥（Ollama Local 不需要密钥），再选择 Ask Me 或 Allow All 权限模式。

如何使用这个 Agent？

完成向导后运行 mercury 在前台聊天，或运行 mercury up 安装用户级服务并保持后台运行。使用 mercury doctor 重新配置提供商、频道和默认权限；启用 Web 后访问 http://127.0.0.1:6174。聊天中可用 /permissions 切换会话权限模式、/budget 查看预算、/memory 管理记忆、/tasks 查看定时任务；Telegram 首次配对时向机器人发送 /start，再用 mercury telegram approve <code> 批准配对码。

这个 Agent 有哪些优点和局限？

优点
  • 文件、Shell、网络和 Git 操作有明确的审批流程、Shell 禁止列表与文件夹级读写作用域，而非默认静默执行。
  • Second Brain 将结构化记忆、全文检索、冲突处理和自动整合放在本机 SQLite/FTS5 数据库中。
  • 同一代理覆盖 Ink CLI、Telegram 和 localhost Web Dashboard，并可作为 macOS LaunchAgent、Linux systemd 用户服务或 Windows 计划任务长期运行。
  • 内置定时任务、看板执行和社区技能安装，适合把对话延伸为持续的本地自动化。
局限
  • 需要自行配置模型提供商；除 Ollama Local 外，已列出的提供商都需要 API 密钥，费用由所选提供商决定。
  • npm 安装和源码构建要求 Node.js 20+；构建独立二进制还要求 Bun 1.3+。
  • 后台模式下 CLI 仅用于日志，交互主要依赖 Telegram；Telegram 只处理私聊并需要管理员审批配对。
  • Web Dashboard 默认凭据为 mercury / Mercury@123，且虽默认仅绑定 localhost，采用前仍应完成自身的访问配置与安全评估。

这个 Agent 与同类方案有什么区别？

Mercury 不绑定单一模型提供商：可按配置顺序在 DeepSeek、OpenAI、Anthropic、Grok、Ollama Cloud 和 Ollama Local 之间故障切换。与只面向云端聊天的部署方式相比，它将配置、记忆、计划和看板数据保存在 ~/.mercury/ 本机目录，并提供用户级后台服务。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Mercury 当前 66 · 存在缺口 命令行工具免费 + 模型费 ★ 3.9k 今天 TypeScript OpenAI API · Claude API
Waku 65 · 存在缺口 命令行工具免费 + 模型费 ★ 2.2k 27 天前 Python OpenAI API · Claude API
Ankita 桌面 AI 工作台 69 · 存在缺口 桌面应用免费 + 模型费 ★ 15 7 天前 JavaScript ChatGPT · OpenAI API
Iva 个人助理 72 · 存在缺口 聊天机器人免费 + 模型费 ★ 289 5 天前 TypeScript ChatGPT · Codex

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1
存在缺口
66/ 100 五分制 3.3 / 5
信任安全 16/29
可靠稳定 8/14
适用触发 14/18
规范维护 14/18
有效结果 9/13
证据核验 5/8
查看各维度的扣分理由
信任安全16 / 29 · 2.8/5

文档描述了按路径、通道和角色划分的文件权限、命令阻止及审批、SSRF 防护、密钥日志脱敏、子代理权限继承约束；安全策略还明确指出定时任务以 Allow All 运行且权限代码缺少逐项访问审计，因此最小权限、审批和数据流透明度未达到全面水平。密钥存于本机配置目录，但未见更完整的秘密生命周期说明。依赖清单及 CI 存在，却没有本材料中的依赖漏洞监控或缓解证据。支持 git push、消息发送、技能安装等外部副作用，审批有所覆盖但 Allow All 可绕过提示；提供 git undo 和卸载命令，但未说明一般操作的恢复机制。作者与安全联系渠道可见，发布者身份仍未验证，故来源归属有限。

可靠稳定8 / 14 · 2.9/5

CI 配置覆盖多平台类型检查、测试、打包和二进制冒烟流程，但这些是配置证据，并非本次执行结果。README 将 Ask Me 与 Allow All 描述为可选模式，安全策略进一步揭示定时任务固定使用 Allow All，说明安全叙述存在需要用户理解的例外。提供自动故障恢复、提供商回退、doctor 和故障软化指导；不过没有运行结果可证明实际可用性，某些提供商或渠道依赖外部服务。

适用触发14 / 18 · 3.9/5

材料清楚说明个人终端使用、代码协作、后台机器人、团队频道和多种运行环境，适用场景覆盖充分。权限、预算、渠道角色和技能机制给出一定边界；但 Allow All、无人值守定时任务及未审计技能带来重要边界例外。配置了多渠道、提供商和本地模型，安装说明覆盖 macOS、Linux、Windows 与 Termux；环境依赖和平台限制仍需查阅外部文档。

规范维护14 / 18 · 3.9/5

README 按快速开始、功能、安全、参考和文档组织，命令与配置路径示例具体。安装和源码构建说明包含 Node.js 版本、安装器、升级、二进制构建及未签名提示。MIT 许可证文本明确。版本号与安全支持版本可见，README 链接变更日志，但本材料没有变更日志正文，无法充分评估版本历史与命名稳定性。安全策略给出漏洞报告渠道、支持期限和已知边界；维护责任人及后续更新路径有一定说明，但发布者未经验证，仍不能确认其身份。

有效结果9 / 13 · 3.5/5

统一运行时、多渠道共享记忆、预算、权限及机器人编排可能减少重复操作，并提供可读状态、计划、文件投递和管理命令。README 描述这些能力与具体工作流，但没有本材料中的使用结果或成本数据，因此效用和维护成本只能部分判断。后台任务和技能扩展提升覆盖面，同时增加审查和治理负担。

证据核验5 / 8 · 3.1/5

README 的功能主张可与 package 元数据、入口模块、渠道和能力导出、安全策略及 CI 配置部分对照；安全策略还明确列出未解决的审计缺口与定时任务例外。由于只提供部分源码，权限实现细节不能在本材料中逐项复核，且 CI 文件不能证明构建或测试已经通过。文档区分了当前行为与已知限制，但许多产品能力仍主要是文档陈述，未提供对应实现或结果证据。

风险与缓解建议
  • 安全策略明确指出定时任务以 Allow All 运行，且权限代码没有逐项访问审计；无人值守任务应按这一已记录的限制评估。
  • Allow All 会跳过普通审批提示；社区技能标注为未经审计，安装前应阅读并谨慎限定其权限。
  • 本评估仅基于提供的静态文件样本，未执行程序、测试或核实发布者身份。
证据充分度：低 评估于 2026年11月8日 审查版本 de0aee2a66fb 评估后仓库已有新提交，评分可能未覆盖最新改动
评估证据 README.mdblog/agent-permissions-least-privilege.mdsrc/index.tscapabilities/index.tschannels/index.tsLICENSESECURITY.mdpackage.jsonworkflows/ci.ymlworkflows/desktop-release.yml
查看完整评分方法 →
你是这个项目的维护者？把 FARS 徽章加到 README

徽章显示当前的评审分数和结论，点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/mercury-agent.svg?lang=zh)](https://followagents.com/zh/agents/mercury-agent)
<a href="https://followagents.com/zh/agents/mercury-agent"><img src="https://followagents.com/badge/mercury-agent.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

  1. v1.5.1 Mercury v1.5.1
    发布说明摘录
    ☿ Mercury Agent v1.5.1 Reading aloud and voice typing now use the voice you chose, Gemini included, and the Optimus update button tells you what it did. Speech - Your voice choice counts everywhere. Reading a reply aloud, voice typing and voice notes from Telegram or WhatsApp use the voice service chosen in Settings → Voice when it has a key. A fresh install with only a Gemini key no longer asks for an OpenAI key. …
    在 GitHub 查看 ↗
  2. optimus-v0.5.1 Optimus 0.5.1 (plugin update)
    发布说明摘录
    Plugin-only update. Install or update with /plugins update optimus, or Plugins → Optimus → Update in Mercury Desktop. Mercury itself is unchanged; works with Mercury 1.3.9 and newer. - Microphone & permissions on every OS. Mercury Desktop's Optimus page shows the microphone, Accessibility and Screen Recording state at the top, with a microphone picker, a live voice-level test and an off switch. - Checks the microphone before a voice session, so a blocked microphone says so instead of a silent session. The macOS permissions check now includes the microphone. …
    在 GitHub 查看 ↗
  3. v1.5.0 Mercury v1.5.0
    发布说明摘录
    ☿ Mercury Agent v1.5.0: Mercury Desktop Mercury now has a desktop app for macOS, Windows and Linux. It runs Mercury on your computer or connects to Mercury on a server, keeps itself and your servers up to date, and asks you before anyone new gets in. Mercury Desktop (new) - One app for chat, code, bots and research. It installs and starts Mercury on this computer for you, or connects to any number of Mercury servers and switches between them from the top bar. …
    在 GitHub 查看 ↗

常见问题

它是否会在未经同意时执行命令或修改文件？
默认可选 Ask Me 或 Allow All 会话模式；文档说明文件、Shell、网络和 Git 操作受权限系统、待审批流程及目录作用域控制，且 Shell 禁止列表中的命令不会执行。
使用成本是什么？
Mercury 提供每日 token 预算、70% 后自动简洁模式和 /budget 控制；模型 API 成本取决于所配置的提供商。Ollama Local 文档标注为无需 API 密钥。
模型提供商发生故障会怎样？
Mercury 按配置顺序尝试提供商，并在失败时切换到下一个；它会记住上次成功的提供商，并在下次请求时优先使用。
数据存在哪里？
运行数据位于 ~/.mercury/；Second Brain 数据库存放在本机 ~/.mercury/memory/second-brain/second-brain.db，文档称不会上传到云端。
这页内容对你有帮助吗？
在 GitHub 查看 ↗ 安装 ↓