分析查询与洞察

分析查询与洞察

通过 sensors-cli 消费数据、获取业务洞察的三个入口，覆盖从标准化报表直接执行到自定义即席取数的完整分析链路。本功能簇包含概览书签、通用分析模型与自定义 SQL 三个 Skill，分别面向"读已有报表""跑标准分析""写灵活 SQL"三种粒度的取数诉求。三者各自独立运作，亦可在同一分析会话中组合衔接——标准分析或 SQL 的查询结果可追加为书签沉淀到概览，形成分析闭环。

三者共享同一套前置依赖：已确认的项目上下文（project_name）以及经由 sensors-metadata 校验的事件与属性元数据。建议遵循"先确认元数据，再选入口分析"的顺序。查询结果存在采样或截断时，统一按"估算值/结果不完整"口径解释，不下"Top""唯一""最高"等绝对结论。所有查询均通过 CLI 子命令执行，禁止手写 HTTP 或自写 SQL 兜底。

概览书签（sensors-dashboard）

概览与书签的读写入口，分读路径与写路径两类能力。读路径支持查找概览、展开书签列表、执行已保存的书签查询并解释结果；写路径支持创建空概览、向概览追加书签、在概览之间复制或迁移书签、从概览移除书签。查找与执行是两个独立步骤，仅当用户明确要求执行时才返回查询结果。概览支持十一类书签类型，涵盖事件分析、漏斗分析、留存分析、分布分析、LTV 分析、用户路径分析、间隔分析、归因分析、用户属性分析、Session 分析及自定义 SQL；用户群画像分析与用户列表查询不支持加入概览。追加的书签数据须来源于当前会话内已执行完成的标准分析或自定义 SQL 的查询输入，不支持根据自然语言临时拼装。所有写操作均须经用户确认且依赖 CLI 写操作开关处于开启状态。不支持编辑已有书签和删除概览。

通用分析模型（sensors-insight）

神策十三类标准分析模型的统一执行入口，负责分析意图识别、模型路由与查询执行。十三类模型包括事件分析、漏斗分析、留存分析、间隔分析、分布分析、属性分析、用户列表/用户细查、用户路径分析、用户群画像分析、RFM 分析、LTV 分析、Session 分析及归因分析。所有模型共享统一的参数协议：字段路径采用三段式或两段式，过滤条件统一使用三段式结构，聚合器按业务口径映射，相对时间须先解析为绝对日期。查询对象统一以 JSON 传入，正式执行前先经服务端预演校验。输出采用归一化结构，路径分析、画像分析与 RFM 分析保留各自专属输出形状。查询构造前须逐一核对事件名、属性名、字段路径及枚举值的精确性，遇多候选项须由用户确认，不得自行选择。

自定义 SQL（sensors-sql-query）

只读 SQL 的生成与执行入口，补足标准分析模型难以覆盖的复杂取数需求。支持两种进入方式：用户已提供 SQL 时直接进入只读校验与执行流程，不强制要求元数据确认；自然语言描述取数需求时须先确认所涉事件名、字段名、表名及枚举值，元数据不足则回退至 sensors-metadata，不允许猜测映射。仅允许查询语句，禁止任何建表、改表、增删改操作，执行前必须先经服务端预演校验。自动生成的 SQL 须采用"库名.表名"全限定格式，用户自带 SQL 可原样执行。跨项目与跨库查询在单条 SQL 内以"库名.表名"联表完成，仅当引擎明确报库不存在或权限隔离时才回退逐库查询合并。