大模型应用开发 / 系统课时

查看本地模型与详细信息

查看本地模型与详细信息

学习目标

完成本课后,你将能够:

  • 使用 ollama list 查看本地模型清单
  • 使用 ollama show 读取模型元数据
  • 查看模型模板、参数和许可证
  • 根据详情判断模型规模与运行要求

查看本地模型清单

执行:

bash
ollama list

预期输出示例:

text
NAME          ID          SIZE      MODIFIED
gemma3:1b     <MODEL_ID>  <SIZE>    <MODIFIED>

ollama ls 与 ollama list 可用于列出模型。清单中的 SIZE 是本地模型数据的展示值,不等同于模型运行时的全部内存或显存需求。

查看模型详情

执行:

bash
ollama show gemma3:1b

预期输出通常包含:

text
Model
  architecture        <ARCHITECTURE>
  parameters          <PARAMETER_SIZE>
  context length      <CONTEXT_LENGTH>
  embedding length    <EMBEDDING_LENGTH>
  quantization        <QUANTIZATION_LEVEL>

Capabilities
  <CAPABILITIES>

Parameters
  <PARAMETERS>

License
  <LICENSE_SUMMARY>

不同模型的字段、能力和许可证内容不同。不存在的字段不应由应用自行补造。

查看原始 Modelfile

执行:

bash
ollama show --modelfile gemma3:1b

预期输出示例:

text
# Modelfile generated by "ollama show"
FROM <LOCAL_BLOB_PATH>
TEMPLATE """<MODEL_TEMPLATE>"""
PARAMETER <NAME> <VALUE>

FROM 可能指向本地内容摘要路径。复制此输出创建新模型时,建议把 FROM 改为可理解且可移植的模型名称和标签。

单独查看模板或参数

根据当前 CLI 支持的选项,可以先查看帮助:

bash
ollama show --help

预期输出:

text
<SHOW_COMMAND_HELP>

再使用帮助中列出的选项查看模板、参数、系统提示词或许可证。CLI 选项可能随版本变化,教程不应假定所有旧选项长期存在。

通过 API 获取详情

执行:

bash
curl --fail --silent --show-error http://localhost:11434/api/show   -H "Content-Type: application/json"   -d '{"model":"gemma3:1b"}'

预期响应结构:

json
{
  "license": "<LICENSE>",
  "modelfile": "<MODELFILE>",
  "parameters": "<PARAMETERS>",
  "template": "<TEMPLATE>",
  "details": {
    "format": "gguf",
    "family": "<FAMILY>",
    "parameter_size": "<PARAMETER_SIZE>",
    "quantization_level": "<QUANTIZATION_LEVEL>"
  },
  "capabilities": ["<CAPABILITY>"]
}

响应可能包含更多字段。程序应按需要读取字段,并允许可选字段缺失。

建立资产记录

建议至少记录:

字段 用途
完整模型名与标签 可重复拉取和调用
本地摘要或 ID 识别具体内容版本
参数规模 初步评估计算量
量化等级 评估体积和质量取舍
上下文长度 规划长文本任务
能力列表 判断是否支持视觉、嵌入或工具
模板与系统参数 排查消息格式和停止条件
许可证 判断分发与商业使用边界

模型能被下载不代表许可证允许任意再分发或商业使用。

避免错误解读

  • SIZE 小不代表生成一定快,计算架构与硬件同样重要。
  • 标称上下文长度不代表当前 Ollama 实例已经分配同样长度。
  • 能力列表用于筛选,但最终仍要运行测试。
  • 同名标签可能更新,稳定环境应记录摘要和评测日期。
  • 模板是模型协议的一部分,错误修改可能破坏角色边界或停止条件。

本课练习

练习 1:生成模型资产表

任务目标:整理本地模型信息。输入或初始条件:本地至少有两个模型。实现要求:记录名称、参数、量化、能力和许可证

验收条件:信息均来自 list 或 show,没有凭名称猜测。

练习 2:比较两个量化版本

任务目标:理解详情字段的差异。输入或初始条件:同一模型的两个量化标签。实现要求:比较大小、量化等级和运行情况。验收条件:指出哪些结论来自元数据,哪些需要实测。

练习 3:解析 show API

任务目标:练习程序化读取模型详情。输入或初始条件:Ollama API 正常。

实现要求:使用任意语言读取 details 和 capabilities。验收条件:可选字段缺失时程序不会崩溃。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

查看本地模型与详细信息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通