clean

Назначение

Удалить кэшированные удалённые спецификации и сохранённые ответы на вызовы API. Это освобождает дисковое пространство и принудительно загружает свежие копии файлов спецификаций при следующем update или запуске mcp.

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

• Файлы спецификаций изменились на удалённом сервере, и вы хотите принудительно обновить кэш
• Вы хотите освободить дисковое пространство
• Вы диагностируете проблемы с устаревшим кэшем
• Перед запуском update для обеспечения чистой перекэшировки

Синтаксис

swag2mcp clean [path]

Аргументы

Аргумент	Позиция	Обязательно	Описание
path	1	Нет	Директория рабочей области. Если не указан, разрешается по правилам разрешения пути.

Флаги

Нет.

Как это работает

swag2mcp clean
swag2mcp clean ./my-workspace

Что очищается

Директория	Содержимое	Зачем
cache/	Скачанные удалённые файлы спецификаций	Принудительная перезагрузка при следующем обращении
responses/	Сохранённые ответы на вызовы API	Освобождение дискового пространства

Что сохраняется

Директория	Содержимое	Зачем
specs/	Локальные файлы спецификаций	Это ваши исходные файлы, а не кэш
auth_scripts/	Скрипты аутентификации	Они созданы пользователем, а не кэш

Очистка осиротевших скриптов аутентификации

После очистки clean также удаляет скрипты аутентификации для спецификаций, которые больше не существуют в конфигурации. Это предотвращает накопление устаревших скриптов.

Автоматическая очистка

При запуске MCP-сервера (swag2mcp mcp) ответы старше 48 часов удаляются автоматически. Обычно вам не нужно запускать clean вручную для routine-обслуживания.

Проверка после команды

ls ~/.swag2mcp/cache
# Должен быть пустым (директория существует, но файлов нет)

Нюансы

• Конфиг не требуется: clean работает даже без валидного файла конфигурации. Он просто удаляет директории кэша и ответов.
• Очистка осиротевших скриптов — best-effort: Если файл конфигурации повреждён или нечитаем, очистка осиротевших скриптов пропускается (не фатально).
• Директории сохраняются: Сами директории cache/ и responses/ остаются — удаляется только их содержимое.