Feishu Evolver Wrapper

核心用法

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 进程权限执行，需确保运行用户对目标目录有最小必要权限

核心用法

feishu-evolver-wrapper 是 capability-evolver 的飞书集成包装器，提供完整的进化循环管理功能：

1. 进化循环运行

node skills/feishu-evolver-wrapper/index.js

自动注入 EVOLVE_REPORT_TOOL 环境变量，启用飞书富卡片报告。

2. 仪表盘可视化

node skills/feishu-evolver-wrapper/visualize_dashboard.js

从 assets/gep/events.jsonl 生成 Markdown 格式的进化指标与历史可视化。

3. 生命周期管理

node skills/feishu-evolver-wrapper/lifecycle.js [start|stop|status|ensure]

• start/stop：启停守护进程
• status：查询运行状态
• ensure：自动修复（由 OpenClaw Cron evolver_watchdog_robust 每10分钟调用）

4. 历史导出

支持将原始进化历史导出至飞书文档。

---

显著优点

| 维度 | 优势 |

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

| **集成深度** | 原生飞书卡片支持，富文本报告比纯文本更易读 |

| **可靠性** | 内置 Watchdog 机制，10分钟级故障自愈 |

| **安全设计** | `scanForSecrets` 主动扫描，防止密钥随报告泄漏 |

| **可观测性** | 完整的仪表盘 + 历史追溯 + 状态管理 |

| **零依赖** | 无第三方 npm 包，25个文件纯 Node.js 实现 |

---

潜在缺点与局限性

| 问题 | 说明 |

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

| **命令注入风险** | `skills_monitor.js` 使用 `execSync` 验证技能语法，路径拼接存在注入可能（RISK-001） |

| **Git 操作耦合** | `self-repair.js` 直接调用系统 `git` 命令，跨平台兼容性受限（RISK-002） |

| **临时文件竞争** | `issue_tracker.js` 在 `/tmp` 创建可预测文件名，存在条件竞争（RISK-003） |

| **Linux 依赖** | `/proc` 文件系统读取限制为 Linux 环境，其他平台需回退方案（RISK-005） |

| **权限要求** | 需 `child_process.spawn` 创建守护进程，对运行环境有一定权限要求 |

---

适合人群

• 已部署飞书办公套件的团队，希望将 AI 能力进化过程可视化
• 需要无人值守自动化的场景，依赖 Watchdog 保证服务连续性
• 对安全有一定要求的用户（内置 secrets 扫描，HTTPS-only 通信）
• OpenClaw / GEP 生态系统现有用户，需扩展报告渠道

---

常规风险

1. 配置泄露风险：需妥善保管 FEISHU_APP_ID、OPENCLAW_MASTER_ID、FEISHU_EVOLVER_DOC_TOKEN 等环境变量
2. API 调用成本：高频进化循环可能触发飞书 API 限流，建议合理设置进化间隔
3. 进程残留：极端情况下守护进程可能残留，需配合 lifecycle.js status 定期检查
4. JSONL 数据膨胀：events.jsonl 长期运行可能体积过大，需配置日志轮转