BiliNote

mirror of https://github.com/JefferyHcool/BiliNote.git synced 2026-05-12 02:20:18 +08:00

Files

huangjianwu 9a64a2da8e feat(desktop): 启动期路径诊断 + 顶端横幅，主动暴露已知失败因素

桌面端历史痛点：PyInstaller sidecar 在含非 ASCII / 含空格 / 不可写的安装路径下
直接炸（README:36 仅文字警告"不要中文路径"，无主动防御）。Sidecar 退出事件 lib.rs
已 emit 但前端没 listener 消化，用户看到的是空白主页。

- src-tauri/src/lib.rs：
  · setup 中 env::current_exe() 之后做 InstallPathDiagnostics（is_ascii / 空格 /
    父目录 write_probe），命中任一异常就 emit 'backend-warning' 给前端
  · 用 std::thread::spawn + 1500ms sleep 等首屏 listener 挂上再 emit，避免事件丢失
  · 新增 Tauri command get_install_path_diagnostics，前端可主动重查（用户卸载到
    新目录后首次启动）
- BillNote_frontend/src/components/SystemDiagnostic/StartupBanner.tsx（新建）：
  · 监听 backend-warning（路径警告，可关闭）+ backend-terminated（致命，常驻）
  · 纯 web 环境（无 __TAURI_INTERNALS__）下静默不挂载，对桌面端定向起效
  · backend-error（stderr 噪音）暂不展示，留给后续 P2 日志面板
- App.tsx：StartupBanner 在 BackendInitDialog 之前就挂载，让"后端还在初始化时"
  也能看见路径警告（正是该场景容易炸）

不改任何业务逻辑；纯桌面端 UX 加固。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-09 14:22:41 +08:00