From bb12137c4ede891147503f6a2291e54ade5b732a Mon Sep 17 00:00:00 2001
From: npc0-hue <github@npc0.com>
Date: Sat, 25 Jul 2026 10:57:22 +0800
Subject: [PATCH] polish server deployment workflow

---
 .../components/ServerDeploymentWorkflow.tsx   | 66 ++++++++++++-------
 platform_web/pages/ConsolePages.test.tsx      |  6 ++
 platform_web/pages/ServerDetailPage.test.tsx  |  3 +
 platform_web/pages/ServerDetailPage.tsx       | 12 +++-
 platform_web/pages/ServersPage.tsx            |  3 +-
 platform_web/routes/routes.test.ts            |  2 +
 platform_web/routes/routes.ts                 |  8 ++-
 7 files changed, 74 insertions(+), 26 deletions(-)

diff --git a/platform_web/components/ServerDeploymentWorkflow.tsx b/platform_web/components/ServerDeploymentWorkflow.tsx
index b922000..32c7818 100644
--- a/platform_web/components/ServerDeploymentWorkflow.tsx
+++ b/platform_web/components/ServerDeploymentWorkflow.tsx
@@ -20,13 +20,6 @@ interface ServerDeploymentWorkflowProps {
   onSubmit: (form: ServerCreateFormState, saveAsDraft: boolean) => Promise<void>;
 }
 
-const workflowSteps = [
-  { label: "选择目标", icon: Compass },
-  { label: "部署方式", icon: ServerCog },
-  { label: "相关配置", icon: FolderCog },
-  { label: "确认", icon: Rocket }
-];
-
 export function ServerDeploymentWorkflow({ open, kind, plugins, endpoints, initialForm, deployment, busy = false, onClose, onSubmit }: ServerDeploymentWorkflowProps) {
   const [step, setStep] = useState(0);
   const [form, setForm] = useState<ServerCreateFormState>(initialForm);
@@ -37,11 +30,21 @@ export function ServerDeploymentWorkflow({ open, kind, plugins, endpoints, initi
   const bindingFields = runtimeBindingFields(selectedPlugin, form.profileKey);
   const activeServer = kind === "edit" && Boolean(deployment);
   const isScum = selectedPlugin?.id === "game.scum";
+  const needsTargetSelection = kind === "create" || !initialForm.runEndpointId;
+  const workflowSteps = kind === "create"
+    ? [{ label: "选择目标", icon: Compass }, { label: "部署方式", icon: ServerCog }, { label: "相关配置", icon: FolderCog }, { label: "确认", icon: Rocket }]
+    : needsTargetSelection
+      ? [{ label: "选择运行节点", icon: Compass }, { label: "相关配置", icon: FolderCog }, { label: "确认", icon: Rocket }]
+      : [{ label: "相关配置", icon: FolderCog }, { label: "确认", icon: Rocket }];
+  const targetStep = needsTargetSelection ? 0 : -1;
+  const modeStep = kind === "create" ? 1 : -1;
+  const configurationStep = kind === "create" ? 2 : needsTargetSelection ? 1 : 0;
+  const reviewStep = workflowSteps.length - 1;
 
   useEffect(() => {
     if (!open) return;
     setStep(0);
-    setSaveAsDraft(!initialForm.runEndpointId);
+    setSaveAsDraft(kind === "create" && !initialForm.runEndpointId);
     setForm(initialForm);
   }, [initialForm, kind, open]);
 
@@ -61,8 +64,8 @@ export function ServerDeploymentWorkflow({ open, kind, plugins, endpoints, initi
   function updateBinding(key: string, value: string) { setForm((current) => ({ ...current, bindings: { ...current.bindings, [key]: value } })); }
 
   function canContinue() {
-    if (step === 0) return Boolean(form.pluginId && (saveAsDraft || form.runEndpointId));
-    if (step === 2) {
+    if (step === targetStep) return kind === "create" ? Boolean(form.pluginId && (saveAsDraft || form.runEndpointId)) : Boolean(form.runEndpointId);
+    if (step === configurationStep) {
       if (kind === "create" && !form.name.trim()) return false;
       if (isScum && form.deploymentMode === "guided-install" && !form.serverRoot.trim() && !deployment?.serverRootConfigured) return false;
       if (form.deploymentMode === "existing-server" && !form.serverRoot.trim() && !deployment?.serverRootConfigured) return false;
@@ -74,29 +77,30 @@ export function ServerDeploymentWorkflow({ open, kind, plugins, endpoints, initi
 
   async function submit(event: FormEvent<HTMLFormElement>) {
     event.preventDefault();
-    if (step < workflowSteps.length - 1) { if (canContinue()) setStep((current) => current + 1); return; }
+    if (step < reviewStep) { if (canContinue()) setStep((current) => current + 1); return; }
     await onSubmit({ ...form, runEndpointId: saveAsDraft ? "" : form.runEndpointId }, saveAsDraft);
   }
 
   const protectedState = (nextValue: string, configured: boolean) => nextValue.trim() ? "将替换" : configured ? "保持已配置" : "未配置";
-  const actionLabel = kind === "create" ? (saveAsDraft ? "保存草稿" : "创建并部署") : (saveAsDraft ? "保存草稿设置" : "保存部署设置");
+  const actionLabel = kind === "create" ? (saveAsDraft ? "保存草稿" : "创建、部署并前往构建 Run") : "保存部署设置";
 
   return <ManagementDialog open={open} title={kind === "create" ? "创建服务器" : "编辑部署"} description={kind === "create" ? "按部署顺序完成设置；路径和命令始终受保护，不会在确认页或日志中回显。" : "仅停止中的服务器可以修改部署设置。受保护路径和命令留空会保持原值。"} wide onClose={() => { if (!busy) onClose(); }}>
     <form className="provider-form dialog-form server-deployment-workflow" onSubmit={(event) => void submit(event)} aria-label={kind === "create" ? "创建服务器部署向导" : "编辑服务器部署向导"}>
-      <ol className="deployment-workflow-steps" aria-label="部署步骤">{workflowSteps.map((item, index) => { const Icon = item.icon; return <li key={item.label} className={cx(index === step && "deployment-workflow-step-active", index < step && "deployment-workflow-step-complete")}><span>{index < step ? <CheckCircle2 size={15} /> : <Icon size={15} />}</span><strong>{index + 1}. {item.label}</strong></li>; })}</ol>
-      {step === 0 && <div className="deployment-workflow-body">
-        <div className="workflow-hint-grid"><div className="workflow-hint-card"><strong>先确定游戏</strong><span>插件决定可填写的游戏配置与启动预设。</span></div><div className="workflow-hint-card"><strong>再选择节点</strong><span>节点负责预检和执行，平台不会直接访问主机。</span></div><div className="workflow-hint-card"><strong>也可存为草稿</strong><span>草稿不会发起部署，稍后可从服务器详情继续。</span></div></div>
-        <div className="form-grid"><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} disabled={saveAsDraft} required={!saveAsDraft}><option value="">请选择运行节点</option>{endpoints.map((endpoint) => <option key={endpoint.id} value={endpoint.id}>{endpointLabel(endpoint, endpoint.id)}</option>)}</select></label></div>
-        <label className="deployment-draft-choice"><input type="checkbox" checked={saveAsDraft} onChange={(event) => setSaveAsDraft(event.target.checked)} /><span><strong>{kind === "create" ? "仅保存为草稿" : "保持为未绑定草稿"}</strong><small>暂不指定运行节点；不会安装、预检或派发任务。</small></span></label>
+      <ol className="deployment-workflow-steps" style={{ gridTemplateColumns: `repeat(${workflowSteps.length}, minmax(0, 1fr))` }} aria-label="部署步骤">{workflowSteps.map((item, index) => { const Icon = item.icon; return <li key={item.label} className={cx(index === step && "deployment-workflow-step-active", index < step && "deployment-workflow-step-complete")}><span>{index < step ? <CheckCircle2 size={15} /> : <Icon size={15} />}</span><strong>{index + 1}. {item.label}</strong></li>; })}</ol>
+      {step === targetStep && <div className="deployment-workflow-body">
+        {kind === "create" ? <div className="workflow-hint-grid"><div className="workflow-hint-card"><strong>选择游戏</strong><span>插件决定新建时需要的游戏配置与启动预设。</span></div><div className="workflow-hint-card"><strong>选择运行节点</strong><span>Run 在目标主机预检并执行；平台不会直接访问主机。</span></div><div className="workflow-hint-card"><strong>准备服务器目录</strong><span>下一步选择新建、接管或自定义方式，再填写对应目录。</span></div></div> : <div className="form-guidance"><strong>这个草稿尚未绑定运行节点</strong><span>只需在这里补选一次。已绑定服务器编辑时会直接进入相关配置，不会重复要求选择目标。</span></div>}
+        <div className="form-grid">{kind === "create" && <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} disabled={kind === "create" && saveAsDraft} required={kind !== "create" || !saveAsDraft}><option value="">请选择运行节点</option>{endpoints.map((endpoint) => <option key={endpoint.id} value={endpoint.id}>{endpointLabel(endpoint, endpoint.id)}</option>)}</select></label></div>
+        {kind === "create" && <label className="deployment-draft-choice"><input type="checkbox" checked={saveAsDraft} onChange={(event) => setSaveAsDraft(event.target.checked)} /><span><strong>仅保存为草稿</strong><small>暂不指定运行节点；不会安装、预检或派发任务。</small></span></label>}
       </div>}
-      {step === 1 && <div className="deployment-workflow-body"><p className="section-copy">选择你想让平台承担的方式。后续只显示这一方式需要的字段。</p>{isScum && <div className="form-guidance"><strong>SCUM 受控链路</strong><span>Run 会按预检 → 安装或扫描 → 配置映射 → 健康验证执行；目录本身不代表安装完成。</span></div>}<div className="deployment-mode-grid">
+      {step === modeStep && <div className="deployment-workflow-body"><p className="section-copy">选择你想让平台承担的方式。后续只显示这一方式需要的字段。</p>{isScum && <div className="form-guidance"><strong>SCUM 受控链路</strong><span>Run 会按预检 → 安装或扫描 → 配置映射 → 健康验证执行；目录本身不代表安装完成。</span></div>}<div className="deployment-mode-grid">
         <ModeOption active={form.deploymentMode === "guided-install"} title="新建并安装" copy="按插件的推荐方案安装并写入游戏配置。适合绝大多数新服务器。" onClick={() => setForm((current) => ({ ...current, deploymentMode: "guided-install" }))} />
         <ModeOption active={form.deploymentMode === "existing-server"} title="接管已有服务器" copy="预检指定目录并接入已有实例；不会把它当作一次新安装。" onClick={() => setForm((current) => ({ ...current, deploymentMode: "existing-server" }))} />
         <ModeOption active={form.deploymentMode === "custom-command"} title="自定义启动方式" copy="用于非标准启动器或脚本；需由节点策略允许。" onClick={() => setForm((current) => ({ ...current, deploymentMode: "custom-command" }))} />
       </div></div>}
-      {step === 2 && <div className="deployment-workflow-body"><div className="form-grid">
+      {step === configurationStep && <div className="deployment-workflow-body"><div className="form-grid">
         {kind === "create" && <label>服务器名称<input name="name" value={form.name} onChange={updateForm} placeholder="Example Survival #3" required /></label>}
         {kind === "create" && <label>运行预设（可选）<select name="profileKey" value={form.profileKey} onChange={updateForm}><option value="">使用插件默认预设</option>{profileOptions.map((profile) => <option key={profile.key} value={profile.key}>{profile.key} · {profile.mode}</option>)}</select><small className="field-help">仅在插件提供多个兼容启动预设时选择。</small></label>}
+        {kind === "edit" && <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><small className="field-help">可在此调整部署方式；不会重复要求选择已绑定的运行节点。</small></label>}
         {form.deploymentMode === "guided-install" && <label>安装目录{isScum ? "（必填）" : "（可选）"}<input name="serverRoot" value={form.serverRoot} onChange={updateForm} placeholder={deployment?.serverRootConfigured ? "留空保持已配置安装目录" : "完整绝对路径"} autoComplete="off" required={isScum && !deployment?.serverRootConfigured} /><small className="field-help">新建服务器的安装目标；SCUM 受控模板必须明确安装目录。</small></label>}
         {form.deploymentMode === "existing-server" && <label>已有服务器目录<input name="serverRoot" value={form.serverRoot} onChange={updateForm} placeholder={deployment?.serverRootConfigured ? "留空保持已接管目录" : "完整绝对路径"} autoComplete="off" required={!deployment?.serverRootConfigured} /><small className="field-help">Run 会先预检目录、插件与端口；不会重装或覆盖现有游戏配置。</small></label>}
         {form.deploymentMode === "custom-command" && <label>服务器目录<input name="serverRoot" value={form.serverRoot} onChange={updateForm} placeholder={deployment?.serverRootConfigured ? "留空保持已配置目录" : "完整绝对路径"} autoComplete="off" /><small className="field-help">服务器文件、数据与配置的主目录。</small></label>}
@@ -109,12 +113,12 @@ export function ServerDeploymentWorkflow({ open, kind, plugins, endpoints, initi
         ))}
       </div>
       {form.deploymentMode === "guided-install" && <GuidedInstallPlan pluginName={pluginLabel(selectedPlugin, form.pluginId)} isScum={isScum} />}
-      {form.deploymentMode === "existing-server" && <div className="form-guidance"><strong>接管只做预检与绑定</strong><span>不会执行安装命令，也不会把本页的默认游戏参数写进已有服务器。</span></div>}
+      {form.deploymentMode === "existing-server" && <ExistingServerAdoptionPlan pluginName={pluginLabel(selectedPlugin, form.pluginId)} isScum={isScum} />}
       {form.deploymentMode === "custom-command" && <details className="provider-advanced-settings" open><summary>高级启动设置</summary><p className="field-help">只有自定义启动器需要这些设置。执行目录留空时，节点以服务器目录执行。</p><div className="form-grid"><label>启动命令<input name="startCommand" value={form.startCommand} onChange={updateForm} placeholder={deployment?.startCommandConfigured ? "留空保持已配置启动命令" : "必填，例如 ./start-server"} autoComplete="off" required={!deployment?.startCommandConfigured} /></label><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="workingDirectory" value={form.workingDirectory} onChange={updateForm} placeholder={deployment?.workingDirectoryConfigured ? "留空保持已配置执行目录" : "默认使用服务器目录"} autoComplete="off" /></label><label>安装命令（可选）<input name="installCommand" value={form.installCommand} onChange={updateForm} autoComplete="off" placeholder="留空保持原值或不使用" /></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></div></details>}
       {kind === "create" && bindingFields.length > 0 && <details className="provider-advanced-settings"><summary>运行连接设置</summary><p className="field-help">用于插件声明的逻辑连接，不是服务器目录或游戏配置。</p><div className="form-grid">{bindingFields.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></details>}
       </div>}
-      {step === 3 && <div className="deployment-workflow-body"><div className="deployment-review"><div><span>插件类型</span><strong>{pluginLabel(selectedPlugin, form.pluginId)}</strong></div><div><span>目标</span><strong>{saveAsDraft ? "保存为未绑定草稿" : endpointLabel(endpoints.find((endpoint) => endpoint.id === form.runEndpointId), form.runEndpointId)}</strong></div><div><span>部署方式</span><strong>{form.deploymentMode === "guided-install" ? "新建并安装" : form.deploymentMode === "existing-server" ? "接管已有服务器" : "自定义启动方式"}</strong></div><div><span>{form.deploymentMode === "guided-install" ? "安装目录" : form.deploymentMode === "existing-server" ? "已有服务器目录" : "服务器目录"}</span><strong>{protectedState(form.serverRoot, Boolean(deployment?.serverRootConfigured))}</strong></div>{form.deploymentMode === "custom-command" && <><div><span>启动命令</span><strong>{protectedState(form.startCommand, Boolean(deployment?.startCommandConfigured))}</strong></div><div><span>执行目录</span><strong>{protectedState(form.workingDirectory, Boolean(deployment?.workingDirectoryConfigured))}</strong></div></>}{form.deploymentMode === "guided-install" && <div><span>游戏配置</span><strong>{Object.keys(form.createInputs).length ? `${Object.keys(form.createInputs).length} 项已准备` : "使用插件默认值"}</strong></div>}{isScum && <div><span>完成条件</span><strong>安装/扫描、映射、验证全部通过</strong></div>}</div><div className="form-guidance"><strong>{saveAsDraft ? "本次只保存定义" : activeServer ? "本次只保存部署设置" : "确认后将创建并派发部署"}</strong><span>{saveAsDraft ? "后续从服务器详情选择节点并部署。" : form.deploymentMode === "existing-server" ? "Run 将先预检现有目录；不会重装或覆盖已有游戏配置。" : activeServer ? "保存后可在详情中明确发起部署；路径和命令不会显示原文。" : isScum ? "Run 只有在 SCUM 配置映射与健康验证通过后才会报告安装成功。" : "Run 会在领取任务后执行本机预检，再进行安装、配置与启动。"}</span></div></div>}
-      <div className="confirm-actions"><button type="button" disabled={busy} onClick={() => step === 0 ? onClose() : setStep((current) => current - 1)}>{step === 0 ? "取消" : "上一步"}</button>{step < workflowSteps.length - 1 ? <button type="submit" className="confirm-primary" disabled={busy || !canContinue()}><CircleDashed size={16} /><span>下一步</span></button> : <button type="submit" className="confirm-primary" disabled={busy}><Rocket size={16} /><span>{busy ? "保存中…" : actionLabel}</span></button>}</div>
+      {step === reviewStep && <div className="deployment-workflow-body"><div className="deployment-review"><div><span>插件类型</span><strong>{pluginLabel(selectedPlugin, form.pluginId)}</strong></div><div><span>目标</span><strong>{saveAsDraft ? "保存为未绑定草稿" : endpointLabel(endpoints.find((endpoint) => endpoint.id === form.runEndpointId), form.runEndpointId)}</strong></div><div><span>部署方式</span><strong>{form.deploymentMode === "guided-install" ? "新建并安装" : form.deploymentMode === "existing-server" ? "接管已有服务器" : "自定义启动方式"}</strong></div><div><span>{form.deploymentMode === "guided-install" ? "安装目录" : form.deploymentMode === "existing-server" ? "已有服务器目录" : "服务器目录"}</span><strong>{protectedState(form.serverRoot, Boolean(deployment?.serverRootConfigured))}</strong></div>{form.deploymentMode === "custom-command" && <><div><span>启动命令</span><strong>{protectedState(form.startCommand, Boolean(deployment?.startCommandConfigured))}</strong></div><div><span>执行目录</span><strong>{protectedState(form.workingDirectory, Boolean(deployment?.workingDirectoryConfigured))}</strong></div></>}{form.deploymentMode === "guided-install" && <div><span>游戏配置</span><strong>{Object.keys(form.createInputs).length ? `${Object.keys(form.createInputs).length} 项已准备` : "使用插件默认值"}</strong></div>}{isScum && <div><span>完成条件</span><strong>安装/扫描、映射、验证全部通过</strong></div>}</div><div className="form-guidance"><strong>{saveAsDraft ? "本次只保存定义" : activeServer ? "本次只保存部署设置" : "确认后将创建、部署并打开 Run 构建"}</strong><span>{saveAsDraft ? "后续从服务器详情选择节点并部署。" : form.deploymentMode === "existing-server" ? "Run 将先预检现有目录；不会重装或覆盖已有游戏配置。" : activeServer ? "保存后可在详情中明确发起部署；路径和命令不会显示原文。" : isScum ? "Run 只有在 SCUM 配置映射与健康验证通过后才会报告安装成功。" : "Run 会在领取任务后执行本机预检，再进行安装、配置与启动。"}</span></div></div>}
+      <div className="confirm-actions"><button type="button" disabled={busy} onClick={() => step === 0 ? onClose() : setStep((current) => current - 1)}>{step === 0 ? "取消" : "上一步"}</button>{step < reviewStep ? <button type="submit" className="confirm-primary" disabled={busy || !canContinue()}><CircleDashed size={16} /><span>下一步</span></button> : <button type="submit" className="confirm-primary" disabled={busy}><Rocket size={16} /><span>{busy ? "保存中…" : actionLabel}</span></button>}</div>
     </form>
   </ManagementDialog>;
 }
@@ -136,3 +140,21 @@ function GuidedInstallPlan({ pluginName, isScum }: { pluginName: string; isScum:
 
   return <section className="guided-install-plan" aria-label="新建并安装执行流程"><div className="guided-install-plan-heading"><div><strong>确认后，{pluginName} 会这样安装</strong><span>“安装目录”就是游戏服务端、数据和配置将落地的位置；它不是命令执行目录，也不会在日志中回显。</span></div><small>{isScum ? "全部 4 步通过才算安装成功" : "节点按插件契约执行"}</small></div><ol>{steps.map(({ icon: Icon, title, copy }, index) => <li key={title}><span><Icon size={16} /></span><div><strong>{index + 1}. {title}</strong><small>{copy}</small></div></li>)}</ol><p><strong>不会做：</strong>{isScum ? "不会跳过验证就标记成功；失败时不会暴露你的目录、命令或凭据。" : "不会把受保护的路径、命令或凭据回显给浏览器。"}</p></section>;
 }
+
+function ExistingServerAdoptionPlan({ pluginName, isScum }: { pluginName: string; isScum: boolean }) {
+  const steps = isScum ? [
+    { icon: FolderCog, title: "定位服务端根目录", copy: "填写包含 SCUM 服务端文件、数据与配置的目录，不是 Steam 库或 SteamCMD 目录。" },
+    { icon: ScanSearch, title: "Run 本机预检", copy: "检查目录权限、可执行文件、版本、Steam App 标记和所需端口。" },
+    { icon: SlidersHorizontal, title: "只读扫描配置", copy: "识别 ServerSettings.ini 与现有参数；接管不会写入或覆盖它们。" },
+    { icon: ServerCog, title: "绑定受控生命周期", copy: "记录这台实例由哪个 Run 管理，后续启动、停止和日志仍走受控通道。" },
+    { icon: HeartPulse, title: "健康验证", copy: "确认端口、进程与配置可读后，才标记为接管成功。" }
+  ] : [
+    { icon: FolderCog, title: "定位服务端根目录", copy: "填写已有服务端文件、数据与配置所在的主目录。" },
+    { icon: ScanSearch, title: "Run 本机预检", copy: "检查目录权限、插件识别和端口是否可用。" },
+    { icon: SlidersHorizontal, title: "只读扫描配置", copy: "读取插件需要的现有状态，不把新建默认值写进服务器。" },
+    { icon: ServerCog, title: "绑定受控生命周期", copy: "后续运行操作由绑定的 Run 通过平台通道执行。" },
+    { icon: HeartPulse, title: "健康验证", copy: "验证通过后才标记为接管成功。" }
+  ];
+
+  return <section className="guided-install-plan" aria-label="接管已有服务器执行流程"><div className="guided-install-plan-heading"><div><strong>确认后，{pluginName} 会这样接管</strong><span>目录只会交给目标 Run 在本机使用；平台、浏览器和日志都不会显示原始路径。</span></div><small>先扫描，后绑定</small></div><ol>{steps.map(({ icon: Icon, title, copy }, index) => <li key={title}><span><Icon size={16} /></span><div><strong>{index + 1}. {title}</strong><small>{copy}</small></div></li>)}</ol>{isScum ? <p><strong>SCUM 与 SteamCMD：</strong>接管只需要服务端根目录，不需要填写 SteamCMD 目录。Run 可能按本机策略检查 SteamCMD 是否可用，但它不是接管输入。<br /><strong>升级：</strong>接管不会升级游戏；当前平台尚未提供 SCUM 服务端的受控升级任务，不能承诺自动升级。升级能力需要单独的 SteamCMD 更新任务与备份/健康验证流程。</p> : <p><strong>不会做：</strong>不会重新安装、覆盖已有游戏配置，或把受保护路径回显给浏览器。</p>}</section>;
+}
diff --git a/platform_web/pages/ConsolePages.test.tsx b/platform_web/pages/ConsolePages.test.tsx
index 56d7d76..695f0cd 100644
--- a/platform_web/pages/ConsolePages.test.tsx
+++ b/platform_web/pages/ConsolePages.test.tsx
@@ -186,6 +186,12 @@ describe("first-party console pages", () => {
     expect(serverDeploymentWorkflowSource).toContain("全部 4 步通过才算安装成功");
     expect(serverDeploymentWorkflowSource).toContain("已有服务器目录");
     expect(serverDeploymentWorkflowSource).toContain("不会重装或覆盖现有游戏配置");
+    expect(serverDeploymentWorkflowSource).toContain("接管已有服务器执行流程");
+    expect(serverDeploymentWorkflowSource).toContain("不需要填写 SteamCMD 目录");
+    expect(serverDeploymentWorkflowSource).toContain("当前平台尚未提供 SCUM 服务端的受控升级任务");
+    expect(serverDeploymentWorkflowSource).toContain("已绑定服务器编辑时会直接进入相关配置");
+    expect(serverDeploymentWorkflowSource).toContain("可在此调整部署方式；不会重复要求选择已绑定的运行节点");
+    expect(serversPageSource).toContain('onNavigate("serverDetail", { serverId: result.instance.id, routeKey: "run-builder" })');
     expect(serverDeploymentWorkflowSource).toContain("运行连接设置");
     expect(serverDeploymentWorkflowSource).toContain('type={field.sensitive ? "password" : "text"}');
     expect(serversPageSource).toContain("serverCreateRequestFromForm(nextForm)");
diff --git a/platform_web/pages/ServerDetailPage.test.tsx b/platform_web/pages/ServerDetailPage.test.tsx
index 6a2c3e7..a84a2ca 100644
--- a/platform_web/pages/ServerDetailPage.test.tsx
+++ b/platform_web/pages/ServerDetailPage.test.tsx
@@ -75,6 +75,9 @@ describe("ServerDetailPage config write approval", () => {
   });
 
   it("surfaces run distribution and client-manager workflows through platform-mediated APIs", () => {
+    expect(serverDetailPageSource).toContain('params.routeKey !== "run-builder"');
+    expect(serverDetailPageSource).toContain('id="run-builder"');
+    expect(serverDetailPageSource).toContain("scrollIntoView");
     expect(serverDetailPageSource).toContain("getServerRuntimeActions");
     expect(serverDetailPageSource).toContain("generateRunDistribution");
     expect(serverDetailPageSource).toContain("downloadLatestRunDistribution");
diff --git a/platform_web/pages/ServerDetailPage.tsx b/platform_web/pages/ServerDetailPage.tsx
index 8a37b9b..4712f67 100644
--- a/platform_web/pages/ServerDetailPage.tsx
+++ b/platform_web/pages/ServerDetailPage.tsx
@@ -167,6 +167,16 @@ export function ServerDetailPage({ session, params, operations, onNavigate }: Pa
     void refresh();
   }, [refresh]);
 
+  useEffect(() => {
+    if (params.routeKey !== "run-builder" || instance.status !== "ready" || typeof document === "undefined") return;
+    const frame = window.requestAnimationFrame(() => {
+      const target = document.getElementById("run-builder");
+      target?.scrollIntoView({ behavior: "smooth", block: "start" });
+      target?.focus({ preventScroll: true });
+    });
+    return () => window.cancelAnimationFrame(frame);
+  }, [instance.status, params.routeKey]);
+
   const serverOperations = useMemo(
     () => operations.operations.filter((operation) => operation.targetId === serverId || operation.targetId.startsWith(`${serverId}:`)),
     [operations.operations, serverId]
@@ -1007,7 +1017,7 @@ function RuntimeDistributionSection({ instance, runtimeActions, session, operati
   }
 
   return (
-    <article className="console-panel" aria-label="run distribution controls">
+    <article id="run-builder" className="console-panel" aria-label="run distribution controls" tabIndex={-1}>
       <div className="panel-header">
         <h2>
           <PackageOpen size={16} style={{ verticalAlign: "-2px" }} /> 运行分发
diff --git a/platform_web/pages/ServersPage.tsx b/platform_web/pages/ServersPage.tsx
index 89ac899..4733826 100644
--- a/platform_web/pages/ServersPage.tsx
+++ b/platform_web/pages/ServersPage.tsx
@@ -157,10 +157,11 @@ export function ServersPage({ session, operations, onNavigate }: PageComponentPr
     const operationId = operations.begin({ intent: "创建服务器", targetKind: "server", targetId: "platform", requester: session.displayName });
     try {
       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);
+      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);
       await refresh();
+      if (result.job.id) onNavigate("serverDetail", { serverId: result.instance.id, routeKey: "run-builder" });
     } catch (error) {
       operations.fail(operationId, error instanceof Error ? error.message : "创建失败", operationId);
     }
diff --git a/platform_web/routes/routes.test.ts b/platform_web/routes/routes.test.ts
index 412d50e..ed0267a 100644
--- a/platform_web/routes/routes.test.ts
+++ b/platform_web/routes/routes.test.ts
@@ -39,6 +39,8 @@ describe("console shell routes", () => {
     expect(resolved.route.id).toBe("serverDetail");
     expect(resolved.params.serverId).toBe("server-example-1");
     expect(hashForPage("serverDetail", { serverId: "server-example-1" })).toBe("#/servers/server-example-1");
+    expect(hashForPage("serverDetail", { serverId: "server-example-1", routeKey: "run-builder" })).toBe("#/servers/server-example-1?focus=run-builder");
+    expect(resolveRouteHash("#/servers/server-example-1?focus=run-builder", platformAdmin).params).toEqual({ serverId: "server-example-1", routeKey: "run-builder" });
   });
 
   it("round-trips hosted plugin page hashes with server context", () => {
diff --git a/platform_web/routes/routes.ts b/platform_web/routes/routes.ts
index cfab68d..4103248 100644
--- a/platform_web/routes/routes.ts
+++ b/platform_web/routes/routes.ts
@@ -100,7 +100,10 @@ export function routeForPage(pageId: PageId): PageRoute {
 export function hashForPage(pageId: PageId, params: PageParams = {}): string {
   const route = routeForPage(pageId);
   if (pageId === "serverDetail" && params.serverId) {
-    return `#/servers/${encodeURIComponent(params.serverId)}`;
+    const query = new URLSearchParams();
+    if (params.routeKey) query.set("focus", params.routeKey);
+    const suffix = query.toString();
+    return `#/servers/${encodeURIComponent(params.serverId)}${suffix ? `?${suffix}` : ""}`;
   }
   if (pageId === "pluginPage" && params.pluginId && params.routeKey) {
     const query = new URLSearchParams();
@@ -144,7 +147,8 @@ export function resolveRouteHash(hash: string, user?: CurrentUserView): Resolved
     return fallback;
   }
   if (segments[0] === "servers" && segments.length > 1) {
-    return { route: routeForPage("serverDetail"), params: { serverId: decodeURIComponent(segments[1]) } };
+    const routeKey = new URLSearchParams(rawQuery).get("focus") ?? undefined;
+    return { route: routeForPage("serverDetail"), params: { serverId: decodeURIComponent(segments[1]), routeKey } };
   }
   if (segments[0] === "plugin-pages" && segments.length > 2) {
     const serverId = new URLSearchParams(rawQuery).get("serverInstanceId") ?? undefined;