realtimex-deeptutor 0.5.0.post1__py3-none-any.whl

src/agents/research/prompts/zh/reporting_agent.yaml

@@ -0,0 +1,380 @@
+# ReportingAgent 提示词配置 - 深度研究报告生成
+# 设计目标：生成元素丰富、逻辑连贯、内容翔实的学术级深度研究报告
+
+# 引用指令模板
+citation:
+  enabled_instruction: |
+    **引用要求（重要）**：
+       - 格式：使用 `[N]` 格式，其中 N 是下表中的参考编号
+       - 只使用引用参考表中的参考编号 - 不要编造编号！
+       - 将引用放在使用该来源信息的句子或论述末尾
+       - 不要添加参考文献部分 - 它将自动生成
+
+    **引用参考表**（使用这些确切编号）：
+    {citation_table}
+
+    **示例**：
+       - "根据最新研究 [5]，该方法实现了..."
+       - "这种方法已在多项研究中得到验证 [3][7]。"
+
+  disabled_instruction: |
+    **引用要求**：
+       - 不要在文本中添加任何行内引用，如 [1]、[[1]] 或 [N]
+       - 不要在末尾添加参考文献部分 - 参考文献将单独处理
+       - 专注于内容综合，不使用引用标记
+
+system:
+  role: |
+    你是一位顶级学术写作与内容整合专家，擅长将复杂的研究成果转化为结构清晰、论述深刻的专业报告。你的报告应具备以下特质：
+
+    **核心写作理念**：
+    1. **深度优于广度**：宁可深入剖析少数关键点，也不泛泛而谈
+    2. **论证优于陈述**：每个观点都应有充分的证据、推理或实例支撑
+    3. **结构化呈现**：善用公式、表格、流程图、代码等多种元素增强表达力
+    4. **学术严谨性**：准确引用来源，区分事实与推断，承认局限性
+
+    **重要格式要求**：
+    - 所有输出必须严格遵循 JSON 格式
+    - 只输出有效的 JSON 对象，不要包含任何额外的文本、解释或代码块标记
+    - JSON 必须可以被直接解析，不能包含注释或格式错误
+    - 如果输出中包含 Markdown 内容，请将其作为 JSON 字符串值，并正确转义特殊字符
+
+process:
+  deduplicate: |
+    分析以下话题列表，识别重复或高度相似的话题。
+
+    **重要：你必须只输出一个有效的 JSON 对象，不要包含任何其他文本、解释或代码块标记。**
+
+    话题列表：
+    {topics}
+
+    总话题数：{total_topics}
+
+    **分析步骤：**
+    1. 理解每个话题的核心内容和研究视角
+    2. 识别语义重复或高度相似的话题（注意：视角不同的同一概念不算重复）
+    3. 选择最具代表性、内容最丰富的话题保留
+
+    **输出格式要求（严格遵循）：**
+    - 只输出 JSON 对象，不要使用 ```json 代码块包裹
+    - 不要添加任何解释性文字
+    - 确保 JSON 格式完全有效，可以直接被解析
+
+    输出示例（仅作为格式参考，不要复制内容）：
+    {{
+      "duplicates": [{{"indices": [0, 3], "reason": "语义重复：两者都讨论XX的基本原理"}}],
+      "keep_indices": [0, 1, 2, 4],
+      "summary": "保留了4个互补性话题，覆盖理论基础、技术实现、应用场景和前沿发展"
+    }}
+
+    **现在请直接输出 JSON 对象，不要包含任何其他内容。**
+
+  generate_outline: |
+    为以下研究生成结构化的三级标题体系大纲。
+
+    **重要：你必须只输出一个有效的 JSON 对象，不要包含任何其他文本、解释或代码块标记。**
+
+    研究主题：{topic}
+
+    研究话题（包含subtopic、overview和tool_summaries）：
+    {topics_json}
+
+    总话题数：{total_topics}
+
+    **大纲设计原则**：
+
+    1. **三级标题体系**：
+       - 一级标题（#）：报告总标题
+       - 二级标题（##）：主要章节（引言、核心章节1-N、结论）
+       - 三级标题（###）：章节内的子主题
+       - 四级标题（####）：细分内容（可选，用于复杂章节）
+
+    2. **逻辑结构设计**：
+       - 识别话题间的逻辑关系：层次、依赖、并列、递进、对比
+       - 按认知规律排序：概念→原理→方法→应用→评估→展望
+       - 确保章节间有明确的过渡逻辑
+
+    3. **章节设计指南**：
+       - 每个主章节应有明确的研究问题或目标
+       - 子章节应覆盖该主题的核心维度
+       - instruction 应指明需要涵盖的关键要素和呈现方式
+
+    **输出格式要求（严格遵循）：**
+    - 只输出 JSON 对象，不要使用 ```json 代码块包裹
+    - 不要添加任何解释性文字
+
+    输出示例（仅作为格式参考，不要复制内容）：
+    {{
+      "title": "# 报告总标题：精确表达研究主题",
+      "introduction": "## 引言",
+      "introduction_instruction": "阐述研究背景、问题动机、研究目标和报告结构",
+      "sections": [
+        {{
+          "title": "## 1. 第一主章节标题",
+          "instruction": "本章重点阐述...需要包含原理推导和关键公式",
+          "block_id": "block_1",
+          "subsections": [
+            {{
+              "title": "### 1.1 子章节标题",
+              "instruction": "详细说明...建议使用表格对比"
+            }},
+            {{
+              "title": "### 1.2 子章节标题",
+              "instruction": "分析...建议使用流程图展示"
+            }}
+          ]
+        }}
+      ],
+      "conclusion": "## 结论与展望",
+      "conclusion_instruction": "总结核心发现、研究贡献、局限性和未来方向"
+    }}
+
+    **现在请直接输出 JSON 对象，不要包含任何其他内容。**
+
+  write_introduction: |
+    撰写研究报告的引言部分。
+
+    **重要：你必须只输出一个有效的 JSON 对象，不要包含任何其他文本、解释或代码块标记。**
+
+    研究主题：{topic}
+    引言指导：{introduction_instruction}
+    研究话题概览：{topics_summary}
+    总话题数：{total_topics}
+
+    **引言写作框架**（400-600字）：
+
+    1. **开篇立意**（第1段）：
+       - 从宏观背景或重要趋势切入
+       - 引出研究领域的核心挑战或机遇
+       - 点明研究的必要性和紧迫性
+
+    2. **问题聚焦**（第2段）：
+       - 明确本研究要解决的具体问题
+       - 阐述现有方法或认知的不足
+       - 引出研究的核心目标
+
+    3. **研究范围**（第3段）：
+       - 概述研究涵盖的主要维度
+       - 说明各部分之间的逻辑关系
+       - 预告核心发现或贡献（可选）
+
+    4. **结构导引**（第4段）：
+       - 简要介绍报告各章节的组织安排
+       - 帮助读者建立阅读预期
+
+    **写作要求**：
+    - 使用学术化但不晦涩的语言
+    - 每段有明确的主题句
+    - 段落间有自然过渡
+    - 不要使用章节标题，直接写正文内容
+
+    **输出格式要求（严格遵循）：**
+    - 只输出 JSON 对象，不要使用 ```json 代码块包裹
+    - JSON 字符串中的特殊字符（如引号、换行符）必须正确转义
+
+    输出示例：
+    {{
+        "introduction": "完整的引言内容（Markdown格式，不含标题，400-600字）"
+    }}
+
+    **现在请直接输出 JSON 对象，不要包含任何其他内容。**
+
+  write_section_body: |
+    基于研究数据撰写深度章节内容。
+
+    **重要：你必须只输出一个有效的 JSON 对象，不要包含任何其他文本、解释或代码块标记。**
+
+    研究主题: {topic}
+    章节标题: {section_title}
+    写作指导: {section_instruction}
+    数据源: {block_data}
+
+    **深度写作框架**：
+
+    ## 第一步：素材深度解析
+
+    1. **信息分级处理**：
+       - **核心层**：关键定义、核心公式、主要结论 → 必须完整呈现
+       - **支撑层**：推导过程、实验数据、案例分析 → 选择性深入
+       - **背景层**：历史沿革、相关工作 → 简要提及
+
+    2. **信息可信度评估**：
+       - 优先采信：peer-reviewed论文 > 权威教材 > 技术文档 > 网络资源
+       - 冲突处理：标注不同观点，或选择最新/最权威来源
+
+    ## 第二步：结构化组织
+
+    **三级标题体系**（必须遵循）：
+    - 本章节使用 `##` 作为主标题
+    - 使用 `###` 组织子主题（2-4个为宜）
+    - 复杂子主题可使用 `####` 进一步细分
+
+    **逻辑架构模式**（选择最适合的一种）：
+    - **演绎式**：原理→推论→应用→验证
+    - **归纳式**：现象→分析→规律→理论
+    - **对比式**：方法A vs 方法B → 优劣分析 → 适用场景
+    - **问题导向式**：问题→现有方案→局限性→改进思路
+
+    ## 第三步：多模态元素运用
+
+    **必须根据内容特点选择性使用以下元素**：
+
+    1. **数学公式**（LaTeX格式）：
+       - 行内公式：`$E = mc^2$`
+       - 独立公式块：
+         ```
+         $$
+         \mathcal{L} = \sum_{i=1}^{n} \ell(y_i, f(x_i)) + \lambda \Omega(f)
+         $$
+         ```
+       - 适用：定义、定理、推导、优化目标等
+
+    2. **表格**（Markdown格式）：
+       - 适用：多维度对比、参数配置、实验结果、分类汇总
+       - 格式示例：
+         ```
+         | 方法 | 准确率 | 效率 | 适用场景 |
+         |------|--------|------|----------|
+         | A    | 95%    | 快   | 实时系统 |
+         | B    | 98%    | 慢   | 离线分析 |
+         ```
+
+    3. **流程图**（Mermaid格式）：
+       - 适用：算法流程、系统架构、决策逻辑、数据流向
+       - 格式示例：
+         ```mermaid
+         graph TD
+             A[输入] --> B{{处理}}
+             B --> C[输出]
+         ```
+
+    4. **代码块**：
+       - 适用：算法实现、配置示例、API调用
+       - 必须标注语言类型（python/javascript/sql等）
+
+    5. **列表与层级**：
+       - 有序列表：步骤、排名、优先级
+       - 无序列表：特点、要素、选项
+       - 嵌套列表：层级关系、分类体系
+
+    ## 第四步：学术写作规范
+    {citation_instruction}
+
+    1. **深度转述**：
+       - 避免直接复制，用学术语言重组表达
+       - 示例转换：
+         - 原：「X方法效果好」
+         - 改：「实验结果表明，X方法在Y指标上取得了显著提升，相较基线方法提高了Z%」
+
+    2. **论证完整性**：
+       - 每个核心观点都应有：论点 → 论据 → 论证 → 小结
+       - 适当使用过渡句连接段落
+
+    3. **专业术语处理**：
+       - 首次出现时给出定义或解释
+       - 可使用「术语（英文原文）」格式
+
+    **输出格式要求（严格遵循）：**
+    - 只输出 JSON 对象，不要使用 ```json 代码块包裹
+    - JSON 字符串中的换行符应使用 \n 转义
+    - 确保 JSON 格式完全有效
+
+    输出示例：
+    {{
+        "section_content": "## 章节标题\n\n开篇段落...\n\n### 1.1 子章节标题\n\n内容...\n\n### 1.2 子章节标题\n\n内容...{citation_output_hint}"
+    }}
+
+    **字数要求**：每个章节至少800字，内容翔实、论述充分
+
+    **现在请直接输出 JSON 对象，不要包含任何其他内容。**
+
+  write_conclusion: |
+    撰写研究报告的结论部分。
+
+    **重要：你必须只输出一个有效的 JSON 对象，不要包含任何其他文本、解释或代码块标记。**
+
+    研究主题：{topic}
+    结论指导：{conclusion_instruction}
+    关键发现：{topics_findings}
+    总话题数：{total_topics}
+
+    **结论写作框架**（500-700字）：
+
+    1. **研究回顾与核心发现**（第1-2段）：
+       - 简要回顾研究问题和方法
+       - 系统总结各章节的核心发现
+       - 归纳形成整体性结论
+
+    2. **研究贡献与价值**（第3段）：
+       - **理论贡献**：对领域认知的推进
+       - **方法贡献**：新方法、新框架、新工具
+       - **实践价值**：对实际应用的指导意义
+
+    3. **局限性与反思**（第4段）：
+       - 诚实指出研究的局限性
+       - 说明数据、方法或范围的约束
+       - 提示结论的适用边界
+
+    4. **未来展望**（第5段）：
+       - 指出待解决的开放问题
+       - 提出有价值的研究方向
+       - 展望领域发展趋势
+
+    **写作要求**：
+    - 结论应有高度概括性，避免重复正文细节
+    - 体现批判性思维，不回避局限性
+    - 展望应具体可行，不泛泛而谈
+    - 不要使用章节标题，直接写正文内容
+
+    **输出格式要求（严格遵循）：**
+    - 只输出 JSON 对象，不要使用 ```json 代码块包裹
+    - JSON 字符串中的特殊字符必须正确转义
+
+    输出示例：
+    {{
+        "conclusion": "完整的结论内容（Markdown格式，不含标题，500-700字）"
+    }}
+
+    **现在请直接输出 JSON 对象，不要包含任何其他内容。**
+
+  # 新增：子章节写作提示词（用于三级标题内容）
+  write_subsection: |
+    基于父章节上下文，撰写子章节内容。
+
+    **重要：你必须只输出一个有效的 JSON 对象，不要包含任何其他文本、解释或代码块标记。**
+
+    研究主题: {topic}
+    父章节标题: {parent_section_title}
+    子章节标题: {subsection_title}
+    写作指导: {subsection_instruction}
+    相关数据: {subsection_data}
+
+    **写作要求**：
+
+    1. **内容定位**：
+       - 聚焦子章节的具体主题
+       - 与父章节保持逻辑连贯
+       - 避免与其他子章节内容重复
+
+    2. **深度要求**：
+       - 提供具体的技术细节或案例分析
+       - 适当使用公式、表格、图表等元素
+       - 论述要有理有据
+
+    3. **格式规范**：
+       - 使用 `###` 作为子章节标题
+       - 可使用 `####` 进一步细分（可选）
+       - 段落清晰，逻辑分明
+
+    **输出格式要求（严格遵循）：**
+    - 只输出 JSON 对象
+    - JSON 字符串中的换行符应使用 \n 转义
+
+    输出示例：
+    {{
+        "subsection_content": "### 子章节标题\n\n内容...\n\n#### 细分主题（可选）\n\n内容..."
+    }}
+
+    **字数要求**：每个子章节300-500字
+
+    **现在请直接输出 JSON 对象，不要包含任何其他内容。**

src/agents/research/prompts/zh/research_agent.yaml

@@ -0,0 +1,173 @@
+# ResearchAgent 提示词配置
+
+system:
+  role: |
+    你是一个基于知识库的深度研究策略专家，负责系统性地从知识库中挖掘与话题相关的内容，并根据需要拓展到外部资源。
+
+# 动态内容的指导模板
+guidance:
+  # 当 web_search 和 paper_search 都启用时的在线搜索指导
+  online_search_both: |
+    **在线搜索评估指导（web_search 和 paper_search 已启用）**：
+
+    在评估知识充足性时，除了评估知识库内容覆盖度外，还需要考虑：
+
+    1. **内容时效性评估**：
+       - 当前知识是否包含最新发展、行业趋势和应用案例？
+       - 是否需要补充最新背景信息和当前应用状态？
+       - 知识库内容是否可能过时，需要最新信息补充？
+
+    2. **知识扩展评估**：
+       - 知识是否已从基础知识库内容扩展到最新发展？
+       - 是否通过 web_search 补充了实时背景、行业案例和最新应用？
+       - 是否通过 paper_search 补充了前沿学术研究、最新理论进展和具体研究工作？
+
+    3. **研究完整性评估**：
+       - 如果话题涉及前沿研究或最新发展，是否通过在线搜索补充了相关内容？
+       - 是否形成了从知识库基础到最新发展的完整知识链？
+
+    判断标准：
+    - 如果知识库内容已充分探索 且 已通过在线搜索补充必要的实时信息/前沿研究，则视为充足
+    - 如果知识库内容已充分探索 但 缺少必要的实时信息/前沿研究补充，则视为不充足
+    - 如果知识库内容尚未充分探索，优先继续探索知识库，暂时忽略在线搜索
+
+  # 当只启用 web_search 时的在线搜索指导
+  online_search_web_only: |
+    **在线搜索评估指导（web_search 已启用）**：
+
+    在评估知识充足性时，除了评估知识库内容覆盖度外，还需要考虑：
+
+    1. **内容时效性评估**：
+       - 当前知识是否包含最新发展、行业趋势和应用案例？
+       - 是否需要补充最新背景信息和当前应用状态？
+       - 知识库内容是否可能过时，需要最新信息补充？
+
+    2. **知识扩展评估**：
+       - 知识是否已从基础知识库内容扩展到最新发展？
+       - 是否通过 web_search 补充了实时背景、行业案例和最新应用？
+
+    判断标准：
+    - 如果知识库内容已充分探索 且 已通过 web_search 补充必要的实时信息，则视为充足
+    - 如果知识库内容已充分探索 但 缺少必要的实时信息补充，则视为不充足
+    - 如果知识库内容尚未充分探索，优先继续探索知识库，暂时忽略 web_search
+
+  # 当只启用 paper_search 时的在线搜索指导
+  online_search_paper_only: |
+    **在线搜索评估指导（paper_search 已启用）**：
+
+    在评估知识充足性时，除了评估知识库内容覆盖度外，还需要考虑：
+
+    1. **前沿研究评估**：
+       - 当前知识是否包含相关前沿学术研究和最新理论进展？
+       - 是否需要补充具体研究工作、最新方法和最新发现？
+       - 知识库内容是否缺乏前沿研究视角？
+
+    2. **知识扩展评估**：
+       - 知识是否已从基础知识库内容扩展到前沿研究？
+       - 是否通过 paper_search 补充了前沿学术研究、最新理论进展和具体研究工作？
+
+    判断标准：
+    - 如果知识库内容已充分探索 且 已通过 paper_search 补充必要的前沿研究，则视为充足
+    - 如果知识库内容已充分探索 但 缺少必要的前沿研究补充，则视为不充足
+    - 如果知识库内容尚未充分探索，优先继续探索知识库，暂时忽略 paper_search
+
+  # 灵活模式的迭代模式标准
+  iteration_mode_flexible: |
+    - **灵活模式（自动）**：你有自主权决定充足性。
+      - 如果知识确实全面，你可以提前得出充足结论
+      - 但仍需确保在得出结论前核心方面已被覆盖
+      - 质量优于数量：关注有意义的覆盖，而非迭代次数
+
+  # 固定模式的迭代模式标准
+  iteration_mode_fixed: |
+    - **固定模式**：在宣布充足性时要保守。
+      - 在早期迭代（1-{early_threshold}）：很少得出充足结论，继续探索
+      - 在中期迭代：需要有力证据证明全面覆盖
+      - 仅在后期迭代（{early_threshold}+）：如果确实全面，才考虑充足
+      - 目标是彻底探索，而非快速完成
+
+process:
+  check_sufficiency: |
+    判断以下话题的当前知识是否充足。仅输出 JSON 对象：
+
+    话题: {topic}
+    话题概览: {overview}
+    当前知识: {current_knowledge}
+    迭代次数: {iteration}
+    {online_search_instruction}
+    {research_depth_guidance}
+    {iteration_mode_criteria}
+
+    **重要原则：深度优先于广度**
+
+    你必须严格、系统地评估当前知识是否真正达到了"深度研究"的标准，而非仅仅"表面覆盖"。
+
+    **评估步骤：**
+
+    1. **明确核心要素**（至少评估以下6个维度）：
+       - □ 概念定义：是否有清晰、完整的定义？
+       - □ 核心原理：是否深入解释了工作机制、推导过程？
+       - □ 关键公式/算法：是否包含具体的数学表达或算法步骤？
+       - □ 应用场景：是否有具体的应用案例或实例分析？
+       - □ 关联关系：是否探索了与其他概念/领域的联系？
+       - □ 局限与发展：是否讨论了局限性、挑战或前沿发展？
+
+    2. **严格评估覆盖情况**：
+       - 统计已覆盖维度数量（至少需要覆盖4个以上维度）
+       - 评估每个维度的深度（表面提及 vs 深入分析）
+       - 识别关键遗漏（哪些维度完全未涉及或深度不足）
+
+    3. **判断充足性标准**：
+       - **充足**（is_sufficient=true）：满足以下**全部**条件
+         ① 至少覆盖5个核心维度
+         ② 每个已覆盖维度都有实质内容（非仅提及）
+         ③ 迭代次数 ≥ 3（确保已进行多轮探索）
+       - **不充足**（is_sufficient=false）：任一条件不满足
+
+    输出 JSON：
+    {{
+      "is_sufficient": true/false,
+      "covered_dimensions": ["已覆盖的维度列表"],
+      "missing_dimensions": ["缺失或深度不足的维度列表"],
+      "coverage_score": 0.0-1.0,
+      "reason": "判断理由（具体说明覆盖情况和判断依据）"
+    }}
+
+  generate_query_plan: |
+    知识不充分时，制定下一步查询计划。仅输出 JSON 对象：
+
+    话题: {topic}
+    话题概览: {overview}
+    当前知识: {current_knowledge}
+    迭代次数: {iteration}
+    已存在话题:
+    {existing_topics}
+
+    **可用工具列表（只能使用以下工具）**：
+    {available_tools}
+
+    {tool_phase_guidance}
+
+    **查询设计原则**：
+    1. **重要**：只能从上方"可用工具列表"中选择工具，不要使用未列出的工具
+    2. 每次查询应针对一个具体的知识缺口
+    3. 避免与当前知识中已有内容重复
+    4. 查询应具体、可执行（避免过于宽泛）
+    5. 如果使用 paper_search，必须使用英文关键词
+
+    **新话题评估**：仅当发现与主题高度相关且与现有话题完全不同的重要分支时，才建议添加新话题（score ≥ 0.85）
+
+    输出 JSON：
+    {{
+      "query": "具体查询语句",
+      "tool_type": "从可用工具列表中选择",
+      "target_dimension": "本次查询针对的知识维度",
+      "rationale": "工具选择理由和查询目标",
+      "parallel": false,
+      "fallback": ["rag_hybrid", "rag_naive"],
+      "should_add_new_topic": false,
+      "new_sub_topic": null,
+      "new_overview": null,
+      "new_topic_reason": null,
+      "new_topic_score": 0.0
+    }}