Remove manual runtime controls from server detail

plugins/examples/dev-game-plugin/page-bundle/index.ts

@@ -0,0 +1,45 @@
+export const pluginPageBundle = { key: "dev-game-plugin", version: "1.0.0", integritySha256: "sha256:1111111111111111111111111111111111111111111111111111111111111111" };
+
+type ReactLike = { createElement: (...args: any[]) => any };
+
+export function renderPluginPage(react: ReactLike, input: any) {
+  const e = react.createElement;
+  const pageKey = input.page?.key ?? "overview";
+  if (pageKey === "config") return renderConfigPage(e, input);
+  if (pageKey === "logs") return renderLogsPage(e, input);
+  return renderOverviewPage(e, input);
+}
+
+function renderOverviewPage(e: ReactLike["createElement"], input: any) {
+  return renderPanel(e, "插件概览", "Example 插件声明的服务器概览页面。", input, [
+    ["服务器", input.context?.serverInstanceId ?? "未绑定"],
+    ["桥接动作", (input.context?.bridgeActions ?? []).join(" / ") || "未声明"],
+    ["页面来源", "dev-game-plugin 页面 bundle"]
+  ]);
+}
+
+function renderConfigPage(e: ReactLike["createElement"], input: any) {
+  return renderPanel(e, "配置工作台", "配置入口由插件页面声明，平台只提供受控上下文。", input, [
+    ["文件权限", (input.context?.permissions ?? []).filter((value: string) => value.includes("files")).join(" / ") || "未声明"],
+    ["AI 能力", (input.context?.permissions ?? []).includes("ai.invoke") ? "可请求平台 AI" : "未声明"],
+    ["写入策略", "平台审查后派发"]
+  ]);
+}
+
+function renderLogsPage(e: ReactLike["createElement"], input: any) {
+  return renderPanel(e, "日志视图", "日志入口由插件声明并通过平台日志通道读取。", input, [
+    ["日志权限", (input.context?.permissions ?? []).includes("server.logs.read") ? "可读" : "未声明"],
+    ["Companion", input.availability?.available ? "可用" : input.availability?.reason ?? "等待运行端"],
+    ["桥接", (input.context?.bridgeActions ?? []).includes("logs.query") ? "logs.query" : "未声明"]
+  ]);
+}
+
+function renderPanel(e: ReactLike["createElement"], title: string, summary: string, input: any, rows: Array<[string, string]>) {
+  return e("section", { className: "console-panel", "aria-label": title },
+    e("div", { className: "panel-header" },
+      e("div", null, e("h2", null, title), e("p", { className: "provider-id" }, summary)),
+      e("span", { className: "page-status" }, input.context?.serverInstanceId ? "已绑定服务器" : "未绑定服务器")
+    ),
+    e("div", { className: "console-row-list" }, rows.map(([label, value]) => e("div", { key: label, className: "console-row" }, e("span", null, label), e("strong", null, value))))
+  );
+}

plugins/examples/minecraft-server-plugin/manifest.json

@@ -114,55 +114,61 @@
   },
   "pages": [
     {
-      "key": "overview",
-      "title": "MC 概览",
-      "path": "/overview",
+      "key": "files",
+      "title": "文件管理",
+      "path": "/files",
       "bundleKey": "minecraft-server-plugin",
       "bundleVersion": "1.0.0",
       "bundleIntegritySha256": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
       "permissions": [
         "server.read",
-        "server.lifecycle"
-      ],
-      "bridgeActions": [
-        "server.instances.read",
-        "jobs.dispatch"
-      ]
-    },
-    {
-      "key": "remote",
-      "title": "MC 远程",
-      "path": "/remote",
-      "bundleKey": "minecraft-server-plugin",
-      "bundleVersion": "1.0.0",
-      "bundleIntegritySha256": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
-      "permissions": [
-        "server.remote.access",
         "server.files.read",
         "server.files.write",
         "server.logs.read"
       ],
       "bridgeActions": [
-        "remote.access.request",
+        "server.instances.read",
         "files.request",
         "logs.query"
       ]
     },
     {
-      "key": "rcon",
-      "title": "MC RCON",
-      "path": "/rcon",
+      "key": "mods-market",
+      "title": "mod/插件市场",
+      "path": "/mods-market",
       "bundleKey": "minecraft-server-plugin",
       "bundleVersion": "1.0.0",
       "bundleIntegritySha256": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
       "permissions": [
-        "server.remote.access"
+        "server.read",
+        "server.artifacts.read",
+        "server.files.read"
       ],
       "bridgeActions": [
-        "remote.access.request"
+        "server.instances.read",
+        "artifacts.open"
       ]
     }
   ],
+  "fileWorkspace": {
+    "defaultDirectoryKey": "minecraft-config",
+    "directories": [
+      { "key": "minecraft-config", "label": "服务器配置", "scope": "config" },
+      { "key": "minecraft-logs", "label": "日志文件", "scope": "logs" }
+    ],
+    "files": [
+      { "key": "server-properties", "directoryKey": "minecraft-config", "label": "server.properties", "kind": "config", "editable": true },
+      { "key": "ops-json", "directoryKey": "minecraft-config", "label": "ops.json", "kind": "config", "editable": true },
+      { "key": "whitelist-json", "directoryKey": "minecraft-config", "label": "whitelist.json", "kind": "config", "editable": true },
+      { "key": "minecraft-latest-log", "directoryKey": "minecraft-logs", "label": "latest.log", "kind": "log", "streamKey": "minecraft.latest" }
+    ],
+    "configFields": [
+      { "key": "motd", "fileKey": "server-properties", "configKey": "motd", "label": "服务器名称", "description": "显示在 Minecraft 服务器列表中的 MOTD。", "control": "text", "defaultValue": "Minecraft Server", "restartImpact": "restart-required" },
+      { "key": "server-port", "fileKey": "server-properties", "configKey": "server-port", "label": "游戏端口", "description": "Minecraft Java 客户端连接端口。", "control": "port", "minimum": 1, "maximum": 65535, "defaultValue": "25565", "restartImpact": "restart-required" },
+      { "key": "max-players", "fileKey": "server-properties", "configKey": "max-players", "label": "最大玩家数", "description": "允许同时进入服务器的玩家上限。", "control": "number", "minimum": 1, "maximum": 200, "defaultValue": "20", "restartImpact": "restart-required" },
+      { "key": "online-mode", "fileKey": "server-properties", "configKey": "online-mode", "label": "正版验证", "description": "是否启用 Mojang 在线身份验证。", "control": "boolean", "defaultValue": "true", "restartImpact": "restart-required" }
+    ]
+  },
   "ai": {
     "purposes": [
       "config.suggest",

plugins/examples/minecraft-server-plugin/page-bundle/index.ts

@@ -0,0 +1,38 @@
+export const pluginPageBundle = { key: "minecraft-server-plugin", version: "1.0.0", integritySha256: "sha256:2222222222222222222222222222222222222222222222222222222222222222" };
+
+type ReactLike = { createElement: (...args: any[]) => any };
+
+export function renderPluginPage(react: ReactLike, input: any) {
+  const e = react.createElement;
+  const pageKey = input.page?.key ?? "files";
+  const workspace = input.workspace;
+  if (pageKey === "mods-market") return renderModsMarket(e, input);
+  return renderFiles(e, input, workspace);
+}
+
+function renderFiles(e: ReactLike["createElement"], input: any, workspace: any) {
+  const files = workspace?.files ?? [];
+  return e("section", { className: "console-panel", "aria-label": "Minecraft 文件管理" },
+    e("div", { className: "panel-header" },
+      e("div", null, e("h2", null, "文件管理"), e("p", { className: "provider-id" }, "server.properties、白名单、OP 列表和日志由 Minecraft 插件声明。")),
+      e("span", { className: "page-status" }, input.context?.serverInstanceId ? "已绑定服务器" : "未绑定服务器")
+    ),
+    e("div", { className: "console-row-list" },
+      files.length ? files.map((file: any) => e("div", { key: file.key, className: "console-row" }, e("span", null, file.label), e("strong", null, file.kind === "config" ? file.editable === false ? "配置只读" : "配置可写" : "日志只读"))) : e("div", { className: "console-row" }, e("span", null, "声明文件"), e("strong", null, "等待插件工作区"))
+    )
+  );
+}
+
+function renderModsMarket(e: ReactLike["createElement"], input: any) {
+  return e("section", { className: "console-panel", "aria-label": "Minecraft mod 插件市场" },
+    e("div", { className: "panel-header" },
+      e("div", null, e("h2", null, "mod/插件市场"), e("p", { className: "provider-id" }, "Minecraft 插件拥有自己的 mod/插件入口；平台只提供安全托管上下文。")),
+      e("span", { className: "page-status" }, input.availability?.available ? "运行端可用" : input.availability?.reason ?? "等待运行端")
+    ),
+    e("div", { className: "console-row-list" },
+      e("div", { className: "console-row" }, e("span", null, "服务器"), e("strong", null, input.context?.serverInstanceId ?? "未绑定")),
+      e("div", { className: "console-row" }, e("span", null, "权限"), e("strong", null, (input.context?.permissions ?? []).join(" / ") || "未声明")),
+      e("div", { className: "console-row" }, e("span", null, "安装策略"), e("strong", null, "由 Minecraft 插件声明和审核"))
+    )
+  );
+}

plugins/examples/scum-server-plugin/features/page.ts

@@ -22,6 +22,8 @@ export type SCUMFileReadSnapshot = {
 };
 
 export type SCUMPageContext = {
+  pageKey?: string;
+  pageTitle?: string;
   serverInstanceId?: string;
   permissions: string[];
   availability: { available: boolean; reason?: string };
@@ -45,6 +47,7 @@ type DiffLine = { kind: "same" | "added" | "removed"; text: string };
 
 export function renderSCUMFeaturePage(react: ReactLike, input: SCUMPageContext) {
   const e = react.createElement;
+  if (input.pageKey && input.pageKey !== "files-config") return renderSCUMFeatureSurface(e, input);
   const workspace = normalizeWorkspace(input.workspace);
   const [selectedDirectoryKey, setSelectedDirectoryKey] = usePluginState(react, workspace.defaultDirectoryKey);
   const effectiveDirectoryKey = workspace.directories.some((directory) => directory.key === selectedDirectoryKey) ? selectedDirectoryKey : workspace.defaultDirectoryKey;
@@ -199,6 +202,34 @@ export function renderSCUMFeaturePage(react: ReactLike, input: SCUMPageContext)
   );
 }
 
+function renderSCUMFeatureSurface(e: ReactLike["createElement"], input: SCUMPageContext) {
+  const meta = scumSurfaceMeta(input.pageKey ?? "");
+  const featureRows = (input.featureAvailability ?? [])
+    .filter((feature) => meta.features.includes(feature.key))
+    .map((feature) => e("div", { key: feature.key, className: "console-row" }, e("span", null, feature.key), e("strong", null, feature.available ? "可用" : feature.reason ?? "等待 Companion")));
+  return e("section", { className: "console-panel", "aria-label": input.pageTitle ?? meta.title },
+    e("div", { className: "panel-header" },
+      e("div", null, e("h2", null, input.pageTitle ?? meta.title), e("p", { className: "provider-id" }, meta.summary)),
+      e("span", { className: "page-status" }, input.availability.available ? "Companion 在线" : input.availability.reason ?? "等待 Companion")
+    ),
+    e("div", { className: "console-row-list" },
+      e("div", { className: "console-row" }, e("span", null, "服务器"), e("strong", null, input.serverInstanceId ?? "未绑定")),
+      e("div", { className: "console-row" }, e("span", null, "权限"), e("strong", null, input.permissions.join(" / ") || "未声明")),
+      featureRows.length ? featureRows : e("div", { className: "console-row" }, e("span", null, "插件能力"), e("strong", null, meta.features.join(" / ") || "由插件声明"))
+    )
+  );
+}
+
+function scumSurfaceMeta(pageKey: string): { title: string; summary: string; features: string[] } {
+  switch (pageKey) {
+    case "players": return { title: "用户管理", summary: "玩家查询、在线状态、维护窗口和状态修正由 SCUM 插件 Companion 提供。", features: ["player.intelligence", "state.patch"] };
+    case "squads": return { title: "队伍管理", summary: "队伍列表、成员关系和风险上下文来自插件声明的 squads 快照。", features: ["player.intelligence"] };
+    case "live-map": return { title: "实时地图", summary: "玩家、载具和轨迹采样由插件事件流驱动。", features: ["trajectory.collect", "vehicle.spawn"] };
+    case "gifts": return { title: "礼包管理", summary: "礼包目录、发放和玩家通知通过受保护插件命令执行。", features: ["reward.delivery"] };
+    default: return { title: "SCUM 插件页面", summary: "该页面由 SCUM 插件声明。", features: [] };
+  }
+}
+
 function navigationPane(e: ReactLike["createElement"], workspace: NormalizedWorkspace, directoryKey: string, directoryFiles: readonly SCUMLogicalFile[], selectedFileKey: string | undefined, refreshState: WorkspaceRefreshState, canRefreshWorkspace: boolean, onDirectoryChange: (directoryKey: string) => void, onFileSelect: (file: SCUMLogicalFile) => void, onRefreshWorkspace: () => void) {
   const activeDirectory = workspace.directories.find((directory) => directory.key === directoryKey);
   const selectedFile = directoryFiles.find((file) => file.key === selectedFileKey) ?? directoryFiles[0];

plugins/examples/scum-server-plugin/manifest.json

@@ -373,7 +373,13 @@
     "dependencyPolicy": "required",
     "approvalRequired": ["disable", "rollback", "retire"]
   },
-  "pages": [{ "key": "files-config", "title": "文件管理", "path": "/files-config", "bundleKey": "scum-server-plugin", "bundleVersion": "1.0.3", "bundleIntegritySha256": "sha256:797c4e303c102f0316e71e4e5bda50a6ca96506a7cb368a42ecf858b236609b2", "permissions": ["server.read", "server.files.read", "server.files.write", "server.logs.read"], "bridgeActions": ["server.instances.read", "files.request", "logs.query"], "featureKeys": ["config.manage"] }],
+  "pages": [
+    { "key": "files-config", "title": "文件管理", "path": "/files-config", "bundleKey": "scum-server-plugin", "bundleVersion": "1.0.3", "bundleIntegritySha256": "sha256:797c4e303c102f0316e71e4e5bda50a6ca96506a7cb368a42ecf858b236609b2", "permissions": ["server.read", "server.files.read", "server.files.write", "server.logs.read"], "bridgeActions": ["server.instances.read", "files.request", "logs.query"], "featureKeys": ["config.manage"] },
+    { "key": "players", "title": "用户管理", "path": "/players", "bundleKey": "scum-server-plugin", "bundleVersion": "1.0.3", "bundleIntegritySha256": "sha256:797c4e303c102f0316e71e4e5bda50a6ca96506a7cb368a42ecf858b236609b2", "permissions": ["server.read", "server.game-client.read", "server.game-client.command"], "bridgeActions": ["server.instances.read"], "featureKeys": ["player.intelligence", "state.patch"] },
+    { "key": "squads", "title": "队伍管理", "path": "/squads", "bundleKey": "scum-server-plugin", "bundleVersion": "1.0.3", "bundleIntegritySha256": "sha256:797c4e303c102f0316e71e4e5bda50a6ca96506a7cb368a42ecf858b236609b2", "permissions": ["server.read", "server.game-client.read"], "bridgeActions": ["server.instances.read"], "featureKeys": ["player.intelligence"] },
+    { "key": "live-map", "title": "实时地图", "path": "/live-map", "bundleKey": "scum-server-plugin", "bundleVersion": "1.0.3", "bundleIntegritySha256": "sha256:797c4e303c102f0316e71e4e5bda50a6ca96506a7cb368a42ecf858b236609b2", "permissions": ["server.read", "server.game-client.read"], "bridgeActions": ["server.instances.read"], "featureKeys": ["trajectory.collect"] },
+    { "key": "gifts", "title": "礼包管理", "path": "/gifts", "bundleKey": "scum-server-plugin", "bundleVersion": "1.0.3", "bundleIntegritySha256": "sha256:797c4e303c102f0316e71e4e5bda50a6ca96506a7cb368a42ecf858b236609b2", "permissions": ["server.read", "server.game-client.read", "server.game-client.command"], "bridgeActions": ["server.instances.read"], "featureKeys": ["reward.delivery"] }
+  ],
   "fileWorkspace": {
     "defaultDirectoryKey": "scum-config",
     "directories": [{ "key": "scum-config", "label": "服务器配置", "scope": "config" }, { "key": "scum-logs", "label": "日志文件", "scope": "logs" }],

plugins/examples/scum-server-plugin/page-bundle/index.ts

@@ -3,4 +3,4 @@ import type { SCUMFeatureWorkspace } from "../features/contracts.js";
 
 export const pluginPageBundle = { key: "scum-server-plugin", version: "1.0.3", integritySha256: "sha256:797c4e303c102f0316e71e4e5bda50a6ca96506a7cb368a42ecf858b236609b2" };
 
-export function renderPluginPage(react: any, input: any) { return renderSCUMFeaturePage(react, { serverInstanceId: input.context.serverInstanceId, permissions: input.context.permissions, availability: input.availability, featureAvailability: input.availability.features, workspace: input.workspace as SCUMFeatureWorkspace | undefined, workspaceActions: input.workspaceActions }); }
+export function renderPluginPage(react: any, input: any) { return renderSCUMFeaturePage(react, { pageKey: input.page?.key ?? "files-config", pageTitle: input.page?.title ?? "文件管理", serverInstanceId: input.context.serverInstanceId, permissions: input.context.permissions, availability: input.availability, featureAvailability: input.availability.features, workspace: input.workspace as SCUMFeatureWorkspace | undefined, workspaceActions: input.workspaceActions }); }