openclaw/skills/kb-deep-analyzer/SKILL.md

name, description

name	description
kb-deep-analyzer	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

命令

# 分析视频
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	详细说明

成功示例

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

错误示例

API 调用失败

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

环境变量未设置

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

内容文件不存在

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

输出格式（Markdown）

视频分析输出

# 视频标题

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

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

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

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

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

文章分析输出

# 文章标题

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

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

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

安装

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

在 kb-workflow 中的使用

# 步骤 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 并发处理