เวิร์กโฟลว์การพัฒนา Pi

คู่มือนี้สรุปเวิร์กโฟลว์ที่สมเหตุสมผลสำหรับการทำงานกับการรวม pi ใน Mayros

การตรวจสอบประเภทและการ Lint

  • ตรวจสอบประเภทและ build: pnpm build
  • Lint: 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 ทั้งหมดผ่าน 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

การทดสอบด้วยตนเอง

เวิร์กโฟลว์ที่แนะนำ:

  • เรียกใช้ gateway ในโหมดพัฒนา:
    • pnpm gateway:dev
  • กระตุ้น agent โดยตรง:
    • pnpm mayros agent --message "Hello" --thinking low
  • ใช้ TUI สำหรับการดีบักแบบโต้ตอบ:
    • pnpm tui

สำหรับพฤติกรรมการเรียกใช้เครื่องมือ ให้ prompt สำหรับการดำเนินการ read หรือ exec เพื่อให้คุณสามารถเห็นการสตรีมเครื่องมือและการจัดการเพย์โหลด

การรีเซ็ตแบบสะอาด

สถานะอยู่ภายใต้ไดเรกทอรีสถานะ Mayros ค่าเริ่มต้นคือ ~/.mayros หากตั้งค่า MAYROS_STATE_DIR ให้ใช้ไดเรกทอรีนั้นแทน

เพื่อรีเซ็ตทุกอย่าง:

  • mayros.json สำหรับการตั้งค่า
  • credentials/ สำหรับโปรไฟล์การพิสูจน์ตัวตนและโทเค็น
  • agents/<agentId>/sessions/ สำหรับประวัติเซสชัน agent
  • agents/<agentId>/sessions.json สำหรับดัชนีเซสชัน
  • sessions/ หากมีเส้นทางเก่า
  • workspace/ หากคุณต้องการ workspace ว่างเปล่า

หากคุณต้องการรีเซ็ตเซสชันเท่านั้น ให้ลบ agents/<agentId>/sessions/ และ agents/<agentId>/sessions.json สำหรับ agent นั้น เก็บ credentials/ ไว้หากคุณไม่ต้องการพิสูจน์ตัวตนใหม่

การอ้างอิง