Plotly 是 Python 的交互式可视化库，内置悬浮、缩放、平移和选择等交互。它提供两套 API：高层 Plotly Express（简洁）与底层 Graph Objects（灵活）。图表以 HTML/JavaScript 渲染，可在 notebook 与浏览器中使用，支持 40 多种图表类型，包括统计、科学、金融和地理图表。
主要能力：散点图、折线图、柱状图、直方图、箱线图、小提琴图、饼图、热力图/图像、3D、地图与金融图表；支持 make_subplots 多面板布局、分面、共享轴与次坐标轴；可定制模板、颜色、标题、坐标轴、图例和悬浮信息。
必要用法：常见导入为 import plotly.express as px、import plotly.graph_objects as go、from plotly.subplots import make_subplots、import plotly.io as pio。Plotly Express 示例：fig = px.scatter(df, x="col_x", y="col_y", color="category"); fig.show()。Graph Objects 示例：fig = go.Figure(); fig.add_trace(go.Scatter(x=x_data, y=y_data, mode="markers")); fig.update_layout(title="My Plot"); fig.show()。导出示例：fig.write_html("plot.html")。
参考文件按主题组织：quickstart.md（安装、导入、px 与 go）、charts.md（基础图表）、subplots-facets.md（多面板与分面）、styling.md（模板、颜色、布局）、export.md（HTML、图像、JSON）、gotchas.md（常见错误、性能与最佳实践）。
限制：资料指出静态图像导出（PNG/SVG/PDF）在当前环境不可用，因未安装 kaleido（其依赖较重 Chromium）；静态图建议改用 plotnine，交互输出使用 HTML。需要交互时优先于 plotnine；涉及空间分析、投影或 GIS 式制图时使用 geopandas。研究流程中通过脚本文件生成可视化，以保证可审计与可复现：先将绘图代码写入 scripts/stage8_analysis/{step}_{plot-name}.py，再用 Bash 执行并自动捕获输出；完整执行协议见 agent_reference/SCRIPT_EXECUTION_REFERENCE.md，阶段说明见 agent_reference/WORKFLOW_PHASE4_ANALYSIS.md。引用：当 Plotly 作为主要可视化库产出报告或 notebook 中的交互图时，在软件与工具引用中加入 Plotly Technologies Inc. Plotly: Interactive graphing library [Computer software]. https://plotly.com/；仅用于未纳入交付物的探索性绘图时不引用。