hermes-feishu-streaming-card

用途：将 Hermes Agent Gateway 在飞书/Lark 中的响应转为持续更新的交互卡片，替代碎片化的灰色文本消息。主要能力：同一张卡片实时更新 thinking.delta、answer.delta、tool.updated、message.completed；把 Hermes 的审批/澄清选项渲染为飞书按钮（callback 模式）或编号选项（本地/私有 sidecar）；Markdown 表格与代码块按结构边界拆分，长内容稳定显示；支持多飞书机器人、多 Hermes Profile、群聊绑定与路由诊断；独立 sidecar 进程处理飞书 API 调用、状态机、重试与健康检查；fail-open 设计，钩子失败不影响网关，回退为原始文本消息。使用方式：需 Python 3.9+、Hermes Gateway v0.13.0+ 或 v2026.4.23+，以及具备凭证的飞书机器人。安装：pip install hermes-feishu-streaming-card；hermes-feishu-card doctor --hermes-dir ~/.hermes/hermes-agent；hermes-feishu-card install --hermes-dir ~/.hermes/hermes-agent --yes；随后重启 Hermes Gateway。配置存放于 ~/.hermes-feishu-card/config.yaml，含飞书凭证、sidecar 主机端口、卡片标题与表情、interaction_mode（auto/callback/text）、内容分块与表格行数限制等。常用命令：start/stop/status/logs 管理 sidecar，doctor --explain/--json 诊断，repair/restore/uninstall 维护安装状态，bots test 测试机器人，smoke-feishu-card 发送测试卡片；健康检查端点 http://localhost:8765/health 及 /health.routing.profiles。适用场景：把 Hermes 智能体接入飞书群或个人对话，需要流式展示推理与工具调用、卡片内审批交互、长表格代码稳定渲染、多机器人按 Profile 路由的团队。限制：插件为 sidecar 架构，需独立进程运行；callback 按钮模式需要公网回调 URL，本地/私有部署只能使用文本选项模式；飞书单表行数上限 50，卡片内容需分块；不同 Hermes 版本钩子策略不同（旧版用 legacy_gateway_run）；Hook 失败时设计为 fail-open，功能降级但不断开网关。具体价格、授权方式等资料暂未提供。