BiBot
Agentic BI 项目的专属运维机器人，负责健康检查、工作区维护、前后端部署和技能管理。
概述
BiBot（📊）是 Agentic BI 研究项目的专属 Mattermost Bot，运行在 OpenClaw 平台上，使用 github-copilot/claude-sonnet-4.6 模型。主要职责包括：定期健康检查 bi.dora.restry.cn / bi.dev.dora.restry.cn 站点可用性、工作区同步维护（sync.mjs）、PM2 服务管理、以及前后端问题诊断与自动修复。
基本信息
| 属性 | 值 |
|---|---|
| Bot 用户名 | @bibot |
| Emoji | 📊 |
| 模型 | github-copilot/claude-sonnet-4.6 |
| 工作区 | workspace-research-bi |
| 项目 | Agentic BI（已归档） |
| GitHub | msdevhub/agentic-bi |
核心功能
1. 定期健康检查
BiBot 通过 Cron 任务定期检查 BI 站点可用性（约每 6 小时）。检查内容包括：
- HTTP 状态码（检测 502 Bad Gateway 等错误）
- 后端 uvicorn 进程是否运行
- 前端静态服务是否在线
- Caddy 反向代理配置是否正确
2. 工作区维护（sync.mjs）
定期执行 sync.mjs 同步脚本，报告内容包括：
- CONTEXT.md 文件新鲜度（超过 4 天标记为 stale）
- tasks.json 任务完成状态（6/6 全部完成）
- 近期会话活动数量
- 记忆归档需求
3. 自定义技能管理
后端注册了 9 个自定义分析技能，位于 poc/v1-simple/backend/skills/ 目录：
| # | 技能名 | 用途 |
|---|---|---|
| 1 | general_query | 通用 SQL 查询（兜底技能） |
| 2 | year_over_year | 同比分析（保费/理赔同比增长） |
| 3 | top_n | TopN 排名（地区/险种/渠道排名） |
| 4 | trend | 时间趋势分析（月/季/年粒度） |
| 5 | loss_ratio | 赔付率分析（各维度 JOIN 计算） |
| 6 | claim_analysis | 理赔深度分析（时效/拒赔率/金额分布） |
| 7 | customer_profile | 客户画像（年龄/性别/交叉分析） |
| 8 | product_mix | 产品结构（险种占比/新单率/续保率） |
| 9 | channel_performance | 渠道绩效（佣金率/代理人产能/排名） |
4. 服务部署与修复
BiBot 能自动诊断和修复部署问题：
- 前端构建问题：发现
require("@logto/react")CommonJS 调用导致浏览器报错，重新npm run build修复 - 后端启动：通过 PM2 托管
uvicorn backend.main:app --port 8899 - Caddy 路由修复：为
bi.dev.dora.restry.cn配置/api/*→ 后端 8899、其他 → 前端 3016 的分流规则
服务架构
bi.dev.dora.restry.cn (Caddy)
├── /api/* → 后端 uvicorn (port 8899, PM2: bi-backend)
└── /* → 前端静态文件 (port 3016, PM2: dev-bi)
关键事件时间线
- 2026-03-17: 首次上线，OpenClaw 配对
- 2026-03-17~19: 持续报告 502 健康检查告警（项目已归档，预期行为）
- 2026-03-19: 诊断出 Caddy 配置指向错误端口（5173 vs 3016）
- 2026-03-20: 修复前端 require 报错、启动后端、配置 Caddy API 路由分流
- 2026-03-20: 列出 9 个自定义技能
- 2026-03-20~24: 持续工作区维护报告，一切正常
- 2026-03-30: bi-backend 消失后自动重启，确认 9 个技能加载