大模型应用开发 / 系统课时
查看本地模型与详细信息
查看本地模型与详细信息
学习目标
完成本课后,你将能够:
- 使用
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。验收条件:可选字段缺失时程序不会崩溃。
按自己的节奏,确认真正理解。