AI 排查软件报错能帮助你整理线索，但只凭一个“加载失败”弹窗，通常无法判断是网络、权限还是数据问题。本文给出适合普通 Windows 用户的排错流程：保留错误、复现、只读检查、单项验证与回退。它适用于日常软件和本地服务，不要求一开始就会写代码。
一、截图要完整，也要保护隐私
保留应用名称、错误代码、出错时间和相关窗口，不只截一个红色图标。遮住口令、邮箱与个人目录中的敏感片段，但别把真正的错误路径全部遮掉。需要分享日志时，仅截取与故障有关的部分。
对一条模糊提示，可以先让支持图片输入的工具逐字转录。识别不清的字符标记待确认，不让它凭常见错误码自动补齐。
二、写一份最小问题单
应用与版本：[实际填写]
系统：[实际Windows版本]
操作：打开哪个页面、点击什么后出现问题
预期：希望看到什么
实际：错误原文与代码
频率：每次 / 偶发 / 只在某个文件发生
最近变化：更新、换目录、改网络等
已尝试：列动作及结果，不只写“试过了”
限制：先只读排查，不删除数据、不重装、不改权限。
最近变化很重要，但相关不等于原因。不要因为昨天升级了软件，就直接认定升级造成故障；先设计能验证的检查。
三、要求 AI 给出有次序的假设
依据问题单列出最多3个可能原因，按证据强弱排序。
每个原因给出：支持证据、缺失信息、一个只读检查、预期结果。
不要把推测写成已确认事实。
所有命令先解释读取什么；涉及写入、删除或重启时单独指出影响。
不知道应用的具体功能时先查官方说明，不编造菜单。
例如本地页面打不开，可以先确认程序是否在运行、地址是否正确和端口是否监听。不能跳过这些检查，就让用户关闭所有防火墙或重装系统。
四、只读检查的演示
如果你确实运行了 Ollama，可用下面命令检查本机 11434 端口。换成其他软件时，先从其官方文档确认端口，不随意扫描别人的设备。
Test-NetConnection -ComputerName 127.0.0.1 -Port 11434
TcpTestSucceeded 为 True 只能说明端口连接成立，不代表模型、账号或业务请求正常。下一步应检查对应接口或应用日志，不能直接宣布问题解决。
| 检查结果 | 可能的下一步 |
|---|---|
| 进程未运行 | 查看启动日志与启动失败原因 |
| 端口不通 | 核对监听地址和服务状态 |
| 端口通但接口报错 | 检查请求路径、模型或认证 |
| 只在一个文件失败 | 用不敏感小样本检查格式与权限 |
五、每次只验证一个变化
修改前记录原设置，应用一项改动后，用相同步骤复现。如果同时换网络、升级版本、清缓存又改权限，即使恢复了，也很难知道原因，更难复用经验。
问题解决后保存“症状、原因、改动、验收、回退”五项记录。不要保留含登录令牌的完整截图作为公开教程素材。
六、常见问题与排错
AI 总让我重装怎么办？
要求它先给出证据和只读检查，并说明重装会改变什么。数据不明时，不把重装当作默认第一步。
错误消失一次算修好吗？
用原来的复现步骤重复验证，检查重启后是否仍正常。偶发问题还要记录时间与环境。
它给出的命令看不懂怎么办？
先让它逐段解释读写对象、权限与影响，再对照官方命令说明。不要只因为命令短就直接执行。
本地模型接口问题可继续看Ollama API 排错。端口检查用途见 Microsoft Test-NetConnection 文档。