Proofreader API

Thomas Steiner

Alexandra Klepper

تاریخ انتشار: 12 سپتامبر 2025

توضیح دهنده	وب	برنامه های افزودنی	وضعیت کروم	قصد
GitHub	آزمایش مبدا	آزمایش مبدا	مشاهده کنید	قصد نمونه سازی

تصحیح فرآیند جستجو و تصحیح اشتباهات در دستور زبان، املاء و نقطه گذاری است. مرورگرها و سیستم عامل ها به طور فزاینده ای برای ابزارهای آهنگسازی خود، مانند Google Docs، تصحیح را ارائه می دهند.

با Proofreader API، می توانید با هوش مصنوعی داخلی، تصحیح تعاملی را برای برنامه وب یا برنامه افزودنی خود ارائه دهید. این API توابع زیر را ارائه می دهد:

• تصحیح : ورودی های کاربر را برای دستور زبان، املا و علائم نگارشی صحیح کنید.
• برچسب ها : هر تصحیح را بر اساس نوع خطا برچسب گذاری کنید.
• توضیح : تعریف خطا یا دلیل لزوم صحیح بودن آن به زبان ساده.

موارد استفاده کنید

دلایل زیادی وجود دارد که ممکن است بخواهید از Proofreader API استفاده کنید، به عنوان مثال:

• قبل از ارسال پست، اصلاحاتی را برای پیام‌های انجمن، نظرات درباره مقالات و ایمیل‌ها پیشنهاد دهید.
• اصلاحات را در حین یادداشت برداری فعال ارائه دهید.

آیا مورد استفاده شما گم شده است؟ برای به اشتراک گذاشتن نظرات خود به برنامه پیش نمایش اولیه بپیوندید.

شروع کنید

به نسخه آزمایشی اولیه Proofreader API بپیوندید که در Chrome 141 تا 145 اجرا می شود.

پشتیبانی را به لوکال هاست اضافه کنید

برای دسترسی به Proofreader API در لوکال هاست در طول آزمایش اولیه، باید Chrome را به آخرین نسخه به روز کنید . سپس، این مراحل را دنبال کنید:

1. به chrome://flags/#proofreader-api-for-gemini-nano بروید.
2. Enabled را انتخاب کنید.
3. روی راه اندازی مجدد یا راه اندازی مجدد کروم کلیک کنید.

برای آزمایش اولیه ثبت نام کنید

برای شروع استفاده از Proofreader API، مراحل زیر را دنبال کنید:

1. خط‌مشی استفاده‌های ممنوعه هوش مصنوعی Google را بپذیرید.
2. به نسخه آزمایشی اصلی Proofreader API بروید.
3. روی ثبت نام کلیک کنید و فرم را پر کنید. در فیلد مبدا وب، شناسه مبدا یا افزونه خود، chrome-extension://YOUR_EXTENSION_ID ارائه دهید.
4. برای ارسال، روی ثبت کلیک کنید.
5. رمز ارائه شده را کپی کنید و آن را به هر صفحه وب شرکت کننده در مبدا خود اضافه کنید یا در مانیفست برنامه افزودنی خود قرار دهید.
   • اگر در حال ساختن یک برنامه افزودنی هستید، دستورالعمل‌های آزمایشی مبدا برنامه‌های افزودنی را دنبال کنید
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، از تابع 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 هستند. ورودی کاملاً تصحیح شده را در صفت corrected و لیست اصلاحات را در آرایه 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);
}

خط مشی مجوز، iframes، و کارگران وب

به‌طور پیش‌فرض، Proofreader API فقط برای ویندوزهای سطح بالا و iframe‌های هم‌منشأ آن‌ها در دسترس است. دسترسی به API را می توان با استفاده از ویژگی Permission Policy allow="" به iframe های متقاطع واگذار کرد:

<!--
  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 تحت بحث فعال است و ممکن است در آینده تغییر کند. اگر این API را امتحان کردید و بازخورد دارید، مایلیم آن را بشنویم.

• توضیح دهنده را بخوانید ، سوالاتی را مطرح کنید و در بحث شرکت کنید.
• اجرای وضعیت Chrome را در Chrome مرور کنید
• موقعیت استانداردهای موزیلا و موقعیت استانداردهای WebKit را بخوانید.
• برای نگاهی اولیه به APIهای جدید و دسترسی به لیست پستی ما ، به برنامه پیش نمایش اولیه بپیوندید .
• اگر بازخوردی در مورد اجرای Chrome دارید، یک اشکال Chromium را ثبت کنید.

همه APIهای داخلی هوش مصنوعی را که از مدل‌ها، از جمله مدل‌های زبان بزرگ، در مرورگر استفاده می‌کنند، کشف کنید.