在 2026 年 2 月 7 日,Ollama 官方正式发布 v0.15.6 最新版本。本次更新虽然版本号看似小幅提升,但实际上内部改动巨大,涉及 模型加载机制、上下文处理限制、环境变量配置、Docker 构建路径调整、云端模型拉取逻辑优化、tokenizer 模块重构 等众多核心模块。整个更新包含 9 次提交、113 个文件修改、702 行新增与 6,833 行删除,可视为一次结构性优化版本。本文将完整梳理本次更新的变更内容、模块调整、开发者侧的影响及向下兼容性分析。
一、版本概览
发布信息
- • 版本号:v0.15.6
- • 发布日期:2026年2月7日
- • 主要更新者:核心团队成员贡献
- • 提交数量:9 次
- • 修改文件:113 个
- • 新增代码行数:702 行
- • 删除代码行数:6833 行
- • 主要贡献模块:
- •
cmd/config - •
anthropic - •
llm/server - •
model - •
runner - •
sample - •
server - • 新增子包
tokenizer - • 替换
x/mlxrunner→x/imagegen
本次更新的核心议题
-
- 修复
ollama launch droid的上下文限制 (context limits)
- 修复
-
ollama launch命令在缺少模型时自动下载模型,而不再报错
-
- 解决
ollama launch claude提供图像时造成上下文压缩 (context compaction) 的问题
- 解决
-
- 新增
ANTHROPIC_*环境变量支持 Claude Code 的模型调用逻辑
- 新增
-
- 增强
cmd/config相关测试,新增多项自动化覆盖测试
- 增强
-
- 分离与独立
tokenizer模块,将文本处理逻辑彻底从model包迁移
- 分离与独立
-
- 将
x/mlxrunner模块重构为x/imagegen
- 将
-
- 修正 Dockerfile 构建路径错误 —
mlx目录层级更新
- 修正 Dockerfile 构建路径错误 —
-
- 修改 FAQ:增加关于
OLLAMA_NUM_PARALLEL并行参数所需的内存说明
- 修改 FAQ:增加关于
二、核心功能改动解析
(1)上下文限制修复——ollama launch droid 与 Qwen3-Coder-Next 支持
在本次更新中,最重要的一项修复就是 上下文限制 (context limits) 问题。 此前在某些情况下,使用命令:
ollama launch droid
时,模型在运行过程中出现上下文溢出或响应不稳定问题。
此次版本专门引入新的逻辑,使得 Droid 模块在本地及云端模型场景下动态调整 maxOutputTokens。若检测到为云模型,则通过查表自动应用云模型限制值;例如 qwen3-coder-next 新增支持 Context: 262,144 与 Output: 32,768。
if isCloudModel(context.Background(), client, model) { if l, ok := lookupCloudModelLimit(model); ok { maxOutput = l.Output }}
在对应的测试文件 cmd/config/droid_test.go 中,也新增了完整的测试用例 TestDroidEdit_CloudModelLimitsUsed,确保云模型输出上限可被正确识别,并通过本地与 :cloud 后缀的兼容性校验。
(2)ollama launch 自动下载缺失模型
在旧版本中,如果所选模型未存在于本地缓存中,命令会直接报错退出,用户需手动执行 ollama pull model。
v0.15.6 版本将此部分逻辑重写为 自动检测 + 用户交互式确认下载。
新增函数 showOrPull(ctx context.Context, client *api.Client, model string):
if _, err := client.Show(ctx, &api.ShowRequest{Model: model}); err == nil { return nil}if ok, err := confirmPrompt(fmt.Sprintf("Download %s?", model)); err != nil { return err} else if !ok { return errCancelled}return pullModel(ctx, client, model)
通过与 client.Show 判断模型存在性结合,当模型缺失时自动触发下载提示。
在 cmd/config/integrations.go 中,这一逻辑被嵌入 launch 命令的验证流程,多处验证调用此函数替换原 not found 错误。
对应测试 TestShowOrPull_ModelExists 与 TestShowOrPull_ModelNotFound_NoTerminal 模拟了在线检测及无终端场景。
(3)Claude 环境变量增强
在 cmd/config/claude.go 中新增了 modelEnvVars 函数,用以为 Claude Code 环境配置多层模型别名。
新增环境变量包括:
- •
ANTHROPIC_DEFAULT_OPUS_MODEL - •
ANTHROPIC_DEFAULT_SONNET_MODEL - •
ANTHROPIC_DEFAULT_HAIKU_MODEL - •
CLAUDE_CODE_SUBAgent_MODEL
其作用是根据用户保存的 alias 配置动态调整各层次调用关系。例如:
return []string{ "ANTHROPIC_DEFAULT_OPUS_MODEL=" + primary, "ANTHROPIC_DEFAULT_SONNET_MODEL=" + primary, "ANTHROPIC_DEFAULT_HAIKU_MODEL=" + fast, "CLAUDE_CODE_SUBAGENT_MODEL=" + primary,}
并在 cmd/config/claude_t…