refactor(im): centralize proxy disabling logic in base adapter

Author: waterbang

docs/guide/im-bridge/dingtalk.md

@@ -36,6 +36,7 @@ DingTalk (钉钉) is ideal for:
 |------------|---------|
 | `Robot.SingleChat.ReadWrite` | Single chat robot management |
 | `qyapi_chat_read` | Read group basic info |
+| `qyapi_chat_manage` | Manage group chats (create, update, send messages) |
 
 3. Click to enable each permission (no approval needed for internal apps)
 

src/cccc/ports/im/adapters/base.py

@@ -22,6 +22,30 @@ class IMAdapter(ABC):
 
     platform: str = "unknown"
 
+    def _log(self, msg: str) -> None:
+        """Log a message. Subclasses should override with actual logging."""
+        pass
+
+    def _disable_proxies(self) -> None:
+        """
+        Disable all proxies for WebSocket-based SDKs.
+
+        Many IM SDKs (Feishu, DingTalk) use websockets which don't support
+        SOCKS proxy without python-socks. Setting no_proxy=* and clearing
+        proxy environment variables ensures reliable WebSocket connections.
+        """
+        import os
+        os.environ["no_proxy"] = "*"
+        os.environ["NO_PROXY"] = "*"
+        self._log("[connect] Set no_proxy=* to bypass all proxies")
+
+        proxy_vars = ["ALL_PROXY", "all_proxy", "HTTP_PROXY", "http_proxy",
+                      "HTTPS_PROXY", "https_proxy", "SOCKS_PROXY", "socks_proxy"]
+        for var in proxy_vars:
+            if var in os.environ:
+                del os.environ[var]
+                self._log(f"[connect] Cleared {var} environment variable")
+
     @abstractmethod
     def connect(self) -> bool:
         """

src/cccc/ports/im/adapters/dingtalk.py

@@ -291,6 +291,9 @@ def connect(self) -> bool:
         with self._queue_lock:
             self._message_queue.clear()
 
+        # Disable all proxies BEFORE importing dingtalk-stream SDK
+        self._disable_proxies()
+
         # Inbound requires the official SDK (dingtalk-stream) for stream mode.
         try:
             import dingtalk_stream  # type: ignore

src/cccc/ports/im/adapters/feishu.py

@@ -254,20 +254,7 @@ def connect(self) -> bool:
             self._message_queue.clear()
 
         # Disable all proxies BEFORE importing lark SDK
-        # lark-oapi SDK doesn't support SOCKS proxy without python-socks
-        # Setting no_proxy=* tells most libraries to bypass proxy for all hosts
-        import os
-        os.environ["no_proxy"] = "*"
-        os.environ["NO_PROXY"] = "*"
-        self._log("[connect] Set no_proxy=* to bypass all proxies")
-
-        # Also clear any existing proxy variables
-        proxy_vars = ["ALL_PROXY", "all_proxy", "HTTP_PROXY", "http_proxy",
-                      "HTTPS_PROXY", "https_proxy", "SOCKS_PROXY", "socks_proxy"]
-        for var in proxy_vars:
-            if var in os.environ:
-                del os.environ[var]
-                self._log(f"[connect] Cleared {var} environment variable")
+        self._disable_proxies()
 
         # Inbound requires the official SDK (lark-oapi) for long connection messaging.
         try: