---
name: kb-deep-analyzer
description: AI深度分析 - 使用 AI 对内容进行深度分析和摘要
---

# KB Deep Analyzer Skill

**kb-deep-analyzer** - AI 深度内容分析工具。

## 什么时候使用

- kb-workflow 步骤 5：对视频字幕或文章内容进行深度分析
- 需要生成摘要、主题、见解等

## 功能

- 多类型分析：视频（video）、文章（article）
- 模板化输出
- 质量评分
- 自动标签
- 多格式元数据支持

## 环境变量（必需）

| 变量名 | 说明 | 示例 |
|--------|------|------|
| `AI_API_KEY` | AI API 密钥 | `your-api-key` |
| `AI_PROVIDER` | AI 提供商 | `zhipu` / `openai` / `minimax` |
| `AI_MODEL` | 模型名称 | `glm-5` / `gpt-4` |
| `AI_BASE_URL` | API 端点 | `https://open.bigmodel.cn/api/coding/paas/v4` |

## 命令

```bash
# 分析视频
AI_API_KEY="xxx" AI_PROVIDER="zhipu" AI_MODEL="glm-5" \
python3 -u deep_analyzer.py \
    --metadata meta.json \
    --content content.json \
    --output analysis.md \
    --type video \
    --provider zhipu --model glm-5

# 分析文章
AI_API_KEY="xxx" AI_PROVIDER="zhipu" AI_MODEL="glm-5" \
python3 -u deep_analyzer.py \
    --metadata meta.json \
    --content content.txt \
    --output analysis.md \
    --type article \
    --provider zhipu --model glm-5
```

## 参数说明

| 参数 | 说明 | 必需 |
|------|------|------|
| `--metadata` | 元数据 JSON 文件路径 | 是 |
| `--content` | 内容文件路径（JSON/TXT） | 是 |
| `--output` | 输出 Markdown 文件路径 | 是 |
| `--type` | 内容类型（video/article） | 是 |
| `--provider` | AI 提供商 | 否（默认从环境变量） |
| `--model` | 模型名称 | 否（默认从环境变量） |

## 输出格式 Schema

### 必需字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `success` | boolean | 是否分析成功 |

### 成功时字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `output_file` | string | 输出文件路径 |
| `model` | string | 使用的模型 |
| `provider` | string | 使用的提供商 |

### 失败时字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `error` | string | 错误信息 |
| `message` | string | 详细说明 |

## 成功示例

```json
{
  "success": true,
  "output_file": "analyzed/bilibili_BV1xx411c7mD.md",
  "model": "glm-5",
  "provider": "zhipu"
}
```

## 错误示例

### API 调用失败

```json
{
  "success": false,
  "error": "AI API 调用失败: rate limit exceeded",
  "message": "深度分析失败，整个流程终止"
}
```

### 环境变量未设置

```json
{
  "success": false,
  "error": "AI_API_KEY 环境变量未设置",
  "suggestion": "请配置 AI_API_KEY 环境变量"
}
```

### 内容文件不存在

```json
{
  "success": false,
  "error": "内容文件不存在",
  "content_file": "content/missing.json"
}
```

## 输出格式（Markdown）

### 视频分析输出

```markdown
# 视频标题

## 摘要
[200-300字的核心内容摘要]

## 主要主题
- 主题1
- 主题2
- 主题3

## 关键见解
- 见解1
- 见解2

## 时间轴
- 00:00 - 02:30: 第一部分
- 02:30 - 05:00: 第二部分
...

## 标签
#标签1 #标签2 #标签3
```

### 文章分析输出

```markdown
# 文章标题

## 摘要
[300字以内的核心观点]

## 主要主题
- 主题1
- 主题2

## 完整原文
[原始文章内容]
```

## 安装

```bash
cp -r kb-deep-analyzer/ ~/.openclaw/skills/
pip install httpx
```

## 在 kb-workflow 中的使用

```bash
# 步骤 5：深度分析
# ⚠️ 必须成功，否则整个流程失败

AI_API_KEY="$AI_API_KEY" AI_PROVIDER="zhipu" AI_MODEL="glm-5" \
python3 -u ~/.openclaw/skills/kb-deep-analyzer/deep_analyzer.py \
    --metadata "metadata/bilibili_BV1xx411c7mD.meta.json" \
    --content "content/bilibili_BV1xx411c7mD.json" \
    --output "analyzed/bilibili_BV1xx411c7mD.md" \
    --type video \
    --provider zhipu --model glm-5

# 检查结果：
# - success=true → 进入步骤 6（归档）
# - success=false → 整个流程终止，报告错误
```

## ⚠️ 重要提示

1. **必须使用 `-u` 参数**：确保 Python 输出实时显示
2. **深度分析不可跳过**：这是必须成功的步骤
3. **失败即终止**：如果返回 `success: false`，整个流程必须停止
4. **禁止降级**：不能使用预设模板或简单摘要"假装成功"
5. **并发执行**：默认使用 batch_size=3 并发处理