Clasificar mensajes guardados y autores

Las estadísticas usan stats → resource → view. El ejecutable es tg. Los comandos leen el almacén local y no se conectan por defecto. Descarga primero el historial pertinente; una clasificación describe los datos disponibles, no toda la actividad del mensajero.

tg stats messages top 'chat:room date:[2026-10-01 TO 2026-10-08}' --measure reactions --limit 10 --json
tg stats contacts top 'chat:room date:[2026-10-01 TO 2026-10-08}' --score helpful --min-messages 3 --json
tg stats contacts top --weights '{"messages":0.4,"active-days":0.6}' --timezone Europe/Madrid --json

Métricas y puntuacionesCopy Anchor Link

answer-time ordena de menor a mayor por la mediana en milisegundos; las demás métricas ordenan de mayor a menor. --message-kind posts o comments selecciona tipos confirmados antes de agregar. Los vínculos antiguos desconocidos se indican en lugar de suponerse. Los comentarios vinculados de un canal pueden estar en un grupo de discusión guardado; la respuesta enumera los chats de discusión incluidos adicionalmente y su cobertura.

--score helpful da pesos de 0,5 a las respuestas acreditadas, 0,25 a las respuestas de otros y 0,25 a las reacciones. --score active da pesos de 0,6 a los días activos y 0,4 a los mensajes. Ambos se aplican a autores. --score engaging da el mismo peso a reacciones y respuestas de otros; las puntuaciones de autores usan tasas por mensaje y exigen cinco mensajes seleccionados salvo que --min-messages cambie ese umbral. --weights sustituye todos los pesos del preajuste. Los nombres deben ser componentes admitidos para el objeto, los pesos finitos y no negativos, y al menos uno positivo. --measure es incompatible con las puntuaciones.

La versión 1 de la puntuación normaliza cada componente frente al máximo de todas las filas elegibles antes de --limit: 100 × sum(weight × value / maximum) / sum(weight). Un máximo cero aporta cero. Si faltan componentes con peso positivo, la fila queda excluida de la puntuación. Un peso cero ignora ese componente. La respuesta incluye máximos, valores de componentes, aportaciones y recuentos de exclusiones.

Alcance y calidadCopy Anchor Link

Las consultas usan Lucene estricto con --chat, --source, --exact y --timezone, como la búsqueda de mensajes. Una página de clasificación contiene de 1 a 100 filas. Las condiciones de texto y autor seleccionan los mensajes clasificados; el contexto de respuestas usa mensajes guardados autorizados del mismo periodo, sin esos filtros de texto o autor. Las métricas de grafo rechazan ramas de fechas ambiguas: usa un intervalo de fechas positivo común.

Los contadores de vistas, reacciones, reenvíos y comentarios son instantáneas acumulativas guardadas. Se desconocen su hora de observación y vigencia; un filtro de fechas selecciona mensajes, no reacciones recibidas durante ese periodo. Los contadores desconocidos se distinguen del cero. Los totales de reacciones de autores pueden ser parciales, con recuentos de mensajes conocidos y desconocidos. --sync-first está sujeto a comprobaciones y límites; descarga mensajes nuevos y no actualiza contadores antiguos.

Las respuestas se identifican mediante una heurística: una pregunta contiene ? tras quitar las URL, y se acredita su primera respuesta directa de otro autor humano conocido. No cuentan las respuestas propias ni las identidades de canal. Las palabras usan secuencias de letras o dígitos de la versión 1, sin URL. Los días activos usan la zona horaria elegida. La cobertura y la calidad del grafo indican cuándo el historial disponible está incompleto. Ninguna métrica demuestra utilidad.

Seguir las pruebasCopy Anchor Link

Cada fila devuelve drilldown.selection y los drilldown.evidence.arguments exactos de su comando de pruebas. Pasa esa selección como JSON con el localizador de mensaje o el ID de persona en el servicio que se devuelve:

tg stats messages evidence msg:telegram/fixture/room/101 --selection "$selection" --component replies --limit 20 --json
tg stats contacts evidence 42 --selection "$selection" --component answers --limit 20 --json

Las respuestas incluyen el mensaje al que responden; las respuestas acreditadas incluyen la pregunta y su respuesta. Las métricas de instantáneas muestran mensajes medidos, no listas de lectores ni de personas que reaccionaron. Las pruebas messages de un autor muestran todos los mensajes seleccionados incluso al clasificar por puntuación. Las pruebas de días activos enumeran los mensajes subyacentes; sus aportaciones de una por mensaje no se suman como días distintos.

Las pruebas incluyen total, included, hasMore y nextCursor. Continúa con los mismos argumentos y --cursor. Si cambia una fila que contribuye al resultado, se rechaza el cursor; reinicia sin él. Cada página conserva filas completas dentro de un presupuesto de 64 KiB para items. Una fila demasiado grande remite a messages show. El cálculo de la huella está limitado a 50 000 filas y 8 MiB de entradas guardadas; reduce los chats o las fechas si la consulta supera el límite. El JSON de selección está limitado a 64 KiB.

Guardar una clasificación resueltaCopy Anchor Link

tg searches create weekly --selection "$selection"
tg stats contacts top --saved weekly --limit 20 --json

Usa el objeto correspondiente de mensajes o contactos. Los ID resueltos y los límites de fecha quedan fijados; las palabras adicionales reducen el alcance guardado. Las opciones de clasificación que indiques sustituyen a las guardadas. Las selecciones fijadas leen los datos disponibles y rechazan --sync-first; ejecuta una consulta normal para actualizar. El historial guarda parámetros, no el contenido de los resultados. Las pruebas nunca se registran en el historial de búsqueda.

MCP descubre e invoca las mismas rutas mediante las tres herramientas existentes. Allí la selección es un objeto estructurado. Consulta el contrato de comandos y el estándar de la CLI para la interfaz pública y las referencias a estándares.