TUI (Terminal UI)

เริ่มต้นอย่างรวดเร็ว

1. เริ่ม Gateway

bashCopy
mayros gateway

2. เปิด TUI

bashCopy
mayros tui

3. พิมพ์ข้อความและกด Enter

Gateway ระยะไกล:

bashCopy
mayros tui --url ws://<host>:<port> --token <gateway-token>

ใช้ --password หาก Gateway ของคุณใช้การพิสูจน์ตัวตนด้วยรหัสผ่าน

สิ่งที่คุณเห็น

• ส่วนหัว: URL การเชื่อมต่อ, agent ปัจจุบัน, เซสชันปัจจุบัน
• บันทึกแชท: ข้อความผู้ใช้, การตอบกลับ assistant, ประกาศระบบ, การ์ดเครื่องมือ
• บรรทัดสถานะ: สถานะการเชื่อมต่อ/การรัน (connecting, running, streaming, idle, error)
• ส่วนท้าย: สถานะการเชื่อมต่อ + agent + เซสชัน + โมเดล + think/verbose/reasoning + การนับโทเค็น + deliver
• อินพุต: ตัวแก้ไขข้อความพร้อม autocomplete

โมเดลจิต: agents + เซสชัน

• Agents เป็น slugs ที่ไม่ซ้ำ (เช่น main, research) Gateway เปิดเผยรายการ
• เซสชันเป็นของ agent ปัจจุบัน
• session keys ถูกเก็บเป็น agent:<agentId>:<sessionKey>
  • หากคุณพิมพ์ /session main TUI จะขยายมันเป็น agent:<currentAgent>:main
  • หากคุณพิมพ์ /session agent:other:main คุณสลับไปยังเซสชัน agent นั้นอย่างชัดเจน
• ขอบเขตเซสชัน:
  • per-sender (ค่าเริ่มต้น): แต่ละ agent มีหลายเซสชัน
  • global: TUI ใช้เซสชัน global เสมอ (ตัวเลือกอาจว่างเปล่า)
• agent ปัจจุบัน + เซสชันแสดงเสมอในส่วนท้าย

การส่ง + การส่งมอบ

• ข้อความถูกส่งไปยัง Gateway การส่งมอบไปยังผู้ให้บริการปิดตามค่าเริ่มต้น
• เปิดการส่งมอบ:
  • /deliver on
  • หรือแผง Settings
  • หรือเริ่มด้วย mayros tui --deliver

ตัวเลือก + overlays

• ตัวเลือกโมเดล: แสดงรายการโมเดลที่พร้อมใช้งานและตั้งค่าการแทนที่เซสชัน
• ตัวเลือก Agent: เลือก agent ที่แตกต่าง
• ตัวเลือกเซสชัน: แสดงเฉพาะเซสชันสำหรับ agent ปัจจุบัน
• การตั้งค่า: สลับ deliver, การขยายเอาต์พุตเครื่องมือ และการมองเห็นการคิด

แป้นพิมพ์ลัด

• Enter: ส่งข้อความ
• Esc: ยกเลิกการรันที่ใช้งาน
• Ctrl+C: ล้างอินพุต (กดสองครั้งเพื่อออก)
• Ctrl+D: ออก
• Ctrl+L: ตัวเลือกโมเดล
• Ctrl+G: ตัวเลือก agent
• Ctrl+P: ตัวเลือกเซสชัน
• Ctrl+O: สลับการขยายเอาต์พุตเครื่องมือ
• Ctrl+T: สลับการมองเห็นการคิด (โหลดประวัติใหม่)

คำสั่ง Slash

หลัก:

• /help
• /status
• /agent <id> (หรือ /agents)
• /session <key> (หรือ /sessions)
• /model <provider/model> (หรือ /models)

การควบคุมเซสชัน:

• /think <off|minimal|low|medium|high>
• /verbose <on|full|off>
• /reasoning <on|off|stream>
• /deliver <on|off>

วงจรชีวิตเซสชัน:

• /new หรือ /reset (รีเซ็ตเซสชัน)
• /abort (ยกเลิกการรันที่ใช้งาน)
• /settings
• /exit

คำสั่ง slash อื่นๆ ของ Gateway (เช่น /context) ถูกส่งต่อไปยัง Gateway และแสดงเป็นเอาต์พุตระบบ ดู คำสั่ง Slash

คำสั่ง shell ในโลคัล

• นำหน้าบรรทัดด้วย ! เพื่อรันคำสั่ง shell ในโลคัลบนโฮสต์ TUI
• TUI แจ้งครั้งหนึ่งต่อเซสชันเพื่ออนุญาตการดำเนินการในโลคัล การปฏิเสธเก็บ ! ปิดใช้งานสำหรับเซสชัน
• คำสั่งรันใน shell ใหม่ที่ไม่โต้ตอบในไดเรกทอรีทำงาน TUI (ไม่มี cd/env ถาวร)

ตัวเลือก

• --url <url>: Gateway WebSocket URL
• --token <token>: โทเค็น Gateway (ถ้าต้องการ)
• --password <password>: รหัสผ่าน Gateway (ถ้าต้องการ)
• --session <key>: session key (ค่าเริ่มต้น: main)
• --deliver: ส่งมอบการตอบกลับ assistant ไปยังผู้ให้บริการ (ปิดตามค่าเริ่มต้น)
• --thinking <level>: แทนที่ระดับการคิดสำหรับการส่ง
• --timeout-ms <ms>: Agent timeout ใน ms

การแก้ไขปัญหา

ไม่มีเอาต์พุตหลังจากส่งข้อความ:

• รัน /status ใน TUI เพื่อยืนยันว่า Gateway เชื่อมต่อและ idle/busy
• ตรวจสอบบันทึก Gateway: mayros logs --follow
• ยืนยันว่า agent สามารถรัน: mayros status และ mayros models status
• หากคุณคาดหวังข้อความในช่องทางแชท ให้เปิดใช้งานการส่งมอบ (/deliver on หรือ --deliver)