Adeu: Natives "Änderungen nachverfolgen" für KI

LLMs sprechen Markdown; Anwälte sprechen "Änderungen nachverfolgen".

Adeu ist ein Model Context Protocol (MCP) Server und Python SDK, das als "Virtual DOM" für Microsoft Word fungiert. Es bietet eine bidirektionale Abstraktionsschicht, die es KI-Agenten ermöglicht, Dokumententexte frei zu bearbeiten, ohne die zugrunde liegende Formatierung oder komplexes DOCX-XML zu zerstören.

Während Standardbibliotheken wie python-docx hervorragend darin sind, Dokumente von Grund auf neu zu erstellen, scheitern sie an zerstörungsfreien Redigierungen. Adeu löst dies, indem es .docx-Dateien in eine token-effiziente Markdown-Repräsentation übersetzt. Dies befreit KI-Agenten davon, sich mit OpenXML herumschlagen zu müssen, und ermöglicht es ihnen, sich vollständig auf die Semantik des Dokuments zu konzentrieren.

Adeu fungiert als intelligenter Proxy, der KI-Bearbeitungen als sichere, atomare Transaktionen verarbeitet:

1. Extrahieren: Übersetzt das Dokument (von der Festplatte oder aus einem aktiven Word-Prozess) in LLM-freundliches CriticMarkup mit einem semantischen Anhang aus definierten Begriffen, Querverweisen und wahrscheinlichen Tippfehlern. Der Agent beginnt mit der semantischen Struktur, nicht mit Rohdaten.

2. Validieren: Fungiert als striktes Sicherheits-Gateway. Es schützt die Integrität des Dokuments, indem es mehrdeutige Textübereinstimmungen oder ungültige strukturelle Änderungen automatisch blockiert, bevor sie die Datei beeinflussen.

3. Übertragen: Übersetzt die Textbearbeitungen der KI in native Word-Änderungen ("Track Changes"). Adeu handhabt das komplexe XML im Hintergrund und stellt sicher, dass bestehende Layouts, Schriftarten und Randkommentare perfekt erhalten bleiben.

Gewartet von Adeu.

Einrichtung

Voraussetzung: Adeu verwendet uv für eine schnelle, isolierte Ausführung. Der einfachste Weg zur Installation ist über pip:

pip install uv

macOS

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Integration in Claude Desktop

Um Adeu sofort zu Claude Desktop hinzuzufügen, führen Sie Folgendes aus:

uvx adeu init

Überprüfung der Funktionsweise

Sobald Claude Desktop neu gestartet wurde, können Sie bestätigen, dass Adeu verbunden ist, indem Sie die folgende Nachricht direkt an Claude senden:

"Kannst du eine DOCX-Datei mit dem Adeu-Tool lesen?"

Wenn alles korrekt eingerichtet ist, wird Claude bestätigen, dass es Zugriff auf die Adeu-Tools hat, und beschreiben, was es tun kann. Wenn Adeu nicht erwähnt wird oder Claude angibt, keine Dateitools zu haben, überprüfen Sie bitte, ob Sie Claude Desktop nach der Ausführung von uvx adeu init neu gestartet haben.

Da Adeu Python 3.12+ erfordert, übernimmt uvx automatisch das Herunterladen der korrekten Python-Version und das Ausführen des Servers:

{
  "mcpServers": {
    "adeu": {
      "command": "uvx",
      "args": ["--from", "adeu", "adeu-server"]
    }
  }
}

Arbeitsabläufe

1. Für Agenten (Claude / MCP)

Adeu läuft als Model Context Protocol (MCP) Server. Es stellt Agenten spezifische Tools zur Verfügung, um Dokumente sicher zu lesen, zu überprüfen und zu bearbeiten.

MCP Apps UI: Das read_docx-Tool unterstützt das neueste MCP Apps UI-Protokoll. Wenn ein Agent ein Dokument liest, rendert Adeu dynamisch eine benutzerdefinierte, interaktive Markdown-UI-Ansicht direkt in Ihrem Claude-Chatfenster – so können Sie den extrahierten Text und die Formatierung visuell zusammen mit der Argumentation der KI überprüfen!

Empfohlener Agent-Prompt: Obwohl die Tools von Adeu ihre Schemata automatisch gegenüber dem LLM beschreiben, können Sie die besten Ergebnisse garantieren, indem Sie diesen Kontext zu den Projektanweisungen von Claude oder dem System-Prompt Ihres Agenten hinzufügen:

Rolle: Dokumentenspezialist Tools:

• read_docx(clean_view=True): Lesen Sie die finale "saubere" Version des Textes, um den Kontext zu verstehen.

• process_document_batch: Modus "Übertragen & Verhandeln". Wenden Sie eine einheitliche Liste von Änderungen an. Verwenden Sie type: "modify" für spezifische Suchen-und-Ersetzen-Textbearbeitungen und type: "accept", "reject" oder "reply", um bestehende Änderungen und Kommentare nach ID zu verwalten.

• sanitize_docx: Bereinigung vor dem Senden. Entfernen Sie gefährliche Metadaten, Autorennamen und interne Tracking-IDs vor der Freigabe. Kann bestehendes Markup beibehalten (keep_markup=True) oder ein sauberes Delta gegenüber einer Basislinie generieren.

Live MS Word-Integration

Wenn Sie unter Windows mit installiertem Microsoft Word arbeiten, kann Adeu als Echtzeit-Copilot fungieren und das aktive Dokument direkt vor Ihren Augen bearbeiten.

• read_active_word_document: Extrahiert Text, nachverfolgte Änderungen und Kommentare direkt aus dem aktiven, geöffneten Word-Fenster.

• process_active_word_batch: Übersetzt die Bearbeitungen des LLM in native COM-Makros und beobachtet, wie Word automatisch tippt, löscht und Kommentare auf der Arbeitsfläche hinzufügt.

2. Für Entwickler (Python SDK)

Wenn Sie eine Legal-Tech-Anwendung oder eine automatisierte Pipeline erstellen, verwenden Sie die RedlineEngine direkt. Sie übernimmt die Schwerstarbeit der XML-Manipulation.

from adeu import RedlineEngine, ModifyText
from io import BytesIO

# 1. Load the contract
with open("MSA.docx", "rb") as f:
    stream = BytesIO(f.read())

# 2. Define the edit (e.g., from an LLM response)
# Adeu uses fuzzy matching to locate the target text, even if whitespace varies.
edit = ModifyText(
    target_text="State of New York",
    new_text="State of Delaware",
    comment="Standardizing governing law."
)

# 3. Apply changes
engine = RedlineEngine(stream, author="AI Copilot")
engine.apply_edits([edit])

# 4. Save the result
with open("MSA_Redlined.docx", "wb") as f:
    f.write(engine.save_to_stream().getvalue())

3. Das CLI

Untersuchen Sie Dokumente schnell oder wenden Sie Stapel von Bearbeitungen über Ihr Terminal an.

# Extract clean text for RAG or prompting
adeu extract contract.docx -o contract.md

# Generate a visual diff between two versions
adeu diff v1.docx v2.docx

# Preview what an edit list (JSON) would look like
adeu markup contract.docx edits.json --output preview.md

# Apply edits to the DOCX
adeu apply contract.docx edits.json --author "Review Bot"

# Scrub author metadata and internal trackers, but keep the visual redlines for the counterparty
adeu sanitize redline.docx -o clean.docx --keep-markup --author "My Firm" --report

Hauptmerkmale

Format-Sicherheit

Adeu "schreibt" das Dokument nicht um. Es patcht es.

• Bilder & Layouts: Unberührt.

• Nummerierung & Kopfzeilen: Beibehalten.

• Tabellen & Listen: Komplexe Gridspans und mehrstufige juristische Nummerierungen sind explizit geschützt.

• Komplexes XML: Es werden nur die Textbereiche modifiziert, die von der Bearbeitung betroffen sind.

CriticMarkup-Repräsentation

Zwischendarstellungen sind wichtig. Adeu verwendet CriticMarkup, um Änderungen zu visualisieren.

Semantischer Anhang

Verträge sind voller Fallstricke, die ein LLM beim ersten Durchgang übersehen könnte: inkonsistent verwendete definierte Begriffe, defekte Querverweise und OCR-ähnliche Tippfehler in unsauberen Dokumenten. Adeu berechnet diese beim Extrahieren vor und übergibt dem Agenten einen strukturierten Anhang zusammen mit dem Text.

Intelligente Zuordnung

Word-Dokumente sind unordentlich. Ein Wort wie "Vertrag" könnte aufgrund der Rechtschreibprüfung oder des Formatierungsverlaufs in XML-Runs wie ["Ver", "trag"] aufgeteilt sein.

• Run-Zusammenführung: Adeu normalisiert diese Aufteilungen, sodass die KI "Vertrag" sieht.

• Fuzzy Matching: Es handhabt geringfügige Abweichungen bei Leerzeichen zwischen dem Speicher des LLM und dem tatsächlichen Dokumentinhalt.

Metadaten-Bereinigung

Bestehende Metadaten-Scrubber zerstören Redigierungen oder entfernen stillschweigend Daten. Der sanitize-Befehl von Adeu entfernt chirurgisch gefährliche Tracker (rsids, Vorlagen, interne Pfade, Zeitstempel) und verwaiste Inhalte, während gültige Änderungen beibehalten werden. Entscheidend ist, dass ein transparenter Prüfbericht generiert wird, der genau belegt, was entfernt wurde und was für den Empfänger sichtbar sein wird.

Adeu Cloud

Standardmäßig sind die Kern-Redigierungs-Engine von Adeu und die lokalen Dateitools vollständig Open-Source und werden vollständig auf Ihrem Computer ausgeführt. Adeu sendet niemals Ihre lokalen Dokumente nach Hause (obwohl Ihr gewählter LLM-Anbieter den Text, den der Agent liest, natürlich verarbeitet).

Sie können sich jedoch explizit dafür entscheiden, Ihren MCP-Server mit der Adeu Cloud zu verbinden, um Folgendes freizuschalten:

• End-to-End-Workflows (E-Mail): Da Verträge per E-Mail versendet werden, ermöglicht Adeu Cloud Agenten, E-Mail-Threads sicher abzurufen, DOCX-Anhänge von Gegenparteien zur Überprüfung zu extrahieren und Antworten mit Ihren neu bereinigten Redigierungen im Anhang zu entwerfen.

• Erweiterte Dokumentenvalidierung: Führen Sie komplexe, dokumentübergreifende semantische Validierungsaufgaben asynchron aus. Durch die sichere Weiterleitung dieser massiven Kontexte an die Adeu Cloud zur Verarbeitung verhindern Sie, dass Ihr lokaler KI-Agent sein Kontextfenster erschöpft oder Ratenbegrenzungen erreicht.

Erfahren Sie mehr über Adeu Cloud.

Mitwirken

Wir freuen uns über Beiträge aus der Community! Ob es darum geht, Fehler zu beheben, Funktionen hinzuzufügen oder die Dokumentation zu verbessern – bitte lesen Sie unseren Contributing Guide für Anweisungen zur Einrichtung der lokalen uv-Umgebung, zum Ausführen von Tests und zum Verständnis der strengen XML-Sicherheitsrichtlinien des Projekts.

Lizenz

MIT-Lizenz. Open Source und kostenlos für die Verwendung in kommerziellen Anwendungen.