Function generate_reading_report

agents/reading-agent/main.py:4357–4597

(
    paper: Dict[str, Any],
    user_profile: Dict[str, Any],
    report_payload: Optional[Dict[str, Any]] = None,
    response_language: str = "zh",
)

def generate_reading_report(
    paper: Dict[str, Any],
    user_profile: Dict[str, Any],
    report_payload: Optional[Dict[str, Any]] = None,
    response_language: str = "zh",
) -> str:
    payload = report_payload or build_heuristic_report_payload(
        paper,
        user_profile,
        response_language=response_language,
    )
    language = _normalize_response_language(payload.get("response_language") or response_language)
    is_en = language == "en"
    labels = {
        "untitled": "Untitled Paper" if is_en else "Untitled Paper",
        "source_no_abstract_link": "The source did not return a usable abstract. View the original paper here:" if is_en else "源站暂未返回可用摘要。请直接查看原文链接：",
        "source_no_abstract": "The source did not return a usable abstract. Check the original PDF or paper page directly." if is_en else "源站暂未返回可用摘要，建议直接查看原文 PDF 或论文主页。",
        "analysis_pdf": "PDF full text" if is_en else "PDF 全文",
        "analysis_source_page": "source page + metadata" if is_en else "源站正文 + 元数据",
        "analysis_metadata": "abstract + metadata" if is_en else "摘要 + 元数据",
        "model": "model" if is_en else "模型",
        "keywords": "Keywords" if is_en else "关键词",
        "one_sentence": "One-Sentence Summary" if is_en else "一句话总结",
        "one_sentence_empty": "There is not enough information to generate a one-sentence summary yet." if is_en else "当前没有足够信息生成一句话总结。",
        "abstract": "Abstract" if is_en else "摘要",
        "problem_empty": "Start from the abstract and introduction to verify the research problem." if is_en else "建议先回到原文摘要和引言确认研究问题。",
        "related_empty": "The automatic parser did not extract a stable Related Work thread. Check the introduction, related-work section, and citations to identify the main compared methods." if is_en else "当前自动解析没有稳定提取出 Related Work 的完整脉络。可先从论文引言、相关工作章节和引用线索核对它主要对比了哪些方法。",
        "related_prefix": "Based on current evidence, the paper is positioned around: " if is_en else "从当前证据可见，论文的定位至少包括：",
        "solution_empty": "Method details were not extracted reliably; focus on the Method / Approach section." if is_en else "当前未成功提炼方法细节，请重点阅读 Method / Approach 部分。",
        "experiments_empty": "No clear experimental setup was extracted; check Experiments / Results, tables, figures, and key metrics." if is_en else "当前没有提炼出明确实验设置，请重点核对 Experiments / Results、表格、图示和主要指标。",
        "future_empty": "Current information is insufficient; revisit limitations, failure cases, ablation gaps, and cross-domain generalization in the paper." if is_en else "当前信息不足，建议从局限性、失败案例、消融缺口和跨领域泛化四个角度回原文继续挖掘。",
        "contributions_prefix": "Main contributions include: " if is_en else "主要贡献包括：",
        "limitations_prefix": "Important boundaries include: " if is_en else "需要注意的边界包括：",
        "relevance_prefix": "Relationship to the user profile: " if is_en else "与用户画像的关系：",
        "summary_empty": "Current information is insufficient; connect the abstract, introduction, method, and conclusion in the original paper." if is_en else "当前信息不足，建议回到原文摘要、引言、方法和结论串联主线。",
        "recommendation": "Recommendation" if is_en else "推荐指数",
        "reason": "Reason" if is_en else "推荐理由",
        "details": "Paper Details" if is_en else "基本信息",
        "authors": "Authors" if is_en else "作者",
        "affiliation": "Affiliation" if is_en else "机构",
        "source": "Source" if is_en else "来源",
        "subjects": "Subjects/Categories" if is_en else "主题/分类",
        "date": "Date" if is_en else "日期",
        "recommendation_level": "Recommendation" if is_en else "推荐级别",
        "analysis_source": "Analysis source" if is_en else "解析来源",
        "generation_model": "Generation model" if is_en else "生成模型",
        "not_provided": "Not provided" if is_en else "未提供",
        "unknown": "Unknown" if is_en else "未知",
        "analysis_note": "Analysis note" if is_en else "解析说明",
    }
    field_sep = ": " if is_en else "："
    list_joiner = "; " if is_en else "；"
    sentence_end = "." if is_en else "。"
    report_style = _normalize_report_style(payload.get("report_style"))
    title = _clean_text(paper.get("title")) or labels["untitled"]
    abstract = _clean_abstract_text(payload.get("abstract") or paper.get("abstract"))
    clean_abstract_summary = _clean_text(payload.get("clean_abstract_summary"))
    if clean_abstract_summary and (not _clean_text(abstract) or _looks_like_extraction_noise(abstract)):