词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
未命名文档
Profile 命令参考
hermes profile
hermes profile 将显示帮助信息。| 子命令 | 描述 |
|---|---|
list | 列出所有 profile。 |
use | 设置当前活跃（默认）profile。 |
create | 创建新 profile。 |
delete | 删除 profile。 |
show | 显示 profile 详情。 |
alias | 重新生成 profile 的 shell alias。 |
rename | 重命名 profile。 |
export | 将 profile 导出为 tar.gz 归档文件。 |
import | 从 tar.gz 归档文件导入 profile。 |
install | 从 git URL 或本地目录安装 profile 发行版。参见 Profile 发行版。 |
update | 重新拉取发行版管理的 profile 并重新应用其 bundle。 |
info | 显示 profile 的发行版元数据（来源 URL、commit、最后更新时间）。 |
hermes profile list
* 标记。hermes profile use
<name> 设为活跃 profile。此后所有 hermes 命令（不带 -p）都将使用该 profile。| 参数 | 描述 |
|---|---|
<name> | 要激活的 profile 名称。使用 default 可返回基础 profile。 |
hermes profile create
| 参数 / 选项 | 描述 |
|---|---|
<name> | 新 profile 的名称。必须是合法的目录名（字母数字、连字符、下划线）。 |
--clone | 从当前 profile 复制 config.yaml、.env 和 SOUL.md。 |
--clone-all | 从当前 profile 复制所有内容（config、memories、skills、sessions、state）。 |
--clone-from <profile> | 从指定 profile 克隆，而非当前 profile。与 --clone 或 --clone-all 配合使用。 |
--no-alias | 跳过 wrapper 脚本创建。 |
--description "<text>" | 一到两句话描述该 profile 的用途。供 kanban 编排器根据角色而非仅凭 profile 名称来路由任务。可跳过，稍后通过 hermes profile describe 添加。持久化保存在 <profile_dir>/profile.yaml 中。 |
--no-skills | 创建一个空 profile，不启用任何内置 skill。会在 profile 目录中写入 .no-skills 标记，使后续 hermes update 不再重新植入内置 skill 集，且拒绝与 --clone / --clone-all 组合使用（因为后者会复制 skill）。适用于不应继承完整 skill 目录的窄化编排器 profile 或沙箱 profile。 |
config.yaml 中设置 terminal.cwd。hermes profile describe
<profile_dir>/profile.yaml 中，重启后仍有效，并与 gateway 共享。(no description set for '<name>')）。| 参数 / 选项 | 描述 |
|---|---|
<name> | 要描述的 profile。除非使用 --all --auto，否则必填。 |
--text "<text>" | 将描述设置为此精确文本（用户编写）。覆盖已有描述。 |
--auto | 通过辅助 LLM 自动生成 1-2 句描述，依据为该 profile 已安装的 skill、配置的模型和名称。在 config.yaml 的 auxiliary.profile_describer 下配置模型。自动生成的描述会标记 description_auto: true，以便 dashboard 标记供审查。 |
--overwrite | 与 --auto 配合使用时，也替换用户编写的描述（默认：跳过已明确设置描述的 profile）。 |
--all | 与 --auto 配合使用时，扫描所有缺少描述的 profile。 |
hermes profile delete
| 参数 / 选项 | 描述 |
|---|---|
<name> | 要删除的 profile。 |
--yes, -y | 跳过确认提示。 |
警告
hermes profile show
terminal.cwd 启动（或在本地后端 cwd: "." 时从启动目录启动）。| 参数 | 描述 |
|---|---|
<name> | 要查看的 profile。 |
hermes profile alias
~/.local/bin/<name> 的 shell alias 脚本。适用于 alias 被意外删除，或移动 Hermes 安装目录后需要更新的情况。| 参数 / 选项 | 描述 |
|---|---|
<name> | 要创建/更新 alias 的 profile。 |
--remove | 移除 wrapper 脚本而非创建。 |
--name <alias> | 自定义 alias 名称（默认：profile 名称）。 |
hermes profile rename
| 参数 | 描述 |
|---|---|
<old-name> | 当前 profile 名称。 |
<new-name> | 新 profile 名称。 |
hermes profile export
| 参数 / 选项 | 描述 |
|---|---|
<name> | 要导出的 profile。 |
-o, --output <path> | 输出文件路径（默认：<name>.tar.gz）。 |
hermes profile import
| 参数 / 选项 | 描述 |
|---|---|
<archive> | 要导入的 tar.gz 归档文件路径。 |
--name <name> | 导入后的 profile 名称（默认：从归档文件推断）。 |
发行版命令
提示
auth.json 和 .env 永远不属于发行版的一部分 — 它们保留在安装用户的机器上。.env 的自有编辑）在初次安装和后续更新中始终得到保留。信息
hermes profile export / import 仍是在本机进行 profile 本地备份和恢复的正确命令。发行版（install / update / info）是独立概念：通过 git 分发 profile，供他人安装。hermes profile install
| 选项 | 描述 |
|---|---|
<source> | Git URL（github.com/user/repo、https://...、git@...、ssh://、git://）或包含 distribution.yaml 的本地目录根路径。 |
--name NAME | 覆盖 manifest 中的 profile 名称。 |
--alias | 同时创建 shell wrapper（例如 telemetry → hermes -p telemetry）。 |
--force | 覆盖同名的已有 profile。用户数据仍会保留。 |
-y, --yes | 跳过 manifest 预览确认提示。 |
.env.EXAMPLE 文件，复制为 .env 后填写即可。hermes profile update
config.yaml 以保持本地覆盖设置。传入 --force-config 可将其重置为发行版附带的 config。hermes profile info
install 或 update 时记录的 Installed: 时间戳。适用于安装前检查共享 profile 的需求，以及发现"该 profile 已安装 6 个月未更新"等情况。hermes profile list 也会在 Distribution 列中显示发行版名称和版本，hermes profile show <name> / delete <name> 会显示来源 URL，让你一眼看出哪些 profile 来自 git 仓库，哪些是本地创建的。私有发行版
git 二进制文件，因此 shell 已配置的任何认证方式（SSH 密钥、git credential helper、GitHub CLI 存储的 HTTPS 凭据）均可透明生效。git clone 的方式配置好认证，再执行安装。发行版 manifest（distribution.yaml）
distribution.yaml：hermes_requires 支持 >=、<=、==、!=、>、<，或裸版本号（视为 >=）。若当前 Hermes 版本不满足规格，安装将失败并给出明确错误。distribution_owned 为可选项。若设置，更新时仅替换这些路径；profile 中的其他内容保持用户所有。若省略，则应用上述默认值。发布发行版
1.
distribution.yaml，至少包含 name 和 version。2.
3.
hermes profile install <your-repo-url>。HEAD 的接收方将获得最新状态，你也可以随时在 manifest 中更新 version:。hermes -p / hermes --profile
| 选项 | 描述 |
|---|---|
-p <name>, --profile <name> | 本次命令使用的 profile。 |
hermes completion
| 参数 | 描述 |
|---|---|
<shell> | 要生成补全脚本的 shell：bash、zsh 或 fish。 |
hermes profile <TAB> — 子命令（list、use、create 等）hermes profile use <TAB> — profile 名称hermes -p <TAB> — profile 名称