-
下载并固定文件
-
将单文件保存到用户可写目录，不要从浏览器临时目录长期运行。
+ 将单文件保存到 owning YAML 允许的用户可写目录，不要从浏览器临时目录长期运行。
- 查看文件建议
- mkdir C:\HWLAB
- move .\{{ metadata?.artifact.fileName || "hwlab-node.py" }} C:\HWLAB\hwlab-node.py
+ 查看配置边界
+ 实际运行目录、交互用户和工作区根由 owning YAML 与受控节点配置拥有，网页不猜测目标路径。
-
校验 SHA-256
将本机结果与页面上方发布 SHA 完整比对，不一致时停止运行并重新下载。
-
- 查看 PowerShell 命令
- Get-FileHash C:\HWLAB\hwlab-node.py -Algorithm SHA256
-
+ 查看校验要求
使用 Windows 本机文件哈希工具校验实际下载文件，文件名以发布元数据为准。
-
在交互用户会话启动
-
使用本机 Python 3 启动图形节点，保持窗口或托盘程序运行。
-
- 查看启动命令
- py -3 C:\HWLAB\hwlab-node.py
- python C:\HWLAB\hwlab-node.py
-
+ 使用 owning YAML 选择的 Windows 交互用户与原生 Python 启动图形节点，保持窗口或托盘程序运行。
+ 查看启动边界
不得使用 WSL Python、SSH 辅助解释器、Bun 运行器或非交互 Windows 服务冒充完成态。
-
选择 Node 并观察 readiness
diff --git a/web/hwlab-cloud-web/src/components/hwpod/HwpodReadinessRail.vue b/web/hwlab-cloud-web/src/components/hwpod/HwpodReadinessRail.vue
index b96a5515..a173bf24 100644
--- a/web/hwlab-cloud-web/src/components/hwpod/HwpodReadinessRail.vue
+++ b/web/hwlab-cloud-web/src/components/hwpod/HwpodReadinessRail.vue
@@ -17,6 +17,7 @@ defineProps<{ stages: HwpodNodeReadinessStage[] }>();
{{ stage.label }}
{{ stage.authority }}
{{ stage.blocker.summary }}
+ 下一步{{ stage.nextAction.label }}{{ stage.nextAction.entrypoint }}
{{ stage.status === 'ready' ? '已就绪' : stage.status === 'blocked' ? '阻塞' : '待观测' }}
@@ -33,6 +34,9 @@ li[data-status="blocked"] .stage-index { border-color: #b46b4b; background: #fff
.readiness-rail strong { display: block; color: #1d302c; font-size: .86rem; }
.readiness-rail small { color: #71807b; font: .67rem/1.4 ui-monospace, SFMono-Regular, Consolas, monospace; }
.readiness-rail p { margin: 4px 0 0; color: #79503b; font-size: .75rem; line-height: 1.4; }
+.stage-action { display: grid; gap: 2px; color: #31564d !important; }
+.stage-action strong { font-size: .7rem; }
+.stage-action code { color: #687872; font-size: .66rem; overflow-wrap: anywhere; }
.stage-status { margin-top: 4px; color: #5e6f69; font-size: .7rem; font-weight: 800; }
li[data-status="ready"] .stage-status { color: #2c7567; }
li[data-status="blocked"] .stage-status { color: #9b4f2d; }
diff --git a/web/hwlab-cloud-web/src/stores/hwpod.ts b/web/hwlab-cloud-web/src/stores/hwpod.ts
index d0b3cc92..9375c8bb 100644
--- a/web/hwlab-cloud-web/src/stores/hwpod.ts
+++ b/web/hwlab-cloud-web/src/stores/hwpod.ts
@@ -26,6 +26,7 @@ export const useHwpodStore = defineStore("hwpod", () => {
const consoleLoading = ref(false);
const consoleError = ref(null);
const consoleStale = ref(false);
+ let consoleRequestId = 0;
async function refresh(): Promise {
loading.value = true;
@@ -38,12 +39,14 @@ export const useHwpodStore = defineStore("hwpod", () => {
}
async function refreshConsole(resource: "device" | "node" | "onboarding", query: TopologyQuery = {}): Promise {
+ const requestId = ++consoleRequestId;
consoleLoading.value = true;
consoleError.value = null;
consoleStale.value = false;
try {
if (resource === "device") {
const result = await hwpodAPI.devices(query);
+ if (requestId !== consoleRequestId) return;
if (result.ok && result.data) deviceTopology.value = result.data;
else {
consoleError.value = result.error ?? "HWPOD 设备拓扑不可用";
@@ -51,6 +54,7 @@ export const useHwpodStore = defineStore("hwpod", () => {
}
} else if (resource === "node") {
const result = await hwpodAPI.nodes(query);
+ if (requestId !== consoleRequestId) return;
if (result.ok && result.data) nodeTopology.value = result.data;
else {
consoleError.value = result.error ?? "HWPOD Node 拓扑不可用";
@@ -58,6 +62,7 @@ export const useHwpodStore = defineStore("hwpod", () => {
}
} else {
const [nodesResult, updateResult] = await Promise.all([hwpodAPI.nodes(query), hwpodAPI.nodeUpdate()]);
+ if (requestId !== consoleRequestId) return;
if (nodesResult.ok && nodesResult.data) nodeTopology.value = nodesResult.data;
if (updateResult.ok && updateResult.data) nodeUpdate.value = updateResult.data;
if (!nodesResult.ok || !updateResult.ok) {
@@ -66,10 +71,11 @@ export const useHwpodStore = defineStore("hwpod", () => {
}
}
} catch (cause) {
+ if (requestId !== consoleRequestId) return;
consoleError.value = cause instanceof Error ? cause.message : "HWPOD 控制台刷新失败";
consoleStale.value = resource === "device" ? Boolean(deviceTopology.value) : resource === "node" ? Boolean(nodeTopology.value) : Boolean(nodeTopology.value || nodeUpdate.value);
} finally {
- consoleLoading.value = false;
+ if (requestId === consoleRequestId) consoleLoading.value = false;
}
}
diff --git a/web/hwlab-cloud-web/src/types/index.ts b/web/hwlab-cloud-web/src/types/index.ts
index 2389d28d..0df701ea 100644
--- a/web/hwlab-cloud-web/src/types/index.ts
+++ b/web/hwlab-cloud-web/src/types/index.ts
@@ -454,6 +454,7 @@ export interface HwpodNodeReadinessStage {
status: HwpodReadinessStatus;
authority: string;
blocker: HwpodBlocker | null;
+ nextAction: { label: string; entrypoint: string } | null;
}
export interface HwpodNodeTopologyItem {
@@ -511,7 +512,7 @@ export interface HwlabNodeUpdateMetadata {
releaseNotes: string[];
releaseNotesUrl: string | null;
installConditions: Array<{ id: string; label: string; required: boolean }>;
- readinessStages: Array<{ id: string; label: string; authority: string }>;
+ readinessStages: Array<{ id: string; label: string; authority: string; nextAction: { label: string; entrypoint: string } }>;
observedAt: string;
}
export interface CaseRunCaseSummary { caseId: string; title?: string; mode?: string; available?: boolean; hwpodSpec?: string; subject?: Record | null; expected?: Record | null; runtime?: Record | null; [key: string]: unknown }
diff --git a/web/hwlab-cloud-web/src/views/admin/HwpodGroupsView.vue b/web/hwlab-cloud-web/src/views/admin/HwpodGroupsView.vue
index f43b2466..4800425e 100644
--- a/web/hwlab-cloud-web/src/views/admin/HwpodGroupsView.vue
+++ b/web/hwlab-cloud-web/src/views/admin/HwpodGroupsView.vue
@@ -34,7 +34,7 @@ const tab = computed(() => {
return value === "nodes" || value === "onboarding" ? value : "devices";
});
const pathEntityId = computed(() => tab.value === "devices" ? text(route.params.hwpodId) : text(route.params.nodeId));
-const effectiveQuery = computed(() => viewState.q.value || pathEntityId.value);
+const effectiveQuery = computed(() => pathEntityId.value || viewState.q.value);
const effectiveCursor = computed(() => pathEntityId.value ? "" : viewState.cursor.value);
const view = viewState.view;
const density = viewState.density;
@@ -51,7 +51,7 @@ const onboardingStages = computed(() => selectedNode.
const artifact = computed(() => hwpod.nodeUpdate?.artifact ?? null);
const sortField = computed(() => viewState.sort.value.replace(/^-/, "") || "name");
const sortDirection = computed<"asc" | "desc">(() => viewState.sort.value.startsWith("-") ? "desc" : "asc");
-const hasContent = computed(() => tab.value === "devices" ? devices.value.length > 0 : tab.value === "nodes" ? nodes.value.length > 0 : Boolean(hwpod.nodeUpdate));
+const hasContent = computed(() => tab.value === "devices" ? devices.value.length > 0 : tab.value === "nodes" ? nodes.value.length > 0 : Boolean(hwpod.nodeUpdate) || nodes.value.length > 0);
const boundaryState = computed(() => {
if (hwpod.consoleError) return hwpod.consoleStale && hasContent.value ? "partial" as const : "error" as const;
if (hwpod.consoleLoading) return hasContent.value ? "refreshing" as const : "initial-loading" as const;
@@ -99,6 +99,10 @@ function goTab(next: ConsoleTab): void {
const query = collectionQuery();
delete query.cursor;
delete query.filter;
+ if (next === "onboarding") {
+ delete query.q;
+ delete query.sort;
+ }
void router.push({ path: `/hwpods/${next}`, query });
}