docs(deliverables): 参赛成果物补齐（README 五项 + 范式图/架构图 + coverage 报告）

按《参赛成果物提交规范·赛道一》§8：
- README：新增项目性质：新规声明、项目概述、整体功能说明、效果总结
  （431 测试/99.15% 覆盖/双语试运行/影响调查基线）、团队分工、规模与难度自评
- design.md：开发范式流程图（mermaid，6 步与 AI 日志步骤列一致）+ §2.1
  Agent 架构图（感知-规划-行动-记忆映射）
- _AI_USAGE_LOG.md：回填「待补充」→架构设计、「整体迭代」→反馈迭代
- tests/coverage/ 覆盖率 HTML 报告（99.15%）+ tests/test-execution-log.txt 执行日志
- docs/参赛成果物提交规范-赛道一.md → docs/submission-spec-track1.md（ASCII 化）
- pyproject: pytest norecursedirs 排除 test-execution-log.txt
全量 pytest 431 passed / 99.15%

_AI_USAGE_LOG.md

@@ -12,7 +12,7 @@
 | 2026-07-21 | 設計 | QA Agent詳細設計確定（10項チェック/逐字比較+LLM意思一致判定/エラーはWriterにフィードバック） | 会話記録 | deepseek-v4-flash-free |
 | 2026-07-21 | 設計 | 現状システム探索・RAG Layer・既存設計文書の必要性とRAGの位置づけを最終確認 | 会話記録 | deepseek-v4-flash-free |
 | 2026-07-21 | 架构设计 | 完成设计文档（docs/design.md）和实现计划（docs/implementation-plan.md）输出 | docs/design.md, docs/implementation-plan.md | deepseek-v4-flash-free |
-| 2026-07-30 11:11 | 待补充 | 恢复会话上下文，准备继续设计工作 | _AI_USAGE_LOG.md | deepseek-v4-flash-free |
+| 2026-07-30 11:11 | 架构设计 | 恢复会话上下文，准备继续设计工作 | _AI_USAGE_LOG.md | deepseek-v4-flash-free |
 | 2026-07-30 12:30 | 架构设计 | 完成 RAG Layer 详细设计（技术选型/分割/存储/版本管理/检索/冲突处理/接口）并输出文档；design.md 第5章改为摘要+链接 | docs/rag-layer-design.md, docs/design.md | deepseek-v4-flash-free |
 | 2026-07-30 13:10 | 架构设计 | 完成 Agent 运行时层详细设计（推理引擎/编排状态机/三层记忆/工具接口/可观测性/幂等/安全）并输出文档 | docs/agent-runtime-design.md | deepseek-v4-flash-free |
 | 2026-07-30 14:00 | 架构设计 | 全面自查修复：状态机删 parsing_done 统一8状态+确认事件持久化；版本号统一整数；术语统一（写入/设计/参考）；补 Storage Adapter 章节；QA 第7章细化10项验证；implementation-plan 同步运行时层/RAG/QA 任务 | docs/agent-runtime-design.md, docs/web-ui-design.md, docs/design.md, docs/rag-layer-design.md, docs/implementation-plan.md | deepseek-v4-flash-free |
@@ -30,7 +30,7 @@
 | 2026-08-09 03:15 | Agent 实现 | 里程碑2 Task6 实现：FreeTextExtractor（自由记述型 Sheet 内容提取）。新建 src/genesis/parsers/free_text_extractor.py（extract_text_blocks 按全空行分段、行内非空单元格以「 」连接；build_free_text_table 构建占位结构化表，extraction_method="llm_from_free_text"、headers=["text"]、行内 CellValue+Provenance（row 从 1 起、column="A"、column_header="text"）），后续 LLM 结构化入口；tests/test_free_text_extractor.py（2 用例：全空行分段、占位表构建）；TDD 验证 RED（ImportError: No module named 'genesis.parsers.free_text_extractor'）→ GREEN（2 passed）；pytest 全量 34 passed；待接入 SheetNature.FREE_TEXT 分支；data_models.py 未改动；提交 a9cc3c9 | src/genesis/parsers/free_text_extractor.py, tests/test_free_text_extractor.py | deepseek-v4-flash-free |
 | 2026-08-09 03:13 | Agent 实现 | 里程碑2 Task7 实现：ExcelParser 编排器（集成全部解析模块）。创建 src/genesis/parsers/excel_parser.py（ExcelParseResult dataclass：file_name/tables/comments/skipped；ExcelParser.parse 编排：open_workbook→逐 sheet sheet_matrix→空则跳过→detect_sheet_type→classify_sheet→FREE_TEXT 走 extract_text_blocks+build_free_text_table（带 detected_type）→否则 merged ranges 转 tuple 后 forward_fill+extract_table→collect_comments 汇总）与 tests/test_excel_parser.py（2 个用例：表型 sheet 两个（機能一覧 FUNCTION / バッチ一覧 BATCH 类型+行数断言）、自由记述 sheet extraction_method="llm_from_free_text"）；TDD 验证 RED（ImportError: No module named 'genesis.parsers.excel_parser'）→ GREEN（2 passed）；pytest 全量 36 passed；data_models.py 未改动；对照 dispatch 上下文说明：data_models 无 ParsedWorkbook 命名，按 brief 定义 ExcelParseResult | src/genesis/parsers/excel_parser.py, tests/test_excel_parser.py | deepseek-v4-flash-free |
 | 2026-08-09 03:20 | 测试验证 | 里程碑2 Task8 实现：真实样本集成测试。创建 tests/test_real_samples.py（3 个端到端用例，各样本缺失时 pytest.skip：新規開発→機能一覧 存在且 int rows+DB定義；追加改修→tables 非空且至少一表有数据行；自由記述→存在 extraction_method="llm_from_free_text" 的表）；全量验证 39 passed（含 3 个样本用例）；真实样本产物： 新規開発 6 表全 openpyxl（機能一覧9/画面一覧7/帳票一覧5/DB定義20/IF定義3/バッチ一覧3）； 追加改修 2 表 openpyxl（機能10/画面7）+ 改修ポイント 以 FREE_TEXT 分类改 1 行（MIXED 折叠落观察已确认）； 自由記述 3 表全 llm_from_free_text 各 1 行； 3 样本均 0 批注、无空 sheet。调研结论：MIXED 已知缺口#1 在真实样本未触发断言失败（无断言触发），按 brief 保持弱断言 | tests/test_real_samples.py | deepseek-v4-flash-free |
-| 2026-08-09 03:30 | 整体迭代 | 里程碑2 最终评审修正（must-fix x2）：① find_header_row 结果未传入 extract_table（恒 header_row=0，标题行置上的 sheet 会损坏表头）→ excel_parser.py 结构化路径改用 find_header_row(filled) 并 <0 回落 0；② cell_formatting 死代码（CellValue.formatting 恒 None，取消线/背景色到不了下游）→ extract_table 新增可选 formatting_map 参数，excel_parser 遍历 ws.iter_rows 构建 fmt_map 传入。tests/test_excel_parser.py 新增 2 用例（标题行表头定位、strikethrough 回填）；pytest 全量 41 passed | src/genesis/parsers/excel_parser.py, src/genesis/parsers/table_extractor.py, tests/test_excel_parser.py | deepseek-v4-flash-free |
+| 2026-08-09 03:30 | 反馈迭代 | 里程碑2 最终评审修正（must-fix x2）：① find_header_row 结果未传入 extract_table（恒 header_row=0，标题行置上的 sheet 会损坏表头）→ excel_parser.py 结构化路径改用 find_header_row(filled) 并 <0 回落 0；② cell_formatting 死代码（CellValue.formatting 恒 None，取消线/背景色到不了下游）→ extract_table 新增可选 formatting_map 参数，excel_parser 遍历 ws.iter_rows 构建 fmt_map 传入。tests/test_excel_parser.py 新增 2 用例（标题行表头定位、strikethrough 回填）；pytest 全量 41 passed | src/genesis/parsers/excel_parser.py, src/genesis/parsers/table_extractor.py, tests/test_excel_parser.py | deepseek-v4-flash-free |
 | 2026-08-09 03:59 | Agent 实现 | 里程碑2.5 Task9 实现：段落分割器 split_paragraphs（MIXED 完整段落解析第一步，纯函数）。新建 src/genesis/parsers/paragraph_splitter.py（_is_blank_row 行空白判定 + split_paragraphs(matrix)→list[(start,end)] 含端点 0-based，以全空行为界返回段落区间，空矩阵→[]）与 tests/test_paragraph_splitter.py（5 用例：空矩阵/单段落无空行/中间空行分割/尾部空行不产生多余段落/前导空行从首个非空行开始）；TDD 验证 RED（ModuleNotFoundError: No module named 'genesis.parsers.paragraph_splitter'）→ GREEN（5 passed）；pytest 全量 46 passed（41 baseline + 5 新增）；不依赖 openpyxl 与 data_models；提交 34ef28b | src/genesis/parsers/paragraph_splitter.py, tests/test_paragraph_splitter.py | deepseek-v4-flash-free |
 | 2026-08-09 04:20 | Agent 实现 | 里程碑2.5 Task10 实现：data_models 扩展 MixedParagraph/MixedSheet 段落容器，并新增 ExcelParseResult.mixed 字段（默认空列表）。TDD：先追加 3 个测试（字段存在性与默认行为）确认 RED（ImportError: cannot import name 'MixedParagraph'），再在 data_models.py 末尾追加两个 dataclass（顶部 from typing 加 Literal、dataclasses 加 field），excel_parser.py 更新导入并为 ExcelParseResult 加 mixed 字段，确认 GREEN（3 passed），全量 pytest 49 passed（46 baseline + 3）。未修改既有类与字段，仅追加。 | src/genesis/data_models.py, src/genesis/parsers/excel_parser.py, tests/test_excel_parser.py | deepseek-v4-flash-free |
 | 2026-08-09 04:06 | Agent 实现 | 里程碑2.5 Task11 实现：MIXED 完整段落装配（分割→逐段最优解析）。excel_parser.py 新增 MIXED 分支：整表先 forward_fill（合并单元格）再按段切片；对每段 classify_sheet，TABLE 段用 find_header_row(seg)（段内相对，<0 回落 0）并抽出段内子 map seg_fmt_map（物理行 pr→段内 pr-s，修复 formatting_map 坐标错位）传给 extract_table（header_row=header_row）；非表格段归 FREE_TEXT（防二次 MIXED 递归），走 extract_text_blocks + build_free_text_table 构造 kind="free_text"。MixedParagraph 段落追加到 MixedSheet 并进 result.mixed，表/自由文本表进 result.tables。原 else 分支保留为 TABLE 专用，既有 TABLE/FREE_TEXT 路径不变。TDD：先追加 2 测试（段落分割/碎片捕获、表格段不在物理行 0 时的取消线回填）确认 RED（result.mixed 空 + IndexError），再实现确认 GREEN（9 passed），全量 pytest 51 passed（49 baseline + 2）。提交见 git log | src/genesis/parsers/excel_parser.py, tests/test_excel_parser.py | deepseek-v4-flash-free |
@@ -120,3 +120,4 @@
 | 2026-08-26 01:20 | 测试验证 | 真实 LLM 双语试运行验收（补做）：zh 模板+zh 强制 → 7章成功；ja 默认 auto → 暴露 BUG（fallback 误用 impact/data 源数据含中文元素名→日文文档误判期望 zh→硬失败），修复为 fallback 改用 write_rules/design_rules（日文规则文档）+ 回归测试；修复后 ja 重跑成功 7章；程序化扫描两输出：zh 1处=表5-1表格说明引用日文源表名（照抄原文范畴，可接受），ja 1处=封面字段作成日（误报）→ 均无中日混杂正文缺陷；全量 pytest 425 passed / 99.15% | src/genesis/writer/writer_agent.py; tests/test_writer_language.py; docs/superpowers/plans/2026-08-24-language-consistency.md; _AI_USAGE_LOG.md | x-preview-f-free (opencode) |
 | 2026-08-26 02:10 | 反馈迭代 | 未解决问题收尾：#1/#2 orchestrator.generate 新增 chapter_attempts 章级管道重试（默认3，单章硬失败不连坐整次run，耗尽才抛错）+ tests/test_orchestrator_retry.py；#3 find_language_violations 增加表格 caption 检查（rows/headers 仍照抄源不检），QA ChapterArtifact.blocks 扩为 (type,text,caption) 同步生效；#4/#5/#6/#7 文档收尾（README --output-language/中文模板、design.md §6.2.1/§7.2 十一项校验、计划验收勾选、.gitignore 加 .opencode/）；全量 pytest 431 passed / 99.15% | src/genesis/writer/orchestrator.py; src/genesis/writer/language.py; src/genesis/qa/validator.py; src/genesis/eval/scorer.py; tests/test_orchestrator_retry.py; tests/test_writer_language.py; README.md; docs/design.md; docs/superpowers/plans/2026-08-24-language-consistency.md; .gitignore | x-preview-f-free (opencode) |
 | 2026-08-26 03:00 | 文档规范 | 参赛提交规范红线修复（阶段A）：samples/ 改名为 sample/（git mv），11 个非 ASCII 文件名重命名为 ASCII（要件定義→requirements_*、模板→template_*、规则→rules_*、参赛手册PDF→contestant-handbook.pdf）；tests/test_zh_template.py 硬编码绝对路径 D:\00_project\Genesis\samples 改为相对路径；全局更新 21 个活动文件引用（src/scripts/tests/README/AGENTS/design.md/sample-spec.md）；历史日志与审查文档不改（追加本记录说明）；全量 pytest 431 passed / 99.15% 无回归 | sample/（目录改名+10文件重命名）; docs/contestant-handbook.pdf; tests/test_zh_template.py; scripts/run_trial.py; scripts/run_phase5_slice.py; scripts/make_zh_template.py; src/genesis/services/rag_service.py; src/genesis/writer/context_builder.py; src/genesis/writer/orchestrator.py; src/genesis/qa/qa_loop.py; tests/test_real_samples.py; tests/test_code_parser.py; tests/test_impact_agent.py; tests/test_phase5_rag.py; tests/test_phase5_e2e.py; tests/test_language_coverage.py; tests/test_orchestrator_retry.py; tests/test_data_models.py; tests/test_eval_scorer.py; README.md; AGENTS.md; docs/design.md; docs/sample-spec.md | x-preview-f-free (opencode) |
+| 2026-08-26 03:40 | 文档规范 | 参赛成果物补齐（阶段B）：README 重写——新增项目性质：新规声明 + 项目概述/整体功能说明/效果总结（431测试99.15%覆盖/双语试运行通过/影响调查基线）/团队分工/规模与难度自评，保留安装运行说明；design.md 补开发范式流程图（mermaid 6步，与AI日志范式步骤列一致）+ §2.1 Agent 架构图（感知-规划-行动-记忆映射）；_AI_USAGE_LOG.md 回填 L15「待补充」→架构设计、L33「整体迭代」→反馈迭代；生成 tests/coverage/ 覆盖率HTML报告（99.15%）+ tests/test-execution-log.txt 执行日志入库；docs/参赛成果物提交规范-赛道一.md 改名 docs/submission-spec-track1.md（ASCII）；pyproject pytest norecursedirs 排除执行日志；全量 pytest 431 passed / 99.15% | README.md; docs/design.md; docs/submission-spec-track1.md; pyproject.toml; tests/coverage/; tests/test-execution-log.txt; _AI_USAGE_LOG.md | x-preview-f-free (opencode) |