This repository has been archived on 2026-08-07. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
kb-skills/.planning/STATE.md
T

108 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
gsd_state_version: 1.0
milestone: v1.4
milestone_name: Zhihu Anti-Crawler
status: planning
stopped_at: Phase 13 context gathered
last_updated: "2026-03-21T16:14:07.594Z"
last_activity: 2026-03-21 — Roadmap created for v1.6
progress:
total_phases: 15
completed_phases: 10
total_plans: 31
completed_plans: 30
percent: 0
---
# Project State
## Project Reference
See: .planning/PROJECT.md (updated 2026-03-21)
**Core value:** 可靠、可维护的处理管道 - 每个步骤独立、可验证、可恢复
**Current focus:** 语义分段改进 — 使用 LLM 实现智能分段
## Current Position
Phase: Phase 13 - 核心 LLM 分段功能
Plan: TBD
Status: Planning
Last activity: 2026-03-21 — Roadmap created for v1.6
Progress: [░░░░░░░░░░] 0% (Phase 13/15)
### Phase 13 Goal
实现基于 LLM 的智能语义分段,识别视频类型并生成主题标题
### Phase 13 Requirements (18 total)
- VIDEO-01, VIDEO-02, VIDEO-03 (视频类型识别)
- BOUND-01, BOUND-02, BOUND-03, BOUND-04 (语义边界检测)
- COMP-01, COMP-02, COMP-03 (内容完整性保护)
- TITLE-01, TITLE-02, TITLE-03 (主题标题生成)
- SENT-01, SENT-02, SENT-03 (中文句边界检测)
- STRAT-01, STRAT-02, STRAT-03 (分段策略)
## Accumulated Context
### Decisions
Key decisions from v1.0-v1.5 (preserved):
- 管道模型 — BaseProcessor + Pipeline 架构
- 步骤级状态 — WorkflowStateManager
- Schema 验证 — Pydantic v2
- 顺序执行 — 简单性和可调试性
- CLI subparsers — 可扩展命令结构
- SRT 独立模块 — kb_workflow/srt/ 职责分离
- ASR 纠错可选 — AI 不可用时返回原文
v1.6 scope (待验证):
- LLM 语义分析 — 替代简单规则分段
- 通用自适应 — 自动识别视频类型
- 主题识别与标题 — 主题章节生成标题
- 内容完整性 — 避免错误截断话题
### Technical Context
**架构集成:**
- 扩展现有 `SemanticSegmenter`,保持向后兼容
- 新增 `SemanticSegmentationEngine` 模块(`kb_workflow/srt/semantic_engine.py`)
- 在 `SRTProcessor` 中添加 LLM 分支(`enable_semantic_segmentation` 参数)
**技术栈:**
- SimpleAIClient(已集成 zhipu/openai/minimax)
- Pydantic v2(LLM 响应验证)
- 现有 SemanticSegmenter(规则分段保留)
**数据流:**
```
SRT Input → Parse Subtitles → Video Type Detection →
Semantic Segmentation → Extract Paragraphs → ASR Correction →
Deep Analysis
```
### Known Risks
**高优先级风险:**
1. **上下文窗口溢出** — 长视频(>1小时)字幕超10万字符,需分块处理
2. **LLM 输出格式不稳定** — 需多层 fallback 策略
3. **分段边界破坏完整性** — 需句边界保护机制
4. **分段不一致性** — LLM 随机性导致多次运行结果不同
5. **成本失控** — 高频 LLM 调用可能导致费用激增
**缓解策略:**
- Phase 13: 实现 Pydantic 验证 + 句边界保护
- Phase 14: 实现分块处理 + 缓存 + 温度控制
### Blockers/Concerns
None.
## Session Continuity
Last session: 2026-03-21T16:14:07.592Z
Stopped at: Phase 13 context gathered
Resume file: .planning/phases/13-llm/13-CONTEXT.md
**Next step:** `/gsd:plan-phase 13` - 开始 Phase 13 的详细规划