Процесс разработки Pi

Это руководство описывает разумный процесс работы над интеграцией pi в Mayros.

Проверка типов и линтинг

  • Проверка типов и сборка: pnpm build
  • Линтинг: pnpm lint
  • Проверка форматирования: pnpm format
  • Полная проверка перед push: pnpm lint && pnpm build && pnpm test

Запуск тестов Pi

Используйте специальный скрипт для набора тестов интеграции pi:

bash
scripts/pi/run-tests.sh

Чтобы включить живой тест, который проверяет реальное поведение провайдера:

bash
scripts/pi/run-tests.sh --live

Скрипт запускает все связанные с pi юнит-тесты через эти глобы:

  • src/agents/pi-*.test.ts
  • src/agents/pi-embedded-*.test.ts
  • src/agents/pi-tools*.test.ts
  • src/agents/pi-settings.test.ts
  • src/agents/pi-tool-definition-adapter.test.ts
  • src/agents/pi-extensions/*.test.ts

Ручное тестирование

Рекомендуемый процесс:

  • Запустите gateway в режиме разработки:
    • pnpm gateway:dev
  • Вызовите агента напрямую:
    • pnpm mayros agent --message "Hello" --thinking low
  • Используйте TUI для интерактивной отладки:
    • pnpm tui

Для поведения вызова инструментов, запросите действие read или exec, чтобы увидеть потоковую передачу и обработку полезных нагрузок инструментов.

Сброс с чистого листа

Состояние хранится в директории состояния Mayros. По умолчанию это ~/.mayros. Если установлен MAYROS_STATE_DIR, используйте эту директорию.

Для полного сброса:

  • mayros.json для конфигурации
  • credentials/ для профилей аутентификации и токенов
  • agents/<agentId>/sessions/ для истории сессий агента
  • agents/<agentId>/sessions.json для индекса сессий
  • sessions/ если существуют устаревшие пути
  • workspace/ если хотите чистое рабочее пространство

Если хотите сбросить только сессии, удалите agents/<agentId>/sessions/ и agents/<agentId>/sessions.json для этого агента. Сохраните credentials/, если не хотите повторно аутентифицироваться.

Справочники