token-optimization-benchmark/docs/local-analytics.md

# Local Memind analytics (Umami)

> **Rybbit 已退役**，见 [analytics-platform.md](analytics-platform.md)。下文仅描述 Umami。

Memind 通过同源 `/analytics/*` 代理本地或远程 Umami 服务（默认 `http://127.0.0.1:3100`）。

```dotenv
MEMIND_ANALYTICS_ENABLED=true
MEMIND_ANALYTICS_URL=http://127.0.0.1:3100
MEMIND_ANALYTICS_WEBSITE_ID=<website-id>
MEMIND_ANALYTICS_ID_SECRET=<random-local-secret>
MEMIND_ANALYTICS_IDENTITY_MODE=pseudonymous
MEMIND_ANALYTICS_DOMAINS=127.0.0.1,localhost
```

`MEMIND_ANALYTICS_IDENTITY_MODE=raw` 仅在明确批准的第一方分析环境中使用；其他环境保持 pseudonymous 默认。

## Product shell（独立 Website）

为 Memind 产品壳（H5 SPA）创建第二个 Umami Website，避免聊天与导航事件污染生成页 PV：

```dotenv
MEMIND_PRODUCT_ANALYTICS_ENABLED=true
MEMIND_PRODUCT_ANALYTICS_WEBSITE_ID=<product-website-id>
```

产品壳 tracker 同样走 `/analytics/script.js`，记录 SPA 路由 PV、`product_click` 与 10/30 秒参与事件。

## SEO / GEO 发现流量

公开页 Umami 事件附带 `discovery_channel`（`seo` / `geo` / `direct` / `referral`）与 `discovery_source`。memind_adm **Analytics → SEO / GEO 流量** 看板按页展示 SEO 与 GEO 来源的浏览明细（口径与 Umami「生成页明细」一致）。

## 管理后台

- **memind_adm → Analytics 配置**：Umami Website ID、密钥、SSO 入口
- **memind_adm → SEO / GEO 流量**：按页监控搜索引擎 / 生成式引擎来源访问

生产发布与环境变量见 memind_adm [`docs/analytics-deploy.md`](../../memind_adm/docs/analytics-deploy.md)。  
跨仓库发布顺序见 [analytics-release-runbook.md](analytics-release-runbook.md)。

Analytics 服务 fail-open：未配置或 Umami 不可用时，页面生成与交付不受影响。勿向终端用户暴露 Umami 控制台。
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								# Local Memind analytics (Umami)
-											feat(mindspace): add opt-in local analytics
										
										
											2026-07-16 21:06:28 +08:00
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								> **Rybbit 已退役**，见 [analytics-platform.md](analytics-platform.md)。下文仅描述 Umami。
-											feat(mindspace): add opt-in local analytics
										
										
											2026-07-16 21:06:28 +08:00
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								Memind 通过同源 `/analytics/*` 代理本地或远程 Umami 服务（默认 `http://127.0.0.1:3100`）。
-											feat(mindspace): add opt-in local analytics
										
										
											2026-07-16 21:06:28 +08:00
-											feat: harden orchestrator execution runtime
										
										
											2026-07-24 23:53:32 +08:00
+								```dotenv
 								MEMIND_ANALYTICS_ENABLED=true
 								MEMIND_ANALYTICS_URL=http://127.0.0.1:3100
 								MEMIND_ANALYTICS_WEBSITE_ID=<website-id>
 								MEMIND_ANALYTICS_ID_SECRET=<random-local-secret>
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								MEMIND_ANALYTICS_IDENTITY_MODE=pseudonymous
-											feat: harden orchestrator execution runtime
										
										
											2026-07-24 23:53:32 +08:00
+								MEMIND_ANALYTICS_DOMAINS=127.0.0.1,localhost
 								```
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								`MEMIND_ANALYTICS_IDENTITY_MODE=raw` 仅在明确批准的第一方分析环境中使用；其他环境保持 pseudonymous 默认。
-											feat: add attributable page analytics
										
										
											2026-07-20 20:49:44 +08:00
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								## Product shell（独立 Website）
 								为 Memind 产品壳（H5 SPA）创建第二个 Umami Website，避免聊天与导航事件污染生成页 PV：
-											feat: track Memind product analytics
										
										
											2026-07-20 20:19:52 +08:00
 								```dotenv
 								MEMIND_PRODUCT_ANALYTICS_ENABLED=true
 								MEMIND_PRODUCT_ANALYTICS_WEBSITE_ID=<product-website-id>
 								```
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								产品壳 tracker 同样走 `/analytics/script.js`，记录 SPA 路由 PV、`product_click` 与 10/30 秒参与事件。
-											feat(mindspace): add opt-in local analytics
										
										
											2026-07-16 21:06:28 +08:00
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								## SEO / GEO 发现流量
-											feat(mindspace): add opt-in local analytics
										
										
											2026-07-16 21:06:28 +08:00
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								公开页 Umami 事件附带 `discovery_channel`（`seo` / `geo` / `direct` / `referral`）与 `discovery_source`。memind_adm **Analytics → SEO / GEO 流量** 看板按页展示 SEO 与 GEO 来源的浏览明细（口径与 Umami「生成页明细」一致）。
-											fix: inject Rybbit tracking on m.tkmind.cn publication pages
										
										
											2026-07-27 22:10:07 +08:00
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								## 管理后台
-											feat: harden orchestrator execution runtime
										
										
											2026-07-24 23:53:32 +08:00
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								- **memind_adm → Analytics 配置**：Umami Website ID、密钥、SSO 入口
 								- **memind_adm → SEO / GEO 流量**：按页监控搜索引擎 / 生成式引擎来源访问
-											feat: harden orchestrator execution runtime
										
										
											2026-07-24 23:53:32 +08:00
-											docs: add analytics release runbook and 105 Umami topology
										
										
											2026-08-10 16:21:57 +08:00
+								生产发布与环境变量见 memind_adm [`docs/analytics-deploy.md`](../../memind_adm/docs/analytics-deploy.md)。
 								跨仓库发布顺序见 [analytics-release-runbook.md](analytics-release-runbook.md)。
-											feat(analytics): retire Rybbit and add SEO/GEO discovery tracking
										
										
											2026-08-12 01:34:05 +08:00
+								Analytics 服务 fail-open：未配置或 Umami 不可用时，页面生成与交付不受影响。勿向终端用户暴露 Umami 控制台。