排查之前，先搞清楚一件事：Ollama 有两个不同的 API 接口，分别负责不同的状态。很多时候，模型明明已经下载，接口却返回空数组；或者显存还在占用，但怎么也找不到释放的模型。这通常不是因为程序出了 bug，而是用错了查询命令。
/api/tags 列出的是已经保存到本机的模型（磁盘上的清单），/api/ps 列出的是当前仍加载在内存中的模型（运行中的快照）。这两个接口各有各的用途，分开查才能定位问题。
这套检查方法适用于 Windows、macOS 和 Linux。前提条件很简单：Ollama 已安装，本地服务正在运行，并且终端能访问 localhost:11434。所有操作都是只读查询，不会拉取、删除或改名模型；示例返回里的模型名、体积、时间和显存数值会随本机环境变化，不必纠结具体数字。
Windows 用户建议在 PowerShell 或 Windows Terminal 中使用 curl.exe，避免旧版 PowerShell 把 curl 解释成其他命令。macOS 和 Linux 可直接使用 curl。如果 Ollama 配置了不同端口，记得把命令中的 11434 换成实际监听端口。
先查本机保存了哪些模型
-
先从系统终端开始。Windows 打开 PowerShell 或 Windows Terminal，macOS 打开“终端”，Linux 打开当前桌面环境使用的终端。确认 Ollama 应用或服务已经启动。
第一次请求只读取清单。Windows 执行
curl.exe localhost:11434/api/tags，macOS 或 Linux 执行curl localhost:11434/api/tags。请求方法是 GET，不需要 JSON 请求体。返回内容决定通路是否建立。成功标志是：终端得到一个 JSON 对象，顶层包含
models数组。数组里有对象，表示本地已有模型。返回{"models":[]}，表示接口可用，但当前模型目录没有可列出的模型。错误信息要按类型处理。连接失败时先启动 Ollama，再核对端口。出现 404 时检查路径是否完整写成
/api/tags。Windows 出现参数或别名提示时，确认执行的是curl.exe。
Ollama API Reference 的 List models 页面同时给出了 GET 路径和本机请求示例。截图里左侧的 /api/tags 是接口入口，右侧命令是可以在终端复现的请求。
读懂模型列表里的关键字段
-
清单留在刚才的终端里。从
models数组的第一个对象开始查看。有多个对象时，逐个按相同字段核对。字段要按身份和规格分开读。先记下
name或model，再查看modified_at、size和digest。判断规格时，继续看details内的format、family、parameter_size与quantization_level。一条对象应能说明一个模型。成功标志是：能够确定完整名称、修改时间、字节体积和内容摘要。还能读出格式、模型家族、参数规模与量化级别。后续运行或删除时，使用这里返回的完整名称。
缺项不能靠猜测补齐。字段缺失时先保留原始 JSON。不同模型或 Ollama 版本可能返回不同细节。终端输出挤成一行时，可用本机已有的 JSON 格式化工具查看，但不要改动字段名。
官方返回示例把模型身份和模型细节分成两层。排查“是否下载过”主要看 models、name 和 digest；判断模型规格再进入 details，不要把参数规模误当成文件体积。
再查哪些模型仍在运行
-
运行状态仍从终端读取。继续使用同一个查询窗口。若要观察明确状态，可在另一个终端执行
ollama run 模型完整名称并保持会话，再回到查询窗口。第二次请求只查看加载情况。Windows 执行
curl.exe localhost:11434/api/ps，macOS 或 Linux 执行curl localhost:11434/api/ps。这个 GET 请求不会启动或停止模型。数组内容就是当前快照。成功标志是：终端返回带有
models数组的 JSON。出现模型对象，说明它仍被 Ollama 加载。空数组表示查询成功，但此刻没有模型处于加载状态。接口错误与空结果要分开。连接失败时按第一步检查服务和端口。404 时确认路径是
/api/ps。刚结束会话就得到空数组并不一定异常，模型可能已经到达卸载条件。
List running models 页面把接口定义为 /api/ps，用途是读取当前运行中的模型。它和操作系统的 ps 命令不是一回事，也不会列出 Ollama 之外的进程。
用运行字段判断内存与卸载时间
-
先锁定目标对象。在
/api/ps的models数组中找到目标模型。用name和digest与/api/tags的结果对应。资源判断只看三个新增字段。读取
expires_at、size_vram和context_length。它们分别表示加载状态的到期时间、显存使用量和当前上下文长度。目标状态应能被单独描述。成功标志是：能够确认模型是否在内存中，以及显存、上下文长度与到期时间。多个模型同时出现时逐个记录，不能把第一项当成全部状态。
两个接口不一致往往不是故障。
/api/tags有模型而/api/ps没有，通常表示模型已下载但未加载。刚启动仍查不到时，确认运行与查询指向同一台机器、同一端口和同一个服务。
运行状态响应除了重复模型身份与规格字段，还增加了到期时间、显存和上下文长度。截图中的这些字段用于判断资源占用；磁盘里是否存在模型，仍应以 /api/tags 为准。
把两次查询合成一个状态判断
-
比较前先固定查询范围。并排保留同一时间取得的
/api/tags与/api/ps输出。按完整模型名核对，名称相近时再比较digest。状态归类只需要三种结果。两个数组都有目标，记为“已下载且当前加载”。只在
/api/tags中间出现，记为“已下载但当前空闲”。两个数组都没有时，先检查名称与模型目录。每个模型只能落入一种状态。成功标志是：磁盘存在性与内存加载情况没有混写。需要持续监控时，定时保存两次 GET 的原始 JSON，并附上查询时间。
环境不一致时不能硬比。两次结果来自不同端口或机器时停止比较。查询间隔过长时重新连续执行两条命令。只凭
name无法确认时，再核对digest，不要按数组顺序配对。
最常见的误判是看到 /api/ps 空数组就认为模型被删除。空数组只说明当前没有模型加载到内存；只要 /api/tags 仍能列出目标，它就还在本地模型清单中。
完成检查清单
服务可达：两条请求都能返回 JSON，而不是连接失败或 404。
本地清单明确：
/api/tags中每个目标模型的完整名称、摘要和体积已经记录。运行状态明确：
/api/ps中是否存在目标模型已经确认，空数组没有被误判成删除。资源字段可读：运行模型的到期时间、显存使用量和上下文长度已经分别核对。
环境一致：两次查询指向同一台机器、同一端口和同一个 Ollama 服务。
图片可访问：4 张接口入口与返回字段截图均能打开，并且每张只承担一个检查点。
