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 podajoutputName, 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
- Dokumentacja, kanoniczny przewodnik: Jak znaleźć i zamienić tekst w całym folderze dokumentów bez uszkadzania formatowania
- Centrum dokumentacji: GroupDocs.Editor MCP Server
- Strona produktu GroupDocs.Editor MCP — instalacja jednym kliknięciem dla VS Code i Cursor, konfiguracje dla każdego innego klienta
- Zacznij tutaj: Dlaczego agent AI nie powinien przepisywać twojego dokumentu, aby zmienić trzy słowa
- Powiązane: Wypełnij formularze Word z arkusza kalkulacyjnego przy pomocy agenta AI, lokalnie
- Powiązane: Edytuj jeden arkusz, zachowaj skoroszyt: precyzyjne edycje z obiegiem HTML
- Powiązane: Edytować PDF przy pomocy agenta AI? Najpierw przekształć go w Word, lokalnie
- Model on‑premise i bezpieczeństwa: 3 architektury przetwarzania dokumentów AI i ta, która trzyma pliki w twojej sieci
- Pytania: Forum GroupDocs Editor
- Źródło: GroupDocs.Editor.Mcp na GitHubie · pakiet NuGet