تامین‌کنندهٔ شما خریداری شد و «ACME Corp» اکنون در هر قرارداد، برنامه‌زمانی، بودجه و اسلاید دکی که به آن اشاره می‌کند به «Globex Ltd» تبدیل شده است. با اجرای سرور GroupDocs.Editor MCP به‌صورت محلی، Claude Desktop، Cursor یا Copilot این کار را به‌صورت دسته‌ای انجام می‌دهند: برای هر فایل در پوشه replace_text را فراخوانی می‌کند، قالب‌بندی را حفظ می‌کند، تعداد مواردی که تغییر داده شده را گزارش می‌دهد، و برای فایل‌هایی که هرگز نام قدیمی را ذکر نکرده‌اند هیچ‌چیزی نمی‌نویسد. هیچ‌چیزی بارگذاری نمی‌شود و هیچ‌یک از اصلی‌ها بازنویسی نمی‌شود:

«ACME Corp» را به «Globex Ltd» در هر سندی در پوشهٔ contracts تغییر نام بده، قالب‌بندی را حفظ کن، و برای هر فایل یک شمارش بده.

نسخهٔ گام‌به‌گام در مستندات موجود است: چگونه متن را در تمام اسناد یک پوشه جستجو و جایگزین کنیم بدون خراب کردن قالب‌بندی.

چرا این کار برای ابزار است نه برای مدل؟

زیرا نتیجه باید قابل بررسی باشد. چهل سند برای مقایسهٔ بصری بسیار زیاد است، و مدلی که «تمام قراردادها را به‌روز کرد» چیزی برای مقایسه به شما نمی‌دهد. ابزار جستجو و جایگزینی عددی برای هر فایل ارائه می‌دهد. این اعداد ردپای حسابرسی هستند: می‌دانید کدام فایل‌ها تغییر کرده‌اند، به چه میزان، و کدام‌ها نیازی به تغییر نداشته‌اند.

همچنین باید به‌صورت صحیح خسته‌کننده باشد. نام شرکت به‌صورت بولد باقی می‌ماند، جدول هزینه‌ها شبکهٔ خود را حفظ می‌کند، عناوین سبک‌های خود را نگه می‌دارند. مدل هرگز سند را دوباره تایپ نمی‌کند: موتور آن را باز می‌کند، کلمات را جایگزین می‌کند و یک نسخهٔ جدید می‌نویسد. یک نکته در سرور ۲۶.۱۰.۰: این نسخهٔ جدید از مدل ویرایش HTML موتور نوشته می‌شود و یک پاورقی Word از طریق آن عبور نمی‌کند. قراردادی که نام تامین‌کننده را در پاورقی‌اش دارد به‌جای آن به‌دورگرد HTML صفحه‌بندی‌شده نیاز دارد؛ FAQ فهرست می‌کند که یک سند Word چه چیزهایی را حفظ می‌کند.

آنچه عامل می‌بیند

ضبط شده از GroupDocs.Editor.Mcp 26.10.0 بر روی یک مجموعهٔ کوچک مصنوعی: یک توافق‌نامهٔ خدمات، یک NDA، یک نامهٔ خوش‌آمدگویی، یک بودجهٔ سه‌برگه‌ای و یک ارائهٔ سه‌اسلایدی مرور.

-> replace_text {"file":{"filePath":"contracts/msa-northwind.docx"},
     "find":"ACME Corp","replace":"Globex Ltd","wholeWord":true}
<- Replaced 6 occurrence(s) of 'ACME Corp' in 'msa-northwind.docx'
   Saved to: …/msa-northwind_edited.docx

-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"}, ...}
<- Replaced 1 occurrence(s) of 'ACME Corp' in 'nda-northwind.docx'

-> replace_text {"file":{"filePath":"contracts/welcome-letter.docx"}, ...}
<- Text replacement found no matches for 'ACME Corp' in
   'welcome-letter.docx'. No file was written.

-> replace_text {"file":{"filePath":"budget.xlsx"}, ..., "worksheet":1}
<- Replaced 1 occurrence(s) of 'ACME Corp' in worksheet 1 of 3 of
   'budget.xlsx'

-> replace_text {"file":{"filePath":"review.pptx"}, ..., "slide":1}
<- Replaced 1 occurrence(s) of 'ACME Corp' in slide 1 of 3 of
   'review.pptx'

گزارش عامل به‌صورت خودکار نوشته می‌شود: شش مورد در توافق‌نامه، یک مورد در NDA، هیچ‌کدام در نامهٔ خوش‌آمدگویی، یک مورد در خلاصهٔ بودجه، یک مورد در اولین اسلاید.

حلقه

contracts/ + budget.xlsx + review.pptx
   |
   +-- for each file:
   |      replace_text {"find":"ACME Corp","replace":"Globex Ltd",
   |                    "wholeWord":true}   (+ "worksheet"/"slide")
   |         -> "Replaced N occurrence(s) ..."  -> <name>_edited.<ext>
   |         -> "found no matches ... No file was written."
   |
   '-- report: file -> count; files with 0 listed separately

دو عادت حلقه را قابل اعتماد می‌سازند. برای نام‌ها از wholeWord: true استفاده کنید تا «ACME Corp» داخل «ACME Corporation Holdings» مطابقت ندهد. و از عامل بخواهید فایل‌هایی که صفر مطابقت دارند را فهرست کند، زیرا صفر در فایلی که انتظار تغییر داشتید، نکته‌ای است که شایستگی بررسی دوباره دارد.

بررسی دسته قبل از انجام هر جایگزینی

نسخه‌های ویرایش‌شده در کنار اصلی‌ها قرار می‌گیرند تا زمانی که تصمیم دیگری بگیرید، و این همان لحظه‌ای است که باید بررسی کنید. سه بررسی ساده تقریباً تمام مشکلات را می‌گیرند. شمارش‌های هر فایل را با آنچه انتظار داشتید مقایسه کنید: یک توافق‌نامه که نام تامین‌کننده را در هر صفحه دارد نباید فقط یک مورد گزارش دهد. به اجرای دوبارهٔ همان جایگزینی تکیه نکنید: عبارت تقسیم‌شده در قالب نیز در بار دوم از دست می‌رود و «هیچ مطابقتی یافت نشد» به‌نظر می‌رسد همه چیز واضح است. از عامل بخواهید به‌جای آن extract_html را بر روی هر نسخهٔ ویرایش‌شده اجرا کند؛ پیش‌نمایش متن سادهٔ آن، بخش‌های قالب‌بندی را به هم می‌پیوندد، بنابراین یک «ACME Corp» باقی‌مانده در آن ظاهر می‌شود. املای‌های متفاوت («Acme Corp.» با نقطه، «ACME Corporation») شایستگی یک عبور جداگانه با matchCase: false یا یک عبارت منظم دارند. و یک فایل ویرایش‌شده از هر نوع—یک قرارداد، یک کتاب‌کار و یک ارائه—را باز کنید تا تأیید کنید قالب‌بندی و پاورقی حفظ شده‌اند. فقط پس از آن فایل‌های _edited را روی اصلی‌ها جابه‌جا کنید یا بگذارید سیستم اسناد شما نسخه‌بندی کند.

الگوها، حروف بزرگ/کوچک و قالب در یک فراخوانی

تغییر نام حالت عمومی است، اما همان ابزار بقیهٔ خانوادهٔ «یکنواخت‌سازی متن» را پوشش می‌دهد. در همان اجرای آزمایشی:

-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"},
     "find":"v2\\.3\\b","replace":"v2.4","regex":true,
     "outputName":"nda-northwind-v2.4.docx"}
<- Replaced 1 occurrence(s) of 'v2\.3\b' in 'nda-northwind.docx'

-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"},
     "find":"acme corp","replace":"Globex Ltd","matchCase":false,
     "format":"pdf"}
<- Replaced 1 occurrence(s) of 'acme corp' in 'nda-northwind.docx'
   Saved to: …/nda-northwind_edited.pdf

regex: true یک عبارت منظم .NET می‌گیرد، که برای ارتقاء نسخه یا تغییر قالب تاریخ در یک پوشه استفاده می‌شود. matchCase: false حروف بزرگ/کوچک ناسازگار را می‌گیرد. format: "pdf" در یک مرحله ویرایش و تبدیل می‌کند، برای نسخه‌ای که به سمت دیگر می‌رود.

نکته‌ای برای عوامل برنامه‌نویسی

همان الگو در یک مخزن کار می‌کند. یادداشت‌های انتشار در DOCX و مشخصات در XLSX برای sed نامرئی هستند؛ Claude Code با این سرور می‌تواند رشتهٔ نسخه را در هر دو به‌عنوان بخشی از وظیفهٔ انتشار ارتقا دهد. قانون را در دستورالعمل‌های پروژه بگذارید تا عامل به‌جای تلاش برای استخراج فایل‌های Office از ابزار استفاده کند:

To change wording in .docx/.xlsx/.pptx/.pdf files in this repo, use the
groupdocs-editor MCP server's replace_text (wholeWord for names, regex for
versions). Report the count per file. Never rewrite an Office file by hand.

محدودیت‌های صادقانه

  • مطابقت فقط در یک بخش قالب‌بندی انجام می‌شود. در توافق‌نامهٔ ما، هفتمین «ACME Corp» که «ACME» به ایتالیک بود، جایگزین نشد و شمارش شش آن را نشان داد. عبارات تقسیم‌شده در سبک‌ها نیاز به دورگرد HTML دارند.
  • هر نتیجه در ریشهٔ پوشهٔ خروجی به‌صورت <name>_edited.<ext> ذخیره می‌شود، حتی اگر اصلی در یک زیرپوشه قرار داشته باشد. هیچ‌چیزی بازنویسی نمی‌شود: نامی که قبلاً گرفته شده است عددی می‌گیرد (msa-northwind_edited (1).docx)، بنابراین هنگام امکان برخورد نام‌ها outputName را بدهید.
  • در سرور ۲۶.۱۰.۰ نسخهٔ ویرایش‌شدهٔ یک سند Word پاورقی خود را از دست می‌دهد و کنترل‌های محتوا به متن ساده مسطح می‌شوند. اسنادی که نام قدیمی را در پاورقی دارند بررسی کنید.
  • صفحات گسترده و ارائه‌ها به‌ازای هر فراخوانی یک برگه یا اسلاید ویرایش می‌شوند. در حالت ارزیابی فقط دو مورد اول می‌توانند ویرایش شوند و سرور این را می‌گوید: «حالت ارزیابی فقط دو اسلاید اول یک ارائه را ویرایش می‌کند؛ اسلاید ۳ خارج از آن‌هاست.»
  • حالت ارزیابی همچنین یک خط بنر به هر خروجی اضافه می‌کند و یک PDF طولانی‌تر از دو صفحه رد می‌شود.

پرسش‌های متداول

آیا می‌تواند متن را در Word، Excel و PowerPoint در یک دسته جایگزین کند؟
بله. عامل برای هر فایل همان ابزار را فراخوانی می‌کند و برای کتاب‌کارها worksheet و برای ارائه‌ها slide اضافه می‌کند.

چگونه می‌دانم کدام فایل‌ها تغییر کرده‌اند؟
هر فراخوانی شمارش را برمی‌گرداند و فایل‌هایی که مطابقت ندارند اصلاً نوشته نمی‌شوند. از عامل بخواهید جدول شمارش به‌ازای هر فایل ارائه دهد.

آیا اصلی‌ها بازنویسی می‌شوند؟
خیر. هر ویرایش یک فایل جدید می‌نویسد؛ اصلی‌ها همان‌طور که بودند می‌مانند تا خودتان آن‌ها را جایگزین کنید.

عمیق‌تر بروید