Alur Kerja Pengembangan Pi

Panduan ini merangkum alur kerja yang masuk akal untuk bekerja pada integrasi pi di Mayros.

Type Checking dan Linting

  • Type check dan build: pnpm build
  • Lint: pnpm lint
  • Format check: pnpm format
  • Gate lengkap sebelum push: pnpm lint && pnpm build && pnpm test

Menjalankan Tes Pi

Gunakan skrip khusus untuk set tes integrasi pi:

bash
scripts/pi/run-tests.sh

Untuk menyertakan tes live yang melatih perilaku provider nyata:

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

Skrip menjalankan semua tes unit terkait pi melalui glob ini:

  • 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

Pengujian Manual

Alur yang direkomendasikan:

  • Jalankan gateway dalam mode dev:
    • pnpm gateway:dev
  • Picu agen secara langsung:
    • pnpm mayros agent --message "Hello" --thinking low
  • Gunakan TUI untuk debugging interaktif:
    • pnpm tui

Untuk perilaku tool call, minta tindakan read atau exec sehingga Anda dapat melihat streaming dan penanganan payload tool.

Reset Clean Slate

State berada di bawah direktori state Mayros. Default adalah ~/.mayros. Jika MAYROS_STATE_DIR diset, gunakan direktori itu sebagai gantinya.

Untuk mereset semuanya:

  • mayros.json untuk konfigurasi
  • credentials/ untuk profil auth dan token
  • agents/<agentId>/sessions/ untuk riwayat sesi agen
  • agents/<agentId>/sessions.json untuk indeks sesi
  • sessions/ jika path lama ada
  • workspace/ jika Anda ingin workspace kosong

Jika Anda hanya ingin mereset sesi, hapus agents/<agentId>/sessions/ dan agents/<agentId>/sessions.json untuk agen itu. Simpan credentials/ jika Anda tidak ingin autentikasi ulang.

Referensi