ترجمة آلية

تمت ترجمة هذه الصفحة تلقائيًا بواسطة الذكاء الاصطناعي وقد تحتوي على أخطاء. إذا كان هناك أي شيء غير واضح، يُرجى الرجوع إلى المصدر الإنجليزي.

المصدر الإنجليزي · الإبلاغ عن مشكلة في الترجمة

تحديد المعدل ومعالجة الأخطاء

1. تحديد المعدل ومعالجة الأخطاء

طبقتان: Throttle (core/throttle.py:15) + توجيه الأخطاء في CookieTransport._request (core/http/cookie_transport.py:63-126)؛ بالإضافة إلى الفشل السريع في طبقة الدفعة.

flowchart TD
    REQ["_request issues the request<br/>max_retries=3 (cookie_transport.py:48)"] --> R{result}
    R -->|"2xx"| OK["throttle.reset clears backoff count<br/>(cookie_transport.py:77)<br/>avoids monotonic accumulation across requests"]
    R -->|"401 / 403"| AUTH["AuthTransportError raised immediately<br/>(cookie_transport.py:82-85)<br/>auth failures can't self-heal by backing off"]
    R -->|"429"| RL["RateLimitError + throttle.backoff<br/>keep retrying (cookie_transport.py:86-92)"]
    R -->|"400 and body contains ENTRY_DELETED"| DEL["EntryDeletedError terminal (cookie_transport.py:93-95)<br/>inherits EntryExpiredError — batch must catch it before<br/>EXPIRED (batch_cmd.py:163-174)<br/>mark_deleted, no more retries (offline-operations.md §17)"]
    R -->|"400 and body contains ENTRY_EXPIRED"| EXP["EntryExpiredError terminal<br/>(cookie_transport.py:96-98)<br/>batch marks mark_expired, no more retries"]
    R -->|"500 / 502 / 503 / 504"| S5["TransportError + backoff<br/>retry at least once with backoff (cookie_transport.py:99-107)<br/>504 is a common Cloudflare transient"]
    R -->|"404 and other codes"| NF["TransportError, break, no retry<br/>(cookie_transport.py:108-116)<br/>never mapped to EntryExpiredError: pplx-ask<br/>may transiently 404 when exporting right after thread creation (propagation delay);<br/>a terminal mark would bury a live thread not yet visible"]
    R -->|"network-layer exceptions"| NET["TransportError + backoff<br/>keep retrying (cookie_transport.py:117-125)"]
    RL --> REQ
    S5 --> REQ
    NET --> REQ

    subgraph THR["Throttle (throttle.py:15-53)"]
        D1["delay: uniform(delay_min, delay_max)<br/>batch default 10–20s (cli.py:126-129)"]
        D2["backoff: delay_max × 3^N<br/>±20% jitter anti-sync, capped at 300s<br/>N = consecutive failure count (throttle.py:38-50)"]
        D3["reset: cleared on success (throttle.py:52)"]
    end

    subgraph BF["batch-layer triple fail-fast (batch_cmd.py)"]
        F1["AuthTransportError: auth_fails += 1<br/>3 consecutive (_AUTH_FAIL_FAST, batch_cmd.py:43)<br/>→ save + SystemExit abort<br/>(spinning with a dead cookie would fail hundreds of threads one by one)"]
        F2["other exceptions: auth_fails cleared<br/>mark_error + throttle.backoff, continue (batch_cmd.py:195-200)"]
        F3["KeyboardInterrupt: save, then raise (batch_cmd.py:158-161)"]
    end

    AUTH --> F1
    DEL --> DONE1
    EXP --> DONE1(["terminal registration"])
    OK --> DONE2(["mark_ok"])

    subgraph LIM["rate-limit discipline (anti-ban red line, explicit user requirement)"]
        L1["random 10–20s between threads, no concurrency"]
        L2["pagination ≥3s (rest.py:39)<br/>≥4s before blocks re-fetch (adapter.py:28,88)<br/>space metadata ≥3s (spaces_cmd.py:328)<br/>usage / backfill metadata ≥3s"]
        L3["0.5s between asset downloads (assets.py:28,103)<br/>backfill online phase: CDN downloads at 6 threads<br/>(CDN is not the API, assets_backfill_cmd.py:460-475)"]
    end

• WebBridgeTransport يضبط التراجع 429 و throttle.reset() عند النجاح (bridge_transport.py)؛ تصنيف الأخطاء متوافق مع CookieTransport — 401/403 → AuthTransportError، 400 مع نص يحتوي على ENTRY_EXPIRED → EntryExpiredError، 5xx تراجع-إعادة محاولة؛ فشل المصادقة السريع للدفعة والحالات النهائية المنتهية تنطبق أيضًا تحت --transport webbridge؛ استجابات الخفي غير JSON تنهار إلى TransportError (URLError/JSONDecodeError/OSError يتم التقاطها بشكل موحد)؛ غير 200 الأخرى تذهب مباشرة إلى TransportError.
• محدد السرعة المشترك: تمرر الدفعة نفس المثيل إلى CookieTransport (cli.py:280-282)، مما يوحد عدد التراجع بين طبقة النقل والدفعة؛ إعادة البناء بعد التبديل التلقائي للحساب لا تفقده أيضًا (common.py:139 تمرره أيضًا)؛ الأوامر الفردية التي لا تمرر واحدًا تحصل على مثيل افتراضي مبني بواسطة CookieTransport (cookie_transport.py:49).
• نبضات القلب (المستوى الافتراضي للتفاصيل). الانتظارات الثلاثة الطويلة — نوم Throttle.backoff، طلب معلق قيد التنفيذ (CookieTransport._open_read)، وتدفق SSE خامل pplx-ask (ask_api.post_stream) — تصدر الآن نبضات INFO "لا يزال ينتظر" بحيث لا يُخلط بين الانتظار والتعليق. يتم النوم التراجعي في أجزاء (Throttle._sleep_with_heartbeat) مجموعها يساوي نفس الإجمالي، لذا فإن وتيرة/ميزانية مكافحة الحظر لم تتغير — فقط أصبحت مرئية؛ -v لا يزال يضيف تتبع DEBUG الكامل.
• --skip-auth-check + الفحص المؤجل. يمكن تخطي فحص جلسة إسناد الحساب عند بدء التشغيل (common.py، make_transport) لتجنب انتظار طويل عند بدء التشغيل على شبكة ضعيفة. كشبكة أمان، يقوم batch بتشغيل report_account_status لمرة واحدة (common.py) بمجرد تراكم الأخطاء العامة (batch_cmd.py)، محذرًا ما إذا كانت الكوكي منتهية الصلاحية، أو الحساب غير متطابق، أو الحساب سليم (لذا الأخطاء هي شبكة / تحديد معدل).