fix: avoid xreach false alarm and xiaoyuzhou install crash

agent_reach/channels/twitter.py

@@ -1,6 +1,7 @@
 # -*- coding: utf-8 -*-
 """Twitter/X — check if xreach CLI is available."""
 
+import json
 import shutil
 import subprocess
 from .base import Channel
@@ -19,6 +20,53 @@ def _parse_version(ver_str: str) -> tuple[int, ...]:
         return (0, 0, 0)
 
 
+def _detect_xreach_version(xreach_path: str) -> str:
+    """Best-effort xreach version detection.
+
+    Some xreach-cli releases ship package.json@0.3.2 while `xreach --version`
+    still prints 0.3.0 because the embedded dist version file was not updated.
+    Prefer the newer of:
+    1) `xreach --version`
+    2) `npm list -g xreach-cli --json --depth=0`
+    """
+    versions: list[str] = []
+
+    try:
+        ver_result = subprocess.run(
+            [xreach_path, "--version"], capture_output=True,
+            encoding="utf-8", errors="replace", timeout=5
+        )
+        version_str = (ver_result.stdout or ver_result.stderr).strip()
+        if version_str:
+            versions.append(version_str)
+    except Exception:
+        pass
+
+    npm = shutil.which("npm")
+    if npm:
+        try:
+            npm_result = subprocess.run(
+                [npm, "list", "-g", "xreach-cli", "--json", "--depth=0"],
+                capture_output=True, encoding="utf-8", errors="replace", timeout=10,
+            )
+            if npm_result.returncode == 0 and npm_result.stdout:
+                data = json.loads(npm_result.stdout)
+                npm_ver = (
+                    data.get("dependencies", {})
+                    .get("xreach-cli", {})
+                    .get("version", "")
+                    .strip()
+                )
+                if npm_ver:
+                    versions.append(npm_ver)
+        except Exception:
+            pass
+
+    if not versions:
+        return ""
+    return max(versions, key=_parse_version)
+
+
 class TwitterChannel(Channel):
     name = "twitter"
     description = "Twitter/X 推文"
@@ -39,13 +87,9 @@ class TwitterChannel(Channel):
             )
         # Check version — longform tweet support requires >= 0.3.2
         try:
-            ver_result = subprocess.run(
-                [xreach, "--version"], capture_output=True,
-                encoding="utf-8", errors="replace", timeout=5
-            )
-            version_str = (ver_result.stdout or ver_result.stderr).strip()
+            version_str = _detect_xreach_version(xreach)
             version_tuple = _parse_version(version_str)
-            if version_tuple < _MIN_XREACH_VERSION:
+            if version_str and version_tuple < _MIN_XREACH_VERSION:
                 min_str = ".".join(str(x) for x in _MIN_XREACH_VERSION)
                 return "warn", (
                     f"xreach CLI 版本过旧（当前 {version_str}，需 >= {min_str}）。"