用途：在 PostHog 中创建箱线图洞察，用于展示数值型属性的分布情况，而非已聚合的均值或总量。
选择查询类型： 标准产品分析箱线图适用于数据源为 Trends 支持的事件、动作或数据仓库表，且有一个数值型属性承载待分布的值、用户希望按常规时间区间查看分布的场景。做法是构建 InsightVizNode，其 source 为 TrendsQuery：设置系列事件或动作，设置 math_property 为数值属性，设置 trendsFilter.display 为 BoxPlot，选择日期范围与间隔，用 posthog:query-trends 运行，返回分布行后用 posthog:insight-create 保存，再用 posthog:insight-get 读回确认属性、间隔与显示。没有数值 math_property 的箱线图无效，不要用事件计数替代，除非计数本身就是待分布的值。
SQL 箱线图适用于需要自定义分组、连接、派生值或定制 SQL 的场景。编写 HogQL 前需先阅读 querying-posthog-data，可参考 references/sql-examples.md。不要仅为了复现标准 Trends 查询而使用 SQL。SQL 必须为每个 X 轴与系列组合返回一行预聚合结果，在数据库中计算摘要，切勿基于客户端有限结果行计算百分位。所需数值角色包括 minimum、25th percentile、median、mean、75th percentile、maximum。最简结果形状使用别名 x、series、min、p25、median、mean、p75、max。x 与 series 可选：将 xAxisColumn 设为 null 表示整体分布或每个系列一个箱；将 seriesColumn 设为 null 表示单一系列。保存前用 posthog:execute-sql 校验 HogQL，确认每个统计量均为数值、min <= p25 <= median <= p75 <= max、均值在最小值与最大值之间、每个 X 轴与系列组合只出现一次、系列不超过 200 个且 X 轴与系列单元格不超过 10,000 个。随后用 posthog:insight-create 保存该形状（DataVisualizationNode，display 为 BoxPlot，chartSettings.boxPlot 指定各列）。查询使用不同名称时请使用实际别名，不要把六项统计量映射为六个 Y 轴系列。
保存后验证：用 posthog:insight-get 读回，用 posthog:insight-query 运行，确认结果仍有预期列且每个箱一行，并报告洞察链接、待分布的数值以及分组选择。若某行摘要缺失或无效，PostHog 会省略该箱而保留有效箱；若非预期省略，请修复 SQL。
相关技能：querying-posthog-data 是编写或修改 SQL 箱线图 HogQL 前的必需项；formatting-insight-axes 用于值轴需要货币、时长、百分比等格式时；building-a-dashboard 用于将箱线图与其他洞察放入仪表盘时。
限制：资料未提供具体价格、平台支持范围或额外功能说明。