dootask/resources/ai-kb/zh/concept/push-notice/alias.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
push-notice.alias.concept	友盟 Alias 用户绑定	concept	push-notice	end-user	zh	UmengAlias 友盟别名 设备绑定 推送绑定 怎么收到推送 推送目标			管理员已开启 APP 推送 用户在移动端 APP 已登录	Web 端 / 桌面端不写 UmengAlias 表，因此不通过友盟推送 别名 30 天未活跃即不再用于推送（updated_at 过期） 调试模式（isDebug=1）的 APP 不会注册别名，避免污染生产推送	v1.7.90

友盟 Alias 用户绑定

定义

umeng_alias 是 DooTask 用来记录「某用户的某台移动设备应该接收哪些推送」的绑定表。每次移动 APP 启动登录后会调用 api/users/umeng/alias 注册或更新这条记录，后端按 userid → alias 反向查到所有活跃设备来发推送。

关键字段

字段	说明
userid	DooTask 用户 ID
alias	友盟 alias，用户在友盟侧的唯一标识
platform	ios / android（其他平台调用会被拒）
device	设备型号
device_hash	设备指纹，关联 UserDevice 表
version	APP 版本号（含 versionName）
ua	userAgent
is_notified	系统通知权限（0=未授予 / 1=已授予）
updated_at	最后活跃时间；超过 30 天的别名不再被推送选中

注册逻辑

APP 启动 → 调 api/users/umeng/alias?action=update：

1. 校验 platform 必须是 ios / android
2. 校验 alias 长度 2-20 字符
3. 校验 isDebug=0（调试模式拒绝）
4. 表里同 userid + alias + platform 存在则更新；不存在则插入

退出登录时可调 action=remove 删别名。

多设备规则

• 同一 userid 可绑定多台设备，每个设备一条记录
• 推送时按 platform 分组，每个用户每平台最多取最近 5 个 alias 一起发（按 updated_at 倒序）
• 角标数取自该用户未读且非静默消息总数（WebSocketDialogMsgRead）

解绑

• 用户卸载 APP 后系统不会主动删除别名记录；该别名后续推送会在友盟侧失败，不影响其他设备
• 30 天未活跃自动从推送目标中剔除（但记录仍在表里）
• 管理员可在数据库直接清理 umeng_alias