Робочий процес розробки Pi

Цей посібник підсумовує здоровий робочий процес для роботи над інтеграцією pi в Mayros.

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

  • Перевірка типів та збірка: pnpm build
  • Лінт: pnpm lint
  • Перевірка формату: pnpm format
  • Повна перевірка перед пушем: 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

Ручне тестування

Рекомендований процес:

  • Запустіть шлюз у режимі розробки:
    • pnpm gateway:dev
  • Запустіть агента безпосередньо:
    • pnpm mayros agent --message "Привіт" --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/, якщо ви не хочете повторно автентифікуватися.

Посилання