没有仪表板的网页分析：AI代理是主要用户，却有个3D地球

你见过为AI代理打造的网站分析工具吗？它没有登录页、没有折线图、没有筛选按钮，把命令行和JSON输出当作主要消费界面。这款名为 Vigie 的开源平台，设计逻辑彻底颠覆了“报表”的认知：既然日常写代码、发邮件、提issue的都是自动化脚本，为什么分析结果还要人盯着看？

作者在博客里讲了一个场景：团队里接替网站分析任务的，全是 agent。这些程序需要的不是华丽仪表板，而是能直接在 stdout 吐 JSON 的接口、语义化的退出码，以及一条命令就能取回页面浏览、访客、跳出率，甚至城市坐标。于是就有了 stats overview --site example.com --since 7d 这样的指令，返回 {"ok":true,"data":{"pageviews":1234,"visitors":410,"bounce_rate_pct":38,...}}。整个过程，人一眼都不需要看浏览器。

这种设计并非标新立异，而是在解决一个被长期忽略的痛点。几乎所有隐私优先的分析工具——Plausible、Fathom、Rybbit，仍然默认必须有一个人类登录到炫酷的仪表板前。可现实是，大量监控和运营动作早已交给 CI 流水线。网站流量异常时，机器人要能直接拉出旅程分析，自动判断是否某个渠道出了问题；核心页面性能衰退时，得能一把捞出 LCP、FCP、CLS、INP 等 Web Vitals 的百分位数据，而不是让开发者手动打开 dashboard 拼凑线索。

它为这类自动化场景提供了直接的接口：cities 命令返回城市级经纬度坐标，journeys 把桑基图做成 JSON 扔给你，vitals 直接给出 P50/P75/P90 的百分位数据。cron 作业、部署脚本、告警 bot，全都可以在一行命令后立即做出下一步动作。

如果人类非要“看到”点什么，这个工具给出的不是动态仪表盘，而是一页完整的统计快照。一条 snapshot --publish 命令，会把全部 22 个分析板块——包括用户旅程、渠道来源、热力图、Web Vitals、错误日志、城市地理分布等——打包渲染成一个自包含的 HTML 文件，发布到指定的 artifact 宿主。页面会定时重新生成，永不陈旧，并且没有前端服务器在后台跑。可以把它当成一张永远冻结在某个时间点的完整数据海报，任何人打开链接就能看到，零依赖、零登录。作者还放出了一个用合成数据填满的演示页面，可以直观看到从 session 计数到地理散点图的完整布局。

最出格的部分是一个纯手绘的 3D 地球仪。它用了 canvas 数学直接画点，没有任何前端框架，城市级的光点从实时数据流中重绘。作者的描述是“把流量变成一座活的星球”，不为了分析，只是为了满足某种对数据的审美。

而这些功能全部跑在一个约 300 KB 的二进制文件里。这个二进制集成了 HTTP 接入、SQLite 存储、统计引擎、地球渲染器以及命令行界面，全部用 MFL 语言编写，没有任何 Node.js、ClickHouse、Docker 的踪迹。这意味着你不需要单独维护数据库集群，也不用操心容器编排，把它扔到任何一台服务器上就能直接对外提供分析接入。

地理位置解析同样挑战了传统服务依赖。通常要拿到城市级访客数据，你必须对接某个收费的地理 IP SaaS。该平台直接在 300 行左右的 MFL 代码里从头实现了一个 MaxMind DB（.mmdb）文件读取器，用于读取 CC BY 授权的 DB-IP City Lite 数据库。代码自己走了二叉树遍历，解析了数据区的索引结构，没有借助任何第三方库。这样一来，IP 到城市坐标的转换全部发生在本地，数据不会离开自己的机器。

更值得留意的是它的无 cookie 设计。平台不存储原始 IP，只运行一次 sha256(secret + day + site + ip + ua)，然后用这个哈希作为访客标识。秘钥每日轮换，哈希结果每天都重新盐化，天然隔离了跨日跟踪的可能。由于根本不保留任何可以直接追溯到个人的资料，也就不需要弹出 cookie 同意横幅。这种设计同时把隐私合规和工程复杂度一起压到了最低。

它还把 server-side 事件当成了一等公民。你可以直接用 track --name deploy --actor ci 记录一次部署事件，或者任意 cron 作业的触发。这样一来，不仅仅是页面浏览，所有的运维操作也能汇入同一套分析数据流中。让人惊叹的是，整个工具几乎全由 agent 在一天内构建完成，过程中还找出了三个编译器 bug——包括字符串字面量的处理问题——这或许正是 AI 代理作为主要用户的时代，分析工具该有的样子。