Finalize adaptive research and deck experience

README.md

@@ -14,11 +14,13 @@ license: apache-2.0
 
 # Algorithm Research Deck
 
-Turn an algorithm research topic into an interactive, paper-backed HTML presentation. DeepSeek-V4-Flash first converts Chinese inputs into a precise English technical interpretation and expands them into historical, milestone, current, and benchmark-oriented search queries. The Space searches arXiv with OpenAlex fallback, uses Hugging Face Inference Providers for synthesis, previews the result, and provides HTML, JSON, and ZIP downloads.
+Turn an algorithm research topic into an interactive, evidence-aware HTML presentation. DeepSeek-V4-Flash first converts Chinese inputs into a precise English technical interpretation and expands them into historical, milestone, current, and evaluation-oriented search queries. Results are balanced across query intents instead of allowing the first query to dominate. The Space searches arXiv, supplements sparse or empty results with OpenAlex, uses Hugging Face Inference Providers for synthesis, previews the result, and provides HTML, JSON, and ZIP downloads.
 
 Users can disable online paper search. In that mode the deck relies on the model's existing knowledge and visibly discloses that papers and recency were not externally verified. Download controls sit in the presentation toolbar: HTML for the standalone interactive deck, JSON for structured research data, and ZIP for both.
 
-Report generation is staged: raw papers are compressed into evidence cards, then the model infers the research type, creates a topic-specific outline, and writes each section using an appropriate layout. Timelines, comparisons, equations, paper analysis, and evidence-gap pages are optional rather than globally required. Layout-aware Pydantic validation and at most two targeted repair attempts prevent empty slides while still allowing unfamiliar topics to become clearly labeled exploratory reports instead of fabricated literature reviews.
+Report generation is staged: selected papers are compressed into evidence cards, then the model infers the research type, creates a topic-specific outline, and writes sections in batches of at most four. Each generated section is locked back to its approved outline identity and layout. Timelines, comparisons, processes, equations, paper analysis, and evidence-gap pages are optional rather than globally required. Layout-aware Pydantic validation, malformed-JSON recovery, citation allowlisting, and targeted repair attempts prevent empty slides and unsupported references. If academic search returns no usable result, the run visibly degrades to an exploratory model-knowledge report instead of failing or fabricating papers.
+
+The standalone deck includes an executive-summary view, a generated research map, slide overview navigation, keyboard and touch controls, interactive process nodes, balanced comparison tables, clickable source chips, responsive layouts, and landscape print/PDF styling.
 
 ## Space configuration
 

app.py

@@ -121,7 +121,7 @@ class ReportSection(BaseModel):
 
 
 class SectionsEnvelope(BaseModel):
-    sections: list[ReportSection] = Field(min_length=3, max_length=12)
+    sections: list[ReportSection] = Field(min_length=1, max_length=4)
 
 
 class ResearchReport(BaseModel):
@@ -307,23 +307,34 @@ def plan_search_queries(request: ResearchRequest) -> tuple[list[str], dict[str,
 
 def search_literature(queries: list[str], total_limit: int) -> tuple[list[dict[str, Any]], list[str]]:
     per_query = max(5, min(20, total_limit // max(1, len(queries))))
-    papers: list[dict[str, Any]] = []
+    buckets: list[list[dict[str, Any]]] = []
     warnings: list[str] = []
     for query in queries:
+        query_papers: list[dict[str, Any]] = []
         try:
             found = arxiv_search(query, per_query)
             for paper in found:
                 paper["source"] = "arXiv"
-            papers.extend(found)
+            query_papers.extend(found)
         except Exception:
             warnings.append(f"arXiv timeout: {query}")
+        if len(query_papers) < max(2, per_query // 4):
             try:
-                papers.extend(openalex_search(query, per_query))
+                query_papers.extend(openalex_search(query, per_query))
             except Exception:
                 warnings.append(f"OpenAlex timeout: {query}")
-        if len(deduplicate(papers)) >= total_limit:
+        buckets.append(deduplicate(query_papers))
+
+    balanced: list[dict[str, Any]] = []
+    max_bucket = max((len(bucket) for bucket in buckets), default=0)
+    for index in range(max_bucket):
+        for bucket in buckets:
+            if index < len(bucket):
+                balanced.append(bucket[index])
+        balanced = deduplicate(balanced)
+        if len(balanced) >= total_limit:
             break
-    return deduplicate(papers)[:total_limit], warnings
+    return deduplicate(balanced)[:total_limit], warnings
 
 
 def generate_text(system: str, prompt: str, max_tokens: int, structured: bool = True) -> str:
@@ -597,42 +608,69 @@ def build_report(
         3200,
     )
 
-    sections_result = chat_json(
-        "Write all presentation sections from the model-designed outline. Return only JSON matching the schema. "
-        "Use the selected layout for each section and put layout-specific data in content. Text/evidence sections may use "
-        "{points, details}; timeline uses {nodes:[{year,title,problem,innovation,limitation}]}; comparison uses "
-        "{columns:[...], rows:[{name, values:[...]}]}; process uses {steps:[{name,description}]} for a linear flow, "
-        "or {common_steps:[...],branches:[{name,steps:[...]}]} when methods diverge; equation uses "
-        "{equation, symbols, interpretation}; paper-analysis uses {method,evidence,limitations}; evidence-gap uses "
-        "{interpretation,related_topics,hypotheses,required_inputs}. Every takeaway must follow from the content. "
-        "Distinguish sourced facts from analysis or hypotheses. Never invent sources, papers, metrics, or recency claims.",
-        json.dumps({
-            **shared_context,
-            "outline": outline.model_dump(),
-            "requirements": {
-                "one_section_per_outline_item": True,
-                "preserve_plan_id_title_purpose_layout": True,
-                "source_ids": "Only IDs present in evidence_cards; otherwise []",
-                "schema": SectionsEnvelope.model_json_schema(),
-            },
-        }, ensure_ascii=False),
-        5200,
-    )
-    sections = validate_stage_with_repairs(
-        sections_result,
-        SectionsEnvelope,
-        "report sections",
-        {**shared_context, "outline": outline.model_dump()},
-        5200,
+    section_system = (
+        "Write presentation-ready sections for algorithm engineers. Use the layout selected in the approved plan and put "
+        "layout-specific data in content. Text/evidence uses {points,details}; timeline uses "
+        "{nodes:[{year,title,problem,innovation,limitation}]}; comparison uses "
+        "{columns:[...],rows:[{name,values:[...]}]}; process uses {steps:[{name,description}]} or "
+        "{common_steps:[...],branches:[{name,steps:[...]}]}; equation uses {equation,symbols,interpretation}; "
+        "paper-analysis uses {method,evidence,limitations}; evidence-gap uses "
+        "{interpretation,related_topics,hypotheses,required_inputs}. Write for slides, not an essay: one conclusion per "
+        "section, concise points, explicit assumptions, comparable dimensions, and no repeated background. Distinguish "
+        "retrieved facts from analysis or hypotheses. Never invent sources, papers, metrics, or recency claims."
     )
+    generated_sections: list[ReportSection] = []
+    plans = outline.section_plan
+    for batch_index in range(0, len(plans), 4):
+        batch = plans[batch_index:batch_index + 4]
+        sections_result = chat_json(
+            section_system,
+            json.dumps({
+                **shared_context,
+                "report_identity": {
+                    "title": outline.title,
+                    "research_type": outline.research_type,
+                    "executive_summary": outline.executive_summary,
+                },
+                "approved_section_plan": [item.model_dump() for item in batch],
+                "requirements": {
+                    "exactly_one_section_per_plan_item_in_order": True,
+                    "preserve_plan_id_title_purpose_layout_exactly": True,
+                    "source_ids": "Only IDs present in evidence_cards; otherwise []",
+                    "schema": SectionsEnvelope.model_json_schema(),
+                },
+            }, ensure_ascii=False),
+            4200,
+        )
+        candidates = sections_result.get("sections", [])
+        for plan, candidate in zip(batch, candidates):
+            if isinstance(candidate, dict):
+                candidate.update({
+                    "id": plan.id, "title": plan.title, "purpose": plan.purpose, "layout": plan.layout,
+                })
+        validated_batch = validate_stage_with_repairs(
+            sections_result,
+            SectionsEnvelope,
+            f"report sections batch {batch_index // 4 + 1}",
+            {**shared_context, "approved_section_plan": [item.model_dump() for item in batch]},
+            4200,
+        )
+        if len(validated_batch.sections) != len(batch):
+            raise RuntimeError("The model omitted one or more approved report sections")
+        for plan, section in zip(batch, validated_batch.sections):
+            normalized = section.model_dump()
+            normalized.update({
+                "id": plan.id, "title": plan.title, "purpose": plan.purpose, "layout": plan.layout,
+            })
+            generated_sections.append(ReportSection.model_validate(normalized))
 
     assembled = {
         "title": outline.title,
         "subtitle": outline.subtitle,
         "research_type": outline.research_type,
         "executive_summary": outline.executive_summary,
-        "sections": [item.model_dump() for item in sections.sections],
-        "references": sorted({source_id for section in sections.sections for source_id in section.source_ids}),
+        "sections": [item.model_dump() for item in generated_sections],
+        "references": sorted({source_id for section in generated_sections for source_id in section.source_ids}),
         "limitations": (["Online literature verification was disabled; current-work claims may be incomplete."] if not cards else []),
         "english_understanding": english_understanding,
     }
@@ -679,61 +717,6 @@ def esc(value: Any) -> str:
     return html.escape(str(value or ""))
 
 
-def render_presentation_legacy(report: dict[str, Any], papers: list[dict[str, Any]], cutoff: str) -> str:
-    deck_css = (STATIC_DIR / "deck.css").read_text(encoding="utf-8")
-    deck_js = (STATIC_DIR / "deck.js").read_text(encoding="utf-8").replace("</script", "<\\/script")
-    citations = {p["id"]: p for p in papers}
-    lineage = report.get("lineage", [])
-    sections = report.get("sections", [])
-    summary = report.get("executive_summary", [])
-    comparisons = report.get("comparisons", [])
-    evidence_mode = (report.get("english_understanding") or {}).get("evidence_mode", "")
-    evidence_note = (
-        "未联网检索：内容来自模型已有知识，论文与最新性未经过外部核验。"
-        if evidence_mode else
-        "已联网检索并基于当前论文证据生成。"
-    )
-
-    timeline = "".join(
-        f'<button class="milestone" data-index="{i}" aria-pressed="{str(i == 0).lower()}"><span>{esc(x.get("year"))}</span>{esc(x.get("method"))}</button>'
-        for i, x in enumerate(lineage)
-    )
-    timeline_data = html.escape(json.dumps(lineage, ensure_ascii=False), quote=True)
-    summary_html = "".join(f"<li>{esc(x)}</li>" for x in summary)
-    section_html = "".join(
-        f'''<section class="slide" id="section-{i + 1}">
-        <p class="eyebrow">{i + 3:02d}</p><h2>{esc(x.get('title'))}</h2>
-        <p class="takeaway">{esc(x.get('takeaway'))}</p>
-        <ul>{''.join(f'<li>{esc(b)}</li>' for b in x.get('body', []))}</ul>
-        <details><summary>方法细节与证据</summary><p>{esc(x.get('details'))}</p><p class="sources">论文：{', '.join(esc(pid) for pid in x.get('paper_ids', []))}</p></details>
-        </section>'''
-        for i, x in enumerate(sections)
-    )
-    rows = "".join(
-        f"<tr><th>{esc(x.get('method'))}</th><td>{esc(x.get('mechanism'))}</td><td>{esc(x.get('strengths'))}</td><td>{esc(x.get('limitations'))}</td><td>{esc(x.get('engineering'))}</td></tr>"
-        for x in comparisons
-    )
-    refs = "".join(
-        f'<li id="ref-{esc(pid)}"><a href="{esc(p.get("url"))}" target="_blank" rel="noopener noreferrer">{esc(p.get("title"))}</a><br><span>{esc(", ".join(p.get("authors", [])[:6]))} · {esc((p.get("published") or "")[:10])} · arXiv:{esc(pid)}</span></li>'
-        for pid, p in citations.items()
-    )
-    open_questions = "".join(f"<li>{esc(x)}</li>" for x in report.get("open_questions", []))
-    title = esc(report.get("title", "Algorithm Research"))
-    subtitle = esc(report.get("subtitle", ""))
-    return f'''<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<title>{title}</title><style>{deck_css}</style></head><body>
-<nav><strong>{title}</strong><span id="counter"></span><button id="prev" aria-label="上一页">←</button><button id="next" aria-label="下一页">→</button><button onclick="window.print()">保存 PDF</button></nav>
-<main>
-<section class="slide active" id="cover"><p class="eyebrow">ALGORITHM RESEARCH · {esc(cutoff)}</p><h1>{title}</h1><p class="subtitle">{subtitle}</p><p>{esc(evidence_note)}</p><p>使用方向键翻页，滚动和打印模式同样可用。</p></section>
-<section class="slide" id="summary"><p class="eyebrow">01</p><h2>核心结论</h2><ol>{summary_html}</ol></section>
-<section class="slide" id="lineage" data-lineage="{timeline_data}"><p class="eyebrow">02</p><h2>技术路线</h2><div class="timeline">{timeline}</div><article id="milestone-detail" aria-live="polite"></article></section>
-{section_html}
-<section class="slide" id="comparison"><h2>方法对比</h2><div class="table-wrap"><table><thead><tr><th>方法</th><th>机制</th><th>优势</th><th>局限</th><th>工程考虑</th></tr></thead><tbody>{rows}</tbody></table></div></section>
-<section class="slide" id="questions"><h2>开放问题</h2><ul>{open_questions}</ul></section>
-<section class="slide references" id="references"><h2>论文与研究截止日期</h2><p>{esc(evidence_note)}</p><p>研究截止：{esc(cutoff)}。预印本结论可能随修订发生变化。</p><ol>{refs}</ol></section>
-</main><div class="progress"><span id="progress-bar"></span></div><script>{deck_js}</script></body></html>'''
-
-
 def field_label(key: Any) -> str:
     labels = {
         "points": "要点", "details": "详细说明", "claim": "结论", "claims": "结论",
@@ -873,11 +856,10 @@ def render_section_content(section: dict[str, Any]) -> str:
                 f'{render_value(content.get("symbols"))}')
     wrapper = "aside" if layout == "evidence-gap" else "div"
     return f'<{wrapper} class="{esc(layout)}">' + "".join(
-        f'<h3>{esc(k.replace("_", " ").title())}</h3>{render_value(v)}' for k, v in content.items()
+        f'<h3>{esc(field_label(k))}</h3>{render_value(v)}' for k, v in content.items()
     ) + f"</{wrapper}>"
 
 
-# This later definition intentionally replaces the legacy fixed-layout renderer above.
 def render_presentation(report: dict[str, Any], papers: list[dict[str, Any]], cutoff: str) -> str:
     deck_css = "\n".join(
         (STATIC_DIR / name).read_text(encoding="utf-8")
@@ -887,25 +869,40 @@ def render_presentation(report: dict[str, Any], papers: list[dict[str, Any]], cu
     citations = {p["id"]: p for p in papers}
     evidence_mode = (report.get("english_understanding") or {}).get("evidence_mode", "")
     evidence_note = "未联网核验：内容基于模型已有知识，最新进展未经外部验证。" if evidence_mode else "已联网检索，并基于当前可用论文证据生成。"
-    summary_html = "".join(f"<li>{esc(x)}</li>" for x in report.get("executive_summary", []))
+    evidence_label = "模型知识 · 未联网核验" if evidence_mode else f"论文证据 · {len(report.get('references', []))} 篇引用"
+    summary_html = "".join(
+        f'<article class="summary-card"><span>{i:02d}</span><p>{esc(item)}</p></article>'
+        for i, item in enumerate(report.get("executive_summary", []), 1)
+    )
+    agenda_items = "".join(
+        f'<a href="#section-{i + 1}" data-slide-target="section-{i + 1}"><span>{i + 1:02d}</span>'
+        f'<strong>{esc(section.get("title"))}</strong><small>{esc(section.get("layout"))}</small></a>'
+        for i, section in enumerate(report.get("sections", []))
+    )
     section_html = "".join(
-        f'<section class="slide" id="section-{i + 1}"><p class="eyebrow">{i + 2:02d} · {esc(x.get("layout"))}</p>'
-        f'<h2>{esc(x.get("title"))}</h2><p class="takeaway">{esc(x.get("takeaway"))}</p>{render_section_content(x)}'
-        f'<p class="sources">来源：{", ".join(esc(pid) for pid in x.get("source_ids", [])) or "未引用外部论文"}</p></section>'
+        f'<section class="slide content-slide" id="section-{i + 1}" data-title="{esc(x.get("title"))}">'
+        f'<header class="slide-header"><p class="eyebrow">{i + 3:02d} / {esc(x.get("layout"))}</p><h2>{esc(x.get("title"))}</h2>'
+        f'<p class="takeaway">{esc(x.get("takeaway"))}</p></header><div class="slide-content">{render_section_content(x)}</div>'
+        f'<footer class="slide-footer"><div class="source-chips">'
+        f'{"".join(f"<a href=\"#ref-{esc(pid)}\" title=\"查看参考文献\">{esc(pid)}</a>" for pid in x.get("source_ids", [])) or "<span>本页未绑定外部论文</span>"}'
+        f'</div><span>{i + 3:02d}</span></footer></section>'
         for i, x in enumerate(report.get("sections", []))
     )
     refs = "".join(
-        f'<li><a href="{esc(citations[pid].get("url"))}" target="_blank" rel="noopener noreferrer">{esc(citations[pid].get("title"))}</a>'
-        f'<br><span>{esc(", ".join(citations[pid].get("authors", [])[:6]))} · {esc((citations[pid].get("published") or "")[:10])} · {esc(pid)}</span></li>'
-        for pid in report.get("references", []) if pid in citations
+        f'<li id="ref-{esc(pid)}"><span class="ref-index">{i:02d}</span><div><a href="{esc(citations[pid].get("url"))}" target="_blank" rel="noopener noreferrer">{esc(citations[pid].get("title"))}</a>'
+        f'<br><span>{esc(", ".join(citations[pid].get("authors", [])[:6]))} · {esc((citations[pid].get("published") or "")[:10])} · {esc(pid)}</span></div></li>'
+        for i, pid in enumerate((pid for pid in report.get("references", []) if pid in citations), 1)
     )
     limitations = "".join(f"<li>{esc(x)}</li>" for x in report.get("limitations", []))
     title, subtitle = esc(report.get("title", "Algorithm Research")), esc(report.get("subtitle", ""))
     return f'''<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<title>{title}</title><style>{deck_css}</style></head><body><nav><strong>{title}</strong><span id="counter"></span><button id="prev" aria-label="上一页">←</button><button id="next" aria-label="下一页">→</button><button onclick="window.print()">保存 PDF</button></nav>
-<main><section class="slide active" id="cover"><p class="eyebrow">{esc(report.get("research_type"))} · {esc(cutoff)}</p><h1>{title}</h1><p class="subtitle">{subtitle}</p><p>{esc(evidence_note)}</p></section>
-<section class="slide" id="summary"><p class="eyebrow">01</p><h2>核心结论</h2><ol>{summary_html}</ol></section>{section_html}
-<section class="slide references" id="references"><h2>参考文献与局限</h2><p>{esc(evidence_note)}</p><ol>{refs}</ol><ul>{limitations}</ul></section></main>
+<title>{title}</title><style>{deck_css}</style></head><body>
+<nav class="deck-nav"><button id="menu" aria-label="打开目录" aria-expanded="false">☰</button><strong>{title}</strong><span id="counter"></span><button id="prev" aria-label="上一页">←</button><button id="next" aria-label="下一页">→</button><button onclick="window.print()" title="打印或保存为 PDF"><span class="print-label">保存 PDF</span> ⇩</button></nav>
+<aside id="overview" class="overview" aria-hidden="true"><header><strong>演示目录</strong><button id="close-overview" aria-label="关闭目录">×</button></header><a data-slide-target="cover">封面</a><a data-slide-target="summary">核心结论</a><a data-slide-target="agenda">研究结构</a>{agenda_items}<a data-slide-target="references">参考文献与局限</a></aside><div id="scrim" class="scrim"></div>
+<main><section class="slide cover active" id="cover" data-title="封面"><div class="cover-orb"></div><p class="eyebrow">ALGORITHM RESEARCH / {esc(cutoff)}</p><h1>{title}</h1><p class="subtitle">{subtitle}</p><div class="cover-meta"><span>{esc(report.get("research_type"))}</span><span>{esc(evidence_label)}</span></div><p class="evidence-note">{esc(evidence_note)}</p><p class="hint">方向键翻页 · 点击左上角查看目录 · 可打印保存</p></section>
+<section class="slide" id="summary" data-title="核心结论"><p class="eyebrow">01 / EXECUTIVE SUMMARY</p><h2>先看结论</h2><div class="summary-grid">{summary_html}</div></section>
+<section class="slide" id="agenda" data-title="研究结构"><p class="eyebrow">02 / RESEARCH MAP</p><h2>这份调研如何展开</h2><div class="agenda-grid">{agenda_items}</div></section>{section_html}
+<section class="slide references" id="references" data-title="参考文献与局限"><p class="eyebrow">SOURCES / {esc(cutoff)}</p><h2>参考文献与边界</h2><p class="evidence-note">{esc(evidence_note)}</p><ol>{refs or '<li class="empty-state">本报告未绑定外部论文来源。</li>'}</ol><ul class="limitations">{limitations}</ul></section></main>
 <div class="progress"><span id="progress-bar"></span></div><script>{deck_js}</script></body></html>'''
 
 
@@ -919,7 +916,7 @@ def create_bundle(job_dir: Path, html_path: Path, report_path: Path) -> Path:
 
 def preview_frame(content: str) -> str:
     source = html.escape(content, quote=True)
-    return f'<iframe title="Interactive research presentation" srcdoc="{source}" style="width:100%;height:76vh;border:1px solid #30394a;border-radius:10px;background:#080b12" sandbox="allow-scripts allow-popups"></iframe>'
+    return f'<iframe title="Interactive research presentation" srcdoc="{source}" style="width:100%;height:80vh;border:0;border-radius:14px;background:#071018;box-shadow:0 14px 40px #12283c2b" sandbox="allow-scripts allow-popups"></iframe>'
 
 
 def run_research_ui(
@@ -955,22 +952,25 @@ def run_research_ui(
         progress(0.16, desc="正在联网检索 arXiv 和 OpenAlex")
         user_papers = normalize_user_papers(request.paper_urls)
         discovered_papers, search_warnings = search_literature(queries, budget["discover"])
-        if not discovered_papers and not user_papers:
-            raise gr.Error("arXiv 和 OpenAlex 均未返回论文。请稍后重试，或填写至少一个 arXiv 论文链接。")
         papers = deduplicate(user_papers + discovered_papers)
         screen = papers[: budget["screen"]]
-        progress(0.28, desc="DeepSeek-V4-Flash 正在筛选关键论文")
-        selected_ids = select_papers(request, screen, budget["screen"], budget["deep"])
-        if not selected_ids:
-            selected_ids = [p["id"] for p in screen[: budget["deep"]]]
-        progress(0.48, desc="正在读取关键论文")
-        for index, paper in enumerate(screen):
-            if paper["id"] in selected_ids:
-                try:
-                    deep_texts[paper["id"]] = extract_pdf(paper)
-                except Exception as exc:
-                    deep_texts[paper["id"]] = f"PDF extraction failed: {exc}"
-            progress(0.48 + 0.16 * (index + 1) / len(screen), desc="正在提取论文证据")
+        if screen:
+            progress(0.28, desc="DeepSeek-V4-Flash 正在筛选关键论文")
+            selected_ids = select_papers(request, screen, budget["screen"], budget["deep"])
+            if not selected_ids:
+                selected_ids = [p["id"] for p in screen[: budget["deep"]]]
+            progress(0.48, desc="正在读取关键论文")
+            for index, paper in enumerate(screen):
+                if paper["id"] in selected_ids:
+                    try:
+                        deep_texts[paper["id"]] = extract_pdf(paper)
+                    except Exception as exc:
+                        deep_texts[paper["id"]] = f"PDF extraction failed: {exc}"
+                progress(0.48 + 0.16 * (index + 1) / len(screen), desc="正在提取论文证据")
+        else:
+            search_warnings.append("学术搜索未返回可用论文，已降级为模型知识模式")
+            english_understanding["evidence_mode"] = "Academic search returned no usable papers; model knowledge only."
+            progress(0.48, desc="检索无结果，已降级为模型知识模式")
     else:
         papers = []
         screen = []
@@ -1004,7 +1004,8 @@ def run_research_ui(
 
 
 CSS = """
-.gradio-container{max-width:none!important}.preview-column{min-width:0}.input-column{max-width:430px}
+.gradio-container{max-width:none!important;background:linear-gradient(145deg,#f7f9fc,#eef3f8)!important}.app-hero{margin:4px 4px 18px;padding:18px 22px;border:1px solid #dce5ef;border-radius:16px;background:linear-gradient(120deg,#0c1d2d,#153651);color:#fff;box-shadow:0 12px 35px #16334d1a}.app-hero h1{margin:0 0 5px;font-size:25px}.app-hero p{margin:0;color:#bcd0e3}.app-hero span{display:inline-block;margin-top:10px;padding:4px 8px;border:1px solid #ffffff2b;border-radius:999px;color:#82ead8;font-size:11px}
+.preview-column{min-width:0}.input-column{max-width:430px;padding:14px!important;border:1px solid #dce5ef;border-radius:14px;background:#ffffffb8;box-shadow:0 10px 30px #1a38500d}
 .preview-toolbar{align-items:center!important;justify-content:flex-end!important;gap:6px!important;min-height:38px}
 .preview-title{margin-right:auto!important;min-width:180px}.download-chip{flex:0 0 auto!important;min-width:42px!important;max-width:52px!important;position:relative}
 .download-chip button,.download-chip a{min-width:42px!important;padding:5px 8px!important;font-size:12px!important}
@@ -1013,7 +1014,7 @@ CSS = """
 """
 
 with gr.Blocks(title="Algorithm Research Deck") as demo:
-    gr.Markdown("# Algorithm Research Deck\n从经典方法到最新论文，生成可保存的交互式 HTML 技术演示。")
+    gr.HTML("""<div class="app-hero"><h1>Algorithm Research Deck</h1><p>从问题定义、论文证据到技术判断，生成可保存的交互式研究演示。</p><span>DeepSeek-V4-Flash · arXiv · OpenAlex</span></div>""")
     with gr.Row():
         with gr.Column(scale=1, elem_classes="input-column"):
             topic = gr.Textbox(label="调研主题", placeholder="例如：Diffusion Transformer")
@@ -1034,7 +1035,7 @@ with gr.Blocks(title="Algorithm Research Deck") as demo:
                 html_file = gr.DownloadButton("HTML", size="sm", elem_classes=["download-chip", "download-html"])
                 json_file = gr.DownloadButton("JSON", size="sm", elem_classes=["download-chip", "download-json"])
                 zip_file = gr.DownloadButton("ZIP", size="sm", elem_classes=["download-chip", "download-zip"])
-            preview = gr.HTML("<div style='height:76vh;display:grid;place-items:center;color:#758099'>交互演示将在这里生成</div>")
+            preview = gr.HTML("<div style='height:80vh;display:grid;place-items:center;border-radius:14px;background:#071018;color:#758099'>交互演示将在这里生成</div>")
 
     submit.click(
         run_research_ui,

static/deck.css

@@ -1 +1,186 @@
-:root{font-family:Inter,"Microsoft YaHei",sans-serif;color:#eef3fb;background:#080b12;color-scheme:dark;--accent:#7aa2ff;--muted:#9aa8bd}*{box-sizing:border-box}body{margin:0;background:radial-gradient(circle at 80% 10%,#17213d 0,#080b12 35%);color:#eef3fb}nav{position:fixed;z-index:10;left:0;right:0;top:0;height:56px;display:flex;align-items:center;gap:10px;padding:0 3vw;background:rgba(8,11,18,.9);backdrop-filter:blur(12px);border-bottom:1px solid #273143}nav strong{margin-right:auto;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}nav button{border:1px solid #344158;background:#131c2b;color:#eef3fb;border-radius:7px;padding:7px 10px;cursor:pointer}.slide{display:none;min-height:100vh;padding:11vh 8vw 9vh;align-content:center;max-width:1400px;margin:auto}.slide.active{display:grid}.eyebrow{letter-spacing:.14em;color:var(--accent);font-size:12px}h1{font-size:clamp(42px,7vw,94px);max-width:1050px;line-height:1.02;margin:.25em 0}h2{font-size:clamp(30px,4vw,58px);margin:.2em 0 .6em}.subtitle,.takeaway{font-size:clamp(20px,2.4vw,34px);color:#c8d3e7;max-width:1000px}li,p,td,th{font-size:clamp(16px,1.25vw,21px);line-height:1.55}li{margin:.45em 0}.timeline{display:flex;gap:10px;overflow-x:auto;padding:12px 0}.milestone{min-width:150px;text-align:left;padding:13px;border:1px solid #344158;border-radius:9px;background:#101827;color:#eaf0fb;cursor:pointer}.milestone span{display:block;color:var(--accent);font-size:12px}.milestone[aria-pressed="true"]{border-color:var(--accent);background:#182643}#milestone-detail{margin-top:18px;padding-top:16px;border-top:1px solid #344158}.table-wrap{overflow:auto}table{width:100%;border-collapse:collapse}th,td{text-align:left;vertical-align:top;border-bottom:1px solid #344158;padding:12px}details{margin-top:20px;border-top:1px solid #344158;padding-top:14px}summary{cursor:pointer;color:var(--accent)}.sources,.references span{font-size:13px;color:var(--muted)}.references li{font-size:14px}.references a{color:#a9c3ff}.progress{position:fixed;bottom:0;left:0;right:0;height:4px;background:#1b2434}.progress span{display:block;height:100%;background:var(--accent);transition:width .25s}@media(max-width:700px){nav strong{display:none}.slide{display:block;min-height:auto;padding:90px 22px 50px;border-bottom:1px solid #273143}.slide.active{display:block}.progress{display:none}}@media print{nav,.progress{display:none}.slide{display:block;min-height:auto;break-after:page;padding:10mm;background:#fff;color:#111}.references{break-after:auto}body{background:#fff;color:#111}.subtitle,.takeaway,.sources,.references span{color:#333}a{color:#111}}
+@import url('https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700&family=Noto+Sans+SC:wght@400;500;600;700&display=swap');
+
+:root {
+  font-family: Manrope, "Noto Sans SC", "Microsoft YaHei", sans-serif;
+  color: #edf3ff;
+  background: #071018;
+  color-scheme: dark;
+  --bg: #071018;
+  --panel: #0d1925;
+  --panel-2: #122235;
+  --line: rgba(151, 177, 207, .18);
+  --accent: #5eead4;
+  --accent-2: #7aa2ff;
+  --text: #edf3ff;
+  --muted: #97aabd;
+  --warm: #f4bc67;
+}
+* { box-sizing: border-box; }
+html { scroll-behavior: smooth; }
+body {
+  margin: 0;
+  overflow: hidden;
+  background:
+    radial-gradient(circle at 78% 12%, rgba(45, 92, 145, .28), transparent 32%),
+    radial-gradient(circle at 18% 88%, rgba(38, 127, 118, .16), transparent 28%),
+    var(--bg);
+  color: var(--text);
+}
+button, a { font: inherit; }
+.deck-nav {
+  position: fixed;
+  z-index: 30;
+  inset: 0 0 auto;
+  height: 58px;
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  padding: 0 24px;
+  border-bottom: 1px solid var(--line);
+  background: rgba(7, 16, 24, .78);
+  backdrop-filter: blur(18px);
+}
+.deck-nav strong {
+  margin-right: auto;
+  max-width: min(56vw, 760px);
+  overflow: hidden;
+  color: #dce9f8;
+  font-size: 13px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.deck-nav button {
+  display: grid;
+  place-items: center;
+  min-width: 34px;
+  height: 34px;
+  padding: 0 9px;
+  border: 1px solid var(--line);
+  border-radius: 9px;
+  background: rgba(18, 34, 53, .76);
+  color: var(--text);
+  cursor: pointer;
+  transition: border-color .18s ease, transform .18s ease, background .18s ease;
+}
+.deck-nav button:hover { transform: translateY(-1px); border-color: var(--accent); background: #172b40; }
+#counter { min-width: 54px; color: var(--muted); font-size: 12px; text-align: center; }
+.overview {
+  position: fixed;
+  z-index: 50;
+  inset: 0 auto 0 0;
+  width: min(390px, 88vw);
+  padding: 18px;
+  overflow-y: auto;
+  border-right: 1px solid var(--line);
+  background: rgba(8, 18, 28, .98);
+  box-shadow: 20px 0 60px rgba(0, 0, 0, .35);
+  transform: translateX(-105%);
+  transition: transform .24s ease;
+}
+.overview.open { transform: translateX(0); }
+.overview header { display: flex; align-items: center; margin-bottom: 14px; }
+.overview header strong { margin-right: auto; }
+.overview button { border: 0; background: transparent; color: var(--muted); font-size: 26px; cursor: pointer; }
+.overview > a {
+  display: grid;
+  grid-template-columns: 34px 1fr auto;
+  gap: 8px;
+  align-items: center;
+  margin: 5px 0;
+  padding: 11px;
+  border: 1px solid transparent;
+  border-radius: 9px;
+  color: #c8d6e6;
+  text-decoration: none;
+  cursor: pointer;
+}
+.overview > a:hover, .overview > a.current { border-color: var(--line); background: var(--panel-2); color: #fff; }
+.overview small { color: var(--muted); }
+.scrim { position: fixed; z-index: 40; inset: 0; display: none; background: rgba(0, 0, 0, .48); }
+.scrim.open { display: block; }
+main { height: 100vh; }
+.slide {
+  display: none;
+  width: min(1500px, 100%);
+  height: 100vh;
+  margin: auto;
+  padding: clamp(84px, 10vh, 112px) clamp(34px, 7vw, 112px) clamp(48px, 7vh, 78px);
+  overflow: auto;
+  align-content: center;
+  animation: slide-in .24s ease-out;
+}
+.slide.active { display: grid; }
+@keyframes slide-in { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: none; } }
+.eyebrow { margin: 0 0 12px; color: var(--accent); font-size: 11px; font-weight: 700; letter-spacing: .16em; text-transform: uppercase; }
+h1 { max-width: 1120px; margin: .18em 0; font-size: clamp(44px, 6.5vw, 96px); line-height: 1.02; letter-spacing: -.045em; }
+h2 { margin: .15em 0 .42em; font-size: clamp(31px, 4vw, 58px); line-height: 1.08; letter-spacing: -.035em; }
+h3 { margin: .3em 0; }
+p, li, td, th { font-size: clamp(15px, 1.12vw, 19px); line-height: 1.55; }
+.subtitle { max-width: 920px; margin: 16px 0 28px; color: #bbcadb; font-size: clamp(19px, 2.1vw, 31px); line-height: 1.35; }
+.takeaway { max-width: 1120px; margin: 0; padding-left: 16px; border-left: 3px solid var(--accent); color: #cfdaea; font-size: clamp(17px, 1.65vw, 24px); line-height: 1.42; }
+.cover { position: relative; align-content: center; overflow: hidden; }
+.cover-orb { position: absolute; z-index: -1; top: 12%; right: 4%; width: min(42vw, 580px); aspect-ratio: 1; border: 1px solid rgba(94, 234, 212, .24); border-radius: 50%; box-shadow: inset 0 0 90px rgba(65, 126, 180, .18), 0 0 100px rgba(94, 234, 212, .08); }
+.cover-orb::before, .cover-orb::after { content: ""; position: absolute; inset: 13%; border: 1px solid rgba(122, 162, 255, .18); border-radius: 50%; }
+.cover-orb::after { inset: 30%; background: rgba(94, 234, 212, .05); }
+.cover-meta { display: flex; flex-wrap: wrap; gap: 8px; }
+.cover-meta span, .source-chips a, .source-chips span { padding: 6px 10px; border: 1px solid var(--line); border-radius: 999px; background: rgba(18, 34, 53, .68); color: #b9cde1; font-size: 12px; }
+.evidence-note { max-width: 900px; color: var(--muted); font-size: 13px; }
+.hint { position: absolute; bottom: 34px; color: #63778b; font-size: 11px; }
+.summary-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 13px; max-width: 1180px; }
+.summary-card { display: grid; grid-template-columns: 38px 1fr; gap: 12px; align-items: start; padding: 17px; border: 1px solid var(--line); border-radius: 13px; background: linear-gradient(145deg, rgba(18, 34, 53, .88), rgba(11, 25, 37, .9)); }
+.summary-card span, .agenda-grid > a span { color: var(--accent); font-size: 11px; font-weight: 700; }
+.summary-card p { margin: 0; }
+.agenda-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; max-width: 1120px; }
+.agenda-grid > a { display: grid; grid-template-columns: 38px 1fr auto; gap: 10px; align-items: center; padding: 14px 16px; border: 1px solid var(--line); border-radius: 11px; background: var(--panel); color: var(--text); text-decoration: none; cursor: pointer; transition: transform .18s ease, border-color .18s ease; }
+.agenda-grid > a:hover { transform: translateY(-2px); border-color: var(--accent); }
+.agenda-grid small { color: var(--muted); font-size: 11px; }
+.content-slide { grid-template-rows: auto 1fr auto; align-content: stretch; gap: 22px; }
+.slide-header { align-self: end; }
+.slide-content { min-height: 0; overflow: auto; padding-right: 4px; }
+.slide-footer { display: flex; align-items: center; gap: 12px; padding-top: 10px; border-top: 1px solid var(--line); color: var(--muted); font-size: 11px; }
+.slide-footer > span { margin-left: auto; }
+.source-chips { display: flex; flex-wrap: wrap; gap: 5px; }
+.source-chips a { color: #acd0ff; text-decoration: none; }
+.source-chips a:hover { border-color: var(--accent); }
+.timeline { display: grid; grid-auto-flow: column; grid-auto-columns: minmax(240px, 1fr); gap: 12px; overflow-x: auto; padding: 10px 2px 18px; }
+.milestone { min-width: 0; padding: 15px; border: 1px solid var(--line); border-top: 3px solid var(--accent-2); border-radius: 11px; background: var(--panel); color: var(--text); }
+.milestone span { display: block; margin-bottom: 7px; color: var(--accent); font-size: 11px; }
+.milestone h3 { font-size: 17px; }
+.table-wrap { overflow: auto; border: 1px solid var(--line); border-radius: 12px; }
+table { width: 100%; border-collapse: collapse; background: rgba(10, 23, 35, .7); }
+th, td { padding: 12px 14px; border-bottom: 1px solid var(--line); text-align: left; vertical-align: top; }
+thead th { position: sticky; top: 0; z-index: 2; background: #14283b; color: #dcecff; }
+tbody th { color: var(--accent); }
+.references { align-content: start; }
+.references ol { display: grid; gap: 8px; padding: 0; list-style: none; }
+.references li { display: grid; grid-template-columns: 36px 1fr; gap: 10px; padding: 12px; border-bottom: 1px solid var(--line); }
+.references a { color: #b7d2ff; font-weight: 600; text-decoration: none; }
+.references a:hover { text-decoration: underline; }
+.references li span { color: var(--muted); font-size: 12px; }
+.ref-index { color: var(--accent) !important; font-weight: 700; }
+.limitations { margin-top: 18px; padding: 14px 14px 14px 34px; border-left: 3px solid var(--warm); background: rgba(91, 61, 21, .16); }
+.empty-state { color: var(--muted); }
+.progress { position: fixed; z-index: 31; inset: auto 0 0; height: 3px; background: rgba(255, 255, 255, .06); }
+.progress span { display: block; height: 100%; background: linear-gradient(90deg, var(--accent-2), var(--accent)); transition: width .25s; }
+@media (max-width: 760px) {
+  body { overflow: auto; }
+  .deck-nav strong { display: none; }
+  .slide, .slide.active { display: block; height: auto; min-height: 100vh; padding: 84px 20px 48px; overflow: visible; border-bottom: 1px solid var(--line); }
+  .summary-grid, .agenda-grid { grid-template-columns: 1fr; }
+  .content-slide { min-height: auto; }
+  .slide-content { overflow: visible; }
+  .slide-footer { margin-top: 20px; }
+  .hint { position: static; margin-top: 38px; }
+  .progress { display: none; }
+}
+@media print {
+  @page { size: landscape; margin: 0; }
+  body { overflow: visible; background: #fff; color: #111; }
+  .deck-nav, .overview, .scrim, .progress, .hint { display: none !important; }
+  .slide, .slide.active { display: grid; width: 100%; height: 100vh; min-height: 0; padding: 12mm 16mm; overflow: hidden; break-after: page; background: #fff; color: #111; animation: none; }
+  .slide:last-child { break-after: auto; }
+  .takeaway { color: #263748; }
+  .slide-content { overflow: hidden; }
+  .summary-card, .agenda-grid > a, .milestone, .content-card, .content-item, .content-field, .flow-node, .flow-lane { background: #f6f8fb !important; color: #111 !important; border-color: #cfd7e1 !important; }
+  a { color: #111 !important; }
+}

static/deck.js

@@ -1,8 +1,81 @@
-const slides=[...document.querySelectorAll('.slide')];let current=0;
-const counter=document.getElementById('counter');const bar=document.getElementById('progress-bar');
-function show(index,push=true){current=Math.max(0,Math.min(slides.length-1,index));slides.forEach((s,i)=>s.classList.toggle('active',i===current));counter.textContent=`${current+1} / ${slides.length}`;bar.style.width=`${(current+1)/slides.length*100}%`;if(push)history.replaceState(null,'',`#${slides[current].id}`);slides[current].scrollIntoView({block:'start'});}
-document.getElementById('prev').onclick=()=>show(current-1);document.getElementById('next').onclick=()=>show(current+1);
-document.addEventListener('keydown',e=>{if(['ArrowRight','PageDown'].includes(e.key))show(current+1);if(['ArrowLeft','PageUp'].includes(e.key))show(current-1);if(e.key==='Home')show(0);if(e.key==='End')show(slides.length-1);});
-const initial=slides.findIndex(s=>`#${s.id}`===location.hash);show(initial>=0?initial:0,false);
-const lineage=document.getElementById('lineage');if(lineage){const data=JSON.parse(lineage.dataset.lineage||'[]');const detail=document.getElementById('milestone-detail');function pick(i){const x=data[i]||{};detail.innerHTML=`<h3>${escapeText(x.method||'')}</h3><p><strong>突破：</strong>${escapeText(x.innovation||'')}</p><p><strong>解决的瓶颈：</strong>${escapeText(x.bottleneck||'')}</p><p><strong>遗留限制：</strong>${escapeText(x.limitation||'')}</p>`;document.querySelectorAll('.milestone').forEach((b,j)=>b.setAttribute('aria-pressed',String(i===j)));}document.querySelectorAll('.milestone').forEach((b,i)=>b.onclick=()=>pick(i));if(data.length)pick(0);}
-function escapeText(value){const d=document.createElement('div');d.textContent=value;return d.innerHTML;}
+const slides = [...document.querySelectorAll('.slide')];
+const counter = document.getElementById('counter');
+const bar = document.getElementById('progress-bar');
+const overview = document.getElementById('overview');
+const scrim = document.getElementById('scrim');
+const menu = document.getElementById('menu');
+let current = 0;
+
+function closeOverview() {
+  overview.classList.remove('open');
+  scrim.classList.remove('open');
+  overview.setAttribute('aria-hidden', 'true');
+  menu.setAttribute('aria-expanded', 'false');
+}
+
+function openOverview() {
+  overview.classList.add('open');
+  scrim.classList.add('open');
+  overview.setAttribute('aria-hidden', 'false');
+  menu.setAttribute('aria-expanded', 'true');
+}
+
+function show(index, push = true) {
+  current = Math.max(0, Math.min(slides.length - 1, index));
+  slides.forEach((slide, i) => slide.classList.toggle('active', i === current));
+  counter.textContent = `${current + 1} / ${slides.length}`;
+  bar.style.width = `${(current + 1) / slides.length * 100}%`;
+  document.querySelectorAll('[data-slide-target]').forEach(link => {
+    link.classList.toggle('current', link.dataset.slideTarget === slides[current].id);
+  });
+  document.title = `${slides[current].dataset.title || ''} · ${document.querySelector('.deck-nav strong').textContent}`;
+  if (push) history.replaceState(null, '', `#${slides[current].id}`);
+  slides[current].scrollTo({ top: 0, behavior: 'instant' });
+  closeOverview();
+}
+
+function showById(id) {
+  const index = slides.findIndex(slide => slide.id === id);
+  if (index >= 0) show(index);
+}
+
+document.getElementById('prev').addEventListener('click', () => show(current - 1));
+document.getElementById('next').addEventListener('click', () => show(current + 1));
+menu.addEventListener('click', () => overview.classList.contains('open') ? closeOverview() : openOverview());
+document.getElementById('close-overview').addEventListener('click', closeOverview);
+scrim.addEventListener('click', closeOverview);
+
+document.querySelectorAll('[data-slide-target]').forEach(link => {
+  link.addEventListener('click', event => {
+    event.preventDefault();
+    showById(link.dataset.slideTarget);
+  });
+});
+
+document.querySelectorAll('.source-chips a').forEach(link => {
+  link.addEventListener('click', event => {
+    event.preventDefault();
+    const target = document.querySelector(link.getAttribute('href'));
+    showById('references');
+    if (target) requestAnimationFrame(() => target.scrollIntoView({ block: 'center' }));
+  });
+});
+
+document.addEventListener('keydown', event => {
+  if (event.key === 'Escape') return closeOverview();
+  if (['ArrowRight', 'PageDown', ' '].includes(event.key)) show(current + 1);
+  if (['ArrowLeft', 'PageUp'].includes(event.key)) show(current - 1);
+  if (event.key === 'Home') show(0);
+  if (event.key === 'End') show(slides.length - 1);
+});
+
+let touchStartX = 0;
+document.addEventListener('touchstart', event => { touchStartX = event.changedTouches[0].screenX; }, { passive: true });
+document.addEventListener('touchend', event => {
+  const distance = event.changedTouches[0].screenX - touchStartX;
+  if (Math.abs(distance) > 70) show(current + (distance < 0 ? 1 : -1));
+}, { passive: true });
+
+const hashId = location.hash.slice(1);
+const initial = slides.findIndex(slide => slide.id === hashId);
+show(initial >= 0 ? initial : 0, false);

tests/test_app.py

@@ -3,7 +3,7 @@ from unittest.mock import patch
 
 from pydantic import ValidationError
 
-from app import ResearchReport, chat_json, deduplicate, infer_section_source_ids, normalize_comparison, normalize_process, parse_json_object, prepare_evidence_inputs, render_presentation, render_section_content, render_value, safe_slug
+from app import ResearchReport, chat_json, deduplicate, infer_section_source_ids, normalize_comparison, normalize_process, parse_json_object, prepare_evidence_inputs, render_presentation, render_section_content, render_value, safe_slug, search_literature
 
 
 def base_report(section):
@@ -31,6 +31,24 @@ class AppTests(unittest.TestCase):
         self.assertEqual([item["id"] for item in result[:2]], ["8", "9"])
         self.assertIn("selected_text_extract", result[0])
 
+    @patch("app.openalex_search", return_value=[])
+    @patch("app.arxiv_search")
+    def test_search_balances_multiple_query_intents(self, mocked_arxiv, _mocked_openalex):
+        mocked_arxiv.side_effect = [
+            [{"id": f"classic-{i}", "title": f"Classic {i}"} for i in range(5)],
+            [{"id": f"recent-{i}", "title": f"Recent {i}"} for i in range(5)],
+        ]
+        papers, warnings = search_literature(["classic", "recent"], 4)
+        self.assertEqual([paper["id"] for paper in papers], ["classic-0", "recent-0", "classic-1", "recent-1"])
+        self.assertEqual(warnings, [])
+
+    @patch("app.openalex_search", return_value=[{"id": "oa-1", "title": "Fallback"}])
+    @patch("app.arxiv_search", return_value=[])
+    def test_search_uses_openalex_when_arxiv_returns_empty(self, _mocked_arxiv, mocked_openalex):
+        papers, _ = search_literature(["topic"], 5)
+        self.assertEqual(papers[0]["id"], "oa-1")
+        mocked_openalex.assert_called_once()
+
     def test_parser_removes_invalid_string_line_continuation(self):
         self.assertEqual(parse_json_object('{"title":"A\\\nB","value":1}'), {"title": "AB", "value": 1})
 
@@ -45,6 +63,18 @@ class AppTests(unittest.TestCase):
         output = render_presentation(base_report(section), [], "2026-01-01")
         self.assertIn("<!doctype html>", output)
         self.assertIn("保存 PDF", output)
+        self.assertIn('id="overview"', output)
+        self.assertIn('id="agenda"', output)
+        self.assertIn('data-slide-target="section-1"', output)
+
+    def test_source_chip_links_to_rendered_reference(self):
+        section = {"title": "Evidence", "purpose": "Connect a claim to retrieved evidence.", "takeaway": "The cited result supports this bounded conclusion.", "layout": "evidence", "content": {"claim": "A supported claim", "conditions": ["A stated condition"]}, "source_ids": ["paper-1"]}
+        report = base_report(section)
+        report["references"] = ["paper-1"]
+        paper = {"id": "paper-1", "title": "A Retrieved Paper", "authors": ["A. Author"], "published": "2025-01-01", "url": "https://example.com/paper"}
+        output = render_presentation(report, [paper], "2026-01-01")
+        self.assertIn('href="#ref-paper-1"', output)
+        self.assertIn('id="ref-paper-1"', output)
 
     def test_empty_report_is_rejected(self):
         with self.assertRaises(ValidationError):