Feishu Evolver Wrapper

核心用法

feishu-evolver-wrapper 是 capability-evolver 技能的飞书集成封装层，主要解决进化算法在团队协作环境中的可观测性问题。核心能力包括：

1. 进化循环管理：通过 index.js 运行 GEP 进化周期，自动注入 EVOLVE_REPORT_TOOL 环境变量激活飞书卡片报告
2. 生命周期管控：lifecycle.js 提供 start/stop/status/ensure 四态管理，支持守护进程模式
3. 可视化仪表板：visualize_dashboard.js 将 assets/gep/events.jsonl 中的历史数据渲染为 Markdown 格式报告
4. 文档导出：支持将原始进化历史导出至飞书文档
5. Watchdog 机制：依赖 OpenClaw Cron 任务 evolver_watchdog_robust 每 10 分钟执行 lifecycle.js ensure，替代脆弱的系统 crontab，确保崩溃或挂起时自动重启

显著优点

• 开箱即用的飞书集成：无需手动配置 webhook，环境变量自动注入
• 高可用设计：双层保险（主动 lifecycle 管理 + 被动 watchdog 监控）
• 可观测性完备：实时卡片报告 + 历史仪表板 + 原始数据导出三位一体
• 与 OpenClaw 生态深度整合：利用系统级 Cron 而非外部依赖

潜在局限

• 强依赖飞书环境：EVOLVE_REPORT_TOOL 未配置时核心功能降级
• 事件日志路径固定：硬编码 assets/gep/events.jsonl，灵活性受限
• Node.js 运行时依赖：不适合纯 Python 或容器化隔离环境
• watchdog 粒度较粗：10 分钟检测间隔对实时性要求高的场景可能不足

适合人群

• 使用飞书作为协作平台的 AI/ML 研发团队
• 需要长期运行进化算法且要求可视化监控的场景
• 已部署 OpenClaw 系统并熟悉 GEP（基因表达式编程）的用户

常规风险

• 日志累积风险：events.jsonl 长期运行可能体积膨胀，需定期轮转
• 权限边界：飞书卡片 API 调用需确保机器人具备相应群组权限
• 状态漂移：lifecycle 状态与实际进程状态可能因信号处理异常产生不一致
• 资源泄漏：Node.js 进程异常退出时，watchdog 重启可能产生孤儿进程

核心功能

feishu-evolver-wrapper 是 capability-evolver 的飞书集成包装器，主要提供三大能力：

1. 进化循环管理：封装 GEP（基因表达式编程）进化循环，支持启动/停止/状态检查/自动恢复等生命周期管理
2. 飞书富文本报告：自动生成美观的飞书卡片消息，展示进化进度、最佳表现、历史趋势等关键指标
3. 可视化仪表板：基于 Markdown 的本地仪表板，从 events.jsonl 历史数据生成进化态势分析

显著优点

• 进程管理稳健：采用 PID 文件锁实现单例模式，配合 OpenClaw Cron 看门狗每 10 分钟自动保活，防止重复运行和崩溃挂死
• 安全机制完善：内置 scanForSecrets 敏感信息扫描，在发送飞书消息前自动检测 API Key、Token、私钥等，防止密钥泄露
• 架构清晰：职责分离明确（index.js 主循环、lifecycle.js 生命周期、report.js 报告生成、feishu-helper.js API 封装）
• 依赖极简：仅依赖 commander 一个第三方包，供应链攻击面极小
• 合规性较好：GDPR 数据最小化、CCPA 用户知情权、TLS 加密传输均通过认证

潜在缺点与局限

| 风险点 | 严重度 | 说明 |

|--------|--------|------|

| `child_process` 系统命令执行 | 🟠 中 | 多处使用 `execSync/spawn` 执行 git 操作（add/commit/pull/push/fetch/rebase/merge）、进程管理（ps）、npm install 等，存在命令注入风险 |

| `new Function` 动态代码执行 | 🟠 中 | 在解析 `sessions_spawn` JSON payload 时作为 fallback 使用，若输入不可信可导致任意代码执行 |

| 环境变量读取 | 🟡 低 | 读取 `FEISHU_APP_ID`、`OPENCLAW_MASTER_ID` 等敏感配置，虽为功能必需但需确保权限控制 |

| 文件系统操作广泛 | 🟡 低 | 大量读写 PID 文件、锁文件、计数器、配置状态、事件日志等，需注意路径遍历防护 |

适合人群

• 已部署 capability-evolver 并需要飞书集成报告的自动化运维团队
• 需要无人值守进化监控的研究或生产环境（依赖看门狗自动恢复）
• 具备 Node.js 安全审查能力、能验证输入转义的技术团队

常规风险

1. 代码注入风险：new Function 和 child_process 的未转义输入可能导致 RCE，建议在沙箱环境先行测试
2. 密钥泄露风险：虽内置 secret 扫描，但环境变量配置错误仍可能导致凭证暴露
3. 资源占用风险：进化循环为 CPU 密集型任务，长时间运行需监控资源使用
4. 飞书 API 限制：高频报告可能触发飞书 API 速率限制，需合理配置报告间隔