收口桌面壳窗口标题诊断日志
桌面壳窗口标题失败只记录固定阶段标签 扩展桌面壳配置门禁禁止窗口标题日志输出 Tauri 错误细节 补充宿主壳方案和共享决策中的窗口标题诊断边界
This commit is contained in:
@@ -2918,17 +2918,18 @@ for (const snippet of [
|
||||
'window_title_from_request',
|
||||
'window_title_unavailable_response',
|
||||
'log_desktop_window_title_failure',
|
||||
'desktop window title failed for {label}: {error}',
|
||||
'desktop window title failed for {label}',
|
||||
'required_string_payload(request, "title")',
|
||||
'window.set_title(&title)',
|
||||
'log_desktop_window_title_failure("set", &error.to_string())',
|
||||
'log_desktop_window_title_failure("window", "main window unavailable")',
|
||||
'log_desktop_window_title_failure("set")',
|
||||
'log_desktop_window_title_failure("window")',
|
||||
'"title is required"',
|
||||
'"window title unavailable"',
|
||||
'window_title_request_rejects_missing_or_invalid_payload',
|
||||
'window_title_request_trims_and_truncates_shared_boundary',
|
||||
'window_title_unavailable_response_is_stable',
|
||||
'window_title_failures_are_logged_without_exposing_native_detail',
|
||||
'window_title_failures_log_stable_label_only',
|
||||
]) {
|
||||
if (!desktopHostBridgeTitleSource.includes(snippet)) {
|
||||
throw new Error(`desktop shell title module is missing ${snippet}`);
|
||||
@@ -2936,7 +2937,9 @@ for (const snippet of [
|
||||
}
|
||||
if (
|
||||
desktopHostBridgeTitleSource.includes('failed(request.id.clone(), "host_error", error.to_string())') ||
|
||||
desktopHostBridgeTitleSource.includes('"main window not found"')
|
||||
desktopHostBridgeTitleSource.includes('"main window not found"') ||
|
||||
desktopHostBridgeTitleSource.includes('desktop window title failed for {label}: {error}') ||
|
||||
desktopHostBridgeTitleSource.includes('&error.to_string()')
|
||||
) {
|
||||
throw new Error('desktop shell title module must hide native window errors');
|
||||
}
|
||||
|
||||
@@ -36,13 +36,13 @@ pub(crate) fn set_desktop_host_bridge_window_title(
|
||||
match app.get_webview_window("main") {
|
||||
Some(window) => match window.set_title(&title) {
|
||||
Ok(()) => ok(request.id.clone(), json!(true)),
|
||||
Err(error) => {
|
||||
log_desktop_window_title_failure("set", &error.to_string());
|
||||
Err(_error) => {
|
||||
log_desktop_window_title_failure("set");
|
||||
window_title_unavailable_response(request)
|
||||
}
|
||||
},
|
||||
None => {
|
||||
log_desktop_window_title_failure("window", "main window unavailable");
|
||||
log_desktop_window_title_failure("window");
|
||||
window_title_unavailable_response(request)
|
||||
}
|
||||
}
|
||||
@@ -52,11 +52,8 @@ fn window_title_unavailable_response(request: &HostBridgeRequest) -> HostBridgeR
|
||||
failed(request.id.clone(), "host_error", "window title unavailable")
|
||||
}
|
||||
|
||||
fn log_desktop_window_title_failure(label: &str, error: &str) -> bool {
|
||||
if !error.is_empty() {
|
||||
eprintln!("desktop window title failed for {label}: {error}");
|
||||
}
|
||||
|
||||
fn log_desktop_window_title_failure(label: &str) -> bool {
|
||||
eprintln!("desktop window title failed for {label}");
|
||||
false
|
||||
}
|
||||
|
||||
@@ -129,13 +126,12 @@ mod tests {
|
||||
|
||||
#[test]
|
||||
fn window_title_failures_are_logged_without_exposing_native_detail() {
|
||||
assert!(!log_desktop_window_title_failure(
|
||||
"set",
|
||||
"private title detail"
|
||||
));
|
||||
assert!(!log_desktop_window_title_failure(
|
||||
"window",
|
||||
"main window unavailable"
|
||||
));
|
||||
assert!(!log_desktop_window_title_failure("set"));
|
||||
assert!(!log_desktop_window_title_failure("window"));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn window_title_failures_log_stable_label_only() {
|
||||
assert!(!log_desktop_window_title_failure("set"));
|
||||
}
|
||||
}
|
||||
|
||||
@@ -3162,7 +3162,7 @@
|
||||
|
||||
- 背景:Tauri 桌面壳的外观、角标和窗口标题能力都依赖主窗口和平台系统 API;这些能力对 H5 必须保持稳定错误语义,但开发侧也需要知道是主窗口缺失、主题读取失败还是系统 API 调用失败。
|
||||
- 决策:`apps/desktop-shell/src-tauri/src/host_bridge/appearance.rs`、`apps/desktop-shell/src-tauri/src/host_bridge/badge.rs` 和 `apps/desktop-shell/src-tauri/src/host_bridge/title.rs` 必须在主窗口缺失、主题读取失败、角标设置失败和窗口标题设置失败时分别记录 `desktop appearance failed for ...`、`desktop app badge failed for ...` 或 `desktop window title failed for ...` 日志。HostBridge 对 H5 仍只返回稳定 `appearance unavailable`、`badge unavailable` 或 `window title unavailable`,不透传系统错误、窗口内部信息或平台细节。
|
||||
- 2026-06-21 调整:桌面外观和角标能力失败日志只记录 `desktop appearance failed for <stage>` / `desktop app badge failed for <stage>` 固定标签,不输出主窗口缺失文本、Tauri `theme()` / `set_badge_count` 错误或其它平台细节;配置检查拒绝 `appearance.rs` / `badge.rs` 重新拼接 `: {error}` 或 `&error.to_string()`。
|
||||
- 2026-06-21 调整:桌面外观、角标和窗口标题能力失败日志只记录 `desktop appearance failed for <stage>` / `desktop app badge failed for <stage>` / `desktop window title failed for <stage>` 固定标签,不输出主窗口缺失文本、Tauri `theme()` / `set_badge_count` / `set_title` 错误或其它平台细节;配置检查拒绝 `appearance.rs` / `badge.rs` / `title.rs` 重新拼接 `: {error}` 或 `&error.to_string()`。
|
||||
- 验证方式:`cargo test --manifest-path apps/desktop-shell/src-tauri/Cargo.toml host_bridge::appearance`、`cargo test --manifest-path apps/desktop-shell/src-tauri/Cargo.toml host_bridge::badge`、`cargo test --manifest-path apps/desktop-shell/src-tauri/Cargo.toml host_bridge::title`、`npm run desktop-shell:typecheck`、`npm run check:native-shells`、`npm run check:encoding`、`git diff --check`。
|
||||
|
||||
## 2026-06-20 桌面壳导航系统异常必须可观测
|
||||
|
||||
@@ -354,7 +354,7 @@ GameBridge 禁止:
|
||||
|
||||
2026-06-20 追加:桌面壳文件导入导出的系统异常必须可观测。Tauri dialog 路径转换失败、后台文件读写任务失败或任务 join 失败时,桌面壳必须分别记录 `desktop file export failed for ...` 或 `desktop file import failed for ...` 日志;HostBridge 回包仍只暴露稳定 `file export unavailable` 或 `file import unavailable` 语义,不透传本地路径、系统错误或线程细节。用户取消系统文件对话框仍返回 `cancelled`,不记录为异常。
|
||||
|
||||
2026-06-20 追加:桌面壳窗口状态小能力的系统异常必须可观测。Tauri 主窗口缺失、主题读取失败、角标设置失败或窗口标题设置失败时,桌面壳必须分别记录 `desktop appearance failed for ...`、`desktop app badge failed for ...` 或 `desktop window title failed for ...` 日志;HostBridge 回包仍只暴露稳定 `appearance unavailable`、`badge unavailable` 或 `window title unavailable` 语义,不透传系统错误、窗口内部信息或平台细节。2026-06-21 调整:桌面外观和角标失败日志只记录 `desktop appearance failed for <stage>` / `desktop app badge failed for <stage>` 固定标签,不把 Tauri `theme()` / `set_badge_count` 错误详情或主窗口缺失细节写入 stderr。
|
||||
2026-06-20 追加:桌面壳窗口状态小能力的系统异常必须可观测。Tauri 主窗口缺失、主题读取失败、角标设置失败或窗口标题设置失败时,桌面壳必须分别记录 `desktop appearance failed for ...`、`desktop app badge failed for ...` 或 `desktop window title failed for ...` 日志;HostBridge 回包仍只暴露稳定 `appearance unavailable`、`badge unavailable` 或 `window title unavailable` 语义,不透传系统错误、窗口内部信息或平台细节。2026-06-21 调整:桌面外观、角标和窗口标题失败日志只记录 `desktop appearance failed for <stage>` / `desktop app badge failed for <stage>` / `desktop window title failed for <stage>` 固定标签,不把 Tauri `theme()` / `set_badge_count` / `set_title` 错误详情或主窗口缺失细节写入 stderr。
|
||||
|
||||
2026-06-20 追加:桌面壳导航系统异常必须可观测。Tauri 外链打开失败、同源 H5 route 导航失败、WebView reload 失败或主窗口缺失时,桌面壳必须记录 `desktop navigation failed for ...` 日志;HostBridge 回包仍只暴露稳定 `external URL cannot be opened`、`native page unavailable` 或 `webview reload unavailable` 语义,不透传系统错误、窗口内部信息或平台细节。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user