starmen1265
cf7cbd2ad0
PR Test / lint (pull_request) Successful in 2s
- 新增 --type article 参数
- 文章类型生成 300 字摘要 + 完整原文
- 视频类型保持原有时间轴分析逻辑
- 更新相关文档
🤖 Generated by AI
100 lines
3.4 KiB
Markdown
100 lines
3.4 KiB
Markdown
# kb-deep-analyzer 文章支持 - Implementation Plan
|
||
|
||
**Goal:** 让 kb-deep-analyzer 对文章内容生成 300 字摘要 + 原文 + 元数据，而非视频的时间轴分析
|
||
**Approach:** 在 deep_analyzer.py 中根据 `--type` 参数选择不同的 prompt 模板
|
||
**Estimated Total Time:** 30 分钟
|
||
|
||
## Checkpoint 1: 修改 deep_analyzer.py 核心逻辑 (~15 min)
|
||
|
||
- [ ] Task 1.1: 修改 `_build_prompt` 方法签名，添加 `content_type` 参数 (~2 min)
|
||
- **Action:** 在方法签名中添加 `content_type: str = "video"`
|
||
- **Verify:** 方法签名正确
|
||
|
||
- [ ] Task 1.2: 提取视频 prompt 为 `_build_video_prompt` 方法 (~3 min)
|
||
- **Action:** 将现有逻辑移到独立方法
|
||
- **Verify:** 原有视频分析功能不受影响
|
||
|
||
- [ ] Task 1.3: 新增 `_build_article_prompt` 方法 (~5 min)
|
||
- **Action:** 创建文章专用 prompt：
|
||
- 300 字以内摘要，描述核心观点
|
||
- 主要主题（不超过 5 个）
|
||
- 标签（3-5 个）
|
||
- **不包含时间轴**
|
||
- **Verify:** prompt 模板符合需求
|
||
|
||
- [ ] Task 1.4: 修改 `_build_prompt` 根据 `content_type` 分发 (~2 min)
|
||
- **Action:**
|
||
```python
|
||
if content_type == "article":
|
||
return self._build_article_prompt(...)
|
||
else:
|
||
return self._build_video_prompt(...)
|
||
```
|
||
- **Verify:** 类型判断正确
|
||
|
||
- [ ] Task 1.5: 修改 `analyze` 方法，传递 `content_type` (~2 min)
|
||
- **Action:** 将 content_type 传递到 _build_prompt
|
||
- **Verify:** 调用链正确
|
||
|
||
- [ ] Task 1.6: 修改 `main` 函数，传递 type 参数 (~1 min)
|
||
- **Action:** `analyzer.analyze(metadata, content, args.type)`
|
||
- **Verify:** 命令行参数正确传递
|
||
|
||
## Checkpoint 2: 修改输出格式逻辑 (~5 min)
|
||
|
||
- [ ] Task 2.1: 文章输出时保留原文 (~3 min)
|
||
- **Action:** 在文章类型分析完成后，追加原文内容
|
||
- **格式:**
|
||
```markdown
|
||
## 摘要
|
||
[AI 生成的 300 字摘要]
|
||
|
||
## 主要主题
|
||
- 主题1
|
||
- 主题2
|
||
|
||
## 原文
|
||
[完整的文章原文]
|
||
```
|
||
- **Verify:** 输出格式正确
|
||
|
||
- [ ] Task 2.2: 调整 frontmatter 生成逻辑 (~2 min)
|
||
- **Action:** 文章类型不包含 duration 字段
|
||
- **Verify:** frontmatter 格式正确
|
||
|
||
## Checkpoint 3: 更新文档 (~5 min)
|
||
|
||
- [ ] Task 3.1: 更新 kb-deep-analyzer/SKILL.md (~3 min)
|
||
- **Action:** 添加 `--type article` 的使用说明
|
||
- **Verify:** 文档清晰
|
||
|
||
- [ ] Task 3.2: 确认 kb-workflow/SKILL.md 已正确传递 type 参数 (~2 min)
|
||
- **Action:** 检查步骤 6 的命令是否包含 `--type` 参数
|
||
- **Verify:** workflow 文档正确
|
||
|
||
## Checkpoint 4: 测试验证 (~5 min)
|
||
|
||
- [ ] Task 4.1: 单元测试 - 视频类型不受影响 (~2 min)
|
||
- **Action:** 确认 `--type video` 行为不变
|
||
- **Verify:** 无回归
|
||
|
||
- [ ] Task 4.2: 集成测试 - 文章类型输出正确 (~3 min)
|
||
- **Action:** 用一篇知乎文章测试 `--type article`
|
||
- **Verify:** 输出包含摘要 + 原文，无时间轴
|
||
|
||
## Verification Criteria
|
||
|
||
- [ ] `python deep_analyzer.py --type video` 行为与之前一致
|
||
- [ ] `python deep_analyzer.py --type article` 生成 300 字摘要 + 原文
|
||
- [ ] 文章输出无"时间轴"部分
|
||
- [ ] frontmatter 正确（文章无 duration）
|
||
- [ ] SKILL.md 文档已更新
|
||
|
||
## Execution Options
|
||
|
||
**1. Single-Agent (this session)** - 我在本会话中顺序执行任务，每个 checkpoint 汇报
|
||
|
||
**2. Dispatch Sub-Agent** - 启动子代理执行开发任务
|
||
|
||
选择哪种方式？
|