tiangong-wps-word-automation

tiangong-wps-word-automation

Инструмент для автоматизации типовых операций с документами Word и WPS Writer в Windows с использованием COM-интерфейса. Позволяет читать, редактировать, форматировать, объединять, разделять и экспортировать документы без ручного взаимодействия с интерфейсом. :

Что делает этот инструмент

Данный навык управляет документами Word или WPS напрямую через COM-автоматизацию. Это означает, что все операции выполняются внутри нативного приложения, сохраняя форматирование, стили и структуру документа без использования сторонних парсеров. :

• Чтение текста из документа
• Поиск и замена данных
• Вставка текста
• Применение заголовков
• Настройка колонтитулов
• Разрыв страниц
• Объединение и разделение документов
• Экспорт в PDF или TXT
• Добавление или замена изображений

Когда использовать

• Экспортировать документ в PDF перед отправкой
• Заменить имя клиента во всем отчете
• Объединить несколько файлов в один документ
• Разбить большой файл на части по страницам
• Добавить корпоративные заголовки и футеры

Установка

clawhub install fadeloo/tiangong-wps-word-automation

Если CLI не установлен:

npx clawhub@latest install fadeloo/tiangong-wps-word-automation

Требования

• Операционная система Windows
• Установленный Microsoft Word или WPS Writer
• Python и пакет pywin32

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

python {baseDir}/scripts/wps_word_automation.py read --input "C:\path\file.docx"

python {baseDir}/scripts/wps_word_automation.py replace --input "C:\path\file.docx" --find "old" --replace "new" --save "C:\path\out.docx"

python {baseDir}/scripts/wps_word_automation.py export --input "C:\path\file.docx" --format pdf --output "C:\path\out.pdf"

Основные команды

read

Извлечение текста из документа.

replace

Поиск и замена текста.

insert

Вставка текста в начало или конец документа.

headings

Применение стилей заголовков к строкам.

header-footer

Настройка верхних и нижних колонтитулов.

page-break

Добавление разрыва страницы.

merge

Объединение нескольких документов в один.

split

Разделение документа по диапазонам страниц.

export

Экспорт документа в PDF или TXT.

image

Добавление или замена изображения в документе.

Пример рабочего процесса

Запрос пользователя: экспортировать report.docx в PDF

• Найти путь к исходному файлу
• Запустить команду экспорта с параметром PDF
• Указать путь для сохранения
• Проверить успешное создание файла

Результат: файл report.pdf создан в указанной директории. :

Примечания

• Можно использовать WPS через параметр --app wps
• Параметр --visible true позволяет наблюдать за процессом
• Рекомендуется использовать для одиночных операций, а не пакетной обработки