用途:在为 PostHog 洞察图表选择 y 轴单位时,使用内置格式化器,而不是靠查询公式或字面前后缀伪造单位。适用于使用 posthog:insight-create 或 posthog:insight-update 创建或更新图表。
两种洞察的配置位置不同:TrendsQuery 用 trendsFilter.aggregationAxisFormat;SQL 洞察(DataVisualizationNode)按列配置,图表用 chartSettings.yAxis[].settings.formatting,表格用 tableSettings.columns[].settings.formatting。
TrendsQuery 可选格式:numeric(默认,纯计数)、duration(秒,渲染为 45s、2m 12s、1h 4m)、duration_ms(毫秒)、percentage(已是 0-100)、percentage_scaled(0-1 比率)、currency(项目基础货币)、short(压缩大数 1.2K)。配套字段:aggregationAxisPrefix(固定前缀)、aggregationAxisPostfix(仅用于格式无法表达的真实单位,不要用于 mins/s/%)、decimalPlaces。
要避免的反模式:用 formula "A / 60" 配合 postfix " mins",或 "A / 1000"、"A * 100"、在原始值上直接加 ms/s/min/hr 后缀。这些会把单位固定在一个量级,内置格式化器则按值自动选友好单位并保持底层数值正确。
货币:值为项目基础货币时用 currency;值固定为某货币(如始终 USD)时用 prefix "$" 加 decimalPlaces 2。
秒级序列(延迟、会话时长等):直接默认 duration,无需询问,因格式化不破坏底层数值。仅当用户明确要固定单位时才确认。一次性的 MCP 场景直接选 duration。
SQL 洞察:style 只有 none、number、short、percent,没有 duration 或 currency。percent 会追加 % 并把值乘 100(无未缩放变体),应传入 0-1 比率且不设 suffix;若 SQL 返回 0-100,则用 number + suffix "%"。混用会渲染错误,如 percent 加 % 后缀出现 47.3%%。优先比率形式。
更新已有洞察:若正在编辑的洞察存在上述反模式,在同一次 insight-update 中修复,去掉除 N 或乘 100 及字面 %,交给格式处理;值不变,只改标签。不要扫描无关洞察。
限制:资料未提供其他格式、平台支持范围或额外收费信息。