Pulse v6.3.0 版本深度解读:Patrol 持久化目标、Actions 治理工作台与 Unified Agent 类型化执行预检
Pulse v6.3.0 版本深度解读:Patrol 持久化目标、Actions 治理工作台与 Unified Agent 类型化执行预检
Pulse v6.3.0 是 Pulse v6 稳定线的一次正式次版本(minor)发布,承接稳定版 v6.2.1,并把 v6.3.0-rc.1 至 rc.6 期间积累的"监控优先(monitoring-first)"运营能力与有界修复正式带入稳定渠道。本文以官方发布说明 docs/releases/RELEASE_NOTES_v6.3.0.md 为主体骨架,结合仓库源码与测试用例,从 Patrol 持久化目标与工作凭证、Actions 治理工作台、Unified Agent 类型化预检、Estate-first 资源展示、通知投递日志、最小权限安装到发布工程质量门禁逐层展开,帮助读者理解该版本带来的具体能力变化、落地方式与回滚路径。
一、版本定位与整体脉络
v6.3.0 的核心叙事可以概括为三个方向:
- Patrol 具备持久化目标与可验证工作凭证:巡逻(Patrol)从"发现即上报"演进为"以目标(objective)为单位的持续运营闭环",并由 Actions 提供专门的治理收件箱承载审批与执行;
- Estate-first 页面体系完善:跨 Proxmox VE、PBS、Docker、Kubernetes、TrueNAS、vSphere 等混合基础设施,提供统一的资产摘要(canonical estate summaries)、状态分面(status facets)、资源关系视图与变更时间线,并接入 Operational Trust 信号;
- 更安全的 Agent 运行与发布:Unified Agent 引入类型化操作预检、可验证投递证据,以及 fail-closed 的发布流水线。
按官方发布说明,该版本"promotes the monitoring-first operations work"——即将 RC 线上演练过的运营能力正式转正,并包含最终稳定截断点(stable cutoff)前的有界修复。
二、Patrol 持久化目标:从任务下发到证据闭环
2.1 持久化目标存储与加密落盘
发布说明所称的 "Durable scoped Patrol objectives"(持久化、有作用域范围的 Patrol 目标),在仓库中由 internal/ai/patrol_objectives.go 实现。核心数据结构 PatrolObjective 包含:
Brief(目标简述)与OptionalContext(可选上下文);Scope.ResourceIDs(目标作用域内的资源 ID 列表);Status(生命周期状态);Coverage(覆盖度状态);Observer(挂载的观测器记录,含版本、摘要、触发类型、只读姿态与证据拟合度)。
存储层 PatrolObjectiveStore 值得注意的几个设计点:
- 加密落盘:目标文档保存在
ai_patrol_objectives.enc,经CryptoManager加密,存储目录以0700权限创建,读取时解密并校验文档版本号(当前patrolObjectiveDocumentVersion = 1); - 数量上限:全局最多
MaxPatrolObjectives = 256个目标,其中非归档(active/paused)目标最多MaxActivePatrolObjectives = 64个; - 字段容量约束:目标简述上限 2 KiB、可选上下文上限 4 KiB、资源 ID 列表上限 64 个、观测器解释/唤醒证据各 4 KiB、探针 16 KiB、需求 8 KiB,并对 JSON 深度(12 层)与节点数(512)设限,防止模型产出无界文本;
- 乐观并发控制:
Create/Update/Delete/ProposeObserver全部要求携带ExpectedRevision,修订号不匹配时返回ErrPatrolObjectiveConflict,避免多人/多任务并发修改同一目标造成覆盖。
目标状态机为 active / paused / archived;覆盖度状态为 covered / degraded / uncovered。官方文档提到 Patrol "adds durable objectives and verified work receipts",其中"durable"(持久化)正对应上述加密落盘与版本化文档机制,"scoped"(作用域)对应 ResourceIDs 约束。
2.2 只读观测器:先提议、再验证、后安装
发布说明强调 "validated read-only observer missions"(经过验证的只读观测器任务)。源码中的观测器生命周期状态机为:
proposed → rejected / validated → installed → degraded / disabled
关键约束(internal/ai/patrol_objectives.go 中 ProposeObserver):
- 模型只能把观测器创建到 proposed(提议) 状态,且目标必须处于 active 才允许提议;
- 观测器身份、版本、摘要(digest)、只读姿态以及后续所有状态迁移都由核心(core)拥有,模型不拥有裁决权;
- 观测器制品(
PatrolObserverArtifact)是模型产出的提议输入,不是可信可执行代码,格式为pulse-observer-proposal/v1,探针(probe)与需求(requirements)以有界的规范 JSON 承载,由核心验证器/安装器消费; - 每个观测器记录携带
ReadOnly布尔位,运行期强制校验——internal/ai/patrol_observer_runtime.go 中validatePatrolObserverArtifact明确要求objective.Observer.ReadOnly为真才放行; - 证据拟合度(
EvidenceFit)区分 direct(观测器直接度量目标本身)与 proxy(信号仅用于唤醒 Patrol,不能诚实宣称完整覆盖),防止把相关信号包装成充分证据。
此外,目标意图(brief/context/scope)一旦被编辑,原有观测器的租约立即 fail-closed 失效(PatrolObserverDisabled、ValidUntil 清空),必须由 Patrol 在重新推理修订后的目标后提议新版本——即"观测器是针对其所设计时的确切意图的证据"这一设计原则的落地。
2.3 可验证工作凭证(Verified Work Receipts)
"verified work receipts"在 API 层有明确投影:internal/api/attention_receipts.go 中的 patrolWorkReceipt 记录每条经验证的 Patrol 工作:
type patrolWorkReceipt struct {
ActionID string
ResourceID string
ResourceName string
ResourceType unifiedresources.ResourceType
CapabilityName string
VerifiedAt time.Time
EvidenceClass unifiedresources.ActionEvidenceClass
OriginSurface string
FindingID string
OperationalRecordID string
}
凭证通过 unifiedresources.VerifiedActionAuditOriginReader 读取已核验的行动审计记录(仅限 Patrol 与 Operational Trust 两个来源面),再与资源注册表(registry)关联投影。也就是说,"凭证"不是 Patrol 自说自话的完成标记,而是从已核验的审计记录反查资源、能力、证据类别与原始 finding 的可追溯产物。行动侧则对应 internal/actionlifecycle/service.go 中的 ActionDispatchReceipt 与 RecordActionDispatchReceipt,构成"审批 → 下发 → 执行 → 回执"的完整链。
三、Actions 治理工作台:审批、计划、执行与审计证据
发布说明指出 "Actions provides a dedicated inbox for governed approvals and execution",源码层面对应 internal/api/actions.go:
ActionExecutor是 API 面向的"canonical action lifecycle"(规范行动生命周期)门面;HandleListPendingActions返回"canonical decision queue"(规范决策队列),即待审批/待决策的行动队列;- 决策通过
lifecycle.Decide落库,StepUpVerifierFunc(internal/actionlifecycle/service.go)负责VerifyAndConsume二次确认(如人工提升凭证校验)后才真正消费决策。
治理工作台承载的对象包括:审批请求(approval requests)、治理化计划(governed plans)、执行记录(execution records)、审计证据(audit evidence)与验证状态(verification state)。从源码结构看,工作台的核心是把"谁批准、批准了什么、执行结果如何、证据在哪"全部串成一条可审计链路,而不是简单下发命令。
四、Unified Agent 类型化操作预检(Typed Action Preflight)
4.1 预检协议与绑定校验
v6.3.0 的 "Typed Unified Agent action preflight" 在 internal/agentexec/action_preflight.go 中实现,当前协议版本 ActionPreflightProtocolVersion = 1。预检载荷 ActionPreflightPayload 采用严格的类型判别(type switch),一次只能携带恰好一个类型化操作:
| 类型化操作 | 覆盖场景 |
|---|---|
HostUpdate |
主机侧更新类操作 |
StorageCleanup |
主机存储清理类操作 |
DockerLifecycle |
Docker 容器生命周期操作 |
DockerUpdate |
Docker 容器更新操作 |
每个操作都有 Operation、OperationVersion 与 RequestDigest,由 ActionPreflightBinding 抽取为 (operation, version, digest) 绑定三元组。预检结果必须与请求绑定完全一致(ValidateActionPreflightResultForRequest),且 CheckedAt 与接收时间必须落在 ±5 分钟窗口内,超出即判为"过期或时间线错乱"(stale / invalid chronology)——这是防止陈旧预检结果被用于执行的关键防线。
4.2 稳定拒绝码(Refusal Codes)
预检失败时返回稳定、可机读的拒绝码,而不是让调用方解析供应商错误文本。ActionPreflightError 将安全拒绝类别与底层错误隔离(Err 保留在本地,永不被预检协议序列化出去)。已确认的拒绝码集合(internal/agentexec/types.go):
action_contract_invalid 代理能力不可用
agent_capability_unavailable 目标检查不可用
target_inspection_unavailable 目标检查不可用
target_state_changed 目标状态已变化
target_precondition_failed 目标前置条件不满足
package_manager_busy 包管理器忙
package_index_refresh_failed 包索引刷新失败
package_preflight_failed 包预检失败
package_inventory_changed 包清单已变化
package_manager_unhealthy 包管理器不健康
cleanup_preflight_failed 清理预检失败
cleanup_inventory_changed 清理清单已变化
这些拒绝码正好覆盖发布说明所述的五类拒绝场景:过期计划(如目标状态已变 target_state_changed)、目标变更(target_inventory_changed 类)、前置条件缺失(target_precondition_failed)、策略决策(action_contract_invalid、agent_capability_unavailable)以及能力不可用。测试覆盖见 internal/agentexec/action_preflight_test.go。
4.3 预检结果语义
结果载荷 ActionPreflightResultPayload 的校验规则非常严格:
Feasible(可行)时不得携带拒绝码;- 不可行时必须携带合法拒绝码;
RequestDigest必须匹配主机清单哈希模式。
也就是说,"不可行但没说为什么"或"可行却带了个拒绝码"都属于无效预检结果——预检协议把模糊性直接拒绝在协议层之外。
五、Estate-first 资源展示:搜索、分面、关系与时间线
v6.3.0 的资源页面强调 "Estate-first"(资产优先):canonical estate summaries(规范资产摘要)、status facets(状态分面)、shared platform search(跨平台共享搜索)、resource relationship views(资源关系视图)与 resource-change timelines(资源变更时间线)。
一个细节值得单独说明:同短名主机不再被折叠成一行。仓库测试 internal/unifiedresources/presentation_coalesce_test.go 中的 TestCoalescePresentationHostResourcesKeepsSameShortNameEstatesApart 明确验证:来自不同 estate(资产组/站点)的同名短名主机必须保持为不同行;internal/unifiedresources/registry_test.go 中的 TestCanonicalIDSuccessionSkipsLiveShortNamedHost 进一步验证规范 ID 继任不会吞掉仍在线的短名主机。对运维者而言,这意味着多站点场景下不会再出现"两台 prod 主机被合并显示"这类身份混淆问题。
Operational Trust 信号由 internal/operationaltrust/metrics.go 提供指标观测点,包括 ObserveObservationToOpen(发现到告警开启)、ObserveOpenToNotification(开启到通知发出)、ObserveEvidence(证据)、ObserveIdentityCorrelation(身份关联)、ObserveProtectionEvaluation(保护评估)与 ObserveNotificationDelivery(投递结果)——这些信号与资源展示层结合,把"监控对象、告警状态、通知成败"统一到同一张资产页面上。
六、通知投递七日活动日志
发布说明提到 "A seven-day activity log for real notification delivery attempts"。其实现位于 internal/notifications/delivery_log.go:
- 每条记录
DeliveryLogEntry包含notificationId、类型、投递方式、目标 ID、结果(outcome)、关联告警 ID 列表与数量、尝试次数、成功标志、错误信息与时间戳; - 结果归一化为五种:
sent / retry / failed / dead_letter / cancelled,统一由deliveryOutcome函数从审计行的状态推导——该函数同时被运营指标(operational-trust metric)与面向用户的日志调用,保证"健康判定"与"用户看到的日志"对同一次尝试永远不打架; - 保留窗口:普通行(sent/failed/cancelled)与其队列记录保留 7 天;死信(dead_letter)行与其队列记录保留 30 天。API 同时暴露两个窗口,避免把混合保留策略伪装成完整历史;
- 分页有界:默认页大小 50 条,单次读取上限 200 条(
maxDeliveryLogEntries),防止大安装实例被无界载荷拖垮。
从设计注释看,投递健康(delivery health)回答"有没有问题",而投递日志回答"到底发了什么、发到哪、结果如何"——两者读取的是同一批审计行,所以不可能彼此矛盾。相关窗口测试见 internal/notifications/delivery_log_test.go。
七、最小权限安装:Unified Agent 的受支持降权档案
发布说明所称 "supported least-privilege Unified Agent installation profile",在 scripts/install.sh 中体现为一组配套安装开关:
--least-privilege 以专用系统用户 pulse-agent 运行 Agent(仅 Linux systemd)
(SMART、Proxmox LXC 文件系统与命令执行需要 root 或显式授权)
--enable-privileged-helper
安装"类型化 root 助手"(须先选择 least-privilege 档案)
--enable-action-runner 安装独立凭证的"类型化修复执行服务"
(须同时具备 least-privilege 与 privileged-helper 档案)
--grant-smart 配合 --least-privilege,通过精确命令 sudoers 授权允许 SMART 采集
--grant-pct 配合 --least-privilege,通过 sudoers 授权限定 'pct list' 与 'pct df'
安装器内置互相约束校验:--enable-privileged-helper 不能与旧式 --grant-smart/--grant-pct sudo 路径混用;--enable-action-runner 必须依赖安全的 least-privilege + privileged-helper 档案,且首次安装必须提供独立的 --action-token-file。这与发布说明中 "Unified Agent observers remain report-only with destination-scoped trust"(观测器保持只上报姿态、信任按目的地限定)一致——执行能力的授予是显式、分层、可独立吊销的。
八、发布工程与质量门禁:fail-closed 与 exact-SHA
8.1 质量门禁数据
官方发布说明给出该版本的资格数据:v6 控制平面报告 44 项就绪断言(readiness assertions)全部通过、26 项发布门禁(release gates)全部通过,release_ready=True。
8.2 fail-closed 干跑与精确 SHA
- 发布干跑诊断在诊断执行器或 stable 层测试路径失败时fail-closed(关闭),同时保留可操作的产物(actionable artifacts);
- 精确推送的 stable SHA 必须先通过"不发布的发布干跑"(no-publication Release Dry Run),同一 SHA 才能进入单构建发布工作流(single-build publication workflow)——杜绝"换 SHA 重发"式的漂移;
- 激活恢复、Helm 收敛、私有许可证检查与付费运行时证明继续并入规范发布结果(canonical release result),而非依赖重复或移动中的状态。
8.3 生产遥测与版本绑定风险
发布说明披露的生产遥测(2026-08-22):
- 18 个活跃
v6.3.0-rc.6安装(binary 与 Docker 两种形态); - 56 次成功更新记录;0 次更新失败、0 次回滚或版本偏离信号;后续心跳中无新增通知失败或治理行动失败计数;
- 前一个
v6.3.0-rc.5队列同样无回滚信号;1 个安装推进到v6.3.0-rc.6,其唯一的滚动窗口更新失败在首个心跳即已存在、未随候选版本增长。
官方明确注明:发布负责人显式接受了缩短的 rc.6 浸泡(soak)时间与 RC 后有界截断,这属于版本绑定的风险接受(version-bound risk acceptance),而非 72 小时浸泡证据——这是对发布质量表述的诚实限定,读者不应把该版本解读为完整浸泡后转正。
8.4 Windows 未签名例外
v6.3.0 的 Windows Unified Agent 二进制未经 Authenticode 签名,可能出现 "Unknown Publisher" 提示。该例外已获发布负责人批准,且仅改变 Authenticode 维度;exact-SHA 构建、SHA-256 校验和、分离签名(detached signatures)、不可变候选清单与已发布摘要校验(published-digest verification)仍然全部强制。
九、升级、兼容性与回滚
9.1 升级路径
按官方升级说明,使用常规 v6 安装或更新流程即可升级到 v6.3.0:
- 现有配置保持有效,无需手工数据迁移;
- 服务器版本与现有 Pulse Mobile 候选版本兼容:自
v6.3.0-rc.6以来的变更保持了已入库的移动端 API、Relay、配对、审批、推送、认证与入网契约;本服务器版本不附带任何移动端上传或公开应用商店发布。
9.2 回滚目标与命令
回滚目标为 v6.2.1,精确回滚重装命令为:
./scripts/install.sh --version v6.2.1
9.3 付费功能边界
Pulse Pro、Relay 及符合条件的存量(legacy)付费客户应继续使用私有下载页与私有运行时镜像获取付费运行时能力;未经证明的自助商业套餐或账单节奏切换(unproved self-service commercial plan or billing-cadence transitions)仍然禁用,且不因本版本引入。
十、总结
Pulse v6.3.0 是一次把"监控运营闭环"转正的稳定发布:Patrol 从一次性巡检进化为携带加密持久化目标、只读观测器租约与可验证工作凭证的持续运营体系;Actions 收件箱把审批、计划、执行、审计与验证纳入同一条规范决策队列;Unified Agent 通过类型化预检协议与稳定拒绝码,让"该不该执行"在协议层就得到有界、可机读、防过期的裁决;Estate-first 资源展示与 Operational Trust 指标把跨平台资产、告警状态与投递证据统一到一张图上。升级与回滚路径清晰(./scripts/install.sh --version v6.2.1),发布质量以 44 项就绪断言、26 项门禁与 exact-SHA 单构建流水线把关。对需要治理化执行、多站点资产统一视图与更严格 Agent 权限边界的 Pulse 运维者,v6.3.0 值得按常规 v6 流程升级评估。