怎么跑起来

安装器到底往磁盘上放了什么

在 Windows 上装完 Hermes Agent,%LOCALAPPDATA%\hermes 下会多出几十个顶层条目(写这篇时是 80 个)。其中只有四个承载状态——config.yaml、skills、cron、profiles。其余是缓存、锁文件、下载产物和日志;删掉它们只会让下一次启动慢一点,不会丢东西。

STATE — keepconfig.yaml · 22 sectionsskills/ · 66 entriescron/ · 21 filesprofiles/ · 2REGENERABLE — safecache/ · 18 entriesbootstrap-cache/bin/ · launcherdesktop-plugins/NEVER COPY — secretauth.json · mode 600gateway.lock / .pid*.bak — rollback pointls -1 "$LOCALAPPDATA/hermes" · 80 top-level entries · measured 2026-11-18
Source: our own install, ls + grep -cCounts move with versions; the three classes do not

安装器都有同一个毛病:说一句「完成」,然后丢给你一个读不懂的目录。

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 在应用配置变更前自己写的,文件名里带着那次变更的名字。

所以正确的试错方式是这样:

  1. 只改一个段;
  2. 让 agent 写出它自己的备份;
  3. 重启并观察;
  4. 如果退化,把 .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,且还在涨
  1. 段数还是 22。 你只想改一段,结果段数变了,说明不小心多建或少建了一个顶层键——YAML 仍然合法,但这份文件已经不是你以为了的那份。
  2. 哈希只在预期处不同。 改之前先记哈希。哈希变了本身什么都证明不了;只有在你知道「我打算动哪里」时它才有意义。如果改的是 memory.max_tokens,那一段之前和之后的字节应当完全一致。
  3. 看行为,不看文件。 重启之后,让 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 与计数;条目数随版本变化,照着命令重跑即可复核