hermes profile 命令 — 完整参考与示例

概述

hermes profile 管理多个彼此隔离的 Hermes 实例。每个 profile 拥有独立的配置、会话、skills、记忆和凭据，数据存放在 ~/.hermes/profiles/<name>/。default profile 始终存在。

使用全局标志 --profile <name>（或 -p）可以针对指定 profile 执行单次命令，而不改变默认 profile。

hermes profile <子命令>

子命令

list

列出所有 profile。

hermes profile list

use <名称>

设置默认 profile。

hermes profile use work

create <名称>

创建新 profile。名称应使用小写字母和数字。

hermes profile create work [--clone] [--clone-all] [--clone-from SOURCE] [--no-alias] [--no-skills] [--description "工作用途"]

标志：

• --clone — 从当前 profile 复制 config.yaml、.env、SOUL.md 和 skills。
• --clone-all — 完整复制当前 profile（除 per-profile 历史外）。
• --clone-from SOURCE — 从指定 source profile 复制（除非使用 --clone-all，否则隐含 --clone）。
• --no-alias — 不创建 wrapper 脚本。
• --no-skills — 创建不包含捆绑 skills 的空 profile。
• --description — 一句话描述，供 kanban 分解器使用。

delete <名称>

删除 profile 及其所有数据。

hermes profile delete old-project [-y]

describe [名称]

读取或设置 profile 描述。

hermes profile describe work --text "后端工作 profile"
hermes profile describe --auto --all

标志：

• --text TEXT — 将描述设置为指定文本。
• --auto — 通过辅助 LLM 自动生成描述。
• --overwrite — 与 --auto 一起使用时，替换已有描述。
• --all — 与 --auto 一起使用时，为所有缺少描述的 profile 生成。

show <名称>

显示 profile 详情。

hermes profile show work

alias <profile_name>

管理 profile 的 wrapper 脚本别名。

hermes profile alias work [--name work-hermes]
hermes profile alias work --remove

rename <旧名> <新名>

重命名 profile。

hermes profile rename work company-x

export <名称>

将 profile 导出为 .tar.gz 归档。

hermes profile export work -o work.tar.gz

import <归档>

从 .tar.gz 归档导入 profile。

hermes profile import work.tar.gz [--name work]

install <source>

从 git URL（如 github.com/user/repo、https://...、git@...）或包含 distribution.yaml 的本地目录安装 Hermes profile 分发版。

hermes profile install https://github.com/org/profile-dist [--name work] [--alias] [--force] [-y]

标志：

• --name NAME — 覆盖清单中的 profile 名称。
• --alias — 创建 shell wrapper 别名。
• --force — 覆盖同名已有 profile（保留用户数据）。
• -y — 跳过清单预览确认。

update <名称>

从记录的来源重新拉取分发版并应用更新。用户数据（记忆、会话、auth、.env）不会改动；除非使用 --force-config，否则 config.yaml 也会被保留。

hermes profile update work [--force-config] [-y]

info <名称>

显示 profile 分发版清单（版本、依赖、来源）。

hermes profile info work

示例

# 创建并切换到工作 profile
hermes profile create work --description "后端工作"
hermes profile use work

# 不切换默认 profile，临时在另一个 profile 中执行命令
hermes --profile personal chat -q "帮我规划周末"

# 导出并在之后重新导入 profile
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name work-restored

# 安装共享的团队 profile 分发版
hermes profile install [email protected]:org/team-hermes-profile --alias -y

# 更新基于分发版的 profile
hermes profile update team-profile -y

技巧

• Profile 之间完全隔离：配置、会话、凭据和记忆互不泄漏。
• 使用 hermes --profile <name> ... 进行一次性调用，无需更改默认 profile。
• 在使用 kanban 前运行 describe --auto --all 很有用，因为分解器会根据描述来路由任务。
• 分发版安装（install/update）默认只覆盖分发版所属文件，保留用户数据。