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. 修复 gemma4:12b 的浮点异常崩溃
2. Hermes 在 Windows 上的安装流程优化
3. 新增 Hermes Desktop 集成
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. 安装方式

文档给出的安装方式是：

npminstall-gcline

并说明如果 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--modelqwen3.5

使用云端模型

ollama launch cline--modelkimi-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 安装逻辑的强化，让这个版本在实际可用性上明显更进一步。