import { MoonStar, PackageOpen, Pencil, ShieldCheck, Sparkles, Square, Terminal, UserRoundMinus, UserRoundPlus, WandSparkles } from "lucide-react"; import { type FormEvent, useCallback, useEffect, useMemo, useState } from "react"; import { platformApiClient } from "../api/client"; import type { ConfigDiffLineResponse, GamePluginResponse, JobResponse, ServerInstanceResponse, ServerMemberResponse, ServerMetricsResponse, ServerDeploymentResponse, ServerConfigDiffPreviewResponse, RunEndpointResponse } from "../api/types"; import { ConfirmDialog, UsageMeter } from "../components/OperationControls"; import { ServerManagementTerminalDrawer } from "../components/ServerManagementTerminalDrawer"; import { EmptyState, ErrorState, LoadingState, ResultBadge } from "../components/StateViews"; import type { PageComponentProps } from "../contracts/page"; import { canStartServer, canStopServer, runtimeObservationFreshness, serverMetadataFormFromInstance, type ServerMetadataFormState } from "../contracts/serverManagement"; import { serverDetailSections, serverIsOnline, type ConfigDiffView, type LlmSuggestionView, type ServerDetailSection } from "../contracts/workspace"; import { serverLifecycleCommandRequest, serverMetadataUpdateRequestFromForm } from "../schemas/serverManagement"; import { cx } from "../utils/classes"; import { stateLabel, statusClass } from "./ServersPage"; import { PluginPageHostPage } from "./PluginPageHostPage"; type LoadState = { status: "loading" } | { status: "error"; reason: string } | { status: "ready"; data: T }; const serverDetailRefreshMs = 5000; const serverMetricFreshMs = 30000; export function ServerDetailPage(props: PageComponentProps) { const { session, params, operations, onNavigate } = props; const serverId = params.serverId ?? ""; const [section, setSection] = useState("manage"); const [instance, setInstance] = useState>({ status: "loading" }); const [metrics, setMetrics] = useState(null); const [plugins, setPlugins] = useState([]); const [jobs, setJobs] = useState([]); const [runEndpoint, setRunEndpoint] = useState(); const [deployment, setDeployment] = useState>({ status: "loading" }); const [confirm, setConfirm] = useState Promise }>(null); const [confirmBusy, setConfirmBusy] = useState(false); const [terminalOpen, setTerminalOpen] = useState(false); const refresh = useCallback(async () => { if (!serverId) { setInstance({ status: "error", reason: "缺少服务器 ID" }); return; } setInstance({ status: "loading" }); try { const [detail, pluginResponse, jobResponse, deploymentResponse, endpointResponse] = await Promise.all([ platformApiClient.getServerInstance(serverId), platformApiClient.listGamePlugins(), platformApiClient.listJobs(serverId), platformApiClient .getServerDeployment(serverId) .then((data): LoadState => ({ status: "ready", data })) .catch((error): LoadState => ({ status: "error", reason: error instanceof Error ? error.message : "部署定义加载失败" })), platformApiClient.listRunEndpoints().catch(() => ({ items: [], count: 0 })) ]); setInstance({ status: "ready", data: detail }); setPlugins(pluginResponse.items); setJobs(jobResponse.items); setDeployment(deploymentResponse); setRunEndpoint(endpointResponse.items.find((endpoint) => endpoint.id === detail.runEndpointId)); } catch (error) { setInstance({ status: "error", reason: error instanceof Error ? error.message : "加载失败" }); setRunEndpoint(undefined); setDeployment({ status: "error", reason: "部署定义加载失败" }); } try { const metricsResponse = await platformApiClient.listServerMetrics(); setMetrics(metricsResponse.items.find((item) => item.serverInstanceId === serverId) ?? null); } catch { setMetrics(null); } }, [serverId]); useEffect(() => { void refresh(); }, [refresh]); const refreshOperationalState = useCallback(async () => { if (!serverId) return; try { const [detail, jobResponse, metricsResponse, endpointResponse] = await Promise.all([ platformApiClient.getServerInstance(serverId), platformApiClient.listJobs(serverId), platformApiClient.listServerMetrics(), platformApiClient.listRunEndpoints() ]); setInstance({ status: "ready", data: detail }); setJobs(jobResponse.items); setMetrics(metricsResponse.items.find((item) => item.serverInstanceId === serverId) ?? null); setRunEndpoint(endpointResponse.items.find((endpoint) => endpoint.id === detail.runEndpointId)); } catch { setMetrics(null); } }, [serverId]); useEffect(() => { const timer = window.setInterval(() => void refreshOperationalState(), serverDetailRefreshMs); return () => window.clearInterval(timer); }, [refreshOperationalState]); const canManageServers = session.capabilities.includes("servers.manage"); const readyPlugin = instance.status === "ready" ? plugins.find((plugin) => plugin.id === instance.data.pluginId) : undefined; const detailFreshness = instance.status === "ready" ? runtimeObservationFreshness(instance.data, runEndpoint) : "unverified"; const detailStateText = instance.status === "ready" && detailFreshness === "fresh" ? stateLabel(instance.data.state) : instance.status === "ready" ? `最后观测:${stateLabel(instance.data.state)}(Run 未验证)` : "未验证"; const detailSections = useMemo(() => serverDetailSectionEntries(readyPlugin), [readyPlugin]); const metricsWaiting = metrics?.source === "run-metrics-pending"; useEffect(() => { if (!params.routeKey || !readyPlugin?.pages.some((page) => page.key === params.routeKey)) return; setSection(`plugin:${params.routeKey}`); }, [params.routeKey, readyPlugin]); useEffect(() => { if (detailSections.some((entry) => entry.id === section)) return; setSection(detailSections[0]?.id ?? "manage"); }, [detailSections, section]); function requestLifecycle(current: ServerInstanceResponse, action: "start" | "stop") { setConfirm({ title: action === "start" ? "启动服务器" : "停止服务器", description: action === "start" ? `确认启动服务器 ${current.name}(${current.id})?` : `停止服务器 ${current.name}(${current.id})会断开所有在线玩家,确认继续?`, danger: action === "stop", run: async () => { const operationId = operations.begin({ intent: action === "start" ? "启动服务器" : "停止服务器", targetKind: "server", targetId: current.id, requester: session.displayName }); try { const result = action === "start" ? await platformApiClient.startServerInstance(current.id, serverLifecycleCommandRequest(current, "start")) : await platformApiClient.stopServerInstance(current.id, serverLifecycleCommandRequest(current, "stop")); operations.succeed(operationId, `任务 ${result.job.id}(${result.job.capability})已派发`, result.job); await refresh(); } catch (error) { operations.fail(operationId, error instanceof Error ? error.message : "操作失败", operationId); } } }); } if (!serverId) { return ( onNavigate("servers")} /> ); } return (
{instance.status === "loading" && } {instance.status === "error" && ( void refresh()} /> )} {instance.status !== "ready" && ( )} {instance.status === "ready" && ( <>

{instance.data.name}

{instance.data.id} · 插件 {instance.data.pluginId}@{instance.data.pluginVersion} · Run 心跳 {runEndpoint ? "已自动附着" : "等待上报"}
{detailStateText}
{pluginPageKeyFromSection(section) && readyPlugin && } {section === "manage" && } {section === "manage" && ( setInstance({ status: "ready", data: next })} /> )} {section === "manage" && setInstance({ status: "ready", data: next })} />} {section === "llm" && } setTerminalOpen(false)} /> )} setConfirm(null)} onConfirm={() => { if (!confirm) { return; } setConfirmBusy(true); void confirm.run().finally(() => { setConfirmBusy(false); setConfirm(null); }); }} />
); } function serverDetailSectionEntries(plugin?: GamePluginResponse): Array<{ id: ServerDetailSection; label: string }> { const pluginPages = (plugin?.pages ?? []).map((page) => ({ id: `plugin:${page.key}` as ServerDetailSection, label: page.title })); return [...pluginPages, ...serverDetailSections]; } function pluginPageKeyFromSection(section: ServerDetailSection): string | null { return section.startsWith("plugin:") ? section.slice("plugin:".length) : null; } interface PluginPageSectionProps { pageProps: PageComponentProps; serverId: string; plugin: GamePluginResponse; routeKey: string; } function PluginPageSection({ pageProps, serverId, plugin, routeKey }: PluginPageSectionProps) { const params = useMemo(() => ({ ...pageProps.params, pluginId: plugin.id, routeKey, serverId }), [pageProps.params.pluginId, pageProps.params.routeKey, pageProps.params.serverId, plugin.id, routeKey, serverId]); return ; } interface ServerMetadataSectionProps { instance: ServerInstanceResponse; session: PageComponentProps["session"]; operations: PageComponentProps["operations"]; onChanged: (instance: ServerInstanceResponse) => void; } function ServerMetadataSection({ instance, session, operations, onChanged }: ServerMetadataSectionProps) { const [draft, setDraft] = useState(() => serverMetadataFormFromInstance(instance)); const [result, setResult] = useState<{ status: "succeeded" | "failed" | "pending"; label: string } | null>(null); useEffect(() => { setDraft(serverMetadataFormFromInstance(instance)); }, [instance.id, instance.name]); async function saveMetadata(event: FormEvent) { event.preventDefault(); const operationId = operations.begin({ intent: "更新服务器信息", targetKind: "server", targetId: instance.id, requester: session.displayName }); setResult({ status: "pending", label: "正在保存服务器信息" }); try { const updated = await platformApiClient.updateServerInstance(instance.id, serverMetadataUpdateRequestFromForm(draft)); onChanged(updated); operations.succeed(operationId, `服务器信息已更新:${updated.id}`); setResult({ status: "succeeded", label: `已更新 ${updated.name}` }); } catch (error) { operations.fail(operationId, error instanceof Error ? error.message : "服务器信息更新失败"); setResult({ status: "failed", label: error instanceof Error ? error.message : "服务器信息更新失败" }); } } return (

基本信息

{result && }
void saveMetadata(event)}>
); } interface ServerDeploymentSectionProps { instance: ServerInstanceResponse; deployment: LoadState; } function ServerDeploymentSection({ instance, deployment }: ServerDeploymentSectionProps) { if (deployment.status === "loading") return ; if (deployment.status === "error") return ; const view = deployment.data; const projection = view.projection; const isScumTemplate = (instance.pluginId === "game.scum" && (view.mode === "guided-install" || view.mode === "existing-server")) || projection?.templateKey?.startsWith("scum-"); return

部署定义

{view.mode || "未配置"} · 修订 {view.revision}

服务器目录是主目录;执行目录只用于高级自定义启动,留空时继承服务器目录。路径和命令均为受保护输入,不会回显。

服务器目录{view.serverRootConfigured ? "已配置" : "未配置"}
高级执行目录{view.workingDirectoryConfigured ? "已配置" : "使用服务器目录"}
启动设置{view.startCommandConfigured ? "已配置" : view.mode === "custom-command" ? "未配置" : "插件引导"}
{view.latestDispatch &&
最近 Run 调度{view.latestDispatch.deploymentDefinitionIncluded ? `部署定义已随任务发送 · r${view.latestDispatch.deploymentRevision} · ${view.latestDispatch.jobState}` : "未携带部署定义"}
}{view.latestDispatch?.runConfirmed &&
Run 执行确认已按 r{view.latestDispatch.deploymentRevision} 确认执行
}
{isScumTemplate &&
SCUM 部署模板{projection?.templateVersion ? `${projection.templateKey ?? "已选择"} · v${projection.templateVersion}` : "等待 Run 预检"}
预检 / 扫描{deploymentProjectionLabel(projection?.preflightState)} / {deploymentProjectionLabel(projection?.discoveryState)}
配置映射 / 健康验证{deploymentProjectionLabel(projection?.mappingState)} / {deploymentProjectionLabel(projection?.verificationState)}
{projection?.failureCode &&
失败原因{projection.failureCode}
}
}
; } function deploymentProjectionLabel(value?: string): string { switch (value) { case "queued": return "排队中"; case "running": return "执行中"; case "passed": return "已通过"; case "applied": return "已写入"; case "unchanged": return "未变化"; case "failed": return "失败"; case "skipped": return "已跳过"; default: return "待返回"; } } function deploymentProgressLabel(progress: JobResponse["progress"]): string { switch (progress.phase) { case "queued": return "任务已排队,等待 Run 领取"; case "claimed": return "Run 已领取任务"; case "preflight": return "正在执行本机预检"; case "install": return "正在安装服务器"; case "configure": return "正在写入游戏配置"; case "start": return "正在启动服务器"; case "health": return "正在进行健康检查"; default: return "部署任务已提交"; } } interface ServerAdministratorsSectionProps { instance: ServerInstanceResponse; session: PageComponentProps["session"]; onChanged: (instance: ServerInstanceResponse) => void; } function ServerAdministratorsSection({ instance, session, onChanged }: ServerAdministratorsSectionProps) { const [candidates, setCandidates] = useState>({ status: "loading" }); const [selectedUserId, setSelectedUserId] = useState(""); const [busyUserId, setBusyUserId] = useState(null); const [result, setResult] = useState<{ status: "succeeded" | "failed"; label: string } | null>(null); const isOwner = instance.ownerUserId === session.id; const refreshCandidates = useCallback(async () => { if (!isOwner) { setCandidates({ status: "ready", data: [] }); return; } setCandidates({ status: "loading" }); try { const response = await platformApiClient.listServerAdministratorCandidates(instance.id); setCandidates({ status: "ready", data: response.items }); setSelectedUserId((current) => (response.items.some((user) => user.id === current) ? current : response.items[0]?.id ?? "")); } catch (error) { setCandidates({ status: "error", reason: error instanceof Error ? error.message : "加载候选管理员失败" }); } }, [instance.id, isOwner]); useEffect(() => { void refreshCandidates(); }, [refreshCandidates]); async function addAdministrator(event: FormEvent) { event.preventDefault(); if (!selectedUserId) { return; } setBusyUserId(selectedUserId); setResult(null); try { const next = await platformApiClient.addServerAdministrator(instance.id, { userId: selectedUserId }); onChanged(next); setResult({ status: "succeeded", label: "已添加服务器管理员" }); await refreshCandidates(); } catch (error) { setResult({ status: "failed", label: error instanceof Error ? error.message : "添加管理员失败" }); } finally { setBusyUserId(null); } } async function removeAdministrator(userId: string) { setBusyUserId(userId); setResult(null); try { const next = await platformApiClient.removeServerAdministrator(instance.id, userId); onChanged(next); setResult({ status: "succeeded", label: "已移除服务器管理员" }); await refreshCandidates(); } catch (error) { setResult({ status: "failed", label: error instanceof Error ? error.message : "移除管理员失败" }); } finally { setBusyUserId(null); } } return (

管理成员

{isOwner ? "服主可邀请/移除管理员" : "仅服主可调整成员"}
{result && (
)}
服主:{instance.ownerUserId || "未绑定"} 服务器管理员:{instance.adminUserIds.length > 0 ? instance.adminUserIds.join(" / ") : "暂无"}
{isOwner && ( <>
void addAdministrator(event)} aria-label="邀请服务器管理员">
{candidates.status === "loading" && } {candidates.status === "error" && ( void refreshCandidates()} compact /> )} {instance.adminUserIds.length > 0 && (
{instance.adminUserIds.map((userId) => (
{userId} 服务器管理员
))}
)} )}
); } function HeaderStat({ label, value }: { label: string; value: string }) { return ( {label} {value} ); } function metricFreshnessLabel(metrics: ServerMetricsResponse | null): string { if (!metrics || metrics.source === "run-metrics-pending") return "等待上报"; const collectedAt = new Date(metrics.collectedAt).getTime(); if (Number.isFinite(collectedAt) && Date.now() - collectedAt > serverMetricFreshMs) return "指标过期"; return new Date(metrics.collectedAt).toLocaleTimeString(); } interface LlmSectionProps { serverId: string; instance: ServerInstanceResponse; session: PageComponentProps["session"]; operations: PageComponentProps["operations"]; } function LlmSection({ serverId, instance, session, operations }: LlmSectionProps) { const [prompt, setPrompt] = useState(""); const [suggestion, setSuggestion] = useState(null); const [confirming, setConfirming] = useState(false); const [busy, setBusy] = useState(false); const [approvalBusy, setApprovalBusy] = useState(false); const [suggestionError, setSuggestionError] = useState(""); async function requestSuggestion(event: FormEvent) { event.preventDefault(); if (!prompt.trim()) { return; } setBusy(true); setSuggestion(null); setSuggestionError(""); try { const response = await platformApiClient.invokeAI({ requestId: `web:ai.config:${serverId}:${Date.now()}`, serverInstanceId: serverId, purpose: "config.suggest", prompt: prompt.trim() }); if (response.status !== "ok") { throw new Error(response.error?.message ?? "AI 提供商未返回可用建议"); } const recommendation = response.configRecommendation; setSuggestion({ serverInstanceId: serverId, source: "api", recommendation: response.recommendation ?? "Platform 已返回配置建议。", diffId: recommendation?.diffId, expiresAt: recommendation?.expiresAt, diffSummary: recommendation?.diffSummary }); } catch (caught) { setSuggestionError(caught instanceof Error ? caught.message : "AI 建议请求失败"); } finally { setBusy(false); } } async function applySuggestion() { if (!suggestion?.diffId || approvalBusy) { return; } const operationId = operations.begin({ intent: "应用 AI 配置建议", targetKind: "llm", targetId: serverId, requester: session.displayName }); setApprovalBusy(true); try { const approved = await platformApiClient.approveAIConfigDiff(suggestion.diffId, `web:ai.config.approve:${suggestion.diffId}`); const job = approved.dispatch.job; operations.succeed(operationId, `AI 建议已确认,写入任务 ${job.id} 已派发`, job); setSuggestion(null); setConfirming(false); } catch (error) { operations.fail(operationId, error instanceof Error ? error.message : "写入任务派发失败", operationId); setConfirming(false); } finally { setApprovalBusy(false); } } const llmOperation = operations.operations.find((operation) => operation.intent === "应用 AI 配置建议" && operation.targetId === serverId); return (

AI 配置助手

建议仅作用于 {serverId}

AI 建议会先生成推荐说明和配置差异,不会自动写入。只有你确认差异后,平台才会派发写入任务。前端不会接触任何 AI 提供商密钥。

{llmOperation && (
)} {suggestionError && setSuggestionError("")} compact />}
void requestSuggestion(event)}>