Android 数据源能力调研与结构化观测设想¶

/// 观测时间窗口内的一组事件
pub struct ObservationWindow {
    /// 窗口起始时间 (epoch ms)
    pub window_start_ms: i64,
    /// 窗口结束时间 (epoch ms)
    pub window_end_ms: i64,
    /// 窗口内的事件列表
    pub events: Vec<ObservationEvent>,
}

/// 单一观测事件
pub struct ObservationEvent {
    /// 事件唯一 ID
    pub event_id: String,
    /// 事件发生时间戳 (epoch ms)
    pub timestamp_ms: i64,
    /// 事件类型
    pub event_type: EventType,
    /// 数据来源能力等级
    pub source_tier: SourceTier,
    /// 关联的 app (若可确定)
    pub app_package: Option<String>,
}

/// 数据来源能力等级
pub enum SourceTier {
    /// Tier 0: 公开 API, 普通用户授权即可
    Basic = 0,
    /// Tier 1: 无障碍服务 (权限门槛高, 电量开销大)
    Accessibility = 1,
    /// Tier 2: ADB / Shizuku (需要开发者模式)
    Developer = 2,
    /// Tier 3: Root (不在本项目范围内)
    Root = 3,
}

/// 事件类型枚举
pub enum EventType {
    AppTransition(AppTransitionEvent),
    NotificationPosted(NotificationEvent),
    NotificationInteraction(NotificationInteractionEvent),
    ScreenState(ScreenStateEvent),
    SystemState(SystemStateEvent),
    UserInteraction(UserInteractionEvent),
    WindowContent(WindowContentEvent),
    FileSystemChange(FileSystemEvent),
}

// ===== 具体事件结构 =====

/// 应用前后台切换
pub struct AppTransitionEvent {
    /// MOVE_TO_FOREGROUND / MOVE_TO_BACKGROUND
    pub transition: AppTransition,
    /// 触发此事件的 Activity 类名 (可能为空)
    pub activity_class: Option<String>,
}

/// 通知到达
pub struct NotificationEvent {
    /// 通知来源 app
    pub source_package: String,
    /// 通知类别 (Android category 原始值, 如 "msg", "email", "social")
    pub category: Option<String>,
    /// 通知渠道 ID
    pub channel_id: Option<String>,
    /// 脱敏后的通知标题 (仅保留长度、语言类别, 不保留原文)
    pub title_hint: Option<TextHint>,
    /// 脱敏后的通知正文 (仅保留长度、语言类别, 不保留原文)
    pub text_hint: Option<TextHint>,
    /// 从正文中提取的脱敏关键词 (如 "文件", "图片", "语音", "链接")
    pub semantic_hints: Vec<SemanticHint>,
    /// 通知是否持续显示 (ongoing)
    pub is_ongoing: bool,
    /// 通知分组 key
    pub group_key: Option<String>,
    /// 通知是否包含进度条
    pub has_progress: bool,
    /// 通知是否包含图片
    pub has_picture: bool,
}

/// 脱敏后的文本提示 (不传输原文)
pub struct TextHint {
    /// 文本长度
    pub length_chars: usize,
    /// 主要书写系统 (Latin, Hanzi, Cyrillic, Arabic, etc.)
    pub script: ScriptHint,
    /// 是否为纯 emoji
    pub is_emoji_only: bool,
}

/// 从通知文本中提取的语义标签 (在本地完成, 不上传原文)
pub enum SemanticHint {
    /// "文件" / "file" / "pdf" / "docx" 等关键词
    FileMention,
    /// "图片" / "照片" / "截图" 等关键词
    ImageMention,
    /// 音频/语音消息
    AudioMessage,
    /// 链接/URL
    LinkAttachment,
    /// "@我" / 被提及
    UserMentioned,
    /// 会议/日历邀请
    CalendarInvitation,
}

/// 用户与通知的交互
pub struct NotificationInteractionEvent {
    pub notification_key: String,
    pub action: NotificationAction,
}

pub enum NotificationAction {
    /// 用户点击通知
    Tapped,
    /// 用户清除通知
    Dismissed,
    /// 系统自动取消
    Cancelled,
    /// 通知已被查看 (NOTIFICATION_SEEN)
    Seen,
}

/// 屏幕状态变化
pub struct ScreenStateEvent {
    pub state: ScreenState,
}

pub enum ScreenState {
    Interactive,     // 亮屏 + 解锁
    NonInteractive,  // 灭屏
    KeyguardShown,   // 锁屏显示
    KeyguardHidden,  // 锁屏隐藏
    UserUnlocked,    // 用户解锁设备
}

/// 系统状态快照 (周期性采集, 非事件驱动)
pub struct SystemStateEvent {
    /// 电量百分比 (0-100)
    pub battery_pct: Option<u8>,
    /// 是否充电中
    pub is_charging: bool,
    /// 网络类型
    pub network: NetworkType,
    /// 铃声模式
    pub ringer_mode: RingerMode,
    /// 粗粒度地点类别
    pub location_type: LocationType,
    /// 是否连接耳机
    pub headphone_connected: bool,
    /// 是否连接蓝牙
    pub bluetooth_connected: bool,
}

/// 用户交互事件 (仅 Tier 1: AccessibilityService)
pub struct UserInteractionEvent {
    /// 点击/长按/滑动
    pub action: InteractionAction,
    /// 被交互的 UI 元素的脱敏描述
    pub target_hint: Option<TargetHint>,
}

/// 窗口内容摘要 (仅 Tier 1: AccessibilityService)
/// 不上传完整 UI 树, 仅上传聚合后的语义描述
pub struct WindowContentEvent {
    /// 当前前台 app
    pub package_name: String,
    /// 窗口标题 (脱敏)
    pub window_title_hint: Option<TextHint>,
    /// 当前 UI 的语义类型推断
    pub ui_type_hint: Option<UiTypeHint>,
    /// UI 中出现的脱敏语义标签列表
    pub semantic_labels: Vec<SemanticHint>,
}

/// 文件系统变化 (Tier 0: ContentObserver)
pub struct FileSystemEvent {
    /// 变化的目录或 URI
    pub path_pattern: String,
    /// 文件扩展名 (如 "pdf", "docx")
    pub extension: Option<String>,
    /// 变化类型
    pub change_type: FileChangeType,
}

// ===== 辅助枚举 =====

pub enum AppTransition {
    Foreground,
    Background,
}

pub enum NetworkType {
    Wifi,
    Cellular,
    Offline,
    Unknown,
}

pub enum RingerMode {
    Normal,
    Vibrate,
    Silent,
}

pub enum LocationType {
    Home,
    Work,
    Commute,
    Unknown,
}

pub enum ScriptHint {
    Latin,
    Hanzi,      // 汉字
    Cyrillic,
    Arabic,
    Mixed,
    Unknown,
}

pub enum UiTypeHint {
    ChatList,
    ChatDetail,
    FilePreview,
    Settings,
    WebView,
    VideoCall,
    Unknown,
}

pub enum InteractionAction {
    Tap,
    LongPress,
    Swipe,
    Scroll,
    KeyPress,
}

pub enum TargetHint {
    Button,
    TextField,
    Image,
    Link,
    ListItem,
    Unknown,
}

pub enum FileChangeType {
    Created,
    Modified,
    Deleted,
}