@wenbin_wb/dsh-bridge 1.2.4 → 2.0.0

package/client/index.js

@@ -31,7 +31,7 @@ const s = {
   muted:    { color: 'var(--dsw-alias-label-tertiary,#8b93a1)', fontSize: 12, lineHeight: 1.5 },
   label:    { color: 'var(--dsw-alias-label-primary,currentColor)', fontSize: 13, fontWeight: 500 },
   code:     { fontFamily: 'ui-monospace,Menlo,monospace', fontSize: 12, wordBreak: 'break-all', color: 'var(--dsw-alias-label-primary,currentColor)' },
-  btnPri:   { font: 'inherit', cursor: 'pointer', border: 'none', background: 'var(--dsw-alias-button-primary-fill,var(--dsw-alias-brand-primary,#4f6ef7))', color: 'var(--dsw-alias-button-primary-label,#fff)', height: 32, padding: '0 14px', borderRadius: 999, fontSize: 13, fontWeight: 500, display: 'inline-flex', alignItems: 'center', gap: 4 },
+  btnPri:   { font: 'inherit', cursor: 'pointer', border: 'none', background: 'var(--dsw-alias-brand-primary,#4f6ef7)', color: 'var(--dsw-alias-label-primary-foreground,#fff)', height: 32, padding: '0 14px', borderRadius: 999, fontSize: 13, fontWeight: 500, display: 'inline-flex', alignItems: 'center', gap: 4 },
   btnGhost: { font: 'inherit', cursor: 'pointer', border: '1px solid var(--dsw-alias-border-l2,#d1d5db)', background: 'var(--dsw-alias-bg-layer-1,transparent)', color: 'var(--dsw-alias-label-primary,currentColor)', height: 32, padding: '0 14px', borderRadius: 999, fontSize: 13, display: 'inline-flex', alignItems: 'center', gap: 4, textDecoration: 'none' },
   btnLink:  { font: 'inherit', cursor: 'pointer', border: 'none', background: 'none', color: 'var(--dsw-alias-brand-primary,#4f6ef7)', fontSize: 12, padding: 0, display: 'inline-flex', alignItems: 'center', gap: 3, textDecoration: 'none' },
   qr:       { width: 200, height: 200, borderRadius: 10, border: '1px solid var(--dsw-alias-border-l2,#e5e7eb)', margin: '8px 0', display: 'block' },
@@ -213,10 +213,10 @@ const TunnelCard = React.memo(function TunnelCard({ title, desc, data, onStart,
   );
 });
 
-// ---- 微信 Bot 卡片 ----
+// ---- 通用 IM 平台卡片 ----
 
-function WechatCard({ rpcCall, onStatusChange }) {
-  const [wx, setWx] = React.useState(null);
+function PlatformCard({ platformId, platformName, platformDesc, rpcCall, onStatusChange }) {
+  const [platform, setPlatform] = React.useState(null);
   const [err, setErr] = React.useState(null);
   const [busy, setBusy] = React.useState(false);
   const [showAdvanced, setShowAdvanced] = React.useState(false);
@@ -225,48 +225,50 @@ function WechatCard({ rpcCall, onStatusChange }) {
   // 高级设置本地草稿
   const [cfgDraft, setCfgDraft] = React.useState(null);
   React.useEffect(() => {
-    if (wx?.config && !cfgDraft) {
+    if (platform?.config && !cfgDraft) {
       setCfgDraft({
-        digestIntervalSec:  String(wx.config.digestIntervalSec  ?? 300),
-        approvalTimeoutSec: String(wx.config.approvalTimeoutSec ?? 600),
-        maxMessageChars:    String(wx.config.maxMessageChars    ?? 2000),
-        sendChunkDelayMs:   String(wx.config.sendChunkDelayMs   ?? 1500),
+        digestIntervalSec:  String(platform.config.digestIntervalSec  ?? 300),
+        approvalTimeoutSec: String(platform.config.approvalTimeoutSec ?? 600),
+        maxMessageChars:    String(platform.config.maxMessageChars    ?? 2000),
+        sendChunkDelayMs:   String(platform.config.sendChunkDelayMs   ?? 1500),
       });
     }
-  }, [wx?.config]);
+  }, [platform?.config]);
 
   // 向上传递连接状态（供平台列表卡片绿点使用）
   React.useEffect(() => {
-    const connected = wx?.status === 'connected' || wx?.status === 'starting' || wx?.status === 'reconnecting';
+    const connected = platform?.status === 'connected' || platform?.status === 'starting' || platform?.status === 'reconnecting';
     onStatusChange?.(connected);
-  }, [wx?.status, onStatusChange]);
+  }, [platform?.status, onStatusChange]);
 
   const load = React.useCallback(async (quiet = false) => {
     try {
-      const r = await rpcCall(BRIDGE_ENDPOINTS.wechatGetStatus, {});
+      // 用通用端点读取平台状态（不执行登录操作，只获取状态）
+      const r = await rpcCall(BRIDGE_ENDPOINTS.listPlatforms, {});
       if (!r?.ok) throw new Error(r?.error?.message ?? 'RPC failed');
-      setWx(r.value);
+      const allPlatforms = r.value ?? {};
+      setPlatform(allPlatforms[platformId] ?? null);
       if (!quiet) setErr(null);
     } catch (e) {
       if (!quiet) setErr(e.message);
     }
-  }, [rpcCall]);
+  }, [rpcCall, platformId]);
 
   // 轮询：登录中（qr/scaned）快速刷新，其余放慢
   React.useEffect(() => {
     load();
-    const activeLogin = wx?.login && (wx.login.phase === 'qr' || wx.login.phase === 'scaned');
+    const activeLogin = platform?.login && (platform.login.phase === 'qr' || platform.login.phase === 'scaned');
     const interval = activeLogin ? 1500 : 3000;
     const t = setInterval(() => load(true), interval);
     return () => clearInterval(t);
-  }, [load, wx?.login?.phase]);
+  }, [load, platform?.login?.phase]);
 
   const act = React.useCallback(async (endpoint, payload) => {
     setBusy(true);
     try {
-      const r = await rpcCall(endpoint, payload ?? {});
+      const r = await rpcCall(endpoint, { platformId, ...payload });
       if (!r?.ok) throw new Error(r?.error?.message ?? 'RPC failed');
-      setWx(r.value);
+      setPlatform(r.value);
       setErr(null);
       await load(true);
     } catch (e) {
@@ -274,74 +276,72 @@ function WechatCard({ rpcCall, onStatusChange }) {
     } finally {
       setBusy(false);
     }
-  }, [rpcCall, load]);
+  }, [rpcCall, load, platformId]);
 
-  const onLogin = React.useCallback(() => act(BRIDGE_ENDPOINTS.wechatLogin, {}), [act]);
-  const onStop  = React.useCallback(() => act(BRIDGE_ENDPOINTS.wechatStop, {}), [act]);
+  const onLogin = React.useCallback(() => act(BRIDGE_ENDPOINTS.platformLogin, {}), [act]);
+  const onStop  = React.useCallback(() => act(BRIDGE_ENDPOINTS.platformStop, {}), [act]);
 
   // 白名单管理
   const [newId, setNewId] = React.useState('');
   const addAllow = React.useCallback(async () => {
     const id = newId.trim();
     if (!id) return;
-    const list = [...(wx?.allowFrom ?? []), id];
-    await act(BRIDGE_ENDPOINTS.wechatSetAllowFrom, { allowFrom: list });
+    const list = [...(platform?.allowFrom ?? []), id];
+    await act(BRIDGE_ENDPOINTS.platformSetAllowFrom, { allowFrom: list });
     setNewId('');
-  }, [act, newId, wx?.allowFrom]);
+  }, [act, newId, platform?.allowFrom]);
   const removeAllow = React.useCallback(async (id) => {
-    const list = (wx?.allowFrom ?? []).filter((x) => x !== id);
-    await act(BRIDGE_ENDPOINTS.wechatSetAllowFrom, { allowFrom: list });
-  }, [act, wx?.allowFrom]);
+    const list = (platform?.allowFrom ?? []).filter((x) => x !== id);
+    await act(BRIDGE_ENDPOINTS.platformSetAllowFrom, { allowFrom: list });
+  }, [act, platform?.allowFrom]);
   const handleNewId = React.useCallback((e) => setNewId(e.target.value), []);
 
   // 高级设置保存
   const saveConfig = React.useCallback(async () => {
     if (!cfgDraft) return;
-    await act(BRIDGE_ENDPOINTS.wechatSetConfig, {
+    await act(BRIDGE_ENDPOINTS.platformSetConfig, {
       digestIntervalSec:  Number(cfgDraft.digestIntervalSec),
       approvalTimeoutSec: Number(cfgDraft.approvalTimeoutSec),
       maxMessageChars:    Number(cfgDraft.maxMessageChars),
       sendChunkDelayMs:   Number(cfgDraft.sendChunkDelayMs),
     });
   }, [act, cfgDraft]);
-  const cfgDirty = cfgDraft && wx?.config && (
-    Number(cfgDraft.digestIntervalSec)  !== wx.config.digestIntervalSec  ||
-    Number(cfgDraft.approvalTimeoutSec) !== wx.config.approvalTimeoutSec ||
-    Number(cfgDraft.maxMessageChars)    !== wx.config.maxMessageChars    ||
-    Number(cfgDraft.sendChunkDelayMs)   !== wx.config.sendChunkDelayMs
+  const cfgDirty = cfgDraft && platform?.config && (
+    Number(cfgDraft.digestIntervalSec)  !== platform.config.digestIntervalSec  ||
+    Number(cfgDraft.approvalTimeoutSec) !== platform.config.approvalTimeoutSec ||
+    Number(cfgDraft.maxMessageChars)    !== platform.config.maxMessageChars    ||
+    Number(cfgDraft.sendChunkDelayMs)   !== platform.config.sendChunkDelayMs
   );
 
-  if (!wx && !err) {
+  if (!platform && !err) {
     return React.createElement('div', { style: s.card },
-      React.createElement('div', { style: s.label }, '微信 Bot'),
+      React.createElement('div', { style: s.label }, platformName),
       React.createElement('div', { style: { ...s.muted, marginTop: 6 } }, '加载中…'),
     );
   }
 
-  const connected = wx?.status === 'connected' || wx?.status === 'starting';
-  const login = wx?.login ?? {};
+  const connected = platform?.status === 'connected' || platform?.status === 'starting';
+  const login = platform?.login ?? {};
   const showQr = login.phase === 'qr' || login.phase === 'scaned';
-  const statusLabel = wx?.status === 'connected' ? '已连接'
-    : wx?.status === 'starting' ? '连接中…'
-    : wx?.status === 'reconnecting' ? '重连中…'
-    : wx?.status === 'paused' ? '暂停（会话过期）'
-    : wx?.status === 'error' ? '错误'
+  const statusLabel = platform?.status === 'connected' ? '已连接'
+    : platform?.status === 'starting' ? '连接中…'
+    : platform?.status === 'reconnecting' ? '重连中…'
+    : platform?.status === 'paused' ? '暂停（会话过期）'
+    : platform?.status === 'error' ? '错误'
     : '未连接';
 
   return React.createElement('div', { style: s.card },
     React.createElement('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' } },
       React.createElement('div', null,
-        React.createElement('div', { style: s.label }, '微信 Bot'),
-        React.createElement('div', { style: { ...s.muted, marginTop: 2 } },
-          '通过微信扫 ClawBot 二维码，在微信里远程对话和控制 DSH agent'
-        ),
+        React.createElement('div', { style: s.label }, platformName),
+        React.createElement('div', { style: { ...s.muted, marginTop: 2 } }, platformDesc),
       ),
       React.createElement(StatusTag, { running: connected }),
     ),
 
     // 快捷入口：使用说明 / 命令
     React.createElement('div', { style: { display: 'flex', gap: 8, marginTop: 10, flexWrap: 'wrap', alignItems: 'center' } },
-      React.createElement('a', {
+      platformId === 'wechat' && React.createElement('a', {
         href: 'https://github.com/wenbin-wb/dsh-bridge/blob/main/docs/wechat-usage.md',
         target: '_blank', rel: 'noopener noreferrer',
         style: s.btnGhost,
@@ -349,7 +349,7 @@ function WechatCard({ rpcCall, onStatusChange }) {
       React.createElement('button', {
         style: s.btnGhost,
         onClick: () => setShowHelp(v => !v),
-      }, showHelp ? '收起命令' : '微信命令'),
+      }, showHelp ? '收起命令' : '命令列表'),
     ),
 
     // 命令速查
@@ -368,18 +368,18 @@ function WechatCard({ rpcCall, onStatusChange }) {
     err && React.createElement('div', { style: { ...s.warn, marginTop: 10 } }, err),
 
     // 已配置：状态详情 + 白名单
-    wx?.configured && React.createElement('div', { style: s.block },
+    platform?.configured && React.createElement('div', { style: s.block },
       React.createElement('div', { style: { fontSize: 12, lineHeight: 1.7 } },
         React.createElement('div', null, `状态: ${statusLabel}`),
-        wx.accountId && React.createElement('div', null, `账号: ${wx.accountId}`),
-        wx.sessionId && React.createElement('div', null, `当前会话: ${wx.sessionId}`),
+        platform.accountId && React.createElement('div', null, `账号: ${platform.accountId}`),
+        platform.sessionId && React.createElement('div', null, `当前会话: ${platform.sessionId}`),
       ),
       React.createElement('div', { style: { ...s.muted, fontSize: 12, marginTop: 8, lineHeight: 1.6 } },
-        '白名单（仅这些微信用户可驱动 agent）:'
+        '白名单（仅这些用户可驱动 agent）:'
       ),
       React.createElement('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 6, marginTop: 6 } },
-        (wx.allowFrom?.length
-          ? wx.allowFrom.map((id) =>
+        (platform.allowFrom?.length
+          ? platform.allowFrom.map((id) =>
               React.createElement('span', { key: id, style: { ...s.tag, background: 'var(--dsw-alias-bg-layer-2,#f3f4f6)', color: 'var(--dsw-alias-label-primary,currentColor)', gap: 6 } },
                 React.createElement('span', { style: { fontSize: 12, wordBreak: 'break-all' } }, id),
                 React.createElement('button', {
@@ -388,12 +388,16 @@ function WechatCard({ rpcCall, onStatusChange }) {
                 }, '×'),
               )
             )
-          : React.createElement('div', { style: { ...s.muted, fontSize: 12 } }, '(空 — 扫码后首个发消息的微信用户将自动加入)')),
+          : React.createElement('div', { style: { ...s.muted, fontSize: 12 } },
+              platformId === 'wechat'
+                ? '(空 — 扫码后首个发消息的微信用户将自动加入)'
+                : '(空 — 首个发消息的用户将自动加入)'
+            )),
       ),
       React.createElement('div', { style: { display: 'flex', gap: 8, marginTop: 8, alignItems: 'center' } },
         React.createElement('input', {
           style: { ...s.input, flex: 1 },
-          placeholder: '添加允许的微信 ID（如 xxx@im.wechat）',
+          placeholder: platformId === 'wechat' ? '添加允许的微信 ID（如 xxx@im.wechat）' : '添加允许的用户 ID',
           value: newId,
           onChange: handleNewId,
         }),
@@ -403,26 +407,28 @@ function WechatCard({ rpcCall, onStatusChange }) {
         }, '添加'),
       ),
       React.createElement('div', { style: { display: 'flex', gap: 8, marginTop: 10, flexWrap: 'wrap', alignItems: 'center' } },
-        wx.status !== 'connected' && wx.status !== 'starting' &&
-          React.createElement('button', { style: s.btnPri, onClick: onLogin, disabled: busy }, '重新扫码'),
-        (wx.status === 'connected' || wx.status === 'starting') &&
+        platform.status !== 'connected' && platform.status !== 'starting' &&
+          React.createElement('button', { style: s.btnPri, onClick: onLogin, disabled: busy }, '重新登录'),
+        (platform.status === 'connected' || platform.status === 'starting') &&
           React.createElement('button', { style: s.btnGhost, onClick: onStop, disabled: busy }, '断开'),
         React.createElement('button', {
           style: { ...s.btnGhost, color: 'var(--dsw-alias-state-error-primary,#dc2626)', borderColor: 'var(--dsw-alias-state-error-primary,#dc2626)', opacity: busy ? 0.5 : 1 },
           disabled: busy,
-          onClick: () => { if (window.confirm('确认解绑？这将清除登录凭证，下次需重新扫码登录。')) act(BRIDGE_ENDPOINTS.wechatUnbind, {}); },
-          title: '清除登录凭证，下次需重新扫码',
+          onClick: () => { if (window.confirm('确认解绑？这将清除登录凭证，下次需重新登录。')) act(BRIDGE_ENDPOINTS.platformUnbind, {}); },
+          title: '清除登录凭证，下次需重新登录',
         }, '解绑账号'),
       ),
     ),
 
     // 未配置 / 登录中：二维码
-    (!wx?.configured || showQr) && React.createElement('div', { style: s.block },
+    (!platform?.configured || showQr) && React.createElement('div', { style: s.block },
       showQr && login.qr
         ? React.createElement('div', null,
-            React.createElement('img', { src: login.qr, alt: 'wechat QR', style: s.qr }),
+            React.createElement('img', { src: login.qr, alt: 'login QR', style: s.qr }),
             React.createElement('div', { style: { ...s.muted, marginTop: 4 } },
-              login.phase === 'scaned' ? '已扫码，请在手机上确认…' : '请使用微信扫码登录（ClawBot）'
+              login.phase === 'scaned'
+                ? '已扫码，请在手机上确认…'
+                : (platformId === 'wechat' ? '请使用微信扫码登录（ClawBot）' : '请扫码登录')
             ),
             login.error && React.createElement('div', { style: { ...s.muted, marginTop: 4, color: 'var(--dsw-alias-state-warn-primary,#92400e)' } }, login.error),
           )
@@ -492,7 +498,9 @@ function WechatCard({ rpcCall, onStatusChange }) {
 
     React.createElement('div', { style: s.block },
       React.createElement('div', { style: { ...s.tip, fontSize: 12 } },
-        '说明: 扫码成功后，向该微信 Bot 发送第一条消息即自动完成白名单授权。仅白名单内的微信用户能驱动 agent，其他人消息会被忽略。使用专用微信号，避免影响主号。'
+        platformId === 'wechat'
+          ? '说明: 扫码成功后，向该微信 Bot 发送第一条消息即自动完成白名单授权。仅白名单内的微信用户能驱动 agent，其他人消息会被忽略。使用专用微信号，避免影响主号。'
+          : '说明: 登录成功后，发送第一条消息即自动完成白名单授权。仅白名单内的用户能驱动 agent，其他人消息会被忽略。'
       ),
     ),
   );
@@ -649,8 +657,9 @@ function BridgePanel({ rpcCall }) {
   const [status, setStatus]       = React.useState(null);
   const [err, setErr]             = React.useState(null);
   const [activeTab, setActiveTab] = React.useState('lan');
-  // 微信连接状态：独立轮询，不依赖 WechatCard 是否挂载
-  const [wechatConnected, setWechatConnected] = React.useState(false);
+  // 平台列表和连接状态
+  const [platforms, setPlatforms] = React.useState(null);
+  const [selectedPlatform, setSelectedPlatform] = React.useState('wechat');
 
   const load = React.useCallback(async (quiet = false) => {
     try {
@@ -663,15 +672,14 @@ function BridgePanel({ rpcCall }) {
     }
   }, [rpcCall]);
 
-  // 独立轮询微信连接状态（与 getStatus 解耦，Tab 未选中时也能更新绿点）
+  // 独立轮询所有平台状态（Tab 未选中时也能更新）
   React.useEffect(() => {
     let alive = true;
     const poll = async () => {
       try {
-        const r = await rpcCall(BRIDGE_ENDPOINTS.wechatGetStatus, {});
+        const r = await rpcCall(BRIDGE_ENDPOINTS.listPlatforms, {});
         if (alive && r?.ok) {
-          const s = r.value?.status;
-          setWechatConnected(s === 'connected' || s === 'starting' || s === 'reconnecting');
+          setPlatforms(r.value ?? {});
         }
       } catch { /* 忽略，不影响主面板 */ }
     };
@@ -716,11 +724,14 @@ function BridgePanel({ rpcCall }) {
 
   const ct = status?.customTunnel;
 
-  // Tab 状态点：im 用 WechatCard 上报的准确状态，其余从 getStatus 读
+  // Tab 状态点：从各自数据源计算
+  const imConnected = platforms && Object.values(platforms).some(p => 
+    p.status === 'connected' || p.status === 'starting' || p.status === 'reconnecting'
+  );
   const dots = {
     lan:    !!(status?.proxy?.running),
     tunnel: !!(status?.cloudflared?.running || ct?.running),
-    im:     wechatConnected,
+    im:     !!imConnected,
   };
 
   // Tab 内容
@@ -768,30 +779,36 @@ function BridgePanel({ rpcCall }) {
       ),
     );
   } else if (activeTab === 'im') {
-    // 平台列表：已接入的可点击，未接入的置灰
-    // wechatConnected 来自 WechatCard 的 onStatusChange 回调，状态准确
+    // 从 listPlatforms 动态生成平台列表
     const IM_PLATFORMS = [
-      { id: 'wechat', label: '微信', desc: 'iLink Bot API（ClawBot）', available: true,  active: wechatConnected },
-      { id: 'qq',     label: 'QQ',   desc: 'NapCat / Mirai',          available: false, active: false },
-      { id: 'feishu', label: '飞书', desc: '官方事件回调 API',          available: false, active: false },
+      { id: 'wechat', label: '微信', desc: 'iLink Bot API（ClawBot）' },
+      { id: 'qq',     label: 'QQ',   desc: 'NapCat / Mirai' },
+      { id: 'feishu', label: '飞书', desc: '官方事件回调 API' },
     ];
+    
     tabContent = React.createElement('div', null,
-      // 平台选择器
+      // 平台选择器（可点击切换）
       React.createElement('div', {
         style: { display: 'flex', gap: 10, marginBottom: 16, flexWrap: 'wrap' },
       },
-        IM_PLATFORMS.map(({ id, label, desc, available, active }) =>
-          React.createElement('div', {
+        IM_PLATFORMS.map(({ id, label, desc }) => {
+          const platformData = platforms?.[id];
+          const available = !!platformData;
+          const active = platformData?.status === 'connected' || platformData?.status === 'starting' || platformData?.status === 'reconnecting';
+          
+          return React.createElement('div', {
             key: id,
             style: {
               flex: '1 1 140px',
-              border: `1px solid ${active ? 'var(--dsw-alias-state-success-primary,#10b981)' : 'var(--dsw-alias-border-l2,#e5e7eb)'}`,
+              border: `1px solid ${selectedPlatform === id ? 'var(--dsw-alias-state-info-primary,#3b82f6)' : active ? 'var(--dsw-alias-state-success-primary,#10b981)' : 'var(--dsw-alias-border-l2,#e5e7eb)'}`,
               borderRadius: 10,
               padding: '12px 14px',
               opacity: available ? 1 : 0.45,
-              cursor: available ? 'default' : 'not-allowed',
-              background: active ? 'var(--dsw-alias-state-success-bg,#ecfdf5)' : available ? 'var(--dsw-alias-bg-layer-1,transparent)' : 'var(--dsw-alias-bg-layer-2,#f9fafb)',
+              cursor: available ? 'pointer' : 'not-allowed',
+              background: selectedPlatform === id ? 'var(--dsw-alias-state-info-bg,#eff6ff)' : active ? 'var(--dsw-alias-state-success-bg,#ecfdf5)' : available ? 'var(--dsw-alias-bg-layer-1,transparent)' : 'var(--dsw-alias-bg-layer-2,#f9fafb)',
+              transition: 'all 0.15s ease',
             },
+            onClick: available ? () => setSelectedPlatform(id) : undefined,
           },
             React.createElement('div', { style: { ...s.label, fontSize: 13, display: 'flex', alignItems: 'center', gap: 6 } },
               label,
@@ -806,11 +823,17 @@ function BridgePanel({ rpcCall }) {
               }, '即将支持'),
             ),
             React.createElement('div', { style: { ...s.muted, marginTop: 3, fontSize: 11 } }, desc),
-          )
-        ),
+          );
+        }),
       ),
-      // 微信卡片（onStatusChange 向上报连接状态）
-      React.createElement(WechatCard, { rpcCall, onStatusChange: setWechatConnected }),
+      // 显示选中的平台卡片
+      selectedPlatform && platforms?.[selectedPlatform] && React.createElement(PlatformCard, {
+        platformId: selectedPlatform,
+        platformName: IM_PLATFORMS.find(p => p.id === selectedPlatform)?.label ?? selectedPlatform,
+        platformDesc: IM_PLATFORMS.find(p => p.id === selectedPlatform)?.desc ?? '',
+        rpcCall,
+        onStatusChange: () => {}, // 状态变化已由 listPlatforms 轮询处理，不需要回调
+      }),
     );
   }
 

package/lib/bridge-rpc-constants.js

@@ -11,6 +11,15 @@ export const BRIDGE_ENDPOINTS = {
   resetCloudflared: 'resetCloudflared',
   saveCustomTunnelConfig: 'saveCustomTunnelConfig',
   checkVersion: 'checkVersion',
+  // 平台管理器（多 IM 平台统一接口）
+  listPlatforms: 'listPlatforms',
+  platformLogin: 'platformLogin',
+  platformSetAllowFrom: 'platformSetAllowFrom',
+  platformSetConfig: 'platformSetConfig',
+  platformStop: 'platformStop',
+  platformStart: 'platformStart',
+  platformUnbind: 'platformUnbind',
+  // 微信 Bot（v1.x 向后兼容别名，deprecated）
   wechatGetStatus: 'wechatGetStatus',
   wechatLogin: 'wechatLogin',
   wechatSetAllowFrom: 'wechatSetAllowFrom',

package/lib/bridge-rpc.js

@@ -54,7 +54,7 @@ async function wechatStatusValue(wechatService, logger) {
   return { ...status, login: { ...status.login, qr, qrPayload: undefined, qrKind: undefined } };
 }
 
-export function installBridgeRpc(ctx, { service, wechat, logger, saveCustomTunnelConfig }) {
+export function installBridgeRpc(ctx, { service, wechat, platformManager, logger, saveCustomTunnelConfig }) {
   if (!ctx?.connection?.rpc?.handle) {
     logger.warn('dsh-bridge: Connection RPC unavailable — UI will not work');
     return () => {};
@@ -123,7 +123,97 @@ export function installBridgeRpc(ctx, { service, wechat, logger, saveCustomTunne
           return ok(result);
         }
 
-        // ---- 微信 Bot ----
+        // ---- 平台管理器（多 IM 平台）----
+
+        if (endpoint === BRIDGE_ENDPOINTS.listPlatforms) {
+          if (!platformManager) return ok({});
+          // 每个平台的 login.qrPayload 渲染为 dataURL 后返回
+          const raw = platformManager.getStatus();
+          const out = {};
+          for (const [id, status] of Object.entries(raw)) {
+            let qr = null;
+            try { qr = await renderQr(status.login).catch(() => null); } catch { /* ignore */ }
+            out[id] = { ...status, login: { ...(status.login ?? {}), qr, qrPayload: undefined, qrKind: undefined } };
+          }
+          return ok(out);
+        }
+
+        // ---- 平台操作（统一接口）----
+
+        if (endpoint === BRIDGE_ENDPOINTS.platformLogin) {
+          if (!platformManager) return fail('bad-request', 'PlatformManager 未初始化');
+          const { platformId, qrType } = payload;
+          if (!platformId) return fail('bad-request', '缺少 platformId 参数');
+          const platform = platformManager.get(platformId);
+          if (!platform) return fail('bad-request', `平台未注册: ${platformId}`);
+          const result = await platform.login({ qrType });
+          if (!result.ok) return fail('bad-request', result.error ?? '登录启动失败');
+          const status = platform.getStatus();
+          const qr = await renderQr(status.login).catch(() => null);
+          return ok({ ...status, login: { ...status.login, qr, qrPayload: undefined, qrKind: undefined } });
+        }
+
+        if (endpoint === BRIDGE_ENDPOINTS.platformSetAllowFrom) {
+          if (!platformManager) return fail('bad-request', 'PlatformManager 未初始化');
+          const { platformId, allowFrom } = payload;
+          if (!platformId) return fail('bad-request', '缺少 platformId 参数');
+          const platform = platformManager.get(platformId);
+          if (!platform) return fail('bad-request', `平台未注册: ${platformId}`);
+          await platform.setAllowFrom(allowFrom);
+          const status = platform.getStatus();
+          const qr = await renderQr(status.login).catch(() => null);
+          return ok({ ...status, login: { ...status.login, qr, qrPayload: undefined, qrKind: undefined } });
+        }
+
+        if (endpoint === BRIDGE_ENDPOINTS.platformSetConfig) {
+          if (!platformManager) return fail('bad-request', 'PlatformManager 未初始化');
+          const { platformId, ...config } = payload;
+          if (!platformId) return fail('bad-request', '缺少 platformId 参数');
+          const platform = platformManager.get(platformId);
+          if (!platform) return fail('bad-request', `平台未注册: ${platformId}`);
+          await platform.setConfig(config);
+          const status = platform.getStatus();
+          const qr = await renderQr(status.login).catch(() => null);
+          return ok({ ...status, login: { ...status.login, qr, qrPayload: undefined, qrKind: undefined } });
+        }
+
+        if (endpoint === BRIDGE_ENDPOINTS.platformStop) {
+          if (!platformManager) return fail('bad-request', 'PlatformManager 未初始化');
+          const { platformId } = payload;
+          if (!platformId) return fail('bad-request', '缺少 platformId 参数');
+          const platform = platformManager.get(platformId);
+          if (!platform) return fail('bad-request', `平台未注册: ${platformId}`);
+          await platform.stop();
+          const status = platform.getStatus();
+          const qr = await renderQr(status.login).catch(() => null);
+          return ok({ ...status, login: { ...status.login, qr, qrPayload: undefined, qrKind: undefined } });
+        }
+
+        if (endpoint === BRIDGE_ENDPOINTS.platformStart) {
+          if (!platformManager) return fail('bad-request', 'PlatformManager 未初始化');
+          const { platformId } = payload;
+          if (!platformId) return fail('bad-request', '缺少 platformId 参数');
+          const platform = platformManager.get(platformId);
+          if (!platform) return fail('bad-request', `平台未注册: ${platformId}`);
+          await platform.start();
+          const status = platform.getStatus();
+          const qr = await renderQr(status.login).catch(() => null);
+          return ok({ ...status, login: { ...status.login, qr, qrPayload: undefined, qrKind: undefined } });
+        }
+
+        if (endpoint === BRIDGE_ENDPOINTS.platformUnbind) {
+          if (!platformManager) return fail('bad-request', 'PlatformManager 未初始化');
+          const { platformId } = payload;
+          if (!platformId) return fail('bad-request', '缺少 platformId 参数');
+          const platform = platformManager.get(platformId);
+          if (!platform) return fail('bad-request', `平台未注册: ${platformId}`);
+          await platform.unbind();
+          const status = platform.getStatus();
+          const qr = await renderQr(status.login).catch(() => null);
+          return ok({ ...status, login: { ...status.login, qr, qrPayload: undefined, qrKind: undefined } });
+        }
+
+        // ---- 微信 Bot（v1.x 向后兼容别名，deprecated）----
 
         if (endpoint === BRIDGE_ENDPOINTS.wechatGetStatus) {
           if (!wechat) return fail('bad-request', '微信 Bot 未初始化');
@@ -164,7 +254,7 @@ export function installBridgeRpc(ctx, { service, wechat, logger, saveCustomTunne
         if (endpoint === BRIDGE_ENDPOINTS.wechatStart) {
           if (!wechat) return fail('bad-request', '微信 Bot 未初始化');
           await wechat.gateway.start().catch((err) => {
-            logger.error('wechat start failed: %s', err?.message ?? err);
+            logger.error('wechat start enabled: %s', err?.message ?? err);
           });
           const value = await wechatStatusValue(wechat, logger);
           return ok(value);

package/lib/index.js

@@ -16,6 +16,7 @@ import QRCode from 'qrcode';
 import { installBridgeRpc } from './bridge-rpc.js';
 import { CustomTunnelClient } from './tunnel-client.mjs';
 import { CloudflaredManager } from './cloudflared-manager.mjs';
+import { PlatformManager } from './platform/manager.js';
 import { WechatService } from './wechat/index.js';
 
 const name = 'dsh-bridge';
@@ -483,7 +484,10 @@ function apply(ctx, config = {}) {
     }
   }).catch(() => {});
 
-  // 微信 Bot（ClawBot/iLink）
+  // 平台管理器：注册/协调所有 IM 平台适配器
+  const platformManager = new PlatformManager({ logger });
+
+  // 微信 Bot（ClawBot/iLink）—— 作为 Platform 子类注册进平台管理器
   const wechat = new WechatService({
     ctx,
     logger,
@@ -494,20 +498,32 @@ function apply(ctx, config = {}) {
       await saveConfig(stored);
     },
   });
+  platformManager.register(wechat);
 
   // 启动时读取已保存的微信 Bot 配置（凭证 + 白名单 + 活动会话）
-  loadConfig().then((stored) => {
+  loadConfig().then(async (stored) => {
     if (stored?.wechat) {
       const cfg = stored.wechat;
       wechat.node.config.allowFrom = Array.isArray(cfg.allowFrom) ? cfg.allowFrom : [];
-      // 恢复活动会话 ID（直接覆盖，不判断当前值）
-      if (cfg.activeSessionId) {
-        wechat.node.activeSessionId = cfg.activeSessionId;
-        logger.info('dsh-bridge: restored wechat active session: %s', cfg.activeSessionId);
-      } else {
-        // 没有持久化的会话时，回退到选第一个
-        wechat.node._pickDefaultSession().catch(() => {});
-      }
+      
+      // 用 Promise 包装配置恢复过程，防止 handleInbound 竞态
+      wechat.node._restoringConfig = (async () => {
+        try {
+          // 恢复活动会话 ID（直接覆盖，不判断当前值）
+          if (cfg.activeSessionId) {
+            wechat.node.activeSessionId = cfg.activeSessionId;
+            logger.info('dsh-bridge: restored wechat active session: %s', cfg.activeSessionId);
+          } else {
+            // 没有持久化的会话时，回退到选第一个
+            await wechat.node._pickDefaultSession().catch(() => {});
+          }
+        } finally {
+          wechat.node._configRestored = true;
+        }
+      })();
+      
+      await wechat.node._restoringConfig;
+      
       if (cfg.token && cfg.accountId) {
         wechat.gateway.setCredentials({
           token: cfg.token,
@@ -522,6 +538,7 @@ function apply(ctx, config = {}) {
   const disposeRpc = installBridgeRpc(ctx, {
     service,
     wechat,
+    platformManager,
     logger,
     saveCustomTunnelConfig: async (serverUrl, accessToken) => {
       const stored = await loadConfig();
@@ -539,6 +556,7 @@ function apply(ctx, config = {}) {
   ctx.effect(() => async () => {
     try { disposeRpc(); } catch {}
     await wechat.destroy();
+    platformManager.dispose();
     await service.dispose();
   }, 'dsh-bridge: stop wechat, proxy and tunnels');
 }