ollama v0.30.5 更新：Hermes Desktop 上线、Windows 安装优化、Gemma4 崩溃修复、Cline CLI 集成文档全量补齐

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

Ollama v0.30.5 已于 2026 年 6 月 5 日发布。 这次更新虽然版本号看起来只是一次小版本升级，但实际内容非常扎实，涉及模型运行稳定性修复、Hermes 集成能力增强、Windows 安装体验优化、桌面版入口新增，以及文档与集成索引的大幅补全。对于正在使用 Ollama 做本地模型调用、CLI 集成、自动化安装和多工具联动的用户来说，这一版值得认真关注。

一、版本概览：v0.30.5 更新了什么

本次 v0.30.5 的主要变化可以概括为四个方向：

1. 1. 修复 gemma4:12b 的浮点异常崩溃
2. 2. Hermes 在 Windows 上的安装流程优化
3. 3. 新增 Hermes Desktop 集成
4. 4. 补充 Cline CLI 集成文档及相关文档入口

从提交记录来看，这次版本包含 4 个 commits，涉及 12 个文件变更，并且带来了较大规模的新增内容。尤其是 cmd/launch/hermes.go 的变化非常大，说明 Hermes 相关能力被明显增强和重构。

二、核心修复：修复 gemma4:12b 浮点异常崩溃

这次更新最关键的修复之一，是：

• • Fix gemma4:12b floating point exception crash

这意味着在特定情况下，gemma4:12b 可能出现浮点异常崩溃，而 v0.30.5 已经针对这个问题进行了修复。对于实际使用者来说，这类修复往往比新增功能更重要，因为它直接关系到模型推理是否稳定、是否会突然退出、是否会影响工作流。

对于使用 gemma4:12b 的场景，这次更新是一次必须重视的稳定性升级。

三、Hermes 相关更新：Windows 安装体验明显增强

这次版本中，Hermes 是绝对重点。

1. Hermes Windows 安装脚本更新

在更新说明中提到：

• • integrations: hermes windows install

这表明 Hermes 在 Windows 下的安装逻辑被补充了。代码里新增了两个关键常量：

• • hermesWindowsInstallURL
• • hermesWindowsInstallCmd

对应的 Windows 安装脚本来自 Hermes 官方仓库中的 install.ps1。 与 Linux/macOS 使用 bash 安装不同，Windows 这次走的是 PowerShell 路线。

代码中安装命令的逻辑也非常清晰：

• • Windows 下执行 PowerShell
• • 使用 -NoProfile
• • 使用 -ExecutionPolicy Bypass
• • 通过 irm 拉取安装脚本
• • 追加 -SkipSetup

这说明 Ollama 在 Windows 平台上不再只是简单提示用户去手动处理，而是把安装路径进一步打通了。

2. Hermes Desktop 新增：支持桌面应用启动

这次更新非常重要的一点，是新增了：

• • launch: hermes-desktop app

也就是说，Ollama 现在不只是支持 hermes，还新增了 hermes-desktop 入口。

在集成注册里，新增了：

• • hermes-desktop

在帮助文档和支持集成列表中，也加入了 Hermes Desktop 的说明。

这意味着用户可以直接通过类似下面的方式使用：

ollama launch hermes-desktop

而不是只局限于原有 Hermes CLI。

3. Hermes Desktop 的运行逻辑

从代码改动看，Hermes Desktop 不是简单换个名字，而是单独增加了一套运行逻辑。

新增了 HermesDesktop 结构体，它继承了 Hermes 的能力，并且实现了：

• • String() string
• • Run(...) error
• • Onboard() error
• • launchArgs(args []string) []string
• • shouldSkipDesktopBuild(args []string) bool
• • packagedAppExists() bool

这一组方法说明 Hermes Desktop 的启动行为是有额外判断的。

启动参数逻辑

launchArgs 会先生成：

[]string{"desktop"}

如果判断应该跳过构建，就会自动附加：

--skip-build

最后再拼接用户传入的参数。

也就是说，hermes-desktop 启动时本质上会走：

desktop

或：

desktop --skip-build

再加上用户自己的参数。

4. 自动判断是否跳过构建

新增的 shouldSkipDesktopBuild 逻辑也很关键。

它会检查以下情况：

• • 用户是否显式传了 --skip-build
• • 是否传了 --source
• • 是否传了 --build-only
• • 是否传了 --help
• • 是否传了 -h

如果有这些 flag，则不会自动加 --skip-build。 如果没有这些 flag，就会判断本地是否已经存在打包好的应用。

如果本地已经存在 packaged app，就自动追加 --skip-build。

这个行为非常实用，因为它减少了不必要的构建步骤，提升了启动效率。

5. packaged app 的存在检测

为了判断是否已经有可用的桌面应用，代码新增了 packagedAppExists()。

它会遍历多个安装根目录，然后在对应的 apps/desktop/release 下查找各平台打包产物。

支持的安装根目录包括：

• • HERMES_INSTALL_DIR
• • HERMES_HOME
• • 用户家目录相关路径
• • Windows 的 LOCALAPPDATA
• • Linux 的 /usr/local/lib/hermes-agent

这部分非常值得注意，因为它说明 Ollama 已经充分兼容 Hermes 的安装布局，而不是只认单一目录。

6. 不同平台的发布包路径识别

新增了 hermesDesktopPackagedExecutableCandidates()，按平台分别寻找可执行文件：

macOS

在 mac* 目录下匹配：

• • Hermes.app/Contents/MacOS/Hermes

Windows

查找：

• • win-unpacked/Hermes.exe
• • win-ia32-unpacked/Hermes.exe
• • win-arm64-unpacked/Hermes.exe

Linux

查找：

• • linux-unpacked/hermes
• • linux-unpacked/Hermes

这说明 Ollama 对 Hermes Desktop 的发布结构做了明确适配。

7. Windows 下 Hermes 二进制回退查找

这次还新增了 hermesWindowsBinaryFallbacks()。

它会尝试在以下位置查找 hermes.exe：

• • HERMES_HOME
• • LOCALAPPDATA
• • 用户 home 下的 AppData\Local

并生成多个备选路径，例如：

• • hermes-agent\venv\Scripts\hermes.exe
• • hermes\hermes-agent\venv\Scripts\hermes.exe

这一步的意义在于： 即使主路径找不到，也能在常见 Windows 安装布局里继续回退查找，提高可用性。

8. Windows 下的安装提示逻辑变化

这次更新之前，Windows 下 Hermes 可能主要是提示 WSL2。 更新后，行为更细化了。

新增的安装流程里：

• • 如果是 Windows，则走 PowerShell 安装脚本
• • 如果已经安装，返回安装结果
• • 如果缺少依赖，则输出依赖提示

同时，hermesWindowsHint() 仍然存在，用于提示用户：

• • Windows 需要 WSL2
• • 使用 wsl --install
• • 然后在 WSL shell 内运行 ollama launch hermes
• • 并附带官方安装文档链接

这说明 Windows 场景下，既有自动安装的增强，也保留了原有的使用约束说明。

四、Hermes 安装逻辑的优化

1. 安装命令按平台分流

新增了：

func (h *Hermes) runInstallScript() error

这个函数按平台分流：

• • Windows：PowerShell 安装
• • 非 Windows：bash 安装

原来统一的 bash 安装逻辑，现在被抽成了平台判断，更清晰，也更符合实际环境。

2. 依赖检测逻辑修正

ensureInstalledFor(command string) 也被改造了。

更新后：

• • Windows 直接给出 WSL 提示
• • 非 Windows 才检查依赖 bash、curl、git

如果缺少依赖，会输出提示：

• • 先安装缺失依赖
• • 然后重新运行 ollama launch <command>

这里 <command> 会根据传入的参数变化，避免只写死成 hermes。

这也是本次更新很实用的一点： hermes-desktop 和 hermes 在安装提示上有了更准确的区分。

五、新增 Hermes Desktop 集成入口

在注册表中，新增了一个完整的集成定义：

• • Name: hermes-desktop
• • Runner: &HermesDesktop{}
• • Description: Desktop app for Hermes Agent by Nous Research
• • Install URL: 官方 Hermes 安装文档链接

并且它的安装检测逻辑是：

• • 通过 Hermes{}.installed() 判断是否已安装
• • 通过 Hermes{}.ensureInstalledFor("hermes-desktop") 执行安装

这说明 hermes-desktop 并不是完全独立的产品，而是基于 Hermes 安装体系扩展出来的桌面入口。

六、文档更新：Cline CLI 集成文档正式加入

这次版本还新增了一个完整文档：

• • docs/integrations/cline-cli.mdx

同时还加入了相关图片：

• • docs/images/cline-cli.png
• • docs/images/cline-kanban.png

以及文档目录索引和文档 JSON 配置更新。

1. Cline CLI 是什么

文档中对 Cline CLI 的定位是：

• • 一个面向交互式终端会话的自主编码代理

和 IDE 扩展版 Cline 区分开来，这里强调的是 CLI 版本。

2. 安装方式

文档给出的安装方式是：

npm install -g cline

并说明如果 Cline CLI 尚未安装，而 npm 可用，则执行：

ollama launch cline

时会提示安装 cline@latest。

这说明 Ollama 对 Cline CLI 的集成已经具备自动引导安装的能力。

3. Ollama 与 Cline CLI 的联动方式

文档详细说明了通过 Ollama 启动 Cline 时，Ollama 会自动做几件事：

• • 将 provider 设置为 Ollama
• • 指向本地 Ollama 端点
• • 选择用户指定的模型

这意味着用户无需手动反复配置，启动后即可进入联动状态。

4. 主要用法

文档里给了多个示例。

快速启动

ollama launch cline

只做配置，不启动

ollama launch cline --config

指定模型启动

ollama launch cline --model qwen3.5

使用云端模型

ollama launch cline --model kimi-k2.6:cloud

透传提示词

ollama launch cline -- "summarize this repository"

打开 Kanban 看板

ollama launch cline -- kanban

手动配置流程

先拉取模型：

ollama pull qwen3.5

然后执行：

cline auth

在交互流程中选择 Ollama 作为 provider，必要时填写：

• • http://localhost:11434

再选择模型，如：

• • qwen3.5
• • kimi-k2.6:cloud

最后可通过：

cline config

查看当前配置，通过：

cline

启动交互会话。

七、集成列表与排序更新

这次版本还同步更新了集成注册和展示列表。

1. 支持集成列表新增 Hermes Desktop

在集成查找测试中，新增：

• • hermes-desktop

在注册表测试里，期望列表也新增了这个名字。

在自动可安装集成测试中，也把：

• • hermes-desktop

标记为可自动安装。

2. 启动页帮助信息更新

在 launch.go 的支持集成列表中，也加入了：

• • hermes-desktop

并在示例中加入：

• • ollama launch hermes-desktop

这说明用户在命令行里查看帮助时，能直接看到该入口。

3. 集成顺序调整

launcherIntegrationOrder 中新增了：

• • hermes-desktop

放在 opencode 和 codex 之间。

这会影响集成展示顺序，使 Hermes Desktop 在列表中更容易被发现。

4. 文档索引更新

docs/docs.json 和 docs/integrations/index.mdx 中也加入了：

• • Cline CLI

这意味着文档首页和导航入口已经完整接入。

八、测试更新：覆盖 Hermes Desktop 与 Windows 安装场景

本次更新补充了大量测试，确保新逻辑稳定。

1. Hermes Desktop 运行测试

新增测试覆盖：

• • desktop 子命令
• • 已存在 packaged app 时自动跳过构建
• • 显式 --skip-build
• • --source
• • --build-only
• • --help

这些测试验证了 launchArgs 和 shouldSkipDesktopBuild 的行为。

2. Windows LocalAppData 包路径测试

新增测试验证：

• • Windows 平台下能从 LOCALAPPDATA 找到 desktop release 包

这说明 Windows 安装路径识别已经被单独验证。

3. Linux root 安装路径测试

新增测试验证：

• • Linux root install 路径会被包含在 release roots 中

即：

• • /usr/local/lib/hermes-agent/apps/desktop/release

4. Windows 安装流程测试

新增了对 Windows 安装器的测试，验证：

• • 调用 PowerShell
• • 参数包含 -NoProfile
• • -ExecutionPolicy Bypass
• • -Command
• • 安装脚本 URL
• • -SkipSetup

这说明新安装逻辑不是只改了文案，而是完整覆盖了执行路径。

九、整体总结：这次更新的实际意义

如果把 v0.30.5 的更新做一个整体总结，可以概括为以下几点：

1. 稳定性提升

修复了 gemma4:12b 的浮点异常崩溃问题，直接改善模型运行稳定性。

2. Hermes 生态增强

不仅修复了 Hermes Windows 安装问题，还新增了 Hermes Desktop 入口，支持更完整的桌面应用启动链路。

3. Windows 体验更完善

从安装脚本、可执行文件查找、回退路径、安装提示，到测试覆盖，Windows 相关逻辑都得到了加强。

4. 文档体系更完整

Cline CLI 的独立文档补齐，集成首页、JSON 索引、图片资源都已同步更新。

5. 命令行体验更统一

ollama launch 的集成列表更加丰富，用户可直接通过命令行启动更多工具和代理应用。

十、结语

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

Ollama v0.30.5 不是一次单纯的小修小补，而是一次围绕稳定性、集成体验、跨平台支持和文档完善的集中升级。 尤其是 Hermes Desktop 的加入，以及 Windows 安装逻辑的强化，让这个版本在实际可用性上明显更进一步。

·

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。