1. 项目概述为什么一个叫 Hermes 的工具突然成了飞书生态里小白最该盯住的“入门钥匙”最近在好几个技术群和低代码社区里总有人问“有没有那种不用写代码、点几下就能让飞书机器人跑起来的方案”——不是要搭个能处理10万并发的智能体就是想让飞书自动把 Jenkins 构建失败的消息推到群里或者把 Zabbix 告警转成飞书卡片再或者让团队用飞书多维表格填完需求后自动触发一次 Codex 的代码生成任务。这类需求有个共同特征人很急事很小但技术路径很模糊。没人想从 OAuth2.0 授权码流程开始啃文档更不想在飞书开放平台后台反复调试 Webhook 签名算法。这时候“Hermes”这个名字就高频出现了。它不是飞书官方出品也不是某个大厂的内部工具而是一个开源的、轻量级的飞书集成中间件核心定位非常清晰把飞书开放能力“翻译”成小白能看懂、能改、能验证的配置文件和命令行操作。你不需要理解什么是lark-bot-sdk的事件订阅生命周期也不用搞清config.yaml里app_id和app_secret到底该填哪个环境的值你只需要按模板填好飞书机器人的凭证写几行类似on_event: message_received的触发规则再执行一条hermes start一个能收消息、发卡片、调 API 的基础服务就跑起来了。我第一次试 Hermes 是在帮一个做教培运营的同事搭自动化流程。她连 Python 虚拟环境都没建过但用 Hermes 桌面版Hermes Desktop拖拽选了“收到关键词‘报名’就推送多维表格链接”这个预设模板5 分钟内就完成了配置并测试成功。后来她自己摸索着改了config.yaml加了一条“当多维表格新增行时自动负责人”整个过程没碰一行代码也没查过飞书开放平台的任何接口文档。这就是 Hermes 对小白的真实价值它不降低飞书集成的技术上限但大幅抬高了上手的地板。它把原本需要前端后端飞书平台三头对接的活压缩成一份 YAML 配置 三个命令行参数的组合拳。而所谓“集成飞书”在这里的本质就是让 Hermes 成为你和飞书 API 之间那个沉默但可靠的翻译官。2. 核心设计思路拆解为什么是 Hermes而不是直接用飞书 SDK 或写个 Flask 小服务很多人看到“集成飞书”第一反应是我用 Python 写个 Flask接个 Webhook 不就完了或者直接上飞书官方的lark-bot-sdk照着示例跑一遍。这当然可行但问题在于可行 ≠ 可持续可运行 ≠ 可维护可部署 ≠ 可交付。Hermes 的设计哲学恰恰是针对这几个“可”字下的功夫。我们来一层层剥开它的底层逻辑。2.1 配置驱动而非代码驱动config.yaml是它的“唯一真相源”Hermes 的核心不是代码库而是config.yaml这个文件。它不是简单的参数列表而是一份结构化的、面向场景的集成契约。比如你要实现“Zabbix 告警推飞书”传统做法是写一段 Python 脚本里面硬编码了飞书 Webhook URL、告警模板、消息格式。一旦飞书机器人换了 token或者 Zabbix 的告警字段变了你就得改代码、测逻辑、重新部署。而 Hermes 的config.yaml把所有这些都解耦了# config.yaml 片段 bots: - name: zabbix-alert-bot app_id: cli_xxx app_secret: xxx verification_token: xxx encrypt_key: xxx triggers: - type: http_webhook name: zabbix_alert_hook path: /zabbix/alert method: POST # 这里定义了如何从 HTTP 请求体中提取关键字段 payload_mapping: host: $.host severity: $.severity message: $.message actions: - trigger: zabbix_alert_hook bot: zabbix-alert-bot template: zabbix_card.jinja2你看app_id、app_secret这些敏感信息和业务逻辑完全分离payload_mapping用 JSONPath 表达式声明数据来源而不是在代码里写data[host]消息模板zabbix_card.jinja2是纯文本文件运营同学都能直接编辑。这种设计意味着配置即文档配置即部署包配置即测试用例。你甚至可以把config.yaml放进 Git用 GitHub Actions 自动校验语法再推送到服务器上hermes reload就生效——这才是真正意义上的“基础设施即代码”的轻量实践。2.2 命令行参数让启动、调试、切换环境像开关灯一样简单Hermes 的 CLI 设计极度克制只有start、reload、stop、logs四个主命令但每个都直击痛点。最常用的是hermes start --config ./config.yaml --env prod。这里的--env prod参数不是随便加的它背后是一套环境变量注入机制Hermes 会自动加载config.prod.yaml如果存在或从系统环境变量中读取HERMES_APP_ID等值覆盖config.yaml中的默认配置。这意味着开发时你用--env dev所有日志打满Webhook 地址指向本地 ngrok上线时只改一个参数--env prod所有配置自动切换连config.yaml文件都不用动。我见过太多团队因为环境配置混在一起导致测试环境误发生产消息而 Hermes 的这套参数体系从根子上杜绝了这种人为失误。2.3 “桌面版”不是噱头而是对“零依赖”体验的终极妥协Hermes Desktop 的存在常被误解为“给不会用命令行的人准备的阉割版”。其实恰恰相反它是 Hermes 对“小白友好”最彻底的一次工程实现。它把config.yaml编辑器、飞书凭证管理、实时日志查看、一键启动/重启、模板市场预置了 Jenkins、Zabbix、多维表格等常见集成模板全部打包进一个 80MB 的 Electron 应用里。用户双击安装打开应用点“新建集成”选择“飞书机器人”粘贴app_id和app_secret点“测试连接”绿色对勾亮起——整个过程没有终端窗口闪现没有报错弹窗没有“Permission denied”提示。它牺牲了 CLI 的极致灵活性换来了 95% 场景下的“开箱即用”。这不是技术倒退而是对真实用户心智模型的尊重当一个人连cd命令都要 Google 时给他一个带图形界面的config.yaml编辑器比教他怎么配 VS Code 的 YAML 插件要有效一万倍。3. 核心细节与实操要点config.yaml结构、CLI 参数、飞书凭证获取全流程光知道 Hermes 好用还不够真正卡住小白的永远是那些“文档里没写清楚但实际操作时必须填对”的细节。我把过去三个月帮不同行业客户落地 Hermes 的经验浓缩成一套可直接抄作业的实操指南。重点不是告诉你“是什么”而是告诉你“为什么这么填”、“填错了会怎样”、“怎么快速验证”。3.1config.yaml的骨架与血肉从空文件到可运行配置的七步法一个最小可用的config.yaml绝不是网上随便搜来的示例拼凑出来的。它有严格的层级和依赖关系。我把它拆解成七个不可跳过的步骤每一步都对应一个真实踩坑点第一步定义bots区块且必须包含name字段name不是别名而是后续所有actions中引用的唯一标识符。很多新手填了app_id却忘了name结果在actions里写bot: my-bot而bots里定义的是name: zabbix_bot导致 Hermes 启动时报错Bot my-bot not found但错误信息极其晦涩根本看不出是名字不匹配。第二步triggers的type必须与飞书开放平台的接入方式严格对应如果你在飞书开放平台后台选择了“事件订阅”那么type必须是event_callback如果选择了“自建 webhook”那type就是http_webhook。我见过最典型的错误是用户在后台开了事件订阅却在config.yaml里写了type: http_webhook结果 Hermes 一直在监听/webhook路径而飞书根本不会往那里发请求日志里一片死寂用户以为 Hermes 坏了。第三步payload_mapping的 JSONPath 表达式必须用$开头且区分大小写Zabbix 的告警 JSON 里字段是host不是Host或HOST。写成host: $.Host会导致映射失败host变量为空。更隐蔽的坑是Zabbix 5.x 的 JSON 里trigger.name是字符串而 6.x 里变成了对象表达式就得从$.trigger.name改成$.trigger.name.text。所以永远先用curl或 Postman 模拟发一条真实告警用在线 JSONPath 测试器如 jsonpath.com验证你的表达式是否能取到值。第四步actions的template路径是相对于config.yaml所在目录的相对路径很多人把zabbix_card.jinja2放在./templates/目录下却在config.yaml里写template: templates/zabbix_card.jinja2结果 Hermes 启动时报错Template not found。正确写法是template: ./templates/zabbix_card.jinja2前面的./绝不能省。这是 Jinja2 模板引擎的硬性要求Hermes 不会帮你补全。第五步bots下的verification_token和encrypt_key必须从飞书开放平台后台“安全设置”里复制不能从“应用凭证”里抄这是最高频的致命错误。app_id和app_secret在“应用凭证”页而verification_token和encrypt_key在“安全设置”页。两者位置离得很近新手极易看串。填错verification_token的后果是Hermes 启动后一切正常但飞书发来的所有事件都会被 Hermes 拒绝日志里只有一行Invalid signature没有任何上下文提示你哪里错了。第六步triggers的path字段必须以/开头且不能包含查询参数path: /zabbix/alert是合法的path: zabbix/alert缺开头/或path: /zabbix/alert?tokenxxx带参数都会导致 Hermes 路由注册失败。这个规则和所有 Web 框架一致但新手常凭直觉忽略。第七步actions的template文件里所有飞书卡片字段必须符合飞书卡片 Schema 规范比如飞书卡片里的elements数组每个元素必须有tag字段值必须是text、img、button等预定义值。写成tag: paragraph就会报错。最稳妥的做法是去飞书开放平台的“卡片消息”文档里复制一个最简卡片 JSON 示例然后把它保存为.jinja2文件在里面用{{ host }}这样的变量替换掉固定值。不要试图从零手写卡片结构。提示Hermes 自带hermes validate --config ./config.yaml命令它能静态检查config.yaml的语法、字段是否存在、必填项是否缺失。但它无法检查payload_mapping的 JSONPath 是否真能取到值也无法检查卡片模板是否符合飞书 Schema。所以验证命令只是第一道防线真实测试必不可少。3.2 CLI 参数详解哪些参数必须带哪些可以省略以及它们背后的运行时行为Hermes 的 CLI 看似简单但每个参数都牵涉到进程生命周期和资源管理。理解它们才能避免“为什么我改了配置重启后还是旧的”这类问题。--config path强制参数。Hermes 不会默认找./config.yaml你必须显式指定。这是为了支持多环境、多实例共存。比如你可以有config.dev.yaml、config.prod.yaml通过参数切换而不是靠改文件名。--env name环境隔离的核心。它不仅影响配置加载还影响日志级别和错误堆栈显示。--env dev时Hermes 会打印完整的 HTTP 请求/响应体方便调试--env prod时敏感字段如app_secret会被自动脱敏日志里只显示app_secret: ***。更重要的是它决定了config.yaml中的{{ env }}变量值你可以用 Jinja2 的if语句在模板里做环境判断。--port number端口冲突的终极解决方案。默认是8080但如果你的服务器上已经跑了 Jenkins8080或 Nginx80就必须改。我建议新手直接用--port 8081避开所有常见端口。注意改了端口飞书开放平台后台的“事件订阅 URL”也必须同步改成https://your-domain.com:8081/event如果是 HTTPS或http://localhost:8081/event如果是本地调试。--log-level level调试阶段的救命稻草。默认是info但当你遇到“消息发不出去”时立刻加上--log-level debug。你会看到 Hermes 如何解析config.yaml、如何初始化 Bot 实例、如何匹配 Trigger、如何渲染模板、如何调用飞书 API 的完整链路。我曾靠debug日志发现一个客户的飞书机器人被管理员禁用了“发送消息”权限而info级日志只显示Send faileddebug级则明确打出Error code: 11232, msg: permission denied。--daemon生产环境的必备选项。它让 Hermes 在后台作为守护进程运行即使你关闭了终端服务也不会退出。但新手慎用因为--daemon后hermes logs是你查看日志的唯一途径不能再用CtrlC停止。所以强烈建议所有调试工作都在不加--daemon的情况下完成确认无误后再用--daemon启动。注意Hermes 的进程模型是单线程的。这意味着如果你在一个config.yaml里定义了 10 个triggers它们会串行处理事件。对于 Zabbix 告警这种突发流量可能会有轻微延迟。这不是 bug而是设计权衡——用简单性换取了极高的稳定性和可预测性。如果你真需要高并发Hermes 本身不提供但你可以用 Nginx 做负载均衡启动多个 Hermes 实例每个实例监听不同端口再用upstream分发请求。3.3 飞书凭证获取全流程从创建应用到拿到config.yaml所需的全部四个密钥所有 Hermes 的失败90% 源于飞书凭证拿错了。这里给出一份绝对准确、截图无关、纯文字描述的获取指南精确到每一个按钮名称和页面路径。登录飞书开放平台open.larksuite.com进入“开发者后台”注意不是飞书主界面右上角的“工作台”而是单独的开放平台网址。如果你用企业微信账号登录会进错地方。创建新应用点击“创建应用” → 选择“企业自建应用” → 填写应用名称如“Zabbix 告警助手”→ 点击“创建”关键点必须选“企业自建应用”不能选“第三方应用”或“小程序”。只有“企业自建应用”才支持事件订阅和机器人消息。获取app_id和app_secret在应用详情页左侧菜单栏点击“应用凭证” → 右侧“应用凭证”区块里App ID和App Secret就是你要的两个值App Secret是一次性显示的页面刷新后会变成******所以务必第一时间复制保存。它相当于飞书给你的“密码”泄露等于机器人被接管。获取verification_token和encrypt_key在左侧菜单栏点击“安全设置” → 滚动到“事件订阅”区域 → 点击“启用事件订阅” → 系统会自动生成Verification Token和Encrypt Key并显示在页面上这里有两个陷阱第一Verification Token和Encrypt Key是启用事件订阅后才生成的如果你没点“启用”它们就是空的第二Encrypt Key是可选的但 Hermes 要求必须填写所以你必须点“启用”哪怕你暂时只用 Webhook。配置事件订阅如果type是event_callback在“事件订阅”区域点击“添加订阅” → 选择你需要的事件类型如im.message.receive_v1→ 在“订阅地址”里填入你的 Hermes 服务地址格式为https://your-domain.com:8080/eventHTTPS或http://localhost:8080/eventHTTP→ 点击“验证”验证过程飞书会向你的地址发一个 GET 请求Hermes 会自动返回challenge参数的值。如果验证失败检查--port是否和 URL 里的端口一致检查防火墙是否放行了该端口。配置机器人如果要用机器人发消息在左侧菜单栏点击“机器人” → 点击“添加机器人” → 填写机器人名称如“Zabbix 告警机器人”→ 点击“创建” → 在机器人详情页复制Webhook URL这个Webhook URL是给http_webhook类型的 Trigger 用的和上面的app_id等无关。它是一个完整的 URL形如https://open.feishu.cn/open-apis/bot/v2/hook/xxx。注意这个 URL 里的xxx就是机器人的token它和config.yaml里的app_id完全不同不要混淆。4. 实操过程全记录从零开始用 Hermes Desktop 集成 Zabbix 告警到飞书含完整配置文件现在我们把前面所有的理论揉进一个真实的、可复现的案例里。目标让 Zabbix 的任何告警都以一张美观的飞书卡片形式推送到指定的飞书群。全程使用 Hermes Desktop不碰命令行不装 Python不配环境变量。我会记录每一步的操作、预期结果、以及如果出错该怎么快速定位。4.1 准备工作Zabbix 侧的告警脚本与 Hermes Desktop 安装首先确保你的 Zabbix Server 能执行自定义脚本。Zabbix 的告警媒介Media Type支持“脚本”类型我们需要写一个极简的 Bash 脚本它接收 Zabbix 传来的参数{ALERT.SENDTO}、{ALERT.SUBJECT}、{ALERT.MESSAGE}然后用curl发给 Hermes 的 HTTP Webhook 接口。#!/bin/bash # 保存为 /usr/lib/zabbix/alertscripts/zabbix_to_hermes.sh # 给执行权限chmod x /usr/lib/zabbix/alertscripts/zabbix_to_hermes.sh # Hermes 的 Webhook 地址根据你的部署情况修改 HERMES_WEBHOOKhttp://localhost:8080/webhook/zabbix # Zabbix 传入的三个参数 TO$1 SUBJECT$2 MESSAGE$3 # 构造 JSON 体字段名必须和 config.yaml 中的 payload_mapping 严格对应 PAYLOAD$(cat EOF { host: $TO, severity: $SUBJECT, message: $MESSAGE } EOF ) # 发送 POST 请求 curl -X POST \ -H Content-Type: application/json \ -d $PAYLOAD \ $HERMES_WEBHOOK \ /dev/null 21这个脚本的精妙之处在于它把 Zabbix 原生的告警参数原封不动地、一字不差地映射成了 Hermes 期望的 JSON 字段。$TO对应host$SUBJECT对应severity$MESSAGE对应message。这样config.yaml里的payload_mapping就可以写得无比简单host: $.host。Hermes Desktop 的安装毫无难度。去 Hermes 官网github.com/hermes-lab/hermes-desktop/releases下载最新版.exeWindows或.dmgmacOS双击安装即可。安装完成后桌面会出现一个 Hermes 图标双击打开。4.2 Hermes Desktop 配置七步走每一步都有截图级指引文字版启动 Hermes Desktop点击左上角“ 新建集成”弹出对话框选择“飞书机器人”点击“下一步”。在“应用信息”页粘贴飞书凭证App ID、App Secret、Verification Token、Encrypt Key—— 这四个值全部来自你刚才在飞书开放平台后台“应用凭证”和“安全设置”页复制的内容。特别注意Verification Token和Encrypt Key必须是从“安全设置”页复制的不是“应用凭证”页的。填完后点击“测试连接”。如果一切顺利右下角会弹出绿色提示“连接成功”。如果失败99% 是Verification Token填错了回去再核对一遍。在“触发器”页选择“HTTP Webhook”因为我们用的是 Zabbix 的脚本所以不选“事件订阅”。点击“添加 Webhook”系统会自动生成一个唯一的path比如/webhook/zabbix。记住这个路径它就是 Zabbix 脚本里HERMES_WEBHOOKURL 的最后一部分。点击“保存”。在“动作”页点击“添加动作”在弹出的窗口里“触发器”下拉框选择你刚创建的/webhook/zabbix“机器人”下拉框选择你刚配置的飞书机器人名字就是你飞书后台创建机器人时填的“消息模板”选择“自定义”然后点击右侧的“编辑模板”按钮。在弹出的模板编辑器里粘贴以下 Jinja2 代码这是一个经过飞书卡片 Schema 验证的、最简但功能完整的告警卡片{ config: { wide_screen_mode: true, enable_forward: true }, header: { title: { content: Zabbix 告警{{ host }}, tag: plain_text } }, elements: [ { tag: div, text: { content: **主机**: {{ host }}\n**严重性**: {{ severity }}\n**详情**: {{ message }}, tag: lark_md } }, { tag: action, actions: [ { tag: button, text: { content: 查看详情, tag: plain_text }, url: https://your-zabbix-url/zabbix.php?actionproblem.view } ] } ] }关键点{{ host }}、{{ severity }}、{{ message }}这三个变量必须和 Zabbix 脚本里PAYLOAD的 JSON 字段名以及config.yaml里payload_mapping的 key 完全一致。编辑完点击“保存模板”。回到“动作”页点击“保存动作”此时一个完整的“Zabbix 告警 → Hermes → 飞书卡片”的链路就配置好了。Hermes Desktop 会在后台自动生成一份标准的config.yaml你可以在“设置” → “高级” → “查看配置文件”里看到它。它长这样已脱敏bots: - name: zabbix-bot app_id: cli_a1b2c3d4e5f6g7h8 app_secret: s9t0u1v2w3x4y5z6 verification_token: t7u8v9w0x1y2z3a4 encrypt_key: b5c6d7e8f9g0h1i2j3k4l5m6n7o8p9q0 triggers: - type: http_webhook name: zabbix-webhook path: /webhook/zabbix method: POST payload_mapping: host: $.host severity: $.severity message: $.message actions: - trigger: zabbix-webhook bot: zabbix-bot template: ./templates/zabbix_card.jinja2点击左上角“启动”按钮Hermes Desktop 会启动服务并在右下角状态栏显示“运行中”。此时Zabbix 脚本就可以调用http://localhost:8080/webhook/zabbix了。4.3 Zabbix 侧配置与最终测试从告警产生到飞书卡片抵达的端到端验证在 Zabbix Web 界面进入“管理” → “报警媒介类型” → 点击“创建媒介类型”名称Hermes Webhook类型脚本脚本名称zabbix_to_hermes.sh其他字段留空。进入“管理” → “用户” → 选择一个用户如 admin→ “报警媒介”标签页 → 点击“添加”类型选择刚创建的Hermes Webhook收件人填入你要监控的主机名如web-server-01这个值会作为$1传给脚本最终成为卡片里的host其他字段留空。进入“配置” → “动作” → “触发器”标签页 → 创建一个新动作名称Send to Hermes条件触发器 Zabbix agent is not running或其他你想测试的触发器操作点击“新建”在“发送消息给”里选择你刚配置的用户媒介选择Hermes Webhook最后手动触发一次告警进行测试最简单的方法在 Zabbix Server 上临时停掉一个被监控的 Zabbix Agent 服务systemctl stop zabbix-agent。几秒钟后Zabbix 会检测到Zabbix agent is not running并触发告警。此时Zabbix 会执行zabbix_to_hermes.sh脚本脚本向http://localhost:8080/webhook/zabbix发送一个 JSON 请求。Hermes Desktop 会捕获这个请求解析host、severity、message渲染zabbix_card.jinja2模板然后调用飞书 API将卡片推送到你指定的群。预期结果30 秒内你的飞书群会收到一张带 图标的卡片标题是“Zabbix 告警web-server-01”正文里清晰写着主机名、严重性和详情。卡片底部有一个“查看详情”按钮点击后跳转到你的 Zabbix 地址。如果失败按此顺序排查查看 Hermes Desktop 右下角状态栏是否显示“运行中”如果没有点击“启动”。查看 Hermes Desktop 的“日志”面板是否有Received webhook for /webhook/zabbix如果没有说明 Zabbix 脚本没调通检查脚本路径、权限、curl命令是否执行成功把 /dev/null 21去掉看终端输出。如果有Received webhook...但日志里紧接着是Template not found说明zabbix_card.jinja2路径错了回到“动作”页重新编辑模板并保存。如果有Sending card to lark...但飞书群没收到检查飞书机器人是否被禁用或者机器人所在的群是否给了机器人“发送消息”的权限在飞书群设置里找到机器人点“管理权限”。5. 常见问题与独家排查技巧那些文档里不会写的“血泪教训”Hermes 的文档很简洁但真实世界远比文档复杂。我把过去半年里帮客户解决的、最高频、最诡异的 12 个问题整理成一张速查表。每个问题都附带了“现象”、“根因”、“一招鲜排查法”和“永久规避方案”。这些都是我在凌晨三点对着日志屏幕熬出来的经验不是网上抄来的。问题现象根本原因一招鲜排查法永久规避方案Hermes 启动后日志里一直刷Invalid signatureconfig.yaml里的verification_token填错了或者飞书后台的Verification Token被重置了在 Hermes Desktop 的“日志”面板搜索signature找到那条报错日志它后面会跟着飞书发来的原始signature和timestamp。用在线 HMAC-SHA256 工具用你填的verification_token和timestamp计算签名对比是否一致在飞书开放平台后台把Verification Token复制下来后立刻在 Hermes Desktop 里粘贴并“测试连接”成功后再进行下一步配置Zabbix 告警脚本执行成功curl返回 200但 Hermes 日志里没有Received webhookZabbix 脚本里的HERMES_WEBHOOKURL 端口和 Hermes Desktop 启动的端口不一致在 Zabbix Server 上手动执行一遍脚本/usr/lib/zabbix/alertscripts/zabbix_to_hermes.sh web-server-01 High Zabbix agent down然后立刻在 Hermes Desktop 日志里搜索web-server-01。如果搜不到说明 URL 错了在 Hermes Desktop 的“设置” → “高级”里记下它当前监听的端口如8080然后在 Zabbix 脚本里把HERMES_WEBHOOK的 URL 端口强制写死为这个值不要用变量飞书卡片收到了但{{ host }}显示为None或空白Zabbix 脚本里构造的 JSON字段名和config.yaml里的payload_mappingkey 不匹配或者 JSON 格式有语法错误在 Hermes Desktop 日志里找到Received webhook...那行它后面会打印出完整的、未经解析的原始请求体。复制这段 JSON粘贴到在线 JSON 校验器jsonlint.com里看是否合法再用 JSONPath 测试器验证$.host是否能取到值在 Zabbix 脚本里用printf而不是echo构造 JSONprintf { host: %s, severity: %s, message: %s } $TO $SUBJECT $MESSAGEprintf能更好处理特殊字符Hermes Desktop 启动后CPU 占用率飙升到 100%Hermes Desktop 的 Electron 进程和 Hermes Core 进程通信异常通常是 Windows Defender 或其他杀毒软件将其误判为恶意程序任务管理器里找到hermes-desktop.exe进程右键“打开文件所在位置”将整个 Hermes Desktop 安装目录添加到杀毒软件的白名单在安装 Hermes Desktop 前先临时关闭 Windows Defender 的“实时保护”安装完成后再开启飞书卡片里的“查看详情”按钮点击后跳转到一个空白页按钮的url字段是一个相对路径如/zabbix而不是绝对 URL在 Hermes Desktop 的模板编辑器里选中按钮的url字段按CtrlA全选看它是不是以http://或https://开头。如果不是就是相对路径所有按钮url必须是完整的、可直接在浏览器地址栏粘贴的绝对 URL。可以用https://{{ env }}.your-company.com这种带环境变量的写法但必须以https://开头Hermes Desktop 更新后原来的配置全没了Hermes Desktop 的配置文件config.yaml和模板默认存储在%APPDATA%\Hermes Desktop\Windows或~/Library/Application Support/Hermes Desktop/macOS更新安装包时这个目录没有