# 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` API（overlay 在 `deploy/umami/overlay/`） |
| **memind_adm** | Analytics 配置、SEO/GEO 看板、Umami SSO |

## 生产发布

跨仓库顺序与命令见 **[analytics-release-runbook.md](analytics-release-runbook.md)**。

| 步骤 | 仓库 | 命令 |
|------|------|------|
| 1 | memind-analytics | `bash scripts/release-umami-105.sh --yes` |
| 2 | Memind（103 Portal） | `bash scripts/release-portal-runtime-prod.sh --yes` |
| 3 | memind_adm（103 · md.tkmind.cn） | `bash scripts/release-prod.sh --yes` |

105 Umami 细节见 memind-analytics 仓库 `deploy/105-runbook.md`。  
md.tkmind.cn Analytics 环境变量见 memind_adm `docs/analytics-deploy.md`。