feat: move render to documnet

src/noteforge/core/pipeline.py

@@ -17,7 +17,7 @@
     PipelineStatus,
     null_event_handler,
 )
-from noteforge.document import generate_document
+from noteforge.document import MarkdownRenderer, generate_document, write_markdown
 from noteforge.exceptions import (
     NoteForgeError,
     PipelineErrorContext,
@@ -41,7 +41,6 @@
     LLMToolResponse,
 )
 from noteforge.media.models import VideoResource
-from noteforge.renderer import MarkdownRenderer, write_markdown
 
 VideoCollector = Callable[..., VideoResource]
 

src/noteforge/document/__init__.py

@@ -3,10 +3,14 @@
 from noteforge.document.builder import KnowledgeDocumentBuilder
 from noteforge.document.generator import generate_document
 from noteforge.document.models import DocumentSection, LearningDocument
+from noteforge.document.renderers import MarkdownRenderer
+from noteforge.document.writer import write_markdown
 
 __all__ = [
     "DocumentSection",
     "KnowledgeDocumentBuilder",
     "LearningDocument",
+    "MarkdownRenderer",
     "generate_document",
+    "write_markdown",
 ]

src/noteforge/document/renderers/__init__.py

@@ -0,0 +1,5 @@
+"""学习文档的不同输出格式渲染器。"""
+
+from noteforge.document.renderers.markdown import MarkdownRenderer
+
+__all__ = ["MarkdownRenderer"]

src/noteforge/renderer/markdown.py → src/noteforge/document/renderers/markdown.py

@@ -2,7 +2,7 @@
 
 import re
 
-from noteforge.document import LearningDocument
+from noteforge.document.models import LearningDocument
 from noteforge.knowledge.extraction import KnowledgePoint
 
 _MARKDOWN_SPECIAL_CHARACTERS = re.compile(r"([\\`*_{}\[\]()#+.!|>\-])")

src/noteforge/renderer/writer.py → src/noteforge/document/writer.py

@@ -1,4 +1,4 @@
-"""Markdown 文件输出工具。"""
+"""学习文档文件输出工具。"""
 
 from pathlib import Path
 

tests/renderer/test_markdown_renderer.py → tests/document/test_markdown_renderer.py

@@ -2,12 +2,16 @@
 
 import pytest
 
-from noteforge.document import DocumentSection, LearningDocument
+from noteforge.document import (
+    DocumentSection,
+    LearningDocument,
+    MarkdownRenderer,
+    write_markdown,
+)
 from noteforge.knowledge.chunker import RawChunk
 from noteforge.knowledge.extraction import KnowledgePoint, KnowledgePointType
 from noteforge.knowledge.preprocessor import PreprocessedChunk
 from noteforge.knowledge.semantic import SemanticChunk, SemanticChunkType
-from noteforge.renderer import MarkdownRenderer, write_markdown
 
 
 def make_point(