john
871688550e
Memind CI / Test, build, and release guards (push) Has been cancelled
同步 Analytics 发布 runbook 与 admin 默认 PUBLIC_HOST，与 memind_adm 生产入口一致。 Co-authored-by: Cursor <cursoragent@cursor.com>
51 lines
2.3 KiB
Markdown
51 lines
2.3 KiB
Markdown
# 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`。
|