yusong652/yade-mcp

Просматривайте Python API YADE как нативное дерево классов YADE. Дерево строится на реальной иерархии наследования YADE: пути отражают __mro__ класса вплоть до корневой категории. Никаких сокращений: всегда проходите через родителей.

Проверить статус и вывод отправленной задачи YADE.

Выполняет Python код синхронно в работающем процессе YADE. Возвращает stdout немедленно. Код выполняется в окружении Python YADE, где модули yade уже импортированы; побочные эффекты сохраняются. Этот инструмент остаётся отзывчивым ДАЖЕ ВО ВРЕМЯ выполнения симуляционной задачи (отправленной через yade_execute_task). Используйте его как живой REPL для проверки состояния симуляции в реальном времени — не нужно заранее прописывать print-выражения. Типичные сценарии: - Запрос состояния симуляции: количество тел O.bodies, текущая итерация - Создание/изменение тел, движков, взаимодействий - Чтение или задание свойств материалов - Живая инспекция во время запущенной симуляции (например, проверить тензор напряжений, координационное число, энергетический баланс или сделать скриншот области просмотра, если доступен GUI) - Разработка и REPL-стиль тестирования В отличие от yade_execute_task, этот инструмент работает по принципу «запустил и получил ответ»: ответ содержит полный вывод. Он НЕ отслеживается через yade_list_tasks и не может быть прерван или опрошен. Поведение при таймауте: при таймауте мост пытается прервать выполняемый код. Ответ содержит обёртку ошибки (``ok=false``), где ``error.code`` принимает одно из значений: - ``interrupted`` — код выполнял цикл симуляции (``O.run``) и был аккуратно приостановлен на границе итерации. Для длительных симуляций или решения до равновесия переключитесь на yade_execute_task — он отслеживает прогресс и чисто останавливается через yade_interrupt_task. - ``terminated`` — прерывание вне цикла сработало (инъекция асинхронного исключения); поток pump свободен, но состояние YADE может быть частично изменено кодом, выполнившимся до срабатывания прерывания. Проверьте состояние перед повторной попыткой. - ``timeout`` — прерывание не удалось (код застрял в C-расширении или внутри тика PyRunner запущенной задачи); мост может всё ещё быть заблокирован. Перезапустите, если нет ответа. ПРЕДУПРЕЖДЕНИЕ: Для всего, что займёт больше нескольких секунд, используйте вместо этого yade_execute_task — у него есть корректная отмена через yade_interrupt_task, и он не оставляет дрейф состояния при таймауте. Кроме того, НЕ пишите ``except BaseException:`` в коде…

Отправляет Python-скрипт на асинхронное выполнение в YADE. Мгновенно возвращает task_id; скрипт ставится в очередь и выполняется в фоне. Задачи выполняются по одной в порядке отправки (они используют общий процесс YADE и его единственное состояние симуляции), поэтому многоэтапный конвейер можно отправить за один раз — каждый этап запускается после завершения предыдущего. Используйте вспомогательные инструменты для управления жизненным циклом задачи: - yade_check_task_status: опрашивать вывод, прогресс и финальный статус - yade_interrupt_task: остановить выполняющуюся задачу или отменить поставленную в очередь - yade_list_tasks: просматривать историю задач (также показывает порядок очереди) Используйте это для рабочих симуляционных запусков, длительных циклов O.run() и любых операций, которые могут занимать минуты или дольше. Для быстрых запросов и тестирования в стиле REPL используйте yade_execute_code.

Останавливает выполняющуюся задачу YADE или отменяет задачу, ожидающую в очереди. Задача, которая ещё не запущена, просто удаляется из очереди и завершается со статусом ``canceled`` (``method`` сообщает ``canceled_while_queued``). Для выполняющейся задачи мост применяет два пути отмены одновременно: - ``flag_only`` - устанавливает флаг прерывания, который тик PyRunner YADE проверяет между итерациями симуляции (корректный путь для задач ``O.run``). - ``flag_and_async_exc`` - дополнительно внедряет исключение ``TaskInterrupt`` в поток скрипта, так что чисто-питоновские бесконечные циклы без ``O.run`` в стеке тоже завершаются. Поле ``method`` в ответе сообщает, какой путь сработал. Если async-exc отклонён (например, целевой поток является фреймом Dummy-N boost::python), ``async_exc_skipped_reason`` объясняет причину. Пространство имён после прерывания: пространство имён YADE ``__main__`` общее для задач и вызовов ``yade_execute_code``. Любые переменные, которые уже определил прерванный скрипт - включая состояние ``O`` - сохраняются. Нет необходимости перезапускать весь скрипт для продолжения работы: проверьте состояние через ``yade_execute_code`` или возобновите с помощью новой ``yade_execute_task``, которая выполняет только оставшуюся логику.

Выводит отслеживаемые задачи YADE с постраничным разделением. Задачи отображаются от новых к старым. Очередные (ожидающие) задачи выполняются по одной в порядке отправки, поэтому среди ожидающих записей следующей выполняется та, что находится ниже всех в списке.

Ищет по документации YADE API по ключевым словам (как grep). Возвращает подходящие имена классов/функций с описаниями, отсортированными по релевантности. Используйте yade_browse_api для полной документации конкретного класса. Когда использовать: - У вас есть ключевые слова, но вы не знаете точного имени класса - Примеры: "friction material", "gravity engine", "contact force", "triaxial stress", "sphere create", "hertz mindlin" Связанные инструменты: - yade_browse_api: Получить полную документацию по известному пути класса