DSH iOS ซิมูเลเตอร์

iOS ซิมูเลเตอร์แบบสดและโต้ตอบได้ภายในบทสนทนาของ DeepSeek Harness — พร้อม iPhone จริงของคุณผ่าน USB
_{22 เครื่องมือเอเจนต์ • แผงข้าง MJPEG สด • ซิมูเลเตอร์ & iPhone จริงผ่าน USB • การทำงานกับแถวรายการ/ฟีด • โหลดซ้ำทันทีของพรีวิว SwiftUI}

_{npm: @zseven-w/dsh-ios · รีลีสปลั๊กอินปัจจุบัน: 0.1.0-rc.3 · ทดสอบกับ DSH 0.1.1-rc.1}

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia

_{npm: @zseven-w/dsh-ios · เวอร์ชันปลั๊กอินปัจจุบัน: 0.1.0-rc.3 · ทดสอบกับ DSH 0.1.1-rc.1}

_{iPhone เครื่องจริงที่ควบคุมจากในบทสนทนา DSH — การเรียกเครื่องมืออยู่ทางซ้าย แผงอุปกรณ์สดอยู่ทางขวา}

` ค่าเริ่มต้น 2m) หรือ `follow` (จับสดแบบมีขอบเขต `duration_seconds` ค่าเริ่มต้น 10 สูงสุด 60 — ไม่มีวันเป็นสตรีมค้าง) เอาต์พุตจำกัด ~300 บรรทัด / 30 KB พร้อมคำใบ้ให้แคบลง | `udid` (ไม่บังคับ), `mode` (`snapshot`/`follow`), `duration`, `duration_seconds`, `bundle_id`, `predicate` (NSPredicate ดิบ แทนที่ `bundle_id`), `level` (`default`/`info`/`debug`), `grep` | ### เครื่องมือพรีวิว | เครื่องมือ | หน้าที่ | พารามิเตอร์หลัก | | --- | --- | --- | | `ios_sim_preview` | โหลดซ้ำทันทีของพรีวิว SwiftUI แบบสดในซิมูเลเตอร์: `start` (ค่าเริ่มต้น) ตรวจสอบแพ็กเกจ สร้างแอปโฮสต์ใช้แล้วทิ้งในแคชของปลั๊กอิน (ไม่มีวันอยู่ในแพ็กเกจของคุณ) บิลด์แพ็กเกจเป็น dylib สำหรับซิมูเลเตอร์ ติดตั้งและเปิดโฮสต์ แล้วเฝ้าดูซอร์ส — ทุกการแก้ไขบิลด์ใหม่และสลับร้อนโดยไม่ต้องเปิดใหม่ (~2–5 วินาที) ข้อผิดพลาดคอมไพเลอร์คงพรีวิวที่ดีล่าสุดไว้และแสดงผ่าน `status` ครั้งละหนึ่งเซสชัน | `packagePath` (จำเป็นสำหรับ `start`), `udid`, `action` (`start`/`status`/`stop`), `previewFilter` (สตริงย่อยไม่แยกตัวพิมพ์ใหญ่-เล็กบนชื่อพรีวิว) | ### เครื่องมือดีบัก | เครื่องมือ | หน้าที่ | พารามิเตอร์หลัก | | --- | --- | --- | | `ios_sim_processes` | แสดงรายการโพรเซสแอปที่กำลังทำงานของซิมูเลเตอร์หนึ่งจาก launchd ของมันเอง (pid ที่โฮสต์เห็น ชื่อ bundle id) — แหล่ง pid สำหรับแบ็กเทรซ/หน่วยความจำรั่ว udid อุปกรณ์จริงจะแสดงรายการโพรเซสของโทรศัพท์ผ่าน devicectl แทน | `udid` (ไม่บังคับ), `filter` (สตริงย่อยไม่แยกตัวพิมพ์ใหญ่-เล็กบนชื่อ/bundle id) | | `ios_sim_backtrace` | LLDB แบบแบตช์ครั้งเดียว (แนบ → แบ็กเทรซเธรด → ถอด ไม่มีวันโต้ตอบ) เอาต์พุตจำกัด ~200 บรรทัด เธรดหลักก่อน เป้าหมายถูกตรวจสอบเสมอว่าทำงานต่อแล้ว เมื่อ macOS ปฏิเสธการแนบ (โหมดนักพัฒนาปิด) จะลดระดับไปใช้เอนจิน `sample` ของ Xcode (ไม่ระงับ) และรายงานคำใบ้ให้เปิดใช้ เฉพาะซิมูเลเตอร์ — อุปกรณ์จริงถูกปฏิเสธพร้อมเหตุผล | `udid` (ไม่บังคับ), `pid` / `bundle_id`, `all_threads` (ค่าเริ่มต้น true) | | `ios_sim_leaks` | วิเคราะห์หน่วยความจำรั่วด้วยเครื่องมือ `leaks` ของ Xcode: `summary` (จำนวนที่รั่ว ไบต์ที่รั่วรวม ประเภทสูงสุด ~30 ชนิด) หรือ `memgraph` (อาร์ติแฟกต์ `.memgraph` สำหรับเปิดใน Xcode Instruments ไม่มีวันถูกแยกวิเคราะห์ที่นี่) แอปถูกระงับระหว่างสแกนและกลับมาทำงานเสมอ เฉพาะซิมูเลเตอร์ | `udid` (ไม่บังคับ), `pid` / `bundle_id`, `mode` (`summary`/`memgraph`) | | `ios_sim_app_info` | ข้อมูลแอปที่ติดตั้ง: เส้นทางแอปบันเดิล คอนเทนเนอร์ข้อมูลที่เขียนได้ และค่า Info.plist — ผ่าน `simctl appinfo` (พร้อม `get_app_container` สำรอง) บนซิมูเลเตอร์ ผ่าน `devicectl` บนโทรศัพท์ USB `installed: false` พร้อม `note` ที่ชี้ `ios_sim_list_apps` สำหรับแอปที่หายไป | `udid` (ไม่บังคับ), `bundle_id` (จำเป็น) | ## พื้นผิวการแสดงผล - **แผงข้าง — “iOS 模拟器”.** มุมมองสดอยู่ในแผงขวาแบบถาวร (ด็อกคงที่ที่ดันบทสนทนาออกข้าง หรือโอเวอร์เลย์กึ่งกลางบนวิวพอร์ตแคบ) แผงแสดงสตรีม MJPEG สดและรับการคลิกเพื่อแตะและการลากเพื่อท่าทางบนวิดีโอโดยตรง พร้อมแถบไอคอน (โฮม สกรีนช็อต หมุน รีเฟรช) ที่ปุ่มมีทูลทิปเมื่อชี้ การควบคุมขนาดมี **适应** (พอดีความกว้างแผง) ซูม **50–125%** ของความกว้างตรรกะของอุปกรณ์ และค่าที่ตั้งไว้ล่วงหน้า **S / M / L** ที่กำหนดด้านสั้นของอุปกรณ์ (ความกว้างแนวตั้ง แนวนอนจะสเกลให้อุปกรณ์คงขนาดกายภาพ) สไตล์เฟรมคือ **无框 / 边框 / 真机框** (ไร้เฟรม / ขอบจอ / ตัวเครื่องอุปกรณ์เสมือนจริง) พร้อมรัศมีมุมตามสัดส่วน เมื่ออุปกรณ์หมุนเป็นแนวนอน แผงจะขยายอัตโนมัติเป็นขนาดสบายตาและคืนความกว้างของคุณเมื่อหมุนกลับ — การลากด้วยมือระหว่างนั้นชนะเสมอ ที่จับขอบซ้ายลากแผงให้กว้าง/แคบ (สูงสุด 960 px ดับเบิลคลิกรีเซ็ตเป็นความกว้างเริ่มต้น) เมื่อ iPhone ที่เชื่อมต่อ USB เป็นเป้าหมายสตรีม แผงเดียวกันจะแสดงสตรีม MJPEG ของ WebDriverAgent จากโทรศัพท์ด้วยการควบคุมชุดเดียวกัน - **การ์ดสนทนาแบบกะทัดรัด.** ผลลัพธ์เครื่องมือแสดงเป็นการ์ดบรรทัดเดียวโดยไม่มีภาพในบรรทัด: ชื่อรวม **“iOS 模拟器”** ป้ายย่อยการกระทำ (บูต / สกรีนช็อต / โต้ตอบ / บิลด์และรัน / เริ่ม WebDriverAgent) ชื่ออุปกรณ์ แบดจ์สถานะ และคำใบ้ “เปิดในแผงข้าง” การคลิกแถวจะเปิดแผง การคลิกปุ่ม ลิงก์ หรือเฟรมสดเองไม่มีวันเปิด - **แคปซูลสถานะเหนือช่องพิมพ์.** ขณะแผงปิดและมีสตรีมออนไลน์ เม็ดเล็กจุดเขียว (`` · 实时) ปรากฏเหนือช่องพิมพ์ข้อความและเปิดแผงเมื่อคลิก มันผูกกับเซสชัน: แสดงและโพลเฉพาะเมื่อบทสนทนาปัจจุบันมีผลลัพธ์ซิมูเลเตอร์ติดตั้งอยู่ และหยุดเมื่อสลับไปเซสชันที่ไม่มี - **โหมดมาตรฐานและโหมด Code.** เซสชันมาตรฐานใช้ `presentationMeta` ที่โฮสต์ฉายให้ ดิสแพตช์แบบซ้อนของโหมด Code (PTC) ไม่มีวันพก meta ดังนั้นไคลเอนต์จึงสร้าง meta เดียวกันขึ้นใหม่จาก JSON ผลลัพธ์ถาวร — แผง การ์ด และแคปซูลทำงานได้ทั้งสองโหมด ## ความปลอดภัย - เบราว์เซอร์ไม่มีวันคุยกับพอร์ตของ serve-sim ทุกไบต์ผ่านออริจินของเว็บเซิร์ฟเวอร์ DSH ผ่านเส้นทาง `/_dsh/dsh-ios/*` ที่ปลั๊กอินเป็นเจ้าของ: `/stream/` (พร็อกซี MJPEG), `/screenshot/` (PNG แคช), `/ws?token=…` (รีเลย์ควบคุม HID) พร้อมเอนด์พอยต์ `/grant`, `/capture` และ `/status` - โทเคนคือความสามารถ HMAC-SHA256 (`base64url(payload).base64url(mac)`) ที่หมดอายุภายใน 10 นาที ลงนามด้วยคีย์ต่อโฮมของ DSH (`/cache/dsh-ios/stream-access.key`, 0600, สร้างแบบอะตอมมิก) - ทุกเส้นทางใช้รั้วขนส่งลูปแบ็ก/เชื่อถือได้ก่อนตรวจสอบความสามารถใด ๆ: ที่อยู่เพียร์ลูปแบ็ก `Host` แบบลูปแบ็ก (ปฏิเสธ DNS-rebinding) และการตรวจสอบ Fetch-Metadata/Origin เส้นทางสกรีนช็อตให้บริการเฉพาะไฟล์ในไดเรกทอรีแคชของปลั๊กอิน (ปฏิเสธลิงก์สัญลักษณ์ ตรวจสอบ `realpath`) - serve-sim รันเป็นโพรเซสลูกเบื้องหน้าบนลูปแบ็กเท่านั้น ในช่วงพอร์ตเฉพาะ (3181–3244) ดังนั้น serve-sim ของผู้ใช้เองบนพอร์ต 3100 ไม่มีวันถูกแตะ `--host` ไม่มีวันถูกใช้ - **การขนส่งอุปกรณ์จริง** — ทันเนลควบคุมของ WebDriverAgent (REST พอร์ตอุปกรณ์ 8100) และจอ (MJPEG พอร์ต 9100) คือการส่งต่อ usbmux แบบลูปแบ็กบนลิงก์ USB อยู่หลังรั้วเส้นทางที่ลงนามเดียวกัน และเบราว์เซอร์ยังคุยกับออริจินของเว็บเซิร์ฟเวอร์ DSH เท่านั้น - **การรับเลี้ยง/เรียกคืนโพรเซสกำพร้า** — หากโฮสต์ DSH ก่อนหน้าถูกฆ่าอย่างไม่สุภาพและตัวช่วย serve-sim ของมันรอดมา อุปกรณ์เดียวกันจะถูกรับเลี้ยง (แฮนด์เชกของโพรเซสกำพร้าเชื่อถือได้) ตัวช่วยเก่าที่ครองช่องของอุปกรณ์อื่นถูกเรียกคืนผ่าน `serve-sim -k` แล้วเปิดใหม่หนึ่งครั้ง - **Keep-alive + หยุดเมื่อว่าง** — สตรีมที่ล่มเริ่มใหม่ในเบื้องหลัง (~5 วินาที) เมื่อไม่มีผู้บริโภค สตรีมหยุดอัตโนมัติหลัง 5 นาที การหยุดโดยตั้งใจไม่มีวันถูกขัดขวาง (รันเนอร์อุปกรณ์จริงถูกยกเว้นการเก็บเกี่ยวเมื่อว่างโดยตั้งใจ: การเริ่มใหม่มีค่าเท่ากับการบิลด์ `xcodebuild` ใหม่หลายนาที) ## ข้อกำหนด - **macOS พร้อม Xcode ตัวเต็ม** — แค่ Command Line Tools ไม่พอ `xcodebuild`, `xcrun simctl` และรันไทม์ซิมูเลเตอร์ทั้งหมดมากับ Xcode - **รันไทม์ซิมูเลเตอร์ iOS อย่างน้อยหนึ่งตัว** ติดตั้งใน Xcode - **DSH ≥ 0.1.0-rc.6 พร้อมเว็บบันเดิล** สำหรับแผง โปรไฟล์ headless ก็ใช้ได้: เครื่องมือทั้ง 22 ตัวทำงานปกติ แค่ไม่มีมุมมองสด - **โฮสต์ที่ไม่ใช่ macOS**: ปลั๊กอินโหลดและเครื่องมือทั้ง 22 ตัวลงทะเบียน แต่ทุกการเรียกคืนข้อผิดพลาดที่อธิบายได้ (`iOS Simulator requires macOS with Xcode …`) - **serve-sim** มาพร้อมเป็น dependency npm ของปลั๊กอินนี้ จึงแก้ไขในเครื่องได้เมื่อติดตั้งจริง ทางเลือกสำรอง `npx -y serve-sim` ครอบคลุมทรีพัฒนา (ใช้ครั้งแรกต้องมีเน็ต) - **AXe** (ไม่บังคับ — เฉพาะเครื่องมือแบบ AXe เท่านั้นที่ต้องใช้: `ios_sim_ui_tree` / `ios_sim_tap_element` รวม `ios_sim_ui_rows` / `ios_sim_tap_row` บนซิมูเลเตอร์): `brew install cameroncooke/axe/axe` หรือให้ปลั๊กอินดาวน์โหลดรีลีสที่ตรึงไว้ (v1.8.0 ตรวจสอบ SHA-256) ลง `~/Library/Caches/dsh-ios/bin` อัตโนมัติ `DSH_IOS_AXE_BIN` แทนที่การแก้ไข `DSH_IOS_AXE_OFFLINE=1` ปิดการดาวน์โหลด - **Vision OCR** (ไม่บังคับ — เฉพาะ `ios_sim_find_text` / `ios_sim_tap_text` เท่านั้นที่ต้องใช้): ปลั๊กอินคอมไพล์ `assets/ocr.swift` ที่แถมมาด้วย `swiftc` เมื่อใช้ครั้งแรกลง `~/Library/Caches/dsh-ios/bin/ocr` (จดจำ zh-Hans + en-US) - **การแนบ lldb ต้องใช้โหมดนักพัฒนาของ macOS**: รัน `sudo DevToolsSecurity -enable` หนึ่งครั้ง ก่อนหน้านั้น `ios_sim_backtrace` ใช้เอนจิน `sample` ของ Xcode (ไม่ระงับ) และ `ios_sim_leaks` ลดระดับพร้อมคำใบ้ให้เปิดใช้ - **iPhone จริง** — iPhone ที่เชื่อมต่อ USB และปลดล็อกหน้าจอแล้ว (WebDriverAgent เริ่มบนจอล็อกไม่ได้ พิจารณา ล็อกอัตโนมัติ: ไม่ต้อง) สาย USB ที่รับส่งข้อมูลได้ (การจับคู่ผ่าน Wi-Fi เท่านั้นส่งต่อพอร์ตไม่ได้) เปิดโหมดนักพัฒนาบนอุปกรณ์ มีเช็กเอาต์ WebDriverAgent ที่ `~/Library/Caches/dsh-ios/wda/src` (ปลั๊กอินบิลด์สกีม `WebDriverAgentRunner` จากตรงนั้น — มันไม่มีวันดาวน์โหลดหรือโคลนอะไร) และ usbmux จาก libimobiledevice (`brew install libimobiledevice`) สำหรับทันเนล USB การบิลด์ WDA ครั้งแรกติดตั้ง WebDriverAgentRunner ที่ลงนามแล้ว: เชื่อถือใบรับรองบนอุปกรณ์เมื่อถูกถาม และรัน `ios_real_start_wda` ซ้ำเมื่อโปรไฟล์การลงนามทีมฟรีหมดอายุ (อายุ 7 วัน) ## ติดตั้งลงใน DSH ```sh dsh plugin --profile web add @zseven-w/dsh-ios@latest dsh web ``` ## เริ่มต้นอย่างรวดเร็ว บทสนทนาแรกโดยทั่วไป: 1. **ค้นหาอุปกรณ์** — “แสดงรายการซิมูเลเตอร์ที่มี” → `ios_sim_devices` 2. **บูต** — “บูต iPhone 17 Pro” → `ios_sim_boot` สตรีมเริ่มและ**แผง “iOS 模拟器”**เปิดขึ้น: อุปกรณ์แสดงสดในแผงข้าง (คลิกแถวการ์ดซิมูเลเตอร์ใดก็ได้ หรือเม็ดสถานะเหนือช่องพิมพ์ เพื่อเปิดใหม่) 3. **แตะบนวิดีโอ** — แตะหรือลากบนแผงโดยตรง หรือให้เอเจนต์ขับเคลื่อน UI: “เปิดการตั้งค่า แล้วแตะ General” → `ios_sim_interact` (หรือ `ios_sim_ui_tree` + `ios_sim_tap_element` สำหรับการแตะตามเอกลักษณ์ `ios_sim_find_text` + `ios_sim_tap_text` สำหรับการแตะตามข้อความ `ios_sim_ui_rows` + `ios_sim_tap_row` สำหรับแอปรายการ/ฟีด) 4. **บิลด์และรันแอปของคุณ** — “บิลด์และรัน /path/to/MyApp.xcodeproj” → `ios_sim_build_run` การบิลด์เต็มใช้เวลาหลายนาที เมื่อเสร็จแล้วแอปจะเปิดบนซิมูเลเตอร์และคุณดูสดในแผงได้ 5. **โหลดซ้ำทันทีของพรีวิว** — “แสดงพรีวิว SwiftUI ของ /path/to/MyPackage” → `ios_sim_preview start` แก้ไฟล์ซอร์สแล้วพรีวิวจะสลับร้อนเข้าเครื่องจำลองที่กำลังทำงานใน ~2–5 วินาที — ไม่ต้องเปิดใหม่ 6. **ขับเคลื่อน iPhone จริง** — เสียบโทรศัพท์ผ่าน USB (สายข้อมูล) ปลดล็อก แล้ว “เริ่ม WebDriverAgent บนโทรศัพท์” → `ios_real_start_wda` แผงสลับเป็นสตรีมสดของโทรศัพท์และทุกเครื่องมือยอมรับ udid ใน `realDevices` ของมัน เมื่อการเรียกล้มเหลว อ่านเหตุผลแบบรหัสจากสถานะของแผง (`device-locked`, `cert-untrusted`, `profile-expired`, `tunnel-failed`, `device-unplugged`) ## การแก้ปัญหา - **แบ็กเทรซใช้ `sample` แทน lldb หรือ leaks บ่นเรื่องการตรวจสอบที่ถูกจำกัด** — โหมดนักพัฒนาของ macOS ปิดอยู่ รัน `sudo DevToolsSecurity -enable` หนึ่งครั้งแล้วลองใหม่ จนกว่าจะถึงตอนนั้นเครื่องมือลดระดับอย่างเรียบร้อย: `ios_sim_backtrace` ถอยไปใช้ `sample` ของ Xcode (มีสัญลักษณ์แล้ว ไม่ระงับ) และ `ios_sim_leaks` รายงานคำใบ้ให้เปิดใช้ - **`ios_sim_ui_tree` / `ios_sim_tap_element` ต้องใช้ AXe** — ติดตั้งด้วย `brew install cameroncooke/axe/axe` หรือให้ปลั๊กอินดาวน์โหลดรีลีสที่ตรึงไว้เมื่อใช้ครั้งแรก (ต้องมีเน็ตไป github.com) ข้อความข้อผิดพลาดมีคำใบ้การติดตั้งครบถ้วนเสมอ `DSH_IOS_AXE_BIN=/path/to/axe` แทนที่การแก้ไข เครื่องมือแถว (`ios_sim_ui_rows` / `ios_sim_tap_row`) ต้องใช้ AXe บนซิมูเลเตอร์ด้วย - **`ios_sim_find_text` / `ios_sim_tap_text` รายงานว่าตัวช่วย OCR หายไป** — การใช้ครั้งแรกจะคอมไพล์ `assets/ocr.swift` ที่แถมมาด้วย `swiftc` (ต้องมี Xcode) ลง `~/Library/Caches/dsh-ios/bin/ocr` ข้อผิดพลาดมีเส้นทางและคำใบ้ที่แน่นอน - **`ios_sim_ui_rows` ไม่พบแถว** — ผลลัพธ์บอกเหตุผล: ความลึกน้อยเกินไป (เพิ่ม `max_depth` บนโทรศัพท์แต่ละสแนปช็อตที่ลึกขึ้นใช้ ~15–25 วินาที) ไม่ใช่จอรายการ หรือไม่มีข้อมูลการช่วยการเข้าถึงจริง ๆ หลังอ่านเชิงลึก การอ่านตื้นไม่มีวันถูกรายงานผิดเป็น “ไม่มีการช่วยการเข้าถึง” - **`ios_sim_leaks` บนซิมูเลเตอร์ iOS 26.2** — บนรันไทม์ iOS 26.2 `leaks` ของ Xcode อาจตรวจสอบโพรเซสซิมูเลเตอร์ไม่สำเร็จด้วยการวินิจฉัยร้ายแรง เช่น `Failed to get DYLD info` หรือข้อผิดพลาด minimal-corpse แม้เปิดโหมดนักพัฒนาแล้ว เครื่องมือลดระดับอย่างเรียบร้อย: คุณได้การวินิจฉัยดิบ เป้าหมายถูกตรวจสอบเสมอว่าทำงานต่อ และไม่มีอะไรค้าง ไม่มีการแก้ไขฝั่งปลั๊กอิน — เมื่อเจอให้ลอง `mode: "memgraph"` หรือรันไทม์อื่น - **การเรียกอุปกรณ์จริงล้มเหลวด้วยสถานะแบบรหัส** — สถานะของแผงบอกสาเหตุแทนการเดา: `device-locked` (ปลดล็อกโทรศัพท์ มันฟื้นเอง), `cert-untrusted` (เชื่อถือใบรับรอง WebDriverAgent บนอุปกรณ์), `profile-expired` (การลงนามทีมฟรีอยู่ได้ 7 วัน — รัน `ios_real_start_wda` ซ้ำเพื่อบิลด์ใหม่), `tunnel-failed` (ตรวจลิงก์ USB/usbmuxd), `device-unplugged` (ใช้สาย USB ที่รับส่งข้อมูลได้ — การจับคู่ผ่าน Wi-Fi เท่านั้นส่งต่อพอร์ตไม่ได้) - **สตรีมหยุดเอง** — นั่นคือนโยบายเมื่อว่าง ไม่ใช่การล่ม: เมื่อไม่มีผู้บริโภค (แผงปิด ไม่มีการ์ดติดตั้ง ไม่มีเส้นทางทำงาน) สตรีมหยุดหลัง 5 นาทีและเริ่มใหม่ในการเรียกเครื่องมือครั้งถัดไปหรือเมื่อเปิดแผง สตรีมที่ล่มเริ่มใหม่ในเบื้องหลังภายใน ~5 วินาที ## การพัฒนา ```sh pnpm install pnpm run build # tsc ฝั่งโฮสต์ + บันเดิลไคลเอนต์ → lib/ pnpm run typecheck ``` การทดสอบสโมกใน `scripts/` ตรวจสอบ `lib/` ที่บิลด์แล้ว (เฉพาะ macOS สำหรับส่วนที่บูตซิมูเลเตอร์หรือคุยกับโทรศัพท์ USB ตั้ง `DSH_IOS_SMOKE_SKIP_SIM=1` เพื่อข้ามส่วนเหล่านั้น): | สคริปต์ | สิ่งที่ครอบคลุม | | --- | --- | | `node scripts/dev-smoke.mjs` | โฮสต์ซิม: แก้ไขไบนารี เปิดสตรีม ควบคุม keep-alive dispose | | `node scripts/dev-tools-smoke.mjs [--full-build]` | เครื่องมือหลักกับซิมูเลเตอร์จริง (พร้อมบิลด์จริงด้วย `--full-build`) | | `node scripts/dev-routes-smoke.mjs` | เส้นทางเว็บที่ลงนาม: grant พร็อกซีสตรีม สกรีนช็อต รีเลย์ ws รั้ว การหมดอายุ | | `node scripts/dev-card-smoke.mjs` | การ์ดไคลเอนต์: SSR คงที่ (ไม่มี ``) สัญญา status/capture ส่วนเน็ตเกือบสด | | `node scripts/dev-panel-smoke.mjs` | คอมโพเนนต์แผง โหมดขนาด สไตล์เฟรม ลอจิกด็อก/ตัวกระตุ้น/แคปซูล (คงที่เท่านั้น) | | `node scripts/dev-logs-smoke.mjs` | snapshot/follow ของ `ios_sim_logs` ตัวกรอง ขีดจำกัด การเก็บเกี่ยวโพรเซส | | `node scripts/dev-uitree-smoke.mjs` | เครื่องมือ UI ทรี: ไปป์ไลน์แก้ไข/ดาวน์โหลด AXe ตัวเลือก ทรีและแตะบนซิมูเลเตอร์จริง | | `node scripts/dev-debug-smoke.mjs` | เครื่องมือดีบัก: โพรเซส แบ็กเทรซ (lldb + sample) หน่วยความจำรั่ว ข้อมูลแอป | | `node scripts/dev-preview-smoke.mjs` | โหลดซ้ำทันทีของพรีวิว: เริ่ม แก้ไข → สลับร้อนโดยไม่เปิดใหม่ กู้คืนข้อผิดพลาด หยุด | | `node scripts/dev-orphan-smoke.mjs` | การรับเลี้ยง/เรียกคืน serve-sim กำพร้าหลังโฮสต์ถูกฆ่าอย่างไม่สุภาพ | | `node scripts/dev-ocr-smoke.mjs` | เครื่องมือ Vision-OCR: แก้ไขตัวช่วย แคชคอมไพล์ swiftc ไปป์ไลน์จดจำ เส้นทาง tap-text | | `node scripts/dev-wda-smoke.mjs` | โฮสต์ WebDriverAgent: แยกวิเคราะห์ `ServerURLHere` จำแนกความล้มเหลว ทันเนล keep-alive (ม็อก มีรอบสดให้เลือก) | | `node scripts/dev-realdevice-smoke.mjs` | `xcrun devicectl` กับ iPhone ที่เชื่อมต่อ USB — เส้นทางโค้ดที่เครื่องมือใช้จริงทุกประการ | | `node scripts/dev-realstart-smoke.mjs` | เส้นทาง `/real-start`: รั้ว การปฏิเสธแบบรหัส ประตูบิลด์/เปิด (คงที่) | | `node scripts/dev-realtools-smoke.mjs` | แบ็กเอนด์อุปกรณ์จริงของ `ios_sim_screenshot` / `ios_sim_interact` / `ios_sim_ui_tree` / `ios_sim_tap_element` พร้อม `ios_real_start_wda` | ## ระบบนิเวศ - [DSH Android](https://github.com/ZSeven-W/dsh-android) — อีมูเลเตอร์ Android หรืออุปกรณ์ผ่าน USB แบบสดภายในบทสนทนา ขับเคลื่อนทั้งหมดผ่าน adb - [DSH Crew](https://github.com/ZSeven-W/dsh-crew) — มอบหมายงานให้เอเจนต์ DSH จาก Claude Code / Codex - [DSH Noema](https://github.com/ZSeven-W/dsh-noema) — หน่วยความจำระยะยาวสำหรับ DSH - [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) — ตรวจดูและแก้ไขเอกสารออกแบบ `.op` ในบทสนทนา ## เครดิต & ใบอนุญาต - [serve-sim](https://github.com/EvanBacon/serve-sim) — Evan Bacon — เอนจินสตรีมซิมูเลเตอร์ (Apache-2.0 dependency รันไทม์ที่แถมมา) - [AXe](https://github.com/cameroncooke/AXe) — Cameron Cooke — CLI การช่วยการเข้าถึงเบื้องหลังเครื่องมือ UI ทรี (MIT) - [WebDriverAgent](https://github.com/appium/WebDriverAgent) — เซิร์ฟเวอร์ WebDriver ที่ปลั๊กอินบิลด์และเปิดบนอุปกรณ์จริง (ใบอนุญาต BSD) - สถาปัตยกรรมได้แรงบันดาลใจจากปลั๊กอิน “Build iOS Apps” ของ Codex เอนจินพรีวิว SwiftUI เป็นการสร้างใหม่แบบคลีนรูมของแนวทางที่เผยแพร่ต่อสาธารณะ — ไม่มีการคัดลอกโค้ด Codex - ดูประกาศฉบับเต็มที่ [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md) **ใบอนุญาต**: MIT