English | Español | 简体中文 | Português (Brasil) | Deutsch
Übersetzungshinweis: Die englische Version
README.mdist die kanonische Quelle der Wahrheit. Diese Übersetzung kann einen kurzen Rückstand haben. Wesentliche Aktualisierungen des englischen READMEs sollten innerhalb von 72 Stunden in diese Datei übernommen werden.
safe-docx von UseJunior — nutze Programmier-Agenten auch für Papierkram.
Teil der UseJunior-Entwicklertools.
Safe Docx ist ein Open-Source-TypeScript-Stack für die chirurgische Bearbeitung bestehender Microsoft Word .docx-Dateien. Es wurde für Workflows entwickelt, in denen ein Agent Änderungen vorschlägt und ein Mensch weiterhin zuverlässige, formatierungserhaltende Dokumentenbearbeitungen benötigt.
Wenn du Verträge mit KI prüfst, ist der langsamste Schritt oft das Anwenden akzeptierter Empfehlungen in Word. Safe Docx verwandelt das in deterministische Tool-Aufrufe.
KI-Programmier-CLIs sind großartig bei Code und Textdateien, aber schwach bei der Bearbeitung bestehender .docx-Dateien. Geschäfts- und Rechts-Workflows laufen immer noch über Word-Dokumente, daher haben wir einen nativen TypeScript-Pfad gebaut für:
- Lesen und Durchsuchen bestehender Dokumente in token-effizienten Formaten
- Chirurgische Bearbeitungen ohne Zerstörung der Formatierung
- Saubere/nachverfolgte Ausgaben und Revisionsextraktions-Artefakte
Mission: Programmier-Agenten auch für Papierkram befähigen. Safe Docx konzentriert sich auf deterministische Bearbeitungen bestehender Word-Dateien, bei denen Formatierung und Review-Semantik die Automatisierung überleben müssen.
Safe Docx ist optimiert für Agenten-Workflows, die deterministische, lokale Bearbeitungen bestehender .docx-Dateien benötigen:
- Typisierte MCP-Tools für Bearbeitung, Vergleich, Revisionsextraktion, Kommentare, Fußnoten und Layout
- Auditierbares Verhalten mit Testbelegen und Nachverfolgbarkeits-Artefakten
- TypeScript-Laufzeitverteilung ohne Python oder LibreOffice für unterstützte Nutzung
Safe Docx ist nicht dazu gedacht, generierungsorientierte .docx-Bibliotheken zu ersetzen.
- Am Law Top-10-Kanzlei — mehrstufige Vertragsübersetzungs-Pipeline
- Regionalkanzlei mit 150 Anwälten — 22M+ Tokens an Vertragskorrekturen verarbeitet
- Gemini CLI — kompatible Word-Bearbeitungs-MCP-Erweiterung
npx -y @usejunior/safe-docxFür detaillierte Einrichtung und Tool-Referenz siehe packages/docx-mcp/README.md.
Wenn du einem Programmier-Agenten (Claude Code, Cursor, Gemini CLI) mit installiertem Safe Docx einen Prompt gibst, führt der Agent MCP-Tool-Aufrufe wie diese aus:
Benutzer: Bearbeite die NDA unter ~/docs/NDA.docx — ändere das
anwendbare Recht von "State of New York" zu
"State of Delaware" und speichere sowohl eine saubere
Kopie als auch eine Kopie mit Änderungsnachverfolgung.
Agent-Aufrufe:
1. read_file(file_path="~/docs/NDA.docx", format="toon")
→ Gibt Absätze mit stabilen IDs zurück: _bk_1, _bk_2, ...
2. grep(file_path="~/docs/NDA.docx", pattern="State of New York")
→ Treffer in Absatz _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 verarbeitet die Tool-Aufrufe automatisch. Du erhältst eine saubere Datei und eine Datei mit Änderungsnachverfolgung zur menschlichen Überprüfung.
claude mcp add safe-docx -- npx -y @usejunior/safe-docxFüge zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:
{
"mcpServers": {
"safe-docx": {
"command": "npx",
"args": ["-y", "@usejunior/safe-docx"]
}
}
}{
"mcpServers": {
"safe-docx": {
"command": "npx",
"args": ["-y", "@usejunior/safe-docx"]
}
}
}- Befehl:
npx - Args:
["-y", "@usejunior/safe-docx"] - Transport: stdio
- Brownfield-Bearbeitung bestehender
.docx-Dateien - Formatierungserhaltende Textersetzung und Absatzeinfügung
- Kommentar- und Fußnoten-Workflows
- Nachverfolgte Ausgaben zur Überprüfung (
download,compare_documents) - Revisionsextraktion als strukturiertes JSON (
extract_revisions)
Safe Docx ist kein Toolkit zur Dokumentenerstellung von Grund auf.
Wenn dein Hauptbedarf die Erstellung neuer .docx-Dateien aus Vorlagen oder programmatischem Layout ist, verwende Pakete wie docx.
- Common-Paper-Stil gegenseitige NDA-Fixtures
- Bonterms gegenseitiges NDA-Fixture
- Letter-of-Intent-Fixture
- ILPA Limited-Partnership-Agreement-Redline-Fixtures
- NVCA-Finanzierungsformulare
- YC SAFEs
- Angebotsmemoranden
- Bestellformulare und Dienstleistungsvereinbarungen
- Limited-Partnership-Agreements
@usejunior/docx-core: Primitive und 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
- Tool-Schemas werden aus
packages/docx-mcp/src/tool_catalog.tsgeneriert. - OpenSpec-Nachverfolgbarkeitsmatrix:
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
Ein TypeScript-first DOCX-Bearbeitungs-Stack für Programmier-Agenten-Workflows, die deterministische, formatierungserhaltende Bearbeitungen bestehender Word-Dokumente benötigen.
Das ist ein zentrales Designziel. Die Tool-Oberfläche basiert auf chirurgischen Operationen (replace_text, insert_paragraph, Layout-Steuerung), die Dokumentstruktur und Formatierungssemantik so weit wie möglich erhalten.
Nein. Die unterstützte Laufzeitnutzung ist JavaScript/TypeScript mit jszip + @xmldom/xmldom.
Nicht der Hauptfokus. Für die Erstellung von Grund auf verwende Pakete wie docx.
Gegenseitige NDAs (einschließlich Common-Paper/Bonterms-Stil-Fixtures), Letter of Intent und ILPA Limited-Partnership-Agreement-Redline-Fixtures.
Nein. Die gleichen Bearbeitungsprobleme bei bestehenden .docx-Dateien treten in HR, Beschaffung, Finanzen, Vertrieb und anderen papierkramintensiven Workflows auf.
Verwende @usejunior/safe-docx über npx, dann folge den Einrichtungsbeispielen in packages/docx-mcp/README.md.
Siehe die generierte Referenz unter packages/docx-mcp/docs/tool-reference.generated.md.
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- Open Agreements — Standardmäßige Rechtsvorlagen mit Programmier-Agenten ausfüllen (NDAs, SAFEs, NVCA)
- UseJunior-Entwicklertools — Produktseite mit Installationsoptionen und Tool-Katalog
Safe Docx läuft vollständig auf deinem lokalen Rechner. Es werden keine Dokumenteninhalte an externe Server gesendet. Siehe unsere Datenschutzrichtlinie für Details.