Przepływ pracy rozwoju Pi

Ten przewodnik podsumowuje rozsądny przepływ pracy do pracy nad integracją pi w Mayros.

Sprawdzanie typów i lintowanie

  • Sprawdzanie typów i budowanie: pnpm build
  • Lint: pnpm lint
  • Sprawdzanie formatowania: pnpm format
  • Pełna bramka przed push: pnpm lint && pnpm build && pnpm test

Uruchamianie testów Pi

Użyj dedykowanego skryptu dla zestawu testów integracji pi:

bash
scripts/pi/run-tests.sh

Aby uwzględnić test na żywo, który sprawdza rzeczywiste zachowanie dostawcy:

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

Skrypt uruchamia wszystkie testy jednostkowe związane z pi przez te globs:

  • 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

Testowanie manualne

Zalecany przepływ:

  • Uruchom gateway w trybie dev:
    • pnpm gateway:dev
  • Wyzwól agenta bezpośrednio:
    • pnpm mayros agent --message "Cześć" --thinking low
  • Użyj TUI do interaktywnego debugowania:
    • pnpm tui

Dla zachowania wywołań narzędzi, poproś o akcję read lub exec, abyś mógł zobaczyć streamowanie narzędzi i obsługę payloadów.

Reset czystej tablicy

Stan znajduje się w katalogu stanu Mayros. Domyślnie to ~/.mayros. Jeśli MAYROS_STATE_DIR jest ustawiony, użyj tego katalogu.

Aby zresetować wszystko:

  • mayros.json dla konfiguracji
  • credentials/ dla profili uwierzytelniania i tokenów
  • agents/<agentId>/sessions/ dla historii sesji agenta
  • agents/<agentId>/sessions.json dla indeksu sesji
  • sessions/ jeśli istnieją ścieżki legacy
  • workspace/ jeśli chcesz czystego obszaru roboczego

Jeśli chcesz zresetować tylko sesje, usuń agents/<agentId>/sessions/ i agents/<agentId>/sessions.json dla tego agenta. Zachowaj credentials/ jeśli nie chcesz ponownie uwierzytelniać.

Referencje