Unlucky-Launcher/crates/cli/src/cli/model.rs

//! 命令模型（纯数据）：解析结果就是这里的一个 [`Invocation`]。

use std::path::PathBuf;

use unlucky_core::game::AdoptTarget;

/// 全局选项（所有命令共享）。
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct Globals {
    /// `--json`：机器可读输出。
    pub json: bool,
    /// `--no-color`：关闭颜色。v1 输出本身不含 ANSI，参数保留以兼容脚本。
    pub no_color: bool,
    /// `--quiet`：静默人类可读输出（错误仍进 stderr）。
    pub quiet: bool,
    /// `--data-dir <dir>`：覆盖数据根（等价 custom 模式的 `custom_root`）。
    pub data_dir: Option<PathBuf>,
}

/// 一条命令。
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum Command {
    /// 无子命令：版本摘要 + 帮助（用户原话「无子命令时 --version + --help」）。
    Welcome,
    /// 只打印版本 + 系统摘要。
    Version,
    /// 帮助（`Some(topic)` 给该子命令的帮助）。
    Help(Option<String>),
    /// `instances list`。
    InstancesList,
    /// `instances scan`：列出当前游戏根里可登记 / 不可登记的外部版本（只读，M221）。
    InstancesScan,
    /// `instances adopt <version-id> [--name N] [--isolation ...] [--game-dir DIR] [--dry-run]`。
    InstancesAdopt(InstancesAdoptArgs),
    /// `instances launch-args <instance> [--jvm …] [--game …] [--memory …] [--java …] [--backend …] [--clear]`。
    InstancesLaunchArgs(InstanceLaunchArgs),
    /// `install <version> [--loader X] [--name N]`。
    Install(InstallArgs),
    /// `pack import <file> [--target <dir>] [--name N] [--overwrite] [--no-register]`。
    PackImport(PackImportArgs),
    /// `launch <instance> [--dry-run]`。
    Launch(LaunchArgs),
    /// `sessions list [--limit N]`。
    SessionsList {
        /// 最多返回几条。
        limit: usize,
    },
    /// `logs <sid> [--tail N]`。
    Logs(LogsArgs),
    /// `diag <sid>`。
    Diag(DiagArgs),
    /// `config get [<key>]`。
    ConfigGet(ConfigGetArgs),
    /// `config set <key> <value>`。
    ConfigSet(ConfigSetArgs),
    /// `java list`。
    JavaList,
    /// `java install <major> [--vendor X]`。
    JavaInstall {
        /// 目标 JDK 主版本（8 / 17 / 21）。
        major: u32,
        /// 钉死的发行版（缺省走 D23 的回退链）。
        vendor: Option<unlucky_core::game::java::JdkVendor>,
    },
    /// `java vendors`：列出各发行版的可用性 / 镜像 / 当前优先级。
    JavaVendors,
    /// `accounts list`。
    AccountsList,
    /// `accounts add <kind> [<name>]`。
    AccountsAdd(AccountsAddArgs),
    /// `accounts remove <name>`。
    AccountsRemove {
        /// 账户名（或条目 id）。
        name: String,
    },
    /// `agent serve`：对外 MCP server（长驻）。
    AgentServe(AgentServeArgs),
    /// `update check`：查一次更新，不动任何文件。
    UpdateCheck(UpdateCheckArgs),
    /// `update apply [--dest <path>]`：下载 → 校验 → 替换（默认替换本进程 exe）。
    UpdateApply(UpdateApplyArgs),
    /// `agent config`：打印 Claude Code / Cursor 的客户端配置样例。
    AgentConfig {
        /// 覆盖端点端口（默认取设置键 `agent.mcp.port`）。
        port: Option<u16>,
    },
}

/// `update check` 的参数（现在没有选项，留一个结构体以免将来加选项时改签名）。
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct UpdateCheckArgs {}

/// `update apply` 的参数。
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct UpdateApplyArgs {
    /// 替换目标（缺省 = 本进程的 exe；取证/自定义安装位置时才给）。
    pub dest: Option<PathBuf>,
}

/// `agent serve` 的参数（命令行只做覆盖，默认值来自设置键 `agent.mcp.*`）。
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct AgentServeArgs {
    /// 走 stdio 形态（llama.cpp 内置 MCP client 用）；缺省是 Streamable HTTP。
    pub stdio: bool,
    /// 覆盖端口。
    pub port: Option<u16>,
    /// 覆盖监听地址（只接受回环地址，非回环会被 server 拒绝）。
    pub host: Option<String>,
    /// 本次运行放开写工具（仍需设置键 `agent.mcp.allow_write` 或本 flag 之一）。
    pub allow_write: bool,
}

/// `accounts add` 的轨道。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum AccountsAddKind {
    /// 离线（`add offline <name>`）。
    Offline,
    /// 微软 device-code（`add msa`，交互式）。
    Microsoft,
}

impl AccountsAddKind {
    /// 稳定名（帮助文案与 JSON 输出用）。
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Offline => "offline",
            Self::Microsoft => "msa",
        }
    }
}

/// `accounts add` 的参数。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct AccountsAddArgs {
    /// 轨道。
    pub kind: AccountsAddKind,
    /// 离线轨的玩家名（微软轨不需要）。
    pub name: Option<String>,
}

/// `install` 的参数。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct InstallArgs {
    /// 目标版本 id（`1.20.1` / `1.20.1-forge-47.2.0`）。
    pub version: String,
    /// 加载器（`vanilla` 缺省 / `fabric` / `quilt` / `neoforge` / `forge`）。
    pub loader: Option<String>,
    /// 加载器版本（缺省取官方默认：Fabric 系首个稳定版，maven 系该原版下最新）。
    pub loader_version: Option<String>,
    /// 实例显示名（缺省用版本 id）。
    pub name: Option<String>,
    /// 只出安装计划（列清单 + 总大小 + 源选择），不下载、不登记。
    pub dry_run: bool,
    /// 是否往 stderr 打实时进度（`--quiet` 下关掉）。
    pub progress: bool,
    /// 实时进度用 JSONL 形态（`--json` 时开，stderr 一行一条，stdout 仍是单个信封）。
    pub json_progress: bool,
}

/// `pack import` 的参数（M111）。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct PackImportArgs {
    /// 整合包路径：`.zip` / `.mrpack` / MultiMC 实例目录。
    pub path: PathBuf,
    /// 目标实例目录（缺省 = 新实例目录 `<数据根>/.ULL/data/instances/<实例目录名>`，M216 前是
    /// 共享游戏目录 `game_home`）。
    pub target: Option<PathBuf>,
    /// 实例显示名（缺省 = 包名）。
    pub name: Option<String>,
    /// 冲突时用包内内容覆盖（缺省保留用户文件）。
    pub overwrite: bool,
    /// 不登记实例（只落内容）。
    pub no_register: bool,
}

/// `launch` 的参数。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct LaunchArgs {
    /// 实例 id 或实例名；也可以直接给版本 id。
    pub instance: String,
    /// 只组装命令行，不 spawn（D18 的 `--dry-run`）。
    pub dry_run: bool,
    /// Java 可执行文件覆盖。
    pub java: Option<PathBuf>,
    /// 离线账户名（缺省 `Player`）。
    pub username: Option<String>,
    /// 账户名（`accounts` 里的玩家名或条目 id）；缺省用唯一账户。
    pub account: Option<String>,
    /// 最大堆（MB）。
    pub max_memory: Option<u32>,
}

/// `logs` 的参数。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct LogsArgs {
    /// 会话 id（允许唯一前缀）。
    pub session_id: String,
    /// 只打印末尾 N 条事件（缺省 200）。
    pub tail: usize,
}

/// `diag` 的参数。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct DiagArgs {
    /// 会话 id（允许唯一前缀）。
    pub session_id: String,
    /// 送入规则引擎的日志行上限（缺省 2000）。
    pub tail: usize,
}

/// `instances adopt` 的参数（M221：把盘上已有的版本登记成实例，只读外部、只写自己的配置）。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct InstancesAdoptArgs {
    /// 要接入的版本 id（= `versions/<id>/`）。
    pub version_id: String,
    /// 展示名（缺省 = 版本 id）。
    pub name: Option<String>,
    /// 运行目录选择：缺省 [`AdoptTarget::InstanceDir`]（ULL 数据区新目录），
    /// `shared` / `isolated` / `custom` 都必须显式给。
    pub target: AdoptTarget,
    /// 只检查、不写任何文件（`--dry-run`）。
    pub dry_run: bool,
}

/// `instances launch-args` 的参数（M157：实例级启动参数）。
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct InstanceLaunchArgs {
    /// 实例 id 或实例名。
    pub instance: String,
    /// 实例级 JVM 参数（空白分隔，支持引号）。
    pub jvm_args: Option<String>,
    /// 实例级游戏参数。
    pub game_args: Option<String>,
    /// 实例级最大堆（MiB 文本；空串由 `--memory ""` 表达「跟随全局」）。
    pub memory_mb: Option<String>,
    /// 实例级 Java 可执行文件。
    pub java: Option<String>,
    /// 图形后端（`default` / `opengl` / `vulkan`）。
    pub backend: Option<String>,
    /// 先清空五项再应用给出的项（`--clear`；不带其它选项时等于「全部跟随全局」）。
    pub clear: bool,
}

impl InstanceLaunchArgs {
    /// 这次调用是不是纯读取（没有任何写入口）。
    #[must_use]
    pub fn is_read_only(&self) -> bool {
        !self.clear
            && self.jvm_args.is_none()
            && self.game_args.is_none()
            && self.memory_mb.is_none()
            && self.java.is_none()
            && self.backend.is_none()
    }
}

/// `config get` 的参数。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ConfigGetArgs {
    /// 点分键路径；`None` 表示整份生效配置。
    pub key: Option<String>,
    /// 敏感键也输出明文（默认脱敏）。
    pub show_secret: bool,
}

/// `config set` 的参数。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ConfigSetArgs {
    /// 点分键路径。
    pub key: String,
    /// 值的原始文本（先按 JSON 解析，失败按字符串）。
    pub value: String,
}

/// 一次调用的完整输入。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Invocation {
    /// 全局选项。
    pub globals: Globals,
    /// 要执行的命令。
    pub command: Command,
}