Ollama v0.30.5 已于 2026 年 6 月 5 日发布。
这次更新虽然版本号看起来只是一次小版本升级，但实际内容非常扎实，涉及模型运行稳定性修复、Hermes 集成能力增强、Windows 安装体验优化、桌面版入口新增，以及文档与集成索引的大幅补全。对于正在使用 Ollama 做本地模型调用、CLI 集成、自动化安装和多工具联动的用户来说，这一版值得认真关注。
一、版本概览：v0.30.5 更新了什么
本次 v0.30.5 的主要变化可以概括为四个方向：
从提交记录来看，这次版本包含 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 安装逻辑的强化，让这个版本在实际可用性上明显更进一步。
