Windows 启动与安装问题

如果 Windows 用户反馈“打不开”“白屏”“没有任何反应”，请优先按本页顺序排查。

最快处理顺序

1. 先确认安装包类型
2. 再确认运行时与系统拦截
3. 再检查本地目录权限
4. 最后收集日志反馈

先确认安装包

推荐优先使用：

• Lime_*_x64-online-setup.exe

不建议优先分发：

• 便携版压缩包
• 旧的 .msi 安装包

原因：

• 在线安装包体积更小，适合大多数 Windows 10/11 用户
• 如果处于离线、内网或受限网络环境，请改用 Lime_*_x64-offline-setup.exe

常见症状与处理

双击后无反应

处理建议：

1. 确认下载来源可信
2. 如果被 SmartScreen 拦截，点击“更多信息”后再确认是否继续
3. 重新运行 Windows setup 安装包覆盖安装
4. 安装后从开始菜单再次启动

启动后白屏

处理建议：

1. 优先重装 Windows setup 安装包，补齐 WebView2 Runtime
2. 检查系统是否禁用了 Edge WebView2 Runtime
3. 再确认本地目录是否可写

提示缺少运行时

处理建议：

1. 不要先手动找旧版运行时
2. 先重新运行 Windows setup 安装包
3. 如仍失败，再单独检查 WebView2 Runtime 是否安装完整

目录权限检查

以下目录至少要保证当前用户可读写：

• %APPDATA%\lime\
• %USERPROFILE%\.lime\

这些目录分别用于：

• 配置与凭证副本
• 数据库、日志、请求日志和部分运行时状态

如果目录不可写，常见表现包括：

• 启动后立即退出
• 白屏
• 功能区能打开但数据无法加载

日志收集

反馈问题前，建议至少收集以下内容：

• %USERPROFILE%\.lime\logs\
• %USERPROFILE%\.lime\request_logs\
• 问题出现时间
• 安装包文件名
• 页面或弹窗提示截图

一键收集（推荐给支持/开发环境）

如果你有仓库脚本环境，可直接运行：

powershell -ExecutionPolicy Bypass -File .\scripts\windows-collect-support-bundle.ps1

脚本会：

• 打包 %USERPROFILE%\.lime\logs\ 与 request_logs\
• 收集 WebView2、PowerShell、目录存在性等环境信息
• 默认不打包 config.yaml、数据库和凭证正文，避免泄露敏感信息

执行完成后，会在桌面生成 Lime-Support-时间戳.zip。

如果应用本身还能打开，也可以在“设置 / API 服务器 / 诊断接口”区域点击“导出支持包”。

如果页面出现 Windows 启动自检提示

新版本会在部分场景下提示以下问题：

• 应用数据目录不可写
• 用户目录数据根不可写
• 数据库不可访问
• 未检测到 WebView2 Runtime
• 未检测到 PowerShell 或 cmd.exe

建议按提示顺序处理，不要一开始就同时修改多项系统设置。

仍然无法恢复怎么办

请整理以下最小信息后反馈：

1. Windows 版本
2. Lime 版本
3. 使用的安装包文件名
4. 首次出现时间
5. 日志目录压缩包