Hermes Feishu Streaming Card v4.3.0
V4.3.0 为 Hermes Agent v2026.8.3(固定 commit 3c27eb6234bf91b8ceee9e9071591b31e9b148cb)增加经过源码能力探测的 Hybrid 集成。可验证的 Hermes Plugin hooks 负责原生生命周期,缺失的 UI/投递边界由 17 个精确 patch group 补齐;Sidecar 仍是唯一飞书卡片 owner,未知或不完整证据继续 fail-closed。
主要变化
- 新增正式
hermes_agent.pluginsentry point、真实PluginContext注册和 signed runtime bootstrap。 - 固定 tag probe 绑定源码 commit、9 个完整源码哈希、24 个 call-site slice、运行时 Python、distribution/entrypoint 与真实 PluginManager subprocess evidence。
manifest_version: 3绑定 Hermes home、venv Python、purelib/platlib、plugin enable 配置前像、7 个源码 backup 和事务 phase;install幂等,repair、restore、uninstall可验证收敛。- approval、clarify 与 slash interaction 通过独立 loopback signed callback listener 直接唤醒 Hermes 原始 pending handle/future;Sidecar
/events增加 event-id single-flight fence 和精确 replay/conflict 语义。 - subagent 使用独立 timeline;工具完成回调安装在 Hermes core 最终 assignment 后,不再永久停在“进行中”。
- 新增 Linux
enable/disable常驻服务生命周期和 ownership 校验。
已解决的社区问题
- #210:冻结卡终态统计。
- #211:连续 clarify 的已选回显串线。
- #212:stale pidfile / 跨 boot 恢复。
- #214:Hermes
2026.8.3安装后 sidecar 正常但卡片不启用。 - #215:Hermes 升级后经验证的 ownership 恢复与重新安装。
- #217:重复授权卡与授权不生效。
- #221:tool timeline 永久 running。
- #222:
interaction.select遇到瞬时传输错误时做总预算受限的安全重试;吸收 PR #223 的目标,并额外保证HTTPError/应用错误不重试、不向 Feishu callback 传播。 - 吸收 PR #213、#220、#218、#219 中适用于 active runtime / release 的改动。
Issue #216 报告的是飞书平台未通过长连接推送 card.action.trigger。平台端事件为零时,本地插件无法重建点击;本版本不宣称修复该平台投递边界。
发布验证
- Release commit:
b13fccbf72f912890d452ec0cfc126b0adc07c88(PR #224 merge commit)。 - PR CI:Python 3.9 / 3.10 / 3.11 / 3.12、macOS、Windows、Docker Compose、Feishu SDK、PowerShell installer、fixed Hermes fixture、CodeQL 全部通过。
- 精确 merge SHA 独立 clone:
3228 passed, 6 skipped;git diff --check通过。 - release-assets workflow attempt 3 全部通过,并在上传前再次校验 annotated tag、main ancestry 和精确 commit。
- 四个公开资产均通过 checksums;macOS/Linux tar 与 Windows zip 完整性检查通过。
- 从公开 GitHub
v4.3.0tag URL 安装到全新 Python 3.12 venv 后,版本为4.3.0、package origin 位于site-packages、Hermes plugin entrypoint 精确唯一、CLI--help为 exit 0。
安装与升级
export HFC_VERSION=v4.3.0
bash install.sh --hermes-home ~/.hermes安装后验证:
hermes-feishu-card doctor --config ~/.hermes_feishu_card/config.yaml --hermes-dir ~/.hermes/hermes-agent --explain
hermes-feishu-card status --config ~/.hermes_feishu_card/config.yaml --hermes-dir ~/.hermes/hermes-agent下载前请使用 hermes-feishu-card-v4.3.0-checksums.txt 校验对应平台资产。