每日小贴士：你知道可以把 Hermes 智能体配置文件分享到 GitHub 吗？分享一个配置文件，其他人或你自己就能轻松下载和分发！查看文档：https://t.co/TioH6JHaVE

配置文件分发：分享整个智能体 | Hermes 智能体

来源：https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions

一个配置文件分发将完整的 Hermes 智能体打包成一个 Git 仓库，包括个性、技能、定时任务、MCP 连接和配置。有权访问该仓库的人只需一条命令就能安装整个智能体，原地更新，而不会影响自己的记忆、会话和 API 密钥。如果配置文件是本地智能体，那么分发就是将这个智能体变得可共享。

这意味着什么 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#what-this-means)

在分发功能出现之前，分享一个 Hermes 智能体需要你发给人：

1. 你的 SOUL.md
2. 要安装的技能列表
3. 你的 config.yaml（不含密钥）
4. 你连接了哪些 MCP 服务器的说明
5. 你配置的任何定时任务
6. 需要设置哪些环境变量的说明

……然后希望对方能正确组装好。每次版本更新或修复 bug 都得重新交接一遍。

有了分发功能，所有这些都放在一个 Git 仓库里：

my-research-agent/
├── distribution.yaml    # 清单：名称、版本、环境变量要求
├── SOUL.md              # 智能体的个性 / 系统提示
├── config.yaml          # 模型、温度、推理、工具默认值
├── skills/              # 智能体自带的技能
├── cron/                # 智能体运行的定时任务
└── mcp.json             # 智能体连接的 MCP 服务器

接收者运行：

hermes profile install github.com/you/my-research-agent --alias <别名>

……他们就拥有了整个智能体。他们填入自己的 API 密钥（.env.EXAMPLE → .env），然后就可以运行 my-research-agent chat 或通过 Telegram / Discord / Slack / 任何网关平台使用它。当你推送新版本时，他们运行 hermes profile update my-research-agent 就能拉取你的更改——他们的记忆和会话保持不变。

为什么选择 Git？(https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#why-git)

我们考虑过 tarball、HTTP 存档、自定义格式。但都比不上 Git：

• **作者无需构建步骤。**推送到 GitHub；消费者安装即可。没有“打包、上传、更新索引”这样的循环。
• **标签、分支和提交本身就是版本控制。**推送标签就相当于其他工具“打包并上传一个发行版”的功能。
• **更新就是一次 fetch。**不需要重新下载整个存档。
• **透明。**用户可以浏览仓库、查看不同版本间的差异、提交 issue、fork 后自定义。
• **私有仓库免费使用。**SSH 密钥、git credential 助手、GitHub CLI 存储的凭证——你的终端已有的任何认证方式都能透明地应用。
• **可重现性即提交 SHA。**和 pip、npm 记录的一样。

代价是接收者需要安装 Git。但在 2026 年运行 Hermes 的机器上，这已经是标配了。

什么时候该用分发？(https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#when-should-you-use-a-distribution)

适用场景：

• 你要分享一个专用智能体——例如合规监控、代码审查、研究助手、客服机器人——给团队或社区。
• 你要将同一个智能体部署到多台机器，不想每次都手动复制文件。
• 你正在迭代一个智能体，希望接收者能用一条命令获取新版本。
• 你正在把智能体打造成一个产品——带有主观默认设置、精选技能、调优的提示——供其他人作为起点使用。

不适用场景：

• **你只是想在自己的机器上备份一个配置文件。**请使用 hermes profile export / import (https://hermes-agent.nousresearch.com/docs/reference/profile-commands#hermes-profile-export)——那是它们的用途。
• 你想在分享智能体时附带 API 密钥。auth.json 和 .env 被刻意排除在分发之外。每个安装者自带自己的凭证。
• **你想分享记忆 / 会话 / 对话历史。**那些是用户数据，不是分发内容。永远不附带。

下面是完整的端到端流程。请选择你关心的角色。

面向作者：发布分发 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#for-authors-publishing-a-distribution)

第 1 步 — 从可用的配置文件开始 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#step-1–start-from-a-working-profile)

像对待任何其他配置文件一样构建和打磨智能体：

hermes profile create research-bot
research-bot setup   # 配置模型、API 密钥
# 编辑 ~/.hermes/profiles/research-bot/SOUL.md
# 安装技能、连接 MCP 服务器、调度定时任务等
research-bot chat    # 自己用，直到感觉合适

第 2 步 — 添加 distribution.yaml (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#step-2–add-a-distributionyaml)

创建 ~/.hermes/profiles/research-bot/distribution.yaml：

name: research-bot
version: 1.0.0
description: "自主研究助手，支持 arXiv 和网络工具"
hermes_requires: ">=0.12.0"
author: "你的名字"
license: "MIT"

# 告诉安装者该智能体需要哪些环境变量。这些变量会与安装者的
# shell 和现有的 .env 文件进行比对，以免他们对已经配置好的密钥
# 反复询问。
env_requires:
  - name: OPENAI_API_KEY
    description: "OpenAI API 密钥（用于模型访问）"
    required: true
  - name: SERPAPI_KEY
    description: "SerpAPI 密钥（用于网络搜索）"
    required: false
    default: ""

这就是完整的清单。除了 name 之外，每个字段都有合理的默认值。

第 3 步 — 推送到 Git 仓库 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#step-3–push-to-a-git-repo)

cd ~/.hermes/profiles/research-bot
git init
git add .
git commit -m "v1.0.0"
git remote add origin [email protected]:you/research-bot.git
git tag v1.0.0
git push -u origin main --tags

现在该仓库就是一个分发。任何有权访问的人都可以安装。

注意： Git 仓库包含配置目录中除了已从分发中排除的项目之外的所有内容：auth.json、.env、memories/、sessions/、state.db*、logs/、workspace/、*_cache/、local/。这些保留在你的机器上。你也可以添加 .gitignore 来排除其他路径。

第 4 步 — 标记版本发行 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#step-4–tag-versioned-releases)

每当智能体达到一个稳定点，就更新版本并打标签：

# 编辑 distribution.yaml: version: 1.1.0
git add distribution.yaml SOUL.md skills/
git commit -m "v1.1.0: 更严格的研究 SOUL，添加 arxiv 技能"
git tag v1.1.0
git push --tags

运行 hermes profile update research-bot 的接收者将拉取最新版本。

仓库的样子 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#what-the-repo-looks-like)

一个完整的已作者分发：

research-bot/
├── distribution.yaml    # 必需
├── SOUL.md              # 强烈推荐
├── config.yaml          # 模型、提供者、工具默认值
├── mcp.json             # MCP 服务器连接
├── skills/
│   ├── arxiv-search/SKILL.md
│   ├── paper-summarization/SKILL.md
│   └── citation-lookup/SKILL.md
├── cron/
│   └── weekly-digest.json  # 定时任务
└── README.md            # 面向人类的描述（可选）

分发所属 vs 用户所属 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#distribution-owned-vs-user-owned)

当安装者更新到新版本时，有些内容会被替换（作者的领域），有些内容保持不变（安装者的领域）。

默认情况：

你可以在清单中覆盖分发所属的文件列表：

distribution_owned:
  - SOUL.md
  - skills/research/        # 仅我的研究技能；其他已安装的技能保留
  - cron/digest.json

省略时应用上述默认值——这是大多数分发想要的。

面向安装者：使用分发 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#for-installers-using-a-distribution)

安装 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#install)

hermes profile install github.com/you/research-bot --alias <别名>

发生什么：

1. 将仓库克隆到临时目录。
2. 读取 distribution.yaml，显示清单（名称、版本、描述、作者、所需环境变量）。
3. 对照你的 shell 环境和目标配置文件的现有 .env 检查每个必需环境变量。标记为 ✓ 已设置 或 需要设置，让你确切知道要配置什么。
4. 要求确认。传递 -y / --yes 可跳过。
5. 将分发所属的文件复制到 ~/.hermes/profiles/research-bot/（或清单中 name 解析到的位置）。
6. 写入 .env.EXAMPLE，必需的密钥被注释掉——复制到 .env 并填入。
7. 使用 --alias 创建一个包装器，使你可以直接运行 research-bot chat。

源类型 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#source-types)

任何 Git URL 都可以：

# GitHub 简写
hermes profile install github.com/you/research-bot

# 完整 HTTPS
hermes profile install https://github.com/you/research-bot.git

# SSH
hermes profile install [email protected]:you/research-bot.git

# 自托管、GitLab、Gitea、Forgejo——任何 Git 托管平台
hermes profile install https://git.example.com/team/research-bot.git

# 私有仓库，使用你已配置的 git 认证
hermes profile install [email protected]:your-org/internal-bot.git

# 开发期间的本地目录（无需 git push）
hermes profile install ~/my-profile-in-progress/

覆盖配置文件名称 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#override-the-profile-name)

两个用户希望以不同的配置文件名称使用同一个分发：

# Alice
hermes profile install github.com/acme/support-bot --name support-us --alias

# Bob（同一个分发，不同的本地名称）
hermes profile install github.com/acme/support-bot --name support-eu --alias

填写环境变量 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#fill-in-env-vars)

安装后，智能体的配置文件中包含 .env.EXAMPLE：

# 此 Hermes 分发所需的环境变量。
# 复制到 `.env` 并填入你自己的值后再运行。

# OpenAI API 密钥（用于模型访问）
# （必需）
OPENAI_API_KEY=

# SerpAPI 密钥（用于网络搜索）
# （可选）
# SERPAPI_KEY=

复制它：

cp ~/.hermes/profiles/research-bot/.env.EXAMPLE ~/.hermes/profiles/research-bot/.env
# 编辑 .env，粘贴你的真实密钥

已经存在于你 shell 环境中的必需密钥（例如在 ~/.zshrc 中导出的 OPENAI_API_KEY）会在安装时标记为 ✓ 已设置——你不需要在 .env 中重复设置。

查看你安装的内容 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#check-what-you-installed)

hermes profile info research-bot

显示：

分发: research-bot
版本: 1.0.0
描述: 自主研究助手，支持 arXiv 和网络工具
作者: 你的名字
要求: Hermes >=0.12.0
来源: https://github.com/you/research-bot
安装时间: 2026-05-08T17:04:32+00:00

环境变量:
  OPENAI_API_KEY (必需) — OpenAI API 密钥（用于模型访问）
  SERPAPI_KEY (可选) — SerpAPI 密钥（用于网络搜索）

hermes profile list 还会显示一个 分发 列，让你一眼看出哪些配置文件来自仓库，哪些是你手工构建的：

配置文件     模型              网关状态    别名          分发
─────────────── ─────────────────────────── ─────────── ─────────── ────────────────────
◆default      claude-sonnet-4  stopped      —            —
coder         gpt-5            stopped      coder        —
research-bot  claude-opus-4    stopped      research-bot [email protected]
telemetry     claude-sonnet-4  running      telemetry    [email protected]

更新 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#update)

hermes profile update research-bot

发生什么：

1. 从记录的源 URL 重新克隆仓库。
2. 替换分发所属的文件（SOUL、技能、cron、mcp.json）。
3. 保留你的 config.yaml——你可能调整过模型、温度或其他设置。传递 --force-config 可覆盖。
4. 从不触碰用户数据：记忆、会话、认证、.env、日志、状态。不会重新下载整个存档，不会覆盖你对配置的本地更改，不会删除你的对话历史。

删除 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#remove)

hermes profile delete research-bot

删除提示会在要求你确认前显示分发信息：

配置文件: research-bot
路径: ~/.hermes/profiles/research-bot
模型: claude-opus-4 (anthropic)
技能: 12
分发: [email protected]
安装自: https://github.com/you/research-bot

此操作将永久删除：
  • 所有配置、API 密钥、记忆、会话、技能、定时任务
  • 命令别名 (~/.local/bin/research-bot)

输入 'research-bot' 确认：

这样你就不会在不知情的情况下误删一个智能体，或者不知道自己还能重新安装它。

使用场景和模式 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#use-cases-and-patterns)

个人使用：跨机器同步一个智能体 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#personal-sync-one-agent-across-machines)

你在笔记本电脑上构建了一个研究助手。你想在台式机上使用同一个智能体。

# 笔记本电脑
cd ~/.hermes/profiles/research-bot
git init && git add . && git commit -m "initial"
git remote add origin [email protected]:you/research-bot.git
git push -u origin main

# 台式机
hermes profile install github.com/you/research-bot --alias
# 填写 .env。完成。

在笔记本电脑上的任何迭代（git commit && push）都可以通过 hermes profile update research-bot 拉取到台式机上。记忆按机器独立保存——笔记本电脑记住自己的对话，台式机记住自己的，互不冲突。

团队：交付一个经过审核的内部智能体 (https://hermes-agent.nousresearch.com/docs/user-guide/profile-distributions#team-ship-a-reviewed-internal-agent)

你的工程团队想要一个共享的 PR 审查机器人，具有特定的 SOUL、特定的技能，以及一个能自动处理每个 PR 的定时任务。

# 工程负责人
cd ~/.hermes/profiles/pr-reviewer
# ... 构建和调优 ...
git init && git add . && git commit -m "v1.0 PR reviewer"
git tag v1.0.0
git push -u origin main --tags    # 推送到公司内部的 Git 托管平台

# 每位工程师
hermes profile install [email protected]:your-org/pr-reviewer.git --alias
# 用自己的 API 密钥（费用记在自己名下）填写 .env，.env.EXAMPLE 指明了需要哪些密钥
pr-reviewer chat

当负责人发布 v1.1（更好的 SOUL、新技能）时，工程师运行 hermes profile update pr-reviewer，几分钟内所有人都用上了新版本。

你构建了一些新颖的东西——也许是“Polymarket 交易机器人”或“学术论文摘要生成器”或“Minecraft 服务器运维助手”。你想分享它。

# 你
cd ~/.hermes/profiles/polymarket-trader
# 在仓库根目录编写一份扎实的 README.md——GitHub 会在仓库页面上显示它
git init && git add . && git commit -m "v1.0"
git tag v1.0.0
# 发布到公共 GitHub 仓库
git remote add origin https://github