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

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

ใช้เมื่อ unit test หรือเลน Slack live แบบ headless ไม่สามารถพิสูจน์บั๊กได้

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

Mantis ใช้เลเยอร์การจัดเก็บที่แตกต่างกันสามชั้น:

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

ห้ามใส่ความลับ, คุกกี้เบราว์เซอร์, สถานะการล็อกอิน Slack, repository checkouts, node_modules หรือ dist/ ลงในอิมเมจผู้ให้บริการที่อบไว้ล่วงหน้า

# การ dispatch ของ GitHub

รัน workflow จาก 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 ที่อนุญาตถูกจำกัดอย่างตั้งใจ เพราะ workflow ใช้ credentials จริง: บรรพบุรุษของ main ปัจจุบัน, release tags หรือ head ของ PR ที่เปิดอยู่ จาก openclaw/openclaw

workflow เขียน:

• อาร์ทิแฟกต์ที่อัปโหลด: mantis-slack-desktop-smoke-<run-id>-<attempt>;
• คอมเมนต์ PR แบบ inline จาก Mantis GitHub App;
• 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;
• log ระยะไกล เช่น slack-desktop-command.log, openclaw-gateway.log, chrome.log และ ffmpeg.log

คอมเมนต์ PR จะถูกอัปเดตที่เดิมด้วย marker ที่ซ่อนอยู่ <!-- mantis-slack-desktop-smoke -->

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

หลักฐานแบบ cold source:

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

ใช้ lease ที่อุ่นไว้ซ้ำ:

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 เฉพาะเมื่อ workspace ระยะไกลที่นำกลับมาใช้ซ้ำนั้น มี node_modules และ dist/ ที่ build แล้ว Mantis จะ fail closed หากสิ่งเหล่านั้น ขาดหายไป

# โหมด Hydrate

โหมด	ใช้เมื่อ	พฤติกรรมระยะไกล	ข้อแลกเปลี่ยน
source	หลักฐาน PR ปกติ, เครื่อง cold, CI	รัน pnpm install --frozen-lockfile --prefer-offline และ pnpm build ภายใน VM	ช้าที่สุด, เป็นหลักฐาน source-checkout ที่แข็งแรงที่สุด
prehydrated	คุณตั้งใจเตรียม lease ที่นำกลับมาใช้ซ้ำ	ต้องมี node_modules และ dist/ อยู่แล้ว; ข้าม install/build	เร็ว แต่ใช้ได้เฉพาะกับ warm leases ที่ operator ควบคุม

GitHub Actions จะเตรียม candidate checkout ก่อนการรัน VM เสมอ pnpm store ของมันถูกแคชตาม OS, เวอร์ชัน Node และ lockfile การรัน source ใน VM ยัง ใช้ /var/cache/crabbox/pnpm เมื่อมีอยู่ด้วย

# การตีความเวลา

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

• crabbox.warmup: การ boot ของผู้ให้บริการคลาวด์, ความพร้อมของ desktop/browser และ SSH
• crabbox.inspect: การค้นหา metadata ของ lease
• credentials.prepare: การได้มาซึ่ง lease ของ credential จาก Convex
• crabbox.remote_run: sync, การเปิดเบราว์เซอร์, การ install/build ของ OpenClaw หรือ การตรวจสอบ hydrate, การเริ่มต้น Gateway, ภาพหน้าจอ และการจับวิดีโอ
• artifacts.copy: rsync กลับจาก VM

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

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

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

# เช็กลิสต์หลักฐาน

คอมเมนต์ PR ที่ดีควรแสดง:

• scenario id และ candidate SHA;
• URL ของ GitHub Actions run;
• URL ของอาร์ทิแฟกต์;
• ภาพหน้าจอแบบ inline;
• animated preview แบบ inline เมื่อมี;
• ลิงก์ MP4 เต็มและ MP4 ที่ตัดแล้ว;
• สถานะผ่าน/ล้มเหลว;
• สรุปเวลาในรายงานที่แนบมา

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

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

หาก workflow ล้มเหลวก่อนการรัน VM ให้ตรวจสอบ job ของ Actions ก่อน สาเหตุทั่วไป คือ candidate_ref ที่ไม่น่าเชื่อถือ, environment secrets ที่ขาดหาย หรือ candidate install/build ล้มเหลว

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

cat mantis-slack-desktop-smoke-report.md
cat mantis-slack-desktop-smoke-summary.json
cat slack-desktop-command.log
cat openclaw-gateway.log
cat chrome.log
cat ffmpeg.log

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

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

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

# ที่เกี่ยวข้อง

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