# Telegram: Администрирование (/ru/docs/tg/groups)

Посмотрите состав, настройки и состояние своей группы, затем выберите действие администратора. Здесь можно проверить права, найти вопросы и подозрительные аккаунты, подготовить изменения. Начните с отчёта; изменение настроек или удаление участников требует отдельного решения.

[Личный аккаунт](/llms.mdx/docs/ru/tg/usage/content.md) · [Боты](/llms.mdx/docs/ru/tg/bot/content.md) · [Администрирование](/llms.mdx/docs/ru/tg/groups/content.md)

## Проверить группу и свои права

```text prompt
Используй tg CLI. В группе «Клуб» покажи описание, участников, администраторов и мои права. Какие настройки я могу менять? Ничего не меняй.
```

Вы получите карточку группы и список доступных действий. Участие в группе не всегда даёт права администратора; агент должен проверить их до изменений.

[Отчёты о группе и участниках](/llms.mdx/docs/ru/tg/rankings/content.md)

## Подготовить план наведения порядка

```text prompt
Используй tg CLI. Проверь группу «Клуб»: вопросы без ответа, новые участники и признаки спама. Предложи, кому помочь и какие сообщения проверить. Не удаляй сообщения, не блокируй людей и не меняй настройки.
```

Получите план с конкретными сообщениями и причинами. Затем можно выбрать отдельное действие: ответить, проверить аккаунт, изменить описание или правила доступа. Команды управления приведены ниже.

[Антибот и другие отчёты](/llms.mdx/docs/ru/tg/rankings/content.md#task-antibot)

## Команды и инструкции

Используйте эту страницу, если вы являетесь администратором группы Telegram и вам нужна помощь в поддержании порядка. Вы научитесь находить вопросы, на которые никто не ответил, видеть, кто присоединился и кто их добавил, подводить итоги недели, удалять спам по своим правилам и вести историю списка участников. Чтение не отмечает сообщения прочитанными, поэтому проверка группы не сообщает ее членам, что вы ее просматривали.

Здесь все работает из личного аккаунта, в группах, где вы являетесь администратором. Несколько слов на этой странице:

- **Администратор** – это участник с правами управления группой. Некоторые команды учитывают только ваши ответы и ответы администраторов.
- **Локальное хранилище** — это копии сообщений, которые `tg` хранит на этом компьютере. Отчеты и задачи используют его, поэтому видят только то, что было скачано.
- **Задача** — то, что ждёт вашего действия, например вопрос, на который никто не ответил. `tg` открывает и закрывает задачи в локальном хранилище.
- **Правила** определяют, что ищет `tg personal chats moderate`, например ссылки или флуд, и что он может делать.
- **Снимок состава** — это список участников, сохраненный за один день. Снимки с течением времени показывают, кто присоединился, а кто ушел.

## Что можно сделать [#что-можно-сделать]

| Задача | Команда |
| --- | --- |
| Найдите вопросы, которые ждут ответа | `tg personal review --unanswered` |
| Посмотрите, кто присоединился, вышел, был добавлен или удален | `tg personal chats events` |
| Итоги недели: решения, обещания, открытые вопросы | `tg personal review 'date>7d'` |
| Держите список того, что вас ждет | `tg personal tasks list` |
| Удалить спам по своим правилам | `tg personal chats rules set`, `tg personal chats moderate` |
| Заменить утекшую ссылку-приглашение | `tg personal chats links reset` |
| Одобряйте или отклоняйте запросы на вступление | `tg personal chats requests list\|confirm\|reject` |
| Посмотрите активность за неделю и собственную статистику Telegram | `tg personal stats chats show`, `tg personal stats chats official` |
| Сохраняйте список участников каждый день | `tg personal chats members fetch --track` |
| Найдите участников, похожих на ботов или спамеров | `tg personal chats members check` |

Полный список групповых команд находится [ниже](#what-there-is). Подробности о каждой команде приведены в [группах и каналах в руководстве по использованию](/llms.mdx/docs/ru/tg/usage/content.md#groups-and-channels); каждая опция находится в [справке по командам](/llms.mdx/docs/ru/tg/commands/content.md).

## С агентом [#с-агентом]

Ваш ИИ-агент (например, Claude Code, Codex, Cursor или Gemini CLI) может выполнить эти проверки за вас. Агенту с терминалом необходим [skill tg](/llms.mdx/docs/ru/tg/recipes/content.md#once-first); агенту в приложении без терминала необходим [сервер MCP](/llms.mdx/docs/ru/tg/mcp/content.md). Ниже: что вы говорите, что запускает агент и что вы получаете взамен.

Имена, сообщения и результаты, приведенные ниже, являются вымышленными. Команды отделены от ответа: агент читает данные и представляет их вам.

### Утро админа: кто ждёт ответа [#утро-админа-кто-ждёт-ответа]

Начните с вопросов, которые давно ждут вас или админов.

**Ваш запрос:**

> Что в «Hiking» осталось без ответа больше четырёх часов?

**Команда:**

```sh
tg personal review 'chat:Hiking' --unanswered 4h --json
```

**Пример ответа агента:**

> **3 вопроса ждут ответа.**
>
> | Участник | Вопрос | Ожидание |
> | --- | --- | --- |
> | Лена | Во сколько выезд в субботу? | 6 часов |
> | Артём | Палатки общие? | 12 часов |
> | Ира | Кто возьмёт котелок? | 15 часов |
>
> Откройте вопрос, чтобы проверить переписку вокруг него.

Это правила `review`: вопросом считается «?» вне ссылки или ответ вам/админу. Прямой ответ либо следующая реплика вас/админа может закрыть вопрос. [Статистический отчёт](/llms.mdx/docs/ru/tg/rankings/content.md) считает только связанные прямые ответы и может дать другой результат.

### Новенькие за неделю [#новенькие-за-неделю]

Посмотрите события вступления; возраст аккаунта — повод проверить человека, а не доказательство спама.

**Ваш запрос:**

> Кто вступил в «Hiking» за неделю? Покажи, кого стоит проверить.

**Команда:**

```sh
tg personal chats events "Hiking" 'time>=7d' --json
```

**Пример ответа агента:**

> | Новичок | Как появился |
> | --- | --- |
> | Катя | Добавлена Леной |
> | Олег | Вступил сам |
>
> Для проверки Олега откройте доступные сведения о нём. Только по возрасту аккаунта удалять нельзя.

События показывают только доступную историю. Текущий список участников можно проверить отдельно.

### Если приглашение стало публичным [#если-приглашение-стало-публичным]

Замените ссылку-приглашение, если вы попросили об этом.

**Ваш запрос:**

> Ссылка Hiking попала посторонним. Замени её и разреши добавлять людей только админам.

**Заменить ссылку:**

```sh
tg personal chats links reset "Hiking" --json
```

**Ограничить добавление участников:**

```sh
tg personal chats update "Hiking" --only-admins-add on --json
```

**Пример ответа агента:**

> | Настройка | Результат |
> | --- | --- |
> | Старая ссылка | Заменена |
> | Добавление участников | Только админы |
>
> Новая ссылка находится в запрошенном результате; передайте её только нужным людям.

Эти команды изменяют группу. Запрос в примере разрешает оба изменения.

### Удаление спама с вашего согласия [#удаление-спама-с-вашего-согласия]

Сначала посмотрите, что предполагают правила, без каких-либо действий.

**Ваш запрос:**

> Проверьте Поход на спам. Пока ничего не удаляйте; покажи предложения.

**Команда:**

```sh
tg personal chats moderate "Hiking" --dry-run --json
```

**Пример ответа агента:**

> **Предложение:** удалить сообщение со ссылкой-приглашением.
>
> | Найдено | Предложение | Статус |
> | --- | --- | --- |
> | Ссылка-приглашение | Удалить сообщение | Только предпросмотр |
>
> Ничего не удалено. Подтвердите точное сообщение, если хотите выполнить действие.

Для реальных действий нужен ваш запрос и разрешения профиля. Предварительный просмотр не дает разрешения на удаление.

### Недельный отчёт по группе [#недельный-отчёт-по-группе]

Попросите короткий итог: решения, обязательства и открытые вопросы.

**Ваш запрос:**

> Сделай итог недели по «Hiking».

**Команда:**

```sh
tg personal review 'chat:Hiking date>7d' --json
```

**Пример ответа агента:**

> **Решили:** выезд в 7:00 от станции.
>
> **Взяли на себя:**
>
> - Лена — продукты.
> - Артём — палатки.
>
> **Открыто:** кто возьмёт котелок.
>
> Покажу исходные сообщения, если нужно проверить итог.

### Проверка по расписанию [#проверка-по-расписанию]

Для списка открытых вопросов агент не нужен: это обычная команда.

```cron
0 9,21 * * * tg personal review 'chat:Hiking' --unanswered --json >> ~/hiking-open.jsonl 2>> ~/tg-cron.log
```

cron не имеет терминала и часто не имеет `XDG_RUNTIME_DIR`, без которого `tg` не может получить доступ к связке ключей: см. [работа по расписанию](/llms.mdx/docs/ru/tg/recipes/content.md#running-on-a-schedule).

## Доступные команды [#доступные-команды]

| Команда | Что он делает |
|---|---|
| `tg personal review 'chat:"<chat>"' --unanswered [duration]` | вопросы, на которые вы и админы так долго не отвечали — `4h`, `1d`; 24 часа по умолчанию |
| `tg personal chats events <chat>` | кто присоединился, вышел, был добавлен или удален и кем; 7 дней по умолчанию |
| `tg personal chats members list <chat>` | всех в группе, с их ролью и когда их видели в последний раз |
| `tg personal topics list <chat>`, `tg personal search topics <chat> <text>` | темы группы форума; поиск находит их по названию |
| `tg personal topics show <chat> <id>` | одна тема: заголовок, закрыта или закреплена, количество непрочитанных, последняя активность |
| `tg personal topics enable <chat>` | включить форум; базовая группа требует `--upgrade --yes` и возвращает новый идентификатор чата |
| `tg personal topics create <chat> <title>` | создать тему; после неизвестного результата проверьте `topics list` вместо повторения |
| `tg personal topics edit <chat> <id> --emoji <emoji>` | задать теме значок из `topics icons list`; `--emoji none` убирает его; `topics create` тоже принимает `--emoji` |
| `tg personal messages send <chat> <text> --topic <id>`, `tg personal polls create <chat> <question> <answers> --topic <id>` | отправить сообщение или провести опрос в теме форума |
| `tg personal messages forward <chat> <message> --to <forum> --topic <id>` | переслать сообщение в тему форума `--to` |
| `tg personal chats inspect <link>` | куда ведет приглашение или публичная ссылка; никуда не вступает |
| `tg personal chats create <title> [person...]` | новая группа (супергруппа) или канал с `--channel` |
| `tg personal chats join <link>`, `tg personal chats leave <chat>` | присоединиться по ссылке, выйти |
| `tg personal chats update <chat>` | заголовок, описание и возможность участников закреплять (`--all-can-pin`) или добавлять людей (`--only-admins-add`) |
| `tg personal chats members add\|remove <chat> <person...>` | добавлять людей (им сообщают; имена тех, кого не удалось добавить, называют) или удалять их (сообщения остаются) |
| `tg personal chats admins add <chat> <person> --can <rights>` | сделать участника администратором со следующими правами: участники, администраторы, информация, закрепление, ссылка, публикация, редактирование, удаление |
| `tg personal chats admins remove <chat> <person>` | снять права администратора; человек остаётся участником |
| `tg personal chats links update <chat> <link> --approval --expire-time <time>`, `tg personal chats links update <chat> <link> --no-approval --max-uses <n>` | изменить только предоставленное разрешение, срок действия или лимит использования вашей дополнительной ссылки-приглашения; предоставить хотя бы одно изменение |
| `tg personal chats links show\|reset <chat>` | ссылка-приглашение; `reset` делает новый, а старый перестает работать |
| `tg personal chats requests list\|confirm\|reject <chat>` | запросы на вступление в группу, требующую одобрения администратора: кто просил, впустите, отвергните; `--all` отвечает на каждый запрос |
| `tg personal chats rules show\|set\|unset <chat>` | правила группы |
| `tg personal chats moderate <chat>` | проверить группу по ее правилам; делает то, что позволяют правила |
| `tg personal messages delete --for-everyone`, `pin`, `unpin` | удалить для всех, закрепить |

Включить темы может только владелец группы. Существующей супергруппе обновление не нужно. После
обновления обычной группы у неё появляется новый идентификатор чата; локальное хранилище сохраняет
старые сообщения под прежним идентификатором и не объединяет две истории.

В теме форума текст, подписи к фото и файлам и запланированные отправки остаются в этой теме, а явный
ответ должен относиться к той же теме. Закрытая или отсутствующая тема отклоняется до того, как что-либо
отправлено. Если результат отправки неизвестен, повторите её с тем же `--operation-id`, чатом и темой; для
запланированной отправки вместо повтора проверьте `tg personal messages scheduled <chat>`.

Агент, подключенный через [MCP-сервер](/llms.mdx/docs/ru/tg/mcp/content.md), может выполнять те же команды, насколько это позволяют разрешения профиля.

`create`, `join`, `leave`, `update`, `link reset`, `members` и `admins` меняют то, что видят участники группы: новая группа сообщает добавленным людям, а в чате отображается сообщение о присоединении или выходе. Каждый из них проходит через разрешения профиля и защиту отправки, и каждый добавленный человек учитывается в почасовом лимите (см. [Защита отправки](/llms.mdx/docs/ru/tg/security/content.md#the-send-guard)).

## Что ждёт вашего действия [#что-ждёт-вашего-действия]

`review` и `serve` хранят список задач в локальном хранилище: что должны сделать вы и что кто-то должен вам. Задача указывает на своё сообщение и никогда не копирует его. Где правило открывает задачу:

- **Личный чат:** вопрос, на который вы не ответили, и сообщение, где вас упомянули.
- **Группа:** только вопрос, который отвечает на ваше сообщение, и упоминание вас. Вопросы других людей — не ваши задачи.
- **Канал или «Избранное»:** ничего.

Ваш ответ закрывает задачу. Чтобы записывать каждый вопрос в группе, кому бы он ни был адресован, поставьте группе тег:

```sh
tg personal tags add --chat <group> watch-tasks
tg personal tags remove --chat <group> watch-tasks
```

В группе с этим тегом каждый вопрос, на который вы не ответили, открывает задачу — сообщение со знаком вопроса или ответ на ваше сообщение. Учитываются только новые сообщения; для старых используйте `tasks scan`. Просьба или обещание без знака вопроса — не задача правила: её добавляет ваш агент через `tasks add`. Вопрос закрывает ваш ответ, а также ответ на него от любого участника, кроме того, кто спросил. Более позднее сообщение, которое не отвечает на вопрос, ничего не закрывает; такую задачу закрываете вы или ваш агент. Ставьте тег только группам, где отвечать должны вы.

Первая синхронизация аккаунта не открывает задач из вашей истории; следующие синхронизации открывают задачи из новых сообщений. Чтобы превратить историю чата в задачи, посмотрите, что откроется, а затем откройте:

```sh
tg personal tasks scan <chat>
tg personal tasks scan <chat> --last 300 --yes
```

`config set task_first_pass_per_chat <n>` позволяет первой синхронизации открыть до n задач на чат.

Когда кто-то что-то вам обещает, сохраните это как его задачу и посмотрите, что вам должны другие:

```sh
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other --assignee sender
tg personal tasks list "assignee:any state:open"
```

`--assignee sender` — тот, кто отправил сообщение; `--assignee person:<id>` называет другого человека, а `tasks update <task> --assignee none` убирает исполнителя. Задача без исполнителя — это нормально: лучше, чем пропущенная.

Посмотрите, что вас ждет, сначала самые старые, потом только вопросы и упоминания в одной группе:

```sh
tg personal tasks list state:open
```

```sh
tg personal tasks list chat:<chat id> "(kind:question OR kind:mention)"
```

Добавьте то, что не видят правила, например данное вами обещание, или закройте задачу, не требующую ответа:

```sh
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other
```

`tasks categories` показывает категории, которые может получить задача. Чтобы изменить список, измените раздел `task_categories` в `~/.config/WireCat/config.json`. Это общий файл настроек инструментов WireCat, а не файл одного профиля. В нём только ваши изменения списка по умолчанию: имя со смыслом и словами-признаками добавляет или заменяет категорию, а `null` убирает категорию из списка по умолчанию:

```json
{
  "task_categories": {
    "garden": "plants | seedling, es:planta",
    "religion": null
  }
}
```

`config set task_categories.garden "plants | seedling"` и `config unset task_categories.garden` пишут в тот же файл и сохраняют его другие разделы; `config unset task_categories` возвращает список по умолчанию. Хранилище, перенесённое через `MESSAGING_STORE`, читает `config.json` рядом с собой.

Если задача может совпадать с открытой, `tasks add` отклоняет добавление с кодом 2 и показывает кандидатов. Повторите с `--into <task>`, чтобы связать сообщение с этой задачей, либо с `--new`, чтобы создать отдельную. Если она совпадает только с задачей, закрытой за последние 14 дней, `tasks add` открывает её как продолжение, связанное `follow-up-of` с закрытой. `tasks duplicates list` показывает найденные правилами пары, а `tasks merge <task> --into <other>` объединяет задачи:

```sh
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other --into <task>
```

```sh
tg personal tasks close <task> --as dismissed --reason no-reply-needed
```

ИИ-агент, который закрывает задачу, указывает свою уверенность через `--certainty`, от 0 до 1. Ниже порога хранилища (`task_agent_close_min`, по умолчанию 0.8) задача остаётся открытой с предложением закрыть; `config set task_agent_close off` превращает любое закрытие агентом в предложение. `tasks list close:suggested` находит их. Подтвердите предложение командой `tasks close <task>` или отклоните его командой `tasks reject <task>`:

```sh
tg personal tasks list close:suggested
```

```sh
tg personal tasks reject <task>
```

Дайте задаче название, срок и дату, когда к ней вернуться, и свяжите с ней сообщения и чаты, к которым
она относится. Дата следующей проверки — для вас или вашего агента; tg никому не напоминает:

```sh
tg personal tasks update <task> --title "Send Anna the contract" --due 2d --remind-time 1d
```

```sh
tg personal tasks link <task> msg:telegram/<you>/<chat>/<message> --chat "Hiking"
```

Посмотрите, что требует внимания сегодня: просроченные задачи и задачи с близким сроком, чаты, где
кто-то ждёт вашего ответа, и чаты, где вы ждёте ответа от других. Команда читает локальное хранилище,
а не текст сообщений:

```sh
tg personal tasks agenda
```

`tasks agenda` и `tasks duplicates list` принимают поля запроса:

- `tag:` и `category:` оставляют задачи с этой меткой или категорией: `tag:urgent`, `category:money`.
- `claimed:` говорит, кто взял задачу: `none`, `mine`, `others` или `any`. Без него в списке дел видны задачи,
  которые никто не взял, и ваши; `claimed:any` показывает все.
- `decision:` выбирает пары дублей: `review` (по умолчанию) ждут проверяющего агента, а
  `unsure` ждут вас: `decision:unsure`.

```sh
tg personal tasks agenda category:money tag:urgent claimed:any
```

```sh
tg personal tasks duplicates list decision:unsure
```

`tg skill show follow-ups` выводит ежедневный порядок работы для ИИ-агента: он готовит черновики
ответов по этому списку и ничего не отправляет.

Посмотрите открытые задачи для каждого чата, самую старую и среднее время закрытия:

```sh
tg personal stats tasks show
```

Закрытая задача остается закрытой, а отклоненная никогда не возвращается. Только ваши собственные ответы закрывают задачу, ответы других администраторов — нет, и упоминания через `@username` не учитываются. Агент, подключенный через MCP, получает те же команды.

## Правила [#правила]

В правилах группы говорится, что ищет `tg personal chats moderate` и что он может с этим делать. Они живут в файле этого профиля, никогда в Telegram, и за группой в фоновом режиме ничего не следит: правило действует только при запуске `chats moderate`.

Покажите правила. До вашего первого изменения они являются значениями по умолчанию и помечены как несохраненные:

```sh
tg personal chats rules show "Hiking"
```

Удалить сообщение, в котором есть ссылка:

```sh
tg personal chats rules set "Hiking" links delete
```

Заблокировать этих людей по идентификатору…

```sh
tg personal chats rules set "Hiking" blocked 12345,67890
```

…и удалять их, когда они пишут или присоединяются:

```sh
tg personal chats rules set "Hiking" blockedPeople remove
```

Удалить без предварительного запроса:

```sh
tg personal chats rules set "Hiking" consent.delete allow
```

Посмотрите, что будет делать проверка, не выполняя ее:

```sh
tg personal chats moderate "Hiking" --dry-run
```

Проверьте, что нового появилось с момента последнего запуска, и действуйте:

```sh
tg personal chats moderate "Hiking"
```

| Правило | По умолчанию | Что он ищет |
|---|---|---|
| `links`, `invites`, `forwards` | `report` | сообщение со ссылкой, ссылка-приглашение в другую группу, пересылаемое сообщение |
| `blocked`, `blockedNames` | — | люди по идентификатору или части имени, разделенной запятой |
| `blockedPeople` | `report` | что делать с сообщением или присоединением заблокированного человека |
| `flood.messages`, `flood.minutes`, `flood.action` | 5, 1, `report` | больше, чем столько-то сообщений от одного человека за столько-то минут |
| `trusted` | — | люди, к которым правила никогда не применяют действия; администраторы группы и вы тоже исключены |
| `consent.delete`, `consent.remove` | `ask` | насколько далеко вы разрешаете каждое действие |

Действие каждого правила — `report`, `delete` или `remove`. Произойдет ли `delete` или `remove`, зависит от уровня группы, `consent.delete` и `consent.remove`: `deny` никогда, `readonly` только сообщает, `ask` спрашивает вас о каждом из них (по умолчанию; `--allow-dangerous` говорит да всем), `allow` делает это. Каждое действие по-прежнему проходит через защиту отправки и часовой лимит, а выполнение останавливается после `--max-actions` (10). Следующий запуск начинается с того места, где остановился этот; `--since-time` смотрит на ваш собственный период и не сдвигает сохранённую точку отсчёта.

Агент, подключенный через MCP, действует только там, где уровень равен `allow`; действия с запросом подтверждения перечисляются для вас и не выполняются. `newAccount` не предлагается: Telegram не сообщает, сколько лет аккаунту.

## С ботом [#с-ботом]

Если ваш бот является администратором группы, он может выполнить ту же проверку: `tg <bot> bot chats moderate`. Человек, которого удалит бот, не сможет вернуться по ссылке, если вы не добавите `--no-block`. Бот оценивает только сообщения, которые он видел или импортировал на этом компьютере, и не проверяет вступления. См. [модерирование группы с помощью бота](/llms.mdx/docs/ru/tg/bot/content.md#moderating-a-group-by-its-rules).

## Ограничения [#ограничения]

- **История Telegram — источник событий.** `chats events` и `review` показывают, что еще хранится в истории чата; служебное сообщение, удаленное администратором, для них тоже пропало.
- **Админы известны только там, где говорит Telegram.** Без них `review --unanswered` засчитывает только ваши ответы и так и говорит.
- **Ничто не наблюдает за группой само по себе.** Проверка запускается, когда вы, агент по вашему запросу или по вашему расписанию запускаете ее.
- **Применяются ограничения скорости Telegram.** Чтение каждого члена большой группы требует большого количества запросов; ответ `FLOOD_WAIT` говорит, как долго ждать (см. [когда Telegram просит подождать](/llms.mdx/docs/ru/tg/troubleshooting/content.md#telegram-asks-to-wait-n-s-before-the-next-request)).

## Статистика для администраторов групп [#статистика-для-администраторов-групп]

Посмотрите сообщения, участников переписки и ответы за неделю. Чтобы узнать, кто отвечает, кому нужна помощь и остаются ли новички, откройте [Статистику](/llms.mdx/docs/ru/tg/rankings/content.md).

**Ваш запрос:**

> Покажи активность Hiking за неделю и пробелы в истории.

**Команда:**

```sh
tg personal stats chats show "Hiking" --since-time 7d --offline --json
```

**Пример ответа агента:**

> | Показатель | В доступной истории |
> | --- | ---: |
> | Сообщения | 120 |
> | Участники переписки | 18 |
> | Ответы | 30 |
>
> История неполная: это наблюдаемые значения. Этот локальный запрос не загружал события вступления и выхода.

Без `--offline` CLI также загружает события вступления и выхода. Сохранённые ежедневные наблюдения остаются доступны локально. Первый отчёт не может восстановить прошлые списки участников.

### Статистика самого Telegram [#статистика-самого-telegram]

```sh
tg personal stats chats official <chat> --json
```

Telegram рассчитывает статистику для администраторов достаточно крупных супергрупп и каналов — ту же, что на экране «Статистика» в приложениях. `tg personal stats chats official` запрашивает её и выводит один объект JSON. Период выбирает Telegram; он указан в `period`. Каждый итог сопровождается значением за предыдущий период.

- У супергруппы (`kind: "group"`) есть участники, сообщения, читатели и авторы, самые активные авторы, администраторы и приглашающие, а также 8 графиков: рост, участники, новые участники по источнику, языки, сообщения, действия, часы и дни недели.
- У канала (`kind: "channel"`) есть подписчики, просмотры, пересылки и реакции на пост и историю, число подписчиков с включёнными уведомлениями, последние посты со счётчиками и 12 графиков.

Каждый график — список рядов по значениям `x`: `date` (день, `YYYY-MM-DD`), `time` (ISO 8601) или `number`. Если Telegram не может предоставить график, он отображается как `{ "error": ... }`, а остальные графики остаются. Команда только читает: ничего не отправляет, не отмечает прочитанным и не меняет. `--jsonl` отклоняется.

Telegram отвечает только для чата, в котором показывает вам статистику. В обычной группе, чате, где вы не администратор, или слишком маленьком чате команда завершается ошибкой прав или проверки параметров. Один запуск требует примерно 10–17 запросов: карточка чата, статистика и каждый график, который Telegram отдаёт позже. Укажите чат по `@username` или ID: название сначала ищется в вашем списке чатов, что добавляет запрос на каждые 100 чатов. Telegram хранит статистику на отдельном сервере, поэтому первый запуск добавляет ключ входа для него в файл сессии; ключ никогда не выводится.

### Снимки состава и изменения [#снимки-состава-и-изменения]

`tg personal chats members fetch` читает участников в локальное хранилище, записывая профили, изменения, число участников за день и полноту чтения. `--max-pages` ограничивает число страниц. Частичное чтение никого не отмечает как вышедшего: для этого нужно прочитать весь доступный список и знать численность группы, не превышающую число прочитанных участников. Больший бюджет не позволяет обойти ограничения Telegram на список участников.

`--track` добавляет группу в список отслеживания. `chats tracking list` показывает все отслеживаемые группы; `show` — состояние отслеживания одной группы и ежедневные числа за последние 30 дней. `add` начинает отслеживание без немедленной загрузки; `remove` прекращает ежедневную загрузку и сохраняет записанную историю. Пока работает `tg personal serve`, он загружает отслеживаемые группы по одной, начиная первый обход через минуту после подключения, и пропускает уже загруженные в текущий день UTC. Отслеживание не запускает `serve`; если сервер был остановлен несколько дней, следующий запуск создаёт новый снимок, а не заполняет пропущенные дни.

`tg personal chats members history` показывает записанные вступления, выходы и изменения профилей от старых к новым; период ограничивает запрос, например `time>=7d`. Команда никогда не обращается к Telegram. Для вступления используется время Telegram, если известно, иначе время первого наблюдения человека. Выход датируется первым полным снимком без человека, а не точным временем выхода. Первая загрузка записывает исходный состав: эти люди не обязательно вступили в тот день. `chats members list --offline` читает последний полностью сохранённый состав; частичное чтение его не заменяет. Без полного снимка список может быть пуст, хотя некоторые профили и события уже записаны. Профили и история остаются в локальном хранилище рядом с сообщениями.

`tg personal chats members check` перечисляет участников с признаками ботов и причинами; `--max-pages` ограничивает страницы, порог задаёт запрос, например `score>=3` (без него `score>=2`). Никого не удаляет и исключает администраторов и владельца. `meta.truncated` означает, что прочитаны не все участники. С `--offline` команда недоступна; оценки требуют проверки человеком. Telegram предоставляет сведения о bot, scam, fake, deleted, фото, вступлении и пригласившем, где они доступны. «Никогда не писал» означает, что в локальной истории сообщения не найдены, а не доказательство, что человек никогда не писал в группе.

`--deep <n>` также полностью проверяет первых n участников, по одному в секунду: профиль, самое старое фото профиля, до 1 000 сохранённых сообщений каждого и два публичных списка спама — Combot CAS и lols.bot. ID каждого участника отправляется этим спискам. Полная проверка попадает в `check` у каждого проверенного участника.

### Еженедельный отчёт для вашей группы [#еженедельный-отчёт-для-вашей-группы]

«Hiking Club» ниже — вымышленная группа для примера. Сначала загрузите её сообщения через `messages sync`, если они ещё не сохранены, затем запишите текущий состав и подготовьте отчёт:

```sh
tg personal chats members fetch "Hiking Club" --track --json
```

```sh
tg personal stats chats show "Hiking Club" --since-time 7d --by day --timezone Europe/Madrid --json
```

```sh
tg personal chats members history "Hiking Club" "time>=7d" --offline --json
```

```sh
tg personal chats tracking show "Hiking Club" --offline --json
```

```sh
tg personal chats members check "Hiking Club" --json
```

Попросите агента включить в отчёт сообщения, активных отправителей, вопросы без ответа, изменения состава и дни со снимками участников. Оставьте в отчёте видимыми записи `missing`, `meta.truncated` и промежутки между снимками. Для будущих отчётов держите `tg personal serve` запущенным или повторяйте загрузку участников; первый отчёт не может показать выходы до первого записанного состава.
