灵光AI启动失败需按顺序排查：先确认系统兼容性（Win10 22H2+/macOS 12.0+且芯片匹配），再清除残留配置与认证服务，最后运行诊断脚本定位网络、进程、版本三类问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
灵光AI安装后点击图标无反应、刚弹出窗口就消失、控制台报错后进程终止——这不是软件本身坏了，而是启动链路上某个环节被系统拦截、配置污染或服务未就绪。必须按真实启动顺序逐层验证，跳过任意一层都可能反复重装失败。
确认系统与架构兼容性
闪退发生在加载第一行代码前，说明连初始化环境都没通过。Windows用户必须运行Win10 22H2或更高版本；macOS用户必须是Monterey（12.0）及以上，且芯片类型为Apple Silicon（M系列）或x64架构Intel处理器。按下Win+R输入winver回车核对版本号；macOS点左上角苹果图标→“关于本机”，重点看【系统版本】和【芯片】两项。若显示“Intel Core i5-7200U”或“MacBook Air (Mid 2011)”等老旧型号，【该设备无法运行灵光AI，后续所有操作无效】。右键“此电脑”→“属性”，确认“系统类型”明确写着“64位操作系统，x64-based processor”或“Apple Silicon”——ARM64可运行，但必须关闭Rosetta模式，勾选“使用Rosetta打开”反而会导致指令翻译失败而闪退。
清除损坏的配置与认证服务残留
卸载重装无效，是因为%APPDATA%或~/Library里藏着损坏的token、冲突的UI缓存或过期的证书密钥。这些文件不会随卸载自动删除，新进程一读取就崩溃。
方法一：手动重命名配置目录（推荐）
1、确保灵光AI所有进程已结束：任务管理器（Ctrl+Shift+Esc）→“详细信息”页，结束所有含lingguang、authd、minimax字样的进程。
2、Windows用户按Win+R输入%APPDATA%\Minimax\LingguangAI\回车，将整个LingguangAI文件夹重命名为LingguangAI_backup；
3、macOS用户打开终端，执行：mv ~/Library/Application\ Support/Minimax/LingguangAI ~/Library/Application\ Support/Minimax/LingguangAI_backup。
4、重启电脑，再双击桌面图标启动——此时会生成全新配置目录，跳过所有旧数据污染路径。
方法二：强制清理认证服务残留
Windows用户以管理员身份运行命令提示符，依次执行：
taskkill /f /im lingguang-authd.exe
del /q "%LOCALAPPDATA%\Minimax\lingguang-authd\*"
macOS用户在终端运行：
pkill -f lingguang-authd
rm -rf ~/Library/Caches/Minimax/lingguang-authd
这一步能解决“刚点开就消失”且控制台无报错的典型场景。
运行诊断脚本定位根因
手动查环境变量、端口、进程容易遗漏关键项，必须用官方诊断脚本统一抓取17类指标。
第一步：下载对应系统诊断脚本
Windows用户点击下载windows_lingguang.bat；macOS用户下载mac_lingguang.sh。
第二步：以管理员权限运行
Windows右键→以管理员身份运行脚本；macOS终端执行：
chmod +x mac_lingguang.sh && ./mac_lingguang.sh
第三步：查看自动生成的日志文件
脚本执行完毕后生成带时间戳的日志，例如【Lingguang_Log_20260616_1942.txt】，路径显示在命令行末尾，通常与脚本同目录。
第四步：搜索三类关键词精准排查
① 搜索「[网络设置]」→ 若显示proxy_enabled=true但未在灵光AI设置中配置代理地址，会导致所有请求超时；此时需进入IDE插件设置页，手动填入HTTP/HTTPS代理地址和端口。
② 搜索「[Lingguang 进程存在性]」→ 若提示process not found，说明后台服务根本没启动；macOS下运行ps aux | grep lingguang确认进程是否存在。
③ 搜索「[version测试]」→ 若出现failed to connect to public server，大概率是DNS污染或出口IP被限流；此时不要改hosts，而是复制报错中的URL，在浏览器中手动访问，确认能否返回JSON响应。
