统一约定

公共参数默认注入：device_id、platform、app_version、os_version、os_type、device_model、network_type、screen_resolution、session_id、user_id（未登录场景可为空）。

页面曝光类事件统一支持可选参数：duration（页面停留时长，单位秒）。

任务栏功能入口统一复用事件：pc_taskbar_item_click，通过 item_name 区分具体入口。

桌面菜单点击统一复用事件：pc_desktop_menu_click，通过 menu_name 区分具体入口。

桌面信息卡片点击统一复用事件：pc_desktop_card_click，通过 card_name 区分卡片类型。

涉及账号、设备序列号等敏感信息时，统一使用脱敏字段，如：current_account_masked、device_sn_masked。

事件名称	事件编码	触发场景	业务参数	公共参数
登录页曝光	pc_login_page_view	用户打开客户端或会话过期进入登录页，页面首屏完成渲染	referrer、has_history_account、default_login_type、duration	默认公共参数
登录按钮点击	pc_login_submit_click	用户填写完账号密码点击登录	has_account、has_password、remember_pw_checked、auto_login_checked	默认公共参数
登录鉴权状态	pc_login_result	登录接口返回成功/失败结果	success、error_code、error_msg、login_method、request_duration	默认公共参数
设备查找页	pc_login_device_page_view	用户在登录前进入设备查找/设备列表页	discovery_source、device_count、has_bound_device、last_selected_device、duration	默认公共参数
设备初始化页面曝光	pc_wizard_start_page_view	用户首次绑定设备后进入初始化引导开始页	entry_source、is_first_init、device_model_code、duration	默认公共参数
设备初始化-配置远程访问	pc_wizard_remote_service_page_view	用户进入远程访问配置步骤页	default_status、support_remote_service、device_sn_masked、duration	默认公共参数
设备初始化_配置存储池	pc_wizard_storage_pool_page_view	用户进入存储池配置步骤页	disk_count、total_capacity、recommended_raid_type、duration	默认公共参数
桌面首页访问	pc_desktop_page_view	用户登录成功进入桌面首页，或从其他页面返回桌面	referrer、widget_count、wallpaper_type、desktop_mode、duration	默认公共参数
任务栏_回到桌面按钮点击	pc_taskbar_item_click	用户点击任务栏“回到桌面”按钮	item_name=show_desktop、from_page、window_count	默认公共参数
任务栏_应用抽屉按钮点击	pc_taskbar_item_click	用户点击任务栏“应用抽屉”按钮	item_name=apps_drawer、from_page	默认公共参数
任务栏_文件管理按钮点击	pc_taskbar_item_click	用户点击任务栏“文件管理”按钮	item_name=file_manager、from_page	默认公共参数
任务栏_资源管理按钮点击	pc_taskbar_item_click	用户点击任务栏“资源管理”按钮	item_name=resource_manager、from_page	默认公共参数
任务栏_用户头像点击	pc_taskbar_item_click	用户点击任务栏用户头像/账户入口	item_name=user_avatar、from_page、current_account_masked	默认公共参数
任务栏_关闭窗口按钮点击	pc_taskbar_item_click	用户点击当前窗口关闭按钮	item_name=close_window、window_type、window_count	默认公共参数
任务栏_最小化窗口按钮点击	pc_taskbar_item_click	用户点击当前窗口最小化按钮	item_name=minimize_window、window_type、window_count	默认公共参数
任务栏_最大化窗口按钮点击	pc_taskbar_item_click	用户点击当前窗口最大化按钮	item_name=maximize_window、window_type、window_count	默认公共参数
桌面首页_设备信息卡片点击	pc_desktop_card_click	用户点击桌面首页设备信息卡片	card_name=device_info、position、device_status	默认公共参数
桌面首页_资源监控信息卡片点击	pc_desktop_card_click	用户点击桌面首页资源监控卡片	card_name=resource_monitor、position、resource_type	默认公共参数
桌面首页_存储卡片点击	pc_desktop_card_click	用户点击桌面首页存储卡片	card_name=storage、position、storage_usage	默认公共参数
桌面首页_影视卡片点击	pc_desktop_card_click	用户点击桌面首页影视卡片	card_name=media、position、content_count	默认公共参数
桌面首页_相册卡片点击	pc_desktop_card_click	用户点击桌面首页相册卡片	card_name=album、position、photo_count	默认公共参数
桌面首页_常用应用卡片内应用点击	pc_desktop_app_click	用户点击桌面首页常用应用卡片中的应用	source_card=favorite_apps、app_id、app_name、position	默认公共参数
桌面首页_编辑常用应用按钮点击	pc_desktop_common_apps_edit_click	用户点击编辑常用应用按钮	current_app_count、from_page=desktop_home	默认公共参数
桌面首页_编辑常用应用弹窗曝光	pc_desktop_common_apps_edit_popup_view	用户打开编辑常用应用弹窗	current_app_count、recommended_app_count、duration	默认公共参数
桌面首页_常用最近安装应用卡片内应用点击	pc_desktop_app_click	用户点击最近安装应用卡片中的应用	source_card=recent_installed_apps、app_id、app_name、position	默认公共参数
桌面首页_桌面菜单曝光	pc_desktop_context_menu_view	用户在桌面空白区右键打开桌面菜单	menu_count、entry_method=right_click、duration	默认公共参数
桌面菜单_编辑桌面按钮点击	pc_desktop_menu_click	用户点击桌面菜单“编辑桌面”	menu_name=edit_desktop、from_page=desktop_menu	默认公共参数
桌面菜单_个性化按钮点击	pc_desktop_menu_click	用户点击桌面菜单“个性化”	menu_name=personalization、from_page=desktop_menu	默认公共参数
桌面菜单_客户端设置按钮点击	pc_desktop_menu_click	用户点击桌面菜单“客户端设置”	menu_name=settings、from_page=desktop_menu	默认公共参数
桌面菜单_设备重启按钮点击	pc_desktop_menu_click	用户点击桌面菜单“设备重启”并拉起确认流程	menu_name=reboot_device、from_page=desktop_menu、need_confirm=true	默认公共参数
桌面菜单_设备重启结果	pc_device_power_action_result	设备重启请求返回结果	action=reboot、success、error_code、request_duration	默认公共参数
桌面菜单_设备关机按钮点击	pc_desktop_menu_click	用户点击桌面菜单“设备关机”并拉起确认流程	menu_name=shutdown_device、from_page=desktop_menu、need_confirm=true	默认公共参数
桌面菜单_设备关机结果	pc_device_power_action_result	设备关机请求返回结果	action=shutdown、success、error_code、request_duration	默认公共参数
桌面菜单_退出登录按钮点击	pc_desktop_menu_click	用户点击桌面菜单“退出登录”并拉起确认流程	menu_name=logout、from_page=desktop_menu、need_confirm=true	默认公共参数
桌面菜单_退出登录结果	pc_logout_result	用户确认退出登录后，退出流程完成并返回结果	success、logout_type、session_duration、error_code、request_duration	默认公共参数
应用抽屉页曝光	pc_apps_page_view	用户进入所有应用页面（桌面应用抽屉）	default_category、app_count、entry_source、duration	默认公共参数
桌面编辑态页面曝光	pc_desktop_edit_page_view	用户进入桌面编辑态页面	widget_count、editable_widget_count、duration	默认公共参数
客户端设置页曝光	pc_settings_page_view	用户进入客户端设置页	default_tab、entry_source、duration	默认公共参数
客户端设置保存结果	pc_settings_save_result	用户保存客户端设置后返回结果	success、modified_count、modified_tabs、error_code、request_duration	默认公共参数
桌面组件添加点击	pc_desktop_widget_add_click	用户点击添加桌面组件	widget_type、entry_source、current_widget_count	默认公共参数
桌面组件拖拽完成	pc_desktop_widget_drag_complete	用户拖拽调整桌面组件位置完成	widget_type、from_position、to_position、layout_mode	默认公共参数

结果事件补充说明

事件编码	建议触发时机	说明
pc_device_power_action_result	设备重启/关机接口返回后	用于统计高风险操作成功率、失败原因、接口耗时
pc_logout_result	退出登录接口返回/本地态清理完成后	用于统计退出成功率、会话时长
pc_settings_save_result	设置保存接口返回/本地配置写入完成后	用于统计设置保存成功率、失败率和耗时

落地备注

1. 若当前埋点 SDK 不支持自动采集 duration，建议在页面 show/hide 或 focus/blur 生命周期中自行计算。
2. request_duration 建议统一单位为毫秒，duration 统一单位为秒，避免混淆。
3. error_code 仅记录系统定义错误码，不记录包含隐私信息的服务端原始报文。
4. position 建议统一约定：卡片类用序号，桌面组件类用网格坐标，如 2,1。
5. 如后续补充任务栏更多能力，建议继续复用 pc_taskbar_item_click，仅扩展 item_name 枚举值即可。