AskaEth
ff78fe2cae
D4：`pick` 的排序键从「来源序」改成「版本距离 → 来源序」，全不满足时选最接近要求的那个 （托管 25 与 JAVA_HOME/扫盘 17 之间选 17，而不是按 rank 选托管）。新增 `select::decide`： 不符且**没有人显式指定 Java** 时 `ull launch` 直接报 `java_mismatch` 不 spawn（`--java` / 实例 `javaPath` 是豁免，只告警）——1.12.2 配 Java 17/25 必然起不来，警告没有信息量。 `JavaMismatch` + `check` 拆到 `mismatch.rs` 并加 `advice()`（mapping.rs 408→282 行）。 D6：`LaunchSession::finish` 的等进程改成**有界**。判据在 `startup_watch.rs`（纯逻辑）： ①窗口从未出现且**连续 N 秒没有任何日志**（还在打日志就说明还在加载，慢加载不被判死）； ②日志出现关闭标记后 N 秒仍未退出（实机「关窗后 java.exe 仍存活」的形状）。 到点只**停止等待、绝不杀进程**：写 `session_end(still_running)` + 索引 + `launcher.log`， 返回 `LaunchError::Watchdog`，CLI 翻成 `launch_timeout`。两个时长可配 （默认 300s/60s；`ULL_LAUNCH_STARTUP_TIMEOUT_SECS` / `ULL_LAUNCH_SHUTDOWN_GRACE_SECS`， 生效值每次启动写进 launcher.log 与人读输出）。 D10：把「被终止」与「应用错误」分开。①我们自己杀的：`tree_kill` **送达即登记** `kill_registry`（pid 登记簿，取走语义、上限 64），覆盖 GUI 从别的线程 `kill_tree` 的路径， `finish` 据此判 `killed`；②外部强杀：Windows 上「退出码 1 + 零错误输出 + 无崩溃/JVM 关键字」 判 `killed` 并标 `terminated_externally`（任务管理器与 `taskkill /F` 都是 `TerminateProcess(h, 1)`，应用真崩给的是 NTSTATUS 异常码）。 顺带：`SessionHandle` 拆 `session_handle.rs`（launch_session.rs 422→343 行）、 `NativesReport::to_json` 落 core（cli/launch.rs 腾出空间，仍 399 行）。 用例：select 距离/取舍、startup_watch 状态机、watchdog_cases（4 条真进程）、 exit_cases（外部终止与「我们杀的」区分）、pipeline 跨线程 kill。
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};
|