1. 为什么 Hermes 桌面 GUI 的字体和目录值得单独调Hermes Agent 是 Nous Research 开源的 AI 代理框架除了命令行 CLI 和各种 IM 网关它还带了一个原生桌面应用。装好hermes-setup.exe之后启动的就是它底层是 Electron React TailwindUI 布局跟 VS Code、Cursor 有几分神似——左右分栏、右侧文件树、内嵌终端。问题也出在这儿刚装完默认字体偏小长时间看聊天记录和终端输出眼睛累默认工作目录又不是你常用的项目目录每次开新会话都得手动cd或者重新选路径。这两个设置藏得不算深但入口不显眼很多人用了半个月还在每次按快捷键调缩放。这篇就把 Hermes 桌面 GUI 的字体缩放和工作目录切换一次讲清楚包括快捷键、持久化机制、启动即 150% 的写法、切换目录后哪些东西会联动、以及怎么回滚。同时给出一份可复制的settings.json/config.toml骨架把 TaoToken 的统一 Key 和 API 通道接进去让 Hermes 的模型请求走一个稳定入口。适合在 Windows / macOS 下日常用 Hermes 桌面端的本地开发者。2. TaoToken 前置统一 Key 与 API 通道Hermes 桌面端本身不绑定某一家模型服务它通过配置里的 provider 和 base_url 去请求。如果你同时用多个模型、多个项目每个地方填一遍 Key 很容易乱。TaoToken 的作用就是给一个统一的 API 通道和 KeyHermes 这边只需要把 base_url 指过去、把 Key 填进去。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址不带 UTMhttps://taotoken.net/api你需要提前准备的东西一个 TaoToken 账号登录后在控制台创建 API Key确认你要用的模型名比如 Claude 系列、GPT 系列按你账号里可用的来Hermes 桌面端已经装好并能正常启动。创建 Key 的入口在控制台的 API Keys 页面模型对话可以在模型对话页先试跑一句确认 Key 和通道是通的。长期编码或跑 Agent 任务的话Coding Plan 更适合按量长期用。注意Key 只存在本地配置文件里不要提交到 Git也不要在截图里露出完整字符串。3. 可复制配置字体、目录与 TaoToken 接入3.1 字体缩放快捷键与持久化整个窗口的缩放是通过 Electron 的webContents.setZoomLevel控制的Hermes 把默认 0.2 的步长砍半到 0.1手感更细腻。操作Windows / LinuxmacOS放大Ctrl 或 Ctrl Cmd 或 Cmd 缩小Ctrl -Cmd -重置 100%Ctrl 0Cmd 0按一下 Ctrl 整个窗口——聊天消息、文件树、终端、菜单按钮——同步变大连续按可以一路放大到 10 倍zoom level 上限 9。缩放级别写到 renderer 的 localStoragekey 是hermes:desktop:zoomLevel。刷新页面不丢重启 GUI 不丢不同窗口、不同项目之间互不影响。不用每次开应用都重新按一遍。想要「启动就是 150%」打开 DevToolsCtrl Shift ImacOS 是 Cmd Opt IConsole 里执行localStorage.setItem(hermes:desktop:zoomLevel, 0.5)然后 Ctrl/Cmd R 刷新即可。允许范围 -9 ~ 9对应 10% ~ 1000%。调过头布局乱了Ctrl/Cmd 0 一键回到 100%。3.2 工作目录两个触发位置入口都在右侧边栏的文件树头部点当前目录名头部那个灰色的目录名比如 Hermes本身就是一个按钮点它直接弹系统文件夹选择框点文件夹图标目录名右侧的「打开的文件夹」小图标hover 时才完全可见同样会弹出选择框。弹的是 Windows / macOS 原生的dialog.showOpenDialog选完点确定就生效。切换后会联动这些右侧文件树立刻重载为新目录内嵌终端的 CWD 跟着切过去之后所有工具调用terminal / read_file / patch / search_files都跑在新目录下当前会话已经发出的消息不会回溯改 cwd从下一条消息起才用新目录对话框默认定位到当前 cwd连续切换相邻目录很顺手。一个遗憾代码里目前没给「切换目录」绑全局快捷键必须从右侧栏点。好在右侧栏默认常驻显示不用额外设置。3.3 settings.json 骨架含 TaoToken 通道Hermes 桌面端的配置一般放在用户目录下的配置文件夹里Windows 通常在%APPDATA%\HermesmacOS 在~/Library/Application Support/Hermes。下面是一份可复制的settings.json骨架把 provider 指向 TaoToken{ provider: { name: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-20250514 }, desktop: { zoomLevel: 0.5, workingDirectory: /Users/you/projects/my-app }, tools: { terminal: { shell: /bin/zsh, timeoutMs: 120000 } } }Windows 下workingDirectory写成C:\\Users\\you\\projects\\my-app注意反斜杠要转义。zoomLevel这里写 0.5 就等价于前面 localStorage 里的 150%两边保持一致省得互相覆盖。3.4 config.toml 骨架CLI 与桌面共用如果你同时用 Hermes 的 CLI 和桌面端用config.toml更统一[provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-20250514 [desktop] zoom_level 0.5 working_directory /Users/you/projects/my-app [tools.terminal] shell /bin/zsh timeout_ms 120000改完保存重启 Hermes 桌面端让配置生效。桌面端优先读settings.jsonCLI 优先读config.toml两个都写就按各自入口读各自的。4. 验证请求与成功结果配置改完别急着关按下面几步验证。第一步验证字体缩放。重启后看聊天区和文件树的字号是不是你设的 150%。如果没变打开 DevTools 看 Console 里localStorage.getItem(hermes:desktop:zoomLevel)返回什么应该是0.5。第二步验证工作目录。点右侧栏目录名选一个新目录观察文件树是否立刻重载。然后在内嵌终端里敲pwd输出应该是你刚选的新目录路径。再敲一句ls列出的文件应该和新目录一致。第三步验证 TaoToken 通道。在对话框里发一句最简单的请求比如「用一句话说明当前工作目录是什么」。如果模型正常回复说明 base_url 和 Key 都通了。想单独测通道可以在终端里直接 curlcurl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}] }返回里带choices字段就说明通道正常。如果返回 401检查 Key 有没有多余空格返回 404检查 base_url 是不是写成了带/v1的完整路径——TaoToken 的 API 根是https://taotoken.net/api具体路径按文档拼。第四步验证工具调用跑在新目录。让 Hermes 执行一个read_file读新目录下的某个文件能读到内容就说明 cwd 联动生效了。5. 本篇常见错排查字体调了没反应。先确认你按的是 Ctrl 而不是 Ctrl Shift 有些键盘布局下需要配合 Shift。如果快捷键完全无效可能是焦点在某个 iframe 或终端里点一下聊天区再按。还不行就检查settings.json里的zoomLevel和 localStorage 是否冲突以最后写入的为准。重启后缩放回到 100%。说明 localStorage 没写进去或者你用的是无痕模式启动。检查 DevTools 里hermes:desktop:zoomLevel是否存在不存在就手动 setItem 一次再刷新。切换目录后终端还在旧路径。内嵌终端的 CWD 是跟随切换的但如果终端里已经跑着一个前台进程比如npm run dev它不会自动退出。先 Ctrl C 结束进程再敲pwd确认。已经发出的消息不会回溯改 cwd这是设计如此从下一条消息起才用新目录。TaoToken 请求 401。九成是 Key 复制时带了换行或空格。把 Key 重新复制一遍注意别把sk-前缀漏掉。也可能是 Key 被禁用或额度用完去控制台 API Keys 页面确认状态。TaoToken 请求超时。先 curl 测一下通道本身通不通排除是 Hermes 配置问题还是网络问题。如果 curl 通但 Hermes 不通检查settings.json里baseUrl有没有多写斜杠正确写法是https://taotoken.net/api不要写成https://taotoken.net/api/。改了 config.toml 但桌面端没生效。桌面端读的是settings.jsonCLI 读的是config.toml。两个文件路径不同别改错。桌面端的配置目录在%APPDATA%\HermesWindows或~/Library/Application Support/HermesmacOS。回滚步骤。字体回滚Ctrl/Cmd 0或者把zoomLevel改回 0 再重启。目录回滚点右侧栏目录名重新选回原目录或者把workingDirectory改回原路径。TaoToken 回滚把provider段改回你原来的配置或者直接删掉apiKey字段让它走默认。6. 接下来怎么用字体和目录这两个设置调好之后日常体感差距很大。建议按 Ctrl 调到舒服后用 Ctrl 0 记一下边界下次直接定位。工作目录建议固定成你最常开的那个项目根目录这样每次启动 Hermes 不用再选。如果你还没接 TaoToken先去控制台创建 Key然后在模型对话页试跑一句确认通道通再回来改settings.json。长期跑编码和 Agent 任务的话Coding Plan 比按次调用更省心。接入文档里有完整的 base_url 和参数说明配置时对着抄就行。参考源码位置apps/desktop/electron/main.cjsinstallZoomShortcuts / setAndPersistZoomLevel / restorePersistedZoomLevelapps/desktop/src/app/right-sidebar/index.tsxchooseFolder。测试环境Hermes Agent 桌面版Windows 10。
