choosing-trend-or-slope-view

选择趋势线还是斜率视图

“X 在 A 到 B 之间发生了怎样的变化？”这个问题含义不明确。两种图表分别回答两个不同的问题，因此除非用户已经明确指定，否则先确认再构建：

• 随时间变化（折线图） — 范围内每个时间间隔的数值。 展示变化的_过程_：低谷、峰值，以及变化发生的时间。这是默认的趋势视图。
• 起点与终点（斜率图） — 仅显示第一个和最后一个点，每个系列用一条线连接两点。展示_净变化_；对于多个系列，还能显示哪些上升、哪些下降，以及排名变化，而不会被中间过程的波动干扰。

如果用户的请求可能指这两种视图，请简短地询问二选一，例如：

你想查看整个期间的变化过程（折线图），还是只看起点到终点的变化（斜率图）？

如果用户已明确表达需求——“只告诉我从起点到终点增长了多少” → 斜率图；“展示趋势 / 峰值何时出现” → 折线图——则跳过提问，直接构建。

如何渲染每种视图

两种视图都基于相同日期范围内的同一个 TrendsQuery——斜率图只是将该系列折叠为第一个点和最后一个点，并非使用不同的查询。

随时间变化 → 折线图

默认的趋势行为。创建或运行一个 TrendsQuery，并将 trendsFilter.display 保持为 ActionsLineGraph（默认值，即“随时间变化”）：

{
  "kind": "TrendsQuery",
  "series": [{ "kind": "EventsNode", "event": "$pageview", "math": "total" }],
  "dateRange": { "date_from": "2025-01-01", "date_to": "2025-03-31" },
  "trendsFilter": { "display": "ActionsLineGraph" }
}

起点与终点 → 斜率图

使用 posthog:query-trends 运行趋势查询。Max 渲染的结果卡片中有一个 Line / Bar / Slope 视图切换开关——将其切换为 Slope，即可将每个系列显示为一条从第一个点连到最后一个点的线，并在图例中显示各系列的变化。告诉用户，他们可以在结果中切换到 Slope 视图。

斜率图最适合清晰地比较前后差异，尤其适用于多个相对变化情况很重要的系列或类别。选择一个日期范围，使首尾两端正好是你要比较的点（斜率图使用第一个和最后一个时间间隔）。

重要限制

• 两个展示界面，一次计算。 内嵌斜率图（Max 的 query-trends 结果卡片）和已保存洞察中的斜率图（ChartDisplayType.SlopeGraph）展示的内容相同：所选分组时间间隔中，第一个时间间隔的数值与最后一个时间间隔的数值。分组方式决定斜率图的比较范围——按月分组时比较第一个月和最后一个月，按天分组时比较第一天和最后一天。对于已经打开的结果，使用内嵌视图快速查看前后差异；使用已保存的展示形式将其保留在仪表板上。仍在累计的最后一个周期会按当前状态显示，并使用虚线连接；折线图对未完成的尾部也采用相同的呈现方式。
• 对于单个系列的周期同比较（本月与上月），折线图可通过 compareFilter: { "compare": true } 叠加显示两个周期；同时比较多个系列的端点时，斜率图更合适。