Ship SCUM user SQL management page

2026-08-24 16:43:00 +08:00
parent 3005e0510c
commit d4e3f68032
19 changed files with 351 additions and 115 deletions
@@ -17,6 +17,69 @@ export type PluginGameClientQueueRequest = {
  expiresAt: string;
 };

+export type PluginBridgeExecuteEnvelope = { requestId: string; action: string; payload?: Record<string, string> };
+export type PluginBridgeExecutionResult = { status?: string; result?: Record<string, string>; error?: { message?: string } };
+
+export const playerAttributeCatalog = [
+  { key: "stamina", label: "体力", column: "stamina", sourceKeys: ["attributes.stamina", "stamina", "体力"] },
+  { key: "dexterity", label: "敏捷", column: "dexterity", sourceKeys: ["attributes.dexterity", "dexterity", "敏捷"] },
+  { key: "intelligence", label: "智力", column: "intelligence", sourceKeys: ["attributes.intelligence", "intelligence", "智力"] }
+] as const;
+
+export type PlayerAttributeDraft = { fieldKey: string; label: string; before: string; after: string };
+
+export function playerAttributeDrafts(player: RecordMap): PlayerAttributeDraft[] {
+  return playerAttributeCatalog.map((field) => ({ fieldKey: field.key, label: field.label, before: firstText(player, ...field.sourceKeys), after: firstText(player, ...field.sourceKeys) }));
+}
+
+export function playerAttributeSqlPreview(drafts: PlayerAttributeDraft[]): string {
+  const changes = drafts.filter((draft) => draft.after.trim() && draft.after.trim() !== draft.before.trim());
+  if (!changes.length) return "等待输入要提交的属性变更。";
+  return buildPlayerAttributeSqlText({ gamePlayerId: ":playerId" }, changes.flatMap((draft) => {
+    const definition = playerAttributeCatalog.find((candidate) => candidate.key === draft.fieldKey);
+    const after = Number(draft.after);
+    return definition && Number.isFinite(after) ? [{ column: definition.column, after }] : [];
+  }));
+}
+
+export function buildPlayerAttributeMutation(player: RecordMap, drafts: PlayerAttributeDraft[]): RecordMap {
+  const playerId = firstText(player, "steamId", "gamePlayerId", "playerId", "userProfileId", "id");
+  if (!playerId) throw new Error("用户没有可用的 Steam ID 或游戏用户编号。");
+  const changes = drafts.filter((draft) => draft.after.trim() && draft.after.trim() !== draft.before.trim()).map((draft) => {
+    const definition = playerAttributeCatalog.find((candidate) => candidate.key === draft.fieldKey);
+    const before = draft.before.trim() ? Number(draft.before) : Number.NaN;
+    const after = Number(draft.after);
+    if (!definition || !Number.isFinite(after)) throw new Error(`${draft.label}目标值必须是数字。`);
+    return { fieldKey: draft.fieldKey, label: draft.label, column: definition.column, before: Number.isFinite(before) ? before : null, after };
+  });
+  if (!changes.length) throw new Error("至少填写一项与当前值不同的属性。");
+  const idempotencyKey = safeCommandId(`player-attributes:${playerId}:${changes.map((change) => `${change.fieldKey}:${change.after}`).join(",")}:${Date.now()}`);
+  return { playerId, reason: "管理员在 SCUM 用户管理中编辑属性", sqlText: buildPlayerAttributeSqlText(player, changes), changes, idempotencyKey };
+}
+
+export async function queuePlayerAttributePatch(actions: SCUMWorkspaceActions, player: RecordMap, drafts: PlayerAttributeDraft[]): Promise<unknown> {
+  if (!actions.dispatch) throw new Error("通用 remote.access.request 能力不可用，无法提交 SQL 执行任务。");
+  const mutation = buildPlayerAttributeMutation(player, drafts);
+  const idempotencyKey = textValue(mutation.idempotencyKey);
+  const result = await actions.dispatch({
+    requestId: idempotencyKey,
+    action: "remote.access.request",
+    payload: {
+      capability: "remote.run.db.sqlite.execute",
+      declarationKey: "scum-database",
+      targetKey: "scum-database",
+      idempotencyKey,
+      timeoutSeconds: "60",
+      maxAttempts: "1",
+      "input.mode": "execute",
+      "input.sqlText": textValue(mutation.sqlText),
+      "input.reason": textValue(mutation.reason)
+    }
+  });
+  if (result?.status && !["queued", "ok"].includes(result.status)) throw new Error(result.error?.message || "SQL 执行任务未进入 Run 队列。");
+  return result;
+}
+
 export type SCUMWorkspaceActions = {
  pluginData?: PluginDataActions;
  gameClient?: {
@@ -25,6 +88,7 @@ export type SCUMWorkspaceActions = {
    list: (filter?: { profileKey?: string; state?: string; commandType?: string }) => Promise<unknown>;
    snapshots: (query?: { profileKey?: string; type?: string; streamKey?: string; observedAfter?: string; limit?: number }) => Promise<unknown>;
  };
+  dispatch?: (envelope: PluginBridgeExecuteEnvelope, signal?: AbortSignal) => Promise<PluginBridgeExecutionResult>;
 };

 export type SCUMSurfaceData = {
@@ -80,7 +144,7 @@ type SurfaceKey = keyof SCUMSurfaceData;
 type PageKey = "players" | "squads" | "live-map" | "gifts" | "workflows";

 const pageCollections: Record<PageKey, SurfaceKey[]> = {
-  players: ["players", "members"],
+  players: ["players", "members", "activityEvents", "giftClaims", "pendingGifts", "giftDeliveries"],
  squads: ["squads", "members", "flags"],
  "live-map": ["mapPoints", "mapRegions", "mapSettings", "players", "vehicles", "flags"],
  gifts: ["gifts", "giftClaims", "pendingGifts", "giftDeliveries", "timedGiftEvents", "players"],
@@ -292,6 +356,23 @@ function requirePluginData(actions: SCUMWorkspaceActions): PluginDataActions {
  return actions.pluginData;
 }

+function buildPlayerAttributeSqlText(player: RecordMap, changes: Array<{ column: string; after: number }>): string {
+  const playerId = firstText(player, "gamePlayerId", "playerId", "id");
+  const profileId = firstText(player, "userProfileId", "profileId");
+  const steamId = firstText(player, "steamId", "providerId");
+  const where = playerId && playerId !== ":playerId"
+    ? `id = ${sqlLiteral(playerId)}`
+    : profileId
+      ? `id = (SELECT prisoner_id FROM user_profile WHERE CAST(id AS TEXT) = ${sqlLiteral(profileId)} LIMIT 1)`
+      : steamId
+        ? `id = (SELECT profile.prisoner_id FROM user_profile profile WHERE profile.user_id = ${sqlLiteral(steamId)} LIMIT 1)`
+        : "id = :playerId";
+  return changes.map((change) => `UPDATE prisoner SET ${change.column} = ${sqlNumber(change.after)} WHERE ${where};`).join("\n");
+}
+
+function sqlLiteral(value: string): string { return value === ":playerId" ? value : `'${value.replace(/'/g, "''")}'`; }
+function sqlNumber(value: number): string { return Number.isInteger(value) ? String(value) : String(value); }
+
 function requiredKey(value: RecordMap, key: string, label: string): string {
  const result = textValue(value[key]);
  if (!result) throw new Error(`${label}不能为空。`);