ollama v0.33.0发布：Claude Desktop 接入、KV Cache 修复、长预填恢复全面升级

2026年8月26日，Ollama 发布 v0.33.0。 本次版本围绕 Claude Desktop 第三方网关接入、长上下文预填缓存恢复、Claude Code KV Cache 稳定性、DeepSeek Harness 启动兼容性、MLX 依赖与跨平台打包等方向进行了更新。 版本涉及 26 次提交、120 个文件变更，共有 6 位贡献者参与。

一、版本信息概览

Ollama v0.33.0 是一次覆盖桌面应用、模型调用链路、缓存机制、启动器以及跨平台构建的版本更新。

从更新内容看，本次发布的重点可以归纳为以下几个方面：

• Claude Desktop 可以更方便地通过 Ollama 作为第三方网关提供方进行配置；

• 修复 Agent 客户端取消长时间预填时可能发生的挂起问题；

• 提升预填恢复点的可靠性，取消后的请求可以从已完成的位置继续恢复；

• 修复带循环层模型在恢复预填时可能导致超长上下文从零重新处理的问题；

• 禁用 Claude Code 的“剩余 token 倒计时”系统消息，避免其破坏 KV Cache；

• DeepSeek Harness 启动器在全局 npm 安装失败时可回退至 npx；

• 更新 MLX 依赖；

• 修复因 macOS 特定假设导致 Linux 与 Windows 默认打包失败的问题；

• 补充 Claude Desktop 相关的连接、模型管理、自动模式、模型映射、交互响应与安全限制能力；

• 修复图片回退场景中字符串内容的保留问题。

此次版本的变化并不局限于单一功能，而是同时覆盖了桌面端接入体验、长请求运行稳定性、缓存复用效率、工具启动兼容性和多平台构建可用性。

二、Claude Desktop 接入 Ollama 第三方网关

v0.33.0 中最直观的一项更新，是加入 Claude Desktop 相关支持。

开发者现在可以更轻松地配置 Claude Desktop，使其能够与 Ollama 协同工作，并将 Ollama 作为第三方网关提供方使用。

这一变化对应的核心描述是：开发者可更便捷地完成 Claude Desktop 与 Ollama 的连接配置，实现 Claude Desktop 通过 Ollama 的第三方网关能力进行工作。

在提交记录中，Claude Desktop 相关功能并非单一提交，而是包含了一系列配套调整，覆盖接入、模型、设置、连接状态、安全边界与交互体验等层面。

本次版本中的 Claude Desktop 相关变化包括：

• 新增 Claude Desktop 应用；

• 新增“连接你的应用”体验；

• 新增 Claude 模型管理；

• 新增模型推荐端点签名；

• 新增 Claude Desktop 自动模式设置；

• 新增 Claude Desktop 模型映射；

• 在 Claude Desktop 网关中拒绝浏览器来源；

• 在连接过程中保持 Claude 开关的忙碌状态；

• 将 Claude Desktop 模型重置为默认值；

• 修复桌面端交互回归问题；

• 改进桌面集成的响应速度；

• 防止应用标题栏重叠；

• 使集成列表支持滚动。

从这些变更可以看到，v0.33.0 不仅增加了 Claude Desktop 的接入入口，也同时处理了模型管理、模型映射、自动模式、连接过程中的状态反馈、桌面端布局、列表滚动及网关来源限制等问题。

其中，“连接你的应用”体验是桌面端集成链路的一部分；Claude 模型管理与 Claude Desktop 模型映射则涉及模型相关配置；自动模式设置为 Claude Desktop 增加了相应设置项；模型重置功能可以将 Claude Desktop 模型恢复至默认状态。

在连接体验上，本次更新特别处理了连接中的开关状态：当连接仍在进行时，Claude 开关会保持忙碌状态。该变化使连接过程中的状态能够持续显示，而不会在尚未完成连接时提前结束对应状态。

在交互层面，版本修复了桌面交互回归问题，并提升桌面集成响应速度。同时，应用标题栏重叠问题得到处理，集成列表也已支持滚动，进一步完善了桌面端应用和集成页面的使用体验。

在安全限制方面，Claude Desktop 网关新增了对浏览器来源的拒绝处理。该项变更明确限制浏览器来源进入 Claude Desktop 网关。

三、长预填取消不再挂起：缓存恢复机制的重要修复

本次更新中，缓存机制的改进是另一个核心重点。

Ollama v0.33.0 修复了一个与 Agent 客户端相关的问题：当 Agent 客户端取消长时间预填时，可能出现挂起。

预填是请求处理过程中的关键阶段。对于较长提示内容，请求可能需要经历较长的预填过程。如果客户端在这一过程中取消请求，而取消逻辑和缓存状态处理没有正确收敛，就可能影响后续重试或恢复。

本版本针对这一问题进行了修复，目标是避免 Agent 客户端取消长预填时发生挂起。

同时，版本还强化了预填恢复点的可靠性。

更新说明明确指出：预填恢复点现在在设计上具备可信性。一个被取消的预填请求，会保留它所经过的每一个恢复点。这样，当请求重试时，可以从中断的位置继续恢复，而不是从头开始重新处理。

这一变化包含两个关键部分。

第一，取消中的预填不再丢失已经经过的恢复点。

此前，长预填过程如果中途被取消，后续重试可能无法充分利用已经完成的过程。v0.33.0 中，取消后的预填会保留其经历过的恢复点。

第二，重试请求可以从停止的位置继续执行。

更新描述强调，重试不会再从头重新开始，而是从此前停止的位置恢复。对于长提示请求而言，这意味着请求恢复逻辑不再依赖重新执行全部预填内容。

对应的提交记录中，与该能力相关的更新包括：

• 在请求于提示处理中途取消时保留预填快照；

• 在预填被取消时稳定草稿缓存；

• 将预填捕获内容裁剪到其前缀树节点的边界；

• 以完整子节点方式扩展前缀树，以便恢复点相关处理；

• 在关闭记录生成 token 时，将生成 token 换出。

这些变更共同围绕预填快照、草稿缓存、前缀树、恢复点和生成 token 处理展开。

其中，取消发生在提示处理中途时，预填快照将被保留。预填取消时，草稿缓存也会被稳定处理。与前缀树相关的更新则包括：将预填捕获裁剪至所属前缀树节点的边界，以及按完整子节点增长前缀树以处理恢复点相关能力。

此外，生成 token 在关闭记录时会被换出。这一调整同样出现在缓存处理相关的提交中。

四、修复恢复点覆盖不完整：避免超长请求从零开始重处理

除了保留取消请求经过的恢复点，v0.33.0 还处理了另一个更具体的恢复问题。

更新说明指出：恢复后的预填不再记录那些无法覆盖其声称范围的恢复点。

这一修复针对的是恢复点“看起来覆盖了某段内容”，但实际上未能完整覆盖对应内容的情况。

在带有循环层的模型上，这一问题此前可能带来严重影响：一个需要匹配 4.6 万个 token、总长度为 4.7 万个 token 的请求，可能被迫从零开始重新处理。

也就是说，原本请求已经非常接近完整匹配，仅剩少量内容差异，但由于恢复点的覆盖范围并不可信，恢复机制无法正确复用已有处理结果，最终导致整段超长内容重新执行。

v0.33.0 对此进行了修复：

• 恢复后的预填不再记录覆盖范围不完整的恢复点；

• 恢复点所代表的覆盖范围与其实际能够覆盖的内容保持一致；

• 在带循环层模型的相关场景中，避免近乎完整匹配的请求被迫从零重新处理。

这里的变化与“恢复点现在可信”相互对应。

一方面，取消请求会保留已经经历的恢复点；另一方面，恢复后的预填不会产生不正确、无法覆盖其声称范围的恢复点。前者保证恢复信息不因取消而丢失，后者保证恢复信息本身具备正确覆盖范围。

二者结合后，预填重试能够从实际停止位置继续，同时避免使用覆盖范围不正确的恢复记录。

五、禁用 Claude Code 剩余 Token 倒计时，保护 KV Cache

v0.33.0 还处理了 Claude Code 与 KV Cache 之间的一个兼容性问题。

更新说明中提到，Claude Code 的“剩余 token”倒计时系统消息已被禁用。

原因是，Ollama 会将这一系统消息移动到提示词前部，而这一变化会在每一次请求中破坏 KV Cache。

这项问题可以按更新说明中的逻辑理解：

• Claude Code 包含“剩余 token”倒计时系统消息；

• Ollama 会将该消息移动到提示词的前面；

• 该消息位置变化会导致每次请求的 KV Cache 被破坏；

• v0.33.0 禁用了这一“剩余 token”倒计时系统消息；

• 禁用后，该系统消息不再对 KV Cache 造成每次请求都失效的影响。

提交记录中，这项调整被描述为：禁用 Claude Code token 倒计时以保留 KV Cache。

这一更新与前文的预填缓存、恢复点、前缀树等修复共同构成 v0.33.0 在缓存链路上的主要改进。

一边是处理长预填请求被取消后的恢复能力，一边是避免系统消息位置变化破坏 KV Cache。两类更新都直接聚焦请求上下文处理与缓存复用过程。

六、DeepSeek Harness 启动器支持 npx 回退与 Windows 命令垫片

在启动工具兼容性方面，v0.33.0 更新了 DeepSeek Harness 启动器。

此次变化是：当全局 npm 安装失败时，启动器将回退使用 npx。

同时，这项能力包含 Windows 命令垫片支持。

更新说明明确提到两个条件与结果：

• 条件一：全局 npm 安装失败；

• 结果一：DeepSeek Harness 启动器回退到 npx；

• 条件二：在 Windows 环境使用；

• 结果二：支持 Windows 命令垫片。

对应的提交说明为：在启动 DeepSeek Harness 时，当全局 npm 安装失败则回退至 npx。

这一调整聚焦于启动路径的回退处理。当全局 npm 安装无法成功完成时，启动器不再仅依赖这一安装方式，而是使用 npx 作为回退路径。Windows 命令垫片支持则作为该更新的一部分被一并加入。

七、MLX 依赖更新与 Linux、Windows 打包修复

v0.33.0 还包含 MLX 相关更新。

提交记录中列出了 MLX 依赖更新，同时还修复了 macOS 特定假设对 Linux 与 Windows 构建造成的问题。

更新说明指出，默认打包此前存在损坏问题，原因是构建过程包含仅适用于 macOS 的假设，而这些假设影响到了 Linux 和 Windows 构建。

本版本对此进行了修复，涉及以下内容：

• MLX 依赖更新；

• 修复 Linux 与 Windows 上的 macOS 假设；

• 修复因 macOS 特定假设导致的默认打包损坏问题；

• 改善 Linux 和 Windows 的构建与打包结果。

在提交记录中，相关内容包括“修复 Linux、Windows 上的 macOS 假设”以及“MLX 更新”。

这意味着 v0.33.0 对跨平台默认打包问题进行了针对性处理，使 macOS 相关的假设不再影响 Linux 与 Windows 的默认打包路径。

八、图片回退场景保留字符串内容

本版本还有一项代理相关修复：在图片回退过程中保留字符串内容。

对应提交说明为：代理层在图片回退时保留字符串内容。

该项变更聚焦于图片回退场景，处理对象是字符串内容。v0.33.0 对此进行了修复，使图片回退流程中字符串内容能够被保留。

九、其他界面与编辑器防护更新

除上述核心能力外，本次提交中还包括编辑器字段索引相关防护。

具体变化为：在索引字段之前，对空编辑器进行保护。

该更新避免在编辑器为空的情况下继续进行字段索引操作。

同时，桌面端还包含以下界面与交互层面的更新：

• 优化引导页面布局；

• 禁用缩放；

• 防止应用标题栏重叠；

• 修复桌面交互回归；

• 提升桌面集成响应速度；

• 使集成列表可滚动。

这些变化与 Claude Desktop 接入相关更新一起，构成了 v0.33.0 对应用端界面、配置、连接与操作体验的补充。

十、按日期梳理本次提交变化

2026年8月21日

当天的提交内容包括：

• 修复 Linux 与 Windows 环境中的 macOS 假设问题；

• 更新 MLX；

• 处理代码检查相关修复；

• 新增 Claude Desktop 应用；

• 优化引导页面布局并禁用缩放；

• DeepSeek Harness 启动器在全局 npm 安装失败时回退到 npx。

这一阶段的更新主要覆盖跨平台构建、MLX、桌面应用初始能力、引导页面与 DeepSeek Harness 启动回退。

2026年8月22日

当天的提交内容包括：

• 在预填取消时稳定草稿缓存；

• 将预填捕获裁剪至前缀树节点边界；

• 在关闭记录生成 token 时将生成 token 换出；

• 通过完整子节点增长前缀树以处理恢复点；

• 请求在提示处理中途取消时保留预填快照；

• 新增“连接你的应用”体验；

• 新增 Claude 模型管理；

• 新增模型推荐端点签名；

• 禁用 Claude Code token 倒计时以保护 KV Cache；

• 修复应用标题栏重叠；

• 新增 Claude Desktop 自动模式设置；

• 新增 Claude Desktop 模型映射。

这一阶段是本次版本缓存与 Claude Desktop 能力最密集的更新阶段。预填取消、快照保留、草稿缓存、前缀树边界、恢复点以及 Claude Code 的 KV Cache 问题，都在这一时间段内集中处理。

2026年8月25日

当天的提交内容包括：

• 在索引字段前保护空编辑器；

• 修复桌面交互回归；

• 改进桌面集成响应速度；

• 使集成列表可滚动。

这一阶段主要针对编辑器防护与桌面端交互体验进行完善。

2026年8月26日

当天的提交内容包括：

• 在 Claude Desktop 网关中拒绝浏览器来源；

• 在连接过程中保持 Claude 开关忙碌状态；

• 将 Claude Desktop 模型重置为默认值；

• 在图片回退中保留字符串内容。

这些更新进一步补足了 Claude Desktop 网关限制、连接状态、模型默认值恢复以及代理图片回退处理。

十一、v0.33.0 更新内容完整汇总

Ollama v0.33.0 的完整更新重点如下：

• Claude Desktop 可更方便地配置为与 Ollama 第三方网关协同工作；

• 修复 Agent 客户端取消长预填时可能挂起的问题；

• 取消预填后保留所经过的全部恢复点；

• 重试请求可以从停止位置恢复，而非从头开始；

• 恢复后的预填不再记录无法覆盖其声称范围的恢复点；

• 修复带循环层模型中近乎完整匹配请求可能从零重新处理的问题；

• 禁用 Claude Code 的“剩余 token”倒计时系统消息；

• 避免该系统消息被移动到提示词前部后持续破坏 KV Cache；

• DeepSeek Harness 启动器在全局 npm 安装失败时回退至 npx；

• 支持 Windows 命令垫片；

• 更新 MLX 依赖；

• 修复 macOS 特定假设影响 Linux、Windows 默认打包的问题；

• 新增 Claude Desktop 应用；

• 新增“连接你的应用”体验；

• 新增 Claude 模型管理；

• 新增模型推荐端点签名；

• 新增 Claude Desktop 自动模式设置；

• 新增 Claude Desktop 模型映射；

• 拒绝浏览器来源访问 Claude Desktop 网关；

• 在连接期间保持 Claude 开关忙碌状态；

• 支持将 Claude Desktop 模型重置为默认值；

• 修复桌面交互回归；

• 改进桌面集成响应速度；

• 修复应用标题栏重叠；

• 集成列表支持滚动；

• 优化引导布局并禁用缩放；

• 在索引字段前保护空编辑器；

• 在图片回退中保留字符串内容。

十二、结语

代码地址：github.com/ollama/ollama

Ollama v0.33.0 的更新重点非常明确：一方面扩展 Claude Desktop 与 Ollama 的接入和配置能力，另一方面集中修复长预填取消、恢复点可信性、循环层模型恢复以及 Claude Code KV Cache 失效等缓存链路问题。

同时，版本还补充了 DeepSeek Harness 的 npx 回退能力，更新 MLX 依赖，修复 Linux 和 Windows 打包受到 macOS 假设影响的问题，并继续完善桌面端布局、滚动、连接状态、模型恢复与网关来源限制。

对于 v0.33.0 而言，Claude Desktop 接入、预填恢复点可靠性、KV Cache 保护以及跨平台构建修复，共同构成了本次发布的主要内容。

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。