你正想把 macOS 窗口调成半透明，让壁纸从窗口边缘透出来一点——结果滑杆一拉，整个聊天窗口连同文字一起变淡，字都看不清了。于是你默默把滑杆拉回 0，这个功能从此形同虚设。v0.20.4（tag v2026.8.18，发布于 2026 年 8 月 18 日）就是来回答这个问题的：它带来了一种叫 Glass 的毛玻璃半透明模式，模糊窗口背景但文字、卡片、输入框保持全对比度——好看和好用终于不用二选一。

这个窗口合并了约 74 个 PR、146 个提交，改动约 265 个文件。除了 Glass，还有一批“让桌面端不再跟你较劲”的改动：侧边栏固定为标签页、bot 名单能隐藏整理了、hermes update 不再谎报成功、技能安装多了一道安全扫描、cron 附件不再凭空消失、Kanban 任务会弹系统通知。逐条来看。

Glass：能看得清文字的半透明

先说这个版本的头条。过去的“窗口半透明”直接映射到原生窗口不透明度，整个窗口一起淡——文字也在内，所以壁纸一花哨，这项功能基本只能钉在 0。Glass 在 macOS 上换了个思路：窗口在原生层面保持不透明，改为让渲染层的背景表面在系统 vibrancy 材质上变薄。你看到的是哑光模糊，但文字和卡片永远保持自己的不透明底色。

开启后有三个控制项：

• Intensity（强度）——同一个滑杆，跑满全程。拉到顶是纯无色调模糊，文字依然清晰。
• Frost（霜感）——Deep / Soft / Bright / Glare 四档，对应 macOS 的 vibrancy 材质，相当于模糊半径。
• Area（范围）——整个窗口，或仅侧边栏（Finder 那种“玻璃轨道 + 不透明内容栏”的形态）。

还有个小细节很贴心：调节滑杆时会“偷看”——设置浮层会自动淡出，让你直接看到实时窗口的效果。全新 macOS 配置文件默认预选 Glass（强度仍为 0，不动滑杆就一切照旧），Windows 和 Linux 保持原样。想回顾这个版本的全部 8 个亮点，可以看我们的 v0.20.4 发版说明。

侧边栏终于听话了，bot 名单也能收拾

桌面端左侧边栏过去偶尔会把 Sessions 和 Bots 上下堆叠显示，更新后还偶尔复发。现在 SESSIONS | BOTS 每次启动都固定为并排标签页，任何堆叠布局都会被强制归位，不会再出现第二次。

bot 名单也有了整理能力：右键点某个不常用的 bot → Hide Bot，它就从名单里消失（不影响 @mention 和群聊成员关系）；顶栏会出现一个眼睛按钮（只在至少藏了一个 bot 时出现），点开就能看到隐藏的 bot 并以右键恢复。隐藏状态还会同步到其他机器。

技能安装多了一道“第二意见”

每次 hermes skills install 现在都会调用 NVIDIA SkillEvaluator Tier 1（PII 检测、Unicode 走私、脚本 lint）做一次咨询性扫描——发现的问题会在安装确认前以 文件:行号 的形式列出来，但安装始终继续。这是刻意设计：上游 PII 扫描器有已知误报（比如 [email protected] 这种 SSH 语法），所以它的结论是辅助你判断，而不是替你做决定。密钥类发现（私钥、云密钥、token）会标红并提示重点复核。

这项扫描是可选的——没装 skillevaluator 二进制就静默跳过，也可以显式关闭：

skills:
  tier1_advisory: false

如果你经常安装社区技能，这道扫描等于安装前的免费安检。关于技能体系的更多玩法，可以看我们的项目级技能指南和技能组合实战。

cron 附件不再凭空消失

过去 hermes cron run <job-id> 有个隐蔽的坑：任务文本正常送达，但 PDF、图片等附件可能被静默丢弃，运行状态却显示成功——因为独立发送器把上传失败只写进了 warnings，而没有任何代码读它。现在附件失败在两条投递通道的运行状态里都看得见，手动测试和定时调度行为一致了。

另外，附件发送的超时从固定 30 秒变成可配置，默认 300 秒——大导出（长音频、大 PDF）不再一碰就炸：

cron:
  media_send_timeout_seconds: 300   # 或设 HERMES_CRON_MEDIA_SEND_TIMEOUT 环境变量

加上上一版引入的 last_fire_error 漏触发标记，cron 的“静默失败”死角基本都被照亮了。完整的 cron 自动化配置见我们的cron 完全指南。

hermes update 开始说实话

源码安装的用户可能见过这个场景：检出停在某个功能分支上，跑 hermes update，它打印 ✓ Code updated!——但实际更新的是个过期分支，main 的新代码一行都没进来。v0.20.4 修掉了这个谎言：停驻分支安全时（工作树干净、已合并）自动切回 main；不安全时大声警告并把代码更新标记为 SKIPPED；摘要行带上真实分支和 HEAD 短哈希：

✓ Update complete! [main @ 30fcf9580]

漂移一眼可见。

Kanban 任务会弹系统通知了

桌面端现在会在 Kanban 任务完成、撞上 blocker 或失败时弹出原生系统通知（覆盖 completed / blocked / gave_up / crashed / timed_out / block_loop_detected 全终态），你切到别的应用时 worker 卡住不再无声无息。由 设置 ▸ Notifications ▸ Plugin notifications 控制。想系统了解 Kanban 协作，可以读我们的看板评审生命周期指南。

升级

hermes update

升级后运行 hermes doctor 验证安装，并重启 gateway（hermes gateway）。macOS 用户等桌面应用刷新后，在 外观 ▸ Window Translucency 里就能找到 Glass。

完整变更清单在 v0.20.4 发版说明；上一个补丁的 cron 自愈与 MCP 无状态协议亮点在 v0.20.3 详解。