亲手搭起你的
Hermes Agent
用 DeepSeek API 驱动 Hermes 桌面客户端，从注册到第一次对话，15 步全图解。跟着每一步走，完成一张勾一张。
⚠️ 关键认知：Hermes 不是模型
Hermes 是「管家」，DeepSeek 是「大脑」。Hermes 本身不带模型，必须先连上一个模型服务（如 DeepSeek）才能思考。
同样的，免费注册 Hermes 不等于免费得到模型；模型能力由 DeepSeek 提供，按用量计费。
- 一台 macOS 12+ 或 Windows 10/11 电脑
- 能正常访问网页的网络
- 一个邮箱（建议 Gmail / Outlook / Hotmail / Yahoo）
- 支付宝或微信（用于 API 充值）
- 约 10～20 元 DeepSeek API 余额
😵 最容易踩的坑
DeepSeek 有两个站：聊天网站（免费网页对话）和 开放平台（API 用）。
本教程全程使用 platform.deepseek.com 开放平台 —— 在聊天站注册≠开通 API。
- 打开 DeepSeek 开放平台，点击「登录 / 注册」
- 用邮箱或 Google 等方式注册，并完成邮箱验证
- 重新登录开放平台
- 按页面提示完成实名认证（个人实名即可，在线充值前通常需要）
注册失败提示「暂不支持该邮箱域名」？
换 Gmail、Outlook、Hotmail、Yahoo 等国际通用邮箱注册。这是 DeepSeek 官方 FAQ 的建议。
💡 个人 vs 企业认证
个人试用选「个人实名认证」即可；两者在产品功能上没有区别，只有认证方式和所需材料不同。企业如需对公汇款，再切换企业认证。
- 左栏点「API keys」，或直接打开 api_keys 页面
- 点「创建 API key」，名称建议填
Hermes Desktop - 创建后立刻复制并保存（只显示一次！）
- 存入密码管理器，只在本机使用
演示：Key 只显示一次是什么样的
这是装饰性演示，不会生成真实 Key。真实 Key 一旦关闭页面，只能删除重建。
🔒 绝不外发
不要把 API Key 发到微信群、飞书群、ChatGPT 对话、GitHub、截图或任何公开渠道——谁拿到它，谁就能花你的余额。
怀疑泄漏：立刻到 API Keys 页面删除旧 Key，再创建新的。
- 左栏点「充值」，或直接打开 top_up 页面
- 选择「在线充值」（普通个人用户）
- 选小金额（如 ¥10～¥20），确认页面对应 当前登录的账号
- 用支付宝 / 微信完成支付
- 到 账单 确认到账，并在 用量信息 查看用量、开启余额预警
充值余额永久有效。赠送余额可能有有效期，在账单页查看。
确认充值的账号与当前登录一致；若用 Google 登录过，可切换登录检查。未消费金额支持在账单页「退款管理」自助退款。
网页版/App 对话免费。但 Hermes 调用的是 API，API 按 Token 用量计费——用多少扣多少，不是包月。
仅从官方下载：hermes-agent.nousresearch.com/desktop（macOS: .dmg，Windows: .exe）。不要从第三方下载站下载。
- 官方页点 macOS 下载，得到
.dmg文件 - 双击打开 .dmg，把 Hermes 图标拖进「应用程序」
- 在「应用程序」双击 Hermes 启动
- 若提示「无法验证开发者」：确认来自官方后，到 系统设置 → 隐私与安全性 点「仍要打开」
不要关闭整机的安全机制来绕过提示，也不要运行来源不明的安装包。
- 官方页点 Windows 下载，得到
.exe安装程序 - 双击运行，按向导选默认选项：同意协议 → 选位置 → 安装
- 通过开始菜单 / 桌面快捷方式 / 安装完成按钮启动
- 若 SmartScreen 弹警告：先确认安装包来自官方域名，无法确认就不要运行
首次启动会提示选择：本地安装 / 已有远程 Hermes / 登录 Nous Research。新手请选 本地安装（Install locally），不要选远程连接。
Agent 后端会由桌面应用自动准备（Python、Node.js 等都不用你手动装），首次安装需要几分钟，请别中途关闭。
✅ 它和命令行是同一个 Agent
Hermes Desktop 不是功能缩水的聊天壳。它和命令行共享配置、API Key、会话记录、Skills、Memory、工作目录——以后用哪个入口都行。
- 启动向导询问模型时，选择 DeepSeek
- 在 API Key 输入框粘贴你的 Key
- 点保存 / 继续，等待 Hermes 检查连接
粘贴时不要多带空格，也不要把引号复制进去。
- 左侧导航找到 Keys（或 Settings → Keys）
- 找到 DeepSeek → 添加 API Key
- 粘贴 Key 并保存
对应环境变量是 DEEPSEEK_API_KEY，但桌面端通常直接填 Key 即可，无需手动改环境变量。
- 左侧进 Models，点主模型行的 Change
- 左栏选 DeepSeek（只有已配置的 Provider 会出现）
- 右栏选 deepseek-v4-flash（入门推荐）
- 点 Switch / Apply 保存
🧪 模拟选择器——点一点感受流程
Provider · 模型服务商
Model · 模型
🚫 旧教程里的模型名别照抄
deepseek-chat / deepseek-reasoner 属于旧命名；当前官方文档模型为 deepseek-v4-flash 与 deepseek-v4-pro。以 Hermes 下拉列表和 DeepSeek 官方文档为准。
改了模型没生效？正常现象：Settings 里的修改只对「新建会话」生效。关闭当前聊天 → 新建一个 → 看输入框旁的模型名。
选 DeepSeek，而不是 Custom endpoint
Hermes 内置支持 DeepSeek，优先用内置 Provider。
- 「自定义接口」只在你使用第三方中转服务时才需要
- 如果版本确实要求填写，官方 OpenAI 兼容地址为
https://api.deepseek.com - 正常情况下无需手动填地址
新建聊天窗口，发送下面这句话：
✅ 收到「DeepSeek 已连接。」意味着
- Hermes Desktop 已安装、后端已启动
- DeepSeek API Key 有效
- 账户余额可用
- 模型配置正确
验证成功后可到 DeepSeek「用量信息」页确认本次调用记录（有几分钟延迟）。
Hermes 可以做什么？
读取文件、创建/修改文件、执行终端命令、浏览网页、调用工具、跑长时间任务。它是 Agent，不是只聊天的软件。
三条新手铁律
- 保持默认人工确认；不要开 YOLO（跳过危险命令确认）。看到命令请求先读再决定。
- 先用测试文件夹（如
Hermes-Test）让 Agent 工作，别一上来就把「文稿 / 照片 / 项目目录」交给它。 - 敏感信息不发给 Agent：银行卡号、支付密码、API Key、身份证照片、公司密码、未公开客户资料、私人聊天记录。
按顺序检查：① Key 是否已保存；② 是否保存到了 DeepSeek 而不是其他 Provider；③ 是否误选了 Custom endpoint；④ 退出重开 Hermes；⑤ 再到 Models 页查看。
Hermes 只会把「已配置好凭据」的 Provider 显示在选择器里。
Key 有问题。回到 DeepSeek API Keys 页 → 删除旧 Key → 新建 → 重新复制 → 在 Hermes Keys 页替换 → 重启 Hermes。
不要把 Key 发出来让别人帮你排查。
检查：① 是否充值到正确的开放平台账号；② 是否误用普通聊天账号；③ 账单页是否有充值记录；④ 当前模型是否正确；⑤ 是否有其他程序在用同一个 Key。
用 Hermes 当前列表里的名称。现在官方文档模型是 deepseek-v4-flash 和 deepseek-v4-pro，别再照抄几个月前的教程。
正常现象。已打开的会话可能沿用创建时的模型：新建聊天 → 检查输入框旁的模型选择器 → 必要时完全退出重开 Hermes。
检查是否官方下载、包完整、装到正常目录、安全机制是否拦截、是否完全重启。仍不行就在终端运行 hermes doctor 检查环境。
打开终端（macOS：按 Command + 空格 搜「终端」；Windows：打开 PowerShell）。常用命令：
检查安装与配置状态，提示缺什么、怎么修。
重新配置 Provider 和模型（向导式）。
查看当前模型配置。
正常使用桌面客户端时，不常用这些命令；出问题时它们能快速定位。
Hermes
DeepSeek
🛡️ 最后提醒：API Key 就像银行卡密码。教程里可以截操作步骤，但不要截图完整的 Key。