Pulse v6.3.0-rc.6 版本解读:Patrol 只读观察者、Agent 最小权限发布与发布管道加固
Pulse v6.3.0-rc.6 版本解读:Patrol 只读观察者、Agent 最小权限发布与发布管道加固
本文基于开源仓库中 docs/releases/RELEASE_NOTES_v6.3.0-rc.6.md 展开,系统解读 Pulse 这一 v6.3 系列发布候选在 Patrol 自主巡检、Agent 安装与发布工程三条主线上的变更,并结合仓库源码说明每一项改进背后的实现细节。读完本文,你将掌握 v6.3.0-rc.6 的升级/回滚路径、只读观察者与最小权限安装的配置方式,以及本轮发布在制品完整性与凭据隔离上的工程约束。
v6.3.0-rc.6 是继 v6.3.0-rc.5 之后、面向稳定版 v6.2.1 之上的下一个 v6.3 发布候选。它承载 6.3 的完整产品特性包,重点聚焦发布周转(release turnaround):发布图更充分地使用专用 Ryzen PVE worker,将更多 API 生产域拆分为可独立调度的包,并在不移动任何面向客户的指针的前提下,将公开与私有发布工作重叠推进,直到 exact-SHA 就绪。
版本定位与升级/回滚路径
安装与回滚命令
v6.3.0-rc.6 属于预发布候选版本,只有在愿意测试候选版本时才应通过常规 v6 安装或更新流程使用。回滚目标为稳定版 v6.2.1:
./scripts/install.sh --version v6.2.1
仓库根目录的 scripts/install.sh 是官方安装脚本,同时支持全新安装与 --update 更新模式(见脚本头部注释与 install.sh --help 的用法说明)。
兼容性承诺
自 v6.3.0-rc.5 以来的变更不要求 Pulse Mobile 客户端做任何改动,并且保持现有的移动端、Relay、onboarding 及移动端 API 契约不变,因此无需配套的移动端构建。
签名与认证状态(升级注意事项)
- macOS:制品沿用常规的签名与 notarization 流程。
- Windows Unified Agent:本预发布版本中的二进制保留 exact-SHA、校验和与 detached-signature 校验,但未做 Authenticode 签名,因此 Windows 可能显示 "Unknown Publisher" 警告。稳定版
v6.3.0仍要求常规的 SignPath Authenticode 通道。 - 付费客户:Pulse Pro、Relay 及符合条件的既有客户应继续使用私有下载页面与私有运行时镜像来使用付费运行时能力。
Highlights:发布管道的并行化与独立资格认证
本轮候选的三大核心变更集中在发布工程:
- Chart 与资源查询服务独立资格认证:Chart 服务和资源查询服务现在独立于残余 API router 完成资格认证,缩短了根测试关键路径。仓库中
internal/api/router.go负责 API 路由与中间件编排,本轮将路由器中可独立调度的域拆出,使helmchart 与资源查询相关验证不必等待整个 API 表面就绪。 - 后端准入等待与双 shard 余量:后端准入(admission)会先等待兄弟编译器完成,再要求两个启用 race 检测的 API shard 具备可测得的余量(headroom)。
- 并行发布与证明:公开 server 与 provider 控制平面镜像从同一个经校验的 exact-candidate payload 并行发布并完成 attestation。控制平面相关的 provider 实现与发布证明逻辑可在
cmd/pulse-control-plane/provider_msp.go及cmd/pulse-control-plane/provider_msp_install_proof.go中看到对应模块。
Improved:Patrol 的持久化结果、只读观察者与决策溯源
Patrol 从"聊天流"转向"持久化结果"
本轮最实质的 AI 侧改进是:Patrol 现在基于持久化结果(durable outcomes)、限定范围调查(scoped investigations)与经校验的工作收据(verified work receipts)运行,而不再把聊天流当作操作状态。
这一点与 docs/PATROL_ARCHITECTURE.md 描述的 Patrol 运行模型一致:一次 run 经过预算预检 → 客机情报收集 → 确定性 triage → 种子上下文构建 → agentic 循环 → 确定性信号检测 → 评估扫描 → 评估补齐 八个阶段。模型通过工具调用创建 finding,而不是事后从散文里解析;确定性信号检测(DetectSignals,见 internal/ai/patrol_signals.go)作为安全网独立于模型判断运行。
"工作收据"对应的实现位于 internal/operationreceipt/store.go:operation_receipts 表以 attempt_id 为主键,记录 action_id、operation_kind、request_digest、agent_id 以及 accepted → started → terminal 的状态迁移,形成一次操作从接受到终态的完整、可校验的持久化轨迹。这正是 Patrol 判定"结果是否真实发生"的底层依据。
只读观察者:低成本巡检覆盖
只读观察者(read-only observers)可在两次完整模型调查之间扩展 Patrol 的覆盖范围,且不授予任何变更权限。模型通过 patrol_propose_observer 工具提交观察者设计方案(工具名定义见 internal/agentcapabilities/tool_names.go),服务端负责校验、安装、租约与持续执行。
agent 侧通过 --observers-file 指定私有 JSON 文件定义 report-only 观察者目标(环境变量为 PULSE_OBSERVERS_FILE,解析逻辑见 cmd/pulse-agent/main.go)。配置结构与测试用例(cmd/pulse-agent/observers_config_test.go)对应如下:
{
"version": 1,
"observers": [
{
"name": "dev",
"url": "http://127.0.0.1:7656",
"tokenFile": "/path/to/observer.token"
}
]
}
| 字段 | 含义 |
|---|---|
name |
观察者目标名称 |
url |
上报目标 Pulse 服务地址 |
tokenFile |
存放 API token 的私有文件路径(避免 token 落入命令行) |
观察者目标在 cmd/pulse-agent/main.go 中分别转换为 host(hostObserverTargets)、Docker(dockerReportTargets)与 Kubernetes(kubernetesReportTargets)的上报目标;主目标(primary)是 Authoritative 的,而观察者目标默认不具备权威性,确保观察者只报告、不裁决。
决策来源的显式标记
Actions 与 Patrol 现在能够识别一次决策究竟来自 finding、alert、objective,还是来自操作员的显式请求,从而让审批与复查的上下文更清晰。这与 internal/ai/patrol_ai.go 中目标(objectives)作为"持久化结果而非脚本"的设计相互呼应——当目标被显式标记为 observer_missing 时,run 会调用 patrol_propose_observer 一次提交最小可用的只读本地观察者设计,并要求诚实标注 evidence_fit 为 proxy 还是 direct coverage。
Action 拒绝遥测的分类
Action 拒绝遥测现在会对拒绝原因进行分类:目标变更(target changes)、前置条件(prerequisites)、契约失败(contract failures)、能力上限(capability limits)、策略决策(policy decisions)与过期计划(stale plans)。
拒绝原因在 agent 边界上以稳定、受限的机器码表达。定义见 internal/agentexec/types.go:
| 拒绝码 | 含义 |
|---|---|
action_contract_invalid |
操作契约无效 |
agent_capability_unavailable |
Agent 能力不可用 |
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 |
清理清单发生变化 |
这些码穿过 Unified Agent 边界时不会暴露命令输出、包名、路径或 provider 错误文本。IsActionRefusalReasonCode(同文件 internal/agentexec/types.go)只校验形状而非封闭枚举,从而允许更新的 agent 向较旧的 server 上报新的安全分类。
Docker-in-LXC 发现的受控退避
Docker-in-LXC 发现现在被显式控制,并会在 Proxmox 主机缓慢或失败时退避,而不是制造探测风暴(probe storm)。相关探测逻辑在 internal/hostagent/commands_execute_unix_test.go 等测试中有覆盖,核心意图是:发现行为可显式关闭/控制,并对慢主机采取退避策略,避免无节制的并发探测拖垮目标主机。
平台页面与底层表格共用谓词
平台页面现在以资产总量(estate totals)、状态分面(status facets)与搜索开头,且这些控件与底层表格共享同一组谓词。这意味着页面筛选与表格查询走同一套条件解析,用户在页面上看到的筛选结果与其对应的表格数据严格一致,不存在两套语义漂移。
通知设置反映真实投递结果
通知设置现在展示真实投递尝试的结果,而不是用测试发送(test send)作为在线投递健康度的代理。订阅型轮次的空闲超时也会在"已取消的 CLI 子进程仍持有继承的输出管道"场景下及时完成,避免因管道未关闭而挂起。
Fixed:发布激活恢复与收敛修复
- 发布激活恢复:现在会合并到规范的就绪结果(canonical readiness result),不再维护一份过期的历史任务名重复目录。
- Helm 收敛:当工作流从嵌套的 Pages checkout 执行时,会显式绑定仓库操作,避免在错误的工作目录下执行 helm 收敛。
- 付费运行时证明:每个 hosted paid-runtime 证明在调用私有 license 服务前都会先建立自己的 tailnet 连接。许可桥接与中间件逻辑位于
internal/api/licensing_bridge.go与internal/api/middleware_license.go。 - 容量失败上报:当专用 worker 在受限等待后仍无法接纳所需的双 shard 发布形态时,后端 planner 会明确上报容量失败(capacity failure),而不是静默降级。
Security:发布制品完整性、凭据边界与租户隔离
本轮候选在安全工程上的要点:
- PVE 编译保持无凭据(credential-free);GitHub-hosted 任务保留签名、发布变更与发布凭据。
- 容器镜像、Helm charts、公开归档、私有归档、校验和、签名与收敛证明(convergence proof)全部绑定到发布 commit 与源 workflow run。仓库中
scripts/release_control/reconcile_release_convergence.py与scripts/release_control/check_github_release_immutability_test.py正是这条"收敛 + 不可变"校验链的实现。 - 每个并行 Docker matrix 分支在发布前都会独立校验 exact checkout、预期发布线(release line)与不可变候选 manifest。
- Chart 与资源边界在显式包接缝处保留租户范围、router 授权、action 所有权与 operator 状态变更语义——即拆包调度不破坏原有的租户隔离与授权模型。
深入理解:本轮变更与仓库结构的对应关系
| 发布说明要点 | 仓库对应证据 |
|---|---|
| 回滚到 v6.2.1 | scripts/install.sh --version 参数 |
| Patrol 持久化结果/工作收据 | internal/operationreceipt/store.go |
| Patrol 确定性信号检测 | internal/ai/patrol_signals.go |
| 只读观察者配置 | cmd/pulse-agent/observers_config_test.go、cmd/pulse-agent/main.go |
| 观察者提议工具 | internal/agentcapabilities/tool_names.go |
| 拒绝原因分类 | internal/agentexec/types.go |
| 发布收敛与不可变校验 | scripts/release_control/reconcile_release_convergence.py、scripts/release_control/canonical_completion_guard.py |
| Patrol 运行全流程 | docs/PATROL_ARCHITECTURE.md |
小结与建议
v6.3.0-rc.6 作为发布候选,核心价值有三:一是把发布管道拆成可独立资格认证的单元并并行化发布,缩短从提交到可用候选的周转;二是把 Patrol 从"看聊天流"升级为"基于持久化结果 + 只读观察者 + 决策溯源"的确定性安全网架构;三是引入 Agent 最小权限安装、显式拒绝分类与更严格的制品凭据隔离。
若你正在测试该候选版本,建议按本文件给出的命令做好 v6.2.1 回滚准备,并留意 Windows Unified Agent 的 "Unknown Publisher" 提示属于预期行为(稳定版才会启用 Authenticode 签名通道);付费运行时功能请继续通过私有下载页面与私有运行时镜像获取。