baileyh8/hermes-feishu-streaming-card v3.5.1

V3.5.1 — 2026-06-01

on GitHub

核心介绍

V3.5.1 是 V3.5.0 之后的稳定性补丁版，重点修复真实飞书流式卡片中的更新乱序/积压、交互按钮渲染、queued follow-up 原生消息溢出，以及手动重启 sidecar 时 .env 凭据未加载的问题。

主要更新

• 同一 message id 的 runtime event 发送、sidecar 状态更新和终态 Feishu PATCH 增加排序/合并保护，减少思考/答案漏字、截断和回退。
• sidecar 非终态事件快速 ACK，卡片更新合并；终态事件继续等待落卡，避免 message.completed 后仍有更新积压。
• 飞书卡片按钮切换为 JSON 2.0 button + behaviors.callback，修复 approval/choice 按钮进入活动卡片时 PATCH 失败。
• queued follow-up completion 进入卡片路径，成功投递后抑制 Hermes 原生 resend，避免灰色 text 溢出。
• answer.delta / thinking.delta 保留原始边界空格，降低句子和代码片段拼接损伤。
• load_config() 会读取 config 同目录 .env，真实进程环境变量仍优先，避免手动启动 sidecar 时误进入 no-op client。
• 中文 README 首页重新整理，突出场景、价值、安装升级、FAQ 和版本历史。

升级

升级后请重新安装 hook：

git checkout v3.5.1
pip install -e \".[test]\" --upgrade
python3 -m hermes_feishu_card.cli install --hermes-dir ~/.hermes/hermes-agent --yes
python3 -m hermes_feishu_card.cli start --config ~/.hermes/config.yaml

验证

• python3 -m pytest：541 passed
• git diff --check：通过
• GitHub Actions PR #44：Python 3.9 / 3.12 全部通过