From 8518a63f55153e7f45fd49ad6caff5555f4e374f Mon Sep 17 00:00:00 2001 From: elvis Date: Sat, 26 Sep 2026 20:20:19 -0300 Subject: Translate code, comments, logs and terminal UI to English; add English README; rename scripts --- docs/EXTENDER.md | 18 +++++++++--------- docs/RENDIMIENTO.md | 6 +++--- 2 files changed, 12 insertions(+), 12 deletions(-) (limited to 'docs') diff --git a/docs/EXTENDER.md b/docs/EXTENDER.md index f0148e2..9ca243f 100644 --- a/docs/EXTENDER.md +++ b/docs/EXTENDER.md @@ -96,7 +96,7 @@ shell = true shell_allowlist = ["date", "uptime", "free", "df", "ls"] shell_timeout_secs = 10 shell_dry_run = true # estrena la lista sin ejecutar nada -shell_working_dir = "/home/elvis" +shell_working_dir = "/home/user" ``` Empieza con `shell_dry_run = true`: registra lo que el modelo habría ejecutado @@ -111,7 +111,7 @@ Ya está montado, con tres buscadores intercambiables. enabled = true backend = "tavily" # "tavily", "ddgs" o "searxng" api_key_env = "TAVILY_API_KEY" -command = ["../scripts/buscar-ddgs.sh", "{consulta}", "{max}"] +command = ["../scripts/search-ddgs.sh", "{query}", "{max}"] base_url = "" # para searxng: "http://127.0.0.1:8888" max_results = 5 ``` @@ -134,7 +134,7 @@ Con clave, tavily. Sin clave, ddgs. ### Sobre DuckDuckGo -`scripts/buscar-ddgs.sh` se apoya en la librería +`scripts/search-ddgs.sh` se apoya en la librería [`ddgs`](https://github.com/deedy5/ddgs), que es la misma que hay debajo de `duckduckgo-mcp`. Consulta DuckDuckGo, Brave, Mojeek, Startpage y alguno más, sin clave. Conviene instalarla de forma permanente para que cada búsqueda no @@ -157,7 +157,7 @@ La librería sí funciona porque rota buscadores y cabeceras. ### Cualquier otro buscador El backend `ddgs` es en realidad un **backend de comando**: ejecuta un programa -y lee JSON de su salida estándar. `{consulta}` y `{max}` se sustituyen antes de +y lee JSON de su salida estándar. `{query}` y `{max}` se sustituyen antes de ejecutar, y el extractor acepta tanto la lista suelta que devuelve ddgs como la forma `{answer, results}`, con los campos nombrados a la manera de cada uno (`href` o `url`, `body` o `content`). @@ -166,7 +166,7 @@ Así que meter otro buscador —o un puente a un servidor MCP, que es un proceso que habla JSON-RPC por stdio— no es tocar Rust, sino escribir un guion: ```toml -command = ["/ruta/a/mi-buscador.sh", "{consulta}", "{max}"] +command = ["/ruta/a/mi-buscador.sh", "{query}", "{max}"] ``` Los argumentos van al `execve` tal cual, sin shell que los interprete: la @@ -201,7 +201,7 @@ save_dir = "" # vacío = no se guarda ningún fotograma [screen] enabled = true -command = ["../scripts/capturar-pantalla.sh", "{ancho}", "{salida}"] +command = ["../scripts/capture-screen.sh", "{width}", "{output}"] width = 1280 # texto: NO lo bajes, ver abajo output = "" # monitor concreto; vacío = todo save_dir = "" # vacío = no se guarda ninguna captura @@ -228,14 +228,14 @@ completes lo que no se distinga», y funciona: en una prueba real contestó que ### Otro entorno gráfico -`scripts/capturar-pantalla.sh` detecta grim (Wayland wlroots), spectacle (KDE), +`scripts/capture-screen.sh` detecta grim (Wayland wlroots), spectacle (KDE), maim, ImageMagick y scrot (X11), reduce con ffmpeg y escribe el JPEG por la salida estándar. Está fuera del binario para que añadir un compositor sea editar el guion, no recompilar. Cualquier otro programa que respete ese contrato vale: ```toml -command = ["/ruta/a/mi-captura.sh", "{ancho}", "{salida}"] +command = ["/ruta/a/mi-captura.sh", "{width}", "{output}"] ``` ### Tres decisiones que conviene no deshacer @@ -290,7 +290,7 @@ filtrar palabrotas, registrar la conversación— añade un hilo con ```bash # Graba unos segundos de la voz que quieras y transcríbelos a mano. -scripts/clonar-voz.sh grabacion.wav transcripcion.txt mivoz +scripts/clone-voice.sh grabacion.wav transcripcion.txt mivoz ``` Deja `assets/voices/mivoz.{spk,rvq,txt}`. Apunta ahí `[tts.reference]` en la diff --git a/docs/RENDIMIENTO.md b/docs/RENDIMIENTO.md index bed4f33..39914de 100644 --- a/docs/RENDIMIENTO.md +++ b/docs/RENDIMIENTO.md @@ -337,7 +337,7 @@ Medido: **4020 MiB usados de 4096**. Se nota cuando ambos trabajan a la vez. Las pruebas de integración lo enseñaron sin querer: en paralelo, el primer token del LLM pasaba de ~0,5 s a **5,0 s**, y la prueba fallaba. Por eso se turnan mediante un mutex -(`en_exclusiva()`), y por eso el ASR corre en CPU aunque haya CUDA disponible: +(`exclusive()`), y por eso el ASR corre en CPU aunque haya CUDA disponible: disputar esa memoria sale más caro que decodificar en el procesador. El pipeline de verdad sufre menos porque las etapas están naturalmente @@ -396,8 +396,8 @@ RUST_LOG=info,asr=debug,tts=debug cargo run --release -- run RUST_LOG=info,herramientas=info,camara=info cargo run --release -- run # Comprobar de nuevo las cifras de arriba -scripts/servidores.sh arrancar -cargo test --release -p asist-app --test integracion -- --nocapture +scripts/servers.sh start +cargo test --release -p asist-app --test integration -- --nocapture ``` -- cgit v1.2.3