> ## 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.

# Herramientas de usuario

> Consulta perfiles y historiales observados por Headless, y conoce el alcance y los permisos de cada comando de usuario.

Esta guía cubre las fichas de perfil, las consultas de nombres y avatares observados y los comandos que borran esos datos. Las consultas de perfil y esos historiales no requieren permisos de moderación; `.userhistory` es un comando distinto, limitado al staff. Borrar los datos de otra persona sí requiere una comprobación de permisos.

> **Antes de moderar**
>
> Revisa la fecha de entrada, los roles principales y si la cuenta parece reciente antes de decidir cómo atender un caso.

> **Datos visuales**
>
> Avatar, banner y `serverinfo` ayudan a identificar el perfil y el servidor. El banner solo aparece si Discord lo expone.

> **Privacidad**
>
> Estos comandos muestran datos de perfil públicos o eventos que Headless observó. No exponen tokens ni información interna.

## Fichas de perfil

* **`.userinfo [usuario]` · `/userinfo [miembro]` (`.ui`, `.whois`, `.uid`)** — **Qué muestra:** Ficha de Discord con identificador, insignias disponibles, fechas de creación/unión, boost, señales visibles de perfil y enlaces de avatar/banner. · **Alcance:** Servidor; si omites el miembro, consulta a quien ejecuta el comando.
* **`.avatar [usuario]` · `/avatar [miembro]` (`.av`, `.pfp`)** — **Qué muestra:** Avatar actual y, en prefijo, enlaces PNG y WebP. · **Alcance:** Sin permisos elevados. El prefijo es de servidor; si la consulta por prefijo no resuelve un miembro único, el callback usa al invocador.
* **`.banner [usuario]` · `/banner [miembro]` (`.bn`, `.userbanner`)** — **Qué muestra:** Banner del perfil; si no existe, muestra el color de acento cuando Discord lo proporciona. · **Alcance:** Prefijo de servidor; el prefijo devuelve error si no puede resolver el usuario o hay ambigüedad.
* **`.serverinfo` · `/serverinfo` (`.si`, `.server`)** — **Qué muestra:** Ficha informativa del servidor actual. · **Alcance:** Solo en servidores; no requiere permiso de moderación.

Los campos de `userinfo` dependen de lo que Discord exponga para esa cuenta. La ficha no consulta endpoints privados ni garantiza datos de antigüedad de Nitro; muestra señales verificables del perfil cuando están disponibles.

## Historiales observados

* **`.names [usuario]` (`.namehistory`, `.nombres`, `.oldnames`, `.previousnames`, `.prevnames`) · `/buscar nombres [miembro]`** — **Qué consulta:** Historial de nombres y apodos guardados, hasta 12 entradas recientes. · **Ámbito y restricciones:** Datos del servidor actual; la consulta slash requiere contexto de servidor. No recupera cambios anteriores a lo que Headless observó.
* **`.avatars [usuario]` (`.avatarhistory`, `.avhistory`, `.avatares`) · `/buscar avatares [miembro]`** — **Qué consulta:** Collage paginado del historial de avatares. · **Ámbito y restricciones:** Historial global por usuario, aunque se consulta desde un servidor. Muestra hasta 9 imágenes por página; solo quien abrió el resultado puede usar sus controles.
* **`.userhistory <usuario>` · `/userhistory [miembro]` (`.history`, `.uh`)** — **Qué consulta:** Cronología de moderación y actividad con controles para abrir casos, actualizar y copiar el ID. · **Ámbito y restricciones:** Consulta de staff: requiere Manage Messages y las comprobaciones de acceso descritas en [Historial de usuarios](/docs/community/user-history.md).

Estos registros son parciales: dependen de los eventos que Headless recibió y guardó. El historial de nombres es por servidor; el de avatares se comparte como historial de perfil global. Un usuario puede aparecer con menos entradas si el bot no observó sus cambios.

## Borrado y permisos

* **`.clearnames [usuario]` · `/clearnames [miembro]` (`.cnames`, `.nameclear`, `.limpiarnombres`, `.clearnamehistory`, `.delnames`)** — **Datos que elimina:** Historial de nombres del servidor actual y eventos de nombre asociados. · **Quién puede borrar datos de otra persona:** Owner del servidor o de Headless, o Manage Server, Manage Messages o Moderate Members.
* **`.clearhistory [usuario]` · `/clearhistory [miembro]` (`.clearall`, `.limpiarhistorial`)** — **Datos que elimina:** Historial de nombres del servidor actual y avatares del historial global. · **Quién puede borrar datos de otra persona:** La misma comprobación de staff.
* **`.avatarcache [usuario]` · `/avc [miembro]` (`.avc`, `.avatarclear`, `.clearavatars`, `.limpiaravatar`, `.limpiaravatars`)** — **Datos que elimina:** Historial global de avatares y referencias de imágenes en caché asociadas. · **Quién puede borrar datos de otra persona:** La misma comprobación de staff. El alias de prefijo `.avc` también ejecuta `.avatarcache`.

`.clearnames`, `.avatarcache` y `.clearhistory` borran los datos inmediatamente, sin pedir confirmación. Puedes borrar tu propio historial sin permiso de staff; para borrar el de otra persona, el runtime acepta al owner de Headless o cualquiera de los permisos nativos indicados. El comando se invoca dentro de un servidor y las acciones se intentan registrar en sus Logs.

> [!WARNING]
>
> `clearhistory` también elimina el historial global de avatares; no se limita al servidor donde lo ejecutas. Revisa cuidadosamente el miembro antes de usarlo. `clearnames` y `avatarcache` tienen alcances distintos: uno borra nombres locales y el otro avatares globales.

## Pasos

**1. Consulta antes de borrar**

Usa `userinfo`, `avatar`, `banner`, `names` o `avatars` para identificar el perfil y el tipo de historial.

**2. Comprueba el alcance**

`names` y `clearnames` son locales al servidor; `avatars`, `avatarcache` y la parte de avatares de `clearhistory` son globales.

**3. Elige el comando de limpieza correcto**

Usa `clearnames` para nombres, `avatarcache` para avatares o `clearhistory` para ambos. El borrado es inmediato y puede afectar datos visibles desde otros servidores.

## Ejemplos por flujo

### Fichas e información de perfil

#### `.userinfo`

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

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

```headless-command Syntax theme={null}
/userinfo [member:<member>]
```

```headless-command Example theme={null}
/userinfo member:@Member
```

#### `.avatar`

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

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

#### `.banner`

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

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

#### `.serverinfo`

```headless-command Syntax theme={null}
.serverinfo
```

```headless-command Example theme={null}
.serverinfo
```

### Nombres y avatares observados

#### `.names`

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

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

#### `/buscar nombres`

```headless-command Syntax theme={null}
/buscar nombres [user:<user>]
```

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

#### `.avatars`

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

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

#### `/buscar avatares`

```headless-command Syntax theme={null}
/buscar avatares [user:<user>]
```

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

#### `.userhistory`

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

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

### Borrar historial y caché

#### `.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
```

```headless-command Syntax theme={null}
/clearhistory [user:<user>]
```

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

#### `.avatarcache`

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

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

#### `/avc`

```headless-command Syntax theme={null}
/avc [user:<user>]
```

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

## Páginas relacionadas

* [Historial de usuarios](/docs/community/user-history.md)
* [Social y búsquedas públicas](/docs/community/social.md)
* [Casos de moderación](/docs/moderation/cases.md)
* [Registros](/docs/server/logging.md)


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