AskaEth
1fa30c4885
`ull launch --dry-run` 在「环境准备」段走的是真解压：即使只打印命令行，也会在 `versions/<id>/natives/` 下建目录、解 dll、写戳记，把别人的版本树改脏（父目录 mtime 也变）。失败路径（缺 jar 报 missing_components）照样留下这些副作用。 - natives 新增 `preview()`：与 `extract()` 共用条目筛选与戳记口径，但零落盘 （无 create_dir_all / clear_natives / write_stamp），只清点「将写下几个原生库」； jar 打不开照样报错，预览不藏坏包。 - `NativesReport` 增 `planned` / `dir_exists`：预览报告自报家门，人读行与 JSON 说清「未落盘」「目录尚不存在」。 - `Launcher::dry_run` 改走 `preview_environment`，`spawn` 仍走 `prepare_environment`。 - 报告类型拆到 `natives/report.rs`（mod.rs 曾破 400 行红线）。 - 回归测试（natives_dry_run_cases.rs）：有 jar / 无 jar / 空 jar / 已解压过四条 零落盘判据，用「节点类型 + 纳秒 mtime」快照逐字比较版本树，并带一条判据自检 （瞬时建删目录必须被快照看见，防假绿）。 - help：`--dry-run` 的承诺补成「不写盘、不解压 natives、不建目录」。 证据（外部版本树 versions/1.16.5 + 真 natives jar）： 修复前 dry-run 后 versions/1.16.5 mtime 1794342830.6861426 → 1794342832.4544542， 新增 natives/ + lwjgl.dll + OpenAL.dll + .ull-natives.json；修复后同一场景快照逐字 不变（mtime 1794343730.6618167），JSON natives.planned=true / dir_exists=false。
94 lines
3.9 KiB
Rust
94 lines
3.9 KiB
Rust
//! 启动管线：10 阶段命令行组装、Java 选择、子进程管理、结构化 JSONL 事件流。
|
||
//!
|
||
//! 设计定稿：`DevDocs/PlanDoc/06-launch-and-diagnostics.md` §1（管线）与 §3（事件流），
|
||
//! Java 侧约束见 `DevDocs/PlanDoc/01d-language-choice.md` §3（JDK 17 基准 + 版本映射提示）。
|
||
//!
|
||
//! 事件流是 core → app 的唯一启动反馈通道（另一条是快照发布），
|
||
//! 不做 200ms 批量刷 UI 式的隐式耦合。
|
||
//!
|
||
//! # 公共面
|
||
//!
|
||
//! - [`Launcher`]：`dry_run`（D18，只组装命令行、零落盘）、`spawn`/`launch`（完整管线）；
|
||
//! - [`LaunchRequest`] 是命令行组装的**纯数据输入**，由 [`adapter`] 从 game 快照映射而来；
|
||
//! - [`AssembledCommand`] 是组装结果（program + argv + classpath + 环境变量 + 告警）；
|
||
//! - 事件流（[`session`]）与索引（[`session_index`]）是 M15 诊断采集器与
|
||
//! M16 `read_game_log`/`list_game_sessions` 的数据源，schema 见
|
||
//! `DevDocs/SubAgentsTalk/launch-接口约定.md`；
|
||
//! - [`DiagnosisHook`] 是接 M15 的唯一接缝（launch 报事实、M15 下结论）。
|
||
//!
|
||
//! # 与 HMCL 的三处差异（`analyse/02` §8.5）
|
||
//!
|
||
//! 1. `exit 0` 静默失败单独立标（[`exit_analysis`]）；
|
||
//! 2. 日志泵 join 有预算（[`watchdog`]），进程树三段式回收（[`tree_kill`]，P1 换 Job Object）；
|
||
//! 3. 窗口出现检测带启发式名称/耗时/证据（[`window_detect`]）。
|
||
//!
|
||
//! # 两条实机修正（M208 台账）
|
||
//!
|
||
//! - **D6 有界等待**：进程也可能「活着但没动静」。判据在 [`startup_watch`]
|
||
//! （未见过窗口 / 已出现关闭标记），到点只**停止等待**并返回
|
||
//! [`LaunchError::Watchdog`]——绝不杀进程，用户的加载进度不该被启动器清掉；
|
||
//! - **D10 结束归属**：谁结束的进程只有调用方知道，所以 [`tree_kill`] 送达即登记
|
||
//! （[`kill_registry`]），退出分析据此判「被终止」而不是「应用错误」；外部强杀
|
||
//! （任务管理器）走[`exit_analysis::looks_externally_terminated`] 的 Windows 判据。
|
||
//!
|
||
//! 零 UI 依赖：本模块只产出结构化事件与纯数据，不 import 任何 UI 类型。
|
||
|
||
pub mod adapter;
|
||
pub mod args_table;
|
||
pub mod argument;
|
||
pub mod command_builder;
|
||
pub mod crash_bundle;
|
||
pub mod crash_report;
|
||
pub mod crash_scan;
|
||
pub mod defaults;
|
||
pub mod diagnosis_hook;
|
||
pub mod error;
|
||
pub mod exit_analysis;
|
||
pub mod game_args;
|
||
pub mod game_version;
|
||
pub mod jvm_args;
|
||
pub mod kill_registry;
|
||
pub mod launch_session;
|
||
pub mod launcher;
|
||
pub mod launcher_log;
|
||
pub mod log_level;
|
||
pub mod natives;
|
||
pub mod overrides;
|
||
pub mod placeholders;
|
||
pub mod platform;
|
||
pub mod process;
|
||
pub mod pump;
|
||
pub mod redact;
|
||
pub mod request;
|
||
pub mod session;
|
||
pub mod session_handle;
|
||
pub mod session_index;
|
||
pub mod session_meta;
|
||
pub mod session_payload;
|
||
pub mod session_sink;
|
||
pub mod sink;
|
||
pub mod startup_watch;
|
||
pub mod time;
|
||
pub mod tree_kill;
|
||
pub mod watchdog;
|
||
pub mod window_detect;
|
||
|
||
pub use adapter::{
|
||
build_request, AdapterOptions, AdapterOutput, AdapterWarning, LibraryInput, SnapshotInput,
|
||
};
|
||
pub use args_table::{assemble, AssembledCommand, AssemblyWarning};
|
||
pub use crash_report::{ArtifactFact, CrashReport, Evidence, ReportContext};
|
||
pub use crash_scan::{CrashArtifact, CrashSource};
|
||
pub use diagnosis_hook::{DiagnosisHook, DiagnosisRequest, NoopDiagnosis};
|
||
pub use error::{LaunchError, MissingComponent, Result};
|
||
pub use exit_analysis::{ExitAnalysis, ExitType, SilentFailure};
|
||
pub use launch_session::{LaunchSession, SessionHandle};
|
||
pub use launcher::{DryRun, Launcher, LauncherConfig};
|
||
pub use natives::{NativeJar, NativesEra, NativesPlan, NativesReport};
|
||
pub use process::{ProcessConfig, RunningProcess};
|
||
pub use request::LaunchRequest;
|
||
pub use session::{EndReason, SessionMeta, SessionSink, SessionWriter};
|
||
pub use session_index::SessionIndexEntry;
|
||
pub use sink::{CompositeSink, CountingSink, FnSink};
|
||
pub use startup_watch::{StartupWatch, WatchVerdict};
|