devart-dl 4.2.0__tar.gz → 4.3.1__tar.gz

{devart_dl-4.2.0/devart_dl.egg-info → devart_dl-4.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devart-dl
-Version: 4.2.0
+Version: 4.3.1
 Summary: 专业的 DeviantArt 作品批量下载工具 - Professional DeviantArt batch downloader with anti-ban features
 Author: DeviantArt Downloader Team
 License-Expression: MIT
@@ -34,9 +34,11 @@ Dynamic: license-file
 
 # DeviantArt Downloader
 
-一个可靠、聚焦的 DeviantArt 下载 / 归档命令行工具。
+**语言 / Language:** 中文 · [English](README.en.md)
 
-**语言 / Language:** 中文 · [English](README.en.md) · [完整文档](https://redtidev1918.github.io/deviantart-downloader/) · [更新日志](CHANGELOG.md)
+> **一个可靠、聚焦的 DeviantArt 下载 / 归档命令行工具。**
+
+[完整文档](https://redtidev1918.github.io/deviantart-downloader/) · [更新日志](CHANGELOG.md)
 
 [![CI](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml/badge.svg)](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/devart-dl.svg)](https://pypi.org/project/devart-dl/)
@@ -61,6 +63,9 @@ devart-dl https://www.deviantart.com/username/gallery
 # 收藏夹 / 标签
 devart-dl https://www.deviantart.com/username/favourites
 devart-dl https://www.deviantart.com/tag/landscape
+
+# 解析为 JSON 描述（不下载文件）
+devart-dl resolve https://www.deviantart.com/username/art/title-123456
 ```
 
 首次下载前建议使用 OAuth 登录：
@@ -88,10 +93,20 @@ devart-dl login browser   # 打开你的 Chrome 登录，自动保存 Cookie，
 - **下载档案**：`--archive` 用 SQLite 记住已下载，跨会话自动跳过。
 - **路径模板 + 元数据 sidecar**：`--directory`/`--filename` 模板与 `--write-info-json`。
 - **代理与降级**：支持 `--proxy`；未登录 OAuth 时自动回退 Cookie。
+- **Resolve 模式**：`devart-dl resolve URL` 输出 `ResolvedDeviation`/`MediaAsset` 的 JSON 契约，不写文件。
+
+## 文档
+
+| 你想做什么 | 文档 |
+| --- | --- |
+| 下载安装包 | [下载页](https://redtidev1918.github.io/deviantart-downloader/download.md) |
+| 登录与认证 | [登录与认证](docs/LOGIN.md) |
+| 命令、配置与 Python 调用 | [文档站](https://redtidev1918.github.io/deviantart-downloader/) |
 
-完整的安装、登录认证、下载模式、配置参数、命令速查、Python 调用与常见问题，请看**文档站点**：
+## 致谢
 
-https://redtidev1918.github.io/deviantart-downloader/
+- [requests](https://github.com/psf/requests)：HTTP 客户端。
+- 登录与归档目录的实现与 [gallery-dl](https://github.com/mikf/gallery-dl) 交叉核对过。
 
 ## 许可证与免责声明
 

devart_dl-4.3.1/README.en.md

@@ -0,0 +1,87 @@
+# DeviantArt Downloader
+
+**Language / 语言:** [中文](README.md) · English
+
+> **A reliable, focused DeviantArt downloader and archival CLI.**
+
+📖 [Full documentation](https://redtidev1918.github.io/deviantart-downloader/) · [Changelog](CHANGELOG.md)
+
+[![CI](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml/badge.svg)](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/devart-dl.svg)](https://pypi.org/project/devart-dl/)
+[![Python](https://img.shields.io/pypi/pyversions/devart-dl.svg)](https://pypi.org/project/devart-dl/)
+[![Downloads](https://img.shields.io/pypi/dm/devart-dl.svg)](https://pypi.org/project/devart-dl/)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+See [CHANGELOG.md](CHANGELOG.md) for release notes.
+
+---
+
+## Core Features
+
+- **Official API first (OAuth)** — log in once to download originals; no cookie export, no anti-ban delays.
+- **URL-first** — `devart-dl URL` downloads artworks / galleries / favourites / tags / fav.me links directly.
+- **Reliable downloads** — HTTP Range resume, automatic retry, 429 backoff, HTML/empty-file validation, atomic finalize.
+- **Download archive** — `--archive` remembers what you've downloaded in SQLite, skipping it across sessions.
+- **Path templates** — `--directory` / `--filename` support `{id}` `{title}` `{author}` `{published}` `{ext}` and more, with safe sanitization.
+- **Metadata sidecars** — `--write-info-json` writes a `.json` next to each file.
+- **Proxy & fallback** — `--proxy` or proxy environment variables; falls back to cookies when not logged in via OAuth.
+
+---
+
+## Quick Start
+
+### Installation
+
+Requires Python 3.10 or newer.
+
+```bash
+pip install devart-dl
+```
+
+### Basic Usage (URL-first)
+
+```bash
+# Single artwork (also fav.me links and bare artwork ids)
+devart-dl https://www.deviantart.com/username/art/title-123456
+
+# Gallery / all works by an artist
+devart-dl https://www.deviantart.com/username/gallery
+
+# Favourites
+devart-dl https://www.deviantart.com/username/favourites
+
+# Tag
+devart-dl https://www.deviantart.com/tag/landscape
+
+# Resolve to JSON descriptors (download nothing)
+devart-dl resolve https://www.deviantart.com/username/art/title-123456
+```
+
+### Login (OAuth recommended)
+
+```bash
+devart-dl login oauth --client-id YOUR_PUBLIC_CLIENT_ID
+devart-dl whoami     # verify login
+devart-dl logout     # revoke the token
+```
+
+Register a **Public** OAuth app at [deviantart.com/developers](https://www.deviantart.com/developers/) and whitelist `http://127.0.0.1:8765/callback`. Login happens in the browser — no password or `client_secret` is ever given to the CLI.
+
+---
+
+## Documentation
+
+The full install, sign-in, download modes, configuration, command reference, Python API and FAQ live on the [docs site](https://redtidev1918.github.io/deviantart-downloader/).
+
+## Acknowledgements
+
+- [requests](https://github.com/psf/requests) — the HTTP client.
+- DevTools-free login and archive layout were cross-checked against [gallery-dl](https://github.com/mikf/gallery-dl).
+
+## License
+
+MIT License — see [LICENSE](LICENSE).
+
+**Important disclaimer:** this tool is for personal learning and research only.
+Respect DeviantArt's terms of service and copyright. Do not use it commercially
+or to overload their servers. The author is not responsible for any misuse.

{devart_dl-4.2.0 → devart_dl-4.3.1}/README.md

@@ -1,8 +1,10 @@
 # DeviantArt Downloader
 
-一个可靠、聚焦的 DeviantArt 下载 / 归档命令行工具。
+**语言 / Language:** 中文 · [English](README.en.md)
 
-**语言 / Language:** 中文 · [English](README.en.md) · [完整文档](https://redtidev1918.github.io/deviantart-downloader/) · [更新日志](CHANGELOG.md)
+> **一个可靠、聚焦的 DeviantArt 下载 / 归档命令行工具。**
+
+[完整文档](https://redtidev1918.github.io/deviantart-downloader/) · [更新日志](CHANGELOG.md)
 
 [![CI](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml/badge.svg)](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/devart-dl.svg)](https://pypi.org/project/devart-dl/)
@@ -27,6 +29,9 @@ devart-dl https://www.deviantart.com/username/gallery
 # 收藏夹 / 标签
 devart-dl https://www.deviantart.com/username/favourites
 devart-dl https://www.deviantart.com/tag/landscape
+
+# 解析为 JSON 描述（不下载文件）
+devart-dl resolve https://www.deviantart.com/username/art/title-123456
 ```
 
 首次下载前建议使用 OAuth 登录：
@@ -54,10 +59,20 @@ devart-dl login browser   # 打开你的 Chrome 登录，自动保存 Cookie，
 - **下载档案**：`--archive` 用 SQLite 记住已下载，跨会话自动跳过。
 - **路径模板 + 元数据 sidecar**：`--directory`/`--filename` 模板与 `--write-info-json`。
 - **代理与降级**：支持 `--proxy`；未登录 OAuth 时自动回退 Cookie。
+- **Resolve 模式**：`devart-dl resolve URL` 输出 `ResolvedDeviation`/`MediaAsset` 的 JSON 契约，不写文件。
+
+## 文档
+
+| 你想做什么 | 文档 |
+| --- | --- |
+| 下载安装包 | [下载页](https://redtidev1918.github.io/deviantart-downloader/download.md) |
+| 登录与认证 | [登录与认证](docs/LOGIN.md) |
+| 命令、配置与 Python 调用 | [文档站](https://redtidev1918.github.io/deviantart-downloader/) |
 
-完整的安装、登录认证、下载模式、配置参数、命令速查、Python 调用与常见问题，请看**文档站点**：
+## 致谢
 
-https://redtidev1918.github.io/deviantart-downloader/
+- [requests](https://github.com/psf/requests)：HTTP 客户端。
+- 登录与归档目录的实现与 [gallery-dl](https://github.com/mikf/gallery-dl) 交叉核对过。
 
 ## 许可证与免责声明
 

{devart_dl-4.2.0 → devart_dl-4.3.1}/da_downloader/__init__.py

@@ -1,16 +1,18 @@
 """DeviantArt Downloader — a reliable, focused downloader and archival CLI."""
 
-__version__ = "4.0.1"
+__version__ = "4.3.0"
 __author__ = "DeviantArt Downloader Team"
 
 from .download import Downloader, build_downloader, normalize_quality
 from .errors import DeviantArtError
-from .models import DownloadItem
+from .models import DownloadItem, MediaAsset, ResolvedDeviation
 
 __all__ = [
     "Downloader",
     "build_downloader",
     "normalize_quality",
     "DownloadItem",
+    "MediaAsset",
+    "ResolvedDeviation",
     "DeviantArtError",
 ]

{devart_dl-4.2.0 → devart_dl-4.3.1}/da_downloader/cli.py

@@ -37,6 +37,7 @@ _HELP = """DeviantArt Downloader
 
 Usage:
   devart-dl URL [options]             # URL-first: artwork/gallery/favourites/tag
+  devart-dl resolve URL [options]     # resolve to work/media JSON, download nothing
   devart-dl url URL [options]
   devart-dl artist USERNAME [options]
   devart-dl gallery USERNAME [GALLERY_ID] [options]
@@ -62,7 +63,7 @@ Run `devart-dl login oauth --help` for OAuth details.
 """
 
 _KNOWN_COMMANDS = frozenset(
-    {"help", "url", "artist", "gallery", "search", "fav", "login", "whoami", "logout"}
+    {"help", "url", "artist", "gallery", "search", "fav", "resolve", "login", "whoami", "logout"}
 )
 _REMOVED_COMMANDS = frozenset({"anti-ban", "test"})
 _UUID_RE = re.compile(
@@ -75,7 +76,7 @@ def _version() -> str:
     try:
         return version("devart-dl")
     except PackageNotFoundError:
-        return "4.0.1"
+        return "4.3.0"
 
 
 def _looks_like_target(value: str) -> bool:
@@ -199,6 +200,39 @@ def _run_download(arguments: Sequence[str]) -> int:
     )
 
 
+
+def _run_resolve(arguments: Sequence[str]) -> int:
+    parser = argparse.ArgumentParser(
+        prog="devart-dl resolve",
+        description="Resolve a DeviantArt target to work/media JSON (download nothing)",
+    )
+    parser.add_argument("target", help="DeviantArt URL or artwork id")
+    parser.add_argument("--cookies", default=None)
+    parser.add_argument("--quality", default="best")
+    parser.add_argument("--proxy", default=None)
+    parser.add_argument("--timeout", type=float, default=60.0)
+    parser.add_argument("--retries", type=int, default=3)
+    parser.add_argument("--limit", type=int, default=24)
+    args = parser.parse_args(list(arguments))
+    try:
+        downloader = build_downloader(
+            destination=Path("."),
+            cookies=_load_cookies(args.cookies),
+            quality=args.quality,
+            proxy=args.proxy,
+            timeout=args.timeout,
+            retries=args.retries,
+            limit=args.limit,
+        )
+        works = downloader.resolve(args.target)
+    except (ValueError, DeviantArtError) as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 1
+    payload = works[0].to_dict() if len(works) == 1 else {"works": [w.to_dict() for w in works]}
+    print(json.dumps(payload, ensure_ascii=False, indent=2))
+    return 0
+
+
 def _run_subcommand(command: str, rest: Sequence[str]) -> int:
     positionals: list[str] = []
     options: dict[str, str] = {}
@@ -406,6 +440,8 @@ def main(argv: Sequence[str] | None = None) -> int:
         return 0
     if command in {"url", "artist", "gallery", "search", "fav"}:
         return _run_subcommand(command, rest)
+    if command == "resolve":
+        return _run_resolve(rest)
     if command == "login":
         if not rest or rest[0] in {"-h", "--help", "help"}:
             print("Usage: devart-dl login oauth|browser|interactive|clear")

{devart_dl-4.2.0 → devart_dl-4.3.1}/da_downloader/download.py

@@ -15,10 +15,16 @@ from .api import DeviantArtAPI
 from .archive import DownloadArchive
 from .http import HttpDownloader
 from .manager import DownloadManager, DownloadOutcome
+from .models import ResolvedDeviation, make_media_asset
 from .oauth import OAuthSession
 from .official_api import OfficialApiClient
 from .path import PathFormatter
-from .provider import DeviantArtProvider, OfficialProvider, WebProvider
+from .provider import (
+    CompositeProvider,
+    DeviantArtProvider,
+    OfficialProvider,
+    WebProvider,
+)
 from .targets import DownloadTarget, TargetParser
 
 # User-facing quality names (new) and the legacy o/f/p shorthand.
@@ -50,6 +56,50 @@ class Downloader:
         parsed = TargetParser.parse(target) if isinstance(target, str) else target
         return [self.manager.run(item) for item in self.provider.resolve(parsed)]
 
+    def resolve(self, target: str | DownloadTarget) -> list[ResolvedDeviation]:
+        """Resolve a target to DeviantArt works and media assets (no download)."""
+        parsed = TargetParser.parse(target) if isinstance(target, str) else target
+        groups: dict[str, dict] = {}
+        order: list[str] = []
+        for item in self.provider.resolve(parsed):
+            extra = item.metadata.get("index") if item.metadata else None
+            base = str(item.artwork_id)
+            if extra is not None:
+                suffix = f"-{extra}"
+                if base.endswith(suffix):
+                    base = base[: -len(suffix)]
+            if base not in groups:
+                groups[base] = {
+                    "title": item.title,
+                    "author": item.author,
+                    "mature": item.mature,
+                    "url": item.url,
+                    "assets": [],
+                }
+                order.append(base)
+            index = int(extra) if extra is not None else len(groups[base]["assets"])
+            groups[base]["assets"].append(
+                make_media_asset(
+                    base,
+                    index,
+                    item.media_url,
+                    extension=item.extension,
+                    mature=item.mature,
+                )
+            )
+        return [
+            ResolvedDeviation(
+                id=key,
+                title=groups[key]["title"],
+                author=groups[key]["author"],
+                mature=groups[key]["mature"],
+                url=groups[key]["url"],
+                media=tuple(groups[key]["assets"]),
+            )
+            for key in order
+        ]
+
+
 
 def build_downloader(
     *,
@@ -70,23 +120,20 @@ def build_downloader(
 ) -> Downloader:
     """Assemble a wired ``Downloader`` from plain configuration values.
 
-    When an OAuth session exists it is preferred (official API); otherwise the
-    cookie-based web provider is used as the fallback.
+    OAuth and cookies are capabilities, not a global provider mode: the
+    official API is preferred where it works and the web session fills the
+    capabilities it cannot cover (notably search).
     """
     normalized_quality = normalize_quality(quality)
     proxies = {"http": proxy, "https": proxy} if proxy else {}
 
     oauth_session = OAuthSession.from_store()
+    official = web = None
+    api = None
     if oauth_session is not None:
         client = OfficialApiClient(oauth_session, timeout=timeout)
-        provider: DeviantArtProvider = OfficialProvider(
-            client, quality=normalized_quality, limit=limit
-        )
-        # Official media URLs are signed CDN links and need no cookies.
-        http_session = requests.Session()
-        if proxies:
-            http_session.proxies.update(proxies)
-    else:
+        official = OfficialProvider(client, quality=normalized_quality, limit=limit)
+    if cookies or oauth_session is None:
         headers = {
             "accept": "application/json, text/plain, */*",
             "user-agent": (
@@ -99,8 +146,17 @@ def build_downloader(
         api = DeviantArtAPI(
             headers, proxies, retry_delay=int(retry_delay), max_retries=retries
         )
-        provider = WebProvider(api, quality=normalized_quality, limit=limit)
+        web = WebProvider(api, quality=normalized_quality, limit=limit)
+
+    provider: DeviantArtProvider = CompositeProvider(official, web)
+    # The web session's cookies are harmless on signed official CDN links and
+    # required for web-sourced media (search/gallery fallback), so prefer it.
+    if api is not None:
         http_session = api.session
+    else:
+        http_session = requests.Session()
+        if proxies:
+            http_session.proxies.update(proxies)
 
     http = HttpDownloader(
         session=http_session,

{devart_dl-4.2.0 → devart_dl-4.3.1}/da_downloader/models.py

@@ -113,3 +113,100 @@ class DownloadItem:
     published_at: Optional[datetime] = None
     mature: bool = False
     metadata: Mapping[str, Any] = field(default_factory=dict)
+
+
+_MIME_BY_EXT = {
+    "jpg": "image/jpeg",
+    "jpeg": "image/jpeg",
+    "png": "image/png",
+    "gif": "image/gif",
+    "webp": "image/webp",
+    "bmp": "image/bmp",
+    "svg": "image/svg+xml",
+    "mp4": "video/mp4",
+    "webm": "video/webm",
+    "mov": "video/quicktime",
+}
+
+_VIDEO_EXTS = frozenset({"mp4", "webm", "mov", "m4v"})
+
+_DEFAULT_MIME = {"image": "image/jpeg", "video": "video/mp4"}
+
+
+@dataclass(frozen=True)
+class MediaAsset:
+    """One resolute media file of a DeviantArt work (``deviantart:<uuid>:p<n>``)."""
+
+    id: str
+    deviation_id: str
+    index: int
+    kind: str  # "image" | "video"
+    source_url: str
+    extension: str | None = None
+    mime_type: str | None = None
+    width: int | None = None
+    height: int | None = None
+    mature: bool = False
+
+    def to_dict(self) -> dict:
+        data: dict = {
+            "id": self.id,
+            "kind": self.kind,
+            "sourceUrl": self.source_url,
+        }
+        for key, value in (
+            ("extension", self.extension),
+            ("mimeType", self.mime_type),
+            ("width", self.width),
+            ("height", self.height),
+            ("mature", self.mature),
+        ):
+            if value is not None:
+                data[key] = value
+        return data
+
+
+@dataclass(frozen=True)
+class ResolvedDeviation:
+    """A DeviantArt work plus its media assets, independent of downloading."""
+
+    id: str
+    title: str
+    author: str
+    mature: bool
+    media: tuple[MediaAsset, ...] = ()
+    url: str = ""
+
+    def to_dict(self) -> dict:
+        return {
+            "work": {
+                "id": self.id,
+                "title": self.title,
+                "author": self.author,
+                "url": self.url,
+                "mature": self.mature,
+            },
+            "media": [asset.to_dict() for asset in self.media],
+        }
+
+
+def make_media_asset(
+    deviation_id: str,
+    index: int,
+    source_url: str,
+    *,
+    extension: str | None = None,
+    mature: bool = False,
+) -> MediaAsset:
+    ext = (extension or "").lstrip(".").lower() or None
+    kind = "video" if ext in _VIDEO_EXTS else "image"
+    return MediaAsset(
+        id=f"deviantart:{deviation_id}:p{index}",
+        deviation_id=deviation_id,
+        index=index,
+        kind=kind,
+        source_url=source_url,
+        extension=ext,
+        mime_type=_MIME_BY_EXT.get(ext) or _DEFAULT_MIME[kind],
+        mature=mature,
+    )

{devart_dl-4.2.0 → devart_dl-4.3.1}/da_downloader/official_api.py

@@ -320,6 +320,9 @@ def additional_media_urls(init_data: dict) -> list:
     """Original-file URLs of a multimedia deviation's extra pages
     (``deviation.extended.additionalMedia``, each entry nests its Wix
     descriptor under ``media``). Prefers the raw ``baseUri`` file + token.
+
+    Mature pages the server still returns with a ``blur_`` censored image are
+    skipped individually; one blocked page does not discard the others.
     """
     extended = init_data.get("deviation", {}).get("extended") or {}
     entries = extended.get("additionalMedia") or []
@@ -333,6 +336,8 @@ def additional_media_urls(init_data: dict) -> list:
         base = media.get("baseUri")
         if not isinstance(base, str) or not base:
             continue
+        if "blur_" in base:
+            continue
         raw_token = media.get("token")
         token = raw_token[0] if isinstance(raw_token, list) and raw_token else raw_token
         if token:

{devart_dl-4.2.0 → devart_dl-4.3.1}/da_downloader/provider.py

@@ -13,6 +13,7 @@ from typing import Any, Callable, Iterator, Optional, Protocol
 
 from .api import ActionType, DeviantArtAPI
 from .errors import MediaUnavailableError, ParseError
+from .errors import AuthenticationError, NetworkError
 from .models import Deviation, DownloadItem
 from .official_api import (
     OfficialApiClient,
@@ -262,6 +263,13 @@ class OfficialProvider:
             ext = _ext_from_url(original.filename)
             return original.url, ext
         content = deviation.get("content") or {}
+        # `content.src` is a poster for video works; only videos[].src is playable.
+        videos = deviation.get("videos") or []
+        if isinstance(videos, list):
+            for video in videos:
+                src = video.get("src") if isinstance(video, dict) else None
+                if src:
+                    return str(src), _ext_from_url(str(src))
         if content.get("src"):
             return str(content["src"]), _ext_from_url(str(content["src"]))
         preview = deviation.get("preview") or {}
@@ -297,4 +305,55 @@ def _parse_published(value: Any) -> Optional[datetime]:
     return datetime.fromtimestamp(timestamp, tz=timezone.utc)
 
 
-__all__ = ["DeviantArtProvider", "OfficialProvider", "WebProvider"]
+class CompositeProvider:
+    """Routes each target to the provider that can actually serve it.
+
+    OAuth and cookies are capabilities, not global provider modes: search
+    always uses the web session, artwork/tag use the official API, and
+    gallery/favorites prefer the official API with the web session as a
+    fallback when the official path is unavailable.
+    """
+
+    def __init__(
+        self,
+        official: DeviantArtProvider | None = None,
+        web: DeviantArtProvider | None = None,
+    ) -> None:
+        if official is None and web is None:
+            raise ValueError("at least one provider is required")
+        self.official = official
+        self.web = web
+
+    def resolve(self, target: DownloadTarget) -> Iterator[DownloadItem]:
+        kind = target.kind
+        if kind == TargetKind.SEARCH:
+            if self.web is None:
+                raise MediaUnavailableError(
+                    "search requires a web/cookie session "
+                    "(`devart-dl login browser`/`interactive` or --cookies)"
+                )
+            yield from self.web.resolve(target)
+            return
+        if kind in (TargetKind.ARTWORK, TargetKind.TAG):
+            if self.official is None:
+                raise MediaUnavailableError(
+                    "this target requires the official API "
+                    "(`devart-dl login oauth`)"
+                )
+            yield from self.official.resolve(target)
+            return
+        if self.official is not None:
+            try:
+                yield from self.official.resolve(target)
+            except (MediaUnavailableError, NetworkError, AuthenticationError):
+                if self.web is not None:
+                    yield from self.web.resolve(target)
+                    return
+                raise
+        elif self.web is not None:
+            yield from self.web.resolve(target)
+        else:
+            raise MediaUnavailableError("no provider can resolve this target")
+
+
+__all__ = ["CompositeProvider", "DeviantArtProvider", "OfficialProvider", "WebProvider"]

{devart_dl-4.2.0 → devart_dl-4.3.1/devart_dl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devart-dl
-Version: 4.2.0
+Version: 4.3.1
 Summary: 专业的 DeviantArt 作品批量下载工具 - Professional DeviantArt batch downloader with anti-ban features
 Author: DeviantArt Downloader Team
 License-Expression: MIT
@@ -34,9 +34,11 @@ Dynamic: license-file
 
 # DeviantArt Downloader
 
-一个可靠、聚焦的 DeviantArt 下载 / 归档命令行工具。
+**语言 / Language:** 中文 · [English](README.en.md)
 
-**语言 / Language:** 中文 · [English](README.en.md) · [完整文档](https://redtidev1918.github.io/deviantart-downloader/) · [更新日志](CHANGELOG.md)
+> **一个可靠、聚焦的 DeviantArt 下载 / 归档命令行工具。**
+
+[完整文档](https://redtidev1918.github.io/deviantart-downloader/) · [更新日志](CHANGELOG.md)
 
 [![CI](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml/badge.svg)](https://github.com/redtidev1918/deviantart-downloader/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/devart-dl.svg)](https://pypi.org/project/devart-dl/)
@@ -61,6 +63,9 @@ devart-dl https://www.deviantart.com/username/gallery
 # 收藏夹 / 标签
 devart-dl https://www.deviantart.com/username/favourites
 devart-dl https://www.deviantart.com/tag/landscape
+
+# 解析为 JSON 描述（不下载文件）
+devart-dl resolve https://www.deviantart.com/username/art/title-123456
 ```
 
 首次下载前建议使用 OAuth 登录：
@@ -88,10 +93,20 @@ devart-dl login browser   # 打开你的 Chrome 登录，自动保存 Cookie，
 - **下载档案**：`--archive` 用 SQLite 记住已下载，跨会话自动跳过。
 - **路径模板 + 元数据 sidecar**：`--directory`/`--filename` 模板与 `--write-info-json`。
 - **代理与降级**：支持 `--proxy`；未登录 OAuth 时自动回退 Cookie。
+- **Resolve 模式**：`devart-dl resolve URL` 输出 `ResolvedDeviation`/`MediaAsset` 的 JSON 契约，不写文件。
+
+## 文档
+
+| 你想做什么 | 文档 |
+| --- | --- |
+| 下载安装包 | [下载页](https://redtidev1918.github.io/deviantart-downloader/download.md) |
+| 登录与认证 | [登录与认证](docs/LOGIN.md) |
+| 命令、配置与 Python 调用 | [文档站](https://redtidev1918.github.io/deviantart-downloader/) |
 
-完整的安装、登录认证、下载模式、配置参数、命令速查、Python 调用与常见问题，请看**文档站点**：
+## 致谢
 
-https://redtidev1918.github.io/deviantart-downloader/
+- [requests](https://github.com/psf/requests)：HTTP 客户端。
+- 登录与归档目录的实现与 [gallery-dl](https://github.com/mikf/gallery-dl) 交叉核对过。
 
 ## 许可证与免责声明
 

{devart_dl-4.2.0 → devart_dl-4.3.1}/devart_dl.egg-info/SOURCES.txt

@@ -33,6 +33,7 @@ devart_dl.egg-info/top_level.txt
 tests/test_api.py
 tests/test_archive.py
 tests/test_cli.py
+tests/test_conformance.py
 tests/test_download.py
 tests/test_http_downloader.py
 tests/test_manager.py