208 lines
4.3 KiB
Markdown
208 lines
4.3 KiB
Markdown
---
|
||
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 并发处理
|