feat: support scanning QRcode to login

.gitignore

@@ -5,3 +5,4 @@ __pycache__/
 *.pyc
 *.egg-info/
 .venv/
+.DS_Store

python/pyproject.toml

@@ -8,7 +8,10 @@ version = "0.2.0"
 description = "Python SDK for the WeChat iLink Bot API"
 readme = "README.md"
 requires-python = ">=3.11"
-dependencies = ["aiohttp"]
+dependencies = [
+    "aiohttp",
+    "qrcode>=8.2",
+]
 license = { text = "MIT" }
 
 [tool.setuptools.packages.find]

python/weixin_bot/auth.py

@@ -86,8 +86,17 @@ def _clear_credentials_sync(token_path: str | Path | None) -> None:
 
 
 def _print_qr_instructions(url: str) -> None:
-    _log("在微信中打开以下链接完成登录:")
-    sys.stderr.write(f"{url}\n")
+    import qrcode
+
+    try:
+        qr = qrcode.QRCode(border=1)
+        qr.add_data(url)
+        qr.make(fit=True)
+        qr.print_ascii(tty=False)
+        print("请使用微信扫描上方二维码完成登录。")
+    except Exception:
+        _log("在微信中打开以下链接完成登录:")
+        sys.stderr.write(f"{url}\n")
 
 
 async def load_credentials(token_path: str | Path | None = None) -> Credentials | None:

python/weixin_bot/types.py

@@ -3,17 +3,10 @@
 from dataclasses import dataclass
 from datetime import datetime
 from enum import IntEnum
-from typing import Literal, TypedDict
+from typing import TYPE_CHECKING, Literal, TypedDict
 
-try:
+if TYPE_CHECKING:
     from typing import NotRequired, TypeAlias
-except ImportError:  # pragma: no cover - Python < 3.11 runtime compatibility
-    class _NotRequiredCompat:
-        def __class_getitem__(cls, item):
-            return item
-
-    NotRequired = _NotRequiredCompat  # type: ignore[assignment]
-    TypeAlias = object  # type: ignore[assignment]
 
 
 class MessageType(IntEnum):