import { Download, 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, ArtifactResponse, BackupResponse, GamePluginResponse, JobResponse, LogStreamResponse, ServerConfigDiffPreviewResponse, ServerConfigResponse, ServerInstanceResponse, ServerMemberResponse, ServerMetricsResponse, ServerDeploymentResponse, MetricSampleResponse, RemoteAdapterDeclarationResponse, RunEndpointResponse } from "../api/types"; import { ConfirmDialog, DiffView, UsageMeter } from "../components/OperationControls"; import { ProductionGovernancePanel } from "../components/ProductionGovernancePanel"; import { SourceRCONCommandPanel } from "../components/SourceRCONCommandPanel"; import { DiagnosticSummary, EmptyState, ErrorState, LoadingState, ResultBadge } from "../components/StateViews"; import type { PageComponentProps } from "../contracts/page"; import { jobCapabilityLabel } from "../contracts/jobPresentation"; import { canStartServer, canStopServer, runtimeObservationFreshness, serverMetadataFormFromInstance, type ServerMetadataFormState } from "../contracts/serverManagement"; import { ServerManagementTerminalDrawer } from "../components/ServerLiveOperations"; import { serverDetailSections, serverIsOnline, isPlatformAdmin, type ConfigDiffView, type LlmSuggestionView, type ServerDetailSection } from "../contracts/workspace"; import { serverLifecycleCommandRequest, serverMetadataUpdateRequestFromForm } from "../schemas/serverManagement"; import { diffHasChanges } from "../utils/diff"; import { downloadArtifactReference, safeArtifactError, safeArtifactFilename } from "../utils/artifactTransfer"; import { cx } from "../utils/classes"; import { stateLabel, statusClass } from "./ServersPage"; import { PluginPageHostPage } from "./PluginPageHostPage"; import { appendLiveLogEntries, entryFromServerLogEvent, mergeLogStreams, parseLogStreamEvent, parseServerLogEvent, streamFromServerLogEvent, type LiveLogEntry } from "../utils/logEvents"; type LoadState = { status: "loading" } | { status: "error"; reason: string } | { status: "ready"; data: T }; const defaultConfigKey = "server.properties"; 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("logs"); const [instance, setInstance] = useState>({ status: "loading" }); const [metrics, setMetrics] = useState(null); const [plugins, setPlugins] = useState([]); const [jobs, setJobs] = useState([]); const [artifacts, setArtifacts] = useState([]); const [metricHistory, setMetricHistory] = useState([]); const [backups, setBackups] = useState([]); const [remoteAdapters, setRemoteAdapters] = useState([]); const [runEndpoint, setRunEndpoint] = useState(); const [deployment, setDeployment] = useState>({ status: "loading" }); const [terminalOpen, setTerminalOpen] = useState(false); const [confirm, setConfirm] = useState Promise }>(null); const [confirmBusy, setConfirmBusy] = useState(false); const refresh = useCallback(async () => { if (!serverId) { setInstance({ status: "error", reason: "缺少服务器 ID" }); return; } setInstance({ status: "loading" }); try { const [detail, pluginResponse, jobResponse, deploymentResponse, metricHistoryResponse, backupResponse, adapterResponse, 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.listMetricHistory(serverId).catch(() => ({ items: [], count: 0 })), platformApiClient.listBackups(serverId).catch(() => ({ items: [], count: 0 })), platformApiClient.listRemoteAdapters(serverId).catch(() => ({ items: [], count: 0 })), platformApiClient.listRunEndpoints().catch(() => ({ items: [], count: 0 })) ]); setInstance({ status: "ready", data: detail }); setPlugins(pluginResponse.items); setJobs(jobResponse.items); setDeployment(deploymentResponse); setMetricHistory(metricHistoryResponse.items); setBackups(backupResponse.items); setRemoteAdapters(adapterResponse.items); setRunEndpoint(endpointResponse.items.find((endpoint) => endpoint.id === detail.runEndpointId)); const artifactLists = await Promise.all( jobResponse.items.slice(0, 20).map((job) => platformApiClient .listArtifacts({ ownerKind: "job", ownerId: job.id, state: "available" }) .then((response) => response.items) .catch(() => [] as ArtifactResponse[]) ) ); setArtifacts(uniqueArtifacts(artifactLists.flat())); } catch (error) { setInstance({ status: "error", reason: error instanceof Error ? error.message : "加载失败" }); setArtifacts([]); setRunEndpoint(undefined); setDeployment({ status: "error", reason: "部署定义加载失败" }); setMetricHistory([]); setBackups([]); setRemoteAdapters([]); } 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 serverOperations = useMemo( () => operations.operations.filter((operation) => operation.targetId === serverId || operation.targetId.startsWith(`${serverId}:`)), [operations.operations, serverId] ); 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]); 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 ?? "logs"); }, [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} · 节点 {instance.data.runEndpointId}
{detailStateText}
{section === "logs" && } {section === "terminal" && } {pluginPageKeyFromSection(section) && readyPlugin && } {section === "config" && } {section === "config" && ( setInstance({ status: "ready", data: next })} /> )} {section === "config" && setInstance({ status: "ready", data: next })} />} {section === "config" && } {section === "llm" && } {section === "history" && } setTerminalOpen(false)} /> )} setConfirm(null)} onConfirm={() => { if (!confirm) { return; } setConfirmBusy(true); void confirm.run().finally(() => { setConfirmBusy(false); setConfirm(null); }); }} />
); } function uniqueArtifacts(artifacts: ArtifactResponse[]): ArtifactResponse[] { const byID = new Map(); for (const artifact of artifacts) { byID.set(artifact.id, artifact); } return [...byID.values()]; } 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 LogsSectionProps { serverId: string; } interface LogFilterState { level: string; keyword: string; source: string; sinceMinutes: string; } function LogsSection({ serverId }: LogsSectionProps) { const [streams, setStreams] = useState>({ status: "loading" }); const [entries, setEntries] = useState([]); const [filter, setFilter] = useState({ level: "all", keyword: "", source: "all", sinceMinutes: "all" }); const [selected, setSelected] = useState(null); const [eventSourceKey, setEventSourceKey] = useState(0); const refresh = useCallback(() => setEventSourceKey((current) => current + 1), []); useEffect(() => { setStreams({ status: "loading" }); setEntries([]); setSelected(null); let ready = false; const events = platformApiClient.openServerLogEvents(serverId, { historyLimit: 200 }); events.addEventListener("stream", (event) => { const stream = parseLogStreamEvent(event); if (!stream) return; ready = true; setStreams((current) => ({ status: "ready", data: mergeLogStreams(current.status === "ready" ? current.data : [], stream) })); }); events.addEventListener("ready", () => { ready = true; setStreams((current) => current.status === "ready" ? current : { status: "ready", data: [] }); }); events.addEventListener("log", (event) => { const payload = parseServerLogEvent(event); if (!payload) return; ready = true; setStreams((current) => ({ status: "ready", data: mergeLogStreams(current.status === "ready" ? current.data : [], streamFromServerLogEvent(payload)) })); setEntries((current) => appendLiveLogEntries(current, [entryFromServerLogEvent(payload)], 1000)); }); events.onerror = () => { if (!ready) setStreams({ status: "error", reason: "实时日志推送连接失败" }); }; return () => events.close(); }, [eventSourceKey, serverId]); const sources = useMemo(() => [...new Set(entries.map((entry) => entry.source))], [entries]); const visible = useMemo(() => { const keyword = filter.keyword.trim().toLowerCase(); const sinceMs = filter.sinceMinutes === "all" ? null : Date.now() - Number(filter.sinceMinutes) * 60_000; return entries.filter((entry) => { if (filter.level !== "all" && (entry.level ?? "info").toLowerCase() !== filter.level) { return false; } if (filter.source !== "all" && entry.source !== filter.source) { return false; } if (keyword && !entry.line.toLowerCase().includes(keyword)) { return false; } if (sinceMs !== null && new Date(entry.timestamp).getTime() < sinceMs) { return false; } return true; }).sort(compareLogEntriesDesc); }, [entries, filter]); return (

日志

setFilter((current) => ({ ...current, keyword: event.target.value }))} />
{streams.status === "loading" && } {streams.status === "error" && } {streams.status === "ready" && entries.length === 0 && ( )} {streams.status === "ready" && entries.length > 0 && visible.length === 0 && ( )} {visible.length > 0 && (
{visible.map((entry) => ( ))}
)} {selected && (
setSelected(null)}>
event.stopPropagation()}>

日志详情

时间
{new Date(selected.timestamp).toLocaleString()}
级别
{(selected.level ?? "info").toUpperCase()}
来源
{selected.source}
序号
{selected.seq}
内容
{selected.line}
{selected.fields && Object.keys(selected.fields).length > 0 && (
字段
{Object.entries(selected.fields) .map(([key, value]) => `${key}=${value}`) .join(" ")}
)}
)}
); } function levelClass(level?: string): string { const normalized = (level ?? "info").toLowerCase(); if (normalized === "error" || normalized === "fatal") { return "log-level-error"; } if (normalized === "warn" || normalized === "warning") { return "log-level-warn"; } return "log-level-info"; } function compareLogEntriesDesc(a: LiveLogEntry, b: LiveLogEntry): number { const time = (Date.parse(b.timestamp) || 0) - (Date.parse(a.timestamp) || 0); if (time !== 0) return time; return b.seq - a.seq; } interface ConfigSectionProps { serverId: string; instance: ServerInstanceResponse; session: PageComponentProps["session"]; operations: PageComponentProps["operations"]; } function ConfigSection({ serverId, instance, session, operations }: ConfigSectionProps) { const [config, setConfig] = useState>({ status: "loading" }); const [draft, setDraft] = useState(""); const [diff, setDiff] = useState(null); const [previewBusy, setPreviewBusy] = useState(false); const [previewError, setPreviewError] = useState(null); const refresh = useCallback(async () => { setConfig({ status: "loading" }); try { const response: ServerConfigResponse = await platformApiClient.getServerConfig(serverId); setConfig({ status: "ready", data: { content: response.content, source: "api" } }); setDraft(response.content); } catch (error) { setConfig({ status: "error", reason: error instanceof Error ? error.message : "配置读取接口不可用" }); setDraft(""); } }, [serverId]); useEffect(() => { void refresh(); }, [refresh]); async function prepareDiff(event: FormEvent) { event.preventDefault(); if (config.status !== "ready") { return; } setPreviewBusy(true); setPreviewError(null); try { const preview = await platformApiClient.previewServerConfigDiff(serverId, { expectedConfigVersion: instance.configVersion, expectedChecksum: instance.configChecksum, key: defaultConfigKey, proposedContent: draft }); setDiff(configDiffViewFromPreview(preview)); } catch (error) { setPreviewError(error instanceof Error ? error.message : "配置差异预览失败"); } finally { setPreviewBusy(false); } } async function submitDiff() { if (!diff || config.status !== "ready") { return; } const operationId = operations.begin({ intent: "写入配置", targetKind: "config", targetId: serverId, requester: session.displayName }); try { const dispatch = await platformApiClient.approveServerConfigWrite(serverId, { expectedConfigVersion: diff.configVersion ?? instance.configVersion, expectedChecksum: diff.checksum ?? instance.configChecksum, key: diff.key ?? defaultConfigKey, proposedContent: diff.nextContent, proposedContentInputRef: diff.proposedContentInputRef, idempotencyKey: `web:config.write:${serverId}:${Date.now()}` }); const job = dispatch.job; operations.succeed(operationId, `配置写入任务 ${job.id} 已派发`, job); setDiff(null); } catch (error) { operations.fail(operationId, error instanceof Error ? error.message : "配置写入任务派发失败", operationId); } } const writeOperation = operations.operations.find((operation) => operation.intent === "写入配置" && operation.targetId === serverId); return (

配置

{config.status === "ready" && 配置版本 v{instance.configVersion}{instance.configChecksum ? ` · ${instance.configChecksum.slice(0, 18)}` : ""}}
{writeOperation && (
)} {config.status === "loading" && } {config.status === "error" && void refresh()} compact />} {previewError && } {config.status === "ready" && (
void prepareDiff(event)}>