คู่มือการปฏิบัติงาน Mantis สำหรับ Slack บนเดสก์ท็อป

Mantis Slack desktop QA คือช่องทางทดสอบด้วย UI จริงสำหรับบั๊กประเภท Slack ที่ต้องใช้ เดสก์ท็อป Linux, การกู้คืนผ่าน VNC, Slack Web, Gateway ของ OpenClaw จริง, ภาพหน้าจอ, วิดีโอ และความคิดเห็นหลักฐานใน PR ใช้ช่องทางนี้เมื่อการทดสอบหน่วยหรือช่องทางทดสอบ Slack แบบสดที่ไม่มีส่วนติดต่อผู้ใช้ไม่สามารถพิสูจน์บั๊กได้

โมเดลการจัดเก็บ

Mantis ใช้พื้นที่จัดเก็บสามชั้น:

• อิมเมจของผู้ให้บริการ - Crabbox เป็นเจ้าของและจัดเก็บไว้ในบัญชีผู้ให้บริการคลาวด์ มีความสามารถของเครื่อง (Chrome/Chromium, ffmpeg, scrot, Node/corepack/pnpm, เครื่องมือบิลด์แบบเนทีฟ) และไดเรกทอรีแคชว่าง
• สถานะลีสที่อุ่นพร้อมใช้ - เซสชันของผู้ปฏิบัติงานปัจจุบันเป็นเจ้าของ สามารถเก็บ โปรไฟล์เบราว์เซอร์ที่เข้าสู่ระบบแล้ว, /var/cache/crabbox/pnpm และการเช็กเอาต์ซอร์ส ที่เตรียมไว้ขณะที่ลีสยังทำงานอยู่
• อาร์ติแฟกต์ของ Mantis - การรัน OpenClaw เป็นเจ้าของ อยู่ภายใต้ .artifacts/qa-e2e/mantis/...; GitHub Actions อัปโหลดอาร์ติแฟกต์เหล่านี้ และ GitHub App ของ Mantis แสดงความคิดเห็นพร้อมหลักฐานแบบฝังใน PR

ห้ามฝังข้อมูลลับ, คุกกี้ของเบราว์เซอร์, สถานะการเข้าสู่ระบบ Slack, การเช็กเอาต์รีโพซิทอรี, node_modules หรือ dist/ ลงในอิมเมจของผู้ให้บริการโดยเด็ดขาด

การสั่งงานผ่าน GitHub

เรียกใช้เวิร์กโฟลว์จาก main:

gh workflow run mantis-slack-desktop-smoke.yml \  --ref main \  -f candidate_ref=<trusted-ref-or-sha> \  -f pr_number=<pr-number> \  -f scenario_id=slack-canary \  -f crabbox_provider=aws \  -f keep_vm=false \  -f hydrate_mode=source

candidate_ref ถูกจำกัดเนื่องจากเวิร์กโฟลว์ใช้ข้อมูลประจำตัวจริง โดยต้องแก้ค่าได้เป็น บรรพบุรุษของ main ปัจจุบัน, แท็กรีลีส หรือเฮดของ PR ที่เปิดอยู่ใน openclaw/openclaw

เวิร์กโฟลว์สร้างสิ่งต่อไปนี้:

• อาร์ติแฟกต์ที่อัปโหลด mantis-slack-desktop-smoke-<run-id>-<attempt>
• ความคิดเห็นแบบฝังใน PR จาก GitHub App ของ Mantis
• slack-desktop-smoke.png, slack-desktop-smoke.mp4
• slack-desktop-smoke-preview.gif, slack-desktop-smoke-change.mp4
• mantis-slack-desktop-smoke-summary.json, mantis-slack-desktop-smoke-report.md
• บันทึกระยะไกล: slack-desktop-command.log, openclaw-gateway.log, chrome.log, ffmpeg.log

ความคิดเห็นใน PR จะได้รับการอัปเดตในตำแหน่งเดิมผ่านเครื่องหมายซ่อน <!-- mantis-slack-desktop-smoke -->

CLI ภายในเครื่อง

การพิสูจน์จากซอร์สบนเครื่องที่ยังไม่อุ่น:

pnpm openclaw qa mantis slack-desktop-smoke \  --provider aws \  --class standard \  --gateway-setup \  --credential-source convex \  --credential-role maintainer \  --provider-mode live-frontier \  --model openai/gpt-5.4 \  --alt-model openai/gpt-5.4 \  --scenario slack-canary \  --hydrate-mode source

เก็บ VM ไว้เพื่อกู้คืนผ่าน VNC:

pnpm openclaw qa mantis slack-desktop-smoke \  --provider aws \  --class standard \  --gateway-setup \  --scenario slack-canary \  --keep-lease

เปิด VNC:

crabbox vnc --provider aws --id <cbx_id> --open

ใช้ลีสที่อุ่นพร้อมใช้ซ้ำ:

pnpm openclaw qa mantis slack-desktop-smoke \  --provider aws \  --lease-id <cbx_id-or-slug> \  --gateway-setup \  --scenario slack-canary \  --hydrate-mode source

ใช้ --hydrate-mode prehydrated เฉพาะเมื่อพื้นที่ทำงานระยะไกลที่นำกลับมาใช้ซ้ำมี node_modules และ dist/ ที่บิลด์แล้ว มิฉะนั้น Mantis จะหยุดทำงานแบบปิดกั้น

พิสูจน์ UI การอนุมัติแบบเนทีฟของ Slack:

pnpm openclaw qa mantis slack-desktop-smoke \  --provider aws \  --class standard \  --approval-checkpoints \  --credential-source convex \  --credential-role maintainer \  --hydrate-mode source

--approval-checkpoints ใช้ร่วมกับ --gateway-setup ไม่ได้ โดยจะรันสถานการณ์แบบเลือกรับ slack-approval-exec-native และ slack-approval-plugin-native เว้นแต่คุณจะส่ง --scenario จุดตรวจสอบการอนุมัติอย่างชัดเจน ส่วนสถานการณ์ Slack อื่น จะถูกปฏิเสธก่อน VM เริ่มทำงาน ตัวรัน QA ของ Slack จะเขียนไฟล์ JSON ของแต่ละจุดตรวจสอบ จากข้อความ API ของ Slack จริงที่ตรวจพบ จากนั้นตัวเฝ้าดูระยะไกลจะแสดงผลข้อความนั้นเป็น approval-checkpoints/<scenario>-pending.png และ approval-checkpoints/<scenario>-resolved.png การรันจะล้มเหลวหากไฟล์ JSON ของจุดตรวจสอบ, หลักฐานข้อความ, ไฟล์ JSON การตอบรับ หรือภาพหน้าจอที่แสดงผลรายการใด ขาดหายหรือว่างเปล่า

ลีส GitHub Actions ที่ยังไม่อุ่นไม่มีคุกกี้ของ Slack Web ดังนั้นการจับภาพจากเบราว์เซอร์ อาจไปสิ้นสุดที่หน้าลงชื่อเข้าใช้ Slack สำหรับหลักฐานจุดตรวจสอบการอนุมัติ ให้เชื่อถือ ภาพจุดตรวจสอบที่แสดงผลและอาร์ติแฟกต์ QA ของ Slack แทน slack-desktop-smoke.png ใช้ลีสที่อุ่นพร้อมใช้ซึ่งเก็บไว้และมีโปรไฟล์ Slack Web ที่เข้าสู่ระบบด้วยตนเองแล้ว เฉพาะเมื่อภาพหน้าจอของเบราว์เซอร์ต้องแสดง Slack Web โดยตรงเท่านั้น

โหมดการเตรียมสภาพแวดล้อม

GitHub Actions จะเตรียมการเช็กเอาต์ตัวเลือกก่อนรัน VM เสมอ โดยแคชที่เก็บ pnpm ตามระบบปฏิบัติการ, เวอร์ชัน Node และไฟล์ล็อก การรัน source ใน VM จะใช้ /var/cache/crabbox/pnpm ซ้ำด้วยเมื่อมีอยู่

การตีความระยะเวลา

mantis-slack-desktop-smoke-report.md มีระยะเวลาของแต่ละช่วง:

• crabbox.warmup - การบูตของผู้ให้บริการคลาวด์, ความพร้อมของเดสก์ท็อป/เบราว์เซอร์ และ SSH
• crabbox.inspect - การค้นหาข้อมูลเมตาของลีส
• credentials.prepare - การขอลีสข้อมูลประจำตัวจาก Convex
• crabbox.remote_run - การซิงค์, การเปิดเบราว์เซอร์, การติดตั้ง/บิลด์ OpenClaw หรือ การตรวจสอบการเตรียมสภาพแวดล้อม, การเริ่ม Gateway, การจับภาพหน้าจอ และการบันทึกวิดีโอ
• artifacts.copy - การใช้ rsync คัดลอกกลับจาก VM

crabbox.remote_run อาจแสดง accepted เมื่อ Crabbox ส่งคืนสถานะระยะไกลที่ไม่ใช่ศูนย์ แต่ Mantis คัดลอกข้อมูลเมตาที่พิสูจน์ได้ว่าการตั้งค่า Gateway ของ OpenClaw เสร็จสมบูรณ์ หรือคำสั่ง QA ของ Slack เองออกจากการทำงานสำเร็จ ให้ถือว่า accepted คือผ่านพร้อมคำอธิบาย ไม่ใช่สถานการณ์ที่ล้มเหลว

หากการรันช้า:

• หากช่วงอุ่นเครื่องใช้เวลาส่วนใหญ่: อบล่วงหน้าหรือเลื่อนระดับอิมเมจผู้ให้บริการ Crabbox ที่ดีกว่า
• หาก remote_run ใช้เวลาส่วนใหญ่ใน source: ใช้ลีสที่อุ่นพร้อมใช้, ปรับปรุงการใช้ที่เก็บ pnpm ซ้ำ หรือย้ายสิ่งที่เครื่องต้องมีล่วงหน้าไปยังอิมเมจของผู้ให้บริการ
• หาก remote_run ใช้เวลาส่วนใหญ่ใน prehydrated: พื้นที่ทำงานระยะไกลยังไม่พร้อมจริง หรือการตั้งค่า Gateway/เบราว์เซอร์/Slack ทำงานช้า
• หากการคัดลอกอาร์ติแฟกต์ใช้เวลาส่วนใหญ่: ตรวจสอบขนาดวิดีโอและเนื้อหาในไดเรกทอรีอาร์ติแฟกต์

รายการตรวจสอบหลักฐาน

ความคิดเห็นใน PR ที่ดีควรแสดง:

• รหัสสถานการณ์และ SHA ของตัวเลือก
• URL การรัน GitHub Actions และ URL อาร์ติแฟกต์
• ภาพหน้าจอจุดตรวจสอบการอนุมัติแบบฝัง หรือภาพหน้าจอ Slack Web จากลีสที่อุ่นพร้อมใช้ ซึ่งเข้าสู่ระบบแล้ว
• ตัวอย่างภาพเคลื่อนไหวแบบฝังเมื่อมี
• ลิงก์ MP4 ฉบับเต็มและ MP4 ที่ตัดแต่งแล้ว
• สถานะผ่าน/ไม่ผ่านและสรุประยะเวลาจากรายงาน

อย่าคอมมิตภาพหน้าจอหรือวิดีโอลงในรีโพซิทอรี ให้เก็บไว้ในอาร์ติแฟกต์ของ GitHub Actions หรือความคิดเห็นใน PR

การจัดการความล้มเหลว

หากเวิร์กโฟลว์ล้มเหลวก่อนรัน VM ให้ตรวจสอบงาน Actions ก่อน สาเหตุทั่วไป ได้แก่ candidate_ref ที่ไม่น่าเชื่อถือ, ข้อมูลลับของสภาพแวดล้อมที่ขาดหาย หรือการติดตั้ง/บิลด์ตัวเลือกที่ล้มเหลว

หากการรัน VM ล้มเหลวแต่คัดลอกภาพหน้าจอกลับมาแล้ว ให้ตรวจสอบ:

cat mantis-slack-desktop-smoke-report.mdcat mantis-slack-desktop-smoke-summary.jsoncat slack-desktop-command.logcat openclaw-gateway.logcat chrome.logcat ffmpeg.log

หากการรันเก็บลีสไว้ ให้เปิด VNC ด้วยคำสั่ง crabbox vnc ... จากรายงาน จากนั้นหยุดลีสเมื่อเสร็จ:

crabbox stop --provider aws <cbx_id-or-slug>

หากการเข้าสู่ระบบ Slack หมดอายุ ให้แก้ไขผ่าน VNC บนลีสที่เก็บไว้ แล้วรันซ้ำด้วย --lease-id อย่าฝังโปรไฟล์เบราว์เซอร์นั้นลงในอิมเมจของผู้ให้บริการ

เนื้อหาที่เกี่ยวข้อง

• ภาพรวม QA
• ช่องทาง Slack
• การทดสอบ