Safe DOCX Suite

English | Español | 简体中文 | Português (Brasil) | Deutsch

safe-docx von UseJunior — nutzen Sie Coding-Agents auch für den Papierkram.

Teil der UseJunior Entwickler-Tools.

Safe Docx ist ein Open-Source-TypeScript-Stack für die chirurgische Bearbeitung bestehender Microsoft Word .docx-Dateien. Er wurde für Workflows entwickelt, bei denen ein Agent Änderungen vorschlägt und ein Mensch dennoch zuverlässige, formatierungserhaltende Dokumentenänderungen benötigt.

Wenn Sie Verträge mit KI prüfen, ist der langsamste Schritt oft das Anwenden akzeptierter Empfehlungen in Word. Safe Docx verwandelt dies in deterministische Tool-Aufrufe.

Warum gibt es das?

KI-Coding-CLIs sind großartig bei Code- und Textdateien, aber schwach bei der Bearbeitung bestehender .docx-Dateien. Geschäfts- und Rechtsabläufe basieren immer noch auf Word-Dokumenten, daher haben wir einen nativen TypeScript-Pfad entwickelt für:

• das Lesen und Durchsuchen bestehender Dokumente in token-effizienten Formaten

• chirurgische Änderungen, ohne die Formatierung zu zerstören

• die Erstellung sauberer/nachverfolgbarer Ausgaben und Artefakte zur Revisions-Extraktion

Mission: Coding-Agents ermöglichen, auch Papierkram zu erledigen. Safe Docx konzentriert sich auf deterministische Änderungen an bestehenden Word-Dateien, bei denen Formatierung und Prüfungssemantik die Automatisierung überstehen müssen.

Positionierung

Safe Docx ist für Agent-Workflows optimiert, die deterministische, lokale Änderungen an bestehenden .docx-Dateien erfordern:

• typisierte MCP-Tools für Bearbeitung, Vergleich, Revisions-Extraktion, Kommentare, Fußnoten und Layout

• prüfbares Verhalten mit Testnachweisen und Rückverfolgbarkeits-Artefakten

• TypeScript-Laufzeitverteilung, ohne dass Python oder LibreOffice für die unterstützte Nutzung erforderlich sind

Safe Docx ist nicht dazu gedacht, generierungsbasierte .docx-Bibliotheken zu ersetzen.

Vertrauenswürdig für

• Am Law Top-10-Kanzlei — mehrstufige Vertragstransformations-Pipeline

• Regionale Kanzlei mit 150 Anwälten — über 22 Mio. Token an Vertrags-Markups verarbeitet

• Gemini CLI — kompatible Word-Bearbeitungs-MCP-Erweiterung

Hier starten

npx -y @usejunior/safe-docx

Für eine detaillierte Einrichtung und Tool-Referenz siehe packages/docx-mcp/README.md.

Beispiel: Agent bearbeitet einen Vertrag

Wenn Sie einen Coding-Agent (Claude Code, Cursor, Gemini CLI) mit installiertem Safe Docx auffordern, führt der Agent MCP-Tool-Aufrufe wie diese aus:

User: Edit the NDA at ~/docs/NDA.docx — change the governing law
      from "State of New York" to "State of Delaware" and save both
      a clean copy and a tracked-changes copy.

Agent calls:

  1. read_file(file_path="~/docs/NDA.docx", format="toon")
     → Returns paragraphs with stable IDs: _bk_1, _bk_2, ...

  2. grep(file_path="~/docs/NDA.docx", pattern="State of New York")
     → Match in paragraph _bk_47

  3. replace_text(
       file_path="~/docs/NDA.docx",
       target_paragraph_id="_bk_47",
       old_string="State of New York",
       new_string="State of Delaware",
       instruction="Change governing law to Delaware"
     )

  4. save(
       file_path="~/docs/NDA.docx",
       save_to_local_path="~/docs/NDA-clean.docx",
       tracked_save_to_local_path="~/docs/NDA-tracked.docx",
       save_format="both"
     )

Der Agent übernimmt die Tool-Aufrufe automatisch. Sie erhalten eine saubere Datei und eine Datei mit nachverfolgten Änderungen für die menschliche Überprüfung.

MCP-Schnellstart

Claude Code

claude mcp add safe-docx -- npx -y @usejunior/safe-docx

Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "safe-docx": {
      "command": "npx",
      "args": ["-y", "@usejunior/safe-docx"]
    }
  }
}

Gemini CLI

{
  "mcpServers": {
    "safe-docx": {
      "command": "npx",
      "args": ["-y", "@usejunior/safe-docx"]
    }
  }
}

Jeder MCP-Client

• Befehl: npx

• Argumente: ["-y", "@usejunior/safe-docx"]

• Transport: stdio

Wofür Safe Docx optimiert ist

• Bearbeitung bestehender .docx-Dateien

• Formatierungserhaltender Textersatz und Absatzeinfügung

• Kommentar- und Fußnoten-Workflows

• Ausgaben mit nachverfolgten Änderungen zur Überprüfung (download, compare_documents)

• Revisions-Extraktion als strukturiertes JSON (extract_revisions)

Wofür Safe Docx nicht optimiert ist

Safe Docx ist kein Toolkit zur Dokumentenerstellung von Grund auf.

Wenn Ihr Hauptbedarf darin besteht, neue .docx-Dateien aus Vorlagen/programmatischem Layout zu generieren, verwenden Sie Pakete wie docx.

Dokumentenfamilien

Automatisierte Fixture-Abdeckung in diesem Repo

• Common Paper-Stil gegenseitige NDA-Fixtures

• Bonterms gegenseitige NDA-Fixture

• Absichtserklärung-Fixture (Letter of Intent)

• ILPA Limited Partnership Agreement Redline-Fixtures

Entwickelt für komplexe rechtliche und geschäftliche .docx-Klassen

• NVCA-Finanzierungsformulare

• YC SAFEs

• Angebotsmemoranden

• Bestellformulare und Dienstleistungsverträge

• Limited Partnership Agreements

Pakete

• @usejunior/docx-core: Primitive + Vergleichs-Engine für bestehende .docx-Dokumente

• @usejunior/docx-mcp: MCP-Server-Implementierung und Tool-Oberfläche

• @usejunior/safe-docx: Kanonischer Installationsname für Endbenutzer (npx -y @usejunior/safe-docx)

• @usejunior/safedocx-mcpb: Privater MCP-Bundle-Wrapper

Zuverlässigkeit und Vertrauensbasis

• Tool-Schemas werden aus packages/docx-mcp/src/tool_catalog.ts generiert.

• OpenSpec-Rückverfolgbarkeitsmatrix: packages/docx-mcp/src/testing/SAFE_DOCX_OPENSPEC_TRACEABILITY.md

• Annahmenmatrix: packages/docx-mcp/assumptions.md

• Konformitätsleitfaden: docs/safe-docx/sprint-3-conformance.md

FAQ

Was ist Safe Docx?

Ein TypeScript-First DOCX-Bearbeitungs-Stack für Coding-Agent-Workflows, die deterministische, formatierungserhaltende Änderungen an bestehenden Word-Dokumenten benötigen.

Bleibt die Formatierung bei Änderungen erhalten?

Das ist ein zentrales Designziel. Die Tool-Oberfläche basiert auf chirurgischen Operationen (replace_text, insert_paragraph, Layout-Steuerungen), die die Dokumentenstruktur und Formatierungssemantik so weit wie möglich bewahren.

Erfordert dies .NET, Python oder LibreOffice im normalen Laufzeitbetrieb?

Nein. Die unterstützte Laufzeitnutzung ist JavaScript/TypeScript mit jszip + @xmldom/xmldom.

Kann dies Verträge von Grund auf generieren?

Nicht der primäre Fokus. Für die Generierung von Grund auf verwenden Sie Pakete wie docx.

Auf welchen Dokumenttypen wurde dies in Repo-Fixtures getestet?

Gegenseitige NDAs (einschließlich Common Paper/Bonterms-Stil-Fixtures), Absichtserklärungen und ILPA Limited Partnership Agreement Redline-Fixtures.

Ist dies nur für Anwälte?

Nein. Die gleichen Probleme bei der Bearbeitung bestehender .docx-Dateien treten auch in den Bereichen Personalwesen, Beschaffung, Finanzen, Vertriebsbetrieb und anderen papierintensiven Workflows auf.

Wo sollte ich als MCP-Benutzer anfangen?

Verwenden Sie @usejunior/safe-docx via npx und folgen Sie dann den Einrichtungsbeispielen in packages/docx-mcp/README.md.

Wo kann ich die Tool-Schemas einsehen?

Siehe die generierte Referenz unter packages/docx-mcp/docs/tool-reference.generated.md.

Entwicklung

npm ci
npm run build
npm run lint --workspaces --if-present
npm run test:run
npm run check:spec-coverage
npm run test:coverage:packages
npm run coverage:packages:check
npm run coverage:matrix

Siehe auch

• Open Agreements — Standard-Rechtsvorlagen mit Coding-Agents ausfüllen (NDAs, SAFEs, NVCA)

• UseJunior Developer Tools — Produktseite mit Installationsoptionen und Tool-Katalog

Datenschutz

Safe Docx läuft vollständig auf Ihrem lokalen Computer. Es werden keine Dokumentinhalte an externe Server gesendet. Details finden Sie in unserer Datenschutzrichtlinie.

Governance

• Beitragsleitfaden

• Verhaltenskodex

• Sicherheitsrichtlinie

• Changelog