ZSeven-W/dsh-android
ZSeven-W/dsh-android has 361 GitHub stars and 37 forks. GitHot measured +3 stars in 24 hours. Last checked 2026-11-19 02:25 UTC. Last push 2026-11-10.
Crecimiento de estrellas medido
- in 24h
- +3
- in 7 days
- Recopilando historial
- in 15 days
- Recopilando historial
- in 1 month
- Recopilando historial
Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.
Acerca de
DeepSeek Harness plugin for Android — build, run, and interact with a live emulator or USB device stream inside a conversation, driven entirely through adb.
Herramientas de desarrolloREADME.es.md
Original
DSH Android
Un dispositivo Android en vivo dentro de una conversación de DeepSeek Harness: emulador o teléfono USB, gobernado por completo a través de adb.
20 herramientas de agente • transmisión en vivo generada en el proceso, sin ayudante externo • panel de navegación de tres botones • compilación & ejecución con Gradle • OCR de Vision
npm: @zseven-w/dsh-android · Versión actual del plugin: 0.1.0-rc.4 · Probado con DSH 0.1.1-rc.1
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia
Un dispositivo Android transmitido y controlado desde dentro de una conversación de DSH: la llamada a la herramienta del agente en el centro, el panel del dispositivo en vivo a la derecha
Por qué DSH Android
DSH Android le da al agente un dispositivo Android real dentro de la conversación, y a ti te da los píxeles. El agente puede iniciar una transmisión en un emulador o en un teléfono conectado por USB, compilar e instalar un proyecto Gradle, gobernar la interfaz por resource-id/texto o por OCR, leer logcat e inspeccionar procesos y memoria, mientras la transmisión en vivo del dispositivo se renderiza en un panel lateral persistente donde puedes tocar, arrastrar, rotar y pulsar Atrás / Inicio / Recientes directamente sobre el vídeo. Sin bloques de imagen y sin archivos de grabación de pantalla: los bytes visuales llegan a la interfaz únicamente a través de URL firmadas y caducas servidas por el servidor web de DSH.
Hay exactamente una ruta de código. adb devices -l informa de un serial, y ese serial es la única identidad de un dispositivo: emulator-5554, un serial USB o un destino ip:port se comportan igual. El plugin no está atado a ningún producto de emulación (AVD, Genymotion, WSA, una granja de dispositivos en la nube), y no existe ninguna división simulador/dispositivo real sobre la que razonar.
| 📱 Dispositivo en vivo en la conversación | Una transmisión PNG multipart/x-mixed-replace producida en el proceso y servida directamente desde el búfer del último fotograma mediante rutas firmadas /_dsh/dsh-android/*. |
| 🔌 Sin ayudante de transmisión externo, sin puerto interno | Un único proceso hijo adb exec-out persistente ejecuta while :; do screencap -p; done; el host mismo divide los PNG concatenados en fotogramas. No hay servidor de transmisión loopback que proxear, ni rango de puertos que gestionar, ni nada que adoptar tras una salida abrupta. |
| 🧩 Una sola ruta de código adb | Para adb, y para este plugin, emuladores y teléfonos son lo mismo. Sin pila doble simctl/WebDriverAgent, sin el baile de compilar y confiar antes de que un dispositivo físico funcione. |
| 🛠️ 20 herramientas de agente | Dispositivos, arranque/apagado, captura de pantalla, interacción, compilación & ejecución con Gradle, listado/lanzamiento de apps, árbol de UI de uiautomator + toque por elemento, acciones sobre filas de listas/feeds, buscar/tocar/esperar con OCR de Vision, logcat, procesos, backtrace de ANR/fallo, meminfo, información de la app. |
| 👆 Panel de navegación de tres botones | Toca y arrastra sobre el vídeo en vivo; una barra con ◁ Atrás · ○ Inicio · □ Recientes más rotar, capturar y actualizar; un menú de dispositivo para el panel de notificaciones, los ajustes rápidos, bloquear, despertar y el asistente. |
| 🖼️ Multimodal nativo | En un modelo capaz de procesar imágenes, cada herramienta de captura (screenshot, interact, tap_element, tap_text, tap_row) devuelve la propia captura de pantalla como un image block: el modelo ve la pantalla directamente. El OCR se mantiene para los toques de texto con precisión de píxel y para las rutas de solo texto; los modelos de solo texto conservan el resumen JSON simple. |
| 🔐 Rutas firmadas y solo en loopback | Cada ruta exige un par en loopback, un Host en loopback (se rechaza el DNS rebinding) y comprobaciones Fetch-Metadata/Origin, antes de consultar cualquier capacidad. Las capacidades HMAC-SHA256 caducan en 10 minutos. |
| 🔍 Automatización semántica + visual | android_ui_tree vuelca la jerarquía de uiautomator y android_tap_element toca por resource-id, texto o content-description; cuando el árbol está vacío o el texto viene incrustado en una imagen, android_find_text / android_tap_text aplican OCR a la pantalla en vez de adivinar coordenadas. |
Herramientas
Las 20 herramientas se registran en todos los hosts y devuelven JSON plano: los bytes visuales llegan a la interfaz solo mediante presentationMeta + rutas firmadas, nunca como bloques de imagen. Cuando adb no puede resolverse, las herramientas siguen registradas y cada llamada falla con un error explicativo que nombra la solución.
Las coordenadas están siempre normalizadas 0..1 respecto al fotograma transmitido. El fotograma sigue la rotación de la pantalla (una app en horizontal se transmite a 2400×1080 en un dispositivo de 1080×2400) y input tap comparte ese mismo espacio, así que en este plugin no existe ningún cálculo de rotación en el cliente.
Herramientas principales
| Herramienta | Qué hace | Parámetros clave |
|---|---|---|
android_devices |
Lista todos los dispositivos que informa adb devices -l (serial, estado, emulador/físico, modelo, versión de Android, nivel de API, nombre del AVD) más los nombres de AVD de la máquina bajo avds. Úsala para descubrir el serial que toman las demás herramientas. Una enumeración fallida lanza un error en vez de devolver una lista vacía. |
— |
android_boot |
Inicia la transmisión en vivo. Pasa un serial ONLINE para transmitirlo de inmediato, o un nombre de AVD para lanzar primero ese emulador y transmitirlo cuando termine de arrancar (minutos en arranque en frío). La transmisión se mantiene viva durante toda la conversación, de modo que el panel puede mostrar el dispositivo en directo. | device (obligatorio: un serial o un nombre de AVD) |
android_shutdown |
Apaga un emulador (adb emu kill) y detiene la transmisión cuando apunta a ese dispositivo. Un dispositivo físico se rechaza con el motivo: adb no puede apagar un teléfono. |
device |
android_screenshot |
Captura un PNG y devuelve un pequeño resumen JSON (ruta, bytes, dimensiones, dispositivo); la imagen se renderiza en la tarjeta y en el panel, nunca como bloque de imagen. | device (opcional: el dispositivo en transmisión, si no el único en línea) |
android_interact |
Interactúa con el dispositivo en transmisión: toca en coordenadas normalizadas 0..1, escribe texto, pulsa un botón de navegación o de hardware (back, home, recents, power, volume_up, volume_down, menu, enter, delete), envía un gesto de deslizamiento o desplaza. Cuando la acción se asienta (~300 ms), una captura nueva muestra el efecto. |
action (obligatorio: tap/type/button/gesture/scroll), x/y, text, name, json, device |
android_list_apps |
Lista los paquetes instalados en el dispositivo (pm list packages), con el nombre de versión de dumpsys package y una etiqueta legible cuando puede resolverse: el nombre de un paquete de terceros no se adivina, así que lístalo o pásale name a android_launch_app. |
device, query (subcadena sin distinguir mayúsculas, CJK incluido), include_system (false por defecto) |
android_launch_app |
Lanza una app instalada por packageName, o por name (una subcadena de etiqueta sin distinguir mayúsculas, resuelta con el mismo listado). Exactamente uno de los dos. relaunch fuerza antes la detención de la app. |
packageName o name (exactamente uno), device, relaunch |
android_build_run |
Compila un proyecto Gradle (./gradlew assembleDebug), instala el APK de depuración resultante (adb install -r) y lo lanza. Una compilación completa tarda minutos; si falla, el resultado lleva la cola de la salida de error de Gradle. |
projectPath (obligatorio), device |
Herramientas de árbol de UI y de filas (uiautomator)
| Herramienta | Qué hace | Parámetros clave |
|---|---|---|
android_ui_tree |
Vuelca la jerarquía uiautomator de la app en primer plano como nodos: type (la cola del nombre de clase), text, contentDesc, resourceId, bounds en píxeles, enabled, focused, con un tope de ~40 KB (se podan los niveles más profundos y se marca truncated). |
device, max_depth, filter (subcadena sin distinguir mayúsculas sobre text/content-description/resource-id) |
android_tap_element |
Toca un elemento por su identidad: resource_id coincide con el resource-id del nodo; text coincide con su texto o su content-description. Primero coincidencia exacta, luego subcadena sin distinguir mayúsculas; los duplicados anidados se colapsan en un único objetivo y una coincidencia ambigua lista hasta 8 candidatos en vez de elegir uno. Los elementos deshabilitados se rechazan. El toque cae en el centro del elemento y, tras ~300 ms, una captura muestra el efecto; si pasas expect_text / expect_gone, el toque y su verificación se vuelven un solo viaje de ida y vuelta. |
device, resource_id, text, expect_text, expect_gone |
android_ui_rows |
Lee una pantalla de lista/feed (RecyclerView y compañía) como FILAS en vez de como árbol crudo: los hijos repetidos de la misma forma se convierten en filas con un índice, un marco en píxeles, la etiqueta agregada y los contadores extraídos de esa etiqueta (número + clasificador, en chino o inglés; no se codifica en duro ningún vocabulario de app). Las claves de contador van y vuelven: pasa una exactamente como se lista a android_tap_row.expect_count. |
device, max_depth |
android_tap_row |
Toca en una posición relativa dentro de una fila visible (index de android_ui_rows; x/y como fracciones del marco de esa fila, 0,5 = centro por defecto). El marco procede de una lectura FRESCA del árbol, así que no se adivina ninguna coordenada absoluta, y un índice fuera de rango FALLA en vez de recortarse. Con expect_count={key, delta} la herramienta relee la fila tras ~800 ms y verifica que el contador se movió exactamente ±1; una clave desconocida RECHAZA el toque antes de que ocurra. |
device, index (obligatorio), x, y, expect_count ({key, delta}) |
Herramientas de OCR, registros y depuración
| Herramienta | Qué hace | Parámetros clave |
|---|---|---|
android_find_text |
Reconoce la pantalla actual con el motor OCR seleccionado. Devuelve cajas en píxeles desde la esquina superior izquierda, por confianza, hasta 40 KB. | serial, query (subcadena sin distinguir mayúsculas), min_confidence (0.3 por defecto) |
android_tap_text |
Busca coincidencia exacta y luego parcial, o devuelve candidatos ambiguos. Toca directamente el centro en píxeles y captura el resultado. | serial, query (obligatorio), min_confidence, expect_text, expect_gone |
android_wait_for |
Espera a que aparezca o desaparezca el texto: 8 s por defecto, máximo 60 s. El tiempo agotado devuelve matched:false. |
serial, text (obligatorio), mode (appear/disappear), timeout_ms, min_confidence |
android_logs |
Lee lo que registra el dispositivo: snapshot (logcat -d -v time sobre una ventana reciente, 2m por defecto) o follow (una captura en vivo acotada por duration_seconds, 10 por defecto, 60 máximo; nunca una transmisión colgada). Filtra a una sola app con bundle_id (el nombre de paquete Android, resuelto a su pid). La salida se limita a ~300 líneas / 30 KB con una pista para acotar. |
device, mode (snapshot/follow), duration, duration_seconds, bundle_id, grep |
android_processes |
Lista los procesos en ejecución del dispositivo (ps -A) como {pid, name}: la fuente de pid para android_backtrace. |
device, filter (subcadena sin distinguir mayúsculas sobre el nombre del proceso) |
android_backtrace |
Pide al proceso que vuelque sus pilas (kill -3) y lee la traza de ANR resultante en /data/anr/. La mayoría de dispositivos sin root deniegan ese directorio, así que la herramienta degrada al búfer de fallos (logcat -b crash -d) e informa con honestidad de qué motor respondió y de qué no puede ver. |
device, pid o bundle_id |
android_meminfo |
Analiza dumpsys meminfo <package>: PSS total, el desglose Java/nativo/gráficos y las categorías principales: la respuesta de Android a un resumen de fugas. |
device, bundle_id (obligatorio) |
android_app_info |
Datos de una app instalada según dumpsys package <package>: nombre y código de versión, directorio de datos, ruta del código, fecha de primera instalación e indicador de sistema. Una app ausente devuelve installed: false más una nota que nombra android_list_apps; no lanza error. |
device, bundle_id (obligatorio) |
Superficies de visualización
- Panel lateral. La vista en vivo vive en un panel derecho persistente (un dock fijo que aparta la conversación, o una superposición centrada en viewports estrechos). Renderiza la transmisión PNG en vivo y acepta clic-para-tocar y arrastrar-para-gesto directamente sobre el vídeo, con una barra que lleva ◁ Atrás, ○ Inicio, □ Recientes, rotar, capturar y actualizar. Un menú de dispositivo ejecuta las cinco acciones de nivel de dispositivo (panel de notificaciones, ajustes rápidos, bloquear, despertar, asistente). El selector de dispositivos lista todos los dispositivos adb en UNA sola lista, agrupados por tipo, con los AVD sin arrancar mostrados como una pista que apunta a
android_booten lugar de arrancarlos al hacer clic. Los modos de tamaño y los estilos de marco (sin marco / bisel / carcasa de teléfono) funcionan igual que en el gemelo de iOS; el panel deduce su relación de aspecto del tamaño natural del propio fotograma, así que una rotación no necesita configuración alguna. - Tarjetas de conversación compactas. Los resultados de las herramientas se renderizan como tarjetas de una línea sin imágenes en línea: el nombre del dispositivo, una subetiqueta de acción, una insignia de estado y una indicación de «abrir en el panel lateral». Al hacer clic en la fila se abre el panel.
- Cápsula de estado sobre la entrada. Mientras el panel está cerrado y hay una transmisión en línea, aparece una pequeña píldora sobre el compositor que abre el panel al hacer clic.
- Modo estándar y modo Code. Las sesiones estándar usan el
presentationMetaproyectado por el host; los despachos anidados del modo Code no llevan meta, así que el cliente reconstruye la misma meta a partir del JSON de resultado durable: el panel, las tarjetas y la cápsula funcionan en ambos.
Seguridad
- El navegador nunca habla con adb, y no existe ningún puerto interno con el que hablar. La transmisión se produce en este proceso y se sirve desde memoria; cada byte cruza el origen del servidor web de DSH mediante rutas
/_dsh/dsh-android/*propiedad del plugin:/stream/<token>(PNG multipart en vivo),/screenshot/<token>(PNG cacheado), más/grant,/switch-device,/devices,/capture,/status,/controly/device-action. Es una superficie de ataque estrictamente menor que la de un servidor de transmisión loopback proxeado. - Una triple barrera de loopback, aplicada antes de leer cualquier capacidad. El par de transporte debe ser una dirección loopback, la cabecera
Hostdebe nombrar una autoridad loopback (por lo que se rechaza unHostde DNS rebinding) y Fetch-Metadata/Origindeben ser del mismo origen. Host y Origin son datos controlados por quien llama y nunca se creen por sí solos. - Proxy inverso: trustedAuthorities debe ser una lista de cadenas y usarse solo detrás de un proxy que autentique todas las rutas del plugin. Un cliente API puede falsificar Host y Origin; Origin no es autenticación. El par debe seguir siendo loopback. La lista vacía predeterminada rechaza hosts públicos. Los puertos se normalizan numéricamente; el protocolo y puerto declarados limitan el Origin.
- Capacidades HMAC-SHA256 que caducan en 10 minutos, con formato
base64url(payload).base64url(mac)y firmadas con una clave de 32 bytes propia de cada hogar DSH (<DSH_HOME>/cache/dsh-android/stream-access.key, modo 0600, creada de forma atómica). Una capacidad emitida para un dispositivo deja de funcionar en el momento en que otro dispositivo toma la ranura de transmisión, y una capacidad de captura no puede reproducirse contra la ruta de transmisión. - La ruta de capturas sirve exactamente un directorio. Las rutas se recorren con
lstat(cualquier enlace simbólico se rechaza), se rematan con una comprobación de contención porrealpath, se abren conO_NOFOLLOW, se acotan en tamaño y se revalidan tras la lectura, de modo que un archivo sustituido por un enlace simbólico entre la emisión y la descarga nunca llega a servirse. /grantnunca arranca nada. Solo inicia el bucle de fotogramas de un dispositivo que ya está en línea, y rechaza (409device_busy) arrebatar la transmisión a otro dispositivo. Cambiar de dispositivo exige el gesto explícito/switch-device; arrancar un AVD sigue siendo cosa de la herramientaandroid_boot.- Keep-alive y parada por inactividad. Un bucle de fotogramas caído se reinicia en segundo plano (~5 s de retardo); con cero consumidores, la transmisión se detiene sola a los 5 minutos. Las paradas intencionadas nunca se combaten.
Requisitos
- Node ≥ 24.11.0.
- adb, de las platform-tools del SDK de Android, resuelto en este orden: la variable de entorno
ADB→adben elPATH→<ANDROID_HOME>/<ANDROID_SDK_ROOT>/la raíz del SDK por defecto de cada sistema +/platform-tools/adb. Instálalo consdkmanager "platform-tools", con Android Studio o conbrew install --cask android-platform-tools. Sin adb el plugin se carga igualmente y las 20 herramientas se registran; cada llamada explica entonces qué falta. - Un dispositivo: un emulador de cualquier producto, o un teléfono con la depuración USB activada. El lanzador
emulatores opcional y solo lo necesitaandroid_bootpor nombre de AVD; todo lo demás funciona con lo que adb pueda ver. - DSH ≥ 0.1.0-rc.6 con el bundle web para el panel. Los perfiles headless también funcionan: las 20 herramientas operan con normalidad, solo que sin la vista en vivo.
- Host macOS para el OCR (solo lo necesitan
android_find_text/android_tap_text/android_wait_for): en el primer uso, el plugin compila suassets/ocr.swiftincluido conswiftcen~/Library/Caches/dsh-android/bin/ocr. En hosts Linux y Windows esas tres herramientas informan de que el OCR necesita el framework Vision de macOS; las otras 17 no se ven afectadas. Sobrescrituras:DSHPLUGIN_ANDROID_OCR_DIR,DSHPLUGIN_ANDROID_OCR_SWIFT,DSHPLUGIN_ANDROID_SWIFTC. - ADBKeyboard (opcional, para escritura CJK y emoji):
adb shell input textsolo admite ASCII. Instala ADBKeyboard en el dispositivo y selecciónalo como IME activo, y el texto no ASCII se entregará por su interfaz de broadcast. Sin él, escribir texto no ASCII se RECHAZA con la pista de instalación, nunca se teclea mal en silencio.
Dispositivos físicos
No hay ningún equivalente de WebDriverAgent que compilar, firmar, aprobar ni volver a firmar cada siete días. Activa la depuración USB, conecta el teléfono, acepta el aviso de autorización en el dispositivo y aparecerá en android_devices con todas las herramientas funcionando contra él. Un dispositivo no autorizado se informa como tal, con la pista sobre el aviso, y no como un fallo misterioso.
Tres salvedades honestas:
- La tasa de fotogramas es menor por USB: unos 2–5 fps contra un teléfono frente a 5–10 fps en un emulador, porque cada fotograma cruza el enlace USB como PNG completo.
- Escribir CJK necesita ADBKeyboard (ver arriba); esto afecta por igual a emuladores y teléfonos.
android_shutdownno puede apagar un teléfono. adb no tiene ese verbo; la herramienta lo dice en vez de fingir.
Rendimiento
Medido en un emulador (Android 14, 1080×2400):
| Bucle screencap persistente | ≈ 8 fps |
Primer fotograma de ensureStreaming |
~200 ms |
Ida y vuelta de input tap |
~130 ms |
Lo que compra estas cifras es el único proceso hijo persistente: lanzar un adb por fotograma cuesta ~50–100 ms antes de que se mueva un solo píxel. Espera ~5–10 fps en un emulador y ~2–5 fps en un teléfono USB, según la máquina y la densidad de pantalla.
Instalar en DSH
dsh plugin --profile web add @zseven-w/dsh-android@latest
dsh web
O añádelo como dependencia de un paquete de perfil existente:
pnpm add @zseven-w/dsh-android
Inicio rápido
- Descubrir dispositivos: «Lista los dispositivos Android.» →
android_devices. - Iniciar la transmisión: «Transmite emulator-5554.» →
android_boot. El panel se abre con el dispositivo en vivo. (Un nombre de AVD arranca primero ese emulador.) - Tocar sobre el vídeo: toca o arrastra directamente en el panel, o deja que conduzca el agente: «Abre Ajustes y toca Pantalla.» →
android_interact, oandroid_ui_tree+android_tap_elementpara toques por identidad, oandroid_find_text+android_tap_textcuando el árbol está ciego. - Compilar y ejecutar tu app: «Compila y ejecuta /path/to/MyApp.» →
android_build_run. Una compilación completa de Gradle tarda minutos; cuando aterriza, la app se lanza y la ves en vivo en el panel. - Leer los registros: «Muestra los últimos dos minutos de logcat de com.example.app.» →
android_logs.
Solución de problemas
- Todas las herramientas dicen que adb no está disponible: el error nombra los tres niveles de resolución. Define
ADB=/ruta/a/adb, ponadben elPATHo instala las platform-tools del SDK (sdkmanager "platform-tools"). - El dispositivo está
unauthorized: acepta el aviso de depuración USB en la pantalla del dispositivo.android_devicesinforma del estado con honestidad en vez de ocultar el dispositivo. android_bootno encuentra un AVD: no se pudo localizar el lanzadoremulator. Arranca el emulador por cualquier medio; aparecerá enandroid_devicesen cuanto adb lo vea, yandroid_boottomará entonces su serial.- Se rechaza el texto no ASCII: instala ADBKeyboard y selecciónalo como método de entrada (ver Requisitos). El rechazo es deliberado:
input textdescartaría o estropearía los caracteres en silencio. android_find_textdice que el OCR no está disponible: el OCR necesita un host macOS (el framework Vision de Apple). Las 17 herramientas sin OCR funcionan en todas partes.- La transmisión se detiene sola: eso es la política de inactividad, no un fallo: con cero consumidores (panel cerrado, ninguna tarjeta montada, ninguna ruta activa) la transmisión se detiene a los 5 minutos y se reinicia en la siguiente llamada a una herramienta o al abrir el panel. Un bucle caído se reinicia solo en ~5 segundos.
- La rotación se ve mal en el launcher: los launchers y Ajustes se fijan en vertical e ignoran
user_rotation. Es comportamiento normal de Android, no un fallo del plugin; rota dentro de una app que lo permita.
Desarrollo
pnpm install
pnpm run build # tsc del host + bundle del cliente → lib/
pnpm run typecheck
pnpm test # todas las suites estáticas; no hace falta dispositivo
Las suites de smoke de scripts/ ejercitan el lib/ compilado. Todas son estáticas salvo dev-emulator-smoke.mjs, que necesita un dispositivo e informa SKIP (código de salida 0) cuando no hay ninguno.
| Script | Qué cubre |
|---|---|
node scripts/dev-adb-smoke.mjs |
La resolución de adb (env / PATH / SDK) contra un binario simulado, el parseo de devices -l, un exec-out seguro para binarios, el divisor de fotogramas PNG y su resincronización, el escapado de input text y el ciclo de vida del host (transmisión, control, parada por inactividad, dispose) contra una cadena de herramientas falsa. |
node scripts/dev-routes-static-smoke.mjs |
Las rutas firmadas contra un host falso: grants relativos, tokens caducados/falsificados/de otro tipo, la barrera de loopback, los sobres 405/415/400, los rechazos de dispositivo codificados, la validación de /control, la forma de rotate, la contención de capturas y la transmisión multipart en vivo. |
node scripts/dev-tools-smoke.mjs |
Las herramientas principales contra un host falso a través de la costura createAndroidTools. |
node scripts/dev-uitree-smoke.mjs |
Herramientas de árbol de UI y de filas: parseo del XML de uiautomator, selectores, tope de profundidad, heurísticas de filas y contadores. |
node scripts/dev-logs-smoke.mjs |
android_logs snapshot/follow, filtros, topes y recolección de procesos. |
node scripts/dev-panel-smoke.mjs |
Componentes del panel, modos de tamaño, estilos de marco, lógica de dock/disparador/cápsula (solo SSR). |
node scripts/dev-emulator-smoke.mjs [serial] |
Dispositivo real: primer fotograma, tasa de fotogramas sostenida, ida y vuelta de un toque, dispose. |
Otros problemas conocidos
Transmisión en blanco / negro en un emulador
Si el panel transmite una imagen completamente blanca (o negra) mientras
android_ui_tree sigue viendo elementos de UI reales, en tu máquina está roto el
readback del framebuffer por la GPU del host del emulador (un problema conocido de
gfxstream en algunos hosts macOS: el propio screencap devuelve fotogramas en
blanco, así que todas las herramientas de pantalla se ven afectadas). Relanza el
emulador con renderizado por software:
emulator -avd <name> -gpu swiftshader_indirect
o define hw.gpu.mode=swiftshader_indirect en el config.ini del AVD. Los
dispositivos físicos nunca se ven afectados.
Hoja de ruta
- Una fuente con mayor tasa de fotogramas. La costura
StreamSourcees deliberadamente intercambiable: una víascrcpy-server+ WebCodecs H.264 sustituiría la transmisión PNG fotograma a fotograma sin tocar las rutas, las herramientas ni el panel. - Recarga en caliente de vistas previas de Compose. El gemelo de iOS intercambia en caliente las vistas previas de SwiftUI como dylib; Compose no tiene hoy una primitiva de intercambio en caliente equivalente, así que esto queda como asunto futuro en vez de como algo entregado e inestable.
Ecosistema
- DSH iOS Simulator — la misma arquitectura para el simulador de iOS y los iPhone conectados por USB
- DSH Crew — delegar trabajo a agentes DSH desde Claude Code / Codex
- DSH Noema — memoria a largo plazo para DSH
- DSH OpenPencil — inspeccionar y editar documentos
.opdentro de una conversación
Créditos & Licencia
- Android SDK platform-tools (
adb) — se resuelven en tiempo de ejecución y nunca se redistribuyen: la licencia del SDK de Google no permite incluirlas. - ADBKeyboard — Senzhk — el IME opcional en el dispositivo detrás de la escritura no ASCII (Apache-2.0; no incluido).
- Arquitectura y postura de seguridad de las rutas compartidas con dsh-ios, de donde se ha portado este plugin.
- Consulta THIRD_PARTY_NOTICES.md para los avisos completos.
Licencia: MIT
OCR: Vision / Tesseract
Por defecto, auto usa Vision en macOS y Tesseract opcional en Windows/Linux. El usuario instala el ejecutable y los datos de idioma. Los caracteres chinos se agrupan por línea TSV y se conservan los espacios entre palabras latinas.
DSHPLUGIN_ANDROID_OCR_BACKEND:auto,vision,tesseract.DSHPLUGIN_ANDROID_TESSERACT_BINARY: Tesseract executable path.DSHPLUGIN_ANDROID_TESSERACT_LANGUAGES:eng+chi_sim.DSHPLUGIN_ANDROID_TESSERACT_DATA_DIR: Optional language-model directory.