Pulse v6.1.0-rc.3 版本技术解读:类型化行动生命周期、Patrol 调查治理与安全加固

原创2026-10-09 19:50:131,708 阅读
文章标签:可观测性运维后端

Pulse v6.1.0-rc.3 版本技术解读:类型化行动生命周期、Patrol 调查治理与安全加固

Pulse 是一个面向 Proxmox VE、PBS、Docker、Kubernetes、TrueNAS 与 vSphere 的自托管实时监控仪表盘,内置智能告警与能够捕获静默故障的 AI Patrol。v6.1.0-rc.3 是 v6 次版本线的一个候选发布(release candidate),它以稳定版 v6.0.5 为比较基线,继承此前候选版的"监控优先"产品改造、类型化 Pulse Intelligence 行动生命周期、独立 Actions 工作区、更安全的原生 Agent 更新与恢复行为,并在此基础上基于候选反馈修复了 Agent 命令注册、Docker 更新操作、存储身份、TrueNAS 准确性、Patrol 可靠性以及更新选择等一系列问题。本文将以该 changelog 为主线,结合仓库源码与测试,逐项解读本次候选版的核心变更、底层实现与升级回滚操作。

一、版本定位:v6.1.0-rc.3 与比较基线

本次变更记录(V6_CHANGELOG_v6.1.0-rc.3.md)描述的是 v6.1.0-rc.3 相对于稳定版 v6.0.5 的累积变更,并取代 v6.1.0-rc.2。几个关键定位信息:

  • 发布类型:候选发布(RC),遵循受治理的 RC 路径,而非直接走 stable-patch 路径;
  • 回滚目标:v6.0.5,回滚命令为 ./scripts/install.sh --version v6.0.5;
  • 晋升路径:从 main 分支构建的 release candidate;
  • 移动端配套:iOS build 10 与 Android versionCode 8,仅在 TestFlight 与 Google Play 内部测试轨道分发,不含公开商店发布。

由于 RC 会改动认证边界与原生安装器/更新器行为,只有当你愿意接受 RC 测试风险时才建议使用 v6 常规安装或更新流程。

二、核心主线:Pulse Intelligence 的类型化行动生命周期

本次候选版最重要的一条主线,是把 Pulse Intelligence 的检测与调查、以及 Patrol 提案出的操作,全部收敛到"规范的类型化行动生命周期"(canonical typed action lifecycle)上,替代此前分散在命令侧的旧式执行路径。桌面端与 Pulse Mobile 客户端也改用统一的 pending-action 队列、决策端点与行动身份,废弃了旧的命令形态审批端点。

2.1 生命周期服务在源码中的落点

在仓库中,这条统一生命周期由 internal/actionlifecycle/service.go 承载。文件头部注释明确写出了它的设计意图:

actionlifecycle 是传输无关的行动生命周期服务:规划、审批决策与执行都面向"类型化资源行动"。internal/api 中的 REST 处理器与任何进程内 broker(例如 Patrol 调查提案)都必须经由这一个服务,以保证所有调用方获得一致的资源查找、可用性检查、计划哈希、审计持久化、修复锁、计划漂移检测、执行与终态验证。任何调用方都不得绕过它执行资源变更。

这意味着一个典型的受治理操作(例如 Docker 容器重启)无论由操作员在界面发起、由 API 调用,还是由 Patrol 调查提案生成,都会走同一条链路:计划(Plan)→ 审批(Decide)→ 派发(Dispatch)→ 执行(Execute)→ 终态验证(Verify)。

2.2 行动状态机

行动的审计状态在 internal/unifiedresources/actions.go 中定义为一个字符串枚举,构成完整的生命周期状态机:

planned → pending_approval → approved → executing → completed
        ↘ rejected          ↘ expired          ↘ failed

其中 PlannedActionState(见 service.go)决定了新建计划的初始状态:当能力策略要求审批(RequiresApproval)时进入 pending_approval,否则进入 planned。

2.3 审批边界与守卫条件

Service.Decide 是唯一的人类决策边界(service.go),在追加式决策被持久化之前强制执行多项校验:

  • 决策重放检测:ErrDecisionReplayConflict 防止同一决策被重复提交;
  • 人类行动绑定校验:ValidateHumanActionBinding 确保发起者与审批者分离(ErrApprovalSeparationRequired);
  • 审批前就绪校验:ValidateCurrentReadiness 在审批被持久化之前,重新检查计划有效期(ErrActionPlanExpired)、紧急停止(ErrActionEmergencyStop)、计划漂移(ErrActionPlanDrift)、修复锁(ErrResourceRemediationLocked)与执行器可用性,防止在资源/策略/就绪状态竞争窗口内错误地落库一个审批;
  • 审批阶梯校验:validateApprovalFloor 依据能力的声明策略(而非调用方声明)决定审批等级。

此外,StepUpVerifier 接口(service.go)负责验证并原子消费加密质询,用于 MFA 升级审批;没有安装持久的服务端校验器时,MFA 审批默认失败关闭(fail closed)。

2.4 Actions 收件箱:统一的审查面

变更记录指出,桌面端 Actions 收件箱现在为提案工作、策略来源(policy provenance)、审批状态、执行进度、验证细节与直接 Patrol 交接(handoff)提供一个统一审查面。从源码的 ActionDetail 结构(service.go)可以看到,单条行动的完整视图由四部分组成:审计记录 audit、生命周期事件列表 events、派发尝试 attempt 与派发回执 receipt——正好覆盖 changelog 所说的"审批状态 + 执行进度 + 验证细节"。而 Service.List 的 pending/settled 两种视图(service.go)则对应收件箱的"待办"与"已了结"两个分区。

三、Patrol:从 Watch 检测到模型调查的职责分离

本次候选版对 Patrol 引擎做了结构性调整:

  • 分离 Watch 检测与调查:Watch 负责持续检测异常,模型驱动的调查(investigation)独立运行;
  • 限定证据与模型轮次:调查过程中证据数量与模型 turn 数都有预算上限,避免失控;
  • 保留多个被接受的发现:多发现(multi-finding)调查会保留被接受的兄弟发现与顺序发现,Provider 重试与重放处理不会把不完整证据升级为完整证据;
  • 类型化工具调用中保持规范资源身份:调查中的工具调用全程使用规范的资源标识,避免身份漂移;
  • 行动状态从权威审计对账:Patrol 行动状态从权威行动审计对账,并在调查历史、桌面审批控件与 Pulse Mobile 审批/拒绝流程间保持一致。

3.1 调查提示词携带真实能力目录

"Changed"部分提到:调查提示词现在包含"经验证的能力目录"(validated capability catalog),其中带有审批门槛(approval floors)、参数 schema 以及敏感/仅操作员(sensitive/operator-only)约束。源码侧对应 internal/agentcapabilities 包(如 governance_prompt.go、schema.go),它向模型提供真实的类型化能力声明,而不是让模型猜测有哪些行动可用。

3.2 有界调查与负向控制

internal/ai/patrol_model_readiness.go 中的常量直接印证了有界调查的设计细节:

  • patrolReadinessMinimumContext = 8192:就绪探针要求的最小上下文窗口;
  • patrolReadinessWatchEnvelope = 4 * time.Minute:Watch 信封时长;
  • 探针上下文 token 数使用 chat.PatrolProviderMinContextTokens,注释明确解释了原因:探针的 haystack 夹具约 25KB(约 7k–9k token),若不开显式 num_ctx,Ollama 会按其服务端默认值(通常 4096)静默截断提示词,从而限制上下文质量(关联 issue #1624)。

changelog 还提到"Live Patrol qualification"路径会演练模型主导的调查、类型化工具使用、发现质量、修复规划与负向控制(negative controls)。仓库中 internal/ai/qualification 下的测试(如 client_test.go 与 ai_qualification_pure_branchcov0716_test.go)即是该资格路径的测试落点。

四、受治理行动范围的扩展

本次候选版把更多日常操作纳入"受治理行动 + 持久回执 + 独立验证"的统一路径:

4.1 Docker 与 Podman 的授权式重启

策略作用域的 Patrol 自治(policy-scoped Patrol autonomy)现在可以授权低风险 Docker 与 Podman 重启,但仅限显式允许的资源,且可选的周期性维护窗口内生效;不支持、窗口外或降级模式(downgraded-mode)的行动仍然需要审批并失败关闭。

4.2 共享治理路径的操作清单

以下操作在 RC 中共用"受治理行动、持久执行回执与独立结果验证"的路径:

  • 主机更新(host update);
  • Debian 与 Ubuntu 软件包维护;
  • 存储压力清理(storage-pressure cleanup);
  • Docker 重启;
  • 受支持的 Proxmox 客户机生命周期操作(如 reboot,见 service.go 中 lifecycleCapabilitySynonym 对 restart/reboot 的词汇同义映射)。

Docker 与 Kubernetes 行动在执行后还会验证"支持的规模与更新结果"(verify supported scale and update outcomes)。值得注意的细节:Docker 更新现在通过重建容器(recreate)而非重启来真正应用所选镜像,且保留共享另一容器网络命名空间的容器;更新与重启工作停留在"经审查的类型化计划 + 持久回执 + 重连恢复"上。

4.3 行动派发的全链路绑定

"Changed"部分指出:行动派发现在通过持久化的准入(admission)、传输(transport)、结果(result)与审计(audit)记录,绑定服务端作者化的策略来源(server-authored policy provenance)与经审查的计划身份(reviewed plan identity)。在源码中,Service 的 DispatchBinder 接口(service.go)负责把派发尝试绑定到审计记录;DispatchReconciler(service.go)则按持久尝试身份查询传输结果——它绝不发送或重发变更,只在收到经过身份认证、可关联的传输响应时才报告 found。行动状态转移会在写时刻从权威审计对账调查结果,并在稍后读取调查时补全错过的转移。

五、本地 AI 与 Provider 生态改进

5.1 Ollama qwen3:8b 引导式快速入门

"Added"部分提到:本地 Provider 设置现在包含一个引导式的 Ollama qwen3:8b 快速入门。源码侧,Ollama 客户端实现在 internal/ai/providers/ollama.go:

  • 默认 Base URL 为 http://localhost:11434(defaultOllamaBaseURL);
  • 支持可选的用户名/密码 Basic Auth 与 keep_alive 参数(config.NormalizeOllamaKeepAlive 负责规范化);
  • 非流式与流式请求使用两个独立的 HTTP 客户端:流式客户端无整体超时,仅依赖上下文(context),并设置响应头超时;
  • 出站连接被限制为 http/https scheme,允许私网与回环地址,经由 securityutil.NewRestrictedOutboundHTTPClient 构造。

patrol_model_readiness.go 的注释还特别指出 qwen3 属于"思考型模型"(thinking model):它的推理 token 会占用生成预算(Ollama 把 <think> 输出计入 num_predict),因此旧的 256-token 上限可能在模型完成推理前就截断其输出(issue #1624)——这也是本版本调整探针生成预算的背景。

5.2 Claude 订阅模型的 schema 绑定流式能力

Claude 订阅计费模型现在支持:

  • schema 绑定的流式轮次(schema-bound streaming turns);
  • 原生类型化工具(native tools);
  • 有界预检(bounded preflight);
  • 可重试的安全持久结果(retry-safe durable outcomes)。

其关键约束是:这些能力不创建并行的行动执行路径——所有执行仍然回到统一的类型化行动生命周期。

5.3 Assistant 与设置的可发现性

  • Relay 现在可从告警配置处发现;
  • Assistant 在首次 AI 设置时被引导展示;
  • 外部 Agent(MCP)连接器设置可从侧边栏搜索找到;
  • Pulse Intelligence 的产品命名在所有设置与日常界面上保持一致,Patrol 定位为检测与调查引擎。

六、修复类变更的深入解读

6.1 存储身份:ZFS nvme-eui 与命名空间后缀

RC 修复了 ZFS 池成员身份解析:此前以 nvme-eui.<hex> 或带命名空间后缀的 by-id 成员引用无法解析,导致这些磁盘只显示泛化的 ZFS 标签而不是所属池名。现在服务端与 host-agent 的匹配器都能正确解析这类成员引用。相关身份对账在受限 NAS 安装中也不再要求 od 工具,recovery-point、TrueNAS 与 nvme-eui 磁盘对账都保留权威身份来源。配套修复还包括:物理磁盘表在宽节点布局下保持可见、待机 SSD 不再被误报为活动故障。

6.2 TrueNAS 读取真实 API 形状

TrueNAS 存储读取现在适配 TrueNAS 实际返回的 API 形状,使数据集、磁盘与池详情反映真实状态,不再出现底层系统健康却显示 Offline/Attention/Unknown 的误报;按系统(per-system)存储视图也不再与 Overview 中选中的系统互换名称。

6.3 Docker 与 Kubernetes 可靠性

  • 禁用全部 Docker 容器/服务告警时,会同时清除已活动的更新告警;容器更新告警延迟(update-alert delay)在 Docker 阈值页上提供显式的关闭状态;
  • 容器更新被服务端拒绝时,按钮前置禁用并展示拒绝原因(包括 agent 过旧应如何处理的指引);
  • Docker Agent 的 collect 周期被看门狗(watchdog)限定,避免容器守护进程挂起导致上报停滞;
  • Docker 与 Kubernetes Agent 的存活判断正确处理时钟偏移(clock skew);
  • Docker 清单会识别冲突的共享 Agent 身份(两个机器上报同一 Agent 身份),注册表客户端可从认证质询中协商 bearer token。

6.4 更新选择与失败关闭

  • 应用内更新按最高版本选择发布,而非 GitHub 列表顺序;格式错误的发布说明会失败关闭;
  • 更新流程先对替换二进制进行自测再就地替换;阻止静默的 Pro→社区降级,保留明确的回滚路径;
  • 更新验证文档与发布输出使用受守卫的 OpenSSH allowed_signers 行;加固的更新服务在可写路径上保留配置备份。

6.5 认证、SSO 与 OIDC

  • 添加 Pulse Agent 勾选"启用命令执行"时,现在会铸出真正携带命令执行作用域的安装 token,首次使用的命令通道绑定与按需再生成均已修复;
  • SSO 背书的 Administrator 保持其有效设置权限;
  • 无 refresh token 的 OIDC 会话在允许处保持有效;混合认证启动避免死锁;Basic 认证身份能够到达行动授权;
  • 遗留 OIDC 回调可恢复发起方 Provider;
  • 已删除的主机可用新凭据重新注册;连续性状态在重载窗口期间维持 Agent 配置;Windows 版本检查会规范化前导 v。

6.6 Patrol 与其他可靠性修复

  • 手动 Patrol 运行只有在状态刷新确认没有运行进行时,才报告启动失败(此前慢速自托管模型在 15 秒内未流式返回时会误报连接超时);
  • Patrol 拒绝不可信指令、无效的再确认快捷方式与无依据的健康声明;重复重启与 Docker OOM 事件使用权威证据;
  • 新 Patrol 发现可路由到已配置的告警通知通道,设置暴露在 API 与 Patrol 设置页;
  • 可用性轮询节奏、告警邮件时区、Docker 变更历史与稳定的 Web 界面链接现在都反映权威值;
  • Webhook 与安全拨号器会尝试每个允许解析的 IP,而不是钉死第一个。

七、安全:更多边界失败关闭

  • 首次运行(first-run)安全边界失败关闭;
  • 当修复锁状态未知时,自治派发(autonomous dispatch)失败关闭;
  • 请求、存储、整数转换、分配与 Cookie 边界经过 CodeQL 驱动的额外加固;
  • macOS 原生发布签名与公证(notarization)是本次 RC 的必需条件;Windows Authenticode 在稳定晋升前仍是必需项,并在公开签名申请待批期间明确披露;
  • Demo SSH 设置不再削弱私有部署主机或 IP 目标的 host-key 处理;
  • Windows 服务安装在无法配置所需恢复动作或非崩溃恢复时失败关闭;Windows 安装成功现在同时要求本地就绪与非空持久服务日志;
  • FreeBSD 更新恢复保留原生 Agent 生命周期;Windows 原生 CI 演练安装器解析、安装、版本替换、就绪日志、强制进程恢复、重启持久性与清理。

八、升级与回滚操作指南

8.1 安装与升级

对 v6.1.0-rc.3 使用常规 v6 安装或更新流程,但请仅在能够接受 RC 测试风险时进行:

./scripts/install.sh

8.2 回滚到 v6.0.5

本次候选版的回滚目标是稳定版 v6.0.5,精确的回滚重装命令为:

./scripts/install.sh --version v6.0.5

由于该候选版改变了认证与原生安装器/更新器边界,它刻意走受治理的 RC 路径,而不是直接的稳定补丁路径。

8.3 移动端与 Windows 二进制注意事项

  • Pulse Mobile iOS build 10 与 Android versionCode 8 携带与 RC 匹配的"计划绑定行动审查与审批"客户端,仅在 TestFlight / Google Play 内部测试轨道;
  • Windows Unified Agent 二进制沿用 v6.0.5 的校验和与分离签名验证,但尚未做 Authenticode 签名,Windows 可能显示未知发布者警告;
  • Pulse Pro、Relay 与符合条件的遗留客户应继续使用私有下载页与私有运行时镜像获取付费运行时特性。

九、发布元数据速查

项目 值
版本 v6.1.0-rc.3
回滚目标 v6.0.5
回滚命令 ./scripts/install.sh --version v6.0.5
晋升路径 来自 main 的 release candidate
iOS 配套 build 10(TestFlight 内部测试)
Android 配套 versionCode 8(Google Play 内部测试)

延伸阅读

登录后查看全文
Pulse