Oil UI
منهجية التصميم · المراجعة العمياء للشاشات الحقيقية

لقطات الشاشات الفعلية والمراجعة البصرية العمياء عبر وكيل فرعي لواجهات الذكاء الاصطناعي

الوكيل الذي يقرأ شيفرة JSX وفئات Tailwind الخاصة به سيقرّر بارتياح أن الشاشة تبدو «نظيفة ومتوازنة» بينما يعاني التصيير الفعلي في المتصفح من التفاف العناوين على ثلاثة أسطر، وتسميات رمادية غير مقروءة فوق خلفية داكنة، وشبكة مائلة التوازن. يتعامل Oil UI مع التصيير الفعلي في المتصفح ونقد الوكيل الفرعي الخالي من السياق كخطوتين إلزاميتين قبل اعتبار أي واجهة منتهية.

النقاط الأساسية

الشيفرة المصدرية ليست هي الواجهة

احكم على التخطيطات حصراً من بكسلات المتصفح الحقيقية المصيّرة عند الأبعاد المستهدفة (1440×900، 390×844، 1920×720).

نقطة رئيسية 2

الوكيل الذي كتب الكود منحاز لنواياه؛ تشغيل وكيل فرعي جديد لا يرى سوى اللقطات ينتج نقداً صادقاً.

افحص ثلاثة منظورات

لقطات الصفحة الكاملة بنسبة 100% للإيقاع، وقصاصات 200% للمحاذاة وانضباط الحدود، والصور مشوّشة النص لوزن الكتل.

نقطة رئيسية 4

تتحقّق اللقطات من الحِرفية الثابتة، بينما يؤكد النقر والكتابة عبر الصفحة الحية أن الحالات والأدراج والتعافي من الأخطاء تعمل فعلاً.

بين الصفحات · دار نشر مستقلةالعدد 07 · الخريف

تسوية مستحقات المساهمين

الاستحقاق 20 نوفمبر
الإجمالي المستحق¥8,640.00
2 جاهزان · 1 بانتظار البيانات البنكية
المساهم والعملصافي المكافأة (¥)الحالة
Lin Yaoنزهة بمحاذاة الماء · مقال3,200.00جاهز
Chen Zhouالجانب الآخر للأشياء · تصوير2,880.00جاهز
Xu Nanدراسات الفناء · رسم2,560.00تنقص بيانات بنكية
تُرحّل السجلات غير المكتملة تلقائياً
ثبّت الـ Skill المجاني مفتوح المصدر Oil UI
npx skills add oil-oil/oil-ui

يتطلب نموذجاً يدعم الصور وبيئة متصفح محلية قادرة على تصيير الصفحات والتقاطها.

لماذا يفوّت فحص الشيفرة المصدرية العيوب البصرية

في الشيفرة المصدرية، يبدو صف flex مع justify-between مرتباً. لكن في شاشة حقيقية بعرض 390px مع عنوان منتج من 32 حرفاً وثلاثة أزرار إجراءات، يسحق الصف نفسه الأزرار إلى كبسولات طويلة غير مقروءة. وبالمثل، لا تكشف فئات الألوان في الكود متى يختفي النص الثانوي فوق خلفية داكنة.

وتعتمد كثير من أدق التفاصيل في معرض Oil UI على سلوك أبعاد الشاشة الفعلي: في Yantu (نظام معلومات وترفيه للسيارة بدقة 1920×720)، يؤدي الاقتراب من منعطف إلى تكبير إرشاد الملاحة وخفت عناصر التحكم بالوسائط؛ وفي Splitwater (ساعة سباحة بدقة 198×242، DPR=4)، يسيطر رقم عملاق واحد على الشاشة المبللة؛ وفي Forkside (دروس شطرنج)، تؤدي نقلة الحصان الصحيحة إلى إضاءة خطي هجوم الشوكة في آنٍ واحد. ولا يؤكد صمود هذه الحالات إلا التصيير الحي.

الطبقات الأربع للتحقق البصري في Oil UI
طبقة الفحصكيف تعملالعيوب التي تلتقطها
التقاط الشاشة بنسبة 100%لقطات كاملة للشاشة وللتمرير الكامل بدقة 1440×900 (سطح المكتب) أو 390×844 (الهاتف)الإجراءات الأساسية المدفونة، وارتفاعات الأقسام الرتيبة، وإيقاع التمرير المكسور، والتذييلات المقصوصة
قصاصات تفاصيل 200%قصاصات مكبّرة 2× للترويسات وصفوف الجداول وحقول النماذج وباقات التسعيرالحدود المزدوجة، والأعمدة الرقمية غير المتحاذية، والهوامش المتفاوتة، والتعليقات ضعيفة التباين
فحص بنية الكتل المشوّشةتشويش النص أو تصغيره بحيث لا يبقى مرئياً سوى الكتل المكانية وألوان التمييزالتخطيطات المثقلة من الأعلى أو المائلة، وألوان التمييز المتنافسة، والشبكات الرتيبة من الصناديق المتطابقة
جولة تفاعلية حيةالنقر والكتابة وسحب أشرطة التمرير وإطلاق حالات الخطأ في المتصفحالأزرار المعطّلة، والقوائم المنبثقة التي تغطي سياقاً مهماً، وتعطّل التعافي من التحقق، وعدم تزامن الحالة

كيف تعمل المراجعة العمياء عبر وكيل فرعي خالٍ من السياق

اطلب من الوكيل المؤلف نقد لقطته الخاصة وسيبرر أخطاءه غالباً لأنه يتذكر الـ prompt الذي كان يحاول إرضاءه.

يكسر Oil UI هذا التحيز التأكيدي عبر إطلاق وكيل فرعي منفصل لا يتلقى أي شيفرة مصدرية ولا أي سجل تنفيذ — فقط لقطات PNG المصيّرة وجملة من سطر واحد تشرح ما هو المنتج. ويتصرف المراجع الأعمى كمستخدم متطلب يزور الصفحة لأول مرة، فيرصد التباعد الضيق وبقايا قوالب الذكاء الاصطناعي وضعف التباين.

  1. التقط لقطات حتمية لكل حالة مطلوبة

    يفتح الوكيل الرئيسي الصفحة المشغّلة في متصفح بدون واجهة رسومية ويلتقط العرض الافتراضي وحالات التفاعل النشطة ونقاط توقف الجوال.

  2. سلّم الصور إلى وكيل فرعي جديد دون أي سياق برمجي

    يفحص المراجع اللقطات مقابل معايير القراءة والتسلسل الهرمي ومكافحة النمطية في Oil UI ويعيد قائمة ملموسة بالعيوب البصرية.

  3. أصلح العيوب واحذف الفوضى وأعد الالتقاط

    يعالج الوكيل الرئيسي كل مشكلة مبلّغ عنها في الكود ويلتقط لقطة جديدة للتحقق من الإصلاح قبل إنهاء المهمة.

قالب prompt لإطلاق مراجعة عمياء للقطات الشاشة

كلما عملت شاشة مسودة وظيفياً لكنها لا تزال تبدو غير متقنة تماماً، نفّذ تمريرة المراجعة هذه:

prompt لالتقاط الشاشة الفعلية والمراجعة العمياء عبر وكيل فرعي
شغّل التحقق البصري لـ Oil UI والمراجعة العمياء عبر وكيل فرعي على الشاشة الحالية:
1. افتح الصفحة الحية في متصفح محلي والتقط صوراً بدقة 1440×900 (سطح المكتب) و390×844 (الجوال)، مع تغطية الحالة الافتراضية و[الحالة 1 / الحالة 2].
2. أطلق وكيلاً فرعياً جديداً دون أي سياق برمجي. مرّر له اللقطات وملخص المنتج فقط، واطلب منه نقد: بقايا قوالب الذكاء الاصطناعي، والنصوص ضعيفة التباين، والهوامش الضيقة، والأعمدة غير المتحاذية، وعدم وضوح بؤرة الشاشة الأولى.
3. أصلح كل مشكلة يثيرها المراجع الأعمى وأعد التقاط الصور للتأكيد.

يعمل تلقائياً في الوكلاء الذين يدعمون الوكلاء الفرعيين وفحص الصور، مثل Claude Code و Codex.

أمثلة حية و prompts من المعرض

تصفح المجموعة →
Oil UI Pro

Oil UI Pro: حتى 3 جولات من المراجعة العمياء نحو 9/10 قبل الإطلاق

يجري الـ Skill المجاني تمريرة مراجعة واحدة لأخطاء التخطيط الواضحة. أما للإطلاقات الموجهة للعملاء، فيضيف Oil UI Pro فحوصات حرفية ضد النمطية، وتتبّع مهام تفاعلياً حياً، وصقلاً عميقاً اختيارياً حتى 3 جولات يستهدف 9/10 ($19.99 دفعة واحدة، تحديثات مدى الحياة).

استكشف Oil UI Pro →
نسخ أمر تثبيت Pro
npx github:oil-oil/oil-cli install oil-ui-pro

الأسئلة الشائعة

ماذا يحدث إذا لم تستطع بيئة وكيلي فتح متصفح أو فحص الصور؟

يظل تأطير التوصيف وإرشاد الفئة وقواعد مكافحة النمطية في Oil UI مفيداً أثناء توليد الكود، لكن دون متصفح حقيقي وفحص للصور لن يرى الوكيل البكسلات المصيّرة ولن يجري مراجعات بصرية عمياء. للحصول على أفضل النتائج، اقرن Oil UI بـ Playwright أو أداة متصفح محلية.

لماذا أفحص قصاصات مكبّرة 200% بالإضافة إلى لقطات الصفحة الكاملة؟

تضغط لقطات الصفحة الكاملة الجداول الكثيفة وعناصر النماذج بما يكفي لإخفاء انحرافات 1px والحدود المتصادمة والنصوص الثانوية الباهتة. أما قصّ عناصر التحكم الأساسية عند 200% فيجعل أخطاء الطباعة الدقيقة والتباعد واضحة بلا لبس.

ماذا يكشف تشويش النص أو تغطيته أثناء المراجعة؟

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

كم جولة من المراجعة العمياء تحتاج الشاشة الاعتيادية؟

تلتقط جولة إلى جولتين الغالبية العظمى من مشكلات التباعد والتباين والنمطية في الشاشات اليومية. أما لصفحات الهبوط الرئيسية أو مساحات العمل المعقدة، فتدفع حلقة Oil UI Pro ذات الجولات الثلاث الحِرفية خطوة أبعد بوضوح.

أدلة ذات صلة

دليل تصميم الواجهات مع Claude Code ↗دليل تصميم الواجهات مع Codex ↗معالجة نمطية واجهات الذكاء الاصطناعي ↗