Unlucky-Launcher/crates/presenter/src/host/job.rs

//! 后台任务的回流消息：`HostTask` 是唯一「线程 → host」的载荷。
//!
//! 线程只做 core 调用（网络/磁盘），产出的都是 `crate::dto` 的 DTO；
//! host 的 `tick` 把它们翻成 [`crate::dto::CoreEvent`]。
//! 这样「跨线程传的是什么」在一处看全，也不会出现半成品领域类型漏回 UI。

use std::sync::mpsc::{Receiver, Sender};

use crate::dto::{
    // 主线（M109 ContentResults / M105 LoaderKind / M113 PackEvent）与 M114 的账户轨并集。
    AccountView,
    AuthlibLoginView,
    ContentDetail,
    ContentFailure,
    ContentResults,
    DeviceLoginView,
    DiagnosisReport,
    InstallProgressView,
    InstanceId,
    InstanceRuntime,
    JavaPageView,
    LaunchFinished,
    LiveLogBatch,
    LoaderKind,
    LogLine,
    LogSession,
    NoticeView,
    PackEvent,
    SessionId,
    SkinImage,
    VersionSummary,
};
use crate::toast::Toast;

/// 后台任务 → host 的消息。
#[derive(Debug, Clone, PartialEq)]
pub enum HostTask {
    /// 版本清单（下载页）
    Versions(Result<Vec<VersionSummary>, String>),
    /// 加载器版本清单（下载页「安装选项」的下拉）
    LoaderVersions {
        /// 加载器种类
        kind: LoaderKind,
        /// 目标原版版本（缓存键的一部分，回传原样）
        mc_version: String,
        /// `Ok(最新在前)` / `Err(人读原因)`
        result: Result<Vec<String>, String>,
    },
    /// 内容库检索（M109；`Err` = 失败大类 + 一句人读原因）
    Content(Box<Result<ContentResults, ContentFailure>>),
    /// 内容库项目详情 + 版本列表（M162）：项目 id 随载荷一起回来（迟到结果靠它判）
    ContentDetail {
        /// 请求时选中的项目 id
        project: String,
        /// `Ok` = 详情；`Err` = 失败大类 + 原因
        result: Box<Result<ContentDetail, ContentFailure>>,
    },
    // M113: import/export
    /// 导入/导出（M113）：一条事件 + 任务代次
    ///
    /// 代次是 **pack 自己的一条**（`host::addon::pack` 的 `pack_epoch()`，按 host 分开），**不**与
    /// [`HostTask::Install`] 的 `CoreHost::install_epoch` 共用 —— 共用会让「关一次导入面板」
    /// 把下载页正在跑的安装静默丢掉（复审 r1 P2-7）。取消/关面板之后回来的旧事件按这条代次
    /// 丢掉，面板不会被重新点亮。
    Pack {
        /// 事件载荷（进度 / 结果 / 探测诊断 / 预检 / 完成）
        event: Box<PackEvent>,
        /// 任务代次
        epoch: u64,
    },
    /// 安装进度（高频，host 只做聚合与转发）
    Install {
        /// 进度快照
        progress: Box<InstallProgressView>,
        /// 任务代次（[`super::CoreHost`] 的 `install_epoch`）
        ///
        /// 取消/重新开工都会把代次 +1，于是**旧任务还在飞的事件**带着旧代次回来，
        /// host 一眼就能认出来并丢掉。没有这一层的话：取消后 `InstallProgress(None)` 刚把面板
        /// 收回，下一条「下载中」事件立刻把它点亮——用户看到的就是「点了取消没反应」（M105 实测）。
        epoch: u64,
    },
    /// 安装收尾（成功带实例名，失败带**大类 + 文案**）
    InstallDone {
        /// 最终进度快照
        progress: Box<InstallProgressView>,
        /// 成功时为 `Ok(实例名)`；失败时带分类（离线 ≠ 查无此项）
        result: Result<String, ContentFailure>,
        /// 任务代次（语义同 [`HostTask::Install`] 的 `epoch`）
        epoch: u64,
    },
    /// 账户列表
    Accounts(Vec<AccountView>),
    /// 设备码登录状态
    Login(Box<DeviceLoginView>),
    /// 第三方轨（authlib-injector）登录/校验状态
    Authlib(Box<AuthlibLoginView>),
    /// 账户皮肤抓取结果（`skin = None` = 没取到；UI 退回首字母块）
    Avatar {
        /// 账户 id
        id: String,
        /// 皮肤原图
        skin: Option<SkinImage>,
    },
    /// Java 页（发行版/回退链/运行时）
    Java(Box<JavaPageView>),
    /// 日志页快照（会话列表 + 选中会话的行 + 诊断）
    Logs {
        /// 会话列表
        sessions: Vec<LogSession>,
        /// 选中会话的行
        lines: Vec<LogLine>,
        /// 诊断结论
        diagnosis: Option<DiagnosisReport>,
    },
    /// 实时日志增量
    Tail(Box<LiveLogBatch>),
    /// 启动开始（pid + 会话 id）
    LaunchStarted {
        /// 实例 id
        id: InstanceId,
        /// 会话 id
        session_id: SessionId,
        /// 进程号
        pid: u32,
    },
    /// 启动阶段推进（磁贴进度环）
    Runtime {
        /// 实例 id
        id: InstanceId,
        /// 阶段状态
        runtime: InstanceRuntime,
    },
    /// 启动收尾
    LaunchEnd(Box<LaunchFinished>),
    /// 崩溃日志导入的分析结论
    Crash(Box<DiagnosisReport>),
    /// 横幅通知（隔离切换提示等）
    Notice(Box<NoticeView>),
    /// Toast
    Toast(Box<Toast>),
    /// 会话列表刷新（只换左栏）
    Sessions(Vec<LogSession>),
    /// 自更新（M159）：检查/应用的回报（载荷已翻成 DTO，见 `host::update::Report`）
    Update(Box<crate::host::update::Report>),
}

/// 后台线程用的发送端（`Sender` 克隆即可）。
pub type JobSender = Sender<HostTask>;

/// host 侧的接收端。
pub type JobReceiver = Receiver<HostTask>;

/// 建一对通道。
pub fn channel() -> (JobSender, JobReceiver) {
    std::sync::mpsc::channel()
}

/// 起一个带名字的后台线程（名字只进 panic 信息，方便定位）。
pub fn spawn(name: &str, job: impl FnOnce() + Send + 'static) -> std::thread::JoinHandle<()> {
    std::thread::Builder::new()
        .name(format!("ull-host-{name}"))
        .spawn(job)
        .unwrap_or_else(|error| panic!("起不来后台线程 {name}: {error}"))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn channel_carries_tasks_across_threads() {
        let (tx, rx) = channel();
        let handle = spawn("test", move || {
            tx.send(HostTask::Toast(Box::new(Toast {
                id: 1,
                kind: crate::toast::ToastKind::Info,
                text: "hi".to_string(),
                remaining_ms: 0,
            })))
            .expect("发送");
        });
        handle.join().expect("线程结束");
        let task = rx.recv().expect("收到");
        assert!(matches!(task, HostTask::Toast(toast) if toast.text == "hi"));
    }
}