From ea48a2a22f0d15e4c54639a7a12f027ac8de751b Mon Sep 17 00:00:00 2001 From: leemour Date: Thu, 15 Oct 2026 17:25:31 +0200 Subject: [PATCH] docs(search): link the search pages, phones and emails in messages - search: the chooser now points to Search efficiently; closing Search pages list - search-architecture: the connected table is replaced by a link to How things are linked - people: new section Phones and emails in messages (mentions list, mentions confirm) - what-is-indexed: link to the mentions section of How things are linked All four pages in en, ru and es. Co-Authored-By: Claude Opus 5.5 (1M context) --- content/docs/people.es.md | 11 +++++++++++ content/docs/people.md | 11 +++++++++++ content/docs/people.ru.md | 11 +++++++++++ content/docs/search-architecture.es.mdx | 6 +----- content/docs/search-architecture.mdx | 6 +----- content/docs/search-architecture.ru.mdx | 6 +----- content/docs/search.es.md | 14 ++++++++------ content/docs/search.md | 14 ++++++++------ content/docs/search.ru.md | 14 ++++++++------ content/docs/what-is-indexed.es.md | 2 +- content/docs/what-is-indexed.md | 2 +- content/docs/what-is-indexed.ru.md | 2 +- 12 files changed, 63 insertions(+), 36 deletions(-) diff --git a/content/docs/people.es.md b/content/docs/people.es.md index 2806e877..e7484406 100644 --- a/content/docs/people.es.md +++ b/content/docs/people.es.md @@ -32,6 +32,17 @@ Consulta [la misma persona en los dos mensajeros](#link-your-accounts). +## Teléfonos y correos en mensajes + +Un número de teléfono o una dirección de correo en un mensaje pertenece a alguien, pero las herramientas no adivinan a quién. Cada uno aparece como una mención y tú indicas de quién es. Sustituye `1` por un id de la lista: + +```sh +tg personal mentions list +tg personal mentions confirm 1 person:7 +``` + +`mentions confirm` registra que el valor pertenece a la persona (o a una organización con `organization:`). Después, `contacts timeline` y búsquedas como `mentions:"person:7"` incluyen esos mensajes. Un valor equivocado se descarta con `mentions reject`. Más: [Teléfonos, enlaces y nombres](./mentions.md) y [Cómo se vincula todo](./how-things-are-linked.md#menciones). + ## Pide al agente ```text prompt diff --git a/content/docs/people.md b/content/docs/people.md index 1c81a26c..571b4f49 100644 --- a/content/docs/people.md +++ b/content/docs/people.md @@ -31,6 +31,17 @@ until you **link** them: you record on your computer that both accounts belong t an overview of what they wrote includes their messages from both messengers. See [the same person in both messengers](#link-your-accounts). +## Phones and emails in messages + +A phone number or an email address in a message belongs to someone, but the tools do not guess who. They list each one as a mention, and you say whose it is. Replace `1` with an id from the list: + +```sh +tg personal mentions list +tg personal mentions confirm 1 person:7 +``` + +`mentions confirm` records that the value belongs to the person (or to an organization with `organization:`). After that, `contacts timeline` and searches such as `mentions:"person:7"` include those messages. A wrong value can be dismissed with `mentions reject`. More: [Phones, links and names](./mentions.md) and [How things are linked](./how-things-are-linked.md#mentions). + ## Ask your agent ```text prompt diff --git a/content/docs/people.ru.md b/content/docs/people.ru.md index 16c8df56..68041933 100644 --- a/content/docs/people.ru.md +++ b/content/docs/people.ru.md @@ -31,6 +31,17 @@ description: "Вспомните, кто вам написал и что вы о человеку. После этого обзор того, что он писал, включит его сообщения из обоих мессенджеров. Подробнее — в разделе [один человек в двух мессенджерах](#link-your-accounts). +## Телефоны и почта в сообщениях + +Телефон или адрес почты в сообщении кому-то принадлежит, но инструменты не угадывают кому. Они показывают каждое значение как упоминание, а вы говорите, чьё оно. Замените `1` на id из списка: + +```sh +tg personal mentions list +tg personal mentions confirm 1 person:7 +``` + +`mentions confirm` записывает, что значение принадлежит человеку (или организации через `organization:`). После этого `contacts timeline` и поиск вроде `mentions:"person:7"` включают эти сообщения. Ошибочное значение отклоняется командой `mentions reject`. Подробнее: [Телефоны, ссылки и имена](./mentions.md) и [Как всё связано](./how-things-are-linked.md#упоминания). + ## Попросите агента ```text prompt diff --git a/content/docs/search-architecture.es.mdx b/content/docs/search-architecture.es.mdx index a7670a7e..713a4c3f 100644 --- a/content/docs/search-architecture.es.mdx +++ b/content/docs/search-architecture.es.mdx @@ -9,11 +9,7 @@ Comprende por qué una búsqueda encuentra un resultado o lo omite: qué se inde ### Qué se puede buscar y conectar -| Contenido | Datos que se pueden buscar | Conexión con la fuente | -| --- | --- | --- | -| Mensajes y correo | Texto guardado, remitente, chat, fechas y metadatos de adjuntos | Una referencia identifica el proveedor, la cuenta y el mensaje | -| Notas | Texto guardado, títulos y filtros compatibles | Una referencia de nota; los enlaces guardados pueden conectarla con otros registros | -| Archivos y transcripciones de reuniones | Texto extraído o aportado, una vez guardado | El texto del adjunto sigue vinculado al mensaje; una transcripción guardada como nota se busca como nota | +Se pueden buscar mensajes, correo, notas, archivos y transcripciones de reuniones, y cada resultado conserva una referencia a su fuente. Qué registros se conectan con cuáles y quién crea cada enlace está en [Cómo se vincula todo](./how-things-are-linked.md). `search all` consulta mensajes y notas en `tg` y `max`, y mensajes, correo y notas en `memo`, y combina sus listas ordenadas. Informa de las fuentes omitidas; no convierte todos los tipos de contenido en un único índice de mensajes. Los archivos necesitan extracción de texto y las grabaciones necesitan transcripción antes de buscar su contenido. diff --git a/content/docs/search-architecture.mdx b/content/docs/search-architecture.mdx index 806e4648..bb472ba6 100644 --- a/content/docs/search-architecture.mdx +++ b/content/docs/search-architecture.mdx @@ -9,11 +9,7 @@ Understand why a search finds a result or misses it: what gets indexed, how matc ### What can be searched and connected -| Content | Searchable data | Connection to the source | -| --- | --- | --- | -| Messages and email | Saved text, sender, chat, dates and attachment metadata | A reference identifies the provider, account and message | -| Notes | Saved note text, titles and supported filters | A note reference; stored links can connect notes to other records | -| Files and meeting transcripts | Extracted or supplied text, once saved | Attachment text stays linked to its message; a transcript saved as a note is searched as a note | +Messages, email, notes, files and meeting transcripts are searchable, and each result keeps a reference to its source. Which records connect to which, and who creates each link, is on [How things are linked](./how-things-are-linked.md). `search all` queries messages and notes in `tg` and `max`, and messages, email and notes in `memo`, then merges their ranked lists. It reports sources it skipped; it does not turn every content type into one message index. Files need text extraction, and recordings need transcription before their contents can be searched. diff --git a/content/docs/search-architecture.ru.mdx b/content/docs/search-architecture.ru.mdx index 6ecadab4..e16e61ae 100644 --- a/content/docs/search-architecture.ru.mdx +++ b/content/docs/search-architecture.ru.mdx @@ -9,11 +9,7 @@ description: "Техническая сторона поиска: сохранё ### Что можно искать и связывать -| Данные | Что доступно для поиска | Связь с источником | -| --- | --- | --- | -| Сообщения и почта | Сохранённый текст, отправитель, чат, даты и метаданные вложений | Адрес указывает провайдера, аккаунт и сообщение | -| Заметки | Сохранённый текст, заголовки и поддерживаемые фильтры | Адрес заметки; сохранённые ссылки могут связывать её с другими записями | -| Файлы и расшифровки встреч | Извлечённый или предоставленный текст после сохранения | Текст вложения связан с сообщением; расшифровка, сохранённая как заметка, ищется среди заметок | +Искать можно сообщения, почту, заметки, файлы и расшифровки встреч, и каждый результат хранит адрес своего источника. Какие записи с какими связаны и кто создаёт каждую связь, описано в [Как всё связано](./how-things-are-linked.md). `search all` ищет в сообщениях и заметках в `tg` и `max`, а в `memo` — ещё и в почте, затем объединяет упорядоченные списки. Он сообщает о пропущенных источниках, а не превращает все данные в один индекс сообщений. Чтобы искать содержимое файлов, сначала нужно извлечь текст; записи нужно расшифровать. diff --git a/content/docs/search.es.md b/content/docs/search.es.md index f379b896..933d6fb5 100644 --- a/content/docs/search.es.md +++ b/content/docs/search.es.md @@ -120,12 +120,7 @@ También puedes filtrar por persona, fecha o adjuntos. Las guías de ## Qué búsqueda elegir -- **Recuerdas palabras:** busca mensajes, el primer paso más sencillo. -- **Recuerdas el tema:** busca discusiones por significado. -- **Encontraste un mensaje:** lee el contexto o conversación. -- **Quieres un recuento:** usa estadísticas en vez de leer cada resultado. - -[Búsqueda por temas de Telegram](./tg/topic-search.md) · [MAX](./max/topic-search.md) +Palabras, un tema, una persona, una imagen, una decisión o un archivo de Drive tienen cada uno su comando: [Busca con eficacia](./search-efficiently.md#elige-el-comando). ## Si falta un resultado @@ -143,3 +138,10 @@ Usa el [buscador de muestra](./search-playground.mdx) con mensajes integrados. N Aprende filtros y operadores en la guía de consultas de [Telegram](./tg/query-language.md) o [MAX](./max/query-language.md). [Cómo funciona la búsqueda](./search-architecture.mdx) explica la indexación, las conversaciones y el orden de los resultados. + +## Páginas de búsqueda + +- [Qué se indexa](./what-is-indexed.md): qué se puede encontrar y qué necesita cada tipo de contenido. +- [Cómo se vincula todo](./how-things-are-linked.md): cómo se conectan mensajes, personas, archivos, notas y tareas. +- [Busca con eficacia](./search-efficiently.md): elegir el comando, acotar, paginar y reducir la salida. +- [Prueba la búsqueda de mensajes](./search-playground.mdx): prueba la búsqueda con mensajes incluidos. diff --git a/content/docs/search.md b/content/docs/search.md index 6eab80be..359ec4a1 100644 --- a/content/docs/search.md +++ b/content/docs/search.md @@ -121,12 +121,7 @@ You can also filter by person, date or attachments. The [Telegram](./tg/search.m ## Which search should I choose? -- **You remember words:** search messages. It is the quickest starting point. -- **You remember the subject:** use topic search to find related discussions by meaning. -- **You already found a message:** ask for its context or conversation to understand the exchange. -- **You need a count:** use statistics instead of reading every result. - -[Telegram topic search](./tg/topic-search.md) · [MAX topic search](./max/topic-search.md) +Words, a subject, a person, a picture, a decision or a Drive file each have their own command: [Search efficiently](./search-efficiently.md#choose-the-command). ## If a result is missing @@ -144,3 +139,10 @@ Use the [search playground](./search-playground.mdx) with built-in messages. It Learn filters and operators in the [Telegram query guide](./tg/query-language.md) or [MAX query guide](./max/query-language.md). [How search works](./search-architecture.mdx) explains indexing, conversations and ranking after the practical guides. + +## Search pages + +- [What gets indexed](./what-is-indexed.md): what can be found and what each kind of content needs. +- [How things are linked](./how-things-are-linked.md): how messages, people, files, notes and tasks connect. +- [Search efficiently](./search-efficiently.md): choose the command, narrow, page and trim the output. +- [Search playground](./search-playground.mdx): try search on built-in messages. diff --git a/content/docs/search.ru.md b/content/docs/search.ru.md index 103ef382..16f3f805 100644 --- a/content/docs/search.ru.md +++ b/content/docs/search.ru.md @@ -121,12 +121,7 @@ max personal search messages 'счёт chat:"Проект"' ## Какой поиск выбрать? -- **Помните слова:** поиск сообщений — самый простой первый шаг. -- **Помните тему:** поиск по смыслу находит связанные обсуждения. -- **Уже нашли сообщение:** прочитайте контекст или весь разговор. -- **Нужно количество:** используйте статистику вместо чтения каждого результата. - -[Поиск по темам Telegram](./tg/topic-search.md) · [MAX](./max/topic-search.md) +Слова, тема, человек, картинка, решение или файл Drive имеют каждый свою команду: [Ищите эффективно](./search-efficiently.md#выберите-команду). ## Если результат не найден @@ -143,3 +138,10 @@ max personal search messages 'счёт chat:"Проект"' Фильтры и операторы — в языке запросов [Telegram](./tg/query-language.md) и [MAX](./max/query-language.md). [Как устроен поиск](./search-architecture.mdx) объясняет индексы, разговоры и порядок результатов. + +## Страницы о поиске + +- [Что попадает в поиск](./what-is-indexed.md): что можно найти и что нужно для каждого вида данных. +- [Как всё связано](./how-things-are-linked.md): как связаны сообщения, люди, файлы, заметки и задачи. +- [Ищите эффективно](./search-efficiently.md): выбрать команду, сузить поиск, листать и сократить вывод. +- [Попробуйте поиск сообщений](./search-playground.mdx): поиск по встроенным сообщениям. diff --git a/content/docs/what-is-indexed.es.md b/content/docs/what-is-indexed.es.md index a68b4c9e..63864bf9 100644 --- a/content/docs/what-is-indexed.es.md +++ b/content/docs/what-is-indexed.es.md @@ -98,7 +98,7 @@ tg personal search messages 'email:"ana@example.com"' tg personal search messages 'domain:example.com' ``` -`phone:` encuentra igual `+1 555 010 0100` y `+1 (555) 010-0100`; sin `+`, solo se reconocen números rusos. `domain:` encuentra todos los enlaces y direcciones de ese sitio. Las menciones se encuentran con reglas, sin modelo. Una mención que rechazas sigue descartada. Cómo revisar menciones y registrar quién es: [Teléfonos, enlaces y nombres](./mentions.md). +`phone:` encuentra igual `+1 555 010 0100` y `+1 (555) 010-0100`; sin `+`, solo se reconocen números rusos. `domain:` encuentra todos los enlaces y direcciones de ese sitio. Las menciones se encuentran con reglas, sin modelo. Una mención que rechazas sigue descartada. Cómo revisar menciones y registrar quién es: [Teléfonos, enlaces y nombres](./mentions.md). Cómo se conectan las menciones con personas y organizaciones: [Cómo se vincula todo](./how-things-are-linked.md#menciones). ## Imágenes diff --git a/content/docs/what-is-indexed.md b/content/docs/what-is-indexed.md index 74edb3e1..6250a802 100644 --- a/content/docs/what-is-indexed.md +++ b/content/docs/what-is-indexed.md @@ -98,7 +98,7 @@ tg personal search messages 'email:"ana@example.com"' tg personal search messages 'domain:example.com' ``` -`phone:` finds `+1 555 010 0100` and `+1 (555) 010-0100` alike; without the `+`, only Russian numbers are recognized. `domain:` finds every link and address on that site. Mentions are found by rules, not by a model. A mention you reject stays dismissed. How to review mentions and record who they are: [Phones, links and names](./mentions.md). +`phone:` finds `+1 555 010 0100` and `+1 (555) 010-0100` alike; without the `+`, only Russian numbers are recognized. `domain:` finds every link and address on that site. Mentions are found by rules, not by a model. A mention you reject stays dismissed. How to review mentions and record who they are: [Phones, links and names](./mentions.md). How mentions connect to people and organizations: [How things are linked](./how-things-are-linked.md#mentions). ## Pictures diff --git a/content/docs/what-is-indexed.ru.md b/content/docs/what-is-indexed.ru.md index 14a9aa90..d5ec4ea7 100644 --- a/content/docs/what-is-indexed.ru.md +++ b/content/docs/what-is-indexed.ru.md @@ -98,7 +98,7 @@ tg personal search messages 'email:"ana@example.com"' tg personal search messages 'domain:example.com' ``` -`phone:` находит `+1 555 010 0100` и `+1 (555) 010-0100` одинаково; без `+` распознаются только российские номера. `domain:` находит все ссылки и адреса этого сайта. Упоминания ищутся по правилам, без модели. Отклонённое упоминание остаётся отклонённым. Как разбирать упоминания и отмечать, кто это: [Телефоны, ссылки и имена](./mentions.md). +`phone:` находит `+1 555 010 0100` и `+1 (555) 010-0100` одинаково; без `+` распознаются только российские номера. `domain:` находит все ссылки и адреса этого сайта. Упоминания ищутся по правилам, без модели. Отклонённое упоминание остаётся отклонённым. Как разбирать упоминания и отмечать, кто это: [Телефоны, ссылки и имена](./mentions.md). Как упоминания связаны с людьми и организациями: [Как всё связано](./how-things-are-linked.md#упоминания). ## Картинки