evstats

外观

在线演示源码

2026 年 9 月 ​

本月的需求新增、功能调整与文档变化。

2026-09-28 ​

  • 在线演示地址改为 https://evstats-dash-demo.mosong.cc，官网导航、页脚和文档里的入口都指向这里。
  • 管理界面和官网镜像的编译阶段改为在构建机的架构上只跑一次，linux/amd64 与 linux/arm64 两个镜像共用同一份静态文件，多架构构建时不再在模拟器里重复安装依赖、重复编译。

2026-09-27 ​

  • 自动化测试入口 evs-test 启动前按 go.mod、package.json、pom.xml 检查 Go、Node 与 Yarn、JDK 的版本，本机版本不符时自动下载到 ~/sdk 并只给这次运行用，不再因为系统里的版本不对而跑到一半失败；Makefile 和服务端测试不再强制 GOTOOLCHAIN=local，也不使用外面传进来的 GOROOT。
  • 换用新标识「墨松」（松树、上扬的趋势线与一笔圆）：管理界面左上角与登录页、官网导航与页脚、浏览器标签页图标、分享卡片和 README 统一更新，界面里的标识按浅色、深色外观各用一套配色，另外补上 favicon.ico 与 iOS 主屏幕图标。
  • 保存 IP 库地址时，代理 fake-ip 网段 198.18.0.0/15 不再被当成内网拒绝，推荐地址在 Clash、Surge 等环境下可以保存。回环、私网和云元数据地址仍然拒绝。
  • 首次引导多了第二步：建好超级管理员后可以选择创建「演示项目」，服务端当场生成约 1 万条示例数据，写完自动进入，每个分析页一进来就有数据，停用后不会再建。
  • 管理员在项目的「接入」页签输入登录密码就能查看完整的写入密钥，输错 5 次锁 10 分钟，每次查看都记操作日志。
  • 没配 IP 库时，地域页照常显示已经带着地域的数据，只在上方提示去配置。
  • ClickHouse、Redis 和端口同时接受环境变量 EVS_CLICKHOUSE、EVS_REDIS、EVS_PORT。推荐用环境变量；同名启动参数写了且非空就覆盖。部署示例改为环境变量。旧名 EVSTATS_CH、EVSTATS_REDIS、EVSTATS_PORT、EVSTATS_HTTP_ADDR 仍然不读取。
  • 密码不再要求至少 8 位，也不再拒绝常见弱密码。任意字符都可以，空格会自动去掉。
  • 首次打开只设置超级管理员的账号、密码和确认密码，用来初始化系统。显示名、邮箱、项目和 AI 改到登录后的设置里填写。
  • 管理界面的页面地址改为 hash 形式，例如 /#/stat。找回密码邮件里的链接也改成 /#/reset。
  • 首次引导不再填写 Redis。以前保存在引导或系统配置里的 redis.uri 不再生效。ClickHouse 默认账号、口令、库名都是 evstats，Redis 默认无口令，端口默认 51321 并对所有网卡开放。
  • 服务端 Go 工具链锁定为 1.26.8，管理界面和官网的 Node 锁定为 22。
  • 官网首页页脚固定显示备案号，不再通过构建变量传入。
  • evstats 默认监听端口是 51321，对所有网卡开放；要换端口时设置 EVS_PORT 或启动参数 -port。开发时官网在 51320，仪表盘在 51322。
  • 采集地址从 /collect 改为 /sa（像素 /sa.gif）。上报参数与神策对齐：data、data_list、gzip。
  • 管理界面的接口请求改用浏览器自带的 fetch，不再依赖 axios，「关于」页的前端第三方清单相应变短。
  • 修复用 yarn dev 开发或设置了 EVS_API_BASE_URL 时，Agent 提问只显示「出错了，请稍后再试」、底部状态栏读不到版本的问题：这两处请求没有加接口基址，现在和其它接口一样统一加上。
  • Agent 回答中途因模型不可用或超时出错时，服务端日志会记一条带请求编号的错误，便于排查。
  • 二次开发文档里仪表盘的整套检查命令改为 yarn run check：Yarn 1 的 yarn check 是自带的依赖校验，不会跑这些检查。
  • Agent 的回答完整渲染 Markdown：标题、引用、代码块、分隔线、删除线、链接都显示成排版后的样式，不再露出 #、> 这类原始符号；宽表格在消息里横向滚动；链接在新窗口打开，图片不加载，显示成链接。
  • 各子项目不再提交锁文件：yarn.lock、uv.lock 由仓库根的 .gitignore 统一忽略，安装改用 yarn install、uv sync，管理界面和官网的镜像构建也不再复制锁文件；go.sum 是校验和，照常提交。

2026-09-26 ​

  • 自行构建服务端镜像时，Dockerfile 会在镜像里编译 amd64 与 arm64 二进制，不用再事先准备编译产物或管理界面。
  • 官网首页改版：按「管理界面看数、Agent 对话问数、OpenAPI 取数、SDK 采集」四种用法介绍，每种配一段真实界面的动图。
  • 首页补上专业统计能力（埋点、事件统计、漏斗、留存、路径、画像、热力图、回放、归因、A/B 实验）、系统架构图，以及「快速体验」与「生产环境」两种安装方式。
  • 文档按读者重新组织为产品、部署、使用指南、二次开发四块，参考与更新日志单列；新增文档导航、功能全景、界面一览、系统架构、生产环境部署、二进制部署和二次开发系列页面。
  • 部署相关页面从使用指南移到部署栏目，快速开始改名为快速体验。
  • 官网截图与动图改由自动化测试生成：示例数据、真实界面，浅色和深色各一套。
  • 官网成为独立项目：构建时不再从其它目录复制契约、设计变量、部署示例和 SDK；这些副本是否与源头一致由自动化测试核对。
  • 更新日志改为按月记录，每天一个日期标题，只写变更摘要。
  • 新增生产环境部署示例：ClickHouse、Redis、evstats 各自一台服务器，每台一份 Compose 文件。
  • Nginx 反代示例改为转发到本机 127.0.0.1:8080，修复与 evstats 同机时两边都要占用 80 端口的问题。
  • 仪表盘指标名旁的说明链接改为官网指标口径页的正确地址和锚点。
  • 仪表盘热力图的颜色分档改为对数刻度，与页面叠加一致，点击集中时其余区域也能看清。
  • 自动化测试入口迁入仓库的 evs-test 目录（uv 管理的 Python 项目），仪表盘浏览器场景在持续集成里运行。