chore: cleanup unused imports + design.md Phase5 notes

This commit is contained in:
lhl
2026-08-13 11:49:58 +08:00
parent 2770c76ba0
commit e4f533799d
3 changed files with 3 additions and 5 deletions
+3 -1
View File
@@ -1729,6 +1729,8 @@ Step 3(关联推理)中部分功能推理失败:
- QA 校验(确定性维度:`traceability` / `placeholder_residue` / `chapter_completeness`)。
- QA 闭环(`QALoop` 仅对失败章重新生成,受 `QALoopController(DEFAULT_MAX_QA_ROUNDS=3)` 约束)。
> **确定性维度生效说明(Phase 5 现状)**:章节级「章节完整性(`chapter_completeness`)」维度当前因 `template_sections_expected` 恒为空而实质为空操作(恒满分),生效的确定性维度为**可追溯性(`traceability`+ 占位符残留(`placeholder_residue`**。待模板期望章节集合回填后,`chapter_completeness` 方才参与校验。
**范围外(诚实标注)**
- **语义 QA 为探针**:内容准确性 / 幻觉检测 / 规则遵守等 LLM 语义维度,经 `ChapterScorer.llm_evaluators` 钩子注入,默认中性分,尚未接入真实推理(设计 §7.5 已声明待 Phase5)。
- **图表生成**:本实现不生成图形/图表,仅支持表格/列表/段落/提示框等文本型 Block(设计 §6.4 的 table/list/paragraph/note)。
@@ -1770,7 +1772,7 @@ Document(注入后 Word 文档)
3. **`RagService.retrieve_*`** 为**同步**方法(非 async)。调用方在同步编排链路中直接调用即可,无需 `await`
4. **`map_template`** 消费真实的 `ParsedTemplate.sections`(元素类型为 `ChapterMarker`,含 `type` / `name` / `level`)。映射按文档顺序:遇到 `heading` 起一章;其后的 `section:<id>` 占位符归属该章 → `chapter_id = id``section_placeholder = "section:<id>"`
5. **`ChapterScorer.score(chapters: list[ChapterArtifact], source: StructuredSource)`**QA 层需要 `ChapterContent → ChapterArtifact` 适配器(由 `ChapterContent.blocks` 拼接得到 `text`,并从各 block 收集 `source_uris`);设计 §7.5 的 `ChapterArtifact` 并非直接由 Writer 产出,需经适配。
6. **真实 `DocxInjector.Block`** 支持 `table` / `list` / `note` 类型;表格注入会渲染 `caption` 段落(caption 非空时在其上方/下方生成说明段落),非空 caption 不应被丢弃。
6. **真实 `DocxInjector.Block`** 支持 `paragraph` / `heading` / `table``list` / `note` 当前按 `paragraph` 降级渲染(原型范围,无列表/提示框样式)。表格注入会渲染 `caption` 段落(caption 非空时在其上方/下方生成说明段落),非空 caption 不应被丢弃。
### 12.4 垂直切片状态
-3
View File
@@ -4,7 +4,4 @@ from __future__ import annotations
from dataclasses import dataclass, field
from docx import Document
from docx.document import Document as DocxDocument
__all__ = ["Block", "DocxInjector", "DocxInjectError"]
-1
View File
@@ -1,4 +1,3 @@
from dataclasses import FrozenInstanceError
from genesis.writer.models import ContentBlock, ChapterContent, GenerationContext, ChapterSpec