feat: redesign server deployment workflow

platform_web/pages/ConsolePages.test.tsx

@@ -9,6 +9,7 @@ import { ServerDetailPage } from "./ServerDetailPage";
 import { ServersPage } from "./ServersPage";
 import { UsersPage } from "./UsersPage";
 import runtimeTaskProgressSource from "../components/RuntimeTaskProgress.tsx?raw";
+import serverDeploymentWorkflowSource from "../components/ServerDeploymentWorkflow.tsx?raw";
 import serversPageSource from "./ServersPage.tsx?raw";
 import serverDetailPageSource from "./ServerDetailPage.tsx?raw";
 import type { PageComponentProps } from "../contracts/page";
@@ -167,21 +168,24 @@ describe("first-party console pages", () => {
     expect(serversPageSource).toContain("旧 run 会话已失效");
   });
 
-  it("submits declared runtime profiles and logical bindings from the create workflow", () => {
-    expect(serversPageSource).toContain("<ManagementDialog");
-    expect(serversPageSource).toContain('className="provider-form dialog-form"');
-    expect(serversPageSource).toContain('name="name"');
-    expect(serversPageSource).toContain('name="profileKey"');
-    expect(serversPageSource).toContain("runtimeBindingFields");
-    expect(serversPageSource).toContain("createProfileUnavailable");
-    expect(serversPageSource).toContain("当前插件没有声明运行配置");
-    expect(serversPageSource).toContain("updateBinding(field.key");
-    expect(serversPageSource).toContain('type={field.sensitive ? "password" : "text"}');
-    expect(serversPageSource).toContain("serverCreateRequestFromForm(form)");
-    expect(serversPageSource).not.toContain('name="id"');
-    expect(serversPageSource).not.toContain("实例 ID");
+  it("uses a staged deployment workflow for create and edit without exposing protected inputs", () => {
+    expect(serversPageSource).toContain("<ServerDeploymentWorkflow");
+    expect(serversPageSource).toContain("openEditDeployment");
+    expect(serversPageSource).toContain("编辑部署");
+    expect(serverDetailPageSource).toContain("<ServerDeploymentWorkflow");
+    expect(serverDeploymentWorkflowSource).toContain("选择目标");
+    expect(serverDeploymentWorkflowSource).toContain("部署方式");
+    expect(serverDeploymentWorkflowSource).toContain("相关配置");
+    expect(serverDeploymentWorkflowSource).toContain("仅保存为草稿");
+    expect(serverDeploymentWorkflowSource).toContain("执行目录（可选）");
+    expect(serverDeploymentWorkflowSource).toContain("默认使用服务器目录");
+    expect(serverDeploymentWorkflowSource).toContain("运行连接设置");
+    expect(serverDeploymentWorkflowSource).toContain('type={field.sensitive ? "password" : "text"}');
+    expect(serversPageSource).toContain("serverCreateRequestFromForm(nextForm)");
+    expect(serverDeploymentWorkflowSource).not.toContain('name="id"');
+    expect(serverDeploymentWorkflowSource).not.toContain("实例 ID");
     for (const forbidden of ["secret://", "/Users/", "/var/run/", "unix://", "tcp://"]) {
-      expect(serversPageSource).not.toContain(forbidden);
+      expect(serverDeploymentWorkflowSource).not.toContain(forbidden);
     }
   });
 

platform_web/pages/ServerDetailPage.tsx

@@ -28,6 +28,7 @@ import type {
   RemoteAdapterDeclarationResponse
 } from "../api/types";
 import { ConfirmDialog, DiffView, UsageMeter } from "../components/OperationControls";
+import { ServerDeploymentWorkflow } from "../components/ServerDeploymentWorkflow";
 import { ClientManagerLifecyclePanel } from "../components/ClientManagerLifecyclePanel";
 import { ProductionGovernancePanel } from "../components/ProductionGovernancePanel";
 import { PluginLifecycleWorkbench } from "../components/PluginLifecycleWorkbench";
@@ -48,7 +49,7 @@ import {
 import { DiagnosticSummary, EmptyState, ErrorState, LoadingState, ResultBadge } from "../components/StateViews";
 import type { PageComponentProps } from "../contracts/page";
 import type { PluginBridgeAction, PluginBridgeManifestContract } from "../contracts/pluginBridge";
-import { canStartServer, canStopServer, endpointLabel, pluginLabel, runtimeBindingFields, serverMetadataFormFromInstance, type ServerMetadataFormState } from "../contracts/serverManagement";
+import { canStartServer, canStopServer, defaultServerCreateForm, endpointLabel, pluginCreateInputDefaults, pluginLabel, runtimeBindingFields, serverMetadataFormFromInstance, type ServerCreateFormState, type ServerMetadataFormState } from "../contracts/serverManagement";
 import {
   serverDetailSections,
   serverIsOnline,
@@ -93,6 +94,7 @@ export function ServerDetailPage({ session, params, operations, onNavigate }: Pa
   const [runtimeBinding, setRuntimeBinding] = useState<LoadState<RuntimeBindingResponse>>({ status: "loading" });
 	const [deployment, setDeployment] = useState<LoadState<ServerDeploymentResponse>>({ status: "loading" });
 	const [endpoints, setEndpoints] = useState<RunEndpointResponse[]>([]);
+  const [showDeploymentEditor, setShowDeploymentEditor] = useState(false);
   const [confirm, setConfirm] = useState<null | { title: string; description: string; danger?: boolean; run: () => Promise<void> }>(null);
   const [confirmBusy, setConfirmBusy] = useState(false);
 
@@ -199,6 +201,18 @@ export function ServerDetailPage({ session, params, operations, onNavigate }: Pa
     });
   }
 
+  async function saveDeploymentWorkflow(form: ServerCreateFormState) {
+    if (instance.status !== "ready") return;
+    const current = instance.data;
+    const operationId = operations.begin({ intent: "更新部署定义", targetKind: "server", targetId: current.id, requester: session.displayName });
+    try {
+      await platformApiClient.updateServerDeployment(current.id, { runEndpointId: form.runEndpointId || undefined, mode: form.deploymentMode, profileKey: form.profileKey || undefined, createInputs: form.createInputs, serverRoot: form.serverRoot.trim() || undefined, workingDirectory: form.workingDirectory.trim() || undefined, installCommand: form.installCommand.trim() || undefined, startCommand: form.startCommand.trim() || undefined, stopCommand: form.stopCommand.trim() || undefined, statusCommand: form.statusCommand.trim() || undefined, shell: form.shell || undefined });
+      operations.succeed(operationId, "部署设置已保存；路径和命令保持受保护状态。");
+      setShowDeploymentEditor(false);
+      await refresh();
+    } catch (error) { operations.fail(operationId, error instanceof Error ? error.message : "部署设置保存失败"); }
+  }
+
   if (!serverId) {
     return (
       <EmptyState title="未选择服务器" description="请从服务器列表进入详情页。" actionLabel="返回服务器列表" onAction={() => onNavigate("servers")} />
@@ -269,6 +283,7 @@ export function ServerDetailPage({ session, params, operations, onNavigate }: Pa
                   <Square size={15} />
                   <span>停止</span>
                 </button>
+                <button type="button" className="icon-command" disabled={instance.data.state === "running" || instance.data.state === "installing"} title={instance.data.state === "running" || instance.data.state === "installing" ? "请先停止服务器再编辑部署" : "编辑部署"} onClick={() => setShowDeploymentEditor(true)}><Pencil size={15} /><span>编辑部署</span></button>
               </div>
             </div>
             <div className="server-detail-stat-strip">
@@ -307,7 +322,7 @@ export function ServerDetailPage({ session, params, operations, onNavigate }: Pa
               onChanged={() => void refresh()}
             />
           )}
-			{section === "overview" && <ServerDeploymentSection instance={instance.data} deployment={deployment} endpoints={endpoints} session={session} operations={operations} onChanged={() => void refresh()} />}
+			{section === "overview" && <ServerDeploymentSection instance={instance.data} deployment={deployment} onEdit={() => setShowDeploymentEditor(true)} />}
           {section === "overview" && <RuntimeDLLExtensionsPanel runtimeProfiles={plugins.find((plugin) => plugin.id === instance.data.pluginId)?.runtimeProfiles} />}
           {section === "overview" && <SourceRCONCommandPanel serverId={instance.data.id} pluginId={instance.data.pluginId} />}
           {section === "overview" && (
@@ -337,6 +352,7 @@ export function ServerDetailPage({ session, params, operations, onNavigate }: Pa
           {section === "plugins" && <PluginControlsSection serverId={serverId} instance={instance.data} plugins={plugins} artifacts={artifacts} session={session} operations={operations} onNavigate={onNavigate} />}
           {section === "llm" && <LlmSection serverId={serverId} instance={instance.data} session={session} operations={operations} />}
           {section === "history" && <HistorySection serverId={serverId} serverOperations={serverOperations} jobs={jobs} artifacts={artifacts} metricHistory={metricHistory} backups={backups} remoteAdapters={remoteAdapters} />}
+          <ServerDeploymentWorkflow open={showDeploymentEditor && deployment.status === "ready"} kind="edit" plugins={plugins} endpoints={endpoints} initialForm={deploymentWorkflowForm(instance.data, deployment.status === "ready" ? deployment.data : undefined, plugins, endpoints)} deployment={deployment.status === "ready" ? deployment.data : undefined} busy={operations.isPending(instance.data.id, "更新部署定义")} onClose={() => setShowDeploymentEditor(false)} onSubmit={saveDeploymentWorkflow} />
         </>
       )}
 
@@ -428,88 +444,26 @@ function ServerMetadataSection({ instance, session, operations, onChanged }: Ser
 interface ServerDeploymentSectionProps {
 	instance: ServerInstanceResponse;
 	deployment: LoadState<ServerDeploymentResponse>;
-	endpoints: RunEndpointResponse[];
-	session: PageComponentProps["session"];
-	operations: PageComponentProps["operations"];
-	onChanged: () => void;
+	onEdit: () => void;
 }
 
-function ServerDeploymentSection({ instance, deployment, endpoints, session, operations, onChanged }: ServerDeploymentSectionProps) {
-	const [runEndpointId, setRunEndpointId] = useState(instance.runEndpointId);
-	const [mode, setMode] = useState<"guided-install" | "existing-server" | "custom-command">("guided-install");
-	const [serverRoot, setServerRoot] = useState("");
-	const [workingDirectory, setWorkingDirectory] = useState("");
-	const [installCommand, setInstallCommand] = useState("");
-	const [startCommand, setStartCommand] = useState("");
-	const [stopCommand, setStopCommand] = useState("");
-	const [statusCommand, setStatusCommand] = useState("");
-	const [shell, setShell] = useState<"" | "posix-sh" | "powershell" | "cmd">("");
-	const [busy, setBusy] = useState(false);
-	const [result, setResult] = useState<{ status: "succeeded" | "failed"; label: string } | null>(null);
-
-	useEffect(() => {
-		setRunEndpointId(instance.runEndpointId);
-		if (deployment.status === "ready") {
-			setMode(deployment.data.mode ?? "guided-install");
-			setShell(deployment.data.shell ?? "");
-		}
-	}, [deployment, instance.id, instance.runEndpointId]);
-
-	async function save(event: FormEvent<HTMLFormElement>) {
-		event.preventDefault();
-		setBusy(true);
-		setResult(null);
-		const operationId = operations.begin({ intent: "更新部署定义", targetKind: "server", targetId: instance.id, requester: session.displayName });
-		try {
-			await platformApiClient.updateServerDeployment(instance.id, { runEndpointId: runEndpointId || undefined, mode, serverRoot: serverRoot.trim() || undefined, workingDirectory: workingDirectory.trim() || undefined, installCommand: installCommand.trim() || undefined, startCommand: startCommand.trim() || undefined, stopCommand: stopCommand.trim() || undefined, statusCommand: statusCommand.trim() || undefined, shell: shell || undefined });
-			operations.succeed(operationId, "部署定义已保存；受保护路径和命令不会回显。");
-			setResult({ status: "succeeded", label: "部署定义已保存" });
-			setServerRoot(""); setWorkingDirectory(""); setInstallCommand(""); setStartCommand(""); setStopCommand(""); setStatusCommand("");
-			onChanged();
-		} catch (error) {
-			const label = error instanceof Error ? error.message : "部署定义保存失败";
-			operations.fail(operationId, label);
-			setResult({ status: "failed", label });
-		} finally { setBusy(false); }
-	}
-
-	async function deploy() {
-		setBusy(true);
-		setResult(null);
-		const operationId = operations.begin({ intent: "部署服务器", targetKind: "server", targetId: instance.id, requester: session.displayName });
-		try {
-			const response = await platformApiClient.deployServerInstance(instance.id, { expectedConfigVersion: instance.configVersion, idempotencyKey: `web:deploy:${instance.id}:${Date.now()}` });
-			operations.succeed(operationId, response.job.id ? "部署任务已进入队列，等待 Run 领取。" : "部署请求已接受。");
-			setResult({ status: "succeeded", label: deploymentProgressLabel(response.job.progress) });
-			onChanged();
-		} catch (error) {
-			const label = error instanceof Error ? error.message : "部署失败";
-			operations.fail(operationId, label);
-			setResult({ status: "failed", label });
-		} finally { setBusy(false); }
-	}
-
+function ServerDeploymentSection({ instance, deployment, onEdit }: ServerDeploymentSectionProps) {
 	if (deployment.status === "loading") return <LoadingState label="正在加载部署定义…" compact />;
 	if (deployment.status === "error") return <ErrorState title="部署定义不可用" reason={deployment.reason} diagnosticId={`deployment:${instance.id}`} compact />;
 	const view = deployment.data;
 	return <article className="console-panel" aria-label="server deployment">
 		<div className="panel-header"><h2><PackageOpen size={16} style={{ verticalAlign: "-2px" }} /> 部署定义</h2><span className="page-status">{view.mode || "未配置"} · 修订 {view.revision}</span></div>
-		<p className="section-copy">根目录、工作目录和命令为受保护输入：保存后仅显示已配置状态，不会显示原文。</p>
-		<div className="action-list"><span>根目录：{view.serverRootConfigured ? "已配置" : "未配置"}</span><span>工作目录：{view.workingDirectoryConfigured ? "已配置" : "未配置"}</span><span>安装 / 启动：{view.installCommandConfigured ? "已配置" : "未配置"} / {view.startCommandConfigured ? "已配置" : "未配置"}</span></div>
-		<form className="provider-form" style={{ marginTop: 12 }} onSubmit={(event) => void save(event)}>
-			<div className="form-grid">
-				<label>运行节点<select value={runEndpointId} onChange={(event) => setRunEndpointId(event.target.value)}><option value="">暂不绑定</option>{endpoints.map((endpoint) => <option key={endpoint.id} value={endpoint.id}>{endpointLabel(endpoint, endpoint.id)}</option>)}</select></label>
-				<label>部署方式<select value={mode} onChange={(event) => setMode(event.target.value as typeof mode)}><option value="guided-install">插件引导安装</option><option value="existing-server">接管已有服务器</option><option value="custom-command">自定义命令</option></select></label>
-				<label>服务器根目录（重新填写才会更改）<input value={serverRoot} onChange={(event) => setServerRoot(event.target.value)} placeholder="完整绝对路径" autoComplete="off" /></label>
-				<label>工作目录（重新填写才会更改）<input value={workingDirectory} onChange={(event) => setWorkingDirectory(event.target.value)} placeholder="完整绝对路径" autoComplete="off" /></label>
-				{mode === "custom-command" && <><label>命令解释器<select value={shell} onChange={(event) => setShell(event.target.value as typeof shell)}><option value="">直接 argv</option><option value="posix-sh">POSIX sh</option><option value="powershell">PowerShell</option><option value="cmd">Windows cmd</option></select></label><label>安装命令<input value={installCommand} onChange={(event) => setInstallCommand(event.target.value)} autoComplete="off" /></label><label>启动命令（首次自定义部署必填）<input value={startCommand} onChange={(event) => setStartCommand(event.target.value)} autoComplete="off" /></label><label>停止命令<input value={stopCommand} onChange={(event) => setStopCommand(event.target.value)} autoComplete="off" /></label><label>状态命令<input value={statusCommand} onChange={(event) => setStatusCommand(event.target.value)} autoComplete="off" /></label></>}
-			</div>
-			<div className="action-strip"><button type="submit" className="primary-command" disabled={busy}><Pencil size={14} /><span>{busy ? "保存中…" : "保存部署定义"}</span></button>{instance.state === "draft" || instance.state === "failed" ? <button type="button" className="icon-command" disabled={busy || !runEndpointId} onClick={() => void deploy()}><Sparkles size={14} /><span>部署到 Run</span></button> : null}</div>
-		</form>
-		{result && <div style={{ marginTop: 10 }}><ResultBadge status={result.status} label={result.label} /></div>}
+		<p className="section-copy">服务器目录是主目录；执行目录只用于高级自定义启动，留空时继承服务器目录。路径和命令均为受保护输入，不会回显。</p>
+		<div className="console-row-list"><div className="console-row"><span>服务器目录</span><strong>{view.serverRootConfigured ? "已配置" : "未配置"}</strong></div><div className="console-row"><span>高级执行目录</span><strong>{view.workingDirectoryConfigured ? "已配置" : "使用服务器目录"}</strong></div><div className="console-row"><span>启动设置</span><strong>{view.startCommandConfigured ? "已配置" : view.mode === "custom-command" ? "未配置" : "插件引导"}</strong></div></div>
+		<div className="action-strip" style={{ marginTop: 12 }}><button type="button" className="primary-command" disabled={instance.state === "running" || instance.state === "installing"} onClick={onEdit}><Pencil size={14} /><span>编辑部署</span></button>{(instance.state === "draft" || instance.state === "failed") && <span className="field-help">保存后可从详情明确发起部署。</span>}</div>
 	</article>;
 }
 
+function deploymentWorkflowForm(instance: ServerInstanceResponse, deployment: ServerDeploymentResponse | undefined, plugins: GamePluginResponse[], endpoints: RunEndpointResponse[]): ServerCreateFormState {
+  const plugin = plugins.find((item) => item.id === instance.pluginId);
+  return { ...defaultServerCreateForm(plugins, endpoints), name: instance.name, pluginId: instance.pluginId, runEndpointId: instance.runEndpointId, profileKey: deployment?.profileKey ?? plugin?.runtimeProfiles?.lifecycleProfiles?.[0]?.key ?? "", createInputs: deployment?.createInputs ?? pluginCreateInputDefaults(plugin), deploymentMode: deployment?.mode ?? "guided-install", shell: deployment?.shell ?? "" };
+}
+
 function deploymentProgressLabel(progress: JobResponse["progress"]): string {
 	switch (progress.phase) {
 		case "queued": return "任务已排队，等待 Run 领取";

platform_web/pages/ServersPage.tsx

@@ -1,5 +1,5 @@
 import { AlertTriangle, CakeSlice, Candy, Search, Sparkles, Trash2 } from "lucide-react";
-import { type CSSProperties, type ChangeEvent, type FormEvent, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { type CSSProperties, type FormEvent, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 
 import { platformApiClient } from "../api/client";
@@ -17,15 +17,14 @@ import {
   useRuntimeTaskController
 } from "../components/RuntimeTaskProgress";
 import { ConfirmDialog, ManagementDialog, UsageMeter } from "../components/OperationControls";
+import { ServerDeploymentWorkflow } from "../components/ServerDeploymentWorkflow";
 import { EmptyState, ErrorState, LoadingState, ResultBadge } from "../components/StateViews";
 import type { PageComponentProps } from "../contracts/page";
 import {
   canDeleteServer,
   defaultServerCreateForm,
   endpointLabel,
-	pluginCreateInputDefaults,
-  pluginLabel,
-  runtimeBindingFields,
+  pluginCreateInputDefaults,
   type ServerCreateFormState
 } from "../contracts/serverManagement";
 import { summarizeServerOperations } from "../contracts/operationsConsole";
@@ -72,6 +71,7 @@ export function ServersPage({ session, operations, onNavigate }: PageComponentPr
   const [statusFilter, setStatusFilter] = useState<ServerStatusFilter>("all");
   const [form, setForm] = useState<ServerCreateFormState>(() => defaultServerCreateForm([], []));
   const [showCreate, setShowCreate] = useState(false);
+  const [editDeployment, setEditDeployment] = useState<{ instance: ServerInstanceResponse; deployment: import("../api/types").ServerDeploymentResponse } | null>(null);
   const runtimeTask = useRuntimeTaskController();
   const [runtimeTaskActions, setRuntimeTaskActions] = useState<RuntimeTaskDialogAction[]>([]);
   const [deleteConfirmation, setDeleteConfirmation] = useState<ReturnType<typeof serverDeleteConfirmation> | null>(null);
@@ -102,7 +102,6 @@ export function ServersPage({ session, operations, onNavigate }: PageComponentPr
           pluginId: plugin?.id ?? "",
           profileKey,
           bindings: plugin?.id === current.pluginId && profileKey === current.profileKey ? current.bindings : {},
-			createInputs: plugin?.id === current.pluginId ? current.createInputs : pluginCreateInputDefaults(plugin),
           runEndpointId: endpointResponse.items.some((endpoint) => endpoint.id === current.runEndpointId)
             ? current.runEndpointId
             : endpointResponse.items[0]?.id || ""
@@ -154,39 +153,10 @@ export function ServersPage({ session, operations, onNavigate }: PageComponentPr
   const visibleCards = useMemo(() => filterServerCards(cards, keyword, statusFilter), [cards, keyword, statusFilter]);
   const createPending = operations.isPending("platform", "创建服务器");
   const canManageServers = session.capabilities.includes("servers.manage");
-  const selectedCreatePlugin = plugins.find((plugin) => plugin.id === form.pluginId);
-  const createProfileOptions = selectedCreatePlugin?.runtimeProfiles?.lifecycleProfiles ?? [];
-  const createProfileUnavailable = Boolean(selectedCreatePlugin && createProfileOptions.length === 0);
-  const createBindingFields = runtimeBindingFields(selectedCreatePlugin, form.profileKey);
-	const createPluginFields = selectedCreatePlugin?.createFields ?? [];
-
-  function updateForm(event: ChangeEvent<HTMLInputElement | HTMLSelectElement>) {
-    const { name, value } = event.target;
-    setForm((current) => {
-      if (name === "pluginId") {
-        const plugin = plugins.find((item) => item.id === value);
-			return { ...current, pluginId: value, profileKey: plugin?.runtimeProfiles?.lifecycleProfiles?.[0]?.key ?? "", bindings: {}, createInputs: pluginCreateInputDefaults(plugin) };
-      }
-      if (name === "profileKey") {
-        return { ...current, profileKey: value, bindings: {} };
-      }
-      return { ...current, [name]: value };
-    });
-  }
-
-  function updateBinding(key: string, value: string) {
-    setForm((current) => ({ ...current, bindings: { ...current.bindings, [key]: value } }));
-  }
-
-	function updateCreateInput(key: string, value: string) {
-		setForm((current) => ({ ...current, createInputs: { ...current.createInputs, [key]: value } }));
-	}
-
-  async function handleCreate(event: FormEvent<HTMLFormElement>) {
-    event.preventDefault();
+  async function handleCreate(nextForm: ServerCreateFormState) {
     const operationId = operations.begin({ intent: "创建服务器", targetKind: "server", targetId: "platform", requester: session.displayName });
     try {
-      const result = await platformApiClient.createServerWorkflow(serverCreateRequestFromForm(form));
+      const result = await platformApiClient.createServerWorkflow(serverCreateRequestFromForm(nextForm));
 		operations.succeed(operationId, result.job.id ? `已创建实例 ${result.instance.id}，安装任务 ${result.job.id} 已派发` : `已保存草稿 ${result.instance.id}；可在 Run 注册后绑定并部署。`, result.job.id ? result.job : undefined);
       setForm(defaultServerCreateForm(plugins, endpoints));
       setShowCreate(false);
@@ -196,6 +166,33 @@ export function ServersPage({ session, operations, onNavigate }: PageComponentPr
     }
   }
 
+  async function openEditDeployment(instance: ServerInstanceResponse) {
+    if (instance.state === "running" || instance.state === "installing") return;
+    try {
+      const deployment = await platformApiClient.getServerDeployment(instance.id);
+      const plugin = plugins.find((item) => item.id === instance.pluginId);
+      setForm({ ...defaultServerCreateForm(plugins, endpoints), name: instance.name, pluginId: instance.pluginId, runEndpointId: instance.runEndpointId, profileKey: deployment.profileKey ?? plugin?.runtimeProfiles?.lifecycleProfiles?.[0]?.key ?? "", createInputs: deployment.createInputs ?? pluginCreateInputDefaults(plugin), deploymentMode: deployment.mode ?? "guided-install", shell: deployment.shell ?? "" });
+      setEditDeployment({ instance, deployment });
+    } catch (error) {
+      const operationId = operations.begin({ intent: "读取部署设置", targetKind: "server", targetId: instance.id, requester: session.displayName });
+      operations.fail(operationId, error instanceof Error ? error.message : "部署设置加载失败");
+    }
+  }
+
+  async function handleUpdateDeployment(nextForm: ServerCreateFormState) {
+    if (!editDeployment) return;
+    const { instance } = editDeployment;
+    const operationId = operations.begin({ intent: "更新部署定义", targetKind: "server", targetId: instance.id, requester: session.displayName });
+    try {
+      await platformApiClient.updateServerDeployment(instance.id, { runEndpointId: nextForm.runEndpointId || undefined, mode: nextForm.deploymentMode, profileKey: nextForm.profileKey || undefined, createInputs: nextForm.createInputs, serverRoot: nextForm.serverRoot.trim() || undefined, workingDirectory: nextForm.workingDirectory.trim() || undefined, installCommand: nextForm.installCommand.trim() || undefined, startCommand: nextForm.startCommand.trim() || undefined, stopCommand: nextForm.stopCommand.trim() || undefined, statusCommand: nextForm.statusCommand.trim() || undefined, shell: nextForm.shell || undefined });
+      operations.succeed(operationId, "部署设置已保存；路径和命令保持受保护状态。");
+      setEditDeployment(null);
+      await refresh();
+    } catch (error) {
+      operations.fail(operationId, error instanceof Error ? error.message : "部署设置保存失败");
+    }
+  }
+
   async function handleDeleteServer() {
     if (!deleteConfirmation) {
       return;
@@ -493,123 +490,8 @@ export function ServersPage({ session, operations, onNavigate }: PageComponentPr
         </div>
       )}
 
-      <ManagementDialog
-        open={showCreate && canManageServers}
-        title="创建服务器"
-        description="先保存服务器定义也可以；Run 注册后再绑定部署。根目录和命令只会写入受保护执行计划，之后不会在页面、任务或日志中显示。"
-        wide
-        onClose={() => { if (!createPending) setShowCreate(false); }}
-      >
-        <form className="provider-form dialog-form" onSubmit={(event) => void handleCreate(event)} aria-label="创建服务器">
-          <div className="form-grid">
-            <label>
-              名称
-              <input name="name" value={form.name} onChange={updateForm} placeholder="Example Survival #3" required />
-            </label>
-            <label>
-              插件
-              <select name="pluginId" value={form.pluginId} onChange={updateForm} required>
-                {plugins.map((plugin) => (
-                  <option key={plugin.id} value={plugin.id}>
-                    {pluginLabel(plugin, plugin.id)}
-                  </option>
-                ))}
-              </select>
-            </label>
-            <label>
-              运行节点
-              <select name="runEndpointId" value={form.runEndpointId} onChange={updateForm}>
-					<option value="">暂不选择（保存草稿）</option>
-                {endpoints.map((endpoint) => (
-                  <option key={endpoint.id} value={endpoint.id}>
-                    {endpointLabel(endpoint, endpoint.id)}
-                  </option>
-                ))}
-              </select>
-            </label>
-            <label>
-				运行配置（可选）
-              <select name="profileKey" value={form.profileKey} onChange={updateForm}>
-					<option value="">不使用插件运行配置</option>
-                {createProfileOptions.map((profile) => (
-                  <option key={profile.key} value={profile.key}>
-                    {profile.key} · {profile.mode}
-                  </option>
-                ))}
-              </select>
-            </label>
-            {createProfileUnavailable && (
-              <div className="operations-inline-warning" role="status">
-                <AlertTriangle size={14} />
-                <span>当前插件没有声明运行配置，请重新注册完整 manifest 后刷新。</span>
-              </div>
-            )}
-			<label>
-				部署方式
-				<select name="deploymentMode" value={form.deploymentMode} onChange={updateForm}>
-					<option value="guided-install">插件引导安装</option>
-					<option value="existing-server">接管已有服务器</option>
-					<option value="custom-command">自定义命令</option>
-				</select>
-			</label>
-			<label>
-				服务器根目录（完整绝对路径，可选）
-				<input name="serverRoot" value={form.serverRoot} onChange={updateForm} placeholder="/srv/scum-alpha 或 C:\\Games\\SCUM" autoComplete="off" />
-			</label>
-			<label>
-				工作目录（完整绝对路径，可选）
-				<input name="workingDirectory" value={form.workingDirectory} onChange={updateForm} placeholder="/srv/scum-alpha" autoComplete="off" />
-			</label>
-			{createPluginFields.map((field) => (
-				<label key={field.key}>
-					{field.label}{field.required ? "（必填）" : ""}
-					{field.type === "select" ? (
-						<select value={form.createInputs[field.key] ?? ""} onChange={(event) => updateCreateInput(field.key, event.target.value)} required={field.required}>
-							{!field.required && <option value="">未设置</option>}
-							{field.options?.map((option) => <option key={option} value={option}>{option}</option>)}
-						</select>
-					) : (
-						<input type={field.type === "boolean" ? "checkbox" : field.type === "number" || field.type === "port" ? "number" : "text"} min={field.type === "port" ? 1 : undefined} max={field.type === "port" ? 65535 : undefined} checked={field.type === "boolean" ? form.createInputs[field.key] === "true" : undefined} value={field.type === "boolean" ? undefined : form.createInputs[field.key] ?? ""} onChange={(event) => updateCreateInput(field.key, field.type === "boolean" ? String(event.target.checked) : event.target.value)} required={field.required} />
-					)}
-				</label>
-			))}
-			{form.deploymentMode === "custom-command" && (
-				<>
-					<label>
-						命令解释器
-						<select name="shell" value={form.shell} onChange={updateForm}>
-							<option value="">直接 argv（推荐）</option><option value="posix-sh">POSIX sh</option><option value="powershell">PowerShell</option><option value="cmd">Windows cmd</option>
-						</select>
-					</label>
-					<label>安装命令（可选）<input name="installCommand" value={form.installCommand} onChange={updateForm} autoComplete="off" placeholder="例如 SteamCMD 安装命令" /></label>
-					<label>启动命令（必填）<input name="startCommand" value={form.startCommand} onChange={updateForm} autoComplete="off" required placeholder="例如 /srv/app/.venv/bin/python server.py" /></label>
-					<label>停止命令（可选）<input name="stopCommand" value={form.stopCommand} onChange={updateForm} autoComplete="off" /></label>
-					<label>状态命令（可选）<input name="statusCommand" value={form.statusCommand} onChange={updateForm} autoComplete="off" /></label>
-				</>
-			)}
-            {createBindingFields.map((field) => (
-              <label key={field.key}>
-                {field.key}{field.required ? "（必填）" : ""}
-                <input
-                  type={field.sensitive ? "password" : "text"}
-                  autoComplete="off"
-                  value={form.bindings[field.key] ?? ""}
-                  onChange={(event) => updateBinding(field.key, event.target.value)}
-                  placeholder={field.sensitive ? "托管凭据引用" : "安全逻辑值"}
-                  required={field.required}
-                />
-              </label>
-            ))}
-          </div>
-          <div className="confirm-actions">
-            <button type="button" disabled={createPending} onClick={() => setShowCreate(false)}>取消</button>
-            <button type="submit" className="confirm-primary" disabled={createPending || createProfileUnavailable} title="创建服务器">
-              <Sparkles size={16} />
-				<span>{createPending ? "保存中…" : form.runEndpointId ? "保存并部署" : "保存草稿"}</span>
-            </button>
-          </div>
-        </form>
-      </ManagementDialog>
+      <ServerDeploymentWorkflow open={showCreate && canManageServers} kind="create" plugins={plugins} endpoints={endpoints} initialForm={form} busy={createPending} onClose={() => setShowCreate(false)} onSubmit={handleCreate} />
+      <ServerDeploymentWorkflow open={editDeployment !== null} kind="edit" plugins={plugins} endpoints={endpoints} initialForm={form} deployment={editDeployment?.deployment} busy={editDeployment ? operations.isPending(editDeployment.instance.id, "更新部署定义") : false} onClose={() => setEditDeployment(null)} onSubmit={handleUpdateDeployment} />
 
       <ManagementDialog
         open={runTargetSelection !== null}
@@ -712,6 +594,7 @@ export function ServersPage({ session, operations, onNavigate }: PageComponentPr
               canManage={canManageServers}
               deleteDisabledReason={serverDeleteDisabledReason(session, card.instance)}
               onOpen={() => onNavigate("serverDetail", { serverId: card.instance.id })}
+              onEdit={() => void openEditDeployment(card.instance)}
               onQuickAction={(action) => void handleQuickRuntimeAction(card.instance, action)}
               onDelete={() => {
                 setDeletePassword("");
@@ -789,11 +672,12 @@ interface ServerCardProps {
   canManage: boolean;
   deleteDisabledReason: string;
   onOpen: () => void;
+  onEdit: () => void;
   onQuickAction: (action: ServerQuickRuntimeAction) => void;
   onDelete: () => void;
 }
 
-function ServerCard({ card, metricsPending, metricsUnavailable, canManage, deleteDisabledReason, onOpen, onQuickAction, onDelete }: ServerCardProps) {
+function ServerCard({ card, metricsPending, metricsUnavailable, canManage, deleteDisabledReason, onOpen, onEdit, onQuickAction, onDelete }: ServerCardProps) {
   const { instance, metrics, pendingJobs, failedJobs = 0 } = card;
   const online = serverIsOnline(instance.state);
   const canDelete = deleteDisabledReason === "";
@@ -914,6 +798,7 @@ function ServerCard({ card, metricsPending, metricsUnavailable, canManage, delet
           <Sparkles size={14} />
           <span>详情</span>
         </button>
+        <button type="button" className="icon-command" disabled={!canManage || instance.state === "running" || instance.state === "installing"} title={instance.state === "running" || instance.state === "installing" ? "请先停止服务器再编辑部署" : "编辑部署"} onClick={onEdit}><span>编辑部署</span></button>
         <button ref={menuButtonRef} type="button" className="icon-command" disabled={!canOpenActions} title={canOpenActions ? "运行操作" : "当前账号没有运行操作权限"} aria-haspopup="menu" aria-expanded={menuOpen} onClick={toggleMenu}>
           <span>运行操作</span>
         </button>