Ollama v0.30.5 已于 2026 年 6 月 5 日发布。这次更新虽然版本号看起来只是一次小版本升级但实际内容非常扎实涉及模型运行稳定性修复、Hermes 集成能力增强、Windows 安装体验优化、桌面版入口新增以及文档与集成索引的大幅补全。对于正在使用 Ollama 做本地模型调用、CLI 集成、自动化安装和多工具联动的用户来说这一版值得认真关注。一、版本概览v0.30.5 更新了什么本次 v0.30.5 的主要变化可以概括为四个方向修复 gemma4:12b 的浮点异常崩溃Hermes 在 Windows 上的安装流程优化新增 Hermes Desktop 集成补充 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 下的安装逻辑被补充了。代码里新增了两个关键常量hermesWindowsInstallURLhermesWindowsInstallCmd对应的 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() stringRun(...) errorOnboard() errorlaunchArgs(args []string) []stringshouldSkipDesktopBuild(args []string) boolpackagedAppExists() 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_DIRHERMES_HOME用户家目录相关路径Windows 的LOCALAPPDATALinux 的/usr/local/lib/hermes-agent这部分非常值得注意因为它说明 Ollama 已经充分兼容 Hermes 的安装布局而不是只认单一目录。6. 不同平台的发布包路径识别新增了hermesDesktopPackagedExecutableCandidates()按平台分别寻找可执行文件macOS在mac*目录下匹配Hermes.app/Contents/MacOS/HermesWindows查找win-unpacked/Hermes.exewin-ia32-unpacked/Hermes.exewin-arm64-unpacked/Hermes.exeLinux查找linux-unpacked/hermeslinux-unpacked/Hermes这说明 Ollama 对 Hermes Desktop 的发布结构做了明确适配。7. Windows 下 Hermes 二进制回退查找这次还新增了hermesWindowsBinaryFallbacks()。它会尝试在以下位置查找hermes.exeHERMES_HOMELOCALAPPDATA用户 home 下的AppData\Local并生成多个备选路径例如hermes-agent\venv\Scripts\hermes.exehermes\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这个函数按平台分流WindowsPowerShell 安装非 Windowsbash 安装原来统一的 bash 安装逻辑现在被抽成了平台判断更清晰也更符合实际环境。2. 依赖检测逻辑修正ensureInstalledFor(command string)也被改造了。更新后Windows 直接给出 WSL 提示非 Windows 才检查依赖bash、curl、git如果缺少依赖会输出提示先安装缺失依赖然后重新运行ollama launch command这里command会根据传入的参数变化避免只写死成hermes。这也是本次更新很实用的一点hermes-desktop和hermes在安装提示上有了更准确的区分。五、新增 Hermes Desktop 集成入口在注册表中新增了一个完整的集成定义Name:hermes-desktopRunner:HermesDesktop{}Description:Desktop app for Hermes Agent by Nous ResearchInstall URL: 官方 Hermes 安装文档链接并且它的安装检测逻辑是通过Hermes{}.installed()判断是否已安装通过Hermes{}.ensureInstalledFor(hermes-desktop)执行安装这说明hermes-desktop并不是完全独立的产品而是基于 Hermes 安装体系扩展出来的桌面入口。六、文档更新Cline CLI 集成文档正式加入这次版本还新增了一个完整文档docs/integrations/cline-cli.mdx同时还加入了相关图片docs/images/cline-cli.pngdocs/images/cline-kanban.png以及文档目录索引和文档 JSON 配置更新。1. Cline CLI 是什么文档中对 Cline CLI 的定位是一个面向交互式终端会话的自主编码代理和 IDE 扩展版 Cline 区分开来这里强调的是 CLI 版本。2. 安装方式文档给出的安装方式是npminstall-gcline并说明如果 Cline CLI 尚未安装而npm可用则执行ollama launch cline时会提示安装clinelatest。这说明 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.5kimi-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/release4. 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/ollamaOllama v0.30.5 不是一次单纯的小修小补而是一次围绕稳定性、集成体验、跨平台支持和文档完善的集中升级。尤其是 Hermes Desktop 的加入以及 Windows 安装逻辑的强化让这个版本在实际可用性上明显更进一步。
ollama v0.30.5 更新：Hermes Desktop 上线、Windows 安装优化、Gemma4 崩溃修复、Cline CLI 集成文档全量补齐
发布时间：2026/6/6 1:40:45
Ollama v0.30.5 已于 2026 年 6 月 5 日发布。这次更新虽然版本号看起来只是一次小版本升级但实际内容非常扎实涉及模型运行稳定性修复、Hermes 集成能力增强、Windows 安装体验优化、桌面版入口新增以及文档与集成索引的大幅补全。对于正在使用 Ollama 做本地模型调用、CLI 集成、自动化安装和多工具联动的用户来说这一版值得认真关注。一、版本概览v0.30.5 更新了什么本次 v0.30.5 的主要变化可以概括为四个方向修复 gemma4:12b 的浮点异常崩溃Hermes 在 Windows 上的安装流程优化新增 Hermes Desktop 集成补充 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 下的安装逻辑被补充了。代码里新增了两个关键常量hermesWindowsInstallURLhermesWindowsInstallCmd对应的 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() stringRun(...) errorOnboard() errorlaunchArgs(args []string) []stringshouldSkipDesktopBuild(args []string) boolpackagedAppExists() 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_DIRHERMES_HOME用户家目录相关路径Windows 的LOCALAPPDATALinux 的/usr/local/lib/hermes-agent这部分非常值得注意因为它说明 Ollama 已经充分兼容 Hermes 的安装布局而不是只认单一目录。6. 不同平台的发布包路径识别新增了hermesDesktopPackagedExecutableCandidates()按平台分别寻找可执行文件macOS在mac*目录下匹配Hermes.app/Contents/MacOS/HermesWindows查找win-unpacked/Hermes.exewin-ia32-unpacked/Hermes.exewin-arm64-unpacked/Hermes.exeLinux查找linux-unpacked/hermeslinux-unpacked/Hermes这说明 Ollama 对 Hermes Desktop 的发布结构做了明确适配。7. Windows 下 Hermes 二进制回退查找这次还新增了hermesWindowsBinaryFallbacks()。它会尝试在以下位置查找hermes.exeHERMES_HOMELOCALAPPDATA用户 home 下的AppData\Local并生成多个备选路径例如hermes-agent\venv\Scripts\hermes.exehermes\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这个函数按平台分流WindowsPowerShell 安装非 Windowsbash 安装原来统一的 bash 安装逻辑现在被抽成了平台判断更清晰也更符合实际环境。2. 依赖检测逻辑修正ensureInstalledFor(command string)也被改造了。更新后Windows 直接给出 WSL 提示非 Windows 才检查依赖bash、curl、git如果缺少依赖会输出提示先安装缺失依赖然后重新运行ollama launch command这里command会根据传入的参数变化避免只写死成hermes。这也是本次更新很实用的一点hermes-desktop和hermes在安装提示上有了更准确的区分。五、新增 Hermes Desktop 集成入口在注册表中新增了一个完整的集成定义Name:hermes-desktopRunner:HermesDesktop{}Description:Desktop app for Hermes Agent by Nous ResearchInstall URL: 官方 Hermes 安装文档链接并且它的安装检测逻辑是通过Hermes{}.installed()判断是否已安装通过Hermes{}.ensureInstalledFor(hermes-desktop)执行安装这说明hermes-desktop并不是完全独立的产品而是基于 Hermes 安装体系扩展出来的桌面入口。六、文档更新Cline CLI 集成文档正式加入这次版本还新增了一个完整文档docs/integrations/cline-cli.mdx同时还加入了相关图片docs/images/cline-cli.pngdocs/images/cline-kanban.png以及文档目录索引和文档 JSON 配置更新。1. Cline CLI 是什么文档中对 Cline CLI 的定位是一个面向交互式终端会话的自主编码代理和 IDE 扩展版 Cline 区分开来这里强调的是 CLI 版本。2. 安装方式文档给出的安装方式是npminstall-gcline并说明如果 Cline CLI 尚未安装而npm可用则执行ollama launch cline时会提示安装clinelatest。这说明 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.5kimi-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/release4. 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/ollamaOllama v0.30.5 不是一次单纯的小修小补而是一次围绕稳定性、集成体验、跨平台支持和文档完善的集中升级。尤其是 Hermes Desktop 的加入以及 Windows 安装逻辑的强化让这个版本在实际可用性上明显更进一步。
)
