llm-intelligence/RUNBOOK.md

# LLM Intelligence Hub - 运维手册

> 版本: v1.1
> 日期: 2026-05-21

---

## 服务启停

### 启动全部服务
```bash
docker-compose up -d --build
```

### 停止服务
```bash
docker-compose down
```

### 查看日志
```bash
docker-compose logs -f app
docker-compose logs -f db
```

---

## 日常巡检

### 应用健康
```bash
curl http://localhost:8080/health
curl http://localhost:8080/api/v1/models
```

### 数据库健康
```bash
psql "$DATABASE_URL" -c "SELECT COUNT(*) FROM models WHERE deleted_at IS NULL"
psql "$DATABASE_URL" -c "SELECT source, success, created_at FROM collector_stats ORDER BY created_at DESC LIMIT 5"
```

### 日报检查
```bash
ls -la reports/daily/daily_report_$(date +%Y-%m-%d).md
```

### 磁盘空间
```bash
df -h /var/lib/postgresql
df -h /tmp
```

---

## 故障排查

### 采集器失败
1. 检查 API Key: `echo $OPENROUTER_API_KEY`
2. 检查网络: `curl https://openrouter.ai/api/v1/models`
3. 查看日志: `tail /tmp/llm_hub_daily_*.log`

### 数据库连接失败
1. 检查 PostgreSQL 状态: `pg_isready`
2. 检查连接串: `echo $DATABASE_URL`
3. 检查权限: `psql -c "\du"`

### 日报未生成
1. 检查 cron: `crontab -l | grep llm-intelligence`
2. 手动执行: `bash scripts/run_daily.sh`
3. 检查最近日报: `ls reports/daily/*.md | tail -1`

### 前端无法访问
1. 检查应用容器: `docker-compose ps app`
2. 检查首页响应: `curl -I http://localhost:8080/`
3. 检查 API 响应: `curl http://localhost:8080/api/v1/models`
4. 查看应用日志: `docker-compose logs -f app`

### 静态资源 404
1. 重新构建镜像: `docker-compose up -d --build`
2. 本地校验前端构建: `cd frontend && npm run build`
3. 确认容器内含有前端产物: `docker-compose exec app ls /app/frontend/dist`

---

## 备份恢复

### 手动备份
```bash
bash scripts/backup.sh
```

### 手动恢复
```bash
gunzip < backup_file.sql.gz | psql "$DATABASE_URL"
```

### 定时备份
```bash
0 2 * * * cd /path/to/llm-intelligence && bash scripts/backup.sh >> /tmp/backup.log 2>&1
```

---

## 监控指标

| 指标 | 告警阈值 | 检查命令 |
|------|----------|----------|
| 模型数 | `< 300` | `SELECT COUNT(*) FROM models` |
| 采集成功率 | `< 95%` | `SELECT success_rate FROM collector_stats` |
| 数据库连接 | 失败 | `pg_isready` |
| 磁盘空间 | `> 80%` | `df -h` |

---

## 联系信息

- 维护者: 宅相
- 项目路径: `D:\project\llm-intelligence`