wx-downloder 0.1.1__py3-none-any.whl

wx_channels_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.1"

wx_channels_cli/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

wx_channels_cli/auth.py

@@ -0,0 +1,130 @@
+from __future__ import annotations
+
+import time
+from urllib.parse import urlsplit
+
+from .client import ORIGIN
+from .config import AppError, app_home, read_json, write_json
+
+
+def cookie_header(cookies: list[dict]) -> str:
+    now = time.time()
+    valid = []
+    for cookie in cookies:
+        domain = cookie.get("domain", "").lstrip(".")
+        expiry = cookie.get("expires", -1)
+        if (
+            domain
+            and ("yuanbao.tencent.com" == domain or "yuanbao.tencent.com".endswith("." + domain))
+            and (expiry == -1 or expiry > now)
+            and cookie.get("value")
+            and "/api/weixin/get_parse_result".startswith(cookie.get("path", "/"))
+        ):
+            valid.append(cookie)
+    valid.sort(key=lambda c: len(c.get("path", "/")), reverse=True)
+    return "; ".join(f"{c['name']}={c['value']}" for c in valid)
+
+
+def load_auth() -> dict:
+    auth = read_json(app_home() / "auth.json", {})
+    if not isinstance(auth, dict):
+        raise AppError("登录凭据文件格式错误，请运行 wx-downloder login")
+    cookie = cookie_header(auth.get("cookies", []))
+    names = {part.split("=", 1)[0] for part in cookie.split("; ")}
+    if not cookie or not {"hy_user", "hy_token"}.issubset(names):
+        raise AppError("没有可用的元宝登录凭据，请先运行 wx-downloder login")
+    return auth | {"cookie": cookie}
+
+
+def login(browser_name: str = "auto", timeout: int = 300, emit=print) -> None:
+    from playwright.sync_api import Error as BrowserError
+    from playwright.sync_api import sync_playwright
+
+    with sync_playwright() as pw:
+        browser = None
+        choices = ("chrome", "chromium") if browser_name == "auto" else (browser_name,)
+        for choice in choices:
+            try:
+                browser = pw.chromium.launch(
+                    headless=False, **({"channel": choice} if choice != "chromium" else {})
+                )
+                break
+            except BrowserError:
+                continue
+        if browser is None:
+            raise AppError(
+                "无法启动浏览器。请安装 Chrome，或运行 python -m playwright install chromium"
+            )
+        context = None
+        capture = None
+        try:
+            # Always authenticate afresh: reusing locally unexpired cookies here can
+            # immediately re-save a session that the server has already revoked.
+            context = browser.new_context(locale="zh-CN")
+            page = context.new_page()
+            captured = {}
+
+            def capture(request):
+                if (
+                    urlsplit(request.url).netloc != "yuanbao.tencent.com"
+                    or "/api/" not in request.url
+                ):
+                    return
+                # This property reads the event's cached headers without issuing a
+                # browser RPC. all_headers() can outlive the page during shutdown.
+                for key, value in request.headers.items():
+                    if key in (
+                        "authorization",
+                        "t-userid",
+                        "x-id",
+                        "x-device-id",
+                        "x-hy92",
+                        "x-hy93",
+                    ):
+                        captured[key] = value
+
+            context.on("request", capture)
+            page.goto(ORIGIN, wait_until="domcontentloaded", timeout=60000)
+            emit("已打开元宝，请在浏览器中完成扫码或手机号登录；检测到登录凭据后自动保存。")
+            # Site labels vary; failure to auto-open is harmless, user can click 登录.
+            for label in ("登录", "立即登录", "登录 / 注册", "Log In", "Not logged in"):
+                try:
+                    button = page.get_by_text(label, exact=True).first
+                    if button.is_visible():
+                        button.click(timeout=1500)
+                        break
+                except BrowserError:
+                    pass
+            deadline = time.monotonic() + timeout
+            while time.monotonic() < deadline:
+                if page.is_closed():
+                    raise AppError("浏览器已关闭，未保存新的登录凭据")
+                cookies = context.cookies(ORIGIN + "/api/weixin/get_parse_result")
+                names = {
+                    c["name"].lower(): c["value"]
+                    for c in cookies
+                    if c.get("value") and (c.get("expires", -1) == -1 or c["expires"] > time.time())
+                }
+                # Yuanbao creates anonymous tracking cookies before login; those do not count.
+                if names.get("hy_user") and names.get("hy_token"):
+                    state = context.storage_state()
+                    write_json(
+                        app_home() / "auth.json",
+                        {
+                            "cookies": cookies,
+                            "storage_state": state,
+                            "headers": captured,
+                            "user_agent": page.evaluate("navigator.userAgent"),
+                            "saved_at": time.strftime("%Y-%m-%dT%H:%M:%S%z"),
+                        },
+                    )
+                    emit("元宝登录凭据已保存（仅当前用户可读写）。")
+                    return
+                page.wait_for_timeout(1000)
+            raise AppError("等待登录超时，未检测到 hy_user/hy_token，请重新运行 wx-downloder login")
+        except BrowserError as exc:
+            raise AppError("元宝浏览器登录失败，请检查网络后重试") from exc
+        finally:
+            if context is not None and capture is not None:
+                context.remove_listener("request", capture)
+            browser.close()

wx_channels_cli/cli.py

@@ -0,0 +1,167 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from . import __version__
+from .auth import load_auth, login
+from .client import YuanbaoClient
+from .config import AppError, app_home, load_config, validate_setting, write_json
+from .download import download_one
+from .inputs import parse_inputs
+
+
+def parser() -> argparse.ArgumentParser:
+    root = argparse.ArgumentParser(prog="wx-downloder", description="元宝登录 · 微信视频号下载")
+    root.add_argument("--version", action="version", version=__version__)
+    subs = root.add_subparsers(dest="command", required=True)
+    auth = subs.add_parser("login", help="打开元宝浏览器登录并保存凭据")
+    auth.add_argument("--browser", choices=("auto", "chrome", "chromium", "msedge"))
+    auth.add_argument("--timeout", type=int, default=300, help="扫码等待秒数，默认 300")
+    subs.add_parser("logout", help="删除本地保存的登录凭据")
+    subs.add_parser("status", help="查看本地凭据与目录状态，不输出 token")
+    config = subs.add_parser("config", help="查看和修改配置").add_subparsers(
+        dest="action", required=True
+    )
+    config.add_parser("show", help="查看配置")
+    setter = config.add_parser("set", help="设置配置项")
+    setter.add_argument("key")
+    setter.add_argument("value")
+    down = subs.add_parser("download", help="下载分享链接、JSON 列表或 JSON 文件")
+    down.add_argument("sources", nargs="*", help="链接、内联 JSON 或 JSON 文件路径；- 读取标准输入")
+    down.add_argument("--input", "-i", action="append", default=[], metavar="JSON_FILE")
+    down.add_argument("--output", "-o", help="本次下载成品目录")
+    down.add_argument("--cache-dir", help="本次下载临时缓存目录")
+    down.add_argument("--quality", choices=("h264", "h265"))
+    down.add_argument("--no-login", action="store_true", help="未登录时直接失败，不打开浏览器")
+    down.add_argument(
+        "--json", action="store_true", help="stdout 仅输出 JSON 结果，日志发往 stderr"
+    )
+    return root
+
+
+def collect_sources(args) -> list[str]:
+    entries = []
+    stdin_used = False
+
+    def read_source(value: str, required_file=False):
+        nonlocal stdin_used
+        if value == "-":
+            if stdin_used:
+                raise AppError("标准输入只能读取一次")
+            stdin_used = True
+            return sys.stdin.read()
+        if not required_file and (
+            value.startswith("https://") or value.lstrip().startswith(("[", "{", '"'))
+        ):
+            return value
+        file = Path(value).expanduser()
+        if required_file or file.is_file():
+            try:
+                return file.read_text(encoding="utf-8-sig")
+            except (OSError, UnicodeError) as exc:
+                raise AppError(f"无法读取输入文件：{file}") from exc
+        return value
+
+    for value in args.sources:
+        entries.extend(parse_inputs(read_source(value)))
+    for file in args.input:
+        entries.extend(parse_inputs(read_source(file, True)))
+    if not args.sources and not args.input:
+        if sys.stdin.isatty():
+            print("请输入视频分享链接或 JSON 列表：", file=sys.stderr)
+            entries.extend(parse_inputs(input()))
+        else:
+            entries.extend(parse_inputs(sys.stdin.read()))
+    return list(dict.fromkeys(entries))
+
+
+def run(args) -> int:
+    config = load_config()
+    emit = lambda message: print(message, file=sys.stderr)
+    if args.command == "config":
+        if args.action == "set":
+            config[args.key] = validate_setting(args.key, args.value)
+            write_json(app_home() / "config.json", config)
+        print(json.dumps(config, ensure_ascii=False, indent=2))
+    elif args.command == "login":
+        if args.timeout <= 0:
+            raise AppError("等待登录超时必须大于 0")
+        login(args.browser or config["browser"], args.timeout, emit)
+    elif args.command == "logout":
+        (app_home() / "auth.json").unlink(missing_ok=True)
+        print("本地元宝登录凭据已删除。")
+    elif args.command == "status":
+        try:
+            auth = load_auth()
+            status = "已保存（服务端有效性将在下载时检查）"
+            saved = auth.get("saved_at")
+        except AppError:
+            status, saved = "未登录或本地 Cookie 已过期", None
+        print(
+            json.dumps(
+                {"auth": status, "saved_at": saved, "config_dir": str(app_home()), **config},
+                ensure_ascii=False,
+                indent=2,
+            )
+        )
+    elif args.command == "download":
+        sources = collect_sources(args)  # Validate all input before launching login/network calls.
+        for key, value in (
+            ("download_dir", args.output),
+            ("cache_dir", args.cache_dir),
+            ("quality", args.quality),
+        ):
+            if value is not None:
+                config[key] = validate_setting(key, value)
+        try:
+            auth = load_auth()
+        except AppError:
+            if args.no_login:
+                raise
+            login(config["browser"], emit=emit)
+            auth = load_auth()
+        results = []
+        with YuanbaoClient(auth, config["timeout"]) as client:
+            for index, source in enumerate(sources, 1):
+                emit(f"[{index}/{len(sources)}] {source}")
+
+                def progress(size, total):
+                    percent = f" / {total / 1048576:.1f} MiB ({size / total:.0%})" if total else ""
+                    emit(f"  已下载 {size / 1048576:.1f} MiB{percent}")
+
+                try:
+                    result = download_one(source, client, config, progress)
+                    emit(
+                        f"  {'跳过已下载' if result['status'] == 'skipped' else '已保存'}：{result['path']}"
+                    )
+                except (AppError, OSError) as exc:
+                    result = {"status": "failed", "source_url": source, "error": str(exc)}
+                    emit(f"  失败：{exc}")
+                results.append(result)
+        counts = {
+            kind: sum(r["status"] == kind for r in results)
+            for kind in ("downloaded", "skipped", "failed")
+        }
+        if args.json:
+            print(json.dumps({"summary": counts, "results": results}, ensure_ascii=False, indent=2))
+        else:
+            print(
+                f"完成：下载 {counts['downloaded']}，跳过 {counts['skipped']}，失败 {counts['failed']}"
+            )
+        return 1 if counts["failed"] else 0
+    return 0
+
+
+def main(argv=None) -> int:
+    args = parser().parse_args(argv)
+    try:
+        return run(args)
+    except KeyboardInterrupt:
+        print("\n已取消。", file=sys.stderr)
+        return 130
+    except (AppError, OSError, EOFError) as exc:
+        print(f"错误：{exc}", file=sys.stderr)
+        return 1

wx_channels_cli/client.py

@@ -0,0 +1,141 @@
+from __future__ import annotations
+
+import secrets
+import time
+from urllib.parse import parse_qs, urlencode, urlsplit
+
+import httpx
+
+from .config import AppError
+from .inputs import normalize_url
+
+ORIGIN = "https://yuanbao.tencent.com"
+PARSE_URL = ORIGIN + "/api/weixin/get_parse_result"
+PREVIEW = "https://channels.weixin.qq.com/finder-preview"
+USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36"
+
+
+def object_field(data: dict, key: str) -> dict:
+    value = data.get(key)
+    return value if isinstance(value, dict) else {}
+
+
+def http_url(value: str):
+    try:
+        url = urlsplit(value)
+        if url.scheme not in ("http", "https") or not url.netloc or url.username:
+            raise ValueError
+        return url
+    except ValueError as exc:
+        raise AppError("接口返回无效的视频地址") from exc
+
+
+def json_response(response: httpx.Response, stage: str) -> dict:
+    if not 200 <= response.status_code < 300:
+        hint = "，请运行 wx-downloder login 重新登录" if response.status_code in (401, 403) else ""
+        raise AppError(f"{stage}返回 HTTP {response.status_code}{hint}")
+    try:
+        data = response.json()
+    except ValueError as exc:
+        raise AppError(f"{stage}返回非 JSON 数据") from exc
+    if not isinstance(data, dict):
+        raise AppError(f"{stage}返回格式异常")
+    return data
+
+
+class YuanbaoClient:
+    def __init__(self, auth: dict, timeout: int = 60, transport=None):
+        self.auth = auth
+        # Cookies are attached ONLY to the Yuanbao POST, never as client defaults.
+        self.http = httpx.Client(timeout=timeout, transport=transport, follow_redirects=False)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.http.close()
+
+    def resolve(self, source: str, quality: str = "h264") -> dict:
+        source = normalize_url(source)
+        headers = {
+            "User-Agent": self.auth.get("user_agent") or USER_AGENT,
+            "Origin": ORIGIN,
+            "Referer": ORIGIN + "/",
+            "Accept": "application/json",
+            "x-source": "web",
+            "Cookie": self.auth["cookie"],
+        }
+        for key, value in self.auth.get("headers", {}).items():
+            if key in ("authorization", "t-userid", "x-id", "x-device-id", "x-hy92", "x-hy93"):
+                headers[key] = value
+        result = json_response(
+            self.http.post(
+                PARSE_URL,
+                headers=headers,
+                json={
+                    "type": "video_channel_url",
+                    "url": source,
+                    "scene": 1,
+                },
+            ),
+            "元宝解析接口",
+        )
+        if result.get("code") != 0:
+            raise AppError(f"元宝解析失败（code={result.get('code')}），请重新登录并检查链接")
+        parsed = result.get("data")
+        if not isinstance(parsed, dict) or not isinstance(parsed.get("playable_url"), str):
+            raise AppError("元宝未返回视频预览地址")
+        url = http_url(parsed["playable_url"])
+        query = parse_qs(url.query)
+        if (
+            url.scheme != "https"
+            or url.netloc != "channels.weixin.qq.com"
+            or not all(query.get(k) for k in ("token", "eid"))
+        ):
+            raise AppError("元宝未返回有效的预览 token/eid")
+        params = {
+            "_rid": f"{int(time.time()):x}-{secrets.token_hex(4)}",
+            "_pageUrl": PREVIEW + "/pages/feed",
+        }
+        profile = json_response(
+            self.http.post(
+                PREVIEW + "/api/feed/get_feed_info?" + urlencode(params),
+                headers={
+                    "User-Agent": headers["User-Agent"],
+                    "Origin": "https://channels.weixin.qq.com",
+                    "Referer": parsed["playable_url"],
+                },
+                json={"baseReq": {"generalToken": query["token"][0]}, "exportId": query["eid"][0]},
+            ),
+            "视频号预览接口",
+        )
+        data = profile.get("data")
+        error = object_field(data, "errMsg") if isinstance(data, dict) else {}
+        if (
+            profile.get("errCode", 0) != 0
+            or not isinstance(data, dict)
+            or any(error.get(k) for k in ("type", "title", "content"))
+        ):
+            raise AppError("视频号预览失败，视频可能已删除、不可见或预览凭证失效")
+        feed = data.get("feedInfo")
+        if not isinstance(feed, dict) or feed.get("mediaType") != 4:
+            raise AppError("链接不是可下载的普通视频，暂不支持图集或直播")
+        candidates = [quality, "h265" if quality == "h264" else "h264"]
+        media = object_field(feed, candidates[0] + "VideoInfo").get("videoUrl")
+        media = (
+            media
+            or feed.get("videoUrl")
+            or object_field(feed, candidates[1] + "VideoInfo").get("videoUrl")
+        )
+        if not isinstance(media, str):
+            raise AppError("视频详情缺少有效的媒体下载地址")
+        http_url(media)
+        return {
+            "source_url": source,
+            "media_url": media,
+            "description": str(feed.get("description") or parsed.get("desc") or "video"),
+            "author": str(
+                object_field(data, "authorInfo").get("nickname") or parsed.get("author") or ""
+            ),
+            "profile": profile,
+        }

wx_channels_cli/config.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+import json
+import os
+import tempfile
+from pathlib import Path
+
+
+class AppError(Exception):
+    """可直接向用户展示的错误。"""
+
+
+def app_home() -> Path:
+    return Path(os.environ.get("WX_CHANNELS_HOME", "~/.config/wx-channels")).expanduser().resolve()
+
+
+def read_json(path: Path, default=None):
+    if not path.exists():
+        return default
+    try:
+        return json.loads(path.read_text(encoding="utf-8-sig"))
+    except (ValueError, UnicodeError) as exc:
+        raise AppError(f"JSON 文件无效：{path}") from exc
+
+
+def write_json(path: Path, data) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    fd, temp = tempfile.mkstemp(prefix=".wx-", suffix=".tmp", dir=path.parent)
+    try:
+        with os.fdopen(fd, "w", encoding="utf-8") as file:
+            json.dump(data, file, ensure_ascii=False, indent=2)
+            file.write("\n")
+            file.flush()
+            os.fsync(file.fileno())
+        os.replace(temp, path)
+    finally:
+        Path(temp).unlink(missing_ok=True)
+
+
+def defaults() -> dict:
+    return {
+        "download_dir": str(Path.home() / "Downloads" / "wx-channels"),
+        "cache_dir": str(
+            Path(os.environ.get("XDG_CACHE_HOME", "~/.cache")).expanduser() / "wx-channels"
+        ),
+        "timeout": 60,
+        "retries": 2,
+        "quality": "h264",
+        "browser": "auto",
+    }
+
+
+def validate_setting(key: str, value):
+    if key not in defaults():
+        raise AppError(f"未知配置项：{key}")
+    if key.endswith("_dir"):
+        if not isinstance(value, str) or not value.strip():
+            raise AppError(f"{key} 必须是非空路径")
+        return str(Path(value).expanduser().resolve())
+    if key in ("timeout", "retries"):
+        try:
+            number = int(value)
+        except (TypeError, ValueError) as exc:
+            raise AppError(f"{key} 必须是整数") from exc
+        if isinstance(value, bool) or str(number) != str(value) or not 0 <= number <= 3600:
+            raise AppError(f"{key} 必须是 0 到 3600 的整数")
+        if key == "timeout" and number == 0:
+            raise AppError("timeout 必须大于 0")
+        if key == "retries" and number > 10:
+            raise AppError("retries 最大为 10")
+        return number
+    options = {"quality": ("h264", "h265"), "browser": ("auto", "chrome", "chromium", "msedge")}
+    if value not in options[key]:
+        raise AppError(f"{key} 可选值：{', '.join(options[key])}")
+    return value
+
+
+def load_config() -> dict:
+    saved = read_json(app_home() / "config.json", {})
+    if not isinstance(saved, dict):
+        raise AppError("config.json 必须是 JSON 对象")
+    return defaults() | {key: validate_setting(key, value) for key, value in saved.items()}

wx_channels_cli/download.py

@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+import hashlib
+import os
+import re
+import shutil
+import tempfile
+import time
+from pathlib import Path
+
+import httpx
+
+from .client import USER_AGENT
+from .config import AppError, read_json, write_json
+
+
+def safe_name(value: str) -> str:
+    name = re.sub(r'[\x00-\x1f\x7f/\\:*?"<>|\s]+', "_", value).strip("._ ")[:60]
+    return name or "video"
+
+
+def stream_video(url: str, cache_dir: Path, timeout: int, progress, transport=None) -> Path:
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    fd, name = tempfile.mkstemp(prefix="wx-video-", suffix=".part", dir=cache_dir)
+    path = Path(name)
+    complete = False
+    try:
+        with (
+            os.fdopen(fd, "wb") as output,
+            httpx.Client(
+                timeout=timeout,
+                follow_redirects=True,
+                transport=transport,
+                headers={"User-Agent": USER_AGENT, "Accept-Encoding": "identity"},
+            ) as http,
+            http.stream("GET", url) as response,
+        ):
+            if response.status_code != 200:
+                raise AppError(f"视频下载返回 HTTP {response.status_code}")
+            content_type = response.headers.get("content-type", "").lower()
+            if any(kind in content_type for kind in ("text/", "json", "xml", "mpegurl")):
+                raise AppError("媒体地址返回网页或错误信息，未保存为视频")
+            try:
+                total = int(response.headers.get("content-length", "0"))
+            except ValueError as exc:
+                raise AppError("媒体服务器返回无效的文件长度") from exc
+            size, last = 0, 0.0
+            head = bytearray()
+            for chunk in response.iter_bytes(256 * 1024):
+                if len(head) < 32:
+                    head.extend(chunk[: 32 - len(head)])
+                output.write(chunk)
+                size += len(chunk)
+                now = time.monotonic()
+                if now - last >= 1:
+                    progress(size, total)
+                    last = now
+            if not size or (total and size != total):
+                raise AppError(f"视频传输不完整：收到 {size} 字节，预期 {total}")
+            if bytes(head[4:8]) not in (b"ftyp", b"moov", b"mdat", b"free", b"wide"):
+                raise AppError("下载内容不是有效的 MP4 文件，未保存成品")
+            output.flush()
+            os.fsync(output.fileno())
+            progress(size, total)
+        complete = True
+        return path
+    finally:
+        if not complete:
+            path.unlink(missing_ok=True)
+
+
+def publish(temp: Path, target: Path) -> None:
+    """Cross-filesystem safe; never replace existing files, clean interrupted copies."""
+    created = False
+    try:
+        with target.open("xb") as out:
+            created = True
+            with temp.open("rb") as source:
+                shutil.copyfileobj(source, out, 1024 * 1024)
+            out.flush()
+            os.fsync(out.fileno())
+    except BaseException:
+        if created:
+            target.unlink(missing_ok=True)
+        raise
+
+
+def download_one(
+    source: str, resolver, config: dict, progress=lambda *_: None, transport=None
+) -> dict:
+    directory = Path(config["download_dir"]).expanduser().resolve()
+    cache = Path(config["cache_dir"]).expanduser().resolve()
+    directory.mkdir(parents=True, exist_ok=True)
+    identity = hashlib.sha256(source.encode()).hexdigest()[:12]
+    receipt = directory / f".wx-{identity}.json"
+    previous = read_json(receipt, {})
+    if isinstance(previous, dict) and previous.get("source_url") == source:
+        filename = previous.get("filename", "")
+        if filename and Path(filename).name == filename:
+            target = directory / filename
+            if target.is_file() and target.stat().st_size == previous.get("bytes", 0) > 0:
+                return {
+                    "status": "skipped",
+                    "source_url": source,
+                    "path": str(target),
+                    "bytes": target.stat().st_size,
+                }
+    for attempt in range(config["retries"] + 1):
+        temp = None
+        try:
+            video = resolver.resolve(source, config["quality"])
+            filename = f"{safe_name(video['description'])}-{identity}.mp4"
+            target = directory / filename
+            if target.exists():
+                raise AppError(f"目标文件已存在但无匹配下载记录，请移动或重命名后重试：{target}")
+            temp = stream_video(video["media_url"], cache, config["timeout"], progress, transport)
+            publish(temp, target)
+            result = {
+                "status": "downloaded",
+                "source_url": source,
+                "path": str(target),
+                "bytes": target.stat().st_size,
+                "filename": filename,
+                "description": video["description"],
+                "author": video["author"],
+            }
+            try:
+                write_json(receipt, result)
+            except OSError as exc:
+                raise AppError(f"视频已保存到 {target}，但下载记录保存失败") from exc
+            return result
+        except (httpx.TransportError, AppError) as exc:
+            # Retry network/temporary failures, never repeatedly retry login or invalid input.
+            retryable = (
+                isinstance(exc, httpx.TransportError)
+                or "HTTP 5" in str(exc)
+                or "HTTP 429" in str(exc)
+            )
+            if not retryable or attempt == config["retries"]:
+                if isinstance(exc, httpx.TransportError):
+                    raise AppError("网络请求失败或超时，请检查网络后重试") from exc
+                raise
+            time.sleep(min(2**attempt, 8))
+        finally:
+            if temp is not None:
+                temp.unlink(missing_ok=True)
+    raise AssertionError("unreachable")

wx_channels_cli/inputs.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+import json
+import re
+from urllib.parse import urlsplit, urlunsplit
+
+from .config import AppError
+
+
+def normalize_url(value: str) -> str:
+    try:
+        url = urlsplit(value.strip())
+        if (
+            url.scheme != "https"
+            or url.netloc != "weixin.qq.com"
+            or not re.fullmatch(r"/sph/[A-Za-z0-9_-]+/?", url.path)
+        ):
+            raise ValueError
+    except ValueError as exc:
+        raise AppError("请输入 https://weixin.qq.com/sph/... 格式的视频号分享链接") from exc
+    return urlunsplit((url.scheme, url.netloc, url.path.rstrip("/"), "", ""))
+
+
+def parse_inputs(raw: str) -> list[str]:
+    """链接、字符串数组、对象数组，以及 links/urls/videos/items/data 包装对象。"""
+    raw = raw.strip()
+    if not raw:
+        raise AppError("输入为空")
+    try:
+        value = json.loads(raw) if raw[0] in '[{"' else raw
+    except ValueError as exc:
+        raise AppError("输入 JSON 格式无效") from exc
+
+    def walk(item):
+        if isinstance(item, str):
+            yield normalize_url(item)
+        elif isinstance(item, list):
+            for child in item:
+                yield from walk(child)
+        elif isinstance(item, dict):
+            for key in ("url", "share_url", "shareUrl", "sourceUrl", "link"):
+                if key in item:
+                    yield from walk(item[key])
+                    return
+            for key in ("links", "urls", "videos", "items", "data"):
+                if key in item:
+                    yield from walk(item[key])
+                    return
+            raise AppError("JSON 对象需要 url/share_url 字段或 links/urls/videos/items/data 列表")
+        else:
+            raise AppError("JSON 中的链接必须是字符串或带 url 字段的对象")
+
+    result = list(dict.fromkeys(walk(value)))
+    if not result:
+        raise AppError("输入列表中没有视频链接")
+    return result

wx_downloder-0.1.1.dist-info/METADATA

@@ -0,0 +1,162 @@
+Metadata-Version: 2.5
+Name: wx-downloder
+Version: 0.1.1
+Summary: 通过元宝登录解析并下载微信视频号分享链接的 Python CLI
+Project-URL: Homepage, https://github.com/QinGeneral/wx-downloder
+Project-URL: Repository, https://github.com/QinGeneral/wx-downloder
+Project-URL: Issues, https://github.com/QinGeneral/wx-downloder/issues
+License: "Commons Clause" License Condition v1.0
+        
+        License: MIT License
+        Licensor: ltaoo
+        Software: wx_channels_download (including binaries and distributions under the names "wx_channels_download.exe", "wx_channel", "wx_video_download", and any substantially similar names)
+        
+        The Software is provided to you by the Licensor under the License, as defined below, subject to the following condition.
+        
+        Without limiting other conditions in the License, the grant of rights under the License will not include, and the License does not grant to you, the right to Sell the Software.
+        
+        For the purposes of the foregoing, "Sell" means practicing any or all of the rights granted to you under the License to provide to third parties, for a fee or other consideration, a product or service whose value derives, entirely or substantially, from the functionality of the Software. Any licensee who wishes to Sell the Software must obtain a separate license from the Licensor.
+        
+        ---
+        
+        MIT License
+        
+        Copyright (c) 2025 ltaoo
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: playwright<2,>=1.51
+Description-Content-Type: text/markdown
+
+# wx-downloder
+
+独立 Python CLI：打开腾讯元宝登录、保存登录凭据、解析微信视频号分享链接并下载 MP4。基于原项目 [wx_channels_download](https://github.com/ltaoo/wx_channels_download) 的元宝分享链接下载流程迁移；运行时无需 Go、微信客户端、代理抓包服务或 Cloudflare Worker。
+
+## 安装
+
+需要 Python 3.10+，以及 Chrome 或 Playwright Chromium。
+
+```bash
+uv tool install wx-downloder
+wx-downloder --help
+```
+
+固定安装本次版本：`uv tool install wx-downloder==0.1.1`。也支持 `python -m pip install wx-downloder`。
+
+如未安装 Chrome，安装 Playwright Chromium：
+
+```bash
+uv tool run --from playwright playwright install chromium
+```
+
+源码开发安装：
+
+```bash
+git clone https://github.com/QinGeneral/wx-downloder.git
+cd wx-downloder
+uv sync
+uv run wx-downloder --help
+```
+
+从旧版 `wx-channels` 更新：先安装新版并确认 `wx-downloder --version` 输出 `0.1.1`，再运行 `uv tool uninstall wx-channels-cli` 移除旧命令。配置目录、`WX_CHANNELS_HOME` 环境变量和登录凭据位置保持兼容，已经登录的用户无需再次扫码。
+
+0.1.1 修复登录成功后浏览器关闭时请求回调反复抛出 `TargetClosedError`：请求监听使用本地缓存的请求头，并在关闭前解除监听。
+
+项目默认使用清华 PyPI 镜像以改善国内安装速度；需要官方源时可执行 `uv sync --default-index https://pypi.org/simple`。
+
+## 登录和下载
+
+```bash
+# 启动独立浏览器窗口，扫码或手机号登录，检测到凭据后自动保存
+wx-downloder login
+
+# 单个链接；未保存登录凭据时会自动打开登录窗口
+wx-downloder download 'https://weixin.qq.com/sph/实际分享ID'
+
+# 多个链接 / JSON 文件 / 内联 JSON
+wx-downloder download 'https://weixin.qq.com/sph/ID1' 'https://weixin.qq.com/sph/ID2'
+wx-downloder download --input examples/links.json
+wx-downloder download links.json
+wx-downloder download '["https://weixin.qq.com/sph/ID1", {"url":"https://weixin.qq.com/sph/ID2"}]'
+cat links.json | wx-downloder download - --no-login --json
+
+# 不传参数：终端交互输入；管道输入则读取标准输入
+wx-downloder download
+```
+
+必须使用微信分享生成的 `https://weixin.qq.com/sph/...` 链接。会自动去除分享参数和重复项。暂不支持公众号文章、直播、图集或微信内部短口令。
+
+JSON 支持字符串数组、带 `url` / `share_url` / `shareUrl` / `sourceUrl` / `link` 字段的对象，以及 `links` / `urls` / `videos` / `items` / `data` 包装的列表。文件支持 UTF-8 和 UTF-8 BOM。示例链接需替换成真实链接。开始下载前验证全部输入，避免错格式时弹出浏览器。
+
+## 目录配置
+
+```bash
+# 成品目录，默认 ~/Downloads/wx-channels
+wx-downloder config set download_dir '/Volumes/Data/微信视频'
+
+# 临时下载缓存目录，默认 ~/.cache/wx-channels（遵循 XDG_CACHE_HOME）
+wx-downloder config set cache_dir '/Volumes/Data/视频缓存'
+
+# 单次覆盖配置；支持缓存和成品在不同磁盘
+wx-downloder download --input links.json --output './videos' --cache-dir './cache'
+
+wx-downloder config set quality h265
+wx-downloder config set timeout 120
+wx-downloder config set retries 2
+wx-downloder config set browser chrome
+wx-downloder config show
+wx-downloder status
+wx-downloder logout
+```
+
+`quality` 默认为 h264；优先所选编码，缺失时尝试通用地址和另一编码。`timeout` 是单次网络读写超时（秒），`retries` 是网络错误、HTTP 429/5xx 的重试次数（0–10）。重试重新解析链接并重新下载，不续传。批量任务中某个视频失败会继续后续项，并返回退出码 1；全部下载或跳过成功返回 0；取消返回 130。
+
+视频先写入缓存目录 `.part` 文件，校验长度和 MP4 文件头后再保存成品。正常结束、失败或 Ctrl+C 时清理本次临时文件。强制终止进程留下的 `.part` 可手动删除。已有文件不会覆盖；匹配下载记录且大小一致的文件自动跳过。成品名称包含视频标题和链接哈希，避免同名冲突；成品目录中的 `.wx-*.json` 保存标题、作者和去重记录，请保留。
+
+## 登录凭据
+
+元宝接口实际使用完整 Cookie，而非单个 token。CLI 在独立浏览器上下文中等待 `hy_user` 和 `hy_token`，保存适用于元宝的 Cookie、浏览器登录状态和相关请求头。保存后关闭本次浏览器，不读取日常浏览器配置文件。
+
+配置默认位于 `~/.config/wx-channels/config.json`，凭据位于同目录的 `auth.json`。可用 `WX_CHANNELS_HOME` 指定其他配置目录。凭据原子写入，文件权限为 `0600`，不打印到终端；下载 CDN 和视频号预览请求不携带元宝 Cookie。`logout` 删除本地凭据，不注销服务器会话。`status` 只反映本地保存情况；服务端凭据过期需重新 `login`。
+
+使用 [Playwright 浏览器登录状态保存机制](https://playwright.dev/python/docs/auth)。元宝和视频号接口并非稳定公开 API，接口或登录方式变化时可能需要更新。真实扫码必须由用户完成；自动测试使用模拟接口，不等同于真实账号端到端验证。
+
+## 开发验证
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check .
+uv build
+
+# 可选：真实 Chrome 回归测试，模拟登录成功后仍有请求进行的场景
+WX_DOWNLODER_BROWSER_TEST=1 uv run pytest tests/test_browser_login.py -q
+```
+
+原项目许可证为 MIT + Commons Clause，保留在 `LICENSE`；本项目沿用该许可条件。
+
+验收记录：39 项常规自动化测试和 1 项真实 Chrome 登录关闭回归测试通过，Ruff 检查及格式检查通过，wheel/源码包构建通过。使用源项目已有凭据实测下载了一个 8,155,895 字节的视频，ffprobe 确认含 H.264 视频流和 AAC 音频流，时长 73.45 秒。该实测不替代用户首次扫码登录；新项目未预填源项目的凭据。
+
+## 发布流程
+
+发布使用 GitHub Actions 的 `.github/workflows/release.yml`，绑定 PyPI Trusted Publisher：`QinGeneral / wx-downloder / release.yml / pypi`。构建任务检查版本标签、运行测试、构建 wheel 和源码包并验证 CLI；独立发布任务通过 OIDC 上传，只有发布任务拥有 `id-token: write` 权限。
+
+维护者更新版本并提交后，创建与版本一致的 `v<版本>` 标签并推送即可发布。PyPI 版本不可覆盖。PyPI 页面：[wx-downloder](https://pypi.org/project/wx-downloder/)。

wx_downloder-0.1.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+wx_channels_cli/__init__.py,sha256=rnObPjuBcEStqSO0S6gsdS_ot8ITOQjVj_-P1LUUYpg,22
+wx_channels_cli/__main__.py,sha256=k1ocEWawweo1qCJWNFAAvyxz3tcY13dzvCenHszij30,48
+wx_channels_cli/auth.py,sha256=ePOoNN_EcQkCx0oOLLKoy4uScnuJNIviiS44BUau3lg,5790
+wx_channels_cli/cli.py,sha256=DV2Oy6vz3jia0pnP2RrhFyopcym-mFBZ2WRBd7XwROI,6990
+wx_channels_cli/client.py,sha256=K4CfIC0lpiYE1yguVimo9VfMaaAQSDa-itKseSVcThM,5506
+wx_channels_cli/config.py,sha256=kOnC-m3vESH8jv-J0GVvvHacVi7Lo2Hfuw89ZGSWqvw,2786
+wx_channels_cli/download.py,sha256=lLMzX-iyPj6f4xx5QfcWGcsZQA_JCqSjmm9HgvbFCjY,5936
+wx_channels_cli/inputs.py,sha256=G4trv3nifkZU88wTrjoOO9g4Co1zJ-GT53ilC1im3Ks,1972
+wx_downloder-0.1.1.dist-info/METADATA,sha256=yYYEsYJNvqPonqC36HnHTzwfug762Wd619LvnrfYbww,9343
+wx_downloder-0.1.1.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
+wx_downloder-0.1.1.dist-info/entry_points.txt,sha256=cye18qs5K7lR6ODRiv3fgjYTuT1XGrOVc0gm_H37bqY,58
+wx_downloder-0.1.1.dist-info/licenses/LICENSE,sha256=5LGmB7V9qAUR0cb9p11EsclSo0y1W0PgxPJT6mCAFlE,2016
+wx_downloder-0.1.1.dist-info/RECORD,,

wx_downloder-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.3
+Root-Is-Purelib: true
+Tag: py3-none-any

wx_downloder-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wx-downloder = wx_channels_cli.cli:main

wx_downloder-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,35 @@
+"Commons Clause" License Condition v1.0
+
+License: MIT License
+Licensor: ltaoo
+Software: wx_channels_download (including binaries and distributions under the names "wx_channels_download.exe", "wx_channel", "wx_video_download", and any substantially similar names)
+
+The Software is provided to you by the Licensor under the License, as defined below, subject to the following condition.
+
+Without limiting other conditions in the License, the grant of rights under the License will not include, and the License does not grant to you, the right to Sell the Software.
+
+For the purposes of the foregoing, "Sell" means practicing any or all of the rights granted to you under the License to provide to third parties, for a fee or other consideration, a product or service whose value derives, entirely or substantially, from the functionality of the Software. Any licensee who wishes to Sell the Software must obtain a separate license from the Licensor.
+
+---
+
+MIT License
+
+Copyright (c) 2025 ltaoo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.