From 978613461b6bb17cf6363bbf7bf928a98fbb27b2 Mon Sep 17 00:00:00 2001 From: starmen1265 Date: Thu, 19 Mar 2026 23:18:50 +0800 Subject: [PATCH] docs: create milestone v1.5 requirements and roadmap --- .planning/REQUIREMENTS.md | 60 +++++++++++++++++++++++++++++++++++++++ .planning/ROADMAP.md | 34 ++++++++++++++++++++-- 2 files changed, 92 insertions(+), 2 deletions(-) create mode 100644 .planning/REQUIREMENTS.md diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md new file mode 100644 index 0000000..24df75e --- /dev/null +++ b/.planning/REQUIREMENTS.md @@ -0,0 +1,60 @@ +# Requirements: kb-skills v1.5 + +**Defined:** 2026-03-19 +**Core Value:** 简化 B 站视频处理流程，生成易读的 Markdown 文档 + +## v1.5 Requirements + +### SRT Processing + +- [ ] **SRT-01**: 系统能解析 SRT 字幕文件格式 +- [ ] **SRT-02**: 系统能移除时间戳，提取纯文本内容 +- [ ] **SRT-03**: 系统能根据内容主题变化自动划分语义段落 +- [ ] **SRT-04**: 系统能使用 LLM 根据上下文修正语音识别错误 + +### Output + +- [ ] **OUT-01**: 系统能生成结构化的 Markdown 文件 +- [ ] **OUT-02**: 系统能在 Markdown 中保留视频元数据（标题、作者等） +- [ ] **OUT-03**: 系统能保留原有的元数据处理功能（BilibiliAdapter） +- [ ] **OUT-04**: 系统能继续生成视频标签（基于元数据） + +### Scope Change + +- [ ] **SCOPE-01**: 移除深度观点分析功能（DeepAnalyzer） +- [ ] **SCOPE-02**: 仅针对 B 站视频，不影响其他平台处理器 + +## Out of Scope + +| Feature | Reason | +|---------|--------| +| 知乎内容处理 | 本次只改 B 站 | +| 观点提炼 | 明确移除 | +| 并行处理 | 不需要 | +| 进度显示 | Deferred | + +## Traceability + +Which phases cover which requirements. Updated during roadmap creation. + +| Requirement | Phase | Status | +|-------------|-------|--------| +| SRT-01 | Phase 12 | Pending | +| SRT-02 | Phase 12 | Pending | +| SRT-03 | Phase 12 | Pending | +| SRT-04 | Phase 12 | Pending | +| OUT-01 | Phase 12 | Pending | +| OUT-02 | Phase 12 | Pending | +| OUT-03 | Phase 12 | Pending | +| OUT-04 | Phase 12 | Pending | +| SCOPE-01 | Phase 12 | Pending | +| SCOPE-02 | Phase 12 | Pending | + +**Coverage:** +- v1.5 requirements: 10 total +- Mapped to phases: 10 +- Unmapped: 0 ✓ + +--- +*Requirements defined: 2026-03-19* +*Last updated: 2026-03-19 after initial definition* diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index 3a04712..51e0c69 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -7,6 +7,7 @@ - ✅ **v1.2 Zhihu Crawler** - Phases 7-9 (shipped 2026-03-17) - ✅ **v1.3 Proxy Pool** - Phase 10 (shipped 2026-03-18) - ✅ **v1.4 Zhihu Anti-Crawler** - Phase 11 (shipped 2026-03-18) +- ◆ **v1.5 B站字幕简化处理** - Phase 12 (in progress) ## Phases @@ -126,6 +127,34 @@ Plans: --- +## ◆ v1.5 B站字幕简化处理 (IN PROGRESS) + +**Milestone Goal:** 简化 B 站视频处理流程，基于 SRT 字幕生成易读的 Markdown 文档 + +### Phase 12: SRT 简化处理器 +**Goal**: 实现 SRT 字幕处理，生成简化的 Markdown 文档，保留元数据和标签，移除深度分析 +**Depends on**: Phase 4 (Pipeline) +**Requirements**: SRT-01, SRT-02, SRT-03, SRT-04, OUT-01, OUT-02, OUT-03, OUT-04, SCOPE-01, SCOPE-02 +**Success Criteria** (what must be TRUE): + 1. 用户运行 `kb-workflow process ` 后生成 Markdown 文件而非深度分析报告 + 2. Markdown 文件包含视频元数据（标题、作者、时长） + 3. 元数据处理功能保持不变（BilibiliAdapter 正常工作） + 4. 视频标签继续正常生成 + 5. 字幕文本已去除时间戳，按语义分段 + 6. 明显的语音识别错误已被 LLM 纠正 + 7. DeepAnalyzer 相关代码已移除或禁用 + 8. 知乎等其他平台处理器不受影响 +**Plans**: 2 plans (pending) + +Plans: +- [ ] 12-01-PLAN.md — SRT 处理器实现（解析、去时间戳、分段、纠正） +- [ ] 12-02-PLAN.md — 集成与测试，移除 DeepAnalyzer + +**Key Decisions:** +- (to be determined during planning) + +--- + ## Progress **Execution Order:** @@ -143,8 +172,9 @@ Phases execute in numeric order: 1 → 2 → ... → 10 → 11 | 8. 内容爬取实现 | v1.2 | 3/3 | Complete | 2026-03-17 | | 9. Pipeline 整合 | v1.2 | 1/1 | Complete | 2026-03-17 | | 10. Proxy Pool | v1.3 | 2/2 | Complete | 2026-03-18 | -| 11. Stealth Fingerprinting | v1.4 | Complete | 2026-03-18 | 2026-03-18 | +| 11. Stealth Fingerprinting | v1.4 | 2/2 | Complete | 2026-03-18 | +| 12. SRT 简化处理器 | v1.5 | 0/2 | Pending | — | --- -*Last updated: 2026-03-18* +*Last updated: 2026-03-19*