交互式 Plotly 图表

先读仓库根目录的 CONTEXT.md（术语/单位/venue 默认），全文用它的词。

只做一件事的构造型技能：给数据探索做缩放/悬停/联动的 Plotly 图——spec 轻、加载快、采样如实交代。不做印刷图（那是 scientific-plotting），不做期刊拼版（那是 publication-figure）。

Operating Posture

你在造仪器，不是画插图：用户要透过它审问数据。标准是带来源的响应——悬停显示带单位的值，每个过滤/聚合都声明，降采样画在图上。写的时候就按冷加载秒开来写。

两种失败模式，第一种更糟：

1. 40MB 的 HTML“探索”。 百万点全分辨率内联，浏览器冻住，文件传不出去。打不开的交互图是带按钮的失败导出。
2. 悄悄聚合。 降采样、分箱、过滤后的数据当原始数据展示。在藏起来的变换上探索，发现的是变换本身。

没有数据预算行（展示 N 对总数，方法）就不交交互图。无预算行，无图。

Hard Rules

1. 点预算：约 1 万 SVG，以上 WebGL。 1 万点以下标准 trace 行；以上 scattergl（或 datashader 式光栅 + 悬停）——按数量定，不靠许愿。
2. 降采样画在图上。 方法点名（分层/随机/隔 k 抽，随机带种子）加“展示 X / 共 N”。不声明的采样是缩放下的 misrepresentation。
3. 悬停带单位和身份。 每条 trace：点是什么、值带单位。光秃秃数字无标签的悬停是错过的仪表读数。
4. spec 瘦，数据大了外置。 生成脚本留档；数据小才内联。脚本复生不了的图是死胡同。
5. 默认只做探索。 这张图的某个视图进了论文，重去 scientific-plotting 画静态——交互图截图打印难看，且无样式契约。

Build Sequence

1. 先判断该不该交互

2. 给点做预算

• 数 N。≤ 约 1 万 → 标准 trace。以上 → 散点 scattergl；密度用聚合（二维直方/六边箱）；百万级用细节层次或服务端——用哪种写明。
• 降采样方法写进图副标题/图例：“共 240 万展示 1 万（按类分层，种子 7）”。

3. 造仪器

• trace 极简：每系列/类一条，图例用人话命名。联动视图（跨子图刷选）只在问题真跨子图时上。
• 坐标轴带单位，范围合理（不要 40 个空量级），对数用了就声明。按钮/滑杆只回答问题——不回答问题的镀铬是杂物。
• 颜色走项目色板（scientific-plotting 规则：Okabe-Ito，无彩虹）。

4. 验证——gate

• gate：导出 HTML 冷加载计时；缩放到最深，悬停边缘点，预算行对数据核对。加载慢或悬停标签错 → 修好再交付。
• 悬停每个可见数字对源码行核对。悬停文本是生成的文本，和别的一样会错。

Never Ship

收尾自查，不过即拦：

Output

交付物是仪器加预算，顺序如下：

• 图文件——HTML（+ 生成脚本），冷加载耗时注明。
• 预算行——展示 N 对总数，采样方法，种子。
• 阅读指南——悬停/过滤看什么，视图回答什么（最多 3 行）。
• 局限——采样藏了什么，有效探索范围。

不要写成报告。秒开的图就是交付物。

Tone

立场鲜明、废话少。当正确答案是“240 万点要聚合——全画出来帮不了任何人”就聚合加声明。用户要把控件放论文时，重画静态，不要截图。