Manejo de hiperacusia
Por qué así: por-que-asi/manejo-de-hiperacusia.md · Normativos:
MindTune_Plan_Integrado.md§1-bis, §1-bis.6 y §1-bis.6-bis,ROADMAP_MAESTRO.md§2.5 y §4 D-R3, D-R4–D-R6 (lote Camping Chivato), DS §4.17 (enmienda 2026-10-26) y §4.37 · Código:lib/features/audio/ruido/dosificacion_ruido.dart(ParametrosHiperacusia,EnvolventeProgresiva),lib/features/terapias/manejo_hiperacusia_screen.dart,lib/features/laboratorio/forma_del_ciclo_lab.dart,tools/oracle/hiperacusia_ciclo_golden.pyVerificado contra HA.1 el 2026-10-26 · Probado en iPhone: no (H2.2-bis, HA.1-bis)
Qué es, en tres frases
El paciente calibra en cada sesión el nivel de ruido que hoy tolera sin que moleste —su techo—; la sesión parte mucho más abajo (al 50 % de la sonoridad del techo), sube suave hasta el techo y desde ahí la intensidad baja y vuelve a subir en ciclos que se alargan, sin pasar nunca ese techo. Es desensibilización por exposición graduada. Es la única terapia de MindTune que no necesita ningún dato del perfil.
Dónde está en la app
Terapias → Manejo de hiperacusia, la cuarta. Sin requisitos: si el perfil tiene un LDL medido, se muestra como referencia durante la calibración, nada más.
El estímulo
Es el mismo generador de ruido que Inhibición residual — banda, variantes, anchos, canales, prueba de oído de 1 segundo en unilateral y techo de banda a 16 kHz. Está descrito en inhibicion-residual.md. Lo único distinto entre las dos terapias es la dosis.
Paso a paso
Calibrar el techo. El ruido parte en un nivel seguro (0,10 por defecto) y el paciente sube. Instrucción literal: «Sube hasta justo antes de que moleste. Si molesta, ya te pasaste: baja un poco.» Ese punto es el techo tolerable de la sesión y queda registrado con
modo = techo_tolerable. La calibración no cuenta dentro de la dosis.El ciclo progresivo (desde HA.1, 2026-10-26), todo en curvas de medio coseno — suaves al salir y al llegar, como la bajada de Inducción:
- Subida inicial, 2 min: desde la partida —el 50 % de la sonoridad del techo, −10,0 dB— hasta el techo.
- Primera vez en el techo, 3 min.
- Ciclos: cada uno baja hasta el 60 % de sonoridad (−7,37 dB) en el 25 % del ciclo, sube al techo en otro 25 % y se queda en el techo el 50 % restante. Los ciclos se alargan en línea recta: el último dura el doble que el primero.
Todo calza en la duración de la sesión: 10 minutos por defecto, entre 10 y 20. Lo que queda después de la subida y el primer techo se reparte en ciclos: cuántos caben lo decide un ciclo nominal de 2:30 (redondeando), y su largo exacto, que la suma dé justo. La sesión termina al final del techo del último ciclo, con el cierre de sesión de siempre.
Duración Ciclos 10 min uno de 5:00 (bajada 1:15, subida 1:15, techo 2:30) 13 min 2:40 y 5:20 15 min 2:13, 3:20 y 4:27 20 min 2:30, 3:20, 4:10 y 5:00 Con 10 min el alargamiento no se ve (hay un solo ciclo); aparece a medida que la duración sube.
La gráfica del ciclo muestra la sesión entera como una curva suave, con tres referencias rotuladas —Techo, 60 % de sonoridad y Partida · 50 %—, la posición actual y una frase: Subiendo al techo · llega en 1:20 / En el techo · 2:10 para empezar a bajar / Bajando · llega al 60 % en 0:40 / Subiendo · vuelve al techo en 1:10 / en el último techo, En el techo · termina en 2:30. Sin color de alarma en el tramo alto.
Los −7,37 dB y los −10,0 dB salen de 10 · log₂(0,6) y 10 · log₂(0,5), con la misma función que
usa Inducción de filtrado: no hay una segunda constante escrita a mano en ninguna parte. La curva está
fijada contra una tabla dorada que escribe un script Python independiente
(tools/oracle/hiperacusia_ciclo_golden.py, numpy) para 10, 13, 15 y 20 min, comparada punto a punto
cada 0,5 s (|Δ| < 1e-6 dB). El ruido en sí no tiene oráculo bit a bit (D-R1): esto fija la envolvente.
La forma de antes (3 min sostenido, 1,5 bajando y 1,5 subiendo en rectas, 15 min, termina donde
caiga) quedó como forma clásica: no suena en ninguna sesión nueva y solo existe para leer los
registros anteriores (forma = clasica).
«¿Cómo te fue?» y el plan de duración (HA.2)
Antes de cada sesión cuya anterior todavía no se evaluó (hasta dos por día, por la hora de espera), sobre la calibración y antes de que suene nada, aparece la misma hoja de Inducción con dos preguntas fijas: ¿Cómo toleraste la última sesión? (Bien · Con algo de molestia · Me costó mucho) y ¿Te resultó difícil llegar al final? (No · Un poco · Sí). Arriba, un dato: La última fue ayer: 10 min, y bajaste el volumen a los 6:40. (la segunda parte, solo si hubo una bajada). Abajo, Para hoy: 12 min con De acuerdo y, si cambia, Seguir con 10 min. La primera sesión de la vida no tiene hoja.
- Sube 2 min tras una sesión bien tolerada —llegó al menos al 80 % de su duración y no hubo señal de dificultad—, hasta 20. Si no, se mantiene. Nunca baja sola.
- Dificultad = Me costó mucho, Sí, o haber bajado el volumen (del teléfono o el techo) 3 dB o más en total durante esa sesión, aunque haya contestado Bien. Con algo de molestia y Un poco no son dificultad: rozar el techo es la terapia.
- Con una indicación del equipo que fija la duración, el plan no corre (y la Configuración dice solo Hoy: 15 min). Mover la duración a mano también vale: el plan sigue desde ahí.
El volumen del teléfono se escucha, nunca se toca. Durante la sesión la app anota cada vez que el
paciente lo cambia (los toques seguidos de los botones son un solo cambio) y cada cambio del techo:
en qué segundo, de cuánto a cuánto y en qué fase del ciclo. En iOS es un canal propio de unas 40
líneas (KVO de AVAudioSession.outputVolume); en Android todavía no, y ahí solo cuenta el techo. La
bajada en dB del volumen del sistema es una aproximación (20·log10 del cociente); la del techo es
exacta.
Cómo se le explica al paciente (H7.14)
- La lección Cómo usar Manejo de hiperacusia está en v2 (delta
lecciones_lote_2026-10-26.json, dictado de Hayo): sesiones de unos 15 minutos que empiezan en 10, el techo con audífonos, un sonido que parte mucho más bajo y nunca pasa del techo, y la duración que sube cuando la anterior fue tolerable. Subió de versión una vez: quien vio la v1 la ve como no vista. pt/en en borrador. - El recorrido de la pantalla tiene cinco paradas (las otras terapias, cuatro; D-A41): la 1 con la
mini-gráfica del ciclo progresivo de 10 min, la 2 el control del techo, la 3 el botón Empezar, la 4
el ⓘ con Leer «Por qué funciona», y la 5 —Parte mucho más bajo— vuelve a recortar el control
del techo y cierra con Entendido.
terapia.recorrido.paradava de 1 a 5. - No te preocupes aparece en tres de esos textos, literal de Hayo; DS §6 lo prohíbe salvo D-IF14,
así que quedó como excepción declarada en los tests (
test/support/excepciones_dif14.dart) a la espera de que DS §6 la escriba.
El techo vive en la ley de ganancia
La envolvente del ciclo es siempre ≤ 0 dB respecto del techo. Eso significa que el techo no es un número que la pantalla vigila, sino una propiedad de la fórmula: bajar el techo a mitad de sesión baja el ciclo entero al instante. Hay un test que exige que ninguna muestra supere el techo, para cualquier techo y en cualquier instante.
Parámetros y valores por defecto
La Configuración de la sesión muestra solo la duración (10–20, paso 1), con el resumen Hoy: 10 min · sube con las sesiones que toleras bien. Una indicación del equipo puede fijar la duración (y la espera y el nivel de partida); la forma no: es dosificación de la app.
| Parámetro | Clave | Por defecto | Rango | Dónde se cambia |
|---|---|---|---|---|
| Duración de la sesión | duracionSesionMinutos | 10 min | 10 – 20 min | Configuración de la sesión · indicación |
| Partida, en sonoridad del techo | partidaSonoridad | 0,50 (−10,0 dB) | 0,30 – 0,80 | Laboratorio |
| Subida inicial | subidaInicialSeg | 120 s | 60 – 180 s | Laboratorio (provisional) |
| Primera vez en el techo | primerTechoSeg | 180 s | 60 – 300 s | Laboratorio |
| Ciclo inicial nominal | cicloNominalSeg | 150 s | 90 – 240 s | Laboratorio (provisional) |
| Último ciclo ÷ primero | factorUltimo | 2,0 | 0,5 – 3,0 | Laboratorio |
| Bajada (= subida) dentro del ciclo | fraccionBajada | 0,25 | 0,15 – 0,35 | Laboratorio |
| Piso de los ciclos | pisoSonoridad | 0,60 (−7,37 dB) | 0,30 – 0,90 | Laboratorio |
| Nivel de partida al calibrar | nivelDePartida | 0,10 | 0,02 – 0,50 | indicación |
| Cooldown recomendado | cooldownMin | 60 min | 0 – 240 min | indicación |
Los siete de forma viven en Laboratorio › Hiperacusia › Forma del ciclo (solo en desarrollo) y se guardan aparte de los parámetros que viajan al servidor. Quien tenía guardada una duración menor que 10 o igual al viejo valor por defecto (15) pasa a 10; una de 11 a 20 elegida a mano se respeta.
El cooldown no bloquea
Al entrar antes de tiempo, la app avisa: «Tu última sesión terminó hace 20 min. Se recomienda esperar una hora.» Y el botón de empezar sigue ahí. El paciente manda en su teléfono, y no hay candados. Los minutos transcurridos desde la sesión anterior quedan en la bitácora.
Avisos
El mismo aviso de algiacusia que la otra terapia de ruido, en la calibración y en la sesión: «Este sonido nunca debe molestar. Si molesta, bájalo.» Sin rojo.
Qué guarda
El techo calibrado de cada sesión —con modo = techo_tolerable—, la forma del ciclo (progresiva)
y sus siete parámetros, el estímulo completo, cada cambio de fase (subida inicial → primer techo →
bajada → subida → techo, con el número de ciclo), los ajustes durante la sesión y los minutos desde la
sesión anterior. Desde HA.2, además, cada cambio de volumen (sesion.volumen), las respuestas de
¿Cómo te fue? con la bajada de esa sesión (hiperacusia.chequeo) y cada paso del plan
(hiperacusia.plan). En el Historial la sesión dice 10 min · ciclo progresivo y, si hubo bajadas,
bajaste el volumen 2 veces; el panel del equipo muestra la serie de duraciones, las respuestas y las
bajadas. La serie de techos es el
dato: hasta dónde tolera el paciente, sesión a sesión.
Lo que NO hace, a propósito
- No usa el LDL como requisito. Un techo que se calibra cada vez no depende de un número medido una vez.
- No sube la intensidad por etapas entre sesiones: no es una escalera semanal (ver la capa 2). Lo que sube con el plan es la duración, y solo si la sesión anterior se toleró bien.
- No bloquea por cooldown.
- No dice «dB SL».
- No pinta de rojo el tramo alto del ciclo.
⚠️ Desfase: H2.4 no está firmada, y acá lo pendiente no es un número sino una reserva clínica escrita: pedirle a un hiperacúsico que roce la molestia en cada sesión y se sostenga tres minutos ahí es exposición, no la TRT clásica de banda ancha a bajo nivel. Está en la capa 2, §6.