114 lines
4 KiB
Python
114 lines
4 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""Twitter/X — check if xreach CLI is available."""
|
||
|
||
import json
|
||
import shutil
|
||
import subprocess
|
||
from .base import Channel
|
||
|
||
# Minimum xreach-cli version with longform tweet and X Article support.
|
||
# v0.3.2 added: extractTweetText() preferring note_tweet for long tweets (#aad6a16)
|
||
# and X Article URL support (/article/ path, #2e05825).
|
||
_MIN_XREACH_VERSION = (0, 3, 2)
|
||
|
||
|
||
def _parse_version(ver_str: str) -> tuple[int, ...]:
|
||
"""Parse a semver string like '0.3.2' into a tuple (0, 3, 2)."""
|
||
try:
|
||
return tuple(int(x) for x in ver_str.strip().split(".")[:3])
|
||
except (ValueError, AttributeError):
|
||
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 推文"
|
||
backends = ["xreach CLI"]
|
||
tier = 1
|
||
|
||
def can_handle(self, url: str) -> bool:
|
||
from urllib.parse import urlparse
|
||
d = urlparse(url).netloc.lower()
|
||
return "x.com" in d or "twitter.com" in d
|
||
|
||
def check(self, config=None):
|
||
xreach = shutil.which("xreach")
|
||
if not xreach:
|
||
return "warn", (
|
||
"xreach CLI 未安装。搜索可通过 Exa 替代。安装：\n"
|
||
" npm install -g xreach-cli"
|
||
)
|
||
# Check version — longform tweet support requires >= 0.3.2
|
||
try:
|
||
version_str = _detect_xreach_version(xreach)
|
||
version_tuple = _parse_version(version_str)
|
||
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}）。"
|
||
f"旧版本无法读取长文推文（note_tweet）和 X Article。升级：\n"
|
||
f" npm install -g xreach-cli@latest"
|
||
)
|
||
except Exception:
|
||
pass # version check failure is non-fatal; proceed to auth check
|
||
|
||
try:
|
||
r = subprocess.run(
|
||
[xreach, "auth", "check"], capture_output=True,
|
||
encoding="utf-8", errors="replace", timeout=10
|
||
)
|
||
if r.returncode == 0:
|
||
return "ok", "完整可用（读取、搜索推文，含长文/X Article）"
|
||
return "warn", (
|
||
"xreach CLI 已安装但未配置 Cookie。运行：\n"
|
||
" agent-reach configure twitter-cookies \"auth_token=xxx; ct0=yyy\""
|
||
)
|
||
except Exception:
|
||
return "warn", "xreach CLI 已安装但连接失败"
|