debate-core

Debate Core: 何时辩、怎么辩、怎么回流

辩论是 MemOmics 的质量内核：结论、参数、可入库知识都必须过辩论。 但不是每次都辩——全量辩论有害（iMAD, AAAI 2026 Oral：选择性触发省 92% token 且准确率反升 13.5%）。用门控决定何时辩。

1. 什么时候该辩论（debate_gate 三级门控）

enforcement.py 的 debate_gate(es, stage, signals) 自动判定，返回 (level, reasons, force)：

级别	含义	成本
L0	跳过（chat/lightweight 级，无分析对象）	0
L1	轻量（单对正反+裁判 / 3 采样投票）	≈1/4
L2	完整 8 角色（正方3+反方4+裁判）	全量

五类触发信号（命中即升级）：

1. 高影响（high_impact）：入库/报告/结论产物工具（generate_report、 save_knowledge、add_figure 等）→ 强制 L2，不可降级
2. 失败（failed_retries≥2 或 last_error）：同命令重试≥2 次 → L2
3. 冲突（conflict）：rail_review(post) 未通过 / 与上次结果差异大 → L2
4. 不确定性（uncertainty）：候选参数≥2、措辞犹豫、自评低置信 → 结论前 L2
5. 阶段（stage）：analysis 级结论合成前默认 L2；脚本设计/执行后默认 L1

级别默认值：chat/lightweight → L0（不辩）；statistical → L1； analysis → 结论前 L2、其余 L1。

预算护栏：单会话辩论次数 ≥ config debate.budget（默认 3）后， 非强制 L2 自动降 L1。topic 级去重：同一主题只辩一次 （debated_topics 集合，替代旧的 debate_done 布尔）。

L2 裁判 confidence=low 且要入库 → 自动升级重辩（不可用低置信结论入库）。

2. 怎么辩论（引擎参数化，config.yaml debate: 段）

debate_analysis(topic, context, mode=?, rounds=?, role_model_map=?)： 不传参数时全部从 config 读，config 无 debate 段 = 现状行为（兼容）。

mode	含义	适用
homogeneous	单模型 8 角色（默认/现状）	日常 L1/L2
adversarial	正/反/判三组异构模型	实验、高争议
multi_model	每个角色独立模型	实验、多样性最大
temperature	同模型多温度采样	对照实验

• rounds：轮数，>1 时第 2 轮起向正反方注入上一轮裁判摘要 （角色依然看不到彼此原始论点——隔离不破坏）
• role_model_map：角色级模型覆盖，优先级最高 （角色名：pro_biology/pro_statistics/pro_bioinformatics/ con_biology/con_statistics/con_bioinformatics/con_history/judge）
• 缓存指纹：缓存 key = md5(topic+context+mode指纹)。不同架构 永不共享缓存结果。改 mode/rounds/role_model_map 必然是新辩论。
• 模型解析优先级：role_model_map[label] → mode 分组 （adversarial 的 judge/pro/con；multi_model 按角色哈希从 provider_keys 分配）→ 环境变量（_sync_debate_env 注入的 _current_model）
• 无环境 key 时回退 provider_keys.json：跳过失效 dcs-cloud，优先 deepseek 官方（deepseek-v4-flash），其余兜底

v2（2026-08-27）新增参数（config 的 debate 段或工具参数）：

• prompt_version: 2（默认）：v2 证据契约 + 结构化论据 + 裁判 rubrics； MEMOMICS_DEBATE_LEGACY_PROMPTS=1 一键回退 v1 提示词
• evidence_cards：外部证据卡（JSON 数组或文本，含 PMID/DOI/effect/n/source_file）， 注入所有角色与裁判；内容变化 → 指纹变化 → 不复用缓存
• role_preset: core7 | core9：core9 增加实验设计评审与可重复性评审两个中立角色 → 10 角色/轮
• judge_count: 1 | 3：多裁判温度采样 + 简单多数投票（judge_consensus 字段）；

  1 时成本 ×2-3，预算护栏按调用次数计

• rounds_max: 5：rounds 上限护栏（默认 5）
• max_tokens: {judge:8192, role:2048, l1_role:2048, l1_judge:8192} —— 推理模型（deepseek-v4-pro）若上限过低会被 reasoning 吃满，content 为空 → 裁决恒低
• 并发说明（2026-08-14 修正）：受控并发 max_workers=3（MEMOMICS_DEBATE_MAX_WORKERS）， 不再全串行（会卡死）也不全并发（会触发配额 8/8 失败）；隔离性不受影响