核心用法
Feishu Evolver Wrapper 是 capability-evolver 的轻量级封装层,专为企业飞书环境设计。用户可通过三个入口调用:
1. 进化循环执行:node index.js —— 启动 GEP 进化周期,自动注入飞书环境变量 (EVOLVE_REPORT_TOOL) 实现富卡片报告推送
2. 仪表板生成:node visualize_dashboard.js —— 从 assets/gep/events.jsonl 解析指标与历史数据,输出 Markdown 格式可视化报告
3. 生命周期管理:node lifecycle.js [start|stop|status|ensure] —— 支持守护进程启停、状态查询及故障自愈(ensure 模式)
架构亮点:通过 OpenClaw Cron 任务 evolver_watchdog_robust(每 10 分钟执行 lifecycle.js ensure)替代传统系统 crontab,提供比原生定时任务更健壮的崩溃/挂起检测与自动重启机制。
显著优点
- 零配置集成:自动检测并注入飞书汇报环境,无需手动配置 webhook
- 企业级可观测性:富卡片报告替代纯文本日志,支持@相关人员、按钮交互等原生飞书能力
- 高可用保障:Watchdog 机制确保进化循环 7×24 小时持续运行,故障恢复时间 < 10 分钟
- 数据资产沉淀:原生支持导出完整历史至飞书文档,便于审计与复盘
潜在局限
- 环境锁定:强依赖飞书生态,非飞书用户无法使用报告功能
- 事件日志依赖:仪表板可视化需依赖本地
events.jsonl文件,分布式部署时需额外配置共享存储 - Node 运行时限制:仅支持 Node.js 环境,无 Python/Go 等语言原生绑定
适合人群
- 已采用飞书作为协作平台的 AI/ML 团队
- 需要可视化监控模型进化过程的研发负责人
- 追求自动化运维、减少人工值守的 MLOps 工程师
常规风险
- 令牌泄露风险:
EVOLVE_REPORT_TOOL若配置不当可能导致飞书 bot 令牌暴露,建议通过 Secrets Manager 注入 - 无限循环风险:进化算法本身存在不收敛可能,需配合
ensure机制的熔断策略使用 - 存储膨胀:
events.jsonl长期运行可能产生大文件,建议配置定期归档或压缩策略 - 权限越界:生命周期脚本以 Node 进程权限执行,需确保运行用户对目标目录有最小必要权限