Seelen-UI故障排查指南

一、故障定位流程

【环境检查】系统兼容性验证

前置检查：

• 确认Windows版本为10 2004+或11
• 验证WebView2运行时已安装
• 检查.NET Framework 4.8+环境

操作步骤：

1. 打开命令提示符执行 winver 确认系统版本
2. 检查 %ProgramFiles%\Microsoft\EdgeWebView2 目录存在性
3. 运行系统文件检查: sfc /scannow

验证方法：

• 系统版本显示在关于Windows对话框中
• WebView2目录包含运行时文件
• SFC扫描结果显示"未发现完整性冲突"

【日志分析】错误信息收集

前置检查：

• 具备文件系统访问权限
• 日志文件未被第三方安全软件锁定

操作步骤：

1. 访问日志目录: %LOCALAPPDATA%\com.seelen.seelen-ui\logs\
2. 打开最新的SLU Service.log文件
3. 搜索关键词: ERROR、FATAL、EXCEPTION

验证方法：

• 找到最近时间戳的错误记录
• 记录错误代码和堆栈信息
• 对比日志关键错误码速查表

二、常见问题解决方案

【启动故障】应用程序无法启动

根本原因分析：WebView运行时损坏或配置文件冲突

操作步骤	验证方法
1. 删除配置目录: %APPDATA%\seelen\config	重启后生成新配置文件
2. 重新注册WebView组件: regsvr32 msedgewebview2.dll	命令执行返回成功提示
3. 执行应用修复: Seelen-UI.exe --repair	修复完成后显示成功代码

【界面异常】工具栏显示错乱

根本原因分析：主题文件损坏或显示驱动不兼容

操作步骤	验证方法
1. 重置主题设置: %APPDATA%\seelen\themes\default	界面恢复默认样式
2. 更新显卡驱动至最新版本	设备管理器显示驱动日期为最近
3. 清除图标缓存: 设置 → 通用 → 清除缓存	图标显示正常无缺失

【功能失效】窗口管理器功能异常

根本原因分析：布局配置错误或快捷键冲突

操作步骤	验证方法
1. 重置窗口管理器配置: %APPDATA%\seelen\window_manager.json	窗口布局恢复默认状态
2. 检查快捷键冲突: 设置 → 快捷键	无重复绑定的快捷键组合
3. 重启窗口管理服务	任务管理器中SeelenWM进程重启

【系统兼容】媒体控制功能失效

根本原因分析：音频服务未运行或权限不足

操作步骤	验证方法
1. 重启Windows音频服务: services.msc → Windows Audio → 重启	服务状态显示"正在运行"
2. 授予媒体访问权限: 设置 → 隐私 → 麦克风	权限开关处于启用状态
3. 重新初始化媒体模块	媒体控制界面显示当前播放内容

三、预防措施

【配置管理】系统设置备份

• 定期导出配置: 设置 → 系统 → 备份配置
• 备份路径: %USERPROFILE%\Documents\Seelen-Backups\
• 建议备份频率: 每周一次

【环境维护】系统兼容性管理

• 启用自动更新: 设置 → 关于 → 自动更新
• 监控系统变更: 安装新软件后重启Seelen-UI
• 定期检查日志: 设置 → 系统 → 诊断 → 生成报告

附录：日志关键错误码速查表

错误码	含义	解决方案
E001	WebView初始化失败	重新安装WebView2运行时
E002	配置文件损坏	删除配置目录并重启
E003	权限不足	以管理员身份运行
E004	主题文件缺失	重新安装默认主题
E005	服务未启动	重启Seelen服务

附录：环境兼容性检查表

检查项	最低要求	推荐配置
操作系统	Windows 10 2004	Windows 11 22H2
WebView2	100.0.1185.39	最新稳定版
.NET Framework	4.8	4.8.1
显卡驱动	2021年以后版本	最新WHQL认证驱动
系统内存	4GB	8GB+