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 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) (limited to 'docs/EXTENDER.md') 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 -- cgit v1.2.3