企业官网建设流程全解析

mercury-agent 安装向导与 doctor 命令完全指南：5分钟配好 LLM、通道与权限

【免费下载链接】mercury-agentSoul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.项目地址: https://gitcode.com/gh_mirrors/me/mercury-agent

mercury-agent 是一个灵魂驱动的 AI 智能体：内置权限加固工具、Token 预算控制和多渠道接入（CLI / Telegram / Slack / Discord 等），可在本地或云端 7×24 小时运行。本文用 5 分钟带你走完两大核心流程——首次安装向导（setup wizard）和doctor 重配置/诊断命令，帮你一次配好 LLM 模型、消息通道和权限策略。无需阅读源码，跟着提示按回车就能完成。

安装：一行命令完成

向导运行前，先把 mercury-agent 装好。macOS / Linux 用户执行一行安装脚本（自动识别架构、校验 SHA-256、配置 PATH）：

curl -fsSL https://mercuryagent.sh/install.sh | sh

Windows 用户可改用 PowerShell 安装器；已有 Node.js 20+ 环境的话，npm i -g @cosmicstack/mercury-agent同样可行。详细说明见 安装文档。

setup 向导：首次启动的 6 步问答

首次运行mercury会进入onboarding 向导，依次问你 5 件事：

1. 你的名字—— 智能体用这个名字称呼你
2. 智能体名字—— 默认 "Mercury"，可自定义
3. LLM 提供商—— 可多选：DeepSeek、OpenAI、Anthropic、Grok、Ollama Cloud/Local、Atomic Chat 或任意 OpenAI 兼容服务
4. 默认模型—— 每填入一个有效 Key，Mercury 会实时拉取该账户下的推荐模型列表供你挑选
5. Telegram Bot Token（可选）—— 开启手机远程访问

API Key 双重校验，拒绝"乱填"

向导对每个 Key 先做格式校验（如 OpenAI 必须sk-开头、Anthropic 必须sk-ant-开头），再实际请求一次模型列表验证。拉取失败会要求重新输入，而不是接受任意文本——这在 密钥校验逻辑 中实现，从源头避免"填错了三天后才发现"的坑。

Telegram 配对码流程

若开启 Telegram，向导会启动临时配对流程：到 Telegram 给机器人发/start，把收到的配对码粘贴回 CLI，即可完成绑定。之后 Telegram 就是你在外时的主界面。

所有配置都写入~/.mercury/，不会污染你的项目目录。完整字段说明见 首次配置文档。

doctor 命令：老用户的"万能遥控器"

配好后想换模型？想加第二个提供商？不想重装？一条命令解决：

mercury doctor

它以你当前的配置值预填整个安装向导，核心交互约定只有一个：

三个贴心细节：

• API Key 掩码显示：界面只展示sk-x••••4f2a这样的形式，明文永不回显
• 模型重新拉取：改了凭据的提供商会重新获取最新模型列表
• 预算调整：可在这里修改每日 Token 预算上限

mercury setup是它的别名，效果完全一致。

doctor --platform：不动配置的兼容性体检

怀疑当前终端、SSH 环境或守护进程有兼容问题？加一个参数跑无破坏性诊断：

mercury doctor --platform

一次性输出 7 类检查结果：操作系统与架构、Node.js 版本、终端 TTY/raw-mode 能力、SSH/CI 环境检测、守护进程状态、Spotify 内联封面支持、按键回退方案（如/view、/ws exit）。它只读不写，放心在 CI 或远程会话里跑。

权限策略：Ask Me 与 Allow All 双模式

Mercury 采用分层权限体系，会话启动时让你二选一：

• 🔒Ask Me（默认）—— 文件写入、非白名单命令、新目录范围都会逐一征求确认
• ✅Allow All—— 本会话自动批准一切，重启后自动重置

三层 Shell 命令分级是安全核心：sudo、rm -rf /这类永远拦截；ls、cat、git status等只读白名单永远放行；其余命令按模式决定。被询问时选择Always（或按A）即可本会话内切换为自动批准。

规则可随时在~/.mercury/permissions.yaml中自定义，完整对照表见 权限文档。

配完就跑：启动与常用命令速查

配置就绪后，推荐用一条命令装上系统服务并拉起守护进程：

mercury up

常用命令一张表：

全部配置存放在~/.mercury/：主配置mercury.yaml、权限permissions.yaml、技能skills/、记忆memory/。完整命令清单见 CLI 命令参考 和 配置参考。

小结

• setup 向导负责"从 0 到 1"：名字、LLM 提供商、模型、Telegram 一步到位，Key 双重校验防错
• doctor 命令负责"从 1 到 N"：Enter 保留 / 输入覆盖，掩码保护密钥，--platform做无破坏性体检
• 权限双模式 + 命令三层分级，让"放手跑"与"盯着跑"自由切换

装好、跑一遍向导、mercury up——你的 7×24 小时 AI 智能体就上线了。

【免费下载链接】mercury-agentSoul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.项目地址: https://gitcode.com/gh_mirrors/me/mercury-agent