Pulse v6.0.5-rc.2 发布解析:Patrol Gemini 就绪检测、SMART 温度回退与温度告警阈值修复实践指南
Pulse v6.0.5-rc.2 发布解析:Patrol Gemini 就绪检测、SMART 温度回退与温度告警阈值修复实践指南
导读:本文基于 Pulse 开源仓库的官方发布说明 RELEASE_NOTES_v6.0.5-rc.2.md,系统梳理该版本候选在 Patrol AI 模型就绪检测、登录记住用户名、Proxmox SMART 温度回退、温度显示严重度阈值、PBS 备份轮询内存、物理磁盘身份合并、Proxmox Token 保留、OIDC SSO 发现与 CSP nonce 等方面的修复内容,并结合仓库源码与测试深入讲解每个修复的底层原理与验证方式。读者阅读后,将能理解 Pulse 的 Patrol 模型就绪评估机制如何工作、smartctl 探测如何回退到 SAT 探针、温度告警阈值如何从硬编码改为可配置,以及升级 RC 时应当注意的版本与回滚边界。
一、发布定位:v6.0.5 补丁线的重要 RC
v6.0.5-rc.2 是 Pulse v6 补丁线(patch line)的第二个发布候选(Release Candidate)。它承接稳定版本 v6.0.4,并在 v6.0.5-rc.1 的基础上追加了多处支持性修复。从发布说明看,本 RC 的价值主张集中在"支持性修复"(support fixes)上,主要覆盖:
- Patrol Gemini 模型就绪检测(readiness checks);
- 登录表单"记住我"(remember me)用户名持久化;
- Proxmox 直接 SATA/SAT 磁盘的 SMART 温度回退;
- 温度显示严重度(severity)改用可配置告警阈值;
- PBS 备份轮询内存占用控制;
- 物理磁盘 SMART/Proxmox 合并身份(merge identity)修复;
- Proxmox Token 在安装/更新流程中的保留回归修复;
- 旧版 OIDC SSO 发现与 CSP nonce 处理;
- 路由感知的 Proxmox 主机 URL 生成;
- Docker、Helm、安装器与发布辅助元数据的刷新。
这些修复共同指向一个目标:提升自托管监控在生产环境中的可靠性与可验证性,尤其是针对 Patrol AI 巡检、磁盘温度监控和 SSO 登录这些容易"静默失败"的场景。
二、Patrol Gemini 模型就绪检测修复
2.1 修复内容
发布说明的第一条修复为:
Fixed Patrol readiness checks for Gemini models so tool-call capability is detected from Gemini candidate parts as well as top-level tool-call lists.
即:此前 Patrol 模型就绪(readiness)评估对 Gemini 模型的工具调用能力检测不够完整——只检查顶层 tool-call 列表,而 Gemini API 将函数调用放在 candidate.content.parts 内嵌的 functionCall 结构中,导致就绪评估可能误判模型不具备工具调用能力。修复后,评估逻辑同时从 Gemini candidate parts 与 顶层 tool-call 列表 两个层面检测工具调用能力。
2.2 源码级原理
Pulse 的 Patrol 模型就绪评估实现在 internal/ai/patrol_model_readiness.go:
PatrolModelReadinessProbeVersion = "patrol-readiness/v1"定义了评估探针的版本标识(第 27 行),持久化结果时必须与之一致,否则旧证据会被忽略(见loadPatrolModelReadiness中对ProbeVersion的校验);- 就绪评估采用多维度证据而非单一综合评分:
PatrolModelReadinessDimensions包含Connectivity(连通性)、ToolProtocol(工具协议)、ContextQuality(上下文质量)、Latency(延迟)四个维度(第 80-85 行),"一个快速但输出畸形工具调用的模型仍然不适合 Patrol"; - 探针场景使用合成夹具(synthetic fixtures)与内存内工具结果,不会执行任何真实基础设施工具(
RunPatrolModelReadiness注释,第 461-463 行),因此评估本身是安全、可重复的; - 对 Gemini 提供商,探针请求强制
ToolChoice = ToolChoiceRequired(对应 Gemini 的functionCallingConfig.mode = "ANY"),确保模型必须走工具调用路径(第 706-708 行、782-784 行); - 探针上下文窗口显式设置(
MinContextTokens,默认patrolReadinessMinimumContext = 8192),避免 Ollama 等服务端默认num_ctx(通常 4096)静默截断 prompt 导致评估失真(patrolReadinessProbeContextTokens注释引用 #1624)。
Gemini 客户端的工具调用解析逻辑位于 internal/ai/providers/gemini.go:
- Gemini 的响应模型是
Candidates []geminiCandidate,其中geminiCandidate.Content是一个geminiContent,其Parts是[]geminiPart(第 124-128 行); - 函数调用以
part.FunctionCall != nil的方式内嵌在 parts 中(第 82 行、第 633-648 行),解析时将part.FunctionCall.ID、Name、Args映射为 Pulse 的providers.ToolCall结构; - 当解析到工具调用时,stop reason 会强制映射为
"tool_use",保证 agentic 循环继续(第 658-665 行)。
这就是"从 candidate parts 检测工具调用"的落地代码:修复确保就绪探针的协议校验(validatePatrolReadinessProtocol)能从 candidate parts 中提取到工具调用,从而正确判定 Gemini 模型是否具备 Patrol 所需的流式工具协议能力。
2.3 就绪评估结果与 Patrol 模式
评估最终输出 PatrolModelReadinessResult,关键字段包括:
| 字段 | 含义 |
|---|---|
TransportHealthy |
提供商/模型可达性(与 Patrol 能力相互独立) |
PatrolCapable |
是否具备 Patrol 能力 |
MaxVerifiedMode |
已验证的最高自治模式:monitor(仅观察)/ approval(先询问) |
Modes |
monitor/approval/assisted/full 四种模式的适配结论 |
Details |
逐场景探针与校验证据(如 "expected exactly one tool call, got 0") |
结果会持久化到数据目录下的 ai_patrol_model_readiness.json(patrolModelReadinessCacheFilename),并配套 .salt 文件(32 字节随机盐)用于对缓存键做 HMAC 指纹,防止凭据泄露时缓存被离线破解(patrolModelReadinessSaltBytes = 32,第 40-41 行)。只有当当前配置的提供商/模型与缓存键匹配时,缓存结果才被复用(CachedPatrolModelReadiness)。这也意味着:更换 Patrol 模型或修改相关配置后,就绪证据会自动失效,需要重新运行评估。
三、登录表单"记住我"提交持久化修复
发布说明第二条:
Fixed the login form so enabling "remember me" during submit persists the remembered username immediately.
此前用户在提交登录时勾选"记住我",记住的用户名并不会在提交动作发生时立即持久化(可能只在某些后续事件中生效)。修复后,勾选状态在 submit 的瞬间 即被持久化,避免用户勾选后被刷新或跳转导致记住用户名丢失。
从仓库前端测试看,该行为对应浏览器层面的登录交互验证(如 frontend-modern/browser-tests 下针对登录表单的自动化脚本,以及 cmd/pulse 的登录相关集成测试)。这属于典型的"UI 状态持久化时序"修复,直接提升多会话运维场景的登录体验。
四、Proxmox SMART 温度回退:直接 SATA/SAT 磁盘
4.1 修复内容
Fixed Proxmox SMART temperature fallback for direct SATA/SAT disks where smartctl auto-detection returned disk health but no temperature until retried with an explicit SAT probe.
部分直接连接的 SATA 磁盘(特别是通过 SAT 翻译层的场景)在 smartctl 自动检测(auto-detect)下能返回磁盘健康信息,却返回不了温度;只有用显式 -d sat 探针重试后才拿到温度。修复让温度采集在自动检测失败时自动回退到显式 SAT 探针重试。
4.2 源码级原理
Pulse 的 smartctl 探测逻辑集中在 internal/hostagent/smartctl.go:
- 传输类型(transport type)区分
sata、sas、nvme等(第 57 行); linuxDirectSATDeviceRE = ^((sd|hd)[a-z]+|sata[0-9]+)$(第 256 行)用于识别直接 SATA 设备路径;- 代码注释明确指出:SAT 翻译层是更具体的信号,必须最先检测——"A SATA disk behind an LSI/mpt3sas HBA (the common Unraid...)" 场景下,
-d scsi会丢弃-d sat的探针提示,把磁盘引导回-d scsi探测;而真正的 SAS 磁盘会报告自己的厂商信息,绝不会是 "ATA"(第 1111-1116 行)。
因此,修复的本质是:在 SAT/SATA 判定路径上,当自动探测未返回温度时,追加一次显式 SAT 探针重试,从而保证直接连接的 SATA 磁盘也能上报温度。与之相关的回归测试包括 internal/hostagent/smartctl_test.go、internal/hostagent/issue1595_sas_collection_test.go(SAS 拓扑收集)与 internal/hostagent/issue1690_smartctl75_power_mode_test.go 等,用于锁定该路径的行为边界。
五、温度显示严重度:从硬编码颜色到可配置阈值
5.1 修复内容
Fixed temperature display severity so node, workload, Docker, standalone agent, and drawer temperature surfaces use configured alert thresholds instead of hardcoded warning colors.
此前节点(node)、工作负载(workload)、Docker、独立 agent、抽屉(drawer)等多个温度展示面使用硬编码的告警颜色来标记严重度,导致与用户实际配置的告警阈值不一致。修复后,所有温度展示面统一使用已配置的告警阈值来计算严重度。
5.2 配置与源码证据
温度相关配置在 internal/config/config.go 中管理:
- 全局开关
TemperatureMonitoringEnabled(json:"temperatureMonitoringEnabled",第 178 行); - 每个节点/工作负载/agent 可以单独覆盖
TemperatureMonitoringEnabled *bool("nil = use global setting, true/false = override",第 580、653、683 行); - 默认情况下该开关为开启(第 842 行)。
阈值归一化逻辑在 internal/config/persistence.go:config.NodeDefaults.Temperature = alerts.NormalizeHysteresisThreshold(config.NodeDefaults.Temperature, 80, 75, "node.temperature")(第 1059 行)——即温度阈值带迟滞(hysteresis)归一化:默认告警阈值 80°C、恢复阈值 75°C,避免温度在临界值附近反复触发告警。迟滞归一化函数定义于 internal/alerts 包。
因此,修复后的严重度计算完全以这些配置阈值为准,而非界面层写死的颜色。这也意味着用户调整温度阈值后,所有温度展示面(节点、负载、Docker、独立 agent、抽屉)的严重度表现会立即同步。
六、PBS 备份轮询:内存使用边界化
发布说明第六条:
Bounded PBS backup polling memory use and added coverage for read-state polling behavior.
修复限制了 PBS 备份轮询的内存使用,并补充了读状态轮询行为(read-state polling)的测试覆盖。结合仓库结构,PBS 相关实现位于 pkg/pbs(6 个 Go 文件)与 internal/unifiedresources,测试覆盖体现在 tests/qualification 等处的 PBS 轮询场景用例。这类修复对长期运行的自托管实例尤为关键:备份任务时间线较长,轮询不得随任务数量线性膨胀内存。
七、物理磁盘 SMART/Proxmox 合并身份修复
7.1 修复内容
Fixed physical disk SMART/Proxmox merge identity so NVMe and SMART-enriched disk records keep their canonical identity and temperature metadata.
物理磁盘记录同时来自 Proxmox 与 SMART 两个来源,合并(merge)时可能丢失磁盘的规范身份(canonical identity)与温度元数据,尤其是 NVMe 与 SMART 增强(SMART-enriched)的磁盘记录。修复确保合并后这些信息被保留。
7.2 源码证据
磁盘合并与温度元数据逻辑位于 internal/hostagent 与 internal/monitoring:
- internal/hostagent/issue1516_physical_disk_regression_test.go 专门覆盖物理磁盘回归场景;
- internal/hostagent/issue1595_sas_collection_test.go 覆盖 SAS 拓扑收集;
- internal/monitoring/merge_temps_test.go 验证温度合并逻辑;
- internal/monitoring/issue1595_collection_trust_test.go 验证收集信任边界。
这些测试共同保证了磁盘身份(identity)与温度元数据在跨来源合并时不丢失,避免出现"同一块 NVMe 盘在多处显示不同身份"或"温度突然消失"的问题。
八、Proxmox Token 保留回归与安装/更新流
Fixed Proxmox token preservation regressions during install/update flows and added smoke diagnostics for token setup and validation.
安装与更新流程中存在 Proxmox Token(API Token)丢失的回归问题,修复后 Token 在流程中正确保留,并新增了 Token 配置与验证的 smoke 诊断(smoke diagnostics)。这呼应了 cmd/pulse-control-plane 中 provider MSP 的安装证明、预检等模块(如 provider_msp_install_proof.go、provider_msp_preflight.go、provider_msp_status.go),也即控制平面在安装/升级时对 Token 的预检与校验链路。
九、旧版 OIDC SSO 发现与 CSP nonce 处理
Fixed legacy OIDC SSO discovery and CSP nonce handling so configured SSO providers are advertised to the login surface after upgrade.
升级后,旧版 OIDC SSO 提供商的**发现(discovery)**与 CSP(内容安全策略)nonce 处理存在缺陷,导致已配置的 SSO 提供商没有被正确"通告"到登录界面。修复后,升级后的登录界面能正常展示已配置的 SSO 提供商。
Pulse 的 OIDC 支持在 docs/OIDC.md 有完整说明,仓库还包含 internal/api 下的认证中间件与 pkg/auth 认证包。CSP nonce 的处理涉及前端页面注入与安全头,属于"升级后登录链路回归"的典型修复。
十、路由感知的 Proxmox 主机 URL 与 RC 元数据刷新
10.1 路由感知 URL
Preferred route-aware Proxmox host URLs when generating host setup details.
生成主机设置详情(host setup details)时,优先使用路由感知的 Proxmox 主机 URL。结合 internal/unifiedresources/proxmox_node_links.go 的存在,可以推断:在多网络/多路由环境下,Pulse 会根据实际可达路由选择更合适的主机地址,避免给出不可达的节点链接。
10.2 RC 元数据刷新
Refreshed Docker, Helm, installer, and release-helper metadata for the release candidate.
本 RC 同步刷新了:
- Dockerfile 与 docker-compose.yml;
- deploy/helm/pulse 下的 Helm Chart(13 个 YAML、模板与文档);
- install.sh 安装脚本;
- 发布辅助脚本(如 scripts/trigger-release.sh、scripts/validate-release.sh 等)。
这些元数据保证 RC 的容器镜像、Helm 部署与安装器指向正确的版本标签。
十一、升级注意事项与回滚边界
发布说明对升级路径给出了明确指引:
- 仅在愿意测试 RC 时升级:
v6.0.5-rc.2是发布候选,应当只在能接受 RC 不稳定性的环境中使用正常的 v6 安装或更新流程(install.sh或 Helm Chart)升级。 - 回滚目标为 v6.0.4:若 RC 出现问题,回滚目标(rollback target)是稳定版
v6.0.4。 - 付费功能走私有渠道:Pulse Pro、Relay 以及符合条件的旧版付费客户,应继续使用私有下载页与私有运行时镜像获取付费运行时功能——RC 渠道不承载付费运行时特性。
十二、小结与验证清单
v6.0.5-rc.2 是一个典型的"质量收敛型"发布候选:没有新功能,而是将补丁线早期引入的多个回归逐一收口。升级到该 RC 后,建议按以下清单验证:
- [ ] Patrol 就绪评估:在 Pulse Intelligence 设置中为 Gemini 模型运行就绪评估,确认
ToolProtocol维度通过、MaxVerifiedMode达到预期的monitor或approval; - ] 温度显示:修改节点温度阈值(默认告警 80°C / 恢复 75°C,见 [internal/config/persistence.go),确认节点、负载、Docker、独立 agent 与抽屉的温度严重度随之变化;
- [ ] SMART 温度:确认直接 SATA/SAT 磁盘在自动检测无温度时,能通过显式 SAT 探针回退拿到温度;
- [ ] 登录"记住我":提交登录时勾选记住用户名,确认刷新/重开后用户名仍被记住;
- [ ] Proxmox Token:执行一次安装/更新流程,确认 Token 保留,并运行新增的 Token smoke 诊断;
- [ ] SSO 登录面:升级后确认已配置的 OIDC SSO 提供商出现在登录界面;
- [ ] PBS 轮询:观察长备份时间线下的内存占用是否保持有界。
每个修复都能在仓库中找到对应的实现与测试证据(相关路径见上文各小节),这也是该 RC"可验证"这一核心特性的体现——无论是 AI 巡检的模型就绪、温度监控的阈值一致性,还是登录与 Token 的生命周期,Pulse 都坚持用源码与测试把行为固定下来。