Cyrene_v2/frontend/web/src/admin/modules/channels/GenericAdapterPanel.tsx

import type { AdminChannelRecord } from "../../../lib/types";
import { Notice } from "../../components";
import { Surface, Tag } from "../../../components/primitives";
import { PLATFORM_LABEL } from "../channelFields";
import { adminOpsOf, capabilityMeta, hasCapability } from "./channelCapabilities";

/** Generic per-adapter shell for platforms without a specialised panel (design/17
 *  §2). KOOK gets KookPanel; every other platform renders this honest shell. It
 *  shows the platform label + account, the capabilities the adapter declares
 *  (from `record.accounts[].capabilities`), a placeholder for platform-specific
 *  feature areas (still to be wired), and a proactive-push note. It never
 *  fabricates data, buttons, or friend/channel lists — non-KOOK platforms have no
 *  backend /view endpoint yet, so the page only displays capability + placeholders
 *  + the generic connect/disconnect/log/identity actions rendered above it. */
export function GenericAdapterPanel({
  platform,
  accountId,
  record,
  recordUnknown = false,
}: {
  platform: string;
  accountId?: string;
  record?: AdminChannelRecord;
  /** The channel list could not be read (backend unreachable): capability/account
   *  emptiness is then unverified, so never present it as "declares nothing". */
  recordUnknown?: boolean;
}): React.ReactNode {
  const label = PLATFORM_LABEL[platform] ?? platform;
  const account = record?.accounts?.find((a) =>
    accountId === undefined ? (!a.id || a.id === "default") : a.id === accountId,
  );
  const caps = account?.capabilities ?? [];
  const accountName =
    account?.botNickname ||
    (account?.botUsername ? `@${account.botUsername}` : accountId ?? "default");

  return (
    <div className="space-y-4">
      <div className="flex flex-wrap items-center gap-2">
        <Tag tone="accent">{label} 平台能力</Tag>
        <Tag tone="neutral">{accountName}</Tag>
        {account?.botId ? <Tag tone="neutral">bot_id:{account.botId}</Tag> : null}
        <span className="ml-auto text-xs text-[var(--mu-text-lo)]">通用壳 · 平台专属端点未接入</span>
      </div>

      <CapabilityBadges caps={caps} recordUnknown={recordUnknown} />
      <FeaturePlaceholder caps={caps} recordUnknown={recordUnknown} />
      <ProactiveNote caps={caps} recordUnknown={recordUnknown} />
    </div>
  );
}

/** Capability badges: what this adapter declares it supports. Empty → honest note. */
function CapabilityBadges({ caps, recordUnknown }: { caps: readonly string[]; recordUnknown: boolean }): React.ReactNode {
  return (
    <Surface gap="sm" className="space-y-3">
      <h3 className="text-sm font-semibold">平台能力</h3>
      {caps.length === 0 ? (
        <Notice tone={recordUnknown ? "err" : "neutral"}>
          {recordUnknown
            ? "读取失败（与后端失联），无法确认该适配器声明的能力；请先确认后端在线后重试。"
            : "该适配器尚未声明能力列表；平台专属端点未接入，当前仅提供通用操作（连接 / 断开 / 消息日志 / 身份测试）。"}
        </Notice>
      ) : (
        <div className="flex flex-wrap gap-2">
          {caps.map((c) => {
            const m = capabilityMeta(c);
            return (
              <Tag key={c} tone={m.tone}>
                {m.label}
              </Tag>
            );
          })}
        </div>
      )}
    </Surface>
  );
}

/** Placeholder for future platform-specific feature areas (friends/channels/members/
 *  test-send). Only the admin-operations the adapter actually declares surface here,
 *  each marked as not yet wired. */
function FeaturePlaceholder({ caps, recordUnknown }: { caps: readonly string[]; recordUnknown: boolean }): React.ReactNode {
  const adminOps = adminOpsOf(caps);
  return (
    <Surface gap="sm" className="space-y-3">
      <h3 className="text-sm font-semibold">平台专属功能区（占位）</h3>
      {adminOps.length === 0 ? (
        <Notice tone={recordUnknown ? "err" : "neutral"}>
          {recordUnknown
            ? "读取失败（与后端失联），无法确认该平台的专属功能模块；请先确认后端在线后重试。"
            : "该平台暂无已声明的专属功能模块。频道 / 成员 / 发送测试等平台能力将随后续接入后在此显示。"}
        </Notice>
      ) : (
        <>
          <div className="flex flex-wrap gap-2">
            {adminOps.map((op) => (
              <Tag key={op} tone={capabilityMeta(op).tone}>
                {capabilityMeta(op).label} · 后续接入
              </Tag>
            ))}
          </div>
          <Notice tone="warn">以上模块为占位展示，对应后端专属端点尚未接入，当前不提供真实数据 / 操作。</Notice>
        </>
      )}
    </Surface>
  );
}

/** Proactive-push note: declared → placeholder; otherwise an honest "not supported". */
function ProactiveNote({ caps, recordUnknown }: { caps: readonly string[]; recordUnknown: boolean }): React.ReactNode {
  const supported = hasCapability(caps, "Proactive");
  return (
    <Surface gap="sm" className="space-y-3">
      <h3 className="text-sm font-semibold">主动推送</h3>
      {supported ? (
        <Notice tone="warn">主动推送（占位，后端待接）：该适配器声明了主动推送能力，定时 / 主动消息功能待后端接入。</Notice>
      ) : recordUnknown ? (
        <Notice tone="err">读取失败（与后端失联），无法确认该适配器是否支持主动推送；请先确认后端在线后重试。</Notice>
      ) : (
        <Notice>当前适配器未声明主动推送能力（Proactive），不支持主动 / 定时消息；仅在被对话触发时响应。</Notice>
      )}
    </Surface>
  );
}