eduevidence 5.2.0 → 6.0.0

package/visualization/eduevidence-report/assets/reader.js

@@ -0,0 +1,132 @@
+/* Offline reader: navigation and display only; no research state mutations. */
+(function () {
+  "use strict";
+  var root = document.documentElement;
+  var copy = {
+    zh: {
+      brief: "\u6458\u8981",
+      full: "\u5b8c\u6574\u62a5\u544a",
+      print: "\u6253\u5370",
+      matched: "\u6761\u8bc1\u636e",
+    },
+    en: {
+      brief: "Brief",
+      full: "Full report",
+      print: "Print",
+      matched: "findings",
+    },
+  };
+  function labels() {
+    var lang = root.lang.indexOf("en") === 0 ? "en" : "zh";
+    document.querySelectorAll("[data-copy]").forEach(function (el) {
+      el.textContent = copy[lang][el.dataset.copy];
+    });
+  }
+  labels();
+  new MutationObserver(labels).observe(root, {
+    attributes: true,
+    attributeFilter: ["lang"],
+  });
+  document.querySelectorAll(".reader-print").forEach(function (b) {
+    b.addEventListener("click", function () {
+      window.print();
+    });
+  });
+  document.querySelectorAll(".reader-home").forEach(function (a) {
+    a.addEventListener("click", function (e) {
+      e.preventDefault();
+      window.scrollTo({ top: 0, behavior: "instant" });
+    });
+  });
+  var scheduled = false;
+  function progress() {
+    scheduled = false;
+    var max = document.documentElement.scrollHeight - window.innerHeight;
+    var fraction = max > 0 ? Math.min(1, Math.max(0, window.scrollY / max)) : 0;
+    var bar = document.querySelector(".reader-progress>span");
+    if (bar) bar.style.transform = "scaleX(" + fraction + ")";
+    var shell = Array.from(document.querySelectorAll(".report-shell")).find(
+      function (s) {
+        return getComputedStyle(s).display !== "none";
+      },
+    );
+    if (!shell) return;
+    var blocks = Array.from(shell.querySelectorAll(".brief-block[id]"));
+    var current = blocks
+      .filter(function (b) {
+        return b.getBoundingClientRect().top < 150;
+      })
+      .pop();
+    shell.querySelectorAll(".brief-navigation a").forEach(function (a) {
+      var active = current && a.hash === "#" + current.id;
+      a.classList.toggle("active", !!active);
+      if (active) a.setAttribute("aria-current", "location");
+      else a.removeAttribute("aria-current");
+    });
+  }
+  function queue() {
+    if (!scheduled) {
+      scheduled = true;
+      requestAnimationFrame(progress);
+    }
+  }
+  window.addEventListener("scroll", queue, { passive: true });
+  window.addEventListener("resize", queue);
+  document.addEventListener("click", queue);
+  progress();
+  document.querySelectorAll(".report-view-btn").forEach(function (btn) {
+    btn.addEventListener("click", function () {
+      window.scrollTo({ top: 0, behavior: "instant" });
+    });
+  });
+  document
+    .querySelectorAll(".table-wrap,.evidence-to-action")
+    .forEach(function (el) {
+      el.tabIndex = 0;
+      el.setAttribute("role", "region");
+      el.setAttribute(
+        "aria-label",
+        root.lang.indexOf("en") === 0
+          ? "Scrollable data table"
+          : "\u53ef\u6eda\u52a8\u6570\u636e\u8868",
+      );
+    });
+  document
+    .querySelectorAll('table[id^="evidence-matrix-"]')
+    .forEach(function (table) {
+      var suffix = table.id.replace(/^evidence-matrix-/, "");
+      var counter = document.createElement("p");
+      counter.className = "reader-filter-count";
+      counter.setAttribute("role", "status");
+      counter.setAttribute("aria-live", "polite");
+      table.parentElement.insertAdjacentElement("beforebegin", counter);
+      function count() {
+        var rows = Array.from(table.querySelectorAll("tbody tr"));
+        var visible = rows.filter(function (r) {
+          return r.style.display !== "none";
+        }).length;
+        counter.textContent =
+          visible +
+          " / " +
+          rows.length +
+          " " +
+          copy[suffix.endsWith("en") ? "en" : "zh"].matched;
+      }
+      ["matrix-search-", "matrix-direction-", "matrix-outcome-"].forEach(
+        function (prefix) {
+          var input = document.getElementById(prefix + suffix);
+          if (input) {
+            input.addEventListener("input", count);
+            input.addEventListener("change", count);
+          }
+        },
+      );
+      count();
+    });
+  document
+    .querySelectorAll('a[href^="http:"] , a[href^="https:"]')
+    .forEach(function (a) {
+      a.target = "_blank";
+      a.rel = "noopener noreferrer";
+    });
+})();

package/visualization/eduevidence-report/references/chart-selection-catalog.md

@@ -0,0 +1,109 @@
+# Chart Selection Catalog — AI 选图与表格边界
+
+本目录是 EduEvidence 报告生成阶段的**自包含选图控制面**。AI 可以根据 `result.json` 的数据形状自由组合图表，但只能从运行时注册表中选择；AI 负责“选什么、为什么”，确定性渲染器负责“从哪里取数、怎么画”。
+
+> 核心原则：**图负责模式识别，表负责精确核验。** 不为了“更像数据产品”把所有表格图表化，也不了“严谨”把所有模式藏在大表里。
+
+## 1. Table vs. chart policy
+
+### 必须保留表格 / 展开详情的内容
+
+- `EvidenceMatrix`：Evidence ID / Outcome / Effect / Quality / Claim / Source。
+- `SourceList`：来源标题、年份、authority、canonical location。
+- `MethodologyPanel` / methodology details：审计项的原始判断与备注。
+- `ClaimTrace`：Claim → Evidence → Outcome → Effect → Quality → Source 的精确链路。
+- 任何用户需要逐行复核、复制、引用或追溯的记录。
+
+这些是审计面，不属于“可视化失败”。图表可以总结它们，但不能替代它们。
+
+### 优先使用图表的内容
+
+- 效应量及 CI 的横向比较。
+- 研究/证据在年份、结果维度、设计簻型上的分布。
+- 正向 / 负向 / 零效应的构成或两极差异。
+- 干预阶段、活动数量与时间分布。
+- 单值置信度和方法学检查构成。
+- 多维研究特征的模式发现。
+
+### 不画图的情况
+
+- 数据不足以形成至少一个诚实的视觉关系。
+- 维度单位不可比较或把不同 outcome 合并会制造假结论。
+- 只有一条记录且图表没有比文本/表格增加信息。
+- 缺失值会迫使渲染器填 `0`、补 CI、补趋势或推断因果方向。
+
+此时输出 `VisualizationSuppressed` / `LieflatSuppressed` 和原因，比凑图更正确。
+
+## 2. AI selection protocol
+
+对每个准备表达的**独立结论**执行：
+
+1. **识别数据形状**：g+CI、排序 g+N、年份×维度、逐条分布、100% 构成、方向计数、双极轴、阶段周区间、单值置信度、审计票数等。
+2. **召回候选**：从下表中找语义匹配且提取器有数据的候选。通常比较至少 3 个；如果有效候选本来只有 1–2 个，不得为了满足数量硬凑不合适图型。
+3. **逐项比较**：语义契合、单位诚实、标签容纳、阅读速度、移动端适配、与本批次图型是否重复、数据是否达到 Meaningful Visualization Gate。
+4. **记录淘汰原因**：例如“需要 CI，但当前只有点估计”“类别名过长，不适合竖排”“与上一张同为方向计数，信息重复”。
+5. **选择 ≤6 张**：每张图必须承担不同结论，优先轮廓多样性而非数量；同一数据形状不要堆多个近似图。
+6. **只写计划，不写数值**：AI 只写 `type / catalog_ref / title_zh+en / subtitle_zh+en / caption_zh+en / source / params`。所有数值由 `charts_data.py` 提取。
+7. **让渲染器最终裁决可画性**：注册表未收录、参数非法或数据不足时显式拒绝/抑制，不允许 AI 绕过。
+
+## 3. Registered chart catalog
+
+| `type` | `catalog_ref` | 数据形状 / extractor source | 最适合表达 | 避免使用 |
+|---|---|---|---|---|
+| `forest_plot` | FOREST-PLOT (publication figure) | g + 95% CI · `meta.forest` | 多研究效应与不确定性、零线关系 | 无 CI 时不要伪造区间 |
+| `dot_cascade` | L2 Dot Cascade | 排序 g + N · `evidence.ranked_effects` | 效应量梯队、快速看排序与差距 | outcome/单位不可比时不要混排 |
+| `bubble_almanac` | L9 Bubble Almanac | 年份 × 维度 × 研究数 · `evidence.year_x_dimension` | 时间覆盖与研究密度 | 没有年份或二维结构时不用 |
+| `jitter_strip` | G15 Jitter Strip | 分组逐研究 g · `evidence.grouped_distribution` | 分布、离散度、异常点 | 只有聚合均值时不用 |
+| `parallel_coordinates` | L20 Parallel Coordinates | g / N / 质量 / 年份 · `evidence.multidim_top` | 同一批研究的多维差异 | 维度单位/缩放无法解释时不用 |
+| `hundred_field` | L14 Hundred Field | 研穵类型 100% 构成 · `evidence.study_type_composition` | 离散单位组成、研究设计结构 | 总数过大且单位点失去意义时慎用 |
+| `tick_donut` | F4 Tick Donut | WWC 100% 构成 · `evidence.wwc_composition` | 少类别质量/等级份额 | 类别过多或精确比较更重要时不用 |
+| `tick_rows` | F5 Tick Rows | outcome 方向计数 · `outcomes.direction_counts` | 长类目下的正/负/零分布 | 样本点太少且文本更清楚时不用 |
+| `rung_bars` | F1 Rung Bars | outcome 方向计数 · `outcomes.direction_counts` | 紧凑方向计数比较 | 长中文类目或移动端拥挤时优先 tick_rows |
+| `paired_rungs` | F6 Paired Rungs | 正/负成对计数 · `outcomes.paired_counts` | 每 outcome 正负直接对照 | 需要展示大量 null 时不优先 |
+| `brand_spectrum` | L7 Brand Spectrum | 双极位置 · `outcomes.bipolar_axes` | “收益 ↔ 风险/退化”的方向张力 | 不得把 claim support 当正效应 |
+| `barcode_lollipop` | L3 Barcode Lollipop | 周次 × 阶段 · `intervention.phase_weeks` | 干预阶段时间安排 | 没有真实周区间时不补时间点 |
+| `launch_fan` | L1 Launch Fan | 阶段 × 活动权重 · `intervention.activity_weights` | 阶段工作量/活动构成 | “活动条数”不是强度时须在副标题说明 |
+| `dotty_matrix` | L8 Dotty Matrix | 阶段 × 活动点阵 · `intervention.phase_groups` | 阶段结构和活动密度 | 不得把点数解释成效果大小 |
+| `tick_gauge` | F11 Tick Gauge | 0–100% 单值 · `decision.confidence_score` | 已存在的决策置信度 | 不得从证据数量自行计算 confidence |
+| `ballot_tally` | L15 Ballot Tally | 方法学检查计票 · `methodology.flag_rates` | 审计通过/风险项概览 | 不替代方法学原始备注 |
+| `matrix_heat` | L16 Matrix Heat | 年份 × outcome × count · `evidence.year_x_outcome_counts` | 二维覆盖、证据空白和聚集区 | count 不代表效果强弱，标题需避免误导 |
+
+## 4. Recommended candidate families
+
+同一“问题”先在家族内比较，再跨家族避免重复：
+
+- **效应与不确定性**：`forest_plot` / `dot_cascade` / `jitter_strip` / `parallel_coordinates`。
+- **证据分布与覆盖**：`bubble_almanac` / `matrix_heat` / `hundred_field` / `tick_donut`。
+- **结果方向**：`tick_rows` / `rung_bars` / `paired_rungs` / `brand_spectrum`。
+- **干预结构**：`barcode_lollipop` / `launch_fan` / `dotty_matrix`。
+- **决策与方法学摘要**：`tick_gauge` / `ballot_tally`。
+
+示例：如果目标是“不同 outcome 的正负证据差异”，先比较 `tick_rows`、`rung_bars`、`paired_rungs`、`brand_spectrum`；如果类目长且要保留 null，通常 `tick_rows` 更合适；如果核心是两极张力，`brand_spectrum` 更快；如果只想看正负并排，`paired_rungs` 更直接。
+
+## 5. Composition constraints
+
+- 一份报告最多 6 张 AI-composed 图；少而准优先于填满 6 张。
+- 每图对应一个明确问题或结论，不允许仅因“有数据”就画。
+- 同一批次避免重复轮廓：例如已经用 `tick_rows` 讲方向分布，就不要再用 `rung_bars` 重复同一事实，除非第二张回答的是不同问题。
+- 五种主题共享同一个 `visual_layout` 科学结构；主题只能改变版式、色板、表格密度和阅读节奏，不能改变数据、结论、图型含义或 Meaningful Visualization Gate。
+- 报告中的 `EvidenceMatrix`、`SourceList`、方法学详情和 `ClaimTrace` 始终保留可审计入口。
+- 图表数据必须通过 `lieflat_data_bound`；任何 AI 写入的数值都不进入渲染数据面。
+
+## 6. Output contract example
+
+```json
+{
+  "type": "paired_rungs",
+  "catalog_ref": "F6 Paired Rungs",
+  "title_zh": "迁移与保持结果呈现更明显的正负分化",
+  "title_en": "Transfer and retention outcomes show the clearest directional split",
+  "subtitle_zh": "每格 = 1 条已提取证据 · 正向与负向并列",
+  "subtitle_en": "1 cell = 1 extracted finding · positive and negative shown side by side",
+  "caption_zh": "仅展示已记录的 effect_direction，不根据 claim relation 推断方向。",
+  "caption_en": "Uses recorded effect_direction only; claim relation never determines effect direction.",
+  "source": "outcomes.paired_counts",
+  "params": {}
+}
+```
+
+AI 选择图型后，仍由 `references/lieflat-composition.md`、`schemas/visual-layout.schema.json`、`charts_data.py` 与 `lieflat_engine.REGISTRY` 共同执行机械校验。

package/visualization/eduevidence-report/references/lieflat-composition.md

@@ -2,10 +2,12 @@
 
 EduEvidence 的 Lieflat 画廊是**数据驱动的手作图表组合**：上游 AI 按数据形状自由选型（只能选注册表内图型），渲染器从 `result.json` 提取真实数据渲染成主题化内联 SVG。AI 不直接写数值——所有数字经 `scripts/charts_data.py` 提取器出数，完整性门 `lieflat_data_bound` 逐值核对溯源。
 
-> 上游规范 = `visualization/lieflat-charts/`（Lupi 正本 + mono-tokens）。本文件只记录 EduEvidence 特有规则。
+> AI 选图规范已内置于 `chart-selection-catalog.md`；本文件记录可执行注册表、数据契约与渲染不变量。任何外部图库只可作为设计灵感，不能成为运行时依赖。
 
 ## 1. 注册表（type ↔ 目录编号 ↔ 数据形状 ↔ 提取器）
 
+选图前先读 `chart-selection-catalog.md`：表格负责逐行审计，图表负责模式表达；AI 通常比较至少 3 个**可行**候选并记录淘汰理由，但候选不足时不得为凑数量选择错误图型。
+
 | `type` | 目录编号 | 数据形状 | 提取器（scripts/charts_data.py） |
 |---|---|---|---|
 | `forest_plot` | FOREST-PLOT (publication figure) | 逐研究 Hedges' g + 95% CI（meta.forest 或 evidence.effect_size） | `meta.forest` |

package/visualization/eduevidence-report/scripts/build_report.py

@@ -1555,55 +1555,15 @@ def first_screen(result: dict, lang: str, ui: dict) -> str:
     action = decision.get("recommended_action", "insufficient_evidence")
     cls = {"adopt": "adopt", "pilot": "pilot", "reject": "reject"}.get(action, "")
 
-    # 1. Strongest Supported Takeaway
-    if decision.get("strongest_support"):
-        strongest = decision.get("strongest_support")
-    elif can_claim:
-        strongest = can_claim[0]
-    elif supported_claims:
-        strongest = supported_claims[0]
-    else:
-        if lang == "zh":
-            strongest = f"即时编程任务编写耗时缩短 35%~50%，代码完成速度显著提升（综合效应量 g = +0.61, p < 0.001），在当堂受控实验中展现明显效率增益。"
-        else:
-            strongest = f"In-task programming completion time is shortened by 35%-50% with significant velocity gain (pooled g = +0.61, p < 0.001) in guided environments."
-
-    # 2. Key Uncertainty / Contradictions
-    if decision.get("key_uncertainty"):
-        uncertainty = decision.get("key_uncertainty")
-    elif uncertain_claims:
-        uncertainty = uncertain_claims[0]
-    elif contradicted_claims:
-        uncertainty = contradicted_claims[0]
-    elif decision.get("reason_for_disagreement"):
-        uncertainty = decision.get("reason_for_disagreement")
-    else:
-        if lang == "zh":
-            uncertainty = "撤除 AI 后的独立闭卷期末考试与概念迁移表现显著下滑（综合效应量 g = -0.28, p = 0.012），学生存在‘看似学会、实则不会’的认知盲区。"
-        else:
-            uncertainty = "Delayed solo exams and independent transfer performance decline significantly (pooled g = -0.28, p = 0.012) once scaffolding is removed."
-
-    # 3. Main Risk
-    if decision.get("main_risk"):
-        risk = decision.get("main_risk")
-    elif decision.get("risk_effect"):
-        risk = decision.get("risk_effect")
-    else:
-        if lang == "zh":
-            risk = "认知脚手架依赖陷阱（Scaffolding Dependency Trap）：过度依赖实时代码补全导致学生自主调试排错、边界测试与底层计算思维出现退化。"
-        else:
-            risk = "Scaffolding Dependency Trap: Over-reliance on code completion degrades novice debugging, boundary testing, and fundamental computational thinking."
-
-    # 4. Next Action / Policy Guidance
-    if decision.get("next_action"):
-        next_action = decision.get("next_action")
-    elif decision.get("next_steps"):
-        next_action = decision.get("next_steps")
-    else:
-        if lang == "zh":
-            next_action = "建议开展限制性教学试点：① 采用苏格拉底式概念引导，严禁直接给答案；② 实行 4 阶段脚手架渐进剥离；③ 坚持以无 AI 闭卷机试与独立随访作为最终考核标准。"
-        else:
-            next_action = "Execute restricted classroom pilot: ① Enforce Socratic guidance instead of direct code generation; ② Implement 4-phase scaffolding fading; ③ Anchor summative grading in unassisted closed-book exams."
+    missing = "当前结果未提供此项信息。" if lang == "zh" else "Not provided in this research result."
+    strongest = (decision.get("strongest_support") or (can_claim[0] if can_claim else None)
+                 or (supported_claims[0] if supported_claims else None) or missing)
+    uncertainty = (decision.get("key_uncertainty")
+                   or (uncertain_claims[0] if uncertain_claims else None)
+                   or (contradicted_claims[0] if contradicted_claims else None)
+                   or decision.get("reason_for_disagreement") or missing)
+    risk = decision.get("main_risk") or decision.get("risk_effect") or missing
+    next_action = decision.get("next_action") or decision.get("next_steps") or missing
 
     rationale = decision.get("decision_rationale") or decision.get("rationale") or ""
     rationale_html = expandable_text(rationale, ui["expand_details"], 380, "hero-rationale")
@@ -2130,7 +2090,9 @@ def render_intervention(result: dict, svg: str, lang: str, ui: dict) -> str:
     intervention = result.get("intervention", {})
     if not intervention:
         return f"<p>{esc(ui['no_data'])}</p>"
-    lines = [f"<p><strong>{esc(ui['intervention_learners'])}{esc(ui['colon'])}</strong>{esc(intervention.get('target_learners'))} · "
+    population = intervention.get("target_population") or intervention.get("target_learners")
+    population_label = ("目标人群" if lang == "zh" else "Target population") if intervention.get("target_population") else ui['intervention_learners']
+    lines = [f"<p><strong>{esc(population_label)}{esc(ui['colon'])}</strong>{esc(population)} · "
              f"<strong>{esc(ui['intervention_duration'])}{esc(ui['colon'])}</strong>{esc(intervention.get('pilot_duration'))}</p>"]
     if intervention.get("ai_usage_policy"):
         lines.append(f"<p><strong>{esc(ui['intervention_policy'])}{esc(ui['colon'])}</strong>{esc(intervention['ai_usage_policy'])}</p>")
@@ -2656,6 +2618,17 @@ def _lang_switcher(ui_zh: dict, ui_en: dict) -> str:
         "</div>")
 
 
+def script_json(value: object) -> str:
+    """Serialize untrusted evidence/chart data for an inline script context."""
+    return (json.dumps(value, ensure_ascii=False, allow_nan=False)
+            .replace("&", "\\u0026").replace("<", "\\u003c").replace(">", "\\u003e")
+            .replace("\u2028", "\\u2028").replace("\u2029", "\\u2029"))
+
+
+def _reader_asset(name: str) -> str:
+    return (Path(__file__).resolve().parent.parent / "assets" / name).read_text(encoding="utf-8")
+
+
 def _enhancer_js(charts_zh: dict, charts_en: dict, result_en: dict) -> str:
     outcome_zh = next((c for c in charts_zh.get("charts", [])
                        if c.get("chart_id") == "outcome-evidence-overview"), None)
@@ -2700,7 +2673,8 @@ def _enhancer_js(charts_zh: dict, charts_en: dict, result_en: dict) -> str:
   }}
   var savedLang = null;
   try {{ savedLang = localStorage.getItem('eduevidence-lang'); }} catch (e) {{}}
-  applyLang(savedLang === 'en' ? 'en' : 'zh');
+  var queryLang = new URLSearchParams(window.location.search).get('lang');
+  applyLang((queryLang || savedLang) === 'en' ? 'en' : 'zh');
   document.querySelectorAll('.lang-btn').forEach(function (btn) {{
     btn.addEventListener('click', function () {{ applyLang(btn.dataset.langTarget); }});
   }});
@@ -2721,7 +2695,8 @@ def _enhancer_js(charts_zh: dict, charts_en: dict, result_en: dict) -> str:
   }}
   var savedView = null;
   try {{ savedView = localStorage.getItem('eduevidence-report-view'); }} catch (e) {{}}
-  applyReportView(savedView === 'full' ? 'full' : 'brief');
+  var queryView = new URLSearchParams(window.location.search).get('view');
+  applyReportView((queryView || savedView) === 'full' ? 'full' : 'brief');
   document.querySelectorAll('.report-view-btn').forEach(function (btn) {{
     btn.addEventListener('click', function () {{ applyReportView(btn.dataset.reportView); }});
   }});
@@ -2803,12 +2778,12 @@ def _enhancer_js(charts_zh: dict, charts_en: dict, result_en: dict) -> str:
     window.eduevidenceCharts = window.eduevidenceCharts || {{}};
     window.eduevidenceCharts[containerId] = chart;
   }}
-  mountChart('chart-outcome-zh', {json.dumps(outcome_zh or {}, ensure_ascii=False)});
-  mountChart('chart-trace-zh', {json.dumps(trace_zh or {}, ensure_ascii=False)});
-  mountChart('chart-benchmark-zh', {json.dumps(benchmark_zh, ensure_ascii=False)});
-  mountChart('chart-outcome-en', {json.dumps(outcome_en or {}, ensure_ascii=False)});
-  mountChart('chart-trace-en', {json.dumps(trace_en or {}, ensure_ascii=False)});
-  mountChart('chart-benchmark-en', {json.dumps(benchmark_en, ensure_ascii=False)});
+  mountChart('chart-outcome-zh', {script_json(outcome_zh or {})});
+  mountChart('chart-trace-zh', {script_json(trace_zh or {})});
+  mountChart('chart-benchmark-zh', {script_json(benchmark_zh)});
+  mountChart('chart-outcome-en', {script_json(outcome_en or {})});
+  mountChart('chart-trace-en', {script_json(trace_en or {})});
+  mountChart('chart-benchmark-en', {script_json(benchmark_en)});
 }})();
 """
 
@@ -2931,15 +2906,25 @@ def render_body(result: dict, lang: str, ui: dict, charts: dict, infographics: d
     brief_blocks = [
         render_brief_block(*brief_titles["decision"], first_screen(result, lang, ui), "brief-decision"),
     ]
-    if lieflat_gallery_html:
-        brief_blocks.append(render_brief_block(*brief_titles["lieflat"], lieflat_gallery_html, "brief-lieflat"))
     brief_blocks.extend([
         render_brief_block(*brief_titles["outcomes"], render_outcomes_brief(result, outcome_chart, lang, ui, viz), "brief-outcomes"),
         render_brief_block(*brief_titles["tribunal"], render_tribunal_visual(result, "", "", lang, ui, compact=True), "brief-tribunal"),
         render_brief_block(*brief_titles["action"], render_evidence_to_action(result, lang, ui), "brief-action"),
         render_brief_block(*brief_titles["sources"], render_brief_sources(result, lang, ui), "brief-sources"),
     ])
+    if lieflat_gallery_html:
+        brief_blocks.insert(-1, render_brief_block(*brief_titles["lieflat"], lieflat_gallery_html, "brief-lieflat"))
     brief = "".join(brief_blocks)
+    # Unique fragment targets per language, stable across theme variants.
+    for section_key in ("decision", "outcomes", "tribunal", "action", "lieflat", "sources"):
+        brief = brief.replace(f'class="brief-block brief-{section_key}"',
+                              f'class="brief-block brief-{section_key}" id="brief-{section_key}-{lang}"')
+    nav_items = [("decision", brief_titles["decision"][0]), ("outcomes", brief_titles["outcomes"][0]),
+                 ("tribunal", brief_titles["tribunal"][0]), ("action", brief_titles["action"][0]),
+                 ("sources", brief_titles["sources"][0])]
+    brief_nav = '<nav class="brief-navigation" aria-label="' + ("摘要导航" if lang == "zh" else "Brief navigation") + '">' + ''.join(
+        f'<a href="#brief-{key}-{lang}"><span>{i:02d}</span>{esc(title)}</a>'
+        for i, (key, title) in enumerate(nav_items, 1)) + '</nav>'
     full_report = render_full_report(result, lang, ui, charts, infographics, figures, viz)
     toc = render_full_toc(result, lang, ui)
 
@@ -2953,7 +2938,7 @@ def render_body(result: dict, lang: str, ui: dict, charts: dict, infographics: d
     else:
         origin_chip = ''
     meta_line = (f"{esc(ui['header_mode'])}{esc(label(lang, 'mode', meta.get('mode') or ''))}"
-                 f" · {esc(ui['header_generated'])}{esc(meta.get('generated_at') or '')}"
+                 f" · {esc(ui['header_generated'])}{esc(str(meta.get('generated_at') or '')[:10])}"
                  f" · {esc(ui['header_evidence'])}{len(result.get('evidence', []))}"
                  f"{esc(ui['header_evidence_suffix'])}"
                  f" · {esc(ui['header_sources'])}{len(result.get('sources', []))}"
@@ -2968,7 +2953,7 @@ def render_body(result: dict, lang: str, ui: dict, charts: dict, infographics: d
 <button type="button" class="report-view-btn" data-report-view="full" aria-pressed="false">{esc(ui['full_report'])}</button>
 </nav>
 </header>
-<div class="report-page report-page-brief" data-report-page="brief">{brief}</div>
+<div class="report-page report-page-brief" data-report-page="brief">{brief_nav}<div class="brief-reading-content">{brief}</div></div>
 <div class="report-page report-page-full" data-report-page="full" hidden>
 <div class="full-report-intro"><h2>{esc(ui['full_report'])}</h2><p>{esc(ui['full_report_intro'])}</p></div>
 <div class="full-report-layout">{toc}<main class="full-report-content">{full_report}</main></div>
@@ -2993,18 +2978,25 @@ def render_html(result_en: dict, result_zh: dict, charts_zh: dict, charts_en: di
 <html lang="zh-CN" data-theme="{esc(theme)}">
 <head>
 <meta charset="utf-8">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; font-src data:; connect-src 'none'; base-uri 'none'; object-src 'none'; form-action 'none'">
 {hash_meta}<meta name="viewport" content="width=device-width, initial-scale=1">
 <title>{esc(result_zh.get("meta", {}).get("question") or result_en.get("meta", {}).get("question") or "EduEvidence Evidence Report")}</title>
 <style>
 {_theme_css()}
 {_base_css()}
 {_motion_css()}
+{_reader_asset("reader.css")}
 </style>
 </head>
 <body>
-<div class="controls">
-<span class="generated-theme">{esc(THEME_DISPLAY[theme])}</span>
-{_lang_switcher(UI_ZH, UI_EN)}
+<div class="reader-progress" aria-hidden="true"><span></span></div>
+<div class="controls reader-toolbar">
+<a class="reader-home" href="#" aria-label="Back to report start">EduEvidence<span class="generated-theme">{esc(THEME_DISPLAY[theme])}</span></a>
+<div class="reader-view-controls" role="group" aria-label="Report view">
+<button type="button" class="report-view-btn active" data-report-view="brief" data-copy="brief" aria-pressed="true">摘要</button>
+<button type="button" class="report-view-btn" data-report-view="full" data-copy="full" aria-pressed="false">完整报告</button>
+</div>
+<div class="reader-tools">{_lang_switcher(UI_ZH, UI_EN)}<button class="reader-print" type="button" data-copy="print">打印</button></div>
 </div>
 {body_zh}
 {body_en}
@@ -3013,6 +3005,7 @@ def render_html(result_en: dict, result_zh: dict, charts_zh: dict, charts_en: di
 </script>
 <script>
 {_enhancer_js(charts_zh, charts_en, result_en)}
+{_reader_asset("reader.js")}
 </script>
 </body>
 </html>