انتقل إلى المحتوى

ترجمة آلية

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

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

العمليات غير المتصلة

الجانب الخالي من الشبكة في pplx_export: إعادة التوليد دون اتصال من JSON الخام، وخط أنابيب إعادة بناء العلاقات، وإثراء فهرس الخلفية، وآلة الحالة للحذف عن بُعد، وسلسلة كشف answer_variants. تحتفظ الأقسام بترقيمها الأصلي من نظرة عامة على البنية.

1. إعادة التوليد دون اتصال (إعادة العرض)

بعد إصلاحات طبقة العرض، أعد توليد جميع القطع الأثرية من JSON الخام بدون شبكة، وبطريقة متساوية النتائج. التنفيذ: commands/rerender_cmd.py (مفرد الخيط rerender rerender_cmd.py:105-190؛ دفعة cmd_rerender rerender_cmd.py:193-212).

flowchart TD
    IN[("&lt;out&gt;/*/*/*/raw_entries.json<br/>glob all thread directories (rerender_cmd.py:199)")] --> CHK{"raw_entries.json exists?"}
    CHK -->|"no"| SKIP["skip (counted as skipped)"]
    CHK -->|"yes"| P1["parse_turn per entry (parsers.py:173)<br/>sort by created_us, re-number index<br/>(rerender_cmd.py:57-60)"]
    P1 --> P2["Conversation rebuilt<br/>metadata = thread_metadata (rerender_cmd.py:65-70)<br/>conv._plain = doc"]
    P2 --> P3{"raw_blocks.json exists?"}
    P3 -->|"yes"| P4["conv._blocks loaded (rerender_cmd.py:91)<br/>PerplexityAdapter(None).sub_agents builds sub_map<br/>(None-transport pure data assembly, rerender_cmd.py:84-88, 138)"]
    P3 -->|"no"| P5["sub_map = {}"]
    P4 --> P6{"mode in computer/council?"}
    P6 -->|"yes"| P7["attach_workflow_blocks (rerender_cmd.py:93)<br/>attach_stub_workflows (rerender_cmd.py:97)<br/>collect_unconsumed_background (rerender_cmd.py:101)"]
    P6 -->|"no"| P8
    P5 --> P8["render_conversation → conversation.md<br/>render_turn × N → turns/turn_NNNN.md<br/>(rerender_cmd.py:170, 189)"]
    P7 --> P8
    P8 --> TJ{"--thread-json?"}
    TJ -->|"no"| OUT(("done: other files untouched"))
    TJ -->|"yes"| TJ1["collect_interruptions(conv, sub_map) (rerender_cmd.py:150)<br/>answer_variants rebuilt with load_archived's same implementation (rerender_cmd.py:83)"]
    TJ1 --> TJ2{"compare the two keys<br/>interruptions / answer_variants<br/>against existing thread.json"}
    TJ2 -->|"content changed"| TJ3["add/remove the two keys in place, then write; all other fields kept as-is (round-trip indent=1)<br/>(rerender_cmd.py:141-169)<br/>warn + append jsonl registration when variants are added/changed<br/>(rerender_cmd.py:163-166, see §18)"]
    TJ2 -->|"no change"| TJ4["no write — avoids library-wide mtime/diff noise"]

الانضباط:

  • بدون شبكة: يعيد PerplexityAdapter(None) استخدام طرق تجميع البيانات الخالصة فقط؛ لا يتم استدعاء أي طريقة عبر الإنترنت (get_thread إلخ).
  • متساوي النتائج: تعتمد القطع الأثرية فقط على الخام + العارض؛ إعادة التشغيل متطابقة بايت ببايت (مضمونة بواسطة اختبارات الانحدار اللقطة، §13).
  • الملفات الأخرى دون تغيير: تبقى المصادر و report.md والأصول كما هي؛ يبقى thread.json دون تغيير افتراضيًا — مع --thread-json يتم إضافة أو إزالة المفتاحين interruptions / answer_variants فقط.
  • --dry-run يسرد الدلائل فقط دون كتابة ملفات (rerender_cmd.py:204-206)؛ --limit N يأخذ أول N.

2. خط أنابيب إعادة بناء العلاقات دون اتصال

cmd_relations (misc_cmd.py:16) يعيد بناء رسم بياني لعلاقات المحادثات على مستوى المكتبة من البيانات الخام المؤرشفة بدون شبكة: يعيد استخدام خط أنابيب إعادة البناء دون اتصال الخاص بإعادة العرض load_archived_conversation (rerender_cmd.py:34) لاستعادة كل محادثة (تحليل/فرز/ترقيم الأدوار، إرفاق _plain/_blocks)، ويملأ conv.sub_agents على مستوى المحادثة عبر adapter.sub_agents خيطًا بخيط (misc_cmd.py:70-73؛ لا يقوم خط أنابيب التصدير بملء هذا الحقل، models.py:178-182)؛ يقوم الاحتياطي لإجابة الكمبيوتر (wf_block_answer) بملء turn.answer في هذه الطبقة، مما يوسع نطاق مسح المراجع (misc_cmd.py:74-79). الخيوط بدون بيانات خام تتحول إلى غلاف thread.json + conversation.md (يمكن اكتشاف حواف same_space / bare-uuid فقط، misc_cmd.py:61-66).

flowchart LR
    RAW["web_archive/*/*/*/raw_entries.json<br/>+ raw_blocks.json"] --> LA["load_archived_conversation<br/>(rerender_cmd.py:34, zero network)"]
    LA --> SUB["adapter.sub_agents → conv.sub_agents<br/>(misc_cmd.py:70-73)"]
    LA --> FB["wf_block_answer backfills turn.answer<br/>(misc_cmd.py:74-79)"]
    SUB --> BE["build_edges (relations.py:200)"]
    FB --> BE
    BE --> SS["same_space: same space<br/>dst = space:&lt;slug&gt;"]
    BE --> SP["same_prompt: first-query normalized equality<br/>(normalize_query, relations.py:111)<br/>in-cluster chaining by created_us (not cliques)<br/>query_source distinguishes scheduled-task reruns<br/>from manual resends (parsers.py:209-215)"]
    BE --> RF["references: answer text / citation URLs<br/>referencing other archived threads (incl. bare uuids)"]
    BE --> SA["subagent_of: main thread → subagent run<br/>dst = toolu_X run id (not a thread uuid)<br/>archived subagent threads recorded in evidence"]
    SS --> OUT[("web_archive/relations/<br/>edges.jsonl + graph.md")]
    SP --> OUT
    RF --> OUT
    SA --> OUT

انضباط القرار (2026-07-23): تم تأكيد آلية branch_of ولكن لا يوجد مثيل لها في الأرشيف — لم يتم بناء أي حواف؛ لا يمكن تحليل related_query من البيانات الموجودة — لم يتم بناء أي حواف أيضًا: من الأفضل فقدان حافة بدلاً من بناء حافة تخمينية. النطاق الملاحظ: 772 حافة / 21 مجموعة عبر الأرشيف (same_space 559 / subagent_of 154 / same_prompt 49 / references 10).

3. search-mode-backfill (إثراء search_mode للفهرس)

cmd_search_mode_backfill (search_mode_backfill_cmd.py:81) يثري الحقل الموثوق من المنصة search_mode في index/library_<account>.json: الخام المحلي أولاً (للخيوط المؤرشفة، المستخرج من entries[].search_mode لـ raw_entries.json، بدون شبكة)؛ فقط الخيوط بدون خام محلي تلجأ إلى جلب الخيط عبر الإنترنت. الكتابة تدمج وتحافظ على حقول الفهرس الموجودة (دلالات التحديث: مفاتيح الإثراء تستبدل، كل شيء آخر يبقى)، متساوية النتائج وقابلة للاستئناف، مع --limit للمجموعات الفرعية. صفوف الفهرس المثرية تجعل مرشح --mode للدفعة موثوقًا: index_row_matches_mode (batch_cmd.py:46) يحكم بواسطة search_mode للفهرس أولاً (SEARCH_MODE_MAP، normalize.py:50)، ويعود إلى الاستدلال فقط عندما يكون مفقودًا.

4. sync-deleted آلة الحالة للحذف عن بُعد

cmd_sync_deleted (sync_deleted_cmd.py:262) يحدد الخيوط "المحذوفة من قبل المستخدم/عن بُعد على جانب المنصة" ويسجل حالة نهائية، جنبًا إلى جنب مع منتهية الصلاحية. تحديد المرشح هو فرق اتحاد جميع فهارس الحسابات: يعتبر الخيط المؤرشف ok مرشحًا فقط عندما يختفي من جميع ملفات index/library_*.json (يظهر خيط export_via عبر الحسابات فقط في فهرس مالكه، لذا فإن فرق حساب واحد سيعطي إيجابية خاطئة؛ find_candidates، sync_deleted_cmd.py:148)؛ يتم تخطي الفهارس المفقودة/غير القابلة للقراءة بأمان مع تسجيل السبب. التشغيل الجاف الافتراضي دون اتصال يسرد المرشحين فقط (بدون شبكة، بدون تغييرات في الملفات)؛ --online يتحقق من الخيط خيطًا بخيط باستخدام GET: ENTRY_DELETED / ENTRY_EXPIRED / 404 → تأكيد الحذف، state.mark_deleted (state.py:136) + شاهد قبر thread.json (mark_thread_json_remote_deleted، sync_deleted_cmd.py:215).

stateDiagram-v2
    [*] --> ok : archived (batch_state = ok)
    ok --> candidate : gone from the union of all account indexes<br/>(find_candidates, sync_deleted_cmd.py:148)
    candidate --> skipped : index missing/unreadable<br/>safely skipped, reason recorded
    candidate --> listed : offline dry-run lists only<br/>(no network, no file changes)
    listed --> deleted : --online verifies one by one<br/>ENTRY_DELETED / ENTRY_EXPIRED / 404<br/>(_confirm_deleted, sync_deleted_cmd.py:247)
    deleted --> [*] : terminal mark_deleted (state.py:136) + thread.json tombstone<br/>plan_incremental trims it like expired<br/>(incremental.py:74-75, 84)

طبقات أنواع الأخطاء: يرث EntryDeletedError من EntryExpiredError (يأتي التحقق من 400 مع نص يحتوي على ENTRY_DELETED قبل ENTRY_EXPIRED، cookie_transport.py:93-98)؛ يجب على الدفعة التقاط الفئة الفرعية قبل الفئة الأم (batch_cmd.py:163-174 قبل 175-183)، وإلا سيتم تسجيل المحذوف خطأً كمنتهي الصلاحية. واجهة برمجة تطبيقات الحذف نفسها: DELETE /rest/thread/delete_thread_by_entry_uuid (يتم أخذ read_write_token من أول entries[].read_write_token غير فارغ؛ تم التحقق عمليًا 10/10 عمليات حذف ناجحة على خيوط اختبار ذاتية الإنشاء وخيوط مساحة BOT).

5. سلسلة كشف answer_variants لإعادة كتابة الإجابة

البدائل المستبدلة في "إعادة كتابة الإجابة / تجارب A-B" للمنصة غير مرئية من جانب واجهة برمجة التطبيقات — الإجابة المحددة مرئية، بينما يترك الشقيق الخاسر أثرًا فقط في entries[].side_by_side_metadata، وقد يتم تطهيره بواسطة المنصة (تم إثبات روابط الأشقاء الميتة: 403 VIEW_THREAD_NOT_ALLOWED + إعادة توجيه SPA إلى الصفحة الرئيسية؛ راجع مرجع واجهة برمجة التطبيقات §5.2). تجعل سلسلة الكشف "حدثت إعادة كتابة" قابلة للملاحظة والتتبع:

flowchart LR
    E["entries[].side_by_side_metadata<br/>narrowed criteria"] --> CAV["parsers.collect_answer_variants<br/>(parsers.py:589)"]
    CAV --> AD["adapter.get_thread warns on online hits<br/>(adapter.py:141-147)"]
    CAV --> RR["re-render offline rebuild<br/>warns only on additions/changes (rerender_cmd.py:163-166)"]
    AD --> LOG["variant_log.warn_detections (variant_log.py:65)<br/>single WARNING line ANSWER_VARIANT_DETECTED (variant_log.py:45)<br/>full locating fields + handling guidance, grep-able"]
    RR --> LOG
    AD --> TJ["thread.json.answer_variants registration<br/>(fs_writer.py:247-252)"]
    RR --> TJ
    TJ --> JSONL[("index/answer_variants_log.jsonl<br/>append_registry (variant_log.py:76)<br/>dedup by (web_uuid, entry_uuid), idempotent")]
    LOG --> B["batch summary surfaces ⚠ hit-thread count<br/>(batch_cmd.py:214-223)"]
    JSONL --> B
  • معايير ضيقة: يتم قبول الإشارات الموثوقة فقط من side_by_side_metadata؛ يتم تسجيل حقول التحديد الكاملة (معرف الخيط الكامل + uuid8، العنوان، entry_uuid، sibling_uuid، selection_status، experiment_role) بالإضافة إلى إرشادات المعالجة؛ التنسيق موجود في format_detection (variant_log.py:53).
  • متساوي النتائج: يقوم jsonl بإزالة التكرارات بناءً على (web_uuid، entry_uuid)؛ التسجيلات المكررة من المسار عبر الإنترنت (source=online) والمسار دون اتصال (source=offline) لا تنتج صفوفًا مكررة؛ يحذر إعادة العرض فقط عندما يتغير محتوى البديل، لذا فإن عمليات إعادة التشغيل على مستوى المكتبة لا تسبب إزعاجًا.
  • تدفق المعالجة: عند حدوث إصابة، قم بتأكيد الإجابة البديلة يدويًا في أقرب وقت ممكن وسجلها (قد يتم تطهير البديل بواسطة المنصة ولا يمكن استرداده عبر واجهة برمجة التطبيقات)؛ التدفق الكامل موجود في مرجع واجهة برمجة التطبيقات §5.2.