Safe DOCX Suite

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

safe-docx от UseJunior — используйте агентов кодирования и для работы с документами.

Часть инструментов UseJunior developer tools.

Safe Docx — это стек с открытым исходным кодом на TypeScript для точечного редактирования существующих файлов Microsoft Word .docx. Он создан для рабочих процессов, где агент предлагает изменения, а человеку по-прежнему требуется надежное редактирование документа с сохранением форматирования.

Если вы проверяете контракты с помощью ИИ, самым медленным этапом часто является применение принятых рекомендаций в Word. Safe Docx превращает это в детерминированные вызовы инструментов.

Зачем это нужно

CLI для ИИ-кодирования отлично работают с кодом и текстовыми файлами, но слабы в редактировании существующих .docx. Бизнес- и юридические процессы по-прежнему опираются на документы Word, поэтому мы создали нативный путь на TypeScript для:

• чтения и поиска в существующих документах в форматах, эффективных с точки зрения токенов

• выполнения точечных правок без нарушения форматирования

• создания чистых/отслеживаемых результатов и артефактов извлечения правок

Миссия: позволить агентам кодирования заниматься и бумажной работой. Safe Docx фокусируется на детерминированном редактировании существующих файлов Word, где форматирование и семантика проверки должны сохраняться при автоматизации.

Позиционирование

Safe Docx оптимизирован для рабочих процессов агентов, которым требуются детерминированные, локальные правки существующих файлов .docx:

• типизированные инструменты MCP для редактирования, сравнения, извлечения правок, комментариев, сносок и макета

• проверяемое поведение с доказательствами тестирования и артефактами прослеживаемости

• распространение среды выполнения TypeScript без необходимости использования Python или LibreOffice для поддерживаемого использования

Safe Docx не предназначен для замены библиотек, ориентированных на создание .docx с нуля.

Нам доверяют

• Юридическая фирма из топ-10 Am Law — многоэтапный конвейер перевода контрактов

• Региональная фирма со 150 юристами — обработано более 22 млн токенов разметки контрактов

• Gemini CLI — совместимое расширение MCP для редактирования Word

С чего начать

npx -y @usejunior/safe-docx

Подробную информацию о настройке и справочник инструментов см. в packages/docx-mcp/README.md.

Пример: Агент редактирует контракт

Когда вы даете задание агенту кодирования (Claude Code, Cursor, Gemini CLI) с установленным Safe Docx, агент делает вызовы инструментов MCP, подобные этим:

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"
     )

Агент автоматически обрабатывает вызовы инструментов. Вы получаете чистый файл и файл с отслеживаемыми изменениями для проверки человеком.

Быстрый старт MCP

Claude Code

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

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %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"]
    }
  }
}

Любой клиент MCP

• Команда: npx

• Аргументы: ["-y", "@usejunior/safe-docx"]

• Транспорт: stdio

Для чего оптимизирован Safe Docx

• Редактирование существующих файлов .docx

• Замена текста и вставка абзацев с сохранением форматирования

• Рабочие процессы с комментариями и сносками

• Вывод результатов с отслеживанием изменений для проверки (download, compare_documents)

• Извлечение правок в виде структурированного JSON (extract_revisions)

Для чего Safe Docx НЕ оптимизирован

Safe Docx не является инструментарием для создания документов с нуля.

Если ваша основная потребность — создание новых файлов .docx из шаблонов/программной верстки, используйте пакеты, такие как docx.

Семейства документов

Автоматизированное покрытие фикстур в этом репозитории

• Фикстуры взаимного NDA в стиле Common Paper

• Фикстура взаимного NDA Bonterms

• Фикстура письма о намерениях (Letter of Intent)

• Фикстуры правок соглашений об ограниченном партнерстве ILPA

Разработано для сложных юридических и бизнес-классов .docx

• Финансовые формы NVCA

• YC SAFEs

• Инвестиционные меморандумы

• Формы заказов и соглашения об оказании услуг

• Соглашения об ограниченном партнерстве

Пакеты

• @usejunior/docx-core: примитивы + движок сравнения для существующих документов .docx

• @usejunior/docx-mcp: реализация сервера MCP и поверхность инструментов

• @usejunior/safe-docx: каноническое имя установки для конечного пользователя (npx -y @usejunior/safe-docx)

• @usejunior/safedocx-mcpb: приватный оберточный пакет MCP

Надежность и поверхность доверия

• Схемы инструментов генерируются из packages/docx-mcp/src/tool_catalog.ts.

• Матрица прослеживаемости OpenSpec: packages/docx-mcp/src/testing/SAFE_DOCX_OPENSPEC_TRACEABILITY.md

• Матрица допущений: packages/docx-mcp/assumptions.md

• Руководство по соответствию: docs/safe-docx/sprint-3-conformance.md

Часто задаваемые вопросы

Что такое Safe Docx?

Стек редактирования DOCX, ориентированный на TypeScript, для рабочих процессов агентов кодирования, которым требуются детерминированные правки существующих документов Word с сохранением форматирования.

Сохраняется ли форматирование при правках?

Это основная цель дизайна. Поверхность инструментов построена вокруг хирургических операций (replace_text, insert_paragraph, элементы управления макетом), которые максимально сохраняют структуру документа и семантику форматирования.

Требуется ли .NET, Python или LibreOffice при обычном использовании?

Нет. Поддерживаемое использование среды выполнения — JavaScript/TypeScript с jszip + @xmldom/xmldom.

Можно ли создавать контракты с нуля?

Это не является основной задачей. Для создания с нуля используйте пакеты, такие как docx.

На каких типах документов это тестировалось в фикстурах репозитория?

Взаимные NDA (включая фикстуры в стиле Common Paper/Bonterms), письма о намерениях и фикстуры правок соглашений об ограниченном партнерстве ILPA.

Это только для юристов?

Нет. Те же проблемы редактирования существующих .docx возникают в HR, закупках, финансах, операциях по продажам и других рабочих процессах, насыщенных бумажной работой.

С чего начать пользователю MCP?

Используйте @usejunior/safe-docx через npx, затем следуйте примерам настройки в packages/docx-mcp/README.md.

Где можно изучить схемы инструментов?

См. сгенерированный справочник в 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 — заполнение стандартных юридических шаблонов с помощью агентов кодирования (NDA, SAFE, NVCA)

• UseJunior Developer Tools — страница продукта с вариантами установки и каталогом инструментов

Конфиденциальность

Safe Docx работает полностью на вашем локальном компьютере. Содержимое документов не отправляется на внешние серверы. Подробности см. в нашей Политике конфиденциальности.

Управление

• Руководство по внесению вклада

• Кодекс поведения

• Политика безопасности

• Журнал изменений