运行时启动与窗口生命周期

模块职责

• 定义应用从 Main() 到主窗口可用的完整启动链路。
• 管理单实例行为、依赖注入容器初始化、运行时异常处理与退出释放。
• 管理主窗口与设置窗口的基础生命周期行为（显示、隐藏、导航、释放）。

关键入口

• STranslate/App.xaml.cs
  • Main()：单实例判定、Velopack 回调、管理员模式启动判定。
  • App() 构造函数：读取三类设置并注册 DI。
  • OnStartup()：插件/服务/数据库初始化，窗口创建与启动后延迟初始化。
  • Register*Exception()、RegisterExitEvents()、Dispose()：异常与退出收敛。
• STranslate/Core/ISingleInstanceApp.cs
  • SingleInstance<TApplication>.InitializeAsFirstInstance()：Mutex + NamedPipe 单实例通知。
• STranslate/Views/MainWindow.xaml.cs
  • OnLoaded()、OnContentRendered()、OnDeactivated()、Dispose()。
• STranslate/Views/SettingsWindow.xaml.cs
  • Navigate()：设置页导航入口与导航状态同步。

核心流程

从入口到结果：应用启动到主窗口可用

1. App.Main() 先调用 SingleInstance<App>.InitializeAsFirstInstance()。
2. 若是第二实例：通过命名管道通知首实例触发 OnSecondAppStarted() 并退出；首实例执行 MainWindowViewModel.Show()。
3. 首实例继续执行 Velopack OnAfterUpdateFastCallback，把临时配置目录回迁到便携数据目录。
4. 执行 NeedAdmin()：若启动模式要求提权，交给 UACHelper 重启进程后当前实例返回。
5. 创建 App 实例：从 AppStorage<T> 读取 Settings、HotkeySettings、ServiceSettings。
6. 在 App() 内配置 DI：注册核心服务（插件/服务管理、翻译链、HTTP、窗口 VM、更新、外部调用、数据库等）。
7. OnStartup() 中顺序初始化：
   • PluginManager.LoadPlugins()
   • ServiceManager.LoadServices()
   • SqlService.InitializeDB()
   • 注册全局异常处理
   • 创建主窗口与主 VM
8. 主窗口 Loaded 时执行延迟初始化：Settings.LazyInitialize()、HotkeySettings.LazyInitialize()、托盘提示、WebDav 后置备份上传，以及自动检查更新服务启动。

从入口到结果：退出与资源回收

1. ProcessExit、Application.Exit、SessionEnding 任一事件触发时统一进入 Dispose()。
2. 在主线程释放资源：通知图标卸载、主窗口 VM 释放、主窗口释放、PluginManager.Dispose() 清理临时解压目录。
3. 需要重启生效的插件目录清理并不在这里直接删除，而由下次启动时的插件扫描阶段处理（NeedDelete/NeedUpgrade 标记）。

窗口生命周期要点

• MainWindow：
  • OnLoaded() 会按 HideOnStartup 计算窗口位置并挂接窗口过程钩子。
  • OnContentRendered() 决定首次显示或隐藏。
  • OnDeactivated() 可按 HideWhenDeactivated 自动隐藏，避免 Alt-Tab 残留。
• SettingsWindow：
  • Navigate(tag) 根据页面类型从 DI 取页实例并注入到 RootFrame.Content。
  • Ctrl+F 由 OnKeyDown 路由到当前页面的搜索框。

关键数据结构/配置

• Settings：主行为配置（窗口、主题、热键策略、网络、OCR/图像翻译参数等）。
• HotkeySettings：全局热键、软件内热键、增量翻译键、Ctrl+CC 配置。
• ServiceSettings：服务实例列表与特殊服务 ID（替换翻译、图片翻译）。
• DataLocation：便携/漫游目录选择、日志/缓存/配置路径、InfoFilePath 与 BackupFilePath。

关键文件

• STranslate/App.xaml.cs
• STranslate/Core/ISingleInstanceApp.cs
• STranslate/Views/MainWindow.xaml.cs
• STranslate/Views/SettingsWindow.xaml.cs
• STranslate/Core/DataLocation.cs

常见改动任务

• 新增启动期服务：在 App() 的 ConfigureServices 注册，并在 OnStartup() 明确初始化顺序。
• 增加全局异常策略：优先放到 RegisterDispatcherUnhandledException / RegisterTaskSchedulerUnhandledException。
• 调整窗口初始行为：优先改 MainWindow.OnContentRendered() 与 MainWindowViewModel.UpdatePosition() 配合逻辑。
• 设置页新增导航项：同步修改 SettingsWindow.xaml 菜单与 SettingsWindow.xaml.cs 的 Navigate 映射。