worker-logplace
5fd5cd47dc
用户投诉原话：「我们的启动日志放在哪？…他找半天没找到崩溃日志」「只有一个安装日志」。 启动器运行日志（.ULL/logs/launcher.log） - presenter 构造 HostEnv 时就登记日志目录：启动早期缓冲的 200 行（[probe]/[font]/[theme]） 当场刷盘，不再是「只有开过一局游戏才有日志」。 - app/** 里所有 eprintln! 诊断改走 app::diag::diag!（stderr + 文件双写，行首 [tag] 即 scope）， 含 boot/boot::fallback/state/update 各线。 - boot 那一拍补一行后端事实（request/effective/fallback）。 - 滚动上限（1 MiB → launcher.1.log，只留一份）写进 README 与 docs/logs-location.md。 会话日志搬家：data/agent/sessions → logs - LauncherLayout: sessions_root()/game_logs() 新增，agent_sessions() 降级为只读兼容。 - host/logs 与 cli/commands/sessions 两个根合并（同 id 新根优先），event_path 回落旧家。 - 不搬不删；日志目录写一份 session-log-location.json 记录（moved=0, policy=read-only-compat）。 入口与文案 - 设置页「通用」新增「日志文件夹」行：路径 + 打开目录 + 复制路径（i18n 中英）。 - 日志页页头的「打开目录」不再是占位：走 M187 的 open_dir，失败文本带路径并送进剪贴板。 - README.md / README.zh-CN.md 新增「日志在哪」章节（含 crash-reports 只在游戏走到那一步才有）， docs/logs-location.md 给出上限、双写判据、迁移策略与没验的部分。 守门（每条都有变异证明，见报告） - 旧家会话仍列得出/打不开 ⇒ 只读新根变红；新会话写 logs/game ⇒ 只读旧根、写回旧家都变红。 - launcher.log 滚动 ⇒ 干掉 rename 变红。 - 打开日志文件夹指向真实目录 ⇒ 换成 cache/ 或去掉 create_dir_all 都变红。 - 日志根随三模式变化 ⇒ 把 HostEnv::logs_dir 写死成便携落点变红。
400 lines
17 KiB
Rust
400 lines
17 KiB
Rust
//! 启动全链：实例 → `LaunchRequest` → 子进程 → JSONL 事件流（GUI 版）。
|
||
//!
|
||
//! 与 CLI `ull launch` 同源同序（`core` 的 `game::resolve` / `arguments.expand` /
|
||
//! `launch::adapter::build_request` / `Launcher::spawn`），差异只有两处：
|
||
//! - **不阻塞 UI**：装配与等待都在后台线程里，进度/日志经 [`super::job::HostTask`] 回流；
|
||
//! - **身份来自 GUI 选中的账户**（`AccountStore` → `AuthPlaceholders`），凭据只在
|
||
//! 本模块内被读一次，绝不进 DTO。
|
||
//!
|
||
//! 停止：`kill_tree(pid)`（core 的三段式进程树回收），`finish()` 会照常收尾写索引。
|
||
|
||
use std::path::PathBuf;
|
||
|
||
use unlucky_core::game::arguments::Environment;
|
||
use unlucky_core::game::install::instance::read_instance_config;
|
||
use unlucky_core::game::isolation::{derive_game_dir, observe_mode, IsolationMode};
|
||
use unlucky_core::game::{self, VersionJson};
|
||
use unlucky_core::launch::adapter::{
|
||
self, AdapterOptions, AdapterWarning, LibraryInput, SnapshotInput,
|
||
};
|
||
use unlucky_core::launch::crash_report::{self, CrashReport, ReportContext};
|
||
use unlucky_core::launch::launcher_log;
|
||
use unlucky_core::launch::request::{LaunchRequest, MemoryOptions};
|
||
use unlucky_core::launch::time::{format_rfc3339_millis, now};
|
||
use unlucky_core::launch::tree_kill;
|
||
use unlucky_core::launch::{Launcher, LauncherConfig};
|
||
|
||
use crate::dto::{
|
||
InstanceId, InstanceRuntime, LaunchFailureStage, LaunchFailureView, LaunchFinished,
|
||
LaunchStage, LogOutcome, Progress,
|
||
};
|
||
|
||
use super::env::HostEnv;
|
||
|
||
mod java;
|
||
|
||
use super::job::{HostTask, JobSender};
|
||
pub use java::pick_java;
|
||
|
||
/// 启动器名（与 CLI `meta::LAUNCHER_NAME` 同值）。
|
||
pub const LAUNCHER_NAME: &str = "Unlucky Launcher";
|
||
|
||
/// 一次启动需要的实例信息。
|
||
#[derive(Debug, Clone, PartialEq, Eq)]
|
||
pub struct LaunchTarget {
|
||
/// 实例 id
|
||
pub id: InstanceId,
|
||
/// 实例名
|
||
pub name: String,
|
||
/// 绑定的版本 id
|
||
pub version_id: String,
|
||
/// 账户 id（`None` = 离线占位）
|
||
pub account: Option<String>,
|
||
}
|
||
|
||
/// 装配 [`LaunchRequest`]（与 CLI `snapshot::prepare` 同序）。
|
||
///
|
||
/// # Errors
|
||
///
|
||
/// 任一步失败都返回 [`LaunchFailureView`]：**阶段**（版本 JSON / 继承链 / 实例设置 / 隔离目录 /
|
||
/// 账户）+ 那一步的原文。文案不在这一层拼（presenter 不依赖 `unlucky-i18n`）。
|
||
pub fn build_request(
|
||
env: &HostEnv,
|
||
target: &LaunchTarget,
|
||
) -> Result<(LaunchRequest, Vec<String>), LaunchFailureView> {
|
||
let version_id = target.version_id.clone();
|
||
let manifest_path = env.game.version_json(&version_id);
|
||
let text = std::fs::read_to_string(&manifest_path).map_err(|error| {
|
||
LaunchFailureView::new(
|
||
LaunchFailureStage::VersionManifest,
|
||
format!("{}：{error}", manifest_path.display()),
|
||
)
|
||
})?;
|
||
let manifest = VersionJson::from_json_str(&text).map_err(|error| {
|
||
LaunchFailureView::new(
|
||
LaunchFailureStage::VersionManifest,
|
||
format!("{}：{error}", manifest_path.display()),
|
||
)
|
||
})?;
|
||
let source = |id: &str| -> Option<VersionJson> {
|
||
std::fs::read_to_string(env.game.version_json(id))
|
||
.ok()
|
||
.and_then(|text| VersionJson::from_json_str(&text).ok())
|
||
};
|
||
let resolved = game::resolve(&source, &manifest).map_err(|error| {
|
||
LaunchFailureView::new(LaunchFailureStage::Inheritance, error.to_string())
|
||
})?;
|
||
|
||
let environment = Environment::host();
|
||
let expanded = resolved
|
||
.arguments
|
||
.as_ref()
|
||
.map(|arguments| arguments.expand(&environment))
|
||
.unwrap_or_default();
|
||
|
||
let mut libraries: Vec<LibraryInput> = Vec::new();
|
||
for library in resolved.libraries.as_deref().unwrap_or_default() {
|
||
if !library.applies(&environment) {
|
||
continue;
|
||
}
|
||
// 1.19+ 的 natives 是独立库条目（name 带分类器），必须进 classpath；
|
||
// ≤1.18 的 `natives` 表条目归 natives::collect，不进 classpath。
|
||
// Linux arm64：独立条目改写成 natives-linux-arm64（路径与展示名一起改）。
|
||
let arm64 = library.linux_arm64_native_name(&environment);
|
||
if arm64.is_none() && library.native_classifier(&environment).is_some() {
|
||
continue;
|
||
}
|
||
let (coordinate, name) = match arm64 {
|
||
Some(rewritten) => {
|
||
let Ok(coordinate) =
|
||
unlucky_core::game::library::MavenCoordinate::parse(&rewritten)
|
||
else {
|
||
continue;
|
||
};
|
||
(coordinate, rewritten)
|
||
}
|
||
None => {
|
||
let Ok(coordinate) = library.coordinate() else {
|
||
continue;
|
||
};
|
||
(coordinate, library.name.clone())
|
||
}
|
||
};
|
||
let path = if library.is_local() {
|
||
env.game.version_library(&version_id, &coordinate)
|
||
} else {
|
||
env.game.library(&coordinate)
|
||
};
|
||
libraries.push(LibraryInput::new(path, name));
|
||
}
|
||
let natives = unlucky_core::launch::natives::collect(
|
||
&env.game,
|
||
&version_id,
|
||
resolved.libraries.as_deref().unwrap_or_default(),
|
||
&environment,
|
||
);
|
||
|
||
let game_dir = run_dir(env, target)?;
|
||
let jar_id = resolved.jar.clone().unwrap_or_else(|| version_id.clone());
|
||
let assets_root = env.game.assets_dir();
|
||
let assets_index = resolved
|
||
.assets
|
||
.clone()
|
||
.or_else(|| resolved.asset_index.as_ref().map(|index| index.id.clone()));
|
||
// 装配的门限 / 分支按**继承链的 MC 根版本**判，不是带加载器后缀的 version_id：
|
||
// `26w14a-fabric-0.16.5` 这种 id 在 `GameVersion::is_weekly_snapshot`（6 字符形态）上判不出来，
|
||
// 周快照的 `--graphicsBackend` 会在拼装链里被静默跳过——而详情页的门槛
|
||
// （`host::launch_args::backend_gate`）与 CLI 用的都是根版本，两边必须同一口径。
|
||
let (mc_version, _) = super::game::describe_version(env, &version_id);
|
||
let snapshot = SnapshotInput {
|
||
version_id: &version_id,
|
||
version_name: Some(&target.name),
|
||
version_type: None,
|
||
game_version: Some(mc_version.as_str()),
|
||
main_class: resolved.main_class.as_deref(),
|
||
jvm_arguments: &expanded.jvm,
|
||
game_arguments: &expanded.game,
|
||
legacy_arguments: resolved.minecraft_arguments.as_deref(),
|
||
libraries: &libraries,
|
||
natives: &natives,
|
||
primary_jar: env.game.version_jar(&jar_id),
|
||
game_dir,
|
||
assets_index: assets_index.as_deref(),
|
||
natives_dir: env.game.natives_dir(&version_id),
|
||
library_dir: env.game.libraries_dir(),
|
||
assets_root: assets_root.clone(),
|
||
game_assets: assets_root,
|
||
};
|
||
|
||
let overrides = super::launch_args::resolved(env, &target.id);
|
||
let java = pick_java(env, &version_id, overrides.java_path.as_deref());
|
||
let (auth, identity_line) = super::identity::resolve(env, target.account.as_deref())?;
|
||
let options = AdapterOptions {
|
||
java: java.selection,
|
||
memory: MemoryOptions {
|
||
min_mb: None,
|
||
max_mb: Some(overrides.memory_mb),
|
||
},
|
||
auth,
|
||
launcher_name: LAUNCHER_NAME.to_string(),
|
||
launcher_version: env!("CARGO_PKG_VERSION").to_string(),
|
||
language: "zh-CN".to_string(),
|
||
..AdapterOptions::strict()
|
||
};
|
||
let output = adapter::build_request(&snapshot, options);
|
||
let mut warnings: Vec<String> = output.warnings.iter().map(describe_warning).collect();
|
||
warnings.push(java.summary);
|
||
warnings.push(identity_line);
|
||
let mut request = output.request;
|
||
request.instance.id = target.id.clone();
|
||
request.instance.name = target.name.clone();
|
||
// 实例级启动参数（三级回落后的生效值）最后落位：user.* / memory / graphics_backend。
|
||
unlucky_core::launch::overrides::apply(&mut request, &overrides);
|
||
Ok((request, warnings))
|
||
}
|
||
|
||
/// 派生运行目录（D20 覆盖链：实例 `isolation` > 全局 `instances.mode`）。
|
||
fn run_dir(env: &HostEnv, target: &LaunchTarget) -> Result<PathBuf, LaunchFailureView> {
|
||
let global = super::game::global_mode(env);
|
||
let config = read_instance_config(&env.layout, &target.id).map_err(|error| {
|
||
LaunchFailureView::new(LaunchFailureStage::InstanceConfig, error.to_string())
|
||
})?;
|
||
let derivation = derive_game_dir(&env.game, &target.version_id, global, config.as_ref(), None)
|
||
.map_err(|error| {
|
||
LaunchFailureView::new(LaunchFailureStage::Isolation, error.to_string())
|
||
})?;
|
||
if let Some(mut config) = config {
|
||
let at = format_rfc3339_millis(now());
|
||
if observe_mode(&mut config, &env.game, &at, derivation.isolation).unwrap_or(false) {
|
||
let _ =
|
||
unlucky_core::game::install::instance::write_instance_config(&env.layout, &config);
|
||
}
|
||
}
|
||
Ok(derivation.game_dir)
|
||
}
|
||
|
||
/// 起一次启动（后台线程；进度/日志/收尾全部走 `HostTask`）。
|
||
pub fn start(env: HostEnv, tx: JobSender, target: LaunchTarget) {
|
||
let id = target.id.clone();
|
||
let tx_progress = tx.clone();
|
||
super::job::spawn("launch", move || {
|
||
// M187：启动器自己的运行日志从这里开始有落点（早于这一拍的行由 core 缓冲接住）。
|
||
// M188 起 presenter 在构造 `HostEnv` 时已经登记过目录（缓冲那时就刷出去了），这里是
|
||
// 幂等的一次兜底：数据根被 `redirect.json` 改过时以最后一次为准。
|
||
let logs_dir = env.layout.logs();
|
||
launcher_log::set_dir(&logs_dir);
|
||
let started_at = std::time::SystemTime::now();
|
||
let mut report = ReportContext::new(
|
||
&target.id,
|
||
&target.name,
|
||
&target.version_id,
|
||
&env.data.game_home,
|
||
&logs_dir,
|
||
started_at,
|
||
unlucky_core::platform::os_info::current().summary_line(),
|
||
);
|
||
let _ = tx_progress.send(HostTask::Runtime {
|
||
id: id.clone(),
|
||
runtime: InstanceRuntime::Busy {
|
||
stage: LaunchStage::Launch,
|
||
progress: Progress { done: 0, total: 1 },
|
||
},
|
||
});
|
||
let (request, warnings) = match build_request(&env, &target) {
|
||
Ok(ok) => ok,
|
||
Err(failure) => {
|
||
let line = format!("instance={} 装配失败：{}", target.id, failure.detail);
|
||
launcher_log::record("launch", &line);
|
||
publish_before_start(&report, failure.stage.slug(), &failure.detail);
|
||
let _ = tx.send(HostTask::LaunchEnd(Box::new(LaunchFinished {
|
||
id,
|
||
session: String::new(),
|
||
outcome: LogOutcome::Crashed,
|
||
exit_code: None,
|
||
uptime_ms: 0,
|
||
failure: Some(failure),
|
||
})));
|
||
return;
|
||
}
|
||
};
|
||
report.run_dir = request.dirs.game_dir.clone();
|
||
report.version_json = Some(env.game.version_json(&target.version_id));
|
||
report.java = format!(
|
||
"{} (major {})",
|
||
request.java.binary.display(),
|
||
request.java.major
|
||
);
|
||
for warning in &warnings {
|
||
let _ = tx.send(HostTask::Notice(Box::new(crate::dto::NoticeView::new(
|
||
&format!("launch-warn:{}", target.id),
|
||
crate::dto::NoticeLevel::Info,
|
||
"启动提示",
|
||
warning,
|
||
))));
|
||
}
|
||
// 命令行（脱敏版）进启动器日志：事故之后「到底用什么参数起的」是第一个要看的。
|
||
let line = format!(
|
||
"instance={} game_dir={} java={} memory={}MB",
|
||
target.id,
|
||
report.run_dir.display(),
|
||
report.java,
|
||
request.memory.max_mb.unwrap_or(0)
|
||
);
|
||
launcher_log::record("launch", &line);
|
||
let config = LauncherConfig::new(env.sessions_root())
|
||
.with_launcher(LAUNCHER_NAME, env!("CARGO_PKG_VERSION"));
|
||
let session = match Launcher::new(config).spawn(&request) {
|
||
Ok(session) => session,
|
||
Err(error) => {
|
||
let failure = LaunchFailureView::new(LaunchFailureStage::Spawn, error.to_string());
|
||
launcher_log::record(
|
||
"launch",
|
||
&format!("instance={} spawn 失败：{error}", target.id),
|
||
);
|
||
publish_before_start(&report, "spawn", &failure.detail);
|
||
let _ = tx.send(HostTask::LaunchEnd(Box::new(LaunchFinished {
|
||
id,
|
||
session: String::new(),
|
||
outcome: LogOutcome::Crashed,
|
||
exit_code: None,
|
||
uptime_ms: 0,
|
||
failure: Some(failure),
|
||
})));
|
||
return;
|
||
}
|
||
};
|
||
let session_id = session.session_id().to_string();
|
||
let pid = session.pid();
|
||
let _ = tx.send(HostTask::LaunchStarted {
|
||
id: id.clone(),
|
||
session_id: session_id.clone(),
|
||
pid,
|
||
});
|
||
let _ = tx.send(HostTask::Runtime {
|
||
id: id.clone(),
|
||
runtime: InstanceRuntime::Running { pid },
|
||
});
|
||
match session.finish() {
|
||
Ok(handle) => {
|
||
let outcome = super::identity::outcome_of(&handle);
|
||
let line = format!(
|
||
"instance={} session={session_id} exit={} type={} uptime={}ms outcome={:?} artifacts={}",
|
||
target.id,
|
||
handle.exit.code,
|
||
handle.exit.exit_type.as_str(),
|
||
handle.uptime_ms,
|
||
outcome,
|
||
handle.artifacts.len()
|
||
);
|
||
launcher_log::record("launch", &line);
|
||
report.secrets.push(session_id.clone());
|
||
let lines: Vec<String> = super::logs::read_lines(&handle.log_path)
|
||
.into_iter()
|
||
.map(|line| line.text)
|
||
.collect();
|
||
crash_report::publish(CrashReport::collect(&handle, &report, &lines));
|
||
let _ = tx.send(HostTask::LaunchEnd(Box::new(LaunchFinished {
|
||
id,
|
||
session: session_id,
|
||
outcome,
|
||
exit_code: Some(handle.exit.code),
|
||
uptime_ms: handle.uptime_ms,
|
||
// 跑起来再崩不算「装配失败」：结局由 `outcome` 表达，这里留 `None`。
|
||
failure: None,
|
||
})));
|
||
}
|
||
Err(error) => {
|
||
let failure = LaunchFailureView::new(LaunchFailureStage::Spawn, error.to_string());
|
||
let line = format!(
|
||
"instance={} session={session_id} 收尾失败：{error}",
|
||
target.id
|
||
);
|
||
launcher_log::record("launch", &line);
|
||
publish_before_start(&report, "spawn", &failure.detail);
|
||
let _ = tx.send(HostTask::LaunchEnd(Box::new(LaunchFinished {
|
||
id,
|
||
session: session_id,
|
||
outcome: LogOutcome::SilentFail,
|
||
exit_code: None,
|
||
uptime_ms: 0,
|
||
failure: Some(failure),
|
||
})));
|
||
}
|
||
}
|
||
});
|
||
}
|
||
|
||
/// 登记一次「进程没起来」的现场（四个失败出口共用这一处，避免各写一遍 exit_type）。
|
||
fn publish_before_start(report: &ReportContext, stage: &str, detail: &str) {
|
||
crash_report::publish(CrashReport::before_start(report, stage, detail, stage));
|
||
}
|
||
|
||
/// 停止一次启动（按 pid 回收进程树；`finish()` 会在后台线程里照常收尾）。
|
||
pub fn stop(pid: u32) -> Result<(), String> {
|
||
tree_kill::kill_tree(pid, std::time::Duration::from_secs(3))
|
||
.map_err(|error| format!("停止进程 {pid} 失败：{error}"))
|
||
}
|
||
|
||
/// 适配层告警 → 人读一行。
|
||
fn describe_warning(warning: &AdapterWarning) -> String {
|
||
match warning {
|
||
AdapterWarning::MissingLibrary { name, path } => {
|
||
format!("缺少库文件 {name}（{}）", path.display())
|
||
}
|
||
AdapterWarning::MissingGameArguments => "版本 JSON 没有游戏参数".to_string(),
|
||
AdapterWarning::MissingAssetsIndex => "版本 JSON 没有资源索引".to_string(),
|
||
AdapterWarning::MissingMainClass => "版本 JSON 没有 mainClass".to_string(),
|
||
AdapterWarning::MissingNativeJar { name, path } => {
|
||
format!("缺少 natives 构件 {name}（{}）", path.display())
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 隔离档位的展示串（`isolated` / `shared`）。
|
||
pub fn isolation_label(mode: IsolationMode) -> &'static str {
|
||
mode.as_str()
|
||
}
|
||
|
||
#[cfg(test)]
|
||
mod tests;
|