> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesslabs.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Historial de usuarios

> Headless registra un historial local de nombres y un historial global de avatares a partir de eventos que observa. No recupera cambios anteriores a la observación del bot.

## Historial observado

`.names` muestra nombres y apodos guardados para el miembro en el servidor actual. `.avatars` consulta el historial global de avatares. Solo se incluyen cambios que Headless observó; ninguno es un registro completo ni recupera datos previos.

### `.userhistory`

```headless-command Syntax theme={null}
.userhistory [user]
```

```headless-command Example theme={null}
.userhistory @Member
```

También funciona: `.history 123456789012345678` · `.uh @Member`

### `/userhistory`

```headless-command Syntax theme={null}
/userhistory user:<user>
```

```headless-command Example theme={null}
/userhistory user:@Member
```

### `.names`

```headless-command Syntax theme={null}
.names [user_query]
```

```headless-command Example theme={null}
.names @Member
```

### `.avatars`

```headless-command Syntax theme={null}
.avatars [user_query]
```

```headless-command Example theme={null}
.avatars @Member
```

## Cronología para staff

`.userhistory <usuario>` (alias `.history` y `.uh`) busca por mención, ID o nombre. `/userhistory user:<miembro>` abre la misma vista en slash. El comando de prefijo requiere Manage Messages; la versión slash exige ese permiso por defecto y valida además el acceso de staff. La vista muestra fechas de creación/unión, risk score, casos, warns, timeouts, jail, kicks, bans, roles y actividad reciente, con controles para abrir casos, actualizar y copiar el ID.

Los encabezados y controles actuales del panel generado por Headless están en inglés. Los nombres del servidor y los datos o razones ya registrados conservan su texto original.

## Borrado y alcance

`clearnames` borra el historial de nombres del servidor actual; `clearhistory` borra ese historial y los avatares globales. Ambos se ejecutan inmediatamente, sin confirmación; borrar datos de otra persona requiere permisos de staff y puede generar un registro de auditoría.

### `.clearnames`

```headless-command Syntax theme={null}
.clearnames [user_query]
```

```headless-command Example theme={null}
.clearnames @Member
```

### `.clearhistory`

```headless-command Syntax theme={null}
.clearhistory [user_query]
```

```headless-command Example theme={null}
.clearhistory @Member
```

> [!WARNING]
>
> `.clearhistory` es destructivo: elimina inmediatamente tanto los nombres locales como los avatares globales. Verifica el usuario y el alcance antes de ejecutarlo; no hay confirmación.

## Resumen público

La respuesta pública del endpoint de Insights se limita a métricas agregadas de siete días y al número de perfiles seguidos; no publica cronologías individuales. Los detalles requieren la sesión de Dashboard y el permiso correspondiente en ese servidor.

## Pasos

**1. Consulta sin modificar**

Usa names o avatars con el usuario que quieres revisar.

**2. Verifica el alcance**

Distingue el historial de nombres del servidor y el historial global de avatares.

**3. Solicita borrado cuando proceda**

Usa clearnames para borrar solo nombres o clearhistory para borrar nombres y avatares. Ambos borrados se ejecutan directamente; revisa el usuario objetivo antes de llamar.

## Alcance del historial de usuario

> **[Cronología privada para staff](/docs/moderation/user-tools.md)**
>
> El panel permite buscar por mención, ID o nombre y revisar el risk score, eventos de moderación y actividad observada. Sus controles abren casos relacionados, actualizan la vista y copian el ID del miembro.
>
> <ul>
>   <li>Búsqueda por mención, ID o nombre</li>
>   <li>Risk score y eventos de moderación/actividad observados</li>
>   <li>La versión actual no ofrece exportación TXT</li>
>   <li>El resumen público no revela cronologías individuales</li>
> </ul>

## Páginas relacionadas

* [Herramientas de usuario](/docs/moderation/user-tools.md)
* [Registros](/docs/server/logging.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.