Tedarikçiniz satın alındı ve “ACME Corp” artık onu belirten her sözleşme, zaman çizelgesi, bütçe ve slayt destesindeki “Globex Ltd” olarak görünüyor. GroupDocs.Editor MCP sunucusu yerel olarak çalışırken, Claude Desktop, Cursor veya Copilot bunu toplu olarak yapar: klasördeki her dosya için replace_text çağırır, biçimlendirmeyi korur, kaç kez değiştirildiğini raporlar ve eski adı hiç içermeyen dosyalar için hiçbir şey yazmaz. Hiçbir şey yüklenmez ve hiçbir orijinal üzerine yazılmaz:

Sözleşmeler klasöründeki her belgede ACME Corp’u Globex Ltd ile yeniden adlandır, biçimlendirmeyi koru ve dosya başına bir sayı ver.

Adım adım sürüm belgelerde bulunabilir: Biçimlendirmeyi bozmadan bir klasördeki belgelerde metin bulma ve değiştirme nasıl yapılır.

Neden bu bir araç işi ve model için değil?

Sonucun kontrol edilebilir olması gerekiyor. Kırk belge, gözle fark edilerek karşılaştırılamayacak kadar çok; “tüm sözleşmeleri güncelledi” diyen bir model, kontrol edilecek bir şey sunmaz. Bir bul‑ve‑değiştir aracı dosya başına bir sayı verir. Bu sayılar denetim izidir: hangi dosyaların değiştiğini, ne kadar değiştiğini ve hangilerinin değişmeye gerek olmadığını bilirsiniz.

Ayrıca doğru şekilde sıkıcı olmalı. Kalın şirket adı kalın kalmalı, ücret tablosu ızgarasını korumalı, başlıklar stillerini korumalı. Model belgeyi yeniden yazmaz: motor belgeyi açar, kelimeleri değiştirir ve bir kopya yazar. Sunucu 26.10.0’da bir uyarı: bu kopya motorun HTML düzenleme modelinden yazılır ve bir Word footer (altbilgi) bu süreçte geçmez. Altbilgisinde tedarikçi adı geçen bir sözleşme, HTML turunu gerektirir; SSS bir Word belgesinin neyi koruduğunu listeler.

Aracın gördükleri

GroupDocs.Editor.Mcp 26.10.0 ile küçük bir sentetik set üzerinde yakalandı: bir hizmet sözleşmesi, bir NDA, bir karşılama mektubu, üç sayfalık bir bütçe ve üç slayttan oluşan bir inceleme destesi.

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

Aracın raporu kendiliğinden oluşur: sözleşmede altı, NDA’da bir, karşılama mektubunda hiç, bütçe özetinde bir, ilk slaytta bir.

Döngü

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

İki alışkanlık döngüyü güvenilir kılar. İsimler için wholeWord: true kullanın, böylece “ACME Corp” “ACME Corporation Holdings” içinde eşleşmez. Ayrıca aracı, sıfır eşleşme olan dosyaları listelemesi için isteyin; değiştirilmesi beklenen bir dosyada sıfır olması ikinci bir gözden geçirme gerektiren tek şeydir.

Herhangi bir şeyi değiştirmeden önce toplu işlemi kontrol etme

Düzenlenmiş kopyalar orijinallerin yanına konur ve siz başka bir şey yapmaya karar verene kadar bu an kontrol için kullanılır. Üç ucuz kontrol neredeyse tüm sorunları yakalar. Dosya‑başına sayımları beklediğinizle karşılaştırın: tedarikçiyi her sayfada adlandıran bir sözleşme bir kez rapor etmemelidir. Aynı değişikliği tekrar çalıştırmaya güvenmeyin: biçimlendirme içinde bölünmüş bir ifade ikinci seferde de kaçırılır ve “found no matches” her şeyin yolunda olduğu izlenimini verir. Aracı, her düzenlenmiş kopyada extract_html çalıştırması için isteyin; düz‑metin önizlemesi biçimlendirme akışlarını birleştirir, böylece kalan “ACME Corp” orada görünür. Varyant yazımlar (“Acme Corp.” nokta ile, “ACME Corporation”) kendi geçişlerini matchCase: false ya da bir düzenli ifade ile hak eder. Ve her türden bir düzenlenmiş dosyayı (sözleşme, çalışma kitabı, sunum) açıp biçimlendirmeyi ve altbilgiyi kontrol edin; sadece bu adımlardan sonra _edited dosyalarını orijinallerin üzerine taşıyın ya da belge sisteminizin sürümlemesini kullanın.

Aynı çağrıda desen, büyük/küçük harf ve format

Yeniden adlandırma yaygın durumdur, ancak aynı araç “ifade tutarlılığını sağla” ailesinin geri kalanını da kapsar. Aynı test çalışmasında:

-> 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 bir .NET düzenli ifadesi alır; bu, bir sürüm yükseltmesi ya da tarih formatı değişikliğinin klasör içinde yürütülmesinin yoludur. matchCase: false tutarsız büyük/küçük harf kullanımını yakalar. format: "pdf" bir adımda düzenler ve dönüştürür, diğer tarafa giden kopya için.

Kodlama ajanları için bir yan not

Aynı desen bir depoda da çalışır. DOCX’deki sürüm notları ve XLSX’deki teknik özellikler sed ile görünmez; bu sunucuyla Claude Code sürüm dizesini her ikisinde de yükseltebilir. Kuralı proje talimatlarına ekleyin, böylece ajan aracı kullanır, dosyaları elle açmaya çalışmaz:

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.

Dürüst sınırlamalar

  • Eşleşme tek bir biçim akışı içinde gerçekleşir. Sözleşmemizde yedinci “ACME Corp”, “ACME” italik olduğunda değiştirilmedi ve sayı altı olarak gösterildi. Stil içinde bölünmüş ifadeler HTML turuna ihtiyaç duyar.
  • Her sonuç, <name>_edited.<ext> biçiminde çıktı klasörünün köküne konur, orijinal alt klasörde olsa bile. Üzerine yazılmaz: aynı ada sahip bir dosya varsa numara eklenir (msa-northwind_edited (1).docx), bu yüzden çakışma olasılığı varsa outputName kullanın.
  • Sunucu 26.10.0’da bir Word belgesinin düzenlenmiş kopyası altbilgisini kaybeder ve içerik denetimleri düz metne dönüştürülür. Altbilgisinde eski adı taşıyan belgeleri kontrol edin.
  • Elektronik tablolar ve sunumlar bir çalışma sayfası ya da slayt başına düzenlenir. Değerlendirme modunda yalnızca ilk iki düzenlenebilir; sunucu şöyle uyarır: “Evaluation mode edits only the first 2 slides of a presentation; slide 3 is beyond them.”
  • Değerlendirme modu ayrıca her çıktıya bir banner satırı ekler ve iki sayfadan uzun PDF’ler reddedilir.

SSS

Metni Word, Excel ve PowerPoint’te tek bir toplu işlemde değiştirebilir mi?
Evet. Ajan aynı aracı dosya başına çağırır ve çalışma kitapları ile sunumlar için worksheet ya da slide ekler.

Hangi dosyaların değiştiğini nasıl öğrenirim?
Her çağrı sayıyı döndürür ve eşleşme olmayan dosyalar hiç yazılmaz. Ajanı dosya‑başına bir tablo istemeye yönlendirin.

Orijinaller üzerine yazılacak mı?
Hayır. Her düzenleme yeni bir dosya yazar; orijinaller siz değiştirmeye karar verene kadar olduğu gibi kalır.

Daha derine in