lhl
a1fefd43eb
按《参赛成果物提交规范·赛道一》§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%
213 lines
42 KiB
HTML
213 lines
42 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Coverage for src\genesis\writer\orchestrator.py: 99%</title>
|
|
<link rel="icon" sizes="32x32" href="favicon_32_cb_c827f16f.png">
|
|
<link rel="stylesheet" href="style_cb_0853b3de.css" type="text/css">
|
|
<script src="coverage_html_cb_188fc9a4.js" defer></script>
|
|
</head>
|
|
<body class="pyfile">
|
|
<header>
|
|
<div class="content">
|
|
<h1>
|
|
<span class="text">Coverage for </span><b>src<span class="sep">\</span>genesis<span class="sep">\</span>writer<span class="sep">\</span>orchestrator.py</b>:
|
|
<span class="pc_cov">99%</span>
|
|
</h1>
|
|
<aside id="help_panel_wrapper">
|
|
<input id="help_panel_state" type="checkbox">
|
|
<label for="help_panel_state">
|
|
<img id="keyboard_icon" src="keybd_closed_cb_900cfef5.png" alt="Show/hide keyboard shortcuts">
|
|
</label>
|
|
<div id="help_panel">
|
|
<p class="legend">Shortcuts on this page</p>
|
|
<div class="keyhelp">
|
|
<p>
|
|
<kbd>r</kbd>
|
|
<kbd>m</kbd>
|
|
<kbd>x</kbd>
|
|
<kbd>p</kbd>
|
|
toggle line displays
|
|
</p>
|
|
<p>
|
|
<kbd>j</kbd>
|
|
<kbd>k</kbd>
|
|
next/prev highlighted chunk
|
|
</p>
|
|
<p>
|
|
<kbd>0</kbd> (zero) top of page
|
|
</p>
|
|
<p>
|
|
<kbd>1</kbd> (one) first highlighted chunk
|
|
</p>
|
|
<p>
|
|
<kbd>[</kbd>
|
|
<kbd>]</kbd>
|
|
prev/next file
|
|
</p>
|
|
<p>
|
|
<kbd>u</kbd> up to the index
|
|
</p>
|
|
<p>
|
|
<kbd>?</kbd> show/hide this help
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</aside>
|
|
<h2>
|
|
<span class="text">65 statements </span>
|
|
<button type="button" class="run button_toggle_run" value="run" data-shortcut="r" title="Toggle lines run">65<span class="text"> run</span></button>
|
|
<button type="button" class="mis show_mis button_toggle_mis" value="mis" data-shortcut="m" title="Toggle lines missing">0<span class="text"> missing</span></button>
|
|
<button type="button" class="exc show_exc button_toggle_exc" value="exc" data-shortcut="x" title="Toggle lines excluded">0<span class="text"> excluded</span></button>
|
|
<button type="button" class="par run show_par button_toggle_par" value="par" data-shortcut="p" title="Toggle lines partially run">1<span class="text"> partial</span></button>
|
|
</h2>
|
|
<p class="text">
|
|
<a id="prevFileLink" class="nav" href="z_cac49e191045e829_models_py.html">« prev</a>
|
|
<a id="indexLink" class="nav" href="index.html">^ index</a>
|
|
<a id="nextFileLink" class="nav" href="z_cac49e191045e829_renderer_py.html">» next</a>
|
|
|
|
<a class="nav" href="https://coverage.readthedocs.io/en/7.15.4">coverage.py v7.15.4</a>,
|
|
created at 2026-08-26 14:20 +0800
|
|
</p>
|
|
<aside class="hidden">
|
|
<button type="button" class="button_next_chunk" data-shortcut="j"></button>
|
|
<button type="button" class="button_prev_chunk" data-shortcut="k"></button>
|
|
<button type="button" class="button_top_of_page" data-shortcut="0"></button>
|
|
<button type="button" class="button_first_chunk" data-shortcut="1"></button>
|
|
<button type="button" class="button_prev_file" data-shortcut="["></button>
|
|
<button type="button" class="button_next_file" data-shortcut="]"></button>
|
|
<button type="button" class="button_to_index" data-shortcut="u"></button>
|
|
<button type="button" class="button_show_hide_help" data-shortcut="?"></button>
|
|
</aside>
|
|
</div>
|
|
</header>
|
|
<main id="source">
|
|
<p class="pln"><span class="n"><a id="t1" href="#t1">1</a></span><span class="t"><span class="str">"""Writer 编排：上下文装配 → 逐章生成 → 渲染 → docx 注入（Phase 5 垂直切片）。</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t2" href="#t2">2</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t3" href="#t3">3</a></span><span class="t"><span class="str">Impact Agent MVP（2026-08-23）：门控 = 用户是否提供既有系统（existing_system 非 None）。</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t4" href="#t4">4</a></span><span class="t"><span class="str">门控通过且未显式传入 impact_report 时，自动运行 ImpactAgent 生成影响调查书，</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t5" href="#t5">5</a></span><span class="t"><span class="str">并作为生成主上下文（GenerationContext.impact_report → prompt 的 {{impact}} 变量）。</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t6" href="#t6">6</a></span><span class="t"><span class="str">"""</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t7" href="#t7">7</a></span><span class="t"><span class="key">from</span> <span class="nam">__future__</span> <span class="key">import</span> <span class="nam">annotations</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t8" href="#t8">8</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t9" href="#t9">9</a></span><span class="t"><span class="key">import</span> <span class="nam">logging</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t10" href="#t10">10</a></span><span class="t"><span class="key">from</span> <span class="nam">datetime</span> <span class="key">import</span> <span class="nam">date</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t11" href="#t11">11</a></span><span class="t"><span class="key">from</span> <span class="nam">pathlib</span> <span class="key">import</span> <span class="nam">Path</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t12" href="#t12">12</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t13" href="#t13">13</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">data_models</span> <span class="key">import</span> <span class="nam">StructuredSource</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t14" href="#t14">14</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">impact</span><span class="op">.</span><span class="nam">impact_agent</span> <span class="key">import</span> <span class="nam">ImpactAgent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t15" href="#t15">15</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">inference</span><span class="op">.</span><span class="nam">factory</span> <span class="key">import</span> <span class="nam">build_inference_engine</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t16" href="#t16">16</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">inference</span><span class="op">.</span><span class="nam">prompt_registry</span> <span class="key">import</span> <span class="nam">PromptRegistry</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t17" href="#t17">17</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">writer</span><span class="op">.</span><span class="nam">context_builder</span> <span class="key">import</span> <span class="nam">build_contexts</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t18" href="#t18">18</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">writer</span><span class="op">.</span><span class="nam">docx_injector</span> <span class="key">import</span> <span class="nam">Block</span><span class="op">,</span> <span class="nam">DocxInjector</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t19" href="#t19">19</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">writer</span><span class="op">.</span><span class="nam">exceptions</span> <span class="key">import</span> <span class="nam">WriterGenerationError</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t20" href="#t20">20</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">writer</span><span class="op">.</span><span class="nam">models</span> <span class="key">import</span> <span class="nam">ChapterContent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t21" href="#t21">21</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">writer</span><span class="op">.</span><span class="nam">renderer</span> <span class="key">import</span> <span class="nam">render_chapter_blocks</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t22" href="#t22">22</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">writer</span><span class="op">.</span><span class="nam">writer_agent</span> <span class="key">import</span> <span class="nam">WriterAgent</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t23" href="#t23">23</a></span><span class="t"><span class="key">from</span> <span class="nam">genesis</span><span class="op">.</span><span class="nam">writer</span><span class="op">.</span><span class="nam">writer_state</span> <span class="key">import</span> <span class="nam">WriterState</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t24" href="#t24">24</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t25" href="#t25">25</a></span><span class="t"><span class="nam">_LOGGER</span> <span class="op">=</span> <span class="nam">logging</span><span class="op">.</span><span class="nam">getLogger</span><span class="op">(</span><span class="nam">__name__</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t26" href="#t26">26</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t27" href="#t27">27</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t28" href="#t28">28</a></span><span class="t"><span class="key">def</span> <span class="nam">_section_id_of</span><span class="op">(</span><span class="nam">placeholder</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span> <span class="op">|</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t29" href="#t29">29</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">placeholder</span> <span class="key">or</span> <span class="key">not</span> <span class="nam">placeholder</span><span class="op">.</span><span class="nam">startswith</span><span class="op">(</span><span class="str">"section:"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t30" href="#t30">30</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t31" href="#t31">31</a></span><span class="t"> <span class="key">return</span> <span class="nam">placeholder</span><span class="op">[</span><span class="nam">len</span><span class="op">(</span><span class="str">"section:"</span><span class="op">)</span><span class="op">:</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t32" href="#t32">32</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t33" href="#t33">33</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t34" href="#t34">34</a></span><span class="t"><span class="key">def</span> <span class="nam">_warn_unanchored</span><span class="op">(</span><span class="nam">ctxs</span><span class="op">)</span> <span class="op">-></span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t35" href="#t35">35</a></span><span class="t"> <span class="str">"""防静默丢章：对缺少 {{section:<id>}} 锚点的章节打显式告警。</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t36" href="#t36">36</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t37" href="#t37">37</a></span><span class="t"><span class="str"> 管线会对模板中每个 Heading 都生成内容，但只有带锚点的章才会注入 docx；</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t38" href="#t38">38</a></span><span class="t"><span class="str"> 无锚点章生成后会被丢弃。此函数将其从「静默丢弃」变为「可见告警」。</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t39" href="#t39">39</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t40" href="#t40">40</a></span><span class="t"> <span class="nam">unanchored</span> <span class="op">=</span> <span class="op">[</span><span class="nam">ctx</span><span class="op">.</span><span class="nam">title</span> <span class="key">for</span> <span class="nam">ctx</span> <span class="key">in</span> <span class="nam">ctxs</span> <span class="key">if</span> <span class="key">not</span> <span class="nam">ctx</span><span class="op">.</span><span class="nam">template_marker</span><span class="op">.</span><span class="nam">section_placeholder</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t41" href="#t41">41</a></span><span class="t"> <span class="key">if</span> <span class="nam">unanchored</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t42" href="#t42">42</a></span><span class="t"> <span class="nam">_LOGGER</span><span class="op">.</span><span class="nam">warning</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t43" href="#t43">43</a></span><span class="t"> <span class="str">"章节已生成但模板缺少 {{section:<id>}} 锚点，内容未注入（静默丢弃）：%s"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t44" href="#t44">44</a></span><span class="t"> <span class="str">", "</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">unanchored</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t45" href="#t45">45</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t46" href="#t46">46</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t47" href="#t47">47</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t48" href="#t48">48</a></span><span class="t"><span class="key">class</span> <span class="nam">WriteOrchestrator</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t49" href="#t49">49</a></span><span class="t"> <span class="key">def</span> <span class="nam">generate</span><span class="op">(</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t50" href="#t50">50</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t51" href="#t51">51</a></span><span class="t"> <span class="nam">structured_source</span><span class="op">:</span> <span class="nam">StructuredSource</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t52" href="#t52">52</a></span><span class="t"> <span class="nam">output_path</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t53" href="#t53">53</a></span><span class="t"> <span class="nam">session_id</span><span class="op">:</span> <span class="nam">str</span> <span class="op">=</span> <span class="str">"writer"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t54" href="#t54">54</a></span><span class="t"> <span class="nam">samples_dir</span><span class="op">:</span> <span class="nam">str</span> <span class="op">=</span> <span class="str">"sample"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t55" href="#t55">55</a></span><span class="t"> <span class="nam">engine</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t56" href="#t56">56</a></span><span class="t"> <span class="nam">prompt_registry</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t57" href="#t57">57</a></span><span class="t"> <span class="nam">template_path</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t58" href="#t58">58</a></span><span class="t"> <span class="nam">impact_report</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t59" href="#t59">59</a></span><span class="t"> <span class="nam">meta</span><span class="op">:</span> <span class="nam">dict</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t60" href="#t60">60</a></span><span class="t"> <span class="nam">output_language</span><span class="op">:</span> <span class="nam">str</span> <span class="op">=</span> <span class="str">"auto"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t61" href="#t61">61</a></span><span class="t"> <span class="nam">chapter_attempts</span><span class="op">:</span> <span class="nam">int</span> <span class="op">=</span> <span class="num">3</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t62" href="#t62">62</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">ChapterContent</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t63" href="#t63">63</a></span><span class="t"> <span class="nam">engine</span> <span class="op">=</span> <span class="nam">engine</span> <span class="key">or</span> <span class="nam">build_inference_engine</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t64" href="#t64">64</a></span><span class="t"> <span class="nam">prompt_registry</span> <span class="op">=</span> <span class="nam">prompt_registry</span> <span class="key">or</span> <span class="nam">PromptRegistry</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t65" href="#t65">65</a></span><span class="t"> <span class="key">if</span> <span class="nam">impact_report</span> <span class="key">is</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">getattr</span><span class="op">(</span><span class="nam">structured_source</span><span class="op">,</span> <span class="str">"existing_system"</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t66" href="#t66">66</a></span><span class="t"> <span class="com"># 门控：用户提供了既有系统（existing_system 非 None）→ 自动执行影响调查</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t67" href="#t67">67</a></span><span class="t"> <span class="nam">_LOGGER</span><span class="op">.</span><span class="nam">info</span><span class="op">(</span><span class="str">"检测到既有系统，自动执行影响调查（追加改修场景）"</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t68" href="#t68">68</a></span><span class="t"> <span class="nam">impact_report</span> <span class="op">=</span> <span class="nam">ImpactAgent</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">run</span><span class="op">(</span><span class="nam">structured_source</span><span class="op">,</span> <span class="nam">session_id</span><span class="op">=</span><span class="nam">session_id</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t69" href="#t69">69</a></span><span class="t"> <span class="key">if</span> <span class="nam">impact_report</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t70" href="#t70">70</a></span><span class="t"> <span class="com"># 回填 structured_source，便于 QA/日志/后续下载</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t71" href="#t71">71</a></span><span class="t"> <span class="nam">structured_source</span><span class="op">.</span><span class="nam">impact_report</span> <span class="op">=</span> <span class="nam">impact_report</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t72" href="#t72">72</a></span><span class="t"> <span class="nam">ctxs</span> <span class="op">=</span> <span class="nam">build_contexts</span><span class="op">(</span><span class="nam">structured_source</span><span class="op">,</span> <span class="nam">samples_dir</span><span class="op">,</span> <span class="nam">output_language</span><span class="op">=</span><span class="nam">output_language</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t73" href="#t73">73</a></span><span class="t"> <span class="nam">_warn_unanchored</span><span class="op">(</span><span class="nam">ctxs</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t74" href="#t74">74</a></span><span class="t"> <span class="nam">state</span> <span class="op">=</span> <span class="nam">WriterState</span><span class="op">(</span><span class="op">[</span><span class="nam">c</span><span class="op">.</span><span class="nam">chapter_id</span> <span class="key">for</span> <span class="nam">c</span> <span class="key">in</span> <span class="nam">ctxs</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t75" href="#t75">75</a></span><span class="t"> <span class="nam">agent</span> <span class="op">=</span> <span class="nam">WriterAgent</span><span class="op">(</span><span class="nam">session_id</span><span class="op">=</span><span class="nam">session_id</span><span class="op">,</span> <span class="nam">engine</span><span class="op">=</span><span class="nam">engine</span><span class="op">,</span> <span class="nam">prompt_registry</span><span class="op">=</span><span class="nam">prompt_registry</span><span class="op">,</span> <span class="nam">state</span><span class="op">=</span><span class="nam">state</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t76" href="#t76">76</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t77" href="#t77">77</a></span><span class="t"> <span class="nam">contents</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">ChapterContent</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t78" href="#t78">78</a></span><span class="t"> <span class="nam">sections</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">list</span><span class="op">[</span><span class="nam">Block</span><span class="op">]</span><span class="op">]</span> <span class="op">=</span> <span class="op">{</span><span class="op">}</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t79" href="#t79">79</a></span><span class="t"> <span class="key">for</span> <span class="nam">ctx</span> <span class="key">in</span> <span class="nam">ctxs</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t80" href="#t80">80</a></span><span class="t"> <span class="com"># 章级管道重试（#1/#2）：真实 LLM 输出有随机方差，单章硬失败不连坐整次运行。</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t81" href="#t81">81</a></span><span class="t"> <span class="com"># 每轮管道尝试内部已含 WriterAgent.max_retries 次 LLM 调用；chapter_attempts 为</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t82" href="#t82">82</a></span><span class="t"> <span class="com"># 管道层兜底轮数（默认 3）。耗尽后仍抛错（不吞错）。</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t83" href="#t83">83</a></span><span class="t"> <span class="nam">content</span><span class="op">:</span> <span class="nam">ChapterContent</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t84" href="#t84">84</a></span><span class="t"> <span class="nam">last_err</span><span class="op">:</span> <span class="nam">Exception</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t85" href="#t85">85</a></span><span class="t"> <span class="key">for</span> <span class="nam">attempt</span> <span class="key">in</span> <span class="nam">range</span><span class="op">(</span><span class="nam">max</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">chapter_attempts</span><span class="op">)</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t86" href="#t86">86</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t87" href="#t87">87</a></span><span class="t"> <span class="nam">content</span> <span class="op">=</span> <span class="nam">agent</span><span class="op">.</span><span class="nam">generate_chapter</span><span class="op">(</span><span class="nam">ctx</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t88" href="#t88">88</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t89" href="#t89">89</a></span><span class="t"> <span class="key">except</span> <span class="nam">WriterGenerationError</span> <span class="key">as</span> <span class="nam">e</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t90" href="#t90">90</a></span><span class="t"> <span class="nam">last_err</span> <span class="op">=</span> <span class="nam">e</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t91" href="#t91">91</a></span><span class="t"> <span class="nam">_LOGGER</span><span class="op">.</span><span class="nam">warning</span><span class="op">(</span><span class="str">"章节 %s 生成失败（第 %d/%d 轮管道重试）: %s"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t92" href="#t92">92</a></span><span class="t"> <span class="nam">ctx</span><span class="op">.</span><span class="nam">chapter_id</span><span class="op">,</span> <span class="nam">attempt</span> <span class="op">+</span> <span class="num">1</span><span class="op">,</span> <span class="nam">chapter_attempts</span><span class="op">,</span> <span class="nam">e</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t93" href="#t93">93</a></span><span class="t"> <span class="key">if</span> <span class="nam">content</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t94" href="#t94">94</a></span><span class="t"> <span class="key">raise</span> <span class="nam">WriterGenerationError</span><span class="op">(</span><span class="fst">f"</span><span class="fst">章节 </span><span class="op">{</span><span class="nam">ctx</span><span class="op">.</span><span class="nam">chapter_id</span><span class="op">}</span><span class="fst"> 管道重试耗尽: </span><span class="op">{</span><span class="nam">last_err</span><span class="op">}</span><span class="fst">"</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t95" href="#t95">95</a></span><span class="t"> <span class="nam">contents</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">content</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t96" href="#t96">96</a></span><span class="t"> <span class="nam">blocks</span> <span class="op">=</span> <span class="nam">render_chapter_blocks</span><span class="op">(</span><span class="nam">content</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t97" href="#t97">97</a></span><span class="t"> <span class="nam">sec_id</span> <span class="op">=</span> <span class="nam">_section_id_of</span><span class="op">(</span><span class="nam">ctx</span><span class="op">.</span><span class="nam">template_marker</span><span class="op">.</span><span class="nam">section_placeholder</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t98" href="#t98">98</a></span><span class="t"> <span class="key">if</span> <span class="nam">sec_id</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t99" href="#t99">99</a></span><span class="t"> <span class="nam">sections</span><span class="op">[</span><span class="nam">sec_id</span><span class="op">]</span> <span class="op">=</span> <span class="nam">blocks</span> </span><span class="r"></span></p>
|
|
<p class="pln"><span class="n"><a id="t100" href="#t100">100</a></span><span class="t"> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t101" href="#t101">101</a></span><span class="t"> <span class="nam">tpl</span> <span class="op">=</span> <span class="nam">template_path</span> <span class="key">or</span> <span class="nam">getattr</span><span class="op">(</span><span class="nam">structured_source</span><span class="op">.</span><span class="nam">template</span><span class="op">,</span> <span class="str">"file_name"</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t102" href="#t102">102</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">tpl</span><span class="op">:</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t103" href="#t103">103</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"template_path 必须提供（structured_source.template.file_name 为空）"</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="par run show_par"><span class="n"><a id="t104" href="#t104">104</a></span><span class="t"> <span class="key">if</span> <span class="nam">meta</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">104 ↛ 110</span><span class="annotate long">line 104 didn't jump to line 110 because the condition on line 104 was always true</span></span></p>
|
|
<p class="run"><span class="n"><a id="t105" href="#t105">105</a></span><span class="t"> <span class="nam">meta</span> <span class="op">=</span> <span class="op">{</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t106" href="#t106">106</a></span><span class="t"> <span class="str">"doc_title"</span><span class="op">:</span> <span class="nam">Path</span><span class="op">(</span><span class="nam">tpl</span><span class="op">)</span><span class="op">.</span><span class="nam">stem</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t107" href="#t107">107</a></span><span class="t"> <span class="str">"version"</span><span class="op">:</span> <span class="str">"v1"</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t108" href="#t108">108</a></span><span class="t"> <span class="str">"created_at"</span><span class="op">:</span> <span class="nam">date</span><span class="op">.</span><span class="nam">today</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">isoformat</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p>
|
|
<p class="run run2"><span class="n"><a id="t109" href="#t109">109</a></span><span class="t"> <span class="op">}</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t110" href="#t110">110</a></span><span class="t"> <span class="nam">doc</span> <span class="op">=</span> <span class="nam">DocxInjector</span><span class="op">(</span><span class="nam">tpl</span><span class="op">)</span><span class="op">.</span><span class="nam">inject</span><span class="op">(</span><span class="nam">sections</span><span class="op">,</span> <span class="nam">meta</span><span class="op">=</span><span class="nam">meta</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t111" href="#t111">111</a></span><span class="t"> <span class="nam">Path</span><span class="op">(</span><span class="nam">output_path</span><span class="op">)</span><span class="op">.</span><span class="nam">parent</span><span class="op">.</span><span class="nam">mkdir</span><span class="op">(</span><span class="nam">parents</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="nam">exist_ok</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t112" href="#t112">112</a></span><span class="t"> <span class="nam">doc</span><span class="op">.</span><span class="nam">save</span><span class="op">(</span><span class="nam">output_path</span><span class="op">)</span> </span><span class="r"></span></p>
|
|
<p class="run"><span class="n"><a id="t113" href="#t113">113</a></span><span class="t"> <span class="key">return</span> <span class="nam">contents</span> </span><span class="r"></span></p>
|
|
</main>
|
|
<footer>
|
|
<div class="content">
|
|
<p>
|
|
<a class="nav" href="z_cac49e191045e829_models_py.html">« prev</a>
|
|
<a class="nav" href="index.html">^ index</a>
|
|
<a class="nav" href="z_cac49e191045e829_renderer_py.html">» next</a>
|
|
|
|
<a class="nav" href="https://coverage.readthedocs.io/en/7.15.4">coverage.py v7.15.4</a>,
|
|
created at 2026-08-26 14:20 +0800
|
|
</p>
|
|
</div>
|
|
</footer>
|
|
</body>
|
|
</html>
|