赫尔墨斯完成通知脚本说明 | AI生成和翻译

Home 2026.05 English 中文

---

问题： 你能解释一下这个 Bash 脚本是做什么的吗？

回答：

这个脚本是 macOS 上 Hermes 代理的一个后处理钩子。它旨在每当 Hermes 完成一次对话轮次时通知用户。让我们逐步解析：

---

1. 脚本元数据

#!/usr/bin/env bash
# ~/.hermes/agent-hooks/on-agent-done.sh

• Shebang（#!/usr/bin/env bash）确保脚本使用 Bash 运行。
• 该脚本位于 ~/.hermes/agent-hooks/ 目录下，并在 Hermes 完成一轮对话时被触发。

---

2. Bash 安全选项

set -euo pipefail

• -e → 如果任何命令失败则退出。
• -u → 将未设置的变量视为错误。
• -o pipefail → 如果管道中的任何部分失败，则脚本失败。

这使得脚本更加健壮，避免静默错误。

---

3. 读取负载

payload="$(cat -)"

• 从 stdin 读取 JSON 输入。Hermes 通过 JSON 将对话轮次的相关信息传递给钩子。

---

4. 使用 Python 提取数据

extracted=$(echo "$payload" | python3 -c "
import json, sys
data = json.load(sys.stdin)

# 从 cwd 获取目录名
cwd = data.get('cwd', '')
import os
dirname = os.path.basename(cwd) if cwd else 'unknown'

# 用户消息的前10个字符
extra = data.get('extra', {})
user_msg = extra.get('user_message', '')[:10]

# 对话历史记录数量
history = extra.get('conversation_history', [])
hist_count = len(history)

print(f'{dirname}|{user_msg}|{hist_count}')
" 2>/dev/null) || extracted="unknown||0"

• 使用 Python 安全地解析 JSON。

• 提取三个关键信息：

  1. dirname → 当前工作目录名称（如果可用）。
  2. user_msg → 用户最后一条消息的前10个字符。
  3. hist_count → 到目前为止的对话轮次数。
• 输出一个以 | 分隔的字符串，供 Bash 解析。
• 如果任何步骤失败，则默认为 "unknown||0"。

---

5. 分割提取的值

IFS='|' read -r dirname user_preview hist_count <<< "$extracted"

• 使用 IFS='|' 将字符串分割为三个变量：

  • dirname → 文件夹名称
  • user_preview → 用户消息片段
  • hist_count → 对话轮次数

---

6. 构建通知副标题

subtitle="msg: ${user_preview}  |  turns: ${hist_count}"

• 将提取的信息组合成一个用于 macOS 通知的短字符串。

---

7. 发送 macOS 通知

osascript -e "
display notification \"Hermes has completed one turn.\" with title \"Hermes Agent — ${dirname}\" subtitle \"${subtitle}\" sound name \"Glass\"
" >/dev/null 2>&1 || true

• 使用 osascript（通过 shell 调用 AppleScript）来显示通知：

  • 标题： "Hermes Agent — <目录>"
  • 副标题： "msg: <前10个字符> | turns: <数量>"
  • 声音： "Glass"
• 将所有输出重定向到 /dev/null 以保持静默。
• || true 确保即使通知被阻止，脚本也不会失败。

---

8. 返回空 JSON

printf '{}\n'

• 输出 {} 以便 Hermes 的钩子系统知道脚本已成功完成。
• 作为“静默无操作”响应。

---

✅ 总结

• 该钩子在每个 Hermes 代理轮次之后触发。
• 提取基本上下文：目录、用户消息预览和对话长度。
• 发送一个非侵入式的 macOS 通知。
• 如果出现问题，会优雅地失败。

这是一个简单但有效的方式，用于在 macOS 上直观地跟踪 Hermes 的活动。

---

如果你需要，我还可以画一个小型流程图，展示 JSON 如何从 Hermes → 此脚本 → macOS 通知，这样更容易理解整个流程。

需要我这么做吗？

---

Back Donate