怎么跑起来
安装器到底往磁盘上放了什么
在 Windows 上装完 Hermes Agent,%LOCALAPPDATA%\hermes 下会多出几十个顶层条目(写这篇时是 80 个)。其中只有四个承载状态——config.yaml、skills、cron、profiles。其余是缓存、锁文件、下载产物和日志;删掉它们只会让下一次启动慢一点,不会丢东西。
安装器都有同一个毛病:说一句「完成」,然后丢给你一个读不懂的目录。
Hermes Agent 比多数产品诚实——它所有的东西都在一个文件夹里。但这个文件夹有二十来个条目,没有任何东西告诉你哪个要紧。本文是 2026-11-18 在一台真实机器上逐个目录读出来的结果,目的是让你分清「状态」和「临时产物」。
一条命令看清全部
$ ls -1 "$LOCALAPPDATA/hermes"
attachments config.yaml gateway-service profiles
audio_cache cron hooks scripts
auth.json desktop _pre_sync_skills skills
bin desktop-plugins hermes-agent ...
bootstrap-cache gateway.lock cache ...
上面这些名字里,只有四个承重:config.yaml、skills、cron、profiles。把这四个复制到新机器,你的 agent 行为就跟着走了。其余的是下载、锁、日志和缓存。
每个目录到底是什么
| 条目 | 装什么 | 能不能删 |
|---|---|---|
config.yaml |
全部设置:模型、终端、压缩、记忆、工具集、审批 | 不能——这就是 agent 本体 |
config.yaml.bak-* |
每次改配置前自动写的带时间戳备份 | 稳定之后可以删 |
skills/ |
程序性记忆,本机 66 个顶层条目 | 不能——重写它们的代价最大 |
cron/ |
定时任务,本机 21 个文件 | 不能,除非你就是要清掉排程 |
profiles/ |
独立 profile,各自带技能与记忆 | 不能 |
| 记忆库 | 通过 memory 工具读写 | 不能,也不该手改文件 |
cache/ |
下载产物、抓过的页、模型元数据(本机 18 个) | 能 |
bootstrap-cache/ |
首次运行的下载缓存 | 能 |
bin/ |
安装器放的启动器 | 能,下次更新会重装 |
auth.json |
凭据,权限 600 | 不能,也永远不要截图或进仓库 |
*.lock / *.pid |
网关与鉴权锁 | 进程停掉后能 |
这张表就是全文。下面两节解释两个容易踩的坑。
这一页最不稳的就是这些数字。 写这篇的过程中,顶层条目从 24 涨到了 80:sessions/、logs/、state.db 这些目录,只有 agent 真正跑起来才会出现,一个下午的使用足够把数量改掉三倍。所以要读的是分类,不是总数——四个名字承载状态、四个可以重新生成、三个永远不能离开这台机器。
坑一:config 是按「段」组织的,不是一列设置项
把 config.yaml 当平面键值文件读,是第一次改配置最常见的错。本机这份有 22 个顶层段:
model terminal browser tool_loop_guardrails compression prompt_caching
memory session_reset group_sessions_per_user streaming skills agent
platform_toolsets stt code_execution delegation display updates
plugins _config_version auxiliary voice
第一天只需要打开两段:memory 决定跨会话能留多少,platform_toolsets 决定它在这台机器上被允许做什么。其余的先别动,直到你觉得慢、或者某个操作被拒。
注意 _config_version。它存在的原因是升级会迁移你的配置文件——手改时把它改成别的形状,是「本来能跑」变成「跑不起来」最常见的原因。
坑二:备份已经在里面了,它就是回滚方案
目录里能看到 config.yaml.bak_20261116_121538_pre_memlimit2x、config.yaml.bak-deepseek 这样的文件。它们是 agent 在应用配置变更前自己写的,文件名里带着那次变更的名字。
所以正确的试错方式是这样:
- 只改一个段;
- 让 agent 写出它自己的备份;
- 重启并观察;
- 如果退化,把
.bak拷回去——不用 git,也不用考古。
这两个文件名还顺带记录了这台机器的历史:一次记忆上限调整、一次换供应商。接手别人的机器时,先看备份文件名列表,是了解「被试过什么」最快的办法。
从这里看不出来的两件事
目录列表不能告诉你:记忆到底有没有跨会话保留、定时任务到底跑没跑。这两件事在运行时里,要用工具问,不是 ls。
如果你要验证排程,让 agent 列出任务;要验证记忆,问它上一轮才知道的事。
另外一件我们没测的事:把 auth.json 从另一台机器恢复过来还能不能用。很可能令牌与原安装绑定。在你自己测过之前,把它当不可迁移。
怎么知道它真的修好了
三条检查,按「能证明多少」递增排列:
$ grep -cE '^[a-z_]+:' "$LOCALAPPDATA/hermes/config.yaml" # 22
$ sha256sum "$LOCALAPPDATA/hermes/config.yaml" | cut -c1-16 # 9380b09296f29604
$ ls -1 "$LOCALAPPDATA/hermes" | wc -l # 80,且还在涨
- 段数还是 22。 你只想改一段,结果段数变了,说明不小心多建或少建了一个顶层键——YAML 仍然合法,但这份文件已经不是你以为了的那份。
- 哈希只在预期处不同。 改之前先记哈希。哈希变了本身什么都证明不了;只有在你知道「我打算动哪里」时它才有意义。如果改的是
memory.max_tokens,那一段之前和之后的字节应当完全一致。 - 看行为,不看文件。 重启之后,让 agent 回忆一件只有上一轮才知道的事,再让它列出定时任务。文件只能证明配置被写进去了,只有这一步能证明它被读进去了。
第三条才是唯一能抓住最常见故障的:配置合法、已保存、却被静默忽略——因为进程根本没重启。
怎么回滚
备份就是回滚方案,而且它们是有名字的:
$ ls -1 "$LOCALAPPDATA/hermes"/config.yaml.bak* # 本机 2 个
$ cp "$LOCALAPPDATA/hermes/config.yaml.bak_20261116_121538_pre_memlimit2x" \
"$LOCALAPPDATA/hermes/config.yaml"
- 改配置:把
.bak拷回去,重启。不要用git checkout一个「应用自己也在写」的配置文件——这个文件归应用所有。 - 删了
cache/或bootstrap-cache/:没有可恢复的东西。这是下载缓存,下次运行会重新填满,只是第一次会慢。 auth.json:唯一一个没有回滚的动作。动之前先拷出来,恢复后把权限改回 600(chmod 600),并且永远不要让它出现在仓库、截图或对话里。- 崩溃后残留的
*.lock/*.pid:只在进程停掉之后删。删活锁会让两个进程都以为自己独占同一个存储。
本机一共 16 个 .bak 文件。那不是垃圾,是每一次「值得备份的改动」留下的审计痕迹。
在你自己机器上复现
$ ls -1 "$LOCALAPPDATA/hermes" | wc -l
$ grep -cE '^[a-z_]+:' "$LOCALAPPDATA/hermes/config.yaml"
如果第一个数只有我们的三分之一,说明这是刚装好、技能还没取全的状态。如果第二个数离 22 很远,你的配置文件早于某次迁移——改之前先看 _config_version。
最后核验:2026-11-18,Windows 11,当前版本。条目数会随版本变,那四个承重名字不会。
相关档案
常见问题
cache 目录能直接删吗?
能。里面是下载产物、抓取过的页面和模型元数据。下一次运行会重新取;代价是首个响应变慢,不是状态丢失。
我的记忆存在哪个文件?
不在你能直接改的目录里。记忆由 agent 运行时维护,通过 memory 工具读写,手改文件不是受支持的路径。
为什么会有 config.yaml.bak 这样的文件?
每次应用配置变更前,agent 会写一份带时间戳的备份。它既是回滚点,也是这台机器上「试过什么」的记录。
来源
本文最后一次核验:2026-11-18 · 在本机 Windows 11 实装目录上执行 ls 与计数;条目数随版本变化,照着命令重跑即可复核