浅念
22d89a3f42
SDK：buildEnvContext 同步扩展 12 键（dpr/viewport/orientation/maxTouchPoints/ deviceMemory/languages/colorScheme/standalone/network downlink·rtt·saveData/ 微信版本），逐键 try/catch 静默缺则不挂；新增 collectHighEntropyHints（UA-CH model/platformVersion/architecture/bitness），init 后 Promise.race 2s 超时 异步并入 __ctk_ctx——批次 context flush 时读取，不阻塞首屏。 后端：Visitor 加 device_model/env_extra（迁移 0005）；ingest 首批快照 EXTENDED_ENV_KEYS 白名单（值截 100），非首批不覆盖、唯 device_model 空且 本批有值时补填一次（晚到 hints）；列表/详情 API 随行输出。 前端：详情访问环境卡设备行升级显示型号（手机 · Pixel 7），追加像素比/ 视口/屏幕方向/触点/内存/网络质量/深浅色/微信版本行（env_extra 逐键判空， 旧数据整块不显示）；列表设备列主行拼型号（手机·Pixel 7）。 Co-Authored-By: Claude Code <noreply@anthropic.com>
58 lines
3.4 KiB
Python
58 lines
3.4 KiB
Python
EVENT_NAMES = {"page_view", "page_stay", "sdk_loaded"}
|
||
MAX_EVENTS_PER_BATCH = 50
|
||
MAX_PROP_KEYS = 32
|
||
MAX_STR_LEN = 500
|
||
MAX_PATH_LEN = 500
|
||
MAX_TITLE_LEN = 200
|
||
CLOCK_SKEW_LATE_SEC = 120 # 超过即标 late
|
||
CLOCK_SKEW_REJECT_SEC = 86400 # 超过即拒绝
|
||
SENSITIVE_KEY_PATTERNS = ("password", "passwd", "token", "secret", "card", "verif", "otp", "idcard")
|
||
URL_PARAM_DROP_PATTERNS = ("email", "phone", "mobile", "token", "key", "password", "verif")
|
||
SESSION_IDLE_MS = 30 * 60 * 1000
|
||
BOT_UA_KEYWORDS = ("bot", "spider", "crawl", "slurp", "bingpreview", "headless", "lighthouse")
|
||
EVENT_PROP_WHITELIST = { # spec §9.1：未知字段拒绝。免费文本/任意属性不得入库
|
||
"page_view": {"referrer", "referrer_domain", "utm", "nav_type", "prerendering"},
|
||
"page_stay": {"active_ms", "path"},
|
||
"sdk_loaded": {"sdk_version"},
|
||
}
|
||
MAX_PROP_DEPTH = 2
|
||
MAX_PROP_JSON_BYTES = 4096
|
||
EXTENDED_ENV_KEYS = { # SDK 扩展环境键白名单（Visitor.env_extra 快照，展示用）：
|
||
"device_pixel_ratio", "viewport", "orientation", "max_touch_points", "device_memory", # 设备形态
|
||
"languages", "color_scheme", "standalone", # 偏好/宿主
|
||
"network_downlink", "network_rtt", "save_data", "wechat_version", # 网络/宿主
|
||
"device_model", "platform_version", "architecture", "bitness", # UA-CH 高熵
|
||
}
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# 来源归因规则库 v1（tracker/services/attribution.py 消费）。改规则必须 bump 版本号
|
||
# 并跑 recompute_attribution 重算历史——已落库分类带 rule_version 可追溯。
|
||
# ---------------------------------------------------------------------------
|
||
ATTRIBUTION_RULE_VERSION = "v1"
|
||
AI_REFERRAL_DOMAINS = { # AI 平台 → 显示名
|
||
"chatgpt.com": "ChatGPT", "perplexity.ai": "Perplexity",
|
||
"copilot.microsoft.com": "Copilot", "gemini.google.com": "Gemini",
|
||
"deepseek.com": "DeepSeek", "claude.ai": "Claude", "poe.com": "Poe", "you.com": "You",
|
||
}
|
||
SEARCH_ENGINE_DOMAINS = { # 引擎后缀/域名 → 显示名（"google."/"yandex." 前缀匹配任意国家站 TLD）
|
||
"google.": "Google", "bing.com": "Bing", "baidu.com": "百度", "yandex.": "Yandex",
|
||
"duckduckgo.com": "DuckDuckGo", "yahoo.com": "Yahoo", "ecosia.org": "Ecosia",
|
||
"search.naver.com": "Naver", "search.brave.com": "Brave",
|
||
}
|
||
SEARCH_TERM_PARAMS = { # 引擎 → referrer URL 里的搜索词参数名（白名单提取）
|
||
"Bing": ["q"], "百度": ["wd", "word"], "DuckDuckGo": ["q"], "Yandex": ["text"],
|
||
"Ecosia": ["q"], "Yahoo": ["p"], "Brave": ["q"], "Naver": ["query"],
|
||
} # 注：Google 不提供，绝不虚构
|
||
PAID_CLICK_PARAMS = {"gclid": "Google Ads", "fbclid": "Meta Ads",
|
||
"msclkid": "Bing Ads", "yclid": "Yandex Ads"}
|
||
SOCIAL_DOMAINS = {
|
||
"t.co": "Twitter/X", "twitter.com": "Twitter/X", "x.com": "Twitter/X",
|
||
"facebook.com": "Facebook", "linkedin.com": "LinkedIn", "instagram.com": "Instagram",
|
||
"vk.com": "VK", "reddit.com": "Reddit", "pinterest.com": "Pinterest",
|
||
"telegram.me": "Telegram", "t.me": "Telegram",
|
||
}
|
||
INAPP_UA_MARKERS = {"MicroMessenger": "微信", "Line/": "Line", "FBAN": "Facebook",
|
||
"FBAV": "Facebook", "Instagram": "Instagram", "WhatsApp": "WhatsApp"}
|
||
CHANNELS = ("natural_search", "paid_search", "ai_referral", "social",
|
||
"in_app", "referral", "direct", "unknown")
|