feat(analytics): retire Rybbit and add SEO/GEO discovery tracking

Document Umami as the sole analytics platform, remove Rybbit proxy and
tracker code, and classify public page traffic with discovery_channel for
adm SEO/GEO dashboards.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
john
2026-08-12 01:34:05 +08:00
parent c58a23d155
commit c122bd5664
26 changed files with 466 additions and 449 deletions
+37
View File
@@ -0,0 +1,37 @@
# Memind 访问统计平台说明
## 当前唯一平台:Umami
Memind 公开页与生成页的真实用户访问统计 **仅使用 Umami**`memind-analytics` 独立部署,生产入口 `fxi.tkmind.cn`)。
- Portal 通过同源 `/analytics/*` 代理 Umami tracker
- 管理后台(memind_adm)通过 SSO 进入 Umami,并提供 **SEO / GEO 发现流量** 专用看板
- 生成页事件维度见 `mindspace-analytics.mjs`(含 `discovery_channel` / `discovery_source`
本地配置见 [local-analytics.md](local-analytics.md)。
## 已退役:Rybbit
**Rybbit 已于 2026-08 下线,不再部署、不再注入 tracker、不再提供 SSO。**
历史背景:Rybbit 曾作为 Umami 并行的行为分析方案(`/rybbit/*` 代理、`MEMIND_RYBBIT_*` 环境变量、memind_adm Rybbit SSO)。该方案已废弃。
**禁止**在新代码、文档、环境变量示例或运维脚本中重新引入 Rybbit 相关配置。若看到遗留引用,应删除而非「可选保留」。
## SEO / GEO 流量口径
| 字段 | 含义 |
|------|------|
| `discovery_channel` | `seo`(搜索引擎)/ `geo`(生成式引擎)/ `direct` / `referral` |
| `discovery_source` | 具体来源,如 `google``baidu``chatgpt``perplexity` |
| `referrer_host` | 外部 referrer 域名(不含路径) |
分类逻辑见 `mindspace-analytics-discovery.mjs`。Shell + iframe 场景会通过 `memind_discovery` 查询参数向内层传播来源。
## 相关仓库
| 仓库 | 职责 |
|------|------|
| **Memind** | tracker 注入、discovery 分类、Umami 代理 |
| **memind-analytics** | Umami 定制部署、`memind-pages` APIoverlay 在 `deploy/umami/overlay/` |
| **memind_adm** | Analytics 配置、SEO/GEO 看板、Umami SSO |