DSH Android

Bir DeepSeek Harness sohbetinin içinde canlı bir Android cihazı — emülatör ya da USB telefon, tamamen adb üzerinden sürülür.
_{20 ajan aracı • süreç içi canlı akış, harici yardımcı yok • üç düğmeli gezinme paneli • Gradle derleme & çalıştırma • Vision OCR}

_{npm: @zseven-w/dsh-android · Güncel eklenti sürümü: 0.1.0-rc.4 · DSH 0.1.1-rc.1 ile test edildi}

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

_{Bir DSH sohbetinin içinden akıtılan ve yönetilen bir Android cihazı — ortada ajanın araç çağrısı, sağda canlı cihaz paneli}

Neden DSH Android

DSH Android ajana sohbetin içinde gerçek bir Android cihazı verir — ve size pikselleri. Ajan bir emülatörde veya USB ile bağlı bir telefonda akış başlatabilir, bir Gradle projesini derleyip kurabilir, arayüzü resource-id/metin ile ya da OCR ile yönetebilir, logcat okuyabilir, süreçleri ve belleği inceleyebilir; bu sırada cihazın canlı akışı kalıcı bir kenar çubuğu panelinde görüntülenir ve videonun üzerinde doğrudan dokunabilir, sürükleyebilir, döndürebilir ve Back / Home / Recents tuşlarına basabilirsiniz. Görüntü bloğu yok, ekran kaydı dosyası yok: görsel baytlar arayüze yalnızca DSH web sunucusunun sunduğu imzalı, süresi dolan URL'ler üzerinden ulaşır.

Tek bir kod yolu vardır. adb devices -l bir seri numarası bildirir ve bir cihazın yegâne kimliği o seri numarasıdır — emulator-5554, bir USB seri numarası veya bir ip:port hedefi tamamen aynı şekilde davranır. Eklenti hiçbir emülatör ürününe (AVD, Genymotion, WSA, bulut cihaz çiftliği) bağlı değildir ve akıl yürütmeniz gereken bir simülatör/gerçek cihaz ayrımı yoktur.

📱 Sohbetin içinde canlı cihaz	Süreç içinde üretilen ve en son kare arabelleğinden doğrudan imzalı /_dsh/dsh-android/* rotaları üzerinden sunulan bir multipart/x-mixed-replace PNG akışı.
🔌 Harici akış yardımcısı yok, iç bağlantı noktası yok	Kalıcı tek bir adb exec-out alt süreci while :; do screencap -p; done çalıştırır; ana makine art arda gelen PNG'leri karelere kendisi ayırır. Vekillenecek bir loopback akış sunucusu, yönetilecek bir bağlantı noktası aralığı ve zarif olmayan bir çıkıştan sonra evlat edinilecek hiçbir şey yoktur.
🧩 Tek bir adb kod yolu	Emülatörler ve telefonlar hem adb için hem de bu eklenti için aynı şeydir. simctl/WebDriverAgent ikili yığını yok, fiziksel bir cihaz çalışmadan önce derleme ve güven dansı yok.
🛠️ 20 ajan aracı	Cihazlar, başlatma/kapatma, ekran görüntüsü, etkileşim, Gradle derleme & çalıştırma, uygulama listeleme/başlatma, uiautomator UI ağacı + öğeye dokunma, liste/akış satırı eylemleri, Vision OCR bul/dokun/bekle, logcat, süreçler, ANR/çökme backtrace'i, meminfo, uygulama bilgisi.
👆 Üç düğmeli gezinme paneli	Canlı videoda dokunun ve sürükleyin; ◁ Back · ○ Home · □ Recents ile birlikte döndürme, ekran görüntüsü ve yenileme içeren bir araç çubuğu; bildirim gölgesi, hızlı ayarlar, kilitleme, uyandırma ve asistan için bir cihaz menüsü.
🖼️ Yerel multimodal	Görsel işleyebilen bir modelde her yakalama aracı (screenshot, interact, tap_element, tap_text, tap_row) ekran görüntüsünün KENDİSİNİ bir image block olarak döndürür — model ekranı doğrudan görür. OCR, piksel hassasiyetli metin dokunuşları ve yalnızca metin işleyen rotalar için kalır; yalnızca metin modelleri sade JSON özetini almayı sürdürür.
🔐 Yalnızca loopback imzalı rotalar	Her rota, herhangi bir yetenek denetlenmeden önce loopback bir eş, loopback bir Host (DNS yeniden bağlama reddedilir) ve Fetch-Metadata/Origin denetimleri ister. HMAC-SHA256 yeteneklerinin süresi 10 dakika içinde dolar.
🔍 Anlamsal + görsel otomasyon	android_ui_tree uiautomator hiyerarşisini döker, android_tap_element ise resource-id, metin veya içerik açıklamasına göre dokunur; ağaç boşken veya metin bir görselin içine gömülüyken android_find_text / android_tap_text koordinat tahmin etmek yerine ekranı OCR'lar.

Araçlar

20 aracın tamamı her ana makinede kayıtlıdır ve düz JSON döndürür — görsel baytlar arayüze yalnızca presentationMeta + imzalı rotalar üzerinden ulaşır, asla görüntü bloğu olarak dönmez. adb çözümlenemediğinde araçlar kayıtlı kalır ve her çağrı, çözümü adıyla söyleyen açıklayıcı bir hatayla başarısız olur.

Koordinatlar her yerde akıtılan karenin 0..1 aralığında normalleştirilmiş değerleridir. Kare, ekran dönüşünü izler (yatay bir uygulama, 1080×2400 bir cihazda 2400×1080 olarak akar) ve input tap da aynı uzayı paylaşır; bu yüzden bu eklentinin hiçbir yerinde istemci tarafı döndürme hesabı yoktur.

Temel araçlar

Araç	Ne yapar	Temel parametreler
android_devices	adb devices -l komutunun bildirdiği her cihazı listeler (seri numarası, durum, emülatör/fiziksel, model, Android sürümü, API seviyesi, AVD adı) ve ayrıca makinedeki AVD adlarını avds altında verir. Diğer araçların aldığı seri numarasını keşfetmek için bunu kullanın. Başarısız bir sayım boş liste döndürmek yerine hata fırlatır.	—
android_boot	Canlı akışı başlatır. Doğrudan akıtmak için ONLINE bir seri numarası verin ya da önce o emülatörü başlatıp açılışı bitince akıtmak için bir AVD adı verin (soğuk başlangıçta dakikalar sürer). Akış sohbet boyunca canlı kalır, böylece panel cihazı canlı gösterebilir.	device (zorunlu — bir seri numarası veya AVD adı)
android_shutdown	Bir emülatörü kapatır (adb emu kill) ve akış o cihazı hedefliyorsa akışı durdurur. Fiziksel bir cihaz gerekçesiyle birlikte reddedilir: adb bir telefonun gücünü kesemez.	device
android_screenshot	Bir PNG yakalar ve kısa bir JSON özeti döndürür (yol, bayt, boyutlar, cihaz); görüntü kartta ve panelde işlenir, asla görüntü bloğu olarak dönmez.	device (isteğe bağlı — akıştaki cihaz, yoksa çevrimiçi olan tek cihaz)
android_interact	Akıştaki cihazla etkileşir: 0..1 normalleştirilmiş koordinatlarda dokunma, metin yazma, bir gezinme veya donanım düğmesine basma (back, home, recents, power, volume_up, volume_down, menu, enter, delete), kaydırma hareketi gönderme veya kaydırma. Eylem yerleştikten sonra (~300 ms) taze bir ekran görüntüsü etkiyi gösterir.	action (zorunlu — tap/type/button/gesture/scroll), x/y, text, name, json, device
android_list_apps	Cihazda kurulu paketleri listeler (pm list packages); dumpsys package çıktısından sürüm adını ve çözümlenebiliyorsa okunabilir bir etiketi getirir — üçüncü taraf bir paket adı tahmin edilemez, bu yüzden önce listeleyin veya android_launch_app'e name verin.	device, query (büyük/küçük harfe duyarsız alt dize, CJK dahil), include_system (varsayılan false)
android_launch_app	Kurulu bir uygulamayı packageName ile ya da name ile (aynı listeleme üzerinden çözümlenen, büyük/küçük harfe duyarsız etiket alt dizesi) başlatır. İkisinden tam olarak biri. relaunch uygulamayı önce zorla durdurur.	packageName veya name (tam olarak biri), device, relaunch
android_build_run	Bir Gradle projesini derler (./gradlew assembleDebug), üretilen debug APK'sını kurar (adb install -r) ve başlatır. Tam derleme dakikalar sürer; başarısızlıkta sonuç, Gradle hata çıktısının kuyruğunu taşır.	projectPath (zorunlu), device

UI ağacı ve satır araçları (uiautomator)

Araç	Ne yapar	Temel parametreler
android_ui_tree	En öndeki uygulamanın uiautomator hiyerarşisini düğümler halinde döker — type (sınıf adının son parçası), text, contentDesc, resourceId, piksel cinsinden bounds, enabled, focused — ~40 KB ile sınırlı (en derin seviyeler budanır ve truncated ayarlanır).	device, max_depth, filter (metin/içerik açıklaması/kaynak kimliği üzerinde büyük/küçük harfe duyarsız alt dize)
android_tap_element	Bir öğeye kimliğine göre dokunur — resource_id düğümün resource-id değeriyle, text ise metniyle veya içerik açıklamasıyla eşleşir. Önce tam eşleşme, sonra büyük/küçük harfe duyarsız alt dize; iç içe yinelemeler tek hedefe indirgenir ve belirsiz bir eşleşme birini seçmek yerine en fazla 8 adayı listeler. Devre dışı öğeler reddedilir. Dokunuş öğenin merkezine iner, ardından ~300 ms sonra bir ekran görüntüsü etkiyi gösterir; expect_text / expect_gone verirseniz dokunuş ve doğrulaması tek gidiş-dönüş olur.	device, resource_id, text, expect_text, expect_gone
android_ui_rows	Bir liste/akış ekranını (RecyclerView ve benzerleri) ham ağaç yerine SATIRLAR olarak okur: aynı şekle sahip yinelenen alt öğeler; bir dizin, piksel çerçevesi, toplanmış etiket ve o etiketten ayrıştırılan sayaçlar (sayı + sınıflandırıcı belirteç, Çince veya İngilizce — hiçbir uygulama sözlüğü kodlanmamıştır) taşıyan satırlara dönüşür. Sayaç anahtarları gidiş-dönüş yapar: android_tap_row.expect_count'a anahtarı tam listede göründüğü gibi verin.	device, max_depth
android_tap_row	Görünür bir satırın içinde göreli konumda dokunur (index android_ui_rows'tan gelir; x/y o satırın çerçevesinin kesirleridir, varsayılan 0.5 = merkez). Çerçeve TAZE bir ağaç okumasından gelir, bu yüzden mutlak koordinat tahmin edilmez ve aralık dışı bir dizin kırpılmak yerine BAŞARISIZ olur. expect_count={key, delta} ile araç ~800 ms sonra satırı yeniden okur ve sayacın tam olarak ±1 değiştiğini doğrular; bilinmeyen bir anahtar dokunuşu gerçekleşmeden REDDEDER.	device, index (zorunlu), x, y, expect_count ({key, delta})

OCR, günlük ve hata ayıklama araçları

Araç	Ne yapar	Temel parametreler
android_find_text	GEÇERLİ ekranı, eklentinin derlediği Vision yardımcısıyla OCR'lar (isabetli tanıma, zh-Hans + en-US). UI ağacı boş veya bozulmuşken, grafik olarak çizilen metinler için (rozet sayıları, görsellere gömülü fiyatlar) ya da ekrandakini bağımsızca doğrulamak için kullanın. {device, size, items:[{text, confidence, rect}]} döndürür; rect'ler sol üst başlangıçlı piksel kutularıdır, güvene göre sıralıdır ve çıktı ~40 KB ile sınırlıdır. Yalnızca macOS ana makine.	device, query (büyük/küçük harfe duyarsız alt dize), min_confidence (varsayılan 0.3)
android_tap_text	GEÇERLİ ekranı OCR'lar ve en iyi metin eşleşmesinin merkezine dokunur — UI ağacının göremediği metinler için, android_tap_element ile aynı tam → içerme → aday listesi kuralları. Eşleşen piksel merkezi kare boyutuna göre normalleştirilir ve dokunuş olarak gönderilir; ~300 ms sonra taze bir ekran görüntüsü etkiyi gösterir. Yalnızca macOS ana makine.	device, query (zorunlu), min_confidence, expect_text, expect_gone
android_wait_for	Bir metnin belirmesini veya kaybolmasını bekler; koşul sağlanana ya da süre dolana kadar (varsayılan 8 sn, en çok 60 sn) aynı yakalama + OCR hattını her 600 ms'de bir yoklar. Zaman aşımı normal bir matched:false yanıtıdır, asla hata değildir. Yalnızca macOS ana makine.	device, text (zorunlu), mode (appear/disappear), timeout_ms, min_confidence
android_logs	Cihazın günlüğe yazdıklarını okur: snapshot (yakın bir pencere üzerinde logcat -d -v time, varsayılan 2m) veya follow (duration_seconds kadar sınırlı canlı yakalama, varsayılan 10, en çok 60 — asla asılı kalan bir akış değil). bundle_id (pid'ine çözümlenen Android paket adı) ile tek bir uygulamaya süzün. Çıktı ~300 satır / 30 KB ile sınırlıdır ve daraltma ipucu içerir.	device, mode (snapshot/follow), duration, duration_seconds, bundle_id, grep
android_processes	Cihazda çalışan süreçleri (ps -A) {pid, name} olarak listeler — android_backtrace için pid kaynağıdır.	device, filter (süreç adı üzerinde büyük/küçük harfe duyarsız alt dize)
android_backtrace	Sürecin yığınlarını dökmesini ister (kill -3) ve oluşan ANR izini /data/anr/ altından okur. Root'lanmamış cihazların çoğu bu dizini reddeder, bu yüzden araç çökme arabelleğine (logcat -b crash -d) düşer ve hangi motorun yanıt verdiğini ve neyi göremediğini dürüstçe bildirir.	device, pid veya bundle_id
android_meminfo	dumpsys meminfo <package> çıktısını ayrıştırır: toplam PSS, Java/native/grafik dağılımı ve en büyük kategoriler — sızıntı özetinin Android'deki karşılığı.	device, bundle_id (zorunlu)
android_app_info	dumpsys package <package> üzerinden kurulu uygulama bilgileri: sürüm adı ve kodu, veri dizini, kod yolu, ilk kurulum zamanı ve sistem bayrağı. Eksik bir uygulama hata fırlatmaz; installed: false ve android_list_apps'i işaret eden bir not döner.	device, bundle_id (zorunlu)

Görüntüleme yüzeyleri

• Kenar çubuğu paneli. Canlı görünüm kalıcı bir sağ panelde yaşar (sohbeti kenara iten sabit bir dock veya dar görünüm alanlarında ortalanmış bir kaplama). Canlı PNG akışını işler ve video üzerinde doğrudan tıkla-dokun ile sürükle-hareket kabul eder; araç çubuğunda ◁ Back, ○ Home, □ Recents, döndürme, ekran görüntüsü ve yenileme bulunur. Bir cihaz menüsü beş cihaz düzeyi eylemi çalıştırır (bildirim gölgesi, hızlı ayarlar, kilitleme, uyandırma, asistan). Cihaz seçici her adb cihazını TEK bir listede, türüne göre gruplanmış olarak gösterir; çevrimdışı AVD'ler tıklayınca başlatma yerine android_boot'a yönlendiren bir ipucu olarak görünür. Boyut modları ve çerçeve stilleri (çerçevesiz / kenarlık / telefon gövdesi) iOS ikizindeki gibi çalışır; panel en boy oranını karenin kendi doğal boyutundan uyarlar, bu yüzden bir döndürme hiçbir yapılandırma gerektirmez.
• Kompakt sohbet kartları. Araç sonuçları satır içi görsel olmadan tek satırlık kartlar olarak işlenir: cihaz adı, bir eylem alt etiketi, bir durum rozeti ve bir “kenar çubuğunda aç” ipucu. Satıra tıklamak paneli açar.
• Girişin üstünde durum kapsülü. Panel kapalıyken ve bir akış çevrimiçiyken, besteleyicinin üstünde küçük bir hap belirir ve tıklanınca paneli açar.
• Standart mod ve Code Modu. Standart oturumlar ana makinenin yansıttığı presentationMeta'yı kullanır; iç içe Code Modu gönderimleri meta taşımaz, bu yüzden istemci aynı meta'yı kalıcı sonuç JSON'undan yeniden kurar — panel, kartlar ve kapsül her iki modda da çalışır.

Güvenlik

• Tarayıcı asla adb ile konuşmaz ve konuşulacak bir iç bağlantı noktası da yoktur. Akış bu süreçte üretilir ve bellekten sunulur; her bayt, DSH web sunucusu kaynağından eklentiye ait /_dsh/dsh-android/* rotaları üzerinden geçer: /stream/<token> (canlı multipart PNG), /screenshot/<token> (önbellekli PNG), ayrıca /grant, /switch-device, /devices, /capture, /status, /control ve /device-action. Bu, vekillenen bir loopback akış sunucusundan kesinlikle daha küçük bir saldırı yüzeyidir.
• Herhangi bir yetenek okunmadan önce uygulanan üçlü loopback çiti. Taşıma eşi bir loopback adresi olmalı, Host başlığı loopback bir otorite adlandırmalı (böylece DNS yeniden bağlama yapan bir Host reddedilir) ve Fetch-Metadata/Origin aynı kaynaktan olmalıdır. Host ve Origin çağıran tarafından denetlenen verilerdir ve asla tek başlarına güvenilmez.
• Süresi 10 dakika içinde dolan HMAC-SHA256 yetenekleri; base64url(payload).base64url(mac) biçimindedir ve her DSH evine özel 32 baytlık bir anahtarla imzalanır (<DSH_HOME>/cache/dsh-android/stream-access.key, mod 0600, atomik oluşturulur). Bir cihaz için üretilen yetenek, başka bir cihaz akış yuvasını aldığı anda çalışmayı bırakır ve bir ekran görüntüsü yeteneği akış rotasına karşı yeniden oynatılamaz.
• Ekran görüntüsü rotası tam olarak tek bir dizini sunar. Yollar lstat ile yürünür (her sembolik bağlantı reddedilir), bir realpath kapsam denetimiyle tamamlanır, O_NOFOLLOW ile açılır, boyutla sınırlanır ve okumadan sonra yeniden doğrulanır — böylece üretimle getirme arasında sembolik bağlantıyla değiştirilen bir dosya asla sunulmaz.
• /grant hiçbir şeyi başlatmaz. Yalnızca zaten çevrimiçi olan bir cihaz için kare döngüsünü başlatır ve akışı başka bir cihazın elinden çekip almayı reddeder (409 device_busy). Cihaz değiştirmek açık /switch-device hareketini gerektirir; bir AVD'yi başlatmak android_boot aracının işidir.
• Keep-alive ve boşta durdurma. Çöken bir kare döngüsü arka planda yeniden başlar (~5 sn gecikme); sıfır tüketiciyle akış 5 dakika sonra kendini durdurur. Kasıtlı durdurmalar asla engellenmez.

Gereksinimler

• Node ≥ 24.11.0.
• adb, Android SDK platform-tools'tan gelir ve şu sırayla çözümlenir: ADB ortam değişkeni → PATH üzerindeki adb → <ANDROID_HOME>/<ANDROID_SDK_ROOT>/işletim sistemine göre varsayılan SDK kökü + /platform-tools/adb. sdkmanager "platform-tools" ile, Android Studio ile veya brew install --cask android-platform-tools ile kurun. adb olmadan da eklenti yüklenir ve 20 aracın tamamı kaydolur; o zaman her çağrı neyin eksik olduğunu açıklar.
• Bir cihaz: herhangi bir ürünün emülatörü ya da USB hata ayıklaması açık bir telefon. emulator başlatıcısı isteğe bağlıdır ve yalnızca android_boot'un AVD adıyla çalışan biçimi ona ihtiyaç duyar — geri kalan her şey adb'nin görebildiği her şeyle çalışır.
• Panel için web paketiyle birlikte DSH ≥ 0.1.0-rc.6. Başsız (headless) profiller de çalışır: 20 aracın tümü normal çalışır, yalnızca canlı görünüm olmaz.
• OCR için macOS ana makine (yalnızca android_find_text / android_tap_text / android_wait_for gerektirir): eklenti, paketli assets/ocr.swift dosyasını ilk kullanımda swiftc ile ~/Library/Caches/dsh-android/bin/ocr içine derler. Linux ve Windows ana makinelerinde bu üç araç OCR'ın macOS Vision çerçevesini gerektirdiğini bildirir; diğer 17 araç etkilenmez. Geçersiz kılmalar: DSH_ANDROID_OCR_DIR, DSH_ANDROID_OCR_SWIFT, DSH_ANDROID_SWIFTC.
• ADBKeyboard (isteğe bağlı, CJK ve emoji girişi için): adb shell input text yalnızca ASCII destekler. Cihaza ADBKeyboard kurup etkin IME olarak seçin; ASCII dışı metin onun yayın (broadcast) arayüzü üzerinden iletilir. Onsuz ASCII dışı yazma, kurulum ipucuyla birlikte REDDEDİLİR — asla sessizce yanlış yazılmaz.

Fiziksel cihazlar

Derlenecek, imzalanacak, güvenilecek veya yedi günde bir yeniden imzalanacak bir WebDriverAgent muadili yoktur. USB hata ayıklamasını açın, telefonu takın, cihazdaki yetkilendirme istemini kabul edin; cihaz android_devices içinde görünür ve her araç onun üzerinde çalışır. Yetkilendirilmemiş bir cihaz gizemli bir hata olarak değil, istem ipucuyla birlikte olduğu gibi bildirilir.

Üç dürüst uyarı:

• USB üzerinden kare hızı daha düşüktür — bir telefonda kabaca 2–5 fps, emülatörde 5–10 fps; çünkü her kare USB bağlantısını tam bir PNG olarak geçer.
• CJK yazımı ADBKeyboard gerektirir (yukarıya bakın); bu, emülatörleri ve telefonları aynı şekilde etkiler.
• android_shutdown bir telefonun gücünü kesemez. adb'de böyle bir fiil yoktur; araç numara yapmak yerine bunu söyler.

Performans

Bir emülatörde ölçüldü (Android 14, 1080×2400):

Kalıcı screencap döngüsü	≈ 8 fps
ensureStreaming ilk kare	~200 ms
input tap gidiş-dönüşü	~130 ms

Bunu mümkün kılan şey tek kalıcı alt süreçtir: kare başına bir adb başlatmak, tek bir piksel kıpırdamadan önce ~50–100 ms'e mal olur. Makineye ve ekran yoğunluğuna bağlı olarak emülatörde ~5–10 fps, USB telefonda ~2–5 fps bekleyin.

DSH'ye Kurulum

dsh plugin --profile web add @zseven-w/dsh-android@latest
dsh web

Ya da mevcut bir profil paketinin bağımlılığı olarak ekleyin:

pnpm add @zseven-w/dsh-android

Hızlı başlangıç

1. Cihazları keşfedin — “Android cihazlarını listele.” → android_devices.
2. Akışı başlatın — “emulator-5554'ü akıt.” → android_boot. Panel, cihaz canlıyken açılır. (Bir AVD adı verildiğinde önce o emülatör başlatılır.)
3. Videoda dokunun — panelde doğrudan dokunun veya sürükleyin; ya da ajanın yönetmesine izin verin: “Ayarlar'ı aç, sonra Display'e dokun.” → android_interact, ya da kimlik tabanlı dokunuşlar için android_ui_tree + android_tap_element, ya da ağaç kör olduğunda android_find_text + android_tap_text.
4. Uygulamanızı derleyip çalıştırın — “/path/to/MyApp'i derleyip çalıştır.” → android_build_run. Tam bir Gradle derlemesi dakikalar sürer; tamamlandığında uygulama başlar ve onu panelde canlı izlersiniz.
5. Günlükleri okuyun — “com.example.app için logcat'in son iki dakikasını göster.” → android_logs.

Sorun giderme

• Her araç adb'nin kullanılamadığını söylüyor — hata, üç çözümleme katmanını adıyla verir. ADB=/path/to/adb ayarlayın, adb'yi PATH üzerine koyun ya da SDK platform-tools'u kurun (sdkmanager "platform-tools").
• Cihaz unauthorized durumunda — cihaz ekranındaki USB hata ayıklama istemini kabul edin. android_devices cihazı gizlemek yerine durumu dürüstçe bildirir.
• android_boot bir AVD bulamıyor — emulator başlatıcısı keşfedilemedi. Emülatörü herhangi bir yolla başlatın; adb onu görür görmez android_devices içinde belirir ve android_boot da seri numarasını alır.
• ASCII dışı metin reddediliyor — ADBKeyboard'ı kurup giriş yöntemi olarak seçin (bkz. Gereksinimler). Bu reddediş bilinçlidir: input text karakterleri sessizce düşürür ya da bozardı.
• android_find_text OCR'ın kullanılamadığını söylüyor — OCR bir macOS ana makine gerektirir (Apple'ın Vision çerçevesi). OCR dışındaki 17 araç her yerde çalışır.
• Akış kendiliğinden duruyor — bu boşta politikasıdır, çökme değil: sıfır tüketiciyle (panel kapalı, bağlı kart yok, etkin rota yok) akış 5 dakika sonra durur ve bir sonraki araç çağrısında veya panel açılışında yeniden başlar. Çöken bir döngü ~5 saniye içinde kendiliğinden yeniden başlar.
• Başlatıcıda döndürme yanlış görünüyor — başlatıcılar ve Ayarlar kendilerini dikey moda sabitler ve user_rotation'ı yok sayar. Bu, eklenti hatası değil, normal Android davranışıdır; buna izin veren bir uygulamanın içinde döndürün.

Geliştirme

pnpm install
pnpm run build      # host tsc + client bundle → lib/
pnpm run typecheck
pnpm test           # every static suite; no device required

scripts/ altındaki duman testleri derlenmiş lib/ çıktısını sınar. dev-emulator-smoke.mjs dışındakilerin tamamı statiktir; o ise bir cihaz gerektirir ve cihaz yokken SKIP (çıkış kodu 0) bildirir.

Betik	Neyi kapsar
node scripts/dev-adb-smoke.mjs	adb çözümlemesi (env / PATH / SDK) bir shim ikilisine karşı, devices -l ayrıştırma, ikili güvenli exec-out, PNG kare ayırıcısı ve yeniden senkronizasyonu, input-text kaçışlama ve sahte bir araç zincirine karşı ana makine yaşam döngüsü (akış, kontrol, boşta durdurma, dispose).
node scripts/dev-routes-static-smoke.mjs	İmzalı rotalar sahte bir ana makineye karşı: göreli grant'ler, süresi dolmuş/sahte/çapraz türde belirteçler, loopback çiti, 405/415/400 zarfları, kodlu cihaz reddetmeleri, /control doğrulaması, döndürme şekli, ekran görüntüsü kapsamı ve canlı multipart akışı.
node scripts/dev-tools-smoke.mjs	Temel araçlar, createAndroidTools dikişi üzerinden sahte bir ana makineye karşı.
node scripts/dev-uitree-smoke.mjs	UI ağacı ve satır araçları: uiautomator XML ayrıştırma, seçiciler, derinlik sınırlama, satır ve sayaç sezgileri.
node scripts/dev-logs-smoke.mjs	android_logs snapshot/follow, filtreler, sınırlar ve süreç toplama.
node scripts/dev-panel-smoke.mjs	Panel bileşenleri, boyut modları, çerçeve stilleri, dock/tetikleyici/kapsül mantığı (yalnızca SSR).
node scripts/dev-emulator-smoke.mjs [serial]	Canlı cihaz: ilk kare, sürdürülen kare hızı, dokunuş gidiş-dönüşü, dispose.

Sorun giderme

Emülatörde boş / beyaz akış

Panel düz beyaz (veya siyah) bir görüntü akıtırken android_ui_tree hâlâ gerçek arayüz öğelerini görüyorsa, emülatörün ana makine GPU'sundaki kare arabelleği geri okuması sizin makinenizde bozuktur (bazı macOS ana makinelerinde bilinen bir gfxstream sorunu — screencap kendisi boş kareler döndürür, bu yüzden tüm ekran araçları etkilenir). Emülatörü yazılımsal işlemeyle yeniden başlatın:

emulator -avd <name> -gpu swiftshader_indirect

ya da AVD'nin config.ini dosyasında hw.gpu.mode=swiftshader_indirect ayarlayın. Fiziksel cihazlar asla etkilenmez.

Yol haritası

• Daha yüksek kare hızlı bir kaynak. StreamSource dikişi bilinçli olarak takılabilir bırakıldı: bir scrcpy-server + WebCodecs H.264 yolu, rotalara, araçlara veya panele dokunmadan kare başına PNG akışının yerini alabilir.
• Compose önizleme sıcak yeniden yükleme. iOS ikizi SwiftUI önizlemelerini dylib olarak sıcak değişimle uygular; Compose'un bugün eşdeğer bir sıcak değişim ilkeli yok, bu yüzden bu, gönderilmiş-ama-titrek bir özellik olmak yerine gelecek bir madde olarak kalıyor.

Ekosistem

• DSH iOS Simulator — iOS Simülatörü ve USB ile bağlı iPhone'lar için aynı mimari
• DSH Crew — Claude Code / Codex üzerinden DSH ajanlarına iş dağıtın
• DSH Noema — DSH için uzun süreli bellek
• DSH OpenPencil — .op tasarım belgelerini sohbet içinde inceleyin ve düzenleyin

Teşekkürler & lisans

• Android SDK platform-tools (adb) — çalışma zamanında çözümlenir, asla yeniden dağıtılmaz: Google'ın SDK lisansı paketlemeye izin vermiyor.
• ADBKeyboard — Senzhk — ASCII dışı yazmanın arkasındaki isteğe bağlı cihaz üstü IME (Apache-2.0; paketlenmez).
• Mimari ve rota duruşu, bu eklentinin kendisinden taşındığı dsh-ios ile paylaşılır.
• Bildirimlerin tamamı için THIRD_PARTY_NOTICES.md dosyasına bakın.

Lisans: MIT