mercury-agent

给AI装上权限锁和预算表，7x24小时稳定干活

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 398 🐛 待处理 59 👀 关注 18

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3886

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

mercury-agent 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队cosmicstack-labs

官网地址https://mercuryagent.sh

GitHubhttps://github.com/cosmicstack-labs/mercury-agent

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-agent,ai-assistant,llm

GitHub 星标★ 3886

上线时间2026-04-20 00:00:00

代码更新2026-11-08

仓库体积55.7 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

mercury-agent 是一个基于 TypeScript 的智能体框架，核心特点是“灵魂驱动”和“权限加固”。它解决了 AI 助手在自主运行时面临的安全与资源控制问题，通过为工具调用设置严格的权限边界和 token 预算，防止智能体越权或消耗过多资源。项目支持 CLI 和 Telegram 双通道接入，可 24/7 不间断运行，适合需要长期后台任务的场景。其核心能力包括：多工具集成与权限管理、token 使用量实时监控、多会话管理，以及灵活的部署方式。开发者可通过配置自定义智能体的“灵魂”（即人格与行为模式），使其更贴合特定业务需求。项目处于成长阶段，社区活跃，但文档和生态尚在完善中。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3886

技术标签

ai-agent ai-assistant llm

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

macOS / Linux 或 Windows（可用官方一键安装脚本，无需 Node.js）
若走 npm 方式安装，需要 Node.js 20+
可用的 LLM Provider API Key（用于写入 ~/.mercury/.env）
磁盘可写目录 ~/.mercury/（运行时数据全部存放于此）

安装与启动步骤

1一键安装(macOS/Linux)

官方脚本会自动下载对应系统的最新独立二进制，无需预装 Node.js。
```
curl -fsSL https://mercuryagent.sh/install.sh | sh
```
2一键安装(Windows)

在 PowerShell 中执行，同样是下载独立二进制安装。
```
irm https://mercuryagent.sh/install.ps1 | iex
```
3填写配置与密钥

运行时数据都在 ~/.mercury/，不要把配置放在项目目录里；在 .env 填 API key，在 mercury.yaml 配 provider、channel 和 budget。
4启动 CLI 验证

README 建议本地直接用 mercury 命令测试运行，首次启动会读取 ~/.mercury/ 下的配置。
```
mercury
```
5安装社区技能

从 skills.mercuryagent.sh 注册表拉取技能，安装后下次启动即被智能体加载。也可先 search / browse / view 再安装。
```
mercury skills install ai-ml/prompt-engineering
```
6检查技能环境

用 doctor 检查技能安装根目录和注册表连通性，确认技能落盘位置正确。
```
mercury skills doctor
```
7从源码构建(可选)

二次开发流程：fork 仓库后安装依赖并编译，再本地用 mercury 测试，最后提 PR。
```
npm install
npm run build
```

关键配置

配置项	必填	说明	示例
`~/.mercury/mercury.yaml`	是	主配置：providers、channels、token budget	`~/.mercury/mercury.yaml`
`~/.mercury/.env`	是	存放 API keys 和 tokens，会与项目 .env 一起加载	`sk-xxxxxxxx`
`~/.mercury/permissions.yaml`	否	工具能力边界与审批规则，权限加固的核心配置	`~/.mercury/permissions.yaml`
`~/.mercury/soul/*.md`	否	智能体人格设定（soul、persona、taste、heartbeat）	`~/.mercury/soul/soul.md`
`MERCURY_SKILLS_REGISTRY`	否	换成自建技能注册表地址，等价于 --registry 参数	`https://skills.mercuryagent.sh`
`MERCURY_SKILLS_INSTALL_ROOT`	否	指定技能的备用安装路径，默认 ~/.mercury/skills/	`/your/path/skills`

如何确认成功

终端能执行 mercury 命令并进入交互；执行 mercury skills doctor 能正常输出安装根与注册表状态；Web 面板 http://127.0.0.1:6174/skills 可打开。

常见问题

Q：安装必须先装 Node.js 吗？

A：不需要。官方一键脚本会下载对应系统的独立二进制；只有走 npm 方式时才要求 Node.js 20+。

Q：社区技能安全吗？

A：技能由社区贡献且未经审计，官方明确建议安装前先执行 mercury skills view <id> 审阅内容，再决定是否安装。

Q：安装的技能放在哪里？

A：默认落在 ~/.mercury/skills/<category>/<slug>/SKILL.md，会被视作与内置技能完全一致，下次启动智能体即可加载。

Q：怎么改用自建技能注册表？

A：命令行加 --registry <url>，或设置环境变量 MERCURY_SKILLS_REGISTRY；输出可用 --json 让结果变为机器可读。

Q：能否从 Telegram 装技能？

A：可以，Telegram 端提供 /skills、/skills search <q>、/skills view <id>、/skills install <id>，其中安装为管理员专属。

注意事项

所有运行时数据都放在 ~/.mercury/，不会写进你的项目目录。
README 中 npm 安装命令被截断，npm 包名可参考徽章 @cosmicstack/mercury-agent，实际命令请以官网 mercuryagent.sh 为准。
技能安装前务必先 view 审阅：社区技能未经审计。
贡献代码流程：fork 仓库 → npm install → 修改 → npm run build 验证编译 → 本地用 mercury 测试 → 提 PR。