8.3 KiB
8.3 KiB
phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves
| phase | plan | type | wave | depends_on | files_modified | autonomous | requirements | must_haves | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 15-output-compat | 03 | execute | 1 |
|
|
true |
|
|
Purpose: 确保用户升级后无需修改代码,现有功能继续正常工作 Output: 向后兼容性测试通过,无破坏性变更
<execution_context> @/home/starmen1265/.claude/get-shit-done/workflows/execute-plan.md @/home/starmen1265/.claude/get-shit-done/templates/summary.md </execution_context>
@.planning/phases/15-output-compat/15-CONTEXT.md @.planning/phases/12-srt-processor/12-01-SUMMARY.md @.planning/phases/15-output-compat/15-01-SUMMARY.md @.planning/phases/15-output-compat/15-02-SUMMARY.md @kb_workflow/pipeline/processors/srt.py @kb_workflow/pipeline/processors/analyze.py @kb_workflow/srt/segmenter.py From kb_workflow/pipeline/processors/analyze.py (expected structure): ```python class AnalyzeProcessor(BaseProcessor): """知乎/文章处理器,独立于 SRTProcessor""" # AnalyzeProcessor 不依赖 SRTProcessor 的配置或分段逻辑 # 它有自己的分析流程和输出格式 ```From kb_workflow/srt/segmenter.py (expected structure):
class SemanticSegmenter:
"""规则分段器,基于时间间隔和字符长度"""
def segment(self, segments: List[Segment]) -> List[str]:
# 简单规则:时间间隔 > 3秒 或 字符数 > 500 创建新分段
# 返回纯文本列表,不包含标题
# Phase 12 的调用方式(应继续工作)
processor = SRTProcessor(state_manager)
# 或
processor = SRTProcessor(state_manager, enable_correction=False)
# 现在会从 KBSettings 读取 enable_semantic_segmentation(默认 True)
1. test_rule_based_segmentation_unchanged:
- 创建 SRTProcessor(enable_semantic_segmentation=False)
- 验证 self.segmenter 是 SemanticSegmenter 实例
- 验证不是 SemanticSegmentationEngine 实例
- 调用 segment() 方法验证返回纯文本列表
- 验证输出 Markdown 包含 "## 内容" 标题
2. test_rule_based_no_llm_calls:
- Mock SimpleAIClient,验证 generate() 方法未被调用
- 确保规则分段不依赖 LLM
3. test_rule_based_thresholds_unchanged:
- 使用已知字幕数据测试分段边界
- 验证分段逻辑与 Phase 12 一致(时间间隔 3秒,字符数 500)
测试数据使用 Phase 12 的测试模式。
pytest tests/test_backward_compat.py::TestBackwardCompatibility::test_rule_based_segmentation_unchanged tests/test_backward_compat.py::TestBackwardCompatibility::test_rule_based_no_llm_calls tests/test_backward_compat.py::TestBackwardCompatibility::test_rule_based_thresholds_unchanged -x -v
- 规则分段测试通过
- 行为与 Phase 12 一致
- CONFIG-02 需求满足
Task 2: 验证 AnalyzeProcessor 独立性
tests/test_processors/test_analyze.py, tests/test_backward_compat.py
- Test 1: AnalyzeProcessor 不受 KBSettings.enable_semantic_segmentation 影响
- Test 2: AnalyzeProcessor 正常初始化和处理
- Test 3: AnalyzeProcessor 输出格式未改变
实现 AnalyzeProcessor 独立性测试:
1. 在 test_backward_compat.py 中添加 test_analyze_processor_unaffected:
- 设置 KB_ENABLE_SEMANTIC_SEGMENTATION=true 或 false
- 创建 AnalyzeProcessor
- 验证处理器正常工作
- 验证 AnalyzeProcessor 不读取 enable_semantic_segmentation 配置
2. 验证 tests/test_processors/test_analyze.py 中现有测试全部通过:
- 确保 AnalyzeProcessor 的测试未被配置变更破坏
- AnalyzeProcessor 有独立的测试套件
AnalyzeProcessor 处理知乎/文章内容,与视频字幕处理完全独立。
pytest tests/test_backward_compat.py::TestBackwardCompatibility::test_analyze_processor_unaffected tests/test_processors/test_analyze.py -x -v
- AnalyzeProcessor 测试通过
- CONFIG-03 需求满足
- 现有测试未受影响
Task 3: 验证 API 调用兼容性
tests/test_backward_compat.py
- Test 1: 不传 enable_semantic_segmentation 参数时使用配置默认值
- Test 2: 旧代码调用 SRTProcessor(state_manager) 继续工作
- Test 3: 显式传 False 时覆盖配置,使用规则分段
实现 API 兼容性测试:
1. test_existing_api_compatibility:
- 模拟 Phase 12 的调用方式:SRTProcessor(state_manager)
- 验证从 KBSettings 读取配置(默认 True)
- Mock get_settings() 返回 enable_semantic_segmentation=True
2. test_explicit_false_overrides_config:
- 设置配置 KB_ENABLE_SEMANTIC_SEGMENTATION=true
- 调用 SRTProcessor(state_manager, enable_semantic_segmentation=False)
- 验证使用规则分段器(参数优先)
3. test_migration_path:
- 验证用户可以通过两种方式启用语义分段:
a) 不传参数,配置文件设置 KB_ENABLE_SEMANTIC_SEGMENTATION=true
b) 代码中显式传入 enable_semantic_segmentation=True
确保升级路径平滑,用户无需立即修改代码。
pytest tests/test_backward_compat.py::TestBackwardCompatibility::test_existing_api_compatibility tests/test_backward_compat.py::TestBackwardCompatibility::test_explicit_false_overrides_config tests/test_backward_compat.py::TestBackwardCompatibility::test_migration_path -x -v
- API 兼容性测试通过
- 升级路径清晰
- 无破坏性变更
- 规则分段行为与 Phase 12 一致(CONFIG-02 满足)
- AnalyzeProcessor 不受影响(CONFIG-03 满足)
- 现有 API 调用保持兼容
- 配置默认值为 True,提供开箱即用的语义分段体验
- 用户可选择禁用(配置或参数)
- 所有现有测试通过
<success_criteria>
- CONFIG-02 需求满足:向后兼容,不破坏现有规则分段
- CONFIG-03 需求满足:AnalyzeProcessor 不受影响
- 无破坏性变更,用户可平滑升级
- 测试覆盖所有兼容性场景 </success_criteria>