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

ثم ينتقل العقد إلى زميل، يفتحه ويرى مستندًا نظيفًا. المراجعة تكون في تطبيق آخر، في محادثة لم يكونوا جزءًا منها، مرتبطة بجمل عليهم الآن العثور عليها يدويًا.

النموذج ليس هو المشكلة. لا يمتلك طريقة للكتابة في الملف. هذه المقالة تتحدث عن إعطائه واحدة — باستخدام حوالي مئة سطر من C# و GroupDocs.Annotation لـ .NET، بحيث يقوم نفس الكود بتعليم PDF و Word و Excel و PowerPoint من جانب الخادم، دون إضافة Word ولا امتداد متصفح.

العينة الكاملة على GitHub: ai-document-review-annotations-net.

حافظ على صغر حجم العقد مع النموذج

لا تطلب من النموذج إحداثيات. اطلب منه النص وتعليقًا:

[
  {
    "quote": "pay all invoices within ninety days",
    "comment": "Ninety-day payment terms are three times our standard. Ask for thirty days.",
    "severity": "high"
  }
]

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

كل ما تبقى يتبع هذه الحقول الثلاثة، ولا يعتمد على تنسيق الملف. لهذا السبب يمكن لمطالبة واحدة أن تخدم PDF و .docx و جدول بيانات.

العثور على الاقتباس في الصفحة

GroupDocs.Annotation يعيد نص كل صفحة مع هندستها:

using Annotator annotator = new Annotator("service-agreement.docx");
IDocumentInfo info = annotator.Document.GetDocumentInfo();

foreach (PageInfo page in info.PagesInfo)
    foreach (TextLineInfo line in page.TextLines)
        Console.WriteLine($"{line.Text} @ {line.LeftIndent},{line.TopIndent} {line.Width}x{line.Height}");

نفس الاستدعاء يعمل مع PDF و Word و Excel و PowerPoint — وهو الجزء الذي لا تستطيع أدوات الـ Word فقط القيام به.

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

القاعدتان اللتان تحددان موضع العلامة

هذا هو المكان الذي غالبًا ما يخطئ فيه المحاولة الأولى، لذا من المفيد توضيحه صراحة.

أرقام الصفحات تُحسب مرتين. PageInfo.PageNumber من GetDocumentInfo() هو مبني على 1. AnnotationBase.PageNumber هو مبني على 0. إذا مررت الأول مباشرة إلى الثاني فإن كل تعليق سيظهر صفحة واحدة أبعد — والتعليقات الموجهة للصفحة الأخيرة تختفي، لأن التعليق الموجه إلى صفحة غير موجودة يُحذف عند حفظ المستند. لا استثناء، لا علامة، لا رسالة.

مصدران. TextLineInfo و AreaAnnotation.Box يقاسان من الزاوية العلوية اليسرى للصفحة. علامات النص — HighlightAnnotation.Points وما يرتبط بها — تقاس من الزاوية السفلية اليسرى، وهو ما يستخدمه PDF نفسه. سطر عند TopIndent = t بارتفاع h على صفحة بارتفاع H يمتد إذًا إلى H - t - h حتى H - t.

العضو الأصل ترقيم الصفحات
PageInfo, TextLineInfo أعلى‑يسار مبني على 1
AnnotationBase.PageNumber — مبني على 0
AreaAnnotation.Box أعلى‑يسار —
HighlightAnnotation.Points أسفل‑يسار —
PreviewOptions.PageNumbers — مبني على 1

كتابة النتيجة في المستند

User reviewer = new User { Id = 1, Name = "AI reviewer", Role = Role.Editor };

float top    = (float)(page.Height - box.Y);
float bottom = (float)(page.Height - box.Y - box.Height);

annotator.Add(new HighlightAnnotation
{
    PageNumber = page.PageNumber - 1,
    BackgroundColor = 0xFFE699,
    Opacity = 0.5,
    Message = finding.Comment,
    CreatedOn = DateTime.Now,
    User = reviewer,
    Points = new List<Point>
    {
        new Point(left, top),  new Point(right, top),
        new Point(left, bottom), new Point(right, bottom)
    },
    Replies = new List<Reply>
    {
        new Reply
        {
            Comment = $"Severity: {finding.Severity}. Reply to accept or reject this remark.",
            RepliedOn = DateTime.Now,
            User = reviewer
        }
    }
});

annotator.Save("service-agreement.reviewed.docx");

افتح النتيجة في Word وستجد مستندًا مراجَعًا عاديًا: العبارة مميزة، التعليق في الهامش، رد تحتها ينتظر إجابة. افتحه في Acrobat وسترى تمييزًا مع ملاحظة. لا شيء فيه يقول “تم إنتاجه بواسطة آلة” إلا اسم المؤلف — وهذا هو الهدف.

تفصيلان يستحقان السرقة:

  • لا تكرر الرسالة في الرد. Word يعرض كلاهما، لذا ستظهر الجملة نفسها مرتين في الهامش. دع الرسالة تحمل النتيجة والرد يفتح الخيط.
  • الألوان تقريبية في Word. BackgroundColor هو 0xRRGGBB وPDF يحافظ عليه بدقة، لكن Word لديه لوحة ألوان ثابتة للتمييز ويقرب إلى الأقرب. اختر مستويات الخطورة بحيث تظل مميزة بعد التقريب.

الجزء الذي يجعل التجربة آمنة

كل علامة تحمل مؤلفًا، لذا يمكن سحب كل المرور المكتوب آليًا دون لمس كلمة كتبها شخص:

annotator.Remove(annotator.Get().Where(a => a.User?.Name == "AI reviewer").ToList());

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

جرّبها

git clone https://github.com/groupdocs-annotation/ai-document-review-annotations-net.git
cd ai-document-review-annotations-net
dotnet run --project src/AiReview -- review samples/service-agreement.docx

العينة تُرفق ملف نتائج لذا تعمل دون اتصال؛ اضبط ANTHROPIC_API_KEY واستخدم llm-review لجعل نموذج ينتجها بدلاً من ذلك. المطالبة هي ملف markdown واحد، وتبديل النموذج يعني تبديل مكالمة HTTP واحدة.

الإصدار خطوة بخطوة، مع قواعد الإحداثيات موضحة، موجود في الوثائق: Write AI review comments into documents. إذا كنت تفضّل تشغيل هذا من عميل دردشة بدلًا من كودك الخاص، فإن GroupDocs.Annotation MCP server يقوم بنفس المهمة عبر Claude أو Cursor أو Copilot.