reference
🆕 12-最新功能与版本边界LCP
🆕 12-最新功能与版本边界 是 Hermes Agent 中文站「reference、latest-features」路径下的中文实战说明页，覆盖核心概念、配置步骤、常见问题与下一步入口，帮助你把 Hermes Agent 在国内环境真正跑起来，并与快速上手、现成方案、Packs、问题排查及参考手册形成完整学习链路。
先看自己安装的渠道和版本，再判断某项功能是否可用。本文分别列出稳定版已经包含的变化与发布后合入主干的变化，不把“PR 已合并”写成“正式版已发布”。
复核日期：2026-09-30。官方 latest release 仍是 Hermes Agent v0.21.5，Git 标签 v2026.9.24（发布于 2026-09-24 10:09 UTC）。下列条目是与中文教程、桌面使用和国内入口有关的选摘，不是完整 changelog，也不代表已经在你的设备上测试通过。官方发布说明
🔎 先确认四个版本信息
| 信息 | 如何理解 | 为什么需要 |
|---|---|---|
| Agent 版本 | v0.21.5 是 Agent 软件版本，v2026.9.24 是其 Git 标签 | 判断后端功能与修复范围 |
| 桌面包版本 | 同一标签的桌面 package.json 为 0.17.6；实际下载包以自身版本为准 | 不能把 Agent 版本当作桌面包版本 |
| 安装渠道与提交 | 稳定标签、主干源码、canary 和官网安装器可能不同 | hermes update / 重新运行安装器不自动等于锁在本文标签 |
| 连接后端 | 桌面可能连接本机或远端，需分别记录版本 | UI 有入口不等于远端支持对应协议或功能 |
终端可用 hermes --version 查看 Agent 版本；桌面核对安装包/应用版本和后端版本。按固定镜像部署时保存完整标签；需要精确复现源码安装时同时记录提交 SHA。桌面包版本源码
✅ 已进入 v2026.9.24 稳定标签
这四个 PR 的合并提交已通过 GitHub compare 核验为稳定标签的祖先，不只是根据合并日期推测。
| 变化与官方 PR | 中文用户会看到什么 | 使用边界 |
|---|---|---|
| #120693：桌面手动添加模型 ID | 聊天模型菜单、切换窗口与 Settings 模型选择可输入目录外 ID | 输入精确 ID 并指定 provider；保存到列表不等于账户有调用权限 |
| #120312：Cron 固定路线不继承全局 fallback | 显式固定模型/provider/endpoint 的任务失败时不会偷偷换到全局备用供应商 | 未固定的任务仍可走全局链；同 provider 凭据池轮换与跨 provider fallback 是不同机制 |
| #120289：恢复会话的跨界面缓存一致性 | TUI、单次问答与 Gateway 间恢复会话时，工具定义序列保持一致，减少界面切换造成的缓存失配 | 不能保证缓存始终命中；换模型、改工具或供应商缓存规则仍可能改变费用 |
| #120441：直连 provider 的价格估算补全 | 部分直连 OpenAI/xAI 等模型不再因缺少本地价表显示未知/零估算 | 这是估算，不是厂商账单；自定义转发、订阅路线或尚无价格数据时仍可能未知 |
这些变化如何影响旧工作流
手动模型 ID：目录更新慢时，可在桌面选择器使用 Add custom model… / Custom model…。先配 provider，再按厂商精确 ID 验证最小回复和实际工具任务；不要将任意名字当成已支持模型。
Cron 固定模型：升级后，原先依赖固定任务跨供应商自动兜底的工作流可能改为失败并报告原因。需要跟随默认与全局 fallback 时，先检查任务是否有 pin；取消固定必须是自己明确作出的配置决定。失败通知仍应检查，不能把没有跨供应商切换误判为调度器没有运行。
缓存与价格：按成本实测指南比较冷/热会话和账单，未知成本不等于免费，估算也不能替代实际扣费。
同一稳定发布窗口中的桌面更新
官方 v0.21.5 发布说明还列出 Simple/Advanced 界面模式、插件 SDK 扩展、Connectors 页面替代旧 MCP 标签、安装插件后让开放聊天使用其工具和技能、快捷键等变化。首次上手先完成模型与文件任务，按需要显示面板或接连接器；不要求为体验新版先安装额外插件。发布说明表示完整整理将随 v0.22.0 提供，本文不将尚未发布的 v0.22.0 当作当前稳定版。官方稳定版说明
🧪 稳定发布之后，仅确认主干已合并
以下 PR 都已合入 main，但合并提交位于 v2026.9.24 标签之后。截至本页复核时没有后续稳定 release，不能据此认为 v0.21.5 已含这些变化。主干、canary 或其他渠道是否实际包含，应核对安装提交和打包渠道。
| 变化与官方 PR | 合并日期（UTC） | 对使用的影响 | 稳定版用户如何处理 |
|---|---|---|---|
| #121511：Kimi 流式压缩解码修复 | 09-24 | 修正 gzip-only 流等问题，并改善流中断诊断 | 保存版本和错误，不将它当成“已正式解决所有 Kimi 流式问题” |
| #121760：飞书回退时删除截断预览 | 09-24 | 减少流式预览回退后重复回复的特定情况 | 用小消息观察实际版本，避免反复重发造成重复任务 |
| #121768：钉钉重连与 SDK 不兼容处理 | 09-24 | 避免重连日志风暴，不兼容时明确失败 | 核对 SDK/依赖和版本，不以进程仍运行当作消息入口成功 |
| #121659：MiniMax 中文思考标签处理 | 09-24 | 隐藏特定中文 reasoning 标签，并保留截断的中间尾部 | 检查真实输出，不把标签显示问题与工具能力混为一谈 |
| #122920：空模型目录显示手填入口 | 09-25 | 自定义 endpoint 的 /v1/models 返回空时，桌面显示手动模型名入口 | 与稳定版已有“手动添加 ID”是两个条目；旧版可先用终端向导配置 |
| #125392：Cron 脚本独立 Python interpreter | 09-27 | CLI 新增每个脚本任务的 --interpreter，适合需要独立虚拟环境的脚本 | v2026.9.24 不照抄这个参数；先按自己版本的脚本解释器规则处理 |
| #126651：桌面模型菜单显示价格与缓存读价 | 09-28 | 选模型时更容易对比单价和缓存读价 | 与稳定版后台价格估算补全不同；菜单价格仍需和厂商账单核对 |
这些主要是特定行为的修复或 UI 能力补充，不应扩展成国内网络、账户权益或所有模型都已联调的保证。等待正式发布，或在隔离环境中测试自己选择的主干提交；不为获得一项修复直接覆盖已有工作环境。
💻 本地模型：文档和渠道也有版本差异
v2026.9.24 的本地模型文档已描述桌面管理 llama.cpp runtime 与模型下载。2026-09-30 核对的主干文档新增 Desktop availability and downloads：Local Models 界面面向 canary，其他桌面构建需 --local 启动标志，下载与 runtime 来源亦有相应说明。它是主干渠道边界，不应写成所有稳定安装包的统一入口或安装方法。
使用前核对对应版本文档、打包渠道和硬件；本页未下载 runtime 或模型，也没有完成 Windows、Linux、macOS 安装实测。固定标签本地模型说明、主干文档复核快照
🔄 应该怎样升级与验收
- 先记录桌面包版本、Agent 版本、渠道、profile 与连接后端，并备份配置、会话和必要文件。
- 明确目标是稳定 release 还是某个主干提交。读其发布/PR 边界，不把同一天合并当成同一个 release。
- Git 安装、桌面安装器、Docker 的更新方式分别处理；Docker 必须重建容器，见 VPS 升级步骤。
- 复测最小回复、文件产物、当前模型与 profile 默认模型；有 Cron、飞书、钉钉或远程连接时，分别验证自己的实际任务。
- 记录通过、失败与未验证；未做 API 或国内网络测试时，不能写成“已验证可用”。
📖 归属判定依据
- 官方最新稳定发布：v2026.9.24，标签对应提交
f97608f178d1ffeca59860195ab7da295f7c8e5f。 - 上述每个 PR 链接提供合并状态、时间和合并提交；通过 GitHub compare 比较合并提交与稳定标签，确认先后关系。
- 官方桌面版本与操作边界：package.json、桌面文档。
➡️ 下一步
- 回到：Reference 总览
- 开始使用：桌面版上手与办公实战
- 查旧版：v0.19.0 Quicksilver 更新指南