你换了一台新笔记本，装好 Hermes 桌面版，把同事喊过来说“你先跟它说句你好试试”。他打开窗口，看到的却是一张设置表单：先选 provider，再填 API Key，挑一个模型，定主题和布局，勾要连接哪些应用，选要装哪些插件。十几项填完，那句“你好”还没说出口，人已经开始走神了。你第一次装的时候大概率也一样——本来只是想试一个工具，结果先做了半小时配置。更现实的问题是，你没法保证一个从没接触过 agent 的人不会在第三步就关掉窗口：他不是不想用，只是不知道该填什么。

v0.22.0 把这一屏换掉了。现在在一台从没用过 Hermes 的电脑上打开桌面版，迎接你的是一段简短的向导对话（setup chat）：一次只问一件事，答完再问下一件。下面说清它问什么、免费试用怎么用，以及顺手多出来的 set_theme 工具。

首启第一屏：一次只问一件事的对话

旧的第一次启动是一页设置，要你一次性面对所有选项；现在它变成了有来有往的对话，一张卡片问一件事：

• 你的名字；
• 强调色和布局；
• 要连接哪些应用；
• 要装哪些插件。

走完这几张卡片，它会给你一个快速导览，然后递上最多四个“先做这个”的任务——按你前面选的东西挑出来的。你不用自己想“装好了该干嘛”，直接从一件具体的小事开始。

整段对话跑在免费试用模型 nous/welcome 上，所以新人在还没有 API Key 的时候就已经在跟 Hermes 说话了。不想走完也没关系：任何一步点 Skip setup 就结束；哪天想再看一遍，Settings → Run onboarding again 随时能叫回来。

set_theme：把改外观变成一句话

向导里选的强调色、明暗模式和布局，事后都能改，而且不用翻设置页——这一版给 agent 加了 set_theme 工具（源码 tools/set_theme_tool.py，也列在官方工具参考里）。

它做三件事：设置强调色（可以点预设色块，也可以给任意 #rrggbb 值）、设置浅色/暗色/跟随系统、设置布局；不带参数调用时会弹出一个选择器让你挑。因为它就是一个普通的聊天工具，你可以在任何桌面版聊天窗口里直接说“换成紫色、暗色模式”，不用去点菜单。

免费试用：先能说话，再决定要不要买 Key

nous/welcome 是给新人的一次性试用，按操作系统用户算一次。它的边界写得很清楚：

• 一台从没装过的桌面版，没配任何 provider、也没有 Nous 账号时，才会拿到这个免费模型；
• CLI、TUI 和消息网关没有免费模型，也没有账号；
• 以前那个 HERMES_GUEST_ONBOARDING 环境变量被删掉了。

免费层不做“假装”这件事：没有哪条路径会让请求看起来发出去了、其实被额度悄悄吃掉——免费额度用完的那一刻，当前这一轮会立刻结束，并告诉你额度什么时候重置。免费层的每一次失败都带一个错误码和一句白话解释，免费用户还会看到一条服务条款与隐私提示，不用自己猜到底是在试用里还是在付费环境里。

有一点要说准，因为它常让人意外：这份试用绑的是桌面版的首启，它并不是 Hermes 通用的“无 Key 模式”。CLI、TUI 和消息网关都拿不到免费模型，也没有账号，所以同一台机器上用脚本调 hermes 跑的任务，并不在你刚在应用里接受的那份试用范围内。

想把这份免费身份升级成正式的 Nous 账号，用一条命令，已经连好的应用不会丢：

# 把免费身份升级为完整的 Nous 账号（保留已连接的应用）
hermes auth upgrade

聊天窗口或消息私聊里也可以用 /login 走同一件事。

什么情况下看不到这段对话

这段向导只覆盖“本地、全新”这一种情形，别指望它到处冒出来：

• 已经用过的安装不会再走一遍；
• 远程后端（SSH、URL、Cloud）不会自动获得首次启动对话；
• 旧的 setup-profile 流程和 /initiate-setup 命令已经删除——如果你还照着老教程操作，那一步已经没有对应实现了。

想再看一遍，或者想让别人看一遍

这段对话不是一次性的。走到一半点 Skip setup 就关掉它，之后用 Settings → Run onboarding again 还能重新打开——比如你已经连了几个账号，想带着更清楚的答案再把应用和插件那两张卡片看一遍。也因为它只属于“从没用过 Hermes 的电脑”，想让同事走一遍这个流程，办法就是本文开头那个场景：递给他一台从没装过这个应用的机器。在一台你已经用了一阵的机器上，导览和推荐任务不再出现在流程里，在设置里怎么翻也不会自己冒出来。

向导之后，它还会递上两件小事

设置对话结束后还有两条线索值得知道。第一，如果这台机器跑得动推荐本地模型，它会给你一次性的本地模型配置邀请。第二，Settings → Providers → Local Models 页面会用适合你硬件的推理引擎（CPU、CUDA、Metal、Vulkan、ROCm）装好并维护 llama.cpp，还会按你的 GPU 和内存给目录里的每个模型打分，省得你自己猜哪个跑得动。终端里 hermes model 也多了 Local models 这一项。

这一版是在哪儿发出来的

首启向导、set_theme 和围绕它的免费试用，是在 v0.22.0 里发布的。这个窗口把 v0.21.1 到 v0.21.7 都卷了进来：约 24,200 个提交、约 6,080 个合并 PR、约 15,600 个文件改动、约 2,520 位贡献者。完整清单见 v0.22.0 发版说明。

想从零装一遍再看这条流程，安装指南里有各平台步骤；如果你更关心“没有 API Key 能不能先跑起来”，免费层指南讲得更细；本地模型那部分可以接着看 本地模型与硬件推荐。