Pulse v6.1.0-rc.2 技术解读:类型化 Action 生命周期、Patrol 治理式自治与安全加固
Pulse v6.1.0-rc.2 技术解读:类型化 Action 生命周期、Patrol 治理式自治与安全加固
导读
本文基于 docs/releases/V6_CHANGELOG_v6.1.0-rc.2.md 以及仓库中对应的源码与测试实现,系统梳理 Pulse v6.1.0-rc.2 这个发布候选版本的核心技术变化:规范化的类型化 Action 生命周期、Patrol 从「Watch 检测」与「模型调查」的分离、受策略约束的低风险自治、Docker/Kubernetes 行动后的独立验证、本地 Ollama qwen3:8b 快速启动、以及覆盖更新器、认证、存储与平台监测的 fail-closed 加固。阅读完本文,你将掌握该候选版本的升级/回滚操作、关键新能力的底层实现位置,以及这些改动在 internal/actionlifecycle、internal/ai、internal/actionrunner 等模块中的落地形态。
一、版本坐标:RC 的定位、基线、晋级路径与回滚目标
v6.1.0-rc.2 是 Pulse v6 次版本线的发布候选(RC),与稳定版 v6.0.5 对比,是累计变更集,并取代了 v6.1.0-rc.1。其版本元数据(见 docs/releases/V6_CHANGELOG_v6.1.0-rc.2.md 的 Release Metadata 一节)明确记录:
- 版本号:
v6.1.0-rc.2 - 回滚目标:
v6.0.5 - 回滚命令:
./scripts/install.sh --version v6.0.5 - 晋级路径:从
main分支构建的 release candidate - 移动端配套候选:iOS build 10 与 Android versionCode 8,位于 TestFlight 与 Google Play 的 internal-testing 轨道
配套的发布说明 docs/releases/RELEASE_NOTES_v6.1.0-rc.2.md 强调:本候选改变了认证边界与原生安装器/更新器边界,因此刻意走受治理的 RC 路径而非直接的 stable-patch 路径。RC 版本仅建议愿意测试预发布构建的用户通过常规 v6 安装/更新流程使用,且回滚目标锁定为 v6.0.5。从仓库脚本结构看,scripts/install.sh 的 --version 参数流(例如 scripts/build-release.sh 中 bash install.sh --version vX.Y.Z 的下载流程)正是 README 快速安装与 scripts/pulse-auto-update.sh 共用的安装入口,回滚命令可直接复用该参数。
二、核心架构:规范化的类型化 Action 生命周期
2.1 一个传输无关的生命周期服务
本候选的「Added」条目开宗明义:Pulse Intelligence 通过规范的类型化 Action 生命周期暴露显式的检测与调查 profile;Patrol 可以捕获类型化的 Action 提案,并把已批准的工作路由到共享生命周期,而非命令侧的旧执行路径。Desktop 与 Pulse Mobile 客户端也改用规范的 pending-action 队列、决策端点与 Action 身份,取代已退役的命令形态审批端点。
该生命周期的实现核心在 internal/actionlifecycle/service.go(1770 行)。包注释写得很清楚:这是传输无关的 Action 生命周期服务,负责规划、审批决策与类型化资源 Action 的执行。internal/api 的 REST 处理器与进程内 broker(如 Patrol 调查提案)必须统一路由到这一个服务,使所有调用方获得一致的资源查找、可用性检查、计划哈希、审计持久化、修复锁、计划漂移检测、执行与终态验证——任何调用方都不得绕过它直接下发资源变更。
生命周期通过一组接口契约切分职责:
Executor:执行此前已规划并批准的 Action(ExecuteAction(ctx, record));DispatchReconciler/DispatchBinder:按持久化的尝试身份(attempt identity)对账传输结果,但绝不重发变更(found仅为通过认证且关联成功的传输响应);AvailabilityChecker/FeasibilityChecker:只读的活体与可行性检查,前者用于资源投影,后者仅在规划/审批/派发具体 Action 时执行有界远程读取;Store:生命周期需要的窄持久化面,覆盖CreateActionAudit、RecordActionDecision、RecordActionExecutionStart/Admission/Result/Refusal、RecordActionDispatchReceipt等事件记录,以及GetPendingActionAudits这类 pending 队列查询。
Service 还挂载了 OnActionCompleted(每个终态审计记录)与 OnActionTransition(每次成功持久化的状态迁移)两个订阅钩子,持久化先于发布,因此 SSE 桥接与对账者不会观察到存储仍可能丢失的状态——这正是 changelog 中「Action 状态在写入时从权威审计对账调查结果、读取时补齐错过的迁移」的后端基础。
2.2 Actions 收件箱与审批可见性
「Added」中提到:Desktop 的 Actions 收件箱提供一个统一审查面,覆盖提案工作、策略来源(policy provenance)、审批状态、执行进度、验证细节与直接 Patrol 交接。前端侧的证据在 frontend-modern/src/stores/actionInbox.ts:其 pendingActionCount 信号负责在 Actions 导航标签上展示待审批数量(get pendingActionCount() 由响应中的 count 或 actions.length 推导)。后端对应的 REST 面在 internal/api/actions.go,配套的测试 internal/actionlifecycle/service_test.go 与 server_reconciliation_integration_test.go 验证了审批决策、派发尝试、操作回执(operation receipt)的完整闭环。
2.3 行动后的独立验证与操作回执
「Docker 和 Kubernetes 动作在执�行后验证支持的 scale 与 update 结果」这一条,对应仓库中的 operation receipt(操作回执) 机制:internal/operationreceipt 包提供 DigestCanonicalJSON、QueryResult、StateTerminal、ProtocolVersion 等类型,而 internal/actionrunner/runner.go 的 Runner.Execute 流程会做去重(ErrReplayInProgress)、绑定冲突校验(ErrBindingConflict)并在终态调用 store.Complete 落库。也就是说:一次受治理的 Docker 更新/重启,其「执行结果」必须通过独立于派发的回执查询(QueryFoundTerminal)才能被 Pulse 认定为已验证,而不是仅仅依赖命令返回码。
三、Patrol:Watch 检测与模型调查分离,证据与模型轮次有界
3.1 检测与调查的职责切分
changelog 的 Changed 条目指出:Patrol 把 Watch 检测与调查分离,对证据与模型轮次设界,保留多个被接受的 findings,并在类型化工具调用中保持规范资源身份。这与 docs/release-control/v6/internal/subsystems/patrol-intelligence.md(Patrol Intelligence 子系统契约,2806 行)的描述一致:检测仅保留一轮模型对话用于证据收集与 finding 决策;记录一个 finding 并不等于诊断充分,也不会移除其证据工具;缺失评估与 provider 失败仍作为可见限制保留在已接受的记录旁。
3.2 调查提示注入已验证的能力目录
「调查提示现在包含经过验证的能力目录(capability catalog),含审批门槛、参数 schema 与敏感/仅操作员约束」。这意味着模型不再需要猜测「哪些动作可用」——Pulse 直接把类型化的能力清单注入提示,任何不在目录内、参数不符合 schema 或触碰敏感/仅操作员约束的提议都会被生命周期拒绝。这一点从 internal/agentcapabilities/manifest.go 可看到支撑:能力清单中定义了 maintenanceWindowActive、maintenanceReason 等结构化选项,以及 MCP 面工具的白名单(allowlist)机制。
3.3 策略化自治:低风险 Docker/Podman 重启的许可边界
「策略化 Patrol 自治可仅对显式允许的资源授权低风险 Docker 与 Podman 重启,并支持可选周期性维护窗口」。该能力的边界语义在源码中清晰可见:
internal/unifiedresources/patrol_autopilot.go定义了PatrolAutopilotScopeCapabilityAllowlistedOnly = "capability_allowlisted_only",即自治范围限定为「仅能力白名单内」;- internal/ai/findings.go 定义了
ResourceOperatorStateMaintenanceWindow结构,并为每条 finding 提供维护窗口判断(MaintenanceWindow非空时进入抑制/安静化逻辑); - internal/agentcapabilities/manifest.go 中的能力描述同时覆盖
maintenanceWindowActive布尔选项,说明维护窗口是否生效会被纳入 agent 上下文(internal/agentcontext/resource_context_sections.go的MaintenanceWindowActive字段)。
由此可推断的运作规则是:没有显式 allowlist 的资源、维护窗口之外的窗口、以及降级模式下的动作,一律回到审批门控并 fail closed,这是 changelog 明示的「unsupported、out-of-window、downgraded-mode 保持审批门控」的实现基础。
3.4 现场(Live)Patrol 资格测试
「现场 Patrol 资格测试现在演练模型主导调查、类型化工具使用、finding 质量、修复规划与负向控制」。仓库中 internal/ai/qualification/ 目录包含评分器与客户端实现(如 scorer_test.go 中的 ScoreRun、client_test.go 中的模型切换验证),均以 ollama:qwen3:8b 为验证模型。这说明该 RC 不仅发布功能,还把「模型能否在真实工具调用下产出合格 finding、能否拒绝不该做的事(负向控制)」纳入了自动化资格测试范围。
四、受治理的运维行动:从主机更新到存储清理
changelog 的 Added 与 Changed 条目集中描述了一组共享治理路径的运维行动:主机更新、Debian 与 Ubuntu 包维护、存储压力清理、Docker 重启、受支持的 Proxmox 客户机生命周期——它们现在共用受治理的 Action、持久化回执与独立验证路径。internal/actionlifecycle/service.go 中 AvailabilityChecker/FeasibilityChecker 与 DispatchReconciler 的分工正是这套路径的骨架:派发前做只读可用性/可行性检查,派发后按尝试身份对账结果,任何「重启失败、容器未重建、包未安装」都不会被当作已验证成功。
配套的语义约束包括:
- Docker 更新必须重建容器:Fixed 条目明确「Docker 更新指引现在会重建容器,使所选镜像真正生效」,修复了此前「restart 无法应用新镜像」的问题;
- 共享网络命名空间保护:更新不会破坏共享另一个容器网络命名空间的容器;
- 时钟偏移容错:Docker 与 Kubernetes agent 的 liveness 评估现在正确处理时钟偏移;
- OOM 与重启证据权威化:Patrol 拒绝无根据的健康断言,Docker OOM 事件使用权威证据(Fixed 条目「authoritative restart and OOM evidence」)。
五、本地 AI Provider:Ollama qwen3:8b 引导式快速启动
5.1 为什么是 qwen3:8b
「本地 provider 设置包含 Ollama qwen3:8b 引导式快速启动」。这不是随意挑选的模型:从 internal/config/ai_providers.go 可以看到常量 OllamaSuggestedPatrolModel = "qwen3:8b",即它是 Pulse 官方建议的 Patrol 模型。配套测试与文档给出了更严格的事实:
- internal/api/contract_test.go 的契约测试明示:「Ollama 连通性本身不证明工具支持,
llama3:latest未通过 Patrol 的工具检查;qwen3:8b是经过验证的 Patrol 模型」; - internal/ai/manual_ollama_preflight_test.go 提到预检运行中
qwen3:8b是唯一「blessed」(被认可)的模型; - internal/ai/providers/ollama_test.go 验证了 thinking 模型的流式行为:
qwen3:8b在正式内容之前通过message.thinking流式输出推理过程,Pulse 必须将其实时呈现(TestOllamaClient_ChatStream_Thinking断言事件序列为thinking → thinking → content → done); - 推理档位语义:
qwen3:8b在ReasoningEffortLow时禁用 thinking,Medium/High保留 thinking(internal/ai/providers/issue1624_ollama_probe_options_test.go)。
5.2 快速启动步骤(基于仓库文档与契约)
综合 docs/AI_PATROL_QUALIFICATION.md 与上述测试,本地引导的典型路径是:
# 1) 拉取经过验证的 Patrol 模型
ollama pull qwen3:8b
# 2) 在 Pulse 的 Provider & Models 设置中选择 "ollama:qwen3:8b" 作为 Patrol 模型
# 3) 可选:为已拉取的模型释放常驻内存
curl http://localhost:11434/api/generate -d '{"model":"qwen3:8b","keep_alive":0}'
注意 UI 层的提醒文案(见 frontend-modern/src/pages/tests/AIIntelligence.test.tsx):Ollama 连通性≠工具能力,必须显式 ollama pull qwen3:8b 并把它选为 Patrol 模型,才能通过 Patrol 的工具支持检查。运行环境方面,docs/AI_PATROL_QUALIFICATION.md 记录了一个约 8GB VRAM、Ollama 0.32.1 + qwen3:8b Q4_K_M 的实测参考(属于仓库记录的验证环境,非泛化承诺)。
六、Claude 订阅模型:schema 绑定流式、原生工具与有界预检
「Claude 订阅模型现在支持 schema 绑定的流式轮次、原生工具、有界预检与重试安全的持久化结果」。其关键设计约束在 changelog 的 Changed 条目中:Claude 路线不创建并行 action 执行路径——也就是它虽然能原生调用类型化工具并流式返回,但一切变更仍必须落到第一节描述的统一生命周期。这正是「类型化工具使用」与「命令侧旧路径」区分的意义:订阅模型(subscription-backed)与按 API 计费的 provider 路由被显式分离,前者的持久化结果在重试与重放处理中保持幂等,不会把不完整的证据升级为已验证结论。
七、集群、Unified Agent 与 Docker 库存的可靠性
- 集群成员可覆盖发现的连接地址:Fixed 条目补充「成员通过另一个成员重新注册时保留操作员选择的连接地址」,避免发现地址被后续注册覆盖;
- Unified Agent 支持旋转 JSON 日志路径:Windows 原生服务现在写入操作员可控的旋转日志,安装时验证已记录的就绪状态,并为安装、替换、恢复、持久化与卸载携带原生生命周期证据;
- Docker 库存身份冲突检测:两台机器上报相同 agent 身份时给出告警;registry 客户端可从认证挑战(authentication challenge)协商 bearer token;
- 平台表格统一模型:Docker、Kubernetes、TrueNAS、vSphere 与 Proxmox 节点表共享一个可排序的平台表格模型,并保留用户控制的列顺序(Changed 条目)。
八、本候选的关键修复与安全加固
8.1 更新器与安装器的 fail-closed 语义
- 替换二进制先自测:in-app 更新器在交换二进制之前先对替换二进制自测;
- 版本意识(edition-aware)更新检查:阻止静默的 Pro→社区降级,并保留显式回滚路径;
- FreeBSD 更新恢复保留原生 agent 生命周期;Windows 服务安装在无法配置所需恢复动作或非崩溃恢复时 fail closed;Windows 安装成功现在同时要求本地就绪与非空持久化服务日志;
- 签名配置不完整时快速失败(docs/releases/RELEASE_NOTES_v6.1.0-rc.2.md)。
8.2 认证、身份与数据真实性
- 遗留 OIDC 回调恢复发起方 provider;无 refresh token 的 OIDC 会话在允许处保持有效;混合认证启动避免死锁;Basic-auth 身份可达 Action 授权;
- 被删除主机可用新凭据重新注册;重载窗口期间连续性状态(continuity state)为 agent 配置供数;Windows 版本检查归一化前导
v; - 访客告警随所属节点迁移;缺失的 guest-agent 磁盘数据用 unavailable 哨兵而非伪造测量值;
- 物理磁盘表保持宽节点磁盘可见,待机 SSD 不再被报告为活跃故障;SSO 管理员保留其有效设置权限;
- 受限 NAS 安装不再依赖
od;recovery-point、TrueNAS 与nvme-eui磁盘对账保留权威身份。
8.3 安全边界
Security 章节的要点是「首次运行安全边界 fail closed」「修复锁状态未知时自主派发 fail closed」以及由 CodeQL 驱动的请求/存储/整数转换/分配/cookie 边界加固。发布侧:macOS 原生发布签名与公证在本 RC 为必须;Windows Authenticode 在稳定晋级前仍为必须,且在本候选的公开签名应用待定时被显式披露。Demo SSH 设置不再削弱私有部署主机或 IP 目标的 host-key 处理;更新验证文档与发布输出使用受守卫的 OpenSSH allowed_signers 行,加固后的更新服务把配置备份保留在可写路径。
九、升级与回滚操作指引
- 升级:仅在你愿意测试 RC 时使用常规 v6 安装/更新流程安装
v6.1.0-rc.2;该候选改变了认证与原生安装器/更新器边界,走的是受治理 RC 路径而非 stable-patch 路径。 - 回滚:回滚目标是
v6.0.5,精确重装命令为:
./scripts/install.sh --version v6.0.5
- 移动端:iOS build 10 与 Android versionCode 8 携带配套的 plan-bound Action 审查与审批客户端,仅停留于 TestFlight 与 Google Play internal-testing 轨道,本 RC 不包含公开商店发布。
- Windows 说明:本候选的 Windows Unified Agent 二进制保留与
v6.0.5相同的校验和与分离签名验证,但尚未 Authenticode 签名,Windows 可能显示未知发布者警告;公共 Windows Authenticode 签名在稳定晋级前仍为必须。 - 付费能力:Pulse Pro、Relay 与符合资格的遗留客户应继续使用私有下载页与私有运行时镜像获取付费运行时特性(见 docs/releases/RELEASE_NOTES_v6.1.0-rc.2.md 的 Upgrade Notes)。
十、源码索引(便于继续深挖)
- 类型化 Action 生命周期服务:internal/actionlifecycle/service.go(包注释即架构说明)
- 生命周期/派发对账测试:internal/actionlifecycle/service_test.go、internal/actionlifecycle/server_reconciliation_integration_test.go
- 操作回执与执行器:internal/operationreceipt/、internal/actionrunner/runner.go
- Patrol Intelligence 子系统契约:docs/release-control/v6/internal/subsystems/patrol-intelligence.md
- Patrol 自治作用域与维护窗口:internal/unifiedresources/patrol_autopilot.go、internal/ai/findings.go、internal/agentcapabilities/manifest.go
- Ollama 提供商与建议模型:internal/ai/providers/ollama_test.go、internal/config/ai_providers.go
- 资格测试:internal/ai/qualification/
- 前端 Actions 收件箱计数:frontend-modern/src/stores/actionInbox.ts
- 发布说明与安装脚本:docs/releases/RELEASE_NOTES_v6.1.0-rc.2.md、scripts/install.sh