第32篇：交付模式——专注产出文件

这篇讲的是：Hermes Agent 在聊天软件里，能把生成的文件直接“递”到你手上，而不是甩给你一串路径让你自己去找。

---

先打个比方

想象你叫了个外卖。普通模式是：厨师做好饭，告诉你“去厨房第三层柜子左边第二个饭盒里拿”。交付模式则是：外卖小哥直接把热腾腾的饭端到你面前。

Hermes 的交付模式就是后者。你在 Slack、微信、Telegram 里让它“画个图表”，它画完，图直接出现在聊天窗口里，点开就能看，不用复制路径、不用打开文件夹。

---

第1步：让 Agent 生成文件

Agent 本身有很多“会做文件”的工具，比如：

• execute_code → 用 matplotlib 画图表
• pdf / latex-pdf-report → 生成 PDF 报告
• xlsx → 生成 Excel 表格
• image_generate → 生成图片
• text_to_speech → 生成音频

你只需要在聊天里说清楚需求，比如：

“把 Q3 营收做成柱状图发给我”

Agent 就会把图表保存成一个文件，比如 /tmp/q3-revenue.png。

---

第2步：Agent 在回复里“提一句”文件路径

这里有个关键机制：Agent 不需要额外标记，只要在回复的正文里写出文件的绝对路径，比如：

图表已生成：/tmp/q3-revenue.png

网关（Gateway）会自动扫描回复文本，把路径从消息里摘出来，上传文件，并在聊天里替换成原生附件——图片直接显示，PDF 变成下载按钮。

注意：代码块里的路径会被忽略，所以不用担心示例代码被误伤。

---

第3步：网关按文件类型分发

不同类型的文件，展示方式不同：

• 图片（.png .jpg .gif 等）→ 直接内嵌显示
• 视频（.mp4 .mov 等）→ 内嵌播放
• 音频（.mp3 .wav 等）→ 语音/音频附件
• 文档/表格/压缩包（.pdf .xlsx .zip 等）→ 文件上传

故意排除 .py、.log 这类源码文件，防止 Agent 乱发代码。想发代码？用代码块就行。

---

第4步：让 Agent 养成“产出文件”的习惯

Agent 默认不会主动做文件，需要你“调教”：

• 临时要求：每次说清楚“发我图表”“返回 CSV”
• 长期设定：在项目的 AGENTS.md 或全局 ~/.hermes/SOUL.md 里写偏好，比如：“在聊天平台回复时，优先用图表/文件形式”

---

进阶：多 Agent 协作时自动带附件

用看板（Kanban）模式时，Worker 可以在完成任务时挂上文件：

kanban_complete(
    summary="已生成 Q3 营收图表和报告",
    artifacts=["/tmp/q3-revenue.png", "/tmp/q3-report.pdf"]
)

任务完成通知发到 Slack/Telegram 时，附件会自动跟着消息一起送达。文件不存在则自动跳过，不报错。

---

补充：接更多服务

想连 Notion、GitHub、Gmail 等？通过 MCP（Model Context Protocol）装社区服务器即可，在 ~/.hermes/config.yaml 里配置 mcp_servers 段。OAuth 令牌都留在你本机，没有云端托管。

---

小结

交付模式的核心就一句话：Agent 生成文件 → 在回复里写路径 → 网关自动转成聊天附件。你不用再“复制路径 → 打开文件夹 → 找文件”，一切在聊天里完成。

下篇预告：第33篇，我们来聊聊 Hermes Agent 的“记忆机制”——它怎么记住你的偏好和项目背景，让每次对话都更懂你。