Hermes Agent桌面端v0.5.0升级实测：界面功能全面革新

上次给用 Hermes 的朋友推荐了桌面版，反响不错。这次作者酝酿了一个大版本更新，几个关键改进值得细说：

X·笔记从普通笔记直接进化为知识工作台，支持高级块、引用、版本管理和 AI 内联写作，可视化编辑体验同步升级。配置来源全面统一，API 密钥、服务状态、模型状态全部收敛到 Hermes Agent，App 不再需要维护独立的语义体系。连接诊断从简单的“端口可达”升级为“能否真正对话”，能更精准地判断 Gateway、Dashboard 和运行时的真实状态。视觉层面也做了统一收口，工作区壳层、侧边栏、中栏和主工作区完成一轮产品级打磨，白底工作台搭配轻量侧边栏，层级关系清晰很多。发布能力方面，Universal DMG 兼容包的构建流程已经稳定，后续可持续用于 Mac 预览版及外部分发测试。

一句话总结：用户体验实现了实质提升。笔记、AI 交互、模式切换、流式输出、连接诊断、模型配置、UI、终端、跨平台兼容，全都翻新了一遍。

图1

体验提升最明显的几个点

抽屉式 AI 交互：选中文字即可调用 AI，无需弹窗遮挡。

之前的笔记中，AI 助手以浮层形式存在。选中文字点击 AI，弹出一个窗口直接挡住上下文，用完还得手动关闭，操作割裂感明显。现在改为嵌入正文的抽屉式交互。选中文字点 AI 助手，不会弹窗，而是在当前内容下方直接展开一个抽屉。上下文一览无余，可以边看上方内容边使用 AI。用法简单：选中一段话，点 AI 助手，让它润色、改写或总结。结果满意就替换或插入下方，不满意则继续追问，不用关闭重开。切换笔记时抽屉自动清理，不留垃圾状态。

图4

Markdown 高级语法支持：笔记不再局限于纯文本。

这次新开发了一套完整的高级块系统。可以在笔记中插入多种结构化内容块，不再只是纯文字。已落地的块包括：引用块（hover 可预览，点击可跳转）、提示块（带左边框的重点区域，比加粗更醒目）、折叠块（长内容收起来不占空间）、标签块（一个区域存放多个内容切换查看）、文件块、多栏块、步骤块（自动生成编号）、行容器。这可不是小修小补，而是笔记能力的质变。

图7

图12

多模式切换：信息密度可自由控制。

以前左侧对话、右侧笔记、上方工具栏，整个界面信息满满当当，想专心写作时眼睛不知该往哪放。现在新增三种模式：全模式（显示所有内容）、笔记模式（只保留编辑区，隐藏对话等干扰）、对话模式（只保留 AI 对话界面，隐藏笔记模块）。写作时切笔记模式，需要咨询 AI 时切对话模式，简洁高效。

流式输出：AI 回复不再卡顿。

这是底层优化带来的变化。之前每个 token 都会触发大量 React 重绘，输出时界面明显卡顿。修改后输出效果像打字机一样流畅。thinking 部分也不再单独顶一条消息，而是挂在回复消息上，支持展开、短暂展开、完成后收起三种状态，对话界面紧凑许多。

图10

连接诊断显示更精准

之前连接状态的判断逻辑很粗暴：端口通不通？通了就是“已连接”，没通就是“未连接”。但问题是，端口通了不代表实际可用。Gateway 进程可能卡死，Dashboard 能访问但模型配置不对，HTTP 可达但 chat readiness 没通过。这些情况旧版本都检测不出来。

现在的连接状态从“端口可达”升级为“真诊断”。系统会区分六个层级：Gateway 是否启动、Dashboard 是否启动、HTTP 是否可达、chat readiness 能否完成一次最小对话、provider 和 model 是否匹配、进程是否存在但持续超时。如果发消息没反应，诊断会明确告诉你“Gateway 已连接，但模型配置不匹配”或“进程存在但持续超时，建议重启”。连接状态页面改为 Gateway 和 Dashboard 两张服务卡并列，每张卡支持测试、启动、停止、编辑地址、保存。页面进入时只同步轻量服务状态，不会自动跑完整诊断。

图9

图8

模型配置统一为 Hermes 源

之前的模型配置是 App 自己维护了一套 provider/model/key/baseUrl 的语义，这次所有配置都向 Hermes 本体收敛。配置读写目标明确为 ~/.hermes/config.yaml 和 ~/.hermes/.env，服务状态来自各组件的真实状态，模型能力从 Hermes 配置和 runtime 能力推导。App 不再维护自己的平行语义。

模型配置页也做了重构。主模型和模型资产分层展示，内置 provider 只清配置不删 provider，自定义资产可以彻底删除。API Key 优先写入 .env，不直接写进 YAML，脱敏的 API Key 不会被当作真实输入值。连接测试也回到了供应商的 Base URL，而不是测 Gateway 主机端口。还修了一个很隐蔽的 Bug：侧边栏切换模型时可能清空 base_url，导致 Gateway 无法路由自定义 provider 请求。Windows 平台也补齐了路径约定。

图6

UI 大改

这次 UI 改动覆盖面很广。应用壳层方面，左侧导航、中栏、右栏的三栏结构做了统一收口。左侧导航的 hover 和 active 状态做了细节优化，收起态下的小图标、圆角、背景权重都美化了。中栏宽度支持拖拽，还增加了恢复默认宽度的按钮。

对话页的变化比较大。输入框从旧版大卡片改成了轻量的工作台风格，支持多行自动增高，Enter 发送、Shift + Enter 换行。用户消息去掉了黑底气泡，Assistant 正文去掉了边框气泡，Markdown 直接铺开，聊天轨道更居中。暗色模式这次做了一轮真正覆盖全 App 的修复：聊天、消息列表、输入区、首页、设置、Hermes 配置、技能列表、文件管理、终端、定时任务，全部覆盖。策略不是简单把背景改黑，而是同步抬亮暗色 surface、压低刺眼的浅色块、统一边框层级。白底也统一了，首页工作台亮色模式改成纯白底，跟顶部标题栏连成一体。

图3

终端升级

终端页从单一面板升级成了三栏工作台：中栏是终端会话列表，右侧是当前终端界面。保留了工作区 cwd 联动，避免了同时渲染多个活跃终端实例导致的资源混乱。这个改动为后续多终端、命令历史、AI 到终端联动打下了基础。

图5

跨平台兼容

macOS 解决了一个很典型的问题：“终端能找到 hermes，App 里找不到”。原因是 macOS GUI 应用不继承终端 Shell PATH。这次升级扩展了二进制路径的扫描范围，覆盖了 ~/.local/bin/hermes、pipx venv、cargo bin、Homebrew 这些常见路径，也加了用户手动配置的持久化机制。Windows 平台补齐了编译说明和路径约定。

作者更新挺累的，有几天基本上是凌晨两三点才睡，白天起来继续干。但看到大家热情地使用他的产品，还是打了鸡血一样在更新。

重要预告：明天更新自带 Hermes 的版本。

图2

附：Hermes Slate Desk 第五版完整更新内容

Hermes Slate Desk v0.5.0-20260524

新增

新增并完善 X·笔记工作台能力，笔记模块从普通 Markdown 编辑页升级为支持高级块、引用、反向引用和 AI 内联辅助的知识工作台。新增笔记内联 AI 助手抽屉，支持在当前块下方嵌入式展开，提供连续追问、替换当前选区、插入下方等写作模式。新增多类笔记高级块体验，包括信息提示块、折叠详情块、Tabs 标签块、步骤列表块、同排容器和文件/图片相关块能力。新增笔记快照与版本策略，自动保存继续保留，版本快照按关键变更、时间窗口和内容变化阈值生成，降低无意义版本数量。新增 Hermes 运行诊断与连接状态工作台，Gateway 与 Dashboard 支持状态检测、启动、停止、地址编辑和诊断入口。新增更贴近真实运行时的 readiness 判定，连接状态不再只看端口是否可达，而是进一步判断 Hermes 是否真正具备对话能力。新增模型配置与 Hermes 本地文件的深度对齐，配置读写目标收口到 /.hermes/config.yaml、/.hermes/.env 与 profile 配置。新增 macOS Universal 兼容包构建流程，支持生成同时适配 Intel Mac 和 Apple Silicon Mac 的 DMG 安装包。

优化

优化 X·笔记编辑体验，高级块从“模板插入”进一步升级为更接近 Notion / Yoopta 的可视化块编辑体验。优化 Tabs、Callout、Toggle、Steps、Row 等高级块的编辑态与预览态样式，整体改为更轻、更扁平、更贴近当前 App 白色工作台风格。优化笔记块内焦点稳定性、自动保存触发时机和 AI 抽屉布局，减少光标跳到顶部、内容保存不及时和抽屉遮挡正文的问题。优化笔记图片体验，支持编辑态图片尺寸持久化，预览态点击图片可打开查看。优化笔记版本面板展示，版本记录更聚焦标题、修改时间、修改类型、块数和快照恢复动作，不再展示冗余摘要。优化首页工作台、连接状态页、模型配置页、设置页、文件管理、定时任务、技能列表和 Hermes 相关页面的白底工作区风格。优化全局壳层视觉，侧边栏、中栏和工作区之间收口为单线分割，减少重复边框、过重阴影和灰脏背景。优化左侧侧边栏视觉，保留轻量毛玻璃质感，中栏与右侧工作区保持纯白，形成更清晰的产品层级。优化 Gateway / Dashboard 连接状态 UI，卡片布局更紧凑，减少重复字段，让页面更像专业运维面板。优化模型配置体验，自定义模型、本地模型、供应商清理、已配置统计和掩码回显更贴近 Hermes CLI 的真实状态。优化多语言适配，简体中文、繁体中文和英文核心页面文案进一步补齐，减少硬编码中文残留。优化应用图标与打包资源，兼容包继续使用最新图标和安装说明资源。

修复

修复 AppInner 中 gatewayDisplayStatus is not defined 导致首页、笔记本等页面白屏的问题。修复笔记高级块在编辑态不显示、预览态显示不一致的问题。修复 TabsBlock 预览态默认未选中第一个标签、标签间距和激活态不明显的问题。修复 ToggleBlock 预览态点击标题或箭头不能稳定展开收起的问题。修复 Callout 信息提示块编辑态文字被左侧色条遮挡的问题。修复同排容器添加图片后出现重复删除按钮、添加容器按钮不明显、布局按钮信息过多的问题。修复笔记 AI 助手抽屉不显示、闪烁、遮挡下方块、关闭后高度不恢复和宽度不同步的问题。修复笔记编辑页保存中状态长时间不结束的问题。修复笔记自动快照触发不稳定的问题，补强超过字数阈值、块增删和关键节点的快照创建逻辑。修复 Gateway 进程卡死但状态仍显示异常的问题，连接配置和侧边栏状态灯进一步对齐真实服务状态。修复对话页白屏、Hermes 连接诊断误报和笔记 AI 助手使用错误聊天参数导致 400 的问题。修复主工作区圆角在页面切换时出现直角闪动的问题，壳层圆角和裁剪状态更加稳定。修复首页工作台顶部重复展示“异常”胶囊的问题，减少不必要的状态噪音。

-END-

来源：互联网