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 的集成文档和相关入口。从代码提交记录来看，这次版本涉及12个文件的变更，改动量不小。特别值得注意的是，`cmd/launch/hermes.go` 这个文件变化巨大，说明 Hermes 相关的能力被重写并显著增强了。
二、核心修复：gemma4:12b 浮点异常崩溃
这次更新最关键的修复之一，就是解决了 `gemma4:12b` 的浮点异常崩溃问题。对于实际使用来说，这类底层稳定性修复的重要性，往往超过一堆花哨的新功能。它直接关系到模型推理的稳定性和工作流的可靠性。如果你的工作流中恰好用到了 `gemma4:12b`，这次的升级可是一次必须重视的稳定性补丁。
三、Hermes 相关更新：Windows 体验的全面强化
在 v0.30.5 中，Hermes 是绝对的主角，更新力度非常大。
1. Hermes Windows 安装脚本更新
更新说明中明确提到了 `integrations: hermes windows install`。这表明 Hermes 在 Windows 下的安装逻辑被彻底重写了。代码里新增了两个关键常量：`hermesWindowsInstallURL` 和 `hermesWindowsInstallCmd`，对应的安装脚本来自Hermes官方仓库的 `install.ps1`。与 Linux/macOS 使用 bash 脚本不同，Windows 这次选择了 PowerShell 路线，安装命令的逻辑也很清晰：通过 `-NoProfile`、`-ExecutionPolicy Bypass` 等参数调用 PowerShell，用 `irm` 拉取脚本并追加 `-SkipSetup` 参数。这说明Ollama不再只是简单地提示用户去手动处理，而是把Windows上的自动化安装路径真正打通了。
2. Hermes Desktop 新增：桌面应用也能一键启动了
这次更新中，一个非常重要的新增功能是：`launch: hermes-desktop app`。Ollama 现在不仅支持 `hermes` CLI，还新增了一个 `hermes-desktop` 入口。在集成注册列表里，我们看到了它的名字，帮助文档和集成列表中也加入了它的说明。这意味着，你可以直接通过 `ollama launch hermes-desktop` 这样的命令来启动它，而不再局限于原有的命令行界面。
3. Hermes Desktop 的运行逻辑揭秘
从代码层面看，`Hermes Desktop` 并非简单地换个名字，而是单独增加了一套完整的运行逻辑。代码中新增了一个 `HermesDesktop` 结构体，它继承了 `Hermes` 的能力，并实现了 `Run()`、`Onboard()` 等一系列方法。这些方法定义了它的启动行为。
启动参数逻辑
它的 `launchArgs` 方法会先生成 `["desktop"]` 参数。如果判断应该跳过构建步骤，就会自动附加 `--skip-build` 参数，最后再拼接上用户传入的自定义参数。也就是说，`hermes-desktop` 启动时，本质上会走 `desktop` 或 `desktop --skip-build` 这两条路径。
自动判断是否跳过构建
新增的 `shouldSkipDesktopBuild` 逻辑非常实用。它会检查用户是否显式传入了 `--skip-build`、`--source`、`--build-only`、`--help` 等flag。如果传了，则不自动追加；如果没传，它会去检查本地是否已经存在打包好的桌面应用。如果本地已存在，就自动追加 `--skip-build` 参数，以减少不必要的构建步骤，提升启动效率。
packaged app 的存在检测
为了判断本地是否已有可用的桌面应用，代码新增了 `packagedAppExists()` 方法。它会遍历多个常见的安装根目录，例如 `HERMES_INSTALL_DIR`、`HERMES_HOME`、用户家目录、Windows的 `LOCALAPPDATA` 和 Linux 的 `/usr/local/lib/hermes-agent`，然后在对应的 `apps/desktop/release` 目录下查找各平台的打包产物。这充分说明 Ollama 已经充分兼容了 Hermes 的各种安装布局。
不同平台的发布包路径识别
新增的 `hermesDesktopPackagedExecutableCandidates()` 方法，更是按平台精确匹配可执行文件：
macOS 在 `mac*` 目录下找 `Hermes.app/Contents/MacOS/Hermes`；
Windows 查找 `win-unpacked/Hermes.exe` 等；
Linux 则查找 `linux-unpacked/hermes` 或 `linux-unpacked/Hermes`。Ollama 对 Hermes Desktop 的发布结构做了非常明确的适配。
4. Windows 下 Hermes 二进制回退查找
这次还新增了 `hermesWindowsBinaryFallbacks()` 方法，用于在 Windows 下查找 `hermes.exe`。它会尝试 `HERMES_HOME`、`LOCALAPPDATA` 等多个路径，并生成诸如 `hermes-agent\venv\Scripts\hermes.exe` 或 `hermes\hermes-agent\venv\Scripts\hermes.exe` 等备选路径。这一步的意义在于：即使主路径找不到，也能在常见的 Windows 安装布局中继续回退查找，大大提高了可用性。
5. Windows 下的安装提示逻辑变化
更新之前，Windows 下 Hermes 的安装提示可能主要指向 WSL2。更新后，行为更加细化。现在，系统会优先尝试走 PowerShell 安装脚本，如果已安装则返回结果；如果缺少依赖，则输出依赖提示。同时，原有的 `hermesWindowsHint()` 仍然保留，用于提醒用户：Windows 需要 WSL2，可以使用 `wsl --install`，然后在 WSL 环境内运行 `ollama launch hermes`。这说明在 Windows 场景下，Ollama 既增强了自动安装的能力，也保留了原有的使用约束说明，为用户提供了多条路径。
四、Hermes 安装逻辑的全面优化
除了桌面版的增强，Hermes 的安装逻辑本身也做了优化。
1. 安装命令按平台分流
新增的 `runInstallScript()` 函数，将安装逻辑按平台分流：Windows 走 PowerShell 安装，非 Windows 走 bash 安装。这比原来统一的 bash 安装逻辑更清晰，也更符合实际环境。
2. 依赖检测逻辑修正
`ensureInstalledFor()` 函数也被改造了。更新后，Windows 平台会直接给出 WSL 提示，而非 Windows 平台才会检查 `bash`、`curl`、`git` 等依赖。如果缺少依赖，会输出提示，并告知用户重新运行 `ollama launch
五、新增 Hermes Desktop 集成入口
在集成注册表中，一个完整的 `hermes-desktop` 集成定义被新增。它的 Name 为 `hermes-desktop`，Runner 指向 `&HermesDesktop{}`，Description 为 `Desktop app for Hermes Agent by Nous Research`。它的安装检测逻辑也很有意思：它通过 `Hermes{}.installed()` 来判断是否已安装，并通过 `Hermes{}.ensureInstalledFor("hermes-desktop")` 来执行安装。这说明 `hermes-desktop` 并非一个完全独立的产品，而是基于 Hermes 安装体系扩展出来的桌面入口。
六、文档更新：Cline CLI 集成文档正式加入
这次版本还新增了一个完整的集成文档 `docs/integrations/cline-cli.mdx`，并同步加入了相关的图片和文档目录索引。
1. Cline CLI 是什么
文档中明确指出，Cline CLI 是一个面向交互式终端会话的自主编码袋里。请注意，它和作为 IDE 扩展的 Cline 是两个不同的东西，这里强调的是 CLI 版本。
2. 安装方式
文档给出的安装方式是通过 `npm install -g cline`。并且，如果 Cline CLI 尚未安装，而 `npm` 可用，当你执行 `ollama launch cline` 时，Ollama 会提示你安装 `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` * **手动配置流程**：文档还提供了完整的备用方案，包括先拉取模型、手动设置 provider、填写本地端点地址、选择模型等步骤，确保无论什么情况下你都能配置成功。七、集成列表与排序更新
这次版本也同步更新了集成注册和展示列表。`hermes-desktop` 加入了支持集成列表和启动页帮助信息。同时，`hermes-desktop` 被加入到 `launcherIntegrationOrder` 中，被放置在 `opencode` 和 `codex` 之间，确保它在列表中处于更显眼的位置。文档的 `docs.json` 和 `integrations/index.mdx` 也加入了 Cline CLI 的入口，文档体系和命令行体验都更加统一。
八、测试更新：全面覆盖新功能场景
为了确保新逻辑的稳定可靠，本次更新补充了大量测试，覆盖了 Hermes Desktop 运行、Windows 下从 `LOCALAPPDATA` 找到桌面包、Linux root 安装路径识别、以及 Windows 安装流程等关键场景。这些测试验证了新代码的执行路径，而不仅仅是改了个文案。
九、总结：这次更新的实际意义
综合来看，Ollama v0.30.5 的更新价值可以概括为以下几点：
1. **稳定性提升**：修复了 `gemma4:12b` 的浮点异常崩溃，直接改善了模型运行稳定性。 2. **Hermes 生态增强**：不仅修复了 Windows 安装问题，还新增了桌面版入口，完善了应用的启动链路。 3. **Windows 体验更完善**：从安装脚本、可执行文件查找、回退路径到测试覆盖，Windows 相关的所有逻辑都得到了强化。 4. **文档体系更完整**：Cline CLI 的独立文档、集成首页、JSON 索引、图片资源都已同步到位。 5. **命令行体验更统一**：`ollama launch` 的集成列表更加丰富，用户可通过命令行启动更多工具和袋里应用。十、结语
Ollama v0.30.5 不是一次小修小补，而是一次围绕稳定性、集成体验、跨平台支持和文档完善的集中升级。特别是 Hermes Desktop 的加入和 Windows 安装逻辑的强化，让这个版本的实际可用性明显上了一个台阶。
