Result Visualization

---
name: result_visualization
description: Charts, evidence tables, process/argument diagrams, and figure validation for research reports and direction discussions. Load when producing or reviewing any long report, when a direction discussion needs implementation-chain/risk/decision diagrams, or when the user asks to plot data, draw diagrams, or produce publication-ready figures. Delegates statistical analysis and verdicts to result_analysis.
requires: research_manager
---

## Output Contract

- 先说结论，再给必要依据和下一步。
- 默认短句和常用词；术语只在更准确时用，首次出现直接解释。
- 内部状态、流程和检查表默认不展示；只有影响决定或用户明确要求时才展开。
- 外部事实、论文结论和数字附来源；不确定的直接写"尚未验证"或"我推测"，不给每句话机械加事实/猜测标签。
- 一段能说清就不用表格；独立要点用列表；只有横向比较才用表格。
- 不写套话、廉价肯定、重复总结和固定收尾。
- 禁用黑话和自造词（赋能、闭环、抓手、对齐、链路、落地、打磨等），直接说具体那件事。
- 写文件前先经用户确认。
- 只在发现具体的过时或重复内容时才提议清理，不作为固定收尾动作。

# Result Visualization — 编码证据，不许扭曲

管视觉编码和图的制作——实验证据图，**也包括方向讨论用的论证图**。不编造不确定度、不做假设检验、不下方向判定。

## 0. 方向讨论用的论证图

`research_progress` 或 `experiment_manager` 委托时，画能暴露文字藏住的缺口的图：

- **实现链图**：输入 → 数据/信号 → 模块 → 张量 → 训练信号 → 推理 → 输出 → 评测。语义状态色用 `plotting-reference.md` §3 的色板（`已验证` 绿、`有依据` 蓝、`猜测` 橙、`不知道/卡住` 红、无关 灰）。核心路径上连续两个橙/红箭头必须保持醒目——不许抹平。
- **相关工作对齐图**：我们的想法到底改了链条的哪一段，对比最近的直接工作。
- **猜想风险图**：猜想清单的条目按 猜测度 × 影响 摆位置。
- **决策图**：结果 A/B/模糊各自映射到 继续/转向/停 的动作。

这些是`解释`类产物，随方向的实验计划保留，不是用完即弃的装饰。

## 1. 数据图和证据表

接受原始/表格数据或 `result_analysis` 的交接。先验：数据形状、观测单位、聚合方式、缺失值、可用的不确定度。

从分析问题选形式：

| 问题 | 形式 |
|---|---|
| 分布 | 直方图、密度、箱线、小提琴、散点带 |
| 配对变化 | 配对点/线、斜率图 |
| 随步数趋势 | 折线 + 标明不确定度单位 |
| 比较 | 点图、小倍数图；类别少才用柱状 |
| 关系 | 散点、热图、等高线 |
| 校准 | 可靠性图、残差图 |
| 敏感性/消融 | 有序点/柱状、交互图 |
| baseline–预期–实际 | 三个都标出的区间对比图 |

优先展示分布或原始点；不许把异质性藏在聚合柱子后面。数据琐碎或图不带来信息时用紧凑表格。不许编造误差棒、置信区间、显著性标记、缺失值、样本量。

## 2. 流程和结构图

画 Mermaid 流程图、状态图、时序图、架构图、ER 图、时间线，不涉及统计分析。要求提供：用途、实体/状态、关系/转换、目标渲染器。节点/边超过可读预算就拆图。标准语义用 Mermaid；Mermaid 表达不了的布局用自包含内联 SVG：复用语义色板（`plotting-reference.md` §3）、不引外部字体或脚本、标注产物类别。不用 draw.io 等依赖插件的格式。

## 3. 图的制作和验收

产出可复现源文件加最少输出：矢量用 PDF/SVG，确实需要预览或位图时才出 PNG。逐项检查：轴标签和单位、刻度和基线、图例、排序、不确定度含义、色盲/灰度可读性、字体可用性、裁切、图注自足性——清单见 `plotting-reference.md` §10。**嵌入处的渲染验收按 `experiment_manager` §4a 的标准执行——磁盘上一个正确但没人引用的文件不算交付。**

拒绝误导性默认：不标注的截断轴、没强理由的双轴、3D 装饰、彩虹色图、默认用饼图做比较、没有分析支撑的显著性装饰。脚本/源文件和渲染产物共用一个前缀，算一套产物。

## 4. 产物的去留

| 类别 | 用途 | 默认去留 |
|---|---|---|
| `诊断` | 调试、数据质量检查、探索性查看 | 不提交；运行后清理 |
| `证据` | 支撑实验价值或方向判定 | 随有价值的运行报告保留；终版报告只选最少集合 |
| `解释` | 表达稳定的流程、架构、论证或论文声明 | 随实验计划、转正后的系统或声明保留 |

每个产物都标类别，去留建议交给 `experiment_manager`。画得漂亮的图不自动是有价值的证据。验证通过和被证伪的方向都可以保留选中的图，只要它们实质支撑终版报告；报告资产是精选的证据，不是所有产物的堆场。

## 5. 交接约定

来自 `result_analysis` 或 `write_md` 的交接要有：用途/问题、源数据和版本、观测单位和设计、变量/分组/分面/排序、汇总/变换方式、合法的不确定度表示、主张或对比、目标媒介和渲染器、产物类别和去留建议。只负责把图画出来；不许改动统计结论。

来自 `research_progress` 的交接要有：带逐箭头状态标签的实现链、对齐目标（最近的工作）、或决策分支。只负责画论证图；不许改动"通过与否"的判断。

实现指导见 `plotting-reference.md`。