可观测性运维后端【免费下载链接】PulseReal-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with smart alerts and AI patrols that catch silent failures.项目地址https://gitcode.com/gh_mirrors/pulse27/Pulse点击查看免费下载本文基于 provider-first-platform-landing-surface-2026-05-23 这份 L8 前端原语frontend primitives实施记录展开结合 Pulse 仓库frontend-modern源码与架构测试系统讲解 Pulse v6 认证后落地页landing surface的 Provider-First 解析机制认证根路由与登录跳转如何按照规范顺序Proxmox → Docker → Kubernetes → TrueNAS → vSphere → Agents解析到第一个可见的平台页以及 App Shell 如何通过路由模块预热、数据保持轻量的启动策略避免预加载已退役的 Infrastructure / Workloads 图表缓存。读完本文你将掌握这一平台导航准入与默认落地路由的设计全貌并能对照源码定位其实现与验证点。一、背景为什么需要 Provider-First 落地页Pulse 是一个面向 Proxmox VE、PBS、Docker、Kubernetes、TrueNAS 与 vSphere 的自托管实时监控平台README.md。在 v6 之前认证后的根路由/登录跳转存在两类问题AgentsMachines/独立 Agent 机器表面可能喧宾夺主当 estate资源环境中同时存在真实 provider如 Docker、TrueNAS与 Pulse agent 时如果以机器数量等简单口径推导落地页很容易把用户带到只有 Pulse Agent 存在的机器列表页而不是用户真正关心的平台监控页。遗留 Infrastructure 表面成为默认运营面历史遗留的 Infrastructure通用基础设施落地页应当保持路由兼容route-compatible即老链接仍能打开但不应再作为认证后的默认运营表面。provider-first-platform-landing-surface断言assertion的目标非常明确Pulse v6 authenticated root and login handoff now resolves to the first visible provider or runtime platform in canonical shell order: Proxmox, Docker, Kubernetes, TrueNAS, vSphere, then Agents only when the estate is agent-only.即认证根路由与登录交接解析到规范 Shell 顺序中第一个可见的 provider 或 runtime 平台只有当 estate 完全是 agent-only 时才落到 Agents。二、规范顺序与选择器PRIMARY_PLATFORM_NAV_IDS 与 selectFirstVisiblePrimaryPlatformNavigationId2.1 规范平台顺序的定义记录文档中提到的选择器selectFirstVisiblePrimaryInfrastructureNavigationId在源码中的实际实现为selectFirstVisiblePrimaryPlatformNavigationId位于 platformNavigationModel.ts。它依赖的规范顺序常量定义在同一文件export const PRIMARY_PLATFORM_NAV_IDS: readonly PrimaryPlatformNavId[] [ proxmox, docker, kubernetes, truenas, vmware, standalone, ] as const;platformNavigationModel.ts可以看到顺序严格遵循文档断言Proxmox → Docker → Kubernetes → TrueNAS → vSphere → standaloneAgents。standalone被排在最末仅作为 agent-only estate 的兜底。2.2 选择器的判定逻辑export function selectFirstVisiblePrimaryPlatformNavigationId( visibility: PlatformNavigationVisibility, ): PrimaryPlatformNavId | null { return ( PRIMARY_PLATFORM_NAV_IDS.find((navId) primaryPlatformNavigationIsVisible(visibility, navId), ) ?? null ); }platformNavigationModel.ts其逻辑等价于按PRIMARY_PLATFORM_NAV_IDS顺序遍历六个平台 ID用primaryPlatformNavigationIsVisiblevisibility[navId] true找到第一个可见的平台若全部不可见例如空 estate 或 agent 证据不足返回null。这正是first visible provider platform in canonical order, Agents only as last-resort的精确实现。2.3 平台可见性如何从资源证据推导PlatformNavigationVisibility是一个RecordPrimaryPlatformNavId, booleanplatformNavigationModel.ts由buildPrimaryPlatformNavigationVisibility从资源列表推导export function buildPrimaryPlatformNavigationVisibility( resources: readonly Resource[], ): PlatformNavigationVisibility { const presentNavigableScopes buildNavigableResourcePlatformScopeSet(resources); const hasAvailabilityEndpoints resources.some( (resource) resource.type network-endpoint || resource.platformType availability || resource.sources?.includes(availability), ); return { proxmox: PRIMARY_PLATFORM_NAV_SCOPE_IDS.proxmox.some((id) presentNavigableScopes.has(id)), docker: PRIMARY_PLATFORM_NAV_SCOPE_IDS.docker.some((id) presentNavigableScopes.has(id)), kubernetes: PRIMARY_PLATFORM_NAV_SCOPE_IDS.kubernetes.some((id) presentNavigableScopes.has(id), ), truenas: PRIMARY_PLATFORM_NAV_SCOPE_IDS.truenas.some((id) presentNavigableScopes.has(id)), vmware: PRIMARY_PLATFORM_NAV_SCOPE_IDS.vmware.some((id) presentNavigableScopes.has(id)), standalone: resources.some(isPulseAgentPlatformResource) || hasAvailabilityEndpoints, }; }platformNavigationModel.ts关键点在于平台 scope 到导航 ID 的映射表export const PRIMARY_PLATFORM_NAV_SCOPE_IDS: RecordPrimaryPlatformNavId, readonly string[] { proxmox: [proxmox-pve, proxmox-pbs, proxmox-pmg], docker: [docker], kubernetes: [kubernetes], truenas: [truenas], vmware: [vmware-vsphere], standalone: [agent], };platformNavigationModel.ts这意味着Proxmox 家族PVE、PBS、PMG 三种来源共享同一个proxmox落地页Docker / Kubernetes / TrueNAS / vSphere各自由对应的单一来源平台标识激活standaloneAgents只在出现agent平台证据或 availability 端点时激活且isPulseAgentPlatformResource只对真正的 Pulse Agent 资源生效——一个通过 agent 来源上报的 TrueNAS 或 Proxmox 主机不会错误激活 Machines 页这正是架构测试does not admit the standalone page for a provider-owned estate验证的行为见 App.architecture.test.ts。此外buildNavigableResourcePlatformScopeSet还通过SUPPORTED_PLATFORM_IDS、ADMITTED_PLATFORM_IDS与getSourcePlatformManifestEntry对平台清单PLATFORM_SUPPORT_MANIFEST.json做交集过滤确保只有可导航navigable的平台才会进入候选集合platformNavigationModel.ts。三、根路由与登录跳转getDefaultWorkspaceRoute3.1 默认工作区路由函数记录文档强调Root/login redirect uses that selector throughgetDefaultWorkspaceRoute。该函数位于 App.tsxexport function getDefaultWorkspaceRoute( visibility: PlatformNavigationVisibility, hasSettingsAccess: boolean, ): string { const navId selectFirstVisiblePrimaryPlatformNavigationId(visibility); if (navId) return PRIMARY_INFRASTRUCTURE_ROUTE_BY_ID[navId]; return hasSettingsAccess ? /settings/infrastructure : /alerts; }配套的路由映射const PRIMARY_INFRASTRUCTURE_ROUTE_BY_ID: RecordPrimaryPlatformNavId, string { proxmox: buildProxmoxPath(), docker: buildDockerPath(), kubernetes: buildKubernetesPath(), truenas: buildTrueNASPath(), vmware: buildVmwarePath(), standalone: buildStandalonePath(), };App.tsx其语义可概括为一张优先级决策表可见平台按规范顺序取第一个落地路由proxmoxPVE/PBS/PMG 任一证据Proxmox 工作区路径dockerDocker 工作区路径kubernetesKubernetes 工作区路径truenasTrueNAS 工作区路径vmwarevSphere 工作区路径standaloneagent-onlyAgents/Machines 工作区路径无任何可见平台且无设置权限/alerts告警页兜底无任何可见平台但有设置权限/settings/infrastructure基础设施设置最后两行非常关键空 estate 不会把用户丢进某个已退役的 Infrastructure 图表页而是落到告警页或基础设施设置页——这与legacy Infrastructure remains route-compatible rather than the default operational surface的断言完全一致。3.2 认证根路由 / 登录交接的调用链在 App.tsx 中平台导航准入是一个 memo登录后的工作区重定向在createEffect中完成const platformNavigationAdmission createMemo(() resolvePlatformNavigationAdmission( runtime.state().resources || [], runtime.runtimeStateResolved(), runtime.platformAdmission(), ), ); const platformNavigationResolved () platformNavigationAdmission().resolved; const platformNavigationVisibility () platformNavigationAdmission().visibility;createEffect(() { if (runtime.isLoading() || runtime.needsAuth() || isPublicRoute()) return; if (!isWorkspaceEntryRoutePath(location.pathname)) { workspaceRedirectPending false; return; } if (!platformNavigationResolved()) return; if (workspaceRedirectPending) return; workspaceRedirectPending true; navigate(getDefaultWorkspaceRoute(platformNavigationVisibility(), hasSettingsAccess()), { replace: true, }); });App.tsx注意这里的replace: true与workspaceRedirectPending守卫登录握手完成后用户停留在工作区入口路由workspace entry route即根路径类入口时会原地替换为默认工作区路由且整个生命周期只触发一次不会产生历史栈垃圾或循环跳转。3.3 平台导航准入从一资源请求到权威 payload 的过渡resolvePlatformNavigationAdmissionApp.tsx是 Provider-First 落地页能快速生效的核心它优先使用运行时已解析runtimeStateResolved的资源列表构造权威可见性在运行时尚未就绪时回退到服务端下发的platformAdmission导航准入 facet从而让 Shell 无需等待整个 estate 大小的运行时 payload 就能渲染导航。一旦权威 payload 到达buildPrimaryPlatformNavigationVisibility基于实时资源重新计算两者按构造一致性自动交接用户无感知。架构测试对此有细致覆盖App.architecture.test.ts认证 REST 资源在 WebSocket 首包之前即可完成准入混合 agent docker-host truenas 资源的 estategetDefaultWorkspaceRoute返回/docker/overview瞬时 WebSocket 断线重连期间平台可见性保持不抖动权威空快照runtimeStateResolvedtrue且无资源时即便浏览器本地残留了陈旧 metadata也不会误准入任何平台且无设置权限时落地/alertsApp.architecture.test.ts。四、主导航、命令面板与快捷键全面贯彻 Provider-First记录文档断言Desktop 与 Mobile 主导航、命令面板command palette、键盘快捷键、路由预加载与 active-tab helpers 均让 provider 平台领先于 Agents。源码证据集中在 AppLayout.tsx主导航 tab 顺序primaryInfrastructureRouteById同样使用selectFirstVisiblePrimaryPlatformNavigationId(platformNavigationVisibility())决定当前激活的主平台 tab无可见平台时回退ROOT_ALERTS_PATHAppLayout.tsxactive-tab helpersrouteBelongsToPrimaryTab通过PRIMARY_ROUTE_PREFIX_BY_IDproxmox/docker/kubernetes/truenas/vmware/standalone前缀把当前 URL 归属到对应主 tab并借助primaryRouteMemory记住每个主 tab 最后访问的子路由AppLayout.tsx命令面板与快捷键filterPlatformNavigationShortcuts只对primaryPlatformNavigationIsVisible的平台注入快捷键路由不可见平台不会出现在命令面板候选里platformNavigationModel.ts。因此无论用户从桌面还是移动端进入、通过命令面板搜索还是敲快捷键第一个候选永远是按规范顺序排列的 provider 平台Agents 只在 estate 中确无 provider 证据时才会出现在主位。五、启动性能不再预热已退役的 Infrastructure / Workloads 图表缓存5.1 App Shell 路由预加载清单记录文档最后一条断言是App Shell 不再以通用认证副作用的方式预热已退役的 Infrastructure 或 Workloads 图表缓存平台优先启动保持路由模块热、数据轻route-module warm and>export const APP_SHELL_ROUTE_PRELOAD_PATHS [ACTIONS_PATH] as const;即 Shell 级通用预加载只包含 Actions 路径——不再包含 Infrastructure 或 Workloads 的图表模块。而各平台的预加载由ROUTE_PRELOADERS按需触发routePreload.ts每个预加载器都带matches(route)条件只有当用户实际导航到对应平台路由时才import(/pages/Proxmox)、import(/pages/Docker)等。这正是route-module warm平台路由模块在命中时快速就绪、data-light图表缓存不被无条件拉取的落地方式。5.2 useAppRuntimeState 不再 import / prewarm 图表缓存记录文档明确要求useAppRuntimeState不 import 也不预热 Infrastructure 或 Workloads 图表缓存。从 useAppRuntimeState.ts 的依赖与状态来看它只聚合会话级运行时状态资源、WebSocket、组织、许可、主题、告警激活、行动收件箱、AI 情报等见 useAppRuntimeState.ts其中资源状态仅保留connectedInfrastructure列表useAppRuntimeState.ts这类轻量派生数据而非拉取整张图表缓存实际资源/表格查询完全由被选中的平台页面在自己的数据加载周期中发起。架构测试也通过源码断言守护了这条边界expect(appSource).toContain(getDefaultWorkspaceRoute)见 App.architecture.test.ts。从源码结构可以推断这一设计把全局副作用式图表预热彻底移除落地页只承担导航职责数据获取下沉到平台页面自身从而显著降低认证首屏的资源下载与解析成本。六、旧表面兼容legacy Infrastructure 仅保持路由兼容记录文档强调legacy Infrastructure remains route-compatible rather than the default operational surface。这体现在两个方面路由兼容旧链接如/settings/infrastructure、/alerts 等历史入口依然可达getDefaultWorkspaceRoute在无可见平台且具备设置权限时仍然会指向/settings/infrastructure保证老用户书签与既有集成不失效不再作为默认面只要 estate 存在任何 provider 证据或 agent-only 证据根路由与登录交接就不再以 Infrastructure 为默认运营面而是按规范顺序解析到 provider 平台页。这与同目录下的姊妹记录 infrastructure-default-landing-dashboard-retirement-2026-04-29 所记录的Infrastructure 默认落地仪表盘退役是同一演进方向的两份证据。七、测试与验证架构测试如何守护 Provider-FirstProvider-First 落地页的行为被 App.architecture.test.ts 以架构级测试锁定核心用例包括场景期望结果agent docker-host truenas 混合 estategetDefaultWorkspaceRoute→/docker/overviewDocker 先于 TrueNASTrueNAS 证据存在、standalone 无证据不显示 standalone 页落地/truenas/overview仅 standaloneagent-only落地 standalone 工作区权威空快照 无设置权限全部可见性为 false落地/alerts权威空快照 有设置权限落地/settings/infrastructure无 facet 也无运行时状态保持 unresolved不产生跳转WebSocket 断线重连可见性与落地路由不抖动App.architecture.test.ts这些用例从排序正确性、Agents 不越位、空 estate 兜底、断线稳定性、权威性交接五个维度验证了 Provider-First 断言的每一项承诺是后续演进如新增平台时防止回归的防线。八、总结Provider-First 落地页的四个设计要点单一规范顺序PRIMARY_PLATFORM_NAV_IDS定义了 Proxmox → Docker → Kubernetes → TrueNAS → vSphere → standalone 的唯一权威顺序选择器selectFirstVisiblePrimaryPlatformNavigationId负责取第一个可见者证据驱动可见性平台可见性由资源证据经PRIMARY_PLATFORM_NAV_SCOPE_IDS映射推导agent-only 的 standalone 被严格限制避免 Machines 页喧宾夺主快速、一次性的登录交接getDefaultWorkspaceRouteresolvePlatformNavigationAdmission让 Shell 在收到首个认证资源或准入 facet 时即可完成重定向replace语义保证历史栈干净启动数据轻量App Shell 只预加载 Actions 路由模块不再预热已退役的 Infrastructure / Workloads 图表缓存资源查询交由被选中的平台页按需发起。对于需要扩展 Pulse 平台导航的开发者建议从 platformNavigationModel.ts 的三处常量PrimaryPlatformNavId、PRIMARY_PLATFORM_NAV_IDS、PRIMARY_PLATFORM_NAV_SCOPE_IDS入手并同步更新 App.architecture.test.ts 中的对应用例即可在不破坏现有落地语义的前提下安全演进。赞分享可观测性运维后端【免费下载链接】PulseReal-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with smart alerts and AI patrols that catch silent failures.项目地址https://gitcode.com/gh_mirrors/pulse27/Pulse点击查看免费下载相关推荐Pulse v6 基础设施默认落地页改造Dashboard 路由退役的架构决策与验证实践Pulse v6 基础设施默认落地页改造Dashboard 路由退役的架构决策与验证实践 本文基于仓库内发布控制记录 infrastructure defau可观测性运维后端Epic Stack认证路由登录注册页面Epic Stack认证路由登录注册页面 还在为复杂的用户认证系统头疼吗Epic Stack提供了一套完整的认证解决方案从登录、注册到密码重置全部开箱即后端前端开发工具认证鉴权Azure Data Studio 中的 GitHub 认证扩展Authentication Provider 机制与登录流程全解析Azure Data Studio 中的 GitHub 认证扩展Authentication Provider 机制与登录流程全解析 本篇技术指南围绕 Azu数据库客户端数据库桌面应用后端上一篇ComfyUI IPAdapter节点异常排查从现象到根源的完整诊断流程下一篇终极解决方案如何用VisualCppRedist AIO一键修复所有Windows软件依赖问题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
可观测性运维后端【免费下载链接】PulseReal-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with smart alerts and AI patrols that catch silent failures.项目地址https://gitcode.com/gh_mirrors/pulse27/Pulse点击查看免费下载本文基于 provider-first-platform-landing-surface-2026-05-23 这份 L8 前端原语frontend primitives实施记录展开结合 Pulse 仓库frontend-modern源码与架构测试系统讲解 Pulse v6 认证后落地页landing surface的 Provider-First 解析机制认证根路由与登录跳转如何按照规范顺序Proxmox → Docker → Kubernetes → TrueNAS → vSphere → Agents解析到第一个可见的平台页以及 App Shell 如何通过路由模块预热、数据保持轻量的启动策略避免预加载已退役的 Infrastructure / Workloads 图表缓存。读完本文你将掌握这一平台导航准入与默认落地路由的设计全貌并能对照源码定位其实现与验证点。一、背景为什么需要 Provider-First 落地页Pulse 是一个面向 Proxmox VE、PBS、Docker、Kubernetes、TrueNAS 与 vSphere 的自托管实时监控平台README.md。在 v6 之前认证后的根路由/登录跳转存在两类问题AgentsMachines/独立 Agent 机器表面可能喧宾夺主当 estate资源环境中同时存在真实 provider如 Docker、TrueNAS与 Pulse agent 时如果以机器数量等简单口径推导落地页很容易把用户带到只有 Pulse Agent 存在的机器列表页而不是用户真正关心的平台监控页。遗留 Infrastructure 表面成为默认运营面历史遗留的 Infrastructure通用基础设施落地页应当保持路由兼容route-compatible即老链接仍能打开但不应再作为认证后的默认运营表面。provider-first-platform-landing-surface断言assertion的目标非常明确Pulse v6 authenticated root and login handoff now resolves to the first visible provider or runtime platform in canonical shell order: Proxmox, Docker, Kubernetes, TrueNAS, vSphere, then Agents only when the estate is agent-only.即认证根路由与登录交接解析到规范 Shell 顺序中第一个可见的 provider 或 runtime 平台只有当 estate 完全是 agent-only 时才落到 Agents。二、规范顺序与选择器PRIMARY_PLATFORM_NAV_IDS 与 selectFirstVisiblePrimaryPlatformNavigationId2.1 规范平台顺序的定义记录文档中提到的选择器selectFirstVisiblePrimaryInfrastructureNavigationId在源码中的实际实现为selectFirstVisiblePrimaryPlatformNavigationId位于 platformNavigationModel.ts。它依赖的规范顺序常量定义在同一文件export const PRIMARY_PLATFORM_NAV_IDS: readonly PrimaryPlatformNavId[] [ proxmox, docker, kubernetes, truenas, vmware, standalone, ] as const;platformNavigationModel.ts可以看到顺序严格遵循文档断言Proxmox → Docker → Kubernetes → TrueNAS → vSphere → standaloneAgents。standalone被排在最末仅作为 agent-only estate 的兜底。2.2 选择器的判定逻辑export function selectFirstVisiblePrimaryPlatformNavigationId( visibility: PlatformNavigationVisibility, ): PrimaryPlatformNavId | null { return ( PRIMARY_PLATFORM_NAV_IDS.find((navId) primaryPlatformNavigationIsVisible(visibility, navId), ) ?? null ); }platformNavigationModel.ts其逻辑等价于按PRIMARY_PLATFORM_NAV_IDS顺序遍历六个平台 ID用primaryPlatformNavigationIsVisiblevisibility[navId] true找到第一个可见的平台若全部不可见例如空 estate 或 agent 证据不足返回null。这正是first visible provider platform in canonical order, Agents only as last-resort的精确实现。2.3 平台可见性如何从资源证据推导PlatformNavigationVisibility是一个RecordPrimaryPlatformNavId, booleanplatformNavigationModel.ts由buildPrimaryPlatformNavigationVisibility从资源列表推导export function buildPrimaryPlatformNavigationVisibility( resources: readonly Resource[], ): PlatformNavigationVisibility { const presentNavigableScopes buildNavigableResourcePlatformScopeSet(resources); const hasAvailabilityEndpoints resources.some( (resource) resource.type network-endpoint || resource.platformType availability || resource.sources?.includes(availability), ); return { proxmox: PRIMARY_PLATFORM_NAV_SCOPE_IDS.proxmox.some((id) presentNavigableScopes.has(id)), docker: PRIMARY_PLATFORM_NAV_SCOPE_IDS.docker.some((id) presentNavigableScopes.has(id)), kubernetes: PRIMARY_PLATFORM_NAV_SCOPE_IDS.kubernetes.some((id) presentNavigableScopes.has(id), ), truenas: PRIMARY_PLATFORM_NAV_SCOPE_IDS.truenas.some((id) presentNavigableScopes.has(id)), vmware: PRIMARY_PLATFORM_NAV_SCOPE_IDS.vmware.some((id) presentNavigableScopes.has(id)), standalone: resources.some(isPulseAgentPlatformResource) || hasAvailabilityEndpoints, }; }platformNavigationModel.ts关键点在于平台 scope 到导航 ID 的映射表export const PRIMARY_PLATFORM_NAV_SCOPE_IDS: RecordPrimaryPlatformNavId, readonly string[] { proxmox: [proxmox-pve, proxmox-pbs, proxmox-pmg], docker: [docker], kubernetes: [kubernetes], truenas: [truenas], vmware: [vmware-vsphere], standalone: [agent], };platformNavigationModel.ts这意味着Proxmox 家族PVE、PBS、PMG 三种来源共享同一个proxmox落地页Docker / Kubernetes / TrueNAS / vSphere各自由对应的单一来源平台标识激活standaloneAgents只在出现agent平台证据或 availability 端点时激活且isPulseAgentPlatformResource只对真正的 Pulse Agent 资源生效——一个通过 agent 来源上报的 TrueNAS 或 Proxmox 主机不会错误激活 Machines 页这正是架构测试does not admit the standalone page for a provider-owned estate验证的行为见 App.architecture.test.ts。此外buildNavigableResourcePlatformScopeSet还通过SUPPORTED_PLATFORM_IDS、ADMITTED_PLATFORM_IDS与getSourcePlatformManifestEntry对平台清单PLATFORM_SUPPORT_MANIFEST.json做交集过滤确保只有可导航navigable的平台才会进入候选集合platformNavigationModel.ts。三、根路由与登录跳转getDefaultWorkspaceRoute3.1 默认工作区路由函数记录文档强调Root/login redirect uses that selector throughgetDefaultWorkspaceRoute。该函数位于 App.tsxexport function getDefaultWorkspaceRoute( visibility: PlatformNavigationVisibility, hasSettingsAccess: boolean, ): string { const navId selectFirstVisiblePrimaryPlatformNavigationId(visibility); if (navId) return PRIMARY_INFRASTRUCTURE_ROUTE_BY_ID[navId]; return hasSettingsAccess ? /settings/infrastructure : /alerts; }配套的路由映射const PRIMARY_INFRASTRUCTURE_ROUTE_BY_ID: RecordPrimaryPlatformNavId, string { proxmox: buildProxmoxPath(), docker: buildDockerPath(), kubernetes: buildKubernetesPath(), truenas: buildTrueNASPath(), vmware: buildVmwarePath(), standalone: buildStandalonePath(), };App.tsx其语义可概括为一张优先级决策表可见平台按规范顺序取第一个落地路由proxmoxPVE/PBS/PMG 任一证据Proxmox 工作区路径dockerDocker 工作区路径kubernetesKubernetes 工作区路径truenasTrueNAS 工作区路径vmwarevSphere 工作区路径standaloneagent-onlyAgents/Machines 工作区路径无任何可见平台且无设置权限/alerts告警页兜底无任何可见平台但有设置权限/settings/infrastructure基础设施设置最后两行非常关键空 estate 不会把用户丢进某个已退役的 Infrastructure 图表页而是落到告警页或基础设施设置页——这与legacy Infrastructure remains route-compatible rather than the default operational surface的断言完全一致。3.2 认证根路由 / 登录交接的调用链在 App.tsx 中平台导航准入是一个 memo登录后的工作区重定向在createEffect中完成const platformNavigationAdmission createMemo(() resolvePlatformNavigationAdmission( runtime.state().resources || [], runtime.runtimeStateResolved(), runtime.platformAdmission(), ), ); const platformNavigationResolved () platformNavigationAdmission().resolved; const platformNavigationVisibility () platformNavigationAdmission().visibility;createEffect(() { if (runtime.isLoading() || runtime.needsAuth() || isPublicRoute()) return; if (!isWorkspaceEntryRoutePath(location.pathname)) { workspaceRedirectPending false; return; } if (!platformNavigationResolved()) return; if (workspaceRedirectPending) return; workspaceRedirectPending true; navigate(getDefaultWorkspaceRoute(platformNavigationVisibility(), hasSettingsAccess()), { replace: true, }); });App.tsx注意这里的replace: true与workspaceRedirectPending守卫登录握手完成后用户停留在工作区入口路由workspace entry route即根路径类入口时会原地替换为默认工作区路由且整个生命周期只触发一次不会产生历史栈垃圾或循环跳转。3.3 平台导航准入从一资源请求到权威 payload 的过渡resolvePlatformNavigationAdmissionApp.tsx是 Provider-First 落地页能快速生效的核心它优先使用运行时已解析runtimeStateResolved的资源列表构造权威可见性在运行时尚未就绪时回退到服务端下发的platformAdmission导航准入 facet从而让 Shell 无需等待整个 estate 大小的运行时 payload 就能渲染导航。一旦权威 payload 到达buildPrimaryPlatformNavigationVisibility基于实时资源重新计算两者按构造一致性自动交接用户无感知。架构测试对此有细致覆盖App.architecture.test.ts认证 REST 资源在 WebSocket 首包之前即可完成准入混合 agent docker-host truenas 资源的 estategetDefaultWorkspaceRoute返回/docker/overview瞬时 WebSocket 断线重连期间平台可见性保持不抖动权威空快照runtimeStateResolvedtrue且无资源时即便浏览器本地残留了陈旧 metadata也不会误准入任何平台且无设置权限时落地/alertsApp.architecture.test.ts。四、主导航、命令面板与快捷键全面贯彻 Provider-First记录文档断言Desktop 与 Mobile 主导航、命令面板command palette、键盘快捷键、路由预加载与 active-tab helpers 均让 provider 平台领先于 Agents。源码证据集中在 AppLayout.tsx主导航 tab 顺序primaryInfrastructureRouteById同样使用selectFirstVisiblePrimaryPlatformNavigationId(platformNavigationVisibility())决定当前激活的主平台 tab无可见平台时回退ROOT_ALERTS_PATHAppLayout.tsxactive-tab helpersrouteBelongsToPrimaryTab通过PRIMARY_ROUTE_PREFIX_BY_IDproxmox/docker/kubernetes/truenas/vmware/standalone前缀把当前 URL 归属到对应主 tab并借助primaryRouteMemory记住每个主 tab 最后访问的子路由AppLayout.tsx命令面板与快捷键filterPlatformNavigationShortcuts只对primaryPlatformNavigationIsVisible的平台注入快捷键路由不可见平台不会出现在命令面板候选里platformNavigationModel.ts。因此无论用户从桌面还是移动端进入、通过命令面板搜索还是敲快捷键第一个候选永远是按规范顺序排列的 provider 平台Agents 只在 estate 中确无 provider 证据时才会出现在主位。五、启动性能不再预热已退役的 Infrastructure / Workloads 图表缓存5.1 App Shell 路由预加载清单记录文档最后一条断言是App Shell 不再以通用认证副作用的方式预热已退役的 Infrastructure 或 Workloads 图表缓存平台优先启动保持路由模块热、数据轻route-module warm and>export const APP_SHELL_ROUTE_PRELOAD_PATHS [ACTIONS_PATH] as const;即 Shell 级通用预加载只包含 Actions 路径——不再包含 Infrastructure 或 Workloads 的图表模块。而各平台的预加载由ROUTE_PRELOADERS按需触发routePreload.ts每个预加载器都带matches(route)条件只有当用户实际导航到对应平台路由时才import(/pages/Proxmox)、import(/pages/Docker)等。这正是route-module warm平台路由模块在命中时快速就绪、data-light图表缓存不被无条件拉取的落地方式。5.2 useAppRuntimeState 不再 import / prewarm 图表缓存记录文档明确要求useAppRuntimeState不 import 也不预热 Infrastructure 或 Workloads 图表缓存。从 useAppRuntimeState.ts 的依赖与状态来看它只聚合会话级运行时状态资源、WebSocket、组织、许可、主题、告警激活、行动收件箱、AI 情报等见 useAppRuntimeState.ts其中资源状态仅保留connectedInfrastructure列表useAppRuntimeState.ts这类轻量派生数据而非拉取整张图表缓存实际资源/表格查询完全由被选中的平台页面在自己的数据加载周期中发起。架构测试也通过源码断言守护了这条边界expect(appSource).toContain(getDefaultWorkspaceRoute)见 App.architecture.test.ts。从源码结构可以推断这一设计把全局副作用式图表预热彻底移除落地页只承担导航职责数据获取下沉到平台页面自身从而显著降低认证首屏的资源下载与解析成本。六、旧表面兼容legacy Infrastructure 仅保持路由兼容记录文档强调legacy Infrastructure remains route-compatible rather than the default operational surface。这体现在两个方面路由兼容旧链接如/settings/infrastructure、/alerts 等历史入口依然可达getDefaultWorkspaceRoute在无可见平台且具备设置权限时仍然会指向/settings/infrastructure保证老用户书签与既有集成不失效不再作为默认面只要 estate 存在任何 provider 证据或 agent-only 证据根路由与登录交接就不再以 Infrastructure 为默认运营面而是按规范顺序解析到 provider 平台页。这与同目录下的姊妹记录 infrastructure-default-landing-dashboard-retirement-2026-04-29 所记录的Infrastructure 默认落地仪表盘退役是同一演进方向的两份证据。七、测试与验证架构测试如何守护 Provider-FirstProvider-First 落地页的行为被 App.architecture.test.ts 以架构级测试锁定核心用例包括场景期望结果agent docker-host truenas 混合 estategetDefaultWorkspaceRoute→/docker/overviewDocker 先于 TrueNASTrueNAS 证据存在、standalone 无证据不显示 standalone 页落地/truenas/overview仅 standaloneagent-only落地 standalone 工作区权威空快照 无设置权限全部可见性为 false落地/alerts权威空快照 有设置权限落地/settings/infrastructure无 facet 也无运行时状态保持 unresolved不产生跳转WebSocket 断线重连可见性与落地路由不抖动App.architecture.test.ts这些用例从排序正确性、Agents 不越位、空 estate 兜底、断线稳定性、权威性交接五个维度验证了 Provider-First 断言的每一项承诺是后续演进如新增平台时防止回归的防线。八、总结Provider-First 落地页的四个设计要点单一规范顺序PRIMARY_PLATFORM_NAV_IDS定义了 Proxmox → Docker → Kubernetes → TrueNAS → vSphere → standalone 的唯一权威顺序选择器selectFirstVisiblePrimaryPlatformNavigationId负责取第一个可见者证据驱动可见性平台可见性由资源证据经PRIMARY_PLATFORM_NAV_SCOPE_IDS映射推导agent-only 的 standalone 被严格限制避免 Machines 页喧宾夺主快速、一次性的登录交接getDefaultWorkspaceRouteresolvePlatformNavigationAdmission让 Shell 在收到首个认证资源或准入 facet 时即可完成重定向replace语义保证历史栈干净启动数据轻量App Shell 只预加载 Actions 路由模块不再预热已退役的 Infrastructure / Workloads 图表缓存资源查询交由被选中的平台页按需发起。对于需要扩展 Pulse 平台导航的开发者建议从 platformNavigationModel.ts 的三处常量PrimaryPlatformNavId、PRIMARY_PLATFORM_NAV_IDS、PRIMARY_PLATFORM_NAV_SCOPE_IDS入手并同步更新 App.architecture.test.ts 中的对应用例即可在不破坏现有落地语义的前提下安全演进。赞分享可观测性运维后端【免费下载链接】PulseReal-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with smart alerts and AI patrols that catch silent failures.项目地址https://gitcode.com/gh_mirrors/pulse27/Pulse点击查看免费下载相关推荐Pulse v6 基础设施默认落地页改造Dashboard 路由退役的架构决策与验证实践Pulse v6 基础设施默认落地页改造Dashboard 路由退役的架构决策与验证实践 本文基于仓库内发布控制记录 infrastructure defau可观测性运维后端Epic Stack认证路由登录注册页面Epic Stack认证路由登录注册页面 还在为复杂的用户认证系统头疼吗Epic Stack提供了一套完整的认证解决方案从登录、注册到密码重置全部开箱即后端前端开发工具认证鉴权Azure Data Studio 中的 GitHub 认证扩展Authentication Provider 机制与登录流程全解析Azure Data Studio 中的 GitHub 认证扩展Authentication Provider 机制与登录流程全解析 本篇技术指南围绕 Azu数据库客户端数据库桌面应用后端上一篇ComfyUI IPAdapter节点异常排查从现象到根源的完整诊断流程下一篇终极解决方案如何用VisualCppRedist AIO一键修复所有Windows软件依赖问题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
