بليكس — دليل المستخدم

استخدام بليكس

بليكس هي البنية الأساسية لـ OrbitingFox. يمكن أن يكون بليكس ملاحظة أو مهمة أو حدث أو مصروف أو تذكير، أو أي قطعة أخرى من المعلومات التي ترغب في تسجيلها.

إنشاء بليكس

1. افتح بليكس من قائمة التطبيق.
2. انقر على بليكس جديدة واختر نوعًا: ملاحظة، مهمة، حدث، مصروف، تذكير، إلخ.
3. املأ العنوان، المحتوى، تاريخ الاستحقاق (للمهام / الأحداث)، وأي علامات.
4. احفظ. سيكون بليكس الخاص بك متاحًا على الفور عبر التطبيقات التي تدعم ربط بليكس.

أنواع بليكس

• ملاحظة — تسجيل نصي حر. فكر في ملاحظة لاصقة رقمية.
• مهمة — عنصر قابل للتنفيذ مع تاريخ استحقاق وعلامة إكمال.
• حدث — يظهر على تقويمك.
• مصروف — إدخال مالي؛ يغذي لوحة التحكم المالية.
• تذكير — يطلق إشعارًا في الوقت المستحق.

ربط بليكس

يمكن ربط بليكس بالأهداف، المشاريع، الأعمال، ومساحات FoxCom من أجل سياق أغنى. كما تظهر أيضًا على لوحة Kanban عند إضافتها إليها.

OrbitPilot

جميع بليكس الخاصة بك متاحة لـ OrbitPilot. اطرح أسئلة مثل "ما المهام المستحقة هذا الأسبوع؟" أو "ملخص مصروفي لشهر مايو."

صور داخل وصف بليكس (2026-08)

يمكنك لصق أو إسقاط صورة مباشرة في وصف بليكس — مفيدة للملاحظات حيث تنتمي الصورة بين السطور. هذه الصور الآن شكلها قابل للتعديل وسهلة العثور عليها:

• تغيير الحجم والتحريك: مرر فوق صورة لاختيارها، ثم اسحب أي مقبض زاوية لتغيير الحجم، أو استخدم شريط الأدوات الصغير لتحديد حجم (ص / م / ل / كامل) ومحاذاته يسار، وسط، أو يمين. يعمل مع اللمس على الهواتف والأجهزة اللوحية أيضًا.
• مُعرض في قسم الصور: تظهر الصور الموجودة داخل الوصف أيضًا في قائمة الصور الخاصة ببليكس (و"الصور الموجودة" في صفحة التحرير)، مُعلمة بشارة "في الملاحظة" بحيث يمكنك تمييزها عن الصور المرفقة بشكل منفصل. لا تحتوي هناك على زر حذف بقصد — لإزالة واحدة، احذفها داخل نص الوصف، حتى لا تسقط عن طريق الخطأ صورة تشير إليها ملاحظتك.
• فتح بحجم كامل: انقر على أي صورة (مرفقة أو داخل الملاحظة) لفتحها كبيرة في علامة تبويب جديدة.

للمطورين: يعيش وحدة التصغير / المحاذاة في templates/blink/_blink_form.html (تراكب مثبت على غلاف المحرر، خارج محتوى Quill القابل للتحرير حتى لا يقوم Quill بحذفه؛ العرض محفوظ كصفة width للصورة، والمحاذاة كـ text-align على الكتلة — كلاهما يمر عبر المُعقم render_description). تصدّر blink_extras.description_images الصور داخل الملاحظة (مطابقة للسياسة: data:image/* باستثناء svg، http(s)، موقع-relative). تتم فتح صور Data-URI عبر عنوان blob (templates/blink/_note_image_open_js.html) لأن المتصفحات تحظر التنقل في المستوى الأعلى إلى data: URL.

تنسيق ملاحظاتك & صفحة التحرير الأكثر ترتيبًا (2026-08)

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

• كيفية التنسيق: حدد الكلمات التي تريدها وانقر على نمط. إذا قمت فقط بوضع المؤشر داخل كلمة وانقر على نمط، سيتم تطبيقه على تلك الكلمة بأكملها — لا حاجة للاختيار. تذكر التعليمات تحت شريط الأدوات.
• الألوان والتسليط تحفظ مع الملاحظة وتظهر في صفحة بليكس.

أصبحت صفحة التحرير الآن منظمّة في بطاقات مصنفة بوضوح — تفاصيل بليكس، الصور، الملفات، والملاحظات الصوتية — لذلك كل قسم من السهل التعرف عليه. ت sit تحديث · معاينة · إلغاء الأزرار معاً تحت النموذج وتتم تكرارها في أسفل الصفحة، بحيث يمكنك الحفظ دون العودة إلى أعلى.

للمطورين: استخدام الألوان / التسليط عن طريق العوامل المضمنة في Quill (attributors/style/color + /background)؛ مُعقم الوصف (blink_extras.render_description) يتحقق من أنماط الإعلان بندًا ببند - النص المحاذاة + اللون / الخلفية بقيم hex / rgb() / rgba() / مسماة محفوظة، وكل شيء آخر (الموقع، url()، ...) يتم حذفه. تنسيق الكلمة عند المؤشر هو مساعد لالتقاط الماوس في _blink_form.html. شريط الإجراءات السفلي يقدم النموذج عبر form="blink-edit-form".

إبقاء بليكس واحد خاصًا من OrbitPilot (2026-08-23)

بعض الأشياء التي تسجلها ليست من شأن أحد آخر — حتى مساعدك. يحتوي كل بليكس الآن على مفتاح مدمج (انقر على "i" الصغيرة بجانبه لقراءة ما يقوم به)، "احتفظ ببليكس هذا خاصًا من OrbitPilot"، في أسفل علامة التبويب الأساسية على نموذج بليكس. **يكون في الوضع إيقاف التشغيل افتراضيًا**، مما يعني أن OrbitPilot يمكنه قراءته — لا تحتاج إلى تشغيل أي شيء.

قم بتشغيله وسيصبح بليكس خاصًا بك: لم يعد بإمكان OrbitPilot قراءته، كما يفقد الوصول إلى أنظمة بليكس المذكرات الصوتية والصور والملفات. يتم حذف أي شيء قد حفظه من ذلك بليكس على الفور — لا تحتاج إلى إعادة بناء أي شيء أو الانتظار. في مكتبتك، يرتدي بليكس شارة صغيرة خاص حتى تتمكن من رؤية بلمحة أي منها لا يمكن للذكاء الاصطناعي رؤيته.

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

المصطلحات: بليكس هي الكلمة الرئيسية (2026-08-23)

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

تحويل الاسم يتم بشكل تدريجي — انظر docs/brand/BLINK-RENAME-PLAN.md وdocs/BACKLOG.md §1c — ويتم حفظه بواسطة manage.py terminology_audit بالإضافة إلى adminapp/test_terminology.py، وهو آلية تكون عددها قد ينخفض ولكنه لا يرتفع أبدا.

معرفات الأكواد التي تقرأ blink متوقفة، وليست في انتظار العمل. max_winks هي خاصية حية Feature.key خلف حدود الخطط — إعادة تسميتها تجعل التحكم بالفشل مفتوحًا. ينطبق نفس الشيء على أسماء ملفات القوالب، أسماء URL، مفاتيح الجلسة، فئات CSS و{wink_title} - عناصر التسمية داخل المطالبات المحفوظة من قبل المسؤول. قائمة التجميد الكاملة موجودة في الخطة وفي terminology.ALLOWED_IDENTIFIERS.

"امسك واحدة أخرى" بعد حفظ بليكس (2026-08-28)

الشعار تم حفظ بليكس! ماذا بعد؟ على لوحة معلومات بليكس تقدم أربع خيارات. يأخذك ثلاثة منها إلى مكان آخر. الرابع، امسك واحدة أخرى، كان يشير إلى لوحة المعلومات — الصفحة التي كنت عليها بالفعل — لذلك أعادت تحميل كل شيء لكشف نموذج بليكس مفتوح بالفعل، فارغ بالفعل، بضع مئات من البيكسلات أسفل نفس الشاشة.

الآن يأخذك إلى ذلك النموذج بدلاً من ذلك: ينتقل إلى لوحة "امسك بليكس"، يفتحها إذا كانت متقلصة، ويضع المؤشر في العنوان حتى يمكن كتابة الفكرة التالية على الفور. لا إعادة تحميل للصفحة، لا شيء مفقود.

ملاحظة للمطورين: التحكم هو #blinkCatchAnother في templates/dashboard.html، وهو رابط إلى #blink-create-panel مع سلوك الفتح والتركيز في كتلة نصوص هذا النموذج. الشعار نفسه يتوقف على علامة السياق blink_just_saved (blink/views.py، تم تعيينها من ?blink_saved=1). مثبت من قبل blink/test_post_save_where_next.py، بما في ذلك أن الأزرار الثلاثة الأخرى ما زالت تترك الصفحة.

الوصف الطويل لم يعد يقفز إلى الأعلى (2026-08-28)

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

الآن تحتوي مربع التفاصيل على ارتفاع أقصى وتقوم بالتمرير داخل نفسها، كما تفعل المحررات عادة. يتم الاحتفاظ بمكانك، تبقى الصفحة بطول منطقي، ولا شيء مخفي — النص الطويل ببساطة يتدفق داخل المربع بدلاً من تمديد الصفحة.

لم يتغير شيء عن الكتابة أو الحفظ؛ فقط شكل المربع.

ملاحظات المطورين — لماذا حدث ذلك (BL-66)

السبب لم يكن خللًا في شيفرتنا. كان محرر الوصف منطقة قابلة للتحرير غير محدودة واحدة: مع وصف طويل قياس 4933px طولاً بعرض 375px. يركز عنصر ما يجعل المتصفح يقوم بتمرير ذلك العنصر إلى العرض، وبدأ العنصر آلاف البيكسلات فوق المؤشر — لذلك كان سلوك المتصفح صحيحًا وكان المحرر ببساطة الشكل الخطأ.

تم قياسه قبل وبعد، مع وصف مكون من 60 فقرة:

• قبل — 375px: scrollY 2379 → 134 عند إعادة التركيز؛ 1280px: 1032 → 0; الصفحة طولها 6729px
• بعد — 375px: 213 → 213 → 213; 1280px: 311 → 308; الصفحة طولها 2056px

التغيير موجود في templates/blink/_blink_form.html: #desc-editor يكتسب max-height + overflow-y: auto (420px، 260px تحت نقطة الانقطاع القياسية 575.98px)، وانتقل حجمه خارج style= مضمونة إلى أنماط القالب — لا يمكن تجاوز النمط المدمج بواسطة استعلام وسيط الهاتف، وهو السبب الذي أدى إلى ضرورة انتقال الاثنين معًا. أصبح التعبئة البيضاء --of-surface-strong رمزًا على .of-desc-editor-wrap جديدة، محاطة بحيث لا يرثها أي شيء آخر.

الاختبارات. blink/test_description_editor_scroll.py يحدد السقف، السقف الخاص بالهاتف، نقطة الانقطاع القياسية، وغياب الأنماط المدمجة. blink/test_description_editor_visual.py يقود Chromium الحقيقي ويقيس موقع التمرير عند 375 و 1280؛ يتجاوز حيث يكون Playwright غائبًا، لذا فلا تتأثر CI ولم تتم إضافة أي اعتماديات إليه.

فخ سجلات الملفات للاختبار التالي على الخادم المباشر: LiveServerTestCase هو TransactionTestCase ويحذف الجداول بعد كل اختبار، مما يأخذ معه صفوف خطة الزراعة. بدون خطة، يقوم التطبيق بتحويل إلى /billing/plans/، لذا يمر الاختبار الأول وكل ما يلي يتم تحميله مع صفحة 500. الحل هو إعادة زراعة ما تحتاجه الصفحة في setUp (عبر apps.get_model، دون أي استيراد عبر التطبيقات — تعد التداخل العددي تعد أيضًا في الاختبارات).