The Proofreader API

Thomas Steiner

Alexandra Klepper

تاريخ النشر: 12 سبتمبر 2025

شرح	الويب	الإضافات	حالة Chrome	النيّة بالشراء
Github	مرحلة التجربة والتقييم	مرحلة التجربة والتقييم	العرض	Intent to Prototype

التدقيق اللغوي هو عملية البحث عن الأخطاء النحوية والإملائية وأخطاء علامات الترقيم وتصحيحها. توفّر المتصفحات وأنظمة التشغيل بشكل متزايد ميزة التدقيق اللغوي في أدوات الكتابة، مثل مستندات Google.

باستخدام Proofreader API، يمكنك توفير تدقيق إملائي تفاعلي لتطبيق الويب أو الإضافة، مع تضمين الذكاء الاصطناعي. توفّر واجهة برمجة التطبيقات هذه الوظائف التالية:

• التصحيح: تصحيح الأخطاء النحوية والإملائية وأخطاء علامات الترقيم في البيانات التي يُدخلها المستخدم
• التصنيفات: صنِّف كل تصحيح حسب نوع الخطأ.
• التفسير: تحديد طبيعة الخطأ أو سبب ضرورة التصحيح بلغة بسيطة

حالات الاستخدام

هناك العديد من الأسباب التي قد تدفعك إلى استخدام واجهة برمجة التطبيقات Proofreader API، مثل:

• اقتراح تصحيحات لرسائل المنتدى والتعليقات على المقالات ورسائل البريد الإلكتروني، قبل إرسال المشاركة
• تقديم تصحيحات أثناء تدوين الملاحظات

هل حالة الاستخدام غير متوفّرة؟ يمكنك الانضمام إلى برنامج الاستخدام المبكر لمشاركة ملاحظاتك.

البدء

يمكنك الانضمام إلى مرحلة التجربة والتقييم لواجهة برمجة التطبيقات Proofreader API التي ستتوفّر في الإصدارات من 141 إلى 145 من Chrome.

إضافة دعم إلى localhost

للوصول إلى واجهة برمجة التطبيقات Proofreader API على المضيف المحلي أثناء مرحلة التجربة والتقييم، عليك تحديث Chrome إلى أحدث إصدار. ثم اتبع الخطوات التالية:

1. الانتقال إلى chrome://flags/#proofreader-api-for-gemini-nano
2. اختَر مفعّل.
3. انقر على إعادة التشغيل أو أعِد تشغيل Chrome.

الاشتراك في التجربة الأصلية

لبدء استخدام Proofreader API، اتّبِع الخطوات التالية:

1. يجب الموافقة على سياسة الاستخدام المحظور للذكاء الاصطناعي التوليدي من Google.
2. انتقِل إلى مرحلة التجربة والتقييم في Proofreader API.
3. انقر على تسجيل واملأ النموذج. في حقل "مصدر الويب"، أدخِل المصدر أو رقم تعريف الإضافة، chrome-extension://YOUR_EXTENSION_ID.
4. لإرسال الطلب، انقر على تسجيل.
5. انسخ الرمز المميّز المقدَّم وأضِفه إلى كل صفحة ويب مشارِكة على مصدرك أو أدرِجه في بيان Extension.
   • إذا كنت بصدد إنشاء إضافة، اتّبِع تعليمات التجربة الأصلية للإضافات.
6. بدء استخدام Proofreader API

مزيد من المعلومات حول كيفية بدء استخدام التجارب الأصلية

استخدام Proofreader API

لتحديد ما إذا كان النموذج جاهزًا للاستخدام، استدعِ الدالة Proofreader.availability(). إذا كانت الاستجابة للدالة availability() هي "downloadable"، استمِع إلى تقدّم التنزيل وأبلِغ المستخدم، لأنّ التنزيل قد يستغرق بعض الوقت.

const options = {
  expectedInputLanguages: ['en'],
};
const available = if (Proofreader.availability("downloadable") === true);

لتفعيل التنزيل وإنشاء مدقّق نحوي، تحقَّق من تفاعل المستخدم. بعد ذلك، استدعِ الدالة غير المتزامنة Proofreader.create().

const session = await Proofreader.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
  ...options,
});

إنشاء كائن Proofreader

لإنشاء مدقّق لغوي، استخدِم الدالة Proofreader.create().

const proofreader = await Proofreader.create({
  expectedInputLanguages: ["en"],
  monitor(m) {
    m.addEventListener("downloadprogress", e => {
      console.log(Downloaded ${e.loaded * 100}%);
    });
  }
};

تتضمّن الطريقة create() الخيارات التالية:

• expectedInputLanguages: مصفوفة من لغات الإدخال المتوقّعة.

لا تتوفّر الخيارات includeCorrectionTypes وincludeCorrectionExplanation من الشرح.

بدء تدقيق نص المستخدم

اتّصِل بالرقم proofread() للحصول على تصحيحات للنص المُدخَل:

const proofreadResult = await proofreader.proofread(
  'I seen him yesterday at the store, and he bought two loafs of bread.',
);

التصحيحات هي نوع من ProofreadResult. ابحث عن الإدخال المصحّح بالكامل في السمة correctedInput وقائمة التصحيحات في مصفوفة corrections:

let inputRenderIndex = 0;

console.log(proofreadResult.correction);

for (const correction of proofreadResult.corrections) {
  // Render part of input that has no error.
  if (correction.startIndex > inputRenderIndex) {
    const unchangedInput = document.createElement('span');
    unchangedInput.textContent = input.substring(inputRenderIndex, correction.startIndex);
    editBox.append(unchangedInput);
  }
  // Render part of input that has an error and highlight as such.
  const errorInput = document.createElement('span');
  errorInput.textContent = input.substring(correction.startIndex, correction.endIndex);
  errorInput.classList.add('error');
  editBox.append(errorInput);
  inputRenderIndex = correction.endIndex;
}

// Render the rest of the input that has no error.
if (inputRenderIndex !== input.length){
  const unchangedInput = document.createElement('span');
  unchangedInput.textContent = input.substring(inputRenderIndex, input.length);
  editBox.append(unchangedInput);
}

سياسة الأذونات وإطارات iframe وWeb Workers

تتوفّر واجهة برمجة التطبيقات Proofreader API تلقائيًا للنوافذ ذات المستوى الأعلى وإطارات iframe ذات المصدر نفسه. يمكن تفويض إذن الوصول إلى واجهة برمجة التطبيقات إلى إطارات iframe من مصادر متعددة باستخدام السمة allow="" في سياسة الأذونات:

<!--
  The hosting site at https://main.example.com can grant a cross-origin iframe
  at https://cross-origin.example.com/ access to the Proofreader API by
  setting the `allow="proofreader"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="proofreader"></iframe>

لا تتوفّر واجهة برمجة التطبيقات Proofreader API في Web Workers. ويرجع ذلك إلى صعوبة إنشاء مستند مسؤول لكل عامل من أجل التحقّق من حالة "سياسة الأذونات".

عرض توضيحي

يمكنك تجربة ساحة لعب Proofreader API.

التفاعل مع الملاحظات ومشاركتها

تخضع واجهة برمجة التطبيقات Proofreader API حاليًا لمناقشات نشطة، وقد تتغيّر في المستقبل. إذا جرّبت واجهة برمجة التطبيقات هذه وكانت لديك ملاحظات، يسعدنا تلقّيها.

• قراءة الشرح، طرح الأسئلة والمشاركة في المناقشة
• راجِع عملية التنفيذ في Chrome على حالة Chrome.
• يمكنك الاطّلاع على موقف Mozilla بشأن المعايير وموقف WebKit بشأن المعايير.
• الانضمام إلى برنامج استخدام الميزة قبل إطلاقها للاطّلاع على واجهات برمجة التطبيقات الجديدة قبل إطلاقها والانضمام إلى قائمتنا البريدية
• إذا كانت لديك ملاحظات حول طريقة تنفيذ Chrome لهذه الميزة، يُرجى إرسال تقرير عن خلل Chromium.

استكشِف جميع واجهات برمجة التطبيقات المُدمَجة والمستنِدة إلى الذكاء الاصطناعي التي تستخدم النماذج، بما في ذلك النماذج اللغوية الكبيرة، في المتصفّح.