使用指南
给已经有一套 evstats 的人：怎么把数据收进来，怎么在管理界面、Agent 和 OpenAPI 里把它用起来，以及项目、用户、配置怎么管。还没有部署的话，先看 快速体验。
按这个顺序用起来
| 步骤 | 做什么 | 看哪里 |
|---|---|---|
| 1. 建项目 | 一个网站、一个 App 或一组服务对应一个项目，拿到写入密钥 | 项目设置、核心概念 |
| 2. 接入 | 网页放 Web SDK，服务端用 Go / Java SDK，其它平台按 HTTP 协议发 | 接入概览 |
| 3. 设计埋点 | 用预置事件，给业务动作起事件名和属性 | 事件与属性 |
| 4. 确认收到 | 接入检查里看收到了什么、丢了多少、为什么 | 接入检查 |
| 5. 看数 | 流量、页面、用户、事件、行为五组分析，常看的图放进看板 | 看数、看板与书签 |
| 6. 深入分析 | 漏斗、留存、路径、画像、热力图、回放、归因、A/B 实验 | 左侧「分析」一组 |
| 7. 问数与取数 | 用中文问 Agent；业务系统用 OpenAPI 取同一套数 | Agent 问数、OpenAPI |
| 8. 管起来 | 用户与角色、系统配置、操作日志 | 左侧「管理」一组 |
两种工作方式
管理界面顶栏用一个分段控件在两种模式之间切换，项目和时间范围保持不动。
| 模式 | 看起来 | 适合 |
|---|---|---|
| Stats（数据看板） | 左边是分析菜单和看板，右边是图和表 | 每天看数、对账、导出 |
| Agent | 左边是这个项目下自己的对话，右边是流式回答 | 问掉量、漏斗卡点、留存、渠道 |
Agent 查到的条件和 Stats 的页面条件是同一套：每次查询在对话里是一张卡片，可以「在 Stats 打开」；任何一张 Stats 图表也可以「问 Agent」。
一套数，三个出口
统计只有一个实现。管理界面、Agent、OpenAPI 调用同一个查询、命中同一份缓存，所以三处的数字对得上。口径公开写在 指标口径。
能做什么
| 分组 | 回答的问题 |
|---|---|
| 流量分析 | 多少人来、从哪来、在哪、用什么设备；实时访问、数据汇总、趋势 |
| 页面分析 | 看了哪些页、从哪一页进、在哪一页走、站内站外搜什么 |
| 用户分析 | 某个人做了什么；活跃、忠诚度、流失、留存、回流与沉默 |
| 事件分析 | 事件次数与人数、事件日志、按维度拆分、漏斗、路径、自定义 SQL |
| 行为分析 | 热力图（可以叠在自己的网页上看）、会话回放、归因、A/B 实验 |
| 看板与书签 | 把常看的图放进一页，每天打开就是自己关心的数 |
| Agent 问数 | 用中文提问，回答里的每个数字都能点回原图 |
| OpenAPI | 只读的 /api/v1，嵌进自己的后台，或者交给外部 Agent |
全部功能都在同一个开源版本里，没有授权开关。每一项的详细说明见 功能全景。