Twój dostawca został przejęty, a „ACME Corp” jest teraz „Globex Ltd” w każdym kontrakcie, harmonogramie, budżecie i prezentacji, które go wymieniają. Z uruchomionym lokalnie serwerem GroupDocs.Editor MCP, Claude Desktop, Cursor lub Copilot wykonuje to jako wsadowe zadanie: dla każdego pliku w folderze wywołuje replace_text, zachowuje formatowanie, raportuje, ile wystąpień zmieniło, i nie zapisuje nic dla plików, które nigdy nie wspominały starej nazwy. Nic nie jest przesyłane, i żaden oryginał nie jest nadpisany:

Zmień nazwę ACME Corp na Globex Ltd w każdym dokumencie w folderze contracts, zachowaj formatowanie i podaj mi liczbę zmian dla każdego pliku.

Wersja krok po kroku znajduje się w dokumentacji: Jak znaleźć i zamienić tekst w całym folderze dokumentów bez uszkadzania formatowania.

Dlaczego to zadanie dla narzędzia, a nie dla modelu?

Ponieważ wynik musi być weryfikowalny. Czterdzieści dokumentów to za dużo, by porównywać je wzrokowo, a model, który „zaktualizował wszystkie kontrakty”, nie daje nic, co można by sprawdzić. Narzędzie znajdź‑i‑zamień podaje liczbę zmian dla każdego pliku. Liczby stanowią ślad audytu: wiesz, które pliki zostały zmienione, o ile i które nie wymagały zmiany.

Musi też być nudne w odpowiedni sposób. Pogrubiona nazwa strony pozostaje pogrubiona, tabela opłat zachowuje swoją siatkę, nagłówki zachowują style. Model nigdy nie przepisuje dokumentu: silnik otwiera go, zamienia słowa i zapisuje kopię. Jedna pułapka w wersji serwera 26.10.0: ta kopia jest zapisywana z modelu edycji HTML silnika, i stopka w Wordzie nie przechodzi. Umowa, która wymienia dostawcę w stopce, wymaga zamiast tego paginowanego obiegu HTML; FAQ wymienia, co zachowuje dokument Word.

Co widzi agent

Zarejestrowane z GroupDocs.Editor.Mcp 26.10.0 na małym syntetycznym zestawie: umowa serwisowa, NDA, list powitalny, trzystronicowy budżet i trzyslajdowa prezentacja przeglądowa.

-> 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'

Raport agenta pisze się sam: sześć w umowie, jedno w NDA, żadnego w liście powitalnym, jedno w podsumowaniu budżetu, jedno na pierwszym slajdzie.

Pętla

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

Dwa nawyki czynią pętlę niezawodną. Używaj wholeWord: true dla nazw, aby „ACME Corp” nie pasowało wewnątrz „ACME Corporation Holdings”. I poproś agenta, aby wypisał pliki z zerową liczbą dopasowań, ponieważ zero w pliku, którego spodziewałeś się zmienić, jest jedyną rzeczą wartą drugiego spojrzenia.

Sprawdzanie wsadu przed zamianą czegokolwiek

Edytowane kopie leżą obok oryginałów, dopóki nie zdecydujesz inaczej, i to jest moment na sprawdzenie. Trzy tanie kontrole łapią prawie każdy problem. Porównaj liczbę zmian w każdym pliku z tym, czego się spodziewałeś: umowa, która wymienia dostawcę na każdej stronie, nie powinna zgłaszać jednego wystąpienia. Nie polegaj na ponownym uruchomieniu tej samej zamiany: fraza podzielona formatowaniem jest pomijana także przy drugim uruchomieniu, a „found no matches” wyglądałoby jak pełne OK. Poproś agenta, aby uruchomił extract_html na każdej edytowanej kopii; jego podgląd tekstu zwykłego łączy fragmenty formatowania, więc pozostawione „ACME Corp” pojawi się tam. Różne warianty pisowni („Acme Corp.” z kropką, „ACME Corporation”) wymagają własnego przebiegu z matchCase: false lub wyrażeniem regularnym. I otwórz jedną edytowaną wersję każdego typu: umowę, skoroszyt i prezentację, aby potwierdzić, że formatowanie i stopka przetrwały. Dopiero potem przenieś pliki _edited nad oryginały lub pozwól systemowi dokumentów wersjonować je.

Wzorce, wielkość liter i format w jednym wywołaniu

Zmiana nazwy to najczęstszy przypadek, ale to samo narzędzie obejmuje resztę rodziny „spójne sformułowanie”. W tym samym teście:

-> 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 przyjmuje wyrażenie regularne .NET, co jest sposobem na podbicie wersji lub zmianę formatu daty w folderze. matchCase: false łapie niespójną wielkość liter. format: "pdf" edytuje i konwertuje w jednym kroku, dla kopii, która trafia na drugą stronę.

Dodatkowa uwaga dla agentów programistycznych

Ten sam wzorzec działa w repozytorium. Notatki wydania w DOCX i specyfikacje w XLSX są niewidoczne dla sed; Claude Code z tym serwerem może podnieść wersję w obu jako część zadania wydania. Umieść regułę w instrukcjach projektu, aby agent używał narzędzia zamiast próbować rozpakowywać pliki 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.

Szczere ograniczenia

  • Dopasowanie odbywa się w ramach jednego fragmentu formatowania. W naszej umowie siódmy „ACME Corp”, z „ACME” w kursywie, nie został zamieniony, a liczba sześć to pokazała. Frazy podzielone stylami wymagają obiegu HTML.
  • Każdy wynik trafia do katalogu wyjściowego jako <name>_edited.<ext>, nawet gdy oryginał znajdował się w podfolderze. Nic nie jest nadpisywane: nazwa, która jest już zajęta, otrzymuje numer (msa-northwind_edited (1).docx), więc podaj outputName, gdy nazwy mogą kolidować.
  • W wersji serwera 26.10.0 edytowana kopia dokumentu Word traci stopkę, a kontrolki treści są spłaszczane do zwykłego tekstu. Sprawdź dokumenty, które mają starą nazwę w stopce.
  • Arkusze kalkulacyjne i prezentacje są edytowane po jednym arkuszu lub slajdzie na wywołanie. W trybie ewaluacyjnym można edytować tylko pierwsze dwa, a serwer to informuje: “Evaluation mode edits only the first 2 slides of a presentation; slide 3 is beyond them.”
  • Tryb ewaluacyjny dodaje także linię banera do każdego wyniku, a PDF dłuższy niż dwie strony jest odrzucany.

FAQ

Czy może zamienić tekst w Word, Excel i PowerPoint w jednej partii?
Tak. Agent wywołuje to samo narzędzie dla każdego pliku i dodaje worksheet lub slide dla skoroszytów i prezentacji.

Jak mogę dowiedzieć się, które pliki zostały zmienione?
Każde wywołanie zwraca liczbę, a pliki bez dopasowania nie są w ogóle zapisywane. Poproś agenta o tabelę per plik.

Czy oryginały zostaną nadpisane?
Nie. Każda edycja zapisuje nowy plik; oryginały pozostają takie, jakie były, dopóki sam ich nie zastąpisz.

Go deeper