یک مدل را بخواهید تا یک قرارداد خدمات را بررسی کند و کار نسبتاً خوبی انجام می‌دهد: شرایط پرداخت نود روزه، مسئولیت نامحدود، بند انتقال داده بدون هیچ حفاظتی. پاسخ به صورت فهرستی در پنجرهٔ چت ظاهر می‌شود.

سپس قرارداد به یک همکار می‌رسد، که آن را باز می‌کند و یک سند تمیز می‌بیند. بررسی در برنامه‌ای دیگر، در گفتگویی که او در آن حضور نداشته، انجام شده است و به جملاتی که اکنون باید به‌دست‌خود پیدا کند، ارجاع داده می‌شود.

مسئلهٔ مدل نیست. مدل هیچ راهی برای نوشتن در فایل ندارد. این پست دربارهٔ دادن چنین راهی به آن است — با حدود صد خط 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() می‌آید یک‑پایه است. AnnotationBase.PageNumber صفر‑پایه است. اگر اولین مقدار را مستقیماً به دوم بدهید، هر حاشیه‌نویسی یک صفحه بیش از حد جلو می‌رود — و حاشیه‌نویس‌های مربوط به آخرین صفحه ناپدید می‌شوند، چون حاشیه‌نویسی که به صفحه‌ای که وجود ندارد ارجاع می‌دهد، هنگام ذخیرهٔ سند حذف می‌شود. هیچ استثنا، هیچ علامت‌گذاری، هیچ پیامی نیست.

دو مبدأ. 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 استفاده کنید تا یک مدل به‌جای آن‌ها تولید کند. درخواست یک فایل مارک‌داون تک است و تعویض مدل یعنی تعویض یک فراخوانی HTTP.

نسخهٔ گام‑به‑گام، با قواعد مختصات به‌صورت واضح، در مستندات موجود است: Write AI review comments into documents. اگر ترجیح می‌دهید این کار را از یک کلاینت چت نه از کد خودتان انجام دهید، سرور MCP GroupDocs.Annotation همین کار را از طریق Claude، Cursor یا Copilot انجام می‌دهد.