عرض PDF

# عارض PDF — سير العمل التفاعلي للمستندات

لديك إمكانية الوصول إلى خادم PDF محلي يعرض المستندات في عارض مباشر ويتيح لك إضافة تعليقات توضيحية وملء النماذج وإضافة التوقيعات مع ردود فعل بصرية فورية.

## متى تستخدم هذه المهارة

**استخدم عارض PDF عندما يريد المستخدم التفاعلية:** - "أظهر لي هذا العقد" / "افتح هذه الوثيقة" - "أبرز الشروط الرئيسية دعني أراجعها" - "ساعدني في ملء هذا النموذج" - "وقع على الصفحة 3" / "أضف أحرفي الأولى على كل صفحة" - "ضع ختم سري" / "ضع علامة موافق عليه" - "ساعدني في الاطلاع على هذا المستند وأضف تعليقات على الأجزاء المهمة"

**لا تستخدم العارض للمعالجة البسيطة:** - "ملخص هذا PDF" → استخدم أداة القراءة المدمجة مباشرة - "ماذا تقول الصفحة 5؟" → استخدم القراءة - "استخرج الجدول من القسم 3" → استخدم القراءة

قيمة العارض تكمن في عرض المستند والتعاون على التعليقات التوضيحية — وليس في تدفق النص إليك.

## الأدوات

### `list_pdfs` إدراج ملفات PDF المحلية المتاحة والمجلدات المحلية المسموح بها. بدون معاملات.

### `display_pdf` افتح ملف PDF في عارض تفاعلي. **استدعِ مرة واحدة لكل مستند.** - `url` — مسار الملف المحلي أو عنوان URL على HTTPS - `page` — الصفحة الأولية (اختياري، القيمة الافتراضية 1) - `elicit_form_inputs` — إذا كانت `true`، تطالب المستخدم بملء حقول النموذج قبل العرض (استخدمها لملء النماذج التفاعلية)

يعيد `viewUUID` — مرره إلى كل استدعاء `interact`. استدعاء `display_pdf` مرة أخرى ينشئ عارض **منفصل**؛ استدعاءات interact مع UUID الجديد لن تصل إلى الذي ينظر إليه المستخدم.

يعيد أيضاً `formFields` (الاسم والنوع والصفحة وصندوق الحدود) إذا كان لدى PDF حقول قابلة للملء — استخدم هذه الإحداثيات لموضع التوقيع.

### `interact` جميع الإجراءات اللاحقة بعد `display_pdf`. مرر `viewUUID` بالإضافة إلى أمر واحد أو أكثر. **جمّع أوامر متعددة في استدعاء واحد** عبر مصفوفة `commands` — يتم تنفيذها بالتسلسل. أنهِ الدفعات بـ `get_screenshot` للتحقق من التغييرات بصرياً.

**إجراءات التعليقات التوضيحية:** - `add_annotations` — أضف علامات (انظر الأنواع أدناه) - `update_annotations` — عدّل الموجود (معرّف + نوع مطلوب) - `remove_annotations` — احذف حسب مصفوفة المعرفات - `highlight_text` — ابحث تلقائياً عن النص حسب الاستعلام وأبرزه (أفضل من المستطيلات اليدوية للعلامات النصية)

**إجراءات الملاحة:** - `navigate` (صفحة)، `search` (استعلام)، `find` (استعلام، صامت)، `search_navigate` (matchIndex)، `zoom` (مقياس 0.5–3.0)

**إجراءات الاستخراج:** - `get_text` — استخرج النص من نطاقات الصفحات (حد أقصى 20 صفحة). استخدمه للقراءة لتقرير ما يجب التعليق عليه، وليس للملخصات - `get_screenshot` — احصل على صورة الصفحة (تحقق من التعليقات التوضيحية)

**إجراء النموذج:** - `fill_form` — ملء الحقول المسماة: `fields: [{name, value}, ...]`

## أنواع التعليقات التوضيحية

جميع التعليقات التوضيحية تحتاج `id` (سلسلة فريدة)، `type`، `page` (مفهرسة من 1). الإحداثيات هي نقاط PDF (1/72 بوصة)، الأصل **أعلى يسار**، Y يزداد نزولاً. الرسالة الأمريكية 612×792pt.

| النوع | الخصائص الرئيسية | الاستخدام | |-------|------------------|-----------| | `highlight` | `rects`، `color?`، `content?` | ضع علامة على النص المهم | | `underline` | `rects`، `color?` | شدّد على الشروط | | `strikethrough` | `rects`، `color?` | ضع علامة على الحذف | | `note` | `x`، `y`، `content`، `color?` | تعليقات ملاحظة لاصقة | | `freetext` | `x`، `y`، `content`، `fontSize?` | نص مرئي على الصفحة | | `rectangle` | `x`، `y`، `width`، `height`، `color?`، `fillColor?` | مناطق صندوقية | | `circle` | `x`، `y`، `width`، `height`، `color?`، `fillColor?` | مناطق دائرية | | `line` | `x1`، `y1`، `x2`، `y2`، `color?` | ارسم خطوط/أسهم | | `stamp` | `x`، `y`، `label`، `color?`، `rotation?` | موافق عليه، مسودة، سري، إلخ | | `image` | `imageUrl`، `x?`، `y?`، `width?`، `height?` | **التوقيعات والأحرف الأولى**، الشعارات |

**التعليقات التوضيحية للصور** تقبل مسار ملف محلي أو عنوان HTTPS URL (بدون بيانات: URIs). يتم الكشف عن الأبعاد تلقائياً إذا تم حذفها. يمكن للمستخدمين أيضاً سحب وإفلات الصور مباشرة على العارض.

## سير العمل التفاعلي

### التعليقات التوضيحية التعاونية (محركة بالذكاء الاصطناعي) 1. `display_pdf` لفتح المستند 2. `interact` → `get_text` على نطاق الصفحة ذات الصلة لفهم المحتوى 3. اقترح دفعة من التعليقات التوضيحية على المستخدم (اشرح ما ستضع علامة عليه) 4. بعد الموافقة، `interact` → `add_annotations` + `get_screenshot` 5. أظهر للمستخدم، اطلب التعديلات، كرر العملية 6. عند الانتهاء، ذكّرهم بأنهم يمكنهم تنزيل PDF المعلّق من شريط أدوات العارض

### ملء النموذج (بصري، وليس برمجي) على عكس أدوات النموذج بدون رأس، هذا يعطي المستخدم **ردود فعل بصرية مباشرة** ويتعامل مع النماذج الغامضة/غير المسماة حيث تكون التسمية مطبوعة على الصفحة بدلاً من بيانات حقل البيانات.

1. `display_pdf` — افحص `formFields` المرجوع (الاسم والنوع والصفحة وصندوق الحدود) 2. إذا كانت أسماء الحقول غامضة (`Text1`، `Field_7`)، `get_screenshot` للصفحات واربط صناديق الحدود بالتسميات البصرية 3. اطلب من المستخدم القيم باستخدام التسميات **البصرية**، أو استنتج من السياق 4. `interact` → `fill_form`، ثم `get_screenshot` لعرض النتيجة 5. يؤكد المستخدم أو يعدّل مباشرة في العارض

للنماذج البسيطة المسماة جيداً، `display_pdf` مع `elicit_form_inputs`