1k-analytics

name	1k-analytics
description	OneKey analytics and server event tracking with LogToServer, logger scopes/scenes, and business metrics. Use for 埋点, analytics, or tracking events.
allowed-tools	Read, Grep, Glob

Analytics Event Tracking

OneKey uses a decorator-based logger system to track user behavior events. Events are routed to the analytics server (Mixpanel) via @LogToServer() decorator on scene methods. NEVER call analytics.trackEvent() directly.

Quick Reference

Topic	Guide	Key Files
Adding events	adding-events.md	packages/shared/src/logger/scopes/
Architecture	architecture.md	packages/shared/src/logger/base/
Common pitfalls	pitfalls.md	—

Critical Rules

1. MUST use @LogToServer() decorator — never call analytics.trackEvent() directly
2. Event method names use camelCase — the method name becomes the event name sent to Mixpanel
3. Methods MUST return params synchronously — never return a Promise
4. Deduplicate high-frequency events — prevent Mixpanel usage spikes (e.g., use in-memory Set for per-session dedup)