refactor(channels): make built-in channels self-contained (#4908)

* refactor(channels): own setup and instance contracts

* refactor(channels): isolate management contracts

* refactor(channels): normalize activation contracts

* fix(channels): enforce management contracts

* refactor(channels): finish setup ownership migration

* fix(channels): harden management contracts

* fix(channels): enforce lazy loading and runtime ownership

* fix(feishu): make multi-instance startup idempotent

* fix(webui): render channel setup contracts cleanly

* fix(feishu): stop websocket clients cleanly

* fix(channels): enforce persistence and activation gates

* fix(channels): preserve global feature action scope

* fix(channels): apply defaults for single plugins

* fix(channels): enforce management contract boundaries

* refactor(feishu): remove identity helper indirection

* fix(channels): preserve management setup contracts

* refactor(channels): generalize instance settings UI

* refactor(channels): package channel plugins with web UI metadata

* refactor(channels): make built-ins self-contained packages

* test(channels): colocate tests with channel packages

* fix(dingtalk): use official brand icon

* feat(channels): colocate webui translations

* docs(channels): clarify plugin ownership

* test(exec): remove output wait race

* refactor(channels): unify plugin descriptors

* fix(channels): enforce descriptor-owned contracts

* refactor(channels): finish package-owned plugin setup

* refactor(channels): use repository-owned packages only

* fix(channels): self-describe dependencies and runtime state

* fix(channels): warn about legacy entry points

webui/src/components/settings/channels/ChannelQrConnectFlow.tsx

@@ -26,25 +26,29 @@ export type ChannelQrConnectLabels = {
   connect: string;
 };
 
+export type ChannelConnectStartOptions = {
+  domain?: string;
+  instanceId?: string;
+  mode?: "replace" | "create";
+  force?: boolean;
+};
+
 export function ChannelQrConnectFlow({
   token,
   channelName,
   startOptions = {},
   idleLabel,
   connectRequestId,
+  forceOnRepeat = false,
   labels,
   onFeaturesUpdate,
 }: {
   token: string;
-  channelName: "feishu" | "weixin";
-  startOptions?: {
-    domain?: "feishu" | "lark";
-    instanceId?: string;
-    mode?: "replace" | "create";
-    force?: boolean;
-  };
+  channelName: string;
+  startOptions?: ChannelConnectStartOptions;
   idleLabel?: string;
   connectRequestId?: number;
+  forceOnRepeat?: boolean;
   labels: ChannelQrConnectLabels;
   onFeaturesUpdate: (payload: NanobotFeaturesPayload) => void;
 }) {
@@ -232,7 +236,7 @@ export function ChannelQrConnectFlow({
           size="sm"
           variant="outline"
           className="h-8 rounded-full border-border/65 bg-background/80 px-3 text-[12px] font-semibold hover:bg-muted/70"
-          onClick={() => void start(channelName === "weixin" && succeeded)}
+          onClick={() => void start(forceOnRepeat && succeeded)}
           disabled={!canStart}
         >
           {busy ? (
@@ -252,83 +256,3 @@ export function ChannelQrConnectFlow({
     </div>
   );
 }
-export function FeishuConnectFlow({
-  token,
-  instanceId = "default",
-  mode = "replace",
-  idleLabel,
-  connectRequestId,
-  onFeaturesUpdate,
-}: {
-  token: string;
-  instanceId?: string;
-  mode?: "replace" | "create";
-  idleLabel?: string;
-  connectRequestId?: number;
-  onFeaturesUpdate: (payload: NanobotFeaturesPayload) => void;
-}) {
-  const { t } = useTranslation();
-  const tx = (key: string, fallback: string) => t(key, { defaultValue: fallback });
-  return (
-    <ChannelQrConnectFlow
-      token={token}
-      channelName="feishu"
-      startOptions={{ domain: "feishu", instanceId, mode }}
-      idleLabel={idleLabel}
-      connectRequestId={connectRequestId}
-      onFeaturesUpdate={onFeaturesUpdate}
-      labels={{
-        qrAlt: tx("settings.channels.feishuQrAlt", "Feishu connection QR code"),
-        scanTitle: tx("settings.channels.feishuScanTitle", "Scan with Feishu"),
-        scanDescription: tx(
-          "settings.channels.feishuScanDescription",
-          "Use Feishu or Lark on your phone to scan this code. nanobot will finish setup automatically after authorization.",
-        ),
-        waiting: tx("settings.channels.feishuWaiting", "Waiting for authorization..."),
-        connected: tx("settings.channels.feishuConnected", "Feishu is connected."),
-        stopped: tx("settings.channels.feishuConnectStopped", "Connection stopped."),
-        connecting: tx("settings.channels.feishuConnecting", "Connecting..."),
-        scanAgain: tx("settings.channels.scanAgain", "Scan again"),
-        connect: tx("settings.channels.connect", "Connect"),
-      }}
-    />
-  );
-}
-
-export function WeixinConnectFlow({
-  token,
-  idleLabel,
-  connectRequestId,
-  onFeaturesUpdate,
-}: {
-  token: string;
-  idleLabel?: string;
-  connectRequestId?: number;
-  onFeaturesUpdate: (payload: NanobotFeaturesPayload) => void;
-}) {
-  const { t } = useTranslation();
-  const tx = (key: string, fallback: string) => t(key, { defaultValue: fallback });
-  return (
-    <ChannelQrConnectFlow
-      token={token}
-      channelName="weixin"
-      idleLabel={idleLabel}
-      connectRequestId={connectRequestId}
-      onFeaturesUpdate={onFeaturesUpdate}
-      labels={{
-        qrAlt: tx("settings.channels.weixinQrAlt", "WeChat login QR code"),
-        scanTitle: tx("settings.channels.weixinScanTitle", "Scan with WeChat"),
-        scanDescription: tx(
-          "settings.channels.weixinScanDescription",
-          "Use WeChat on your phone to scan this code. nanobot saves the account state locally after login.",
-        ),
-        waiting: tx("settings.channels.weixinWaiting", "Waiting for WeChat scan..."),
-        connected: tx("settings.channels.weixinConnected", "WeChat is connected."),
-        stopped: tx("settings.channels.weixinConnectStopped", "WeChat login stopped."),
-        connecting: tx("settings.channels.weixinConnecting", "Connecting..."),
-        scanAgain: tx("settings.channels.scanAgain", "Scan again"),
-        connect: tx("settings.channels.connect", "Connect"),
-      }}
-    />
-  );
-}