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

ใช้หน้านี้เพื่อวินิจฉัยปัญหาที่พบบ่อยในการตั้งค่าและการทำงานของ Ogma

ไม่มีทราฟฟิกปรากฏในประวัติ HTTP

ตรวจสอบว่า:

1. อินสแตนซ์ Ogma กำลังทำงาน
2. พร็อกซีของเบราว์เซอร์หรือแอปพลิเคชันชี้ไปยังตัวรับการเชื่อมต่อของอินสแตนซ์ ซึ่งโดยทั่วไปคือ 127.0.0.1:8080
3. แอปพลิเคชันเป้าหมายไม่ได้ข้ามพร็อกซี
4. การตั้งค่า VPN พร็อกซีระบบ คอนเทนเนอร์ อีมูเลเตอร์ หรือพร็อกซีบนอุปกรณ์เคลื่อนที่ไม่ได้แทนที่การตั้งค่าของไคลเอนต์ที่ใช้ทดสอบ
5. โครงการที่ใช้งานอยู่เปิดในพื้นที่ทำงาน

หากใช้เบราว์เซอร์ Ogma ให้เปิดแท็บใหม่และยืนยันว่ามีป้าย ผ่านพร็อกซี แสดงอยู่

คำขอ HTTPS ล้มเหลว

ตรวจสอบว่า:

• ติดตั้งใบรับรอง CA ของ Ogma ในที่เก็บใบรับรองที่เชื่อถือได้อย่างถูกต้อง
• นำเข้า CA ลงในโปรไฟล์เบราว์เซอร์ที่ใช้งานจริงแล้ว
• เป้าหมายไม่ได้ใช้การตรึงใบรับรอง
• กฎส่งผ่าน TLS ไม่ได้ยกเว้นโฮสต์นี้
• กำหนดข้อกำหนดของใบรับรองไคลเอนต์ใน การตั้งค่า > ใบรับรองไคลเอนต์ แล้ว หากเป้าหมายต้องใช้ mTLS

สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่หรือเดสก์ท็อปที่ตรึงใบรับรอง คุณอาจต้องเตรียมการทดสอบเฉพาะแอปพลิเคชันนอก Ogma

การดักรับหยุดทราฟฟิกมากเกินไป

ใช้กฎดักรับที่มีขอบเขตแคบลง

ขั้นตอนที่แนะนำ:

1. ปิดการดักรับ
2. กำหนดขอบเขต
3. เพิ่มเงื่อนไขจับคู่โฮสต์ เมธอด พาธ ชนิดเนื้อหา หรือส่วนหัว
4. เปิดการดักรับอีกครั้ง
5. ติดตามขนาดคิว

หากคิวเต็ม Ogma จะส่งต่อทราฟฟิกใหม่เพื่อหลีกเลี่ยงภาวะติดตายของไคลเอนต์

เครื่องมือสแกนรายงานผลที่ไม่เกี่ยวข้องมากเกินไป

สำหรับผลที่ไม่เกี่ยวข้องจากการสแกนแบบพาสซีฟ:

• เปิดใช้งานขอบเขตก่อนสแกน
• ให้ความสำคัญกับประเด็นที่ตรวจพบระดับปานกลาง สูง และวิกฤตก่อน
• ประเมินประเด็นเกี่ยวกับส่วนหัวที่ขาดหายตามบริบท
• ใช้กฎพาสซีฟที่กำหนดเองสำหรับหลักฐานเฉพาะโครงการ

สำหรับผลที่ไม่เกี่ยวข้องจากการสแกนแบบแอกทีฟ:

• สแกนคำขอที่เลือกก่อนสแกนประวัติทั้งหมด
• ตรวจสอบคำขอที่ใช้พิสูจน์และเนื้อหาการตอบกลับ
• ยืนยันว่าหลักฐานในการตอบกลับไม่ได้มีอยู่แล้วในการตอบกลับฐานอ้างอิง
• ตรวจสอบว่าความเชื่อมั่นของประเด็นที่ตรวจพบอยู่ในระดับน่าจะเป็นหรือยืนยันแล้ว

ปลั๊กอินไม่โหลด

ตรวจสอบว่า:

1. โฟลเดอร์รากของปลั๊กอินมี manifest.json
2. พาธจุดเริ่มต้นในแมนิเฟสต์มีอยู่หลังการบิลด์
3. คอมไพล์ปลั๊กอินเป็น JavaScript ปกติแล้ว
4. รวมแอสเซ็ตส่วนหน้าไว้ในแพ็กเกจปลั๊กอินแล้ว
5. ประกาศและอนุมัติสิทธิ์ที่จำเป็นแล้ว
6. แท็บบันทึกของปลั๊กอินไม่มีข้อผิดพลาด init() หรือบริดจ์
7. ขนาดแพ็กเกจปลั๊กอินต่ำกว่าขีดจำกัดที่กำหนดไว้

ผู้ช่วย MCP ไม่สามารถเข้าถึง Ogma

ตรวจสอบว่า:

• HTTP แบบฝัง: MCP ทำงานใน การตั้งค่า > MCP และไคลเอนต์ใช้ปลายทาง Streamable HTTP ที่คัดลอกมา ซึ่งโดยทั่วไปคือ http://127.0.0.1:3000/mcp
• stdio แบบแยก: พาธไฟล์ไบนารีถูกต้อง และ --api-url / OGMA_API_URL ตรงกับระบบหลังบ้านที่กำลังทำงาน อินสแตนซ์เดสก์ท็อปอาจใช้พอร์ต API แบบไดนามิก
• ไคลเอนต์ติดตามเคอร์เซอร์ทุกตัวของ tools/list เพราะหน้าแรกเพียงหน้าเดียวไม่ได้มีเครื่องมือทั้งหมด
• เครื่องมือเขียนหรือส่งต้องมีสิทธิ์ที่อนุมัติอย่างชัดเจนในการตั้งค่า หรือใช้แฟล็กสำหรับการทำงานแบบแยก
• เชื่อมต่อใหม่หลัง MCP เริ่มทำงานใหม่ ID เซสชันและโทเค็นยืนยันเดิมจะใช้ไม่ได้อีกต่อไป

ดู การตั้งค่า MCP

เบราว์เซอร์ Ogma ว่างเปล่าหรืออยู่ผิดตำแหน่ง

ตรวจสอบว่า:

• คุณกำลังใช้แอปเดสก์ท็อป ไม่ใช่เพียงส่วนหน้าบนเว็บ
• แท็บที่ใช้งานมี URL จริง ไม่ใช่ about:blank
• ลองเปิดเบราว์เซอร์ในหน้าต่างแยก
• ปรับขนาดหน้าต่าง Ogma เพื่อบังคับให้คำนวณกรอบเบราว์เซอร์ใหม่

JavaScript หรือ CSS ที่กำหนดเองทำให้ UI เสียหาย

ใช้วิธีกู้คืนวิธีใดวิธีหนึ่ง:

• คลิก รีเซ็ตส่วนติดต่อผู้ใช้ที่ปรับแต่ง
• กด Ctrl+Alt+Shift+R

การดำเนินการนี้ล้าง JavaScript และ CSS ที่กำหนดเองออกจากที่เก็บข้อมูลในเครื่อง การตั้งค่าเดสก์ท็อป และค่ากำหนดระบบหลังบ้าน แล้วโหลด Ogma ใหม่

ข้อมูลหรือโครงการดูไม่ถูกต้อง

ตรวจสอบว่า:

• เปิดอินสแตนซ์ที่ถูกต้องอยู่
• โครงการที่ถูกต้องกำลังใช้งาน
• ค่ากำหนดเริ่มต้นไม่ได้เปิดอินสแตนซ์อื่นขึ้นมาใหม่
• ตัวกรองหรือขอบเขตไม่ได้ซ่อนแถวที่ควรแสดง
• การซ่อนแอสเซ็ตคงที่ไม่ได้ยกเว้นชนิดเนื้อหาที่คุณกำลังค้นหา

สร้างข้อมูลสำรองก่อนเปลี่ยนข้อมูลโครงการด้วยตนเอง