# Меню и команды

`Chinabot` удобнее использовать через меню, а не через длинный список команд. Поэтому ниже только то, что реально нужно обычному пользователю.

## Главное правило

Если не знаешь, куда идти, почти всегда правильный путь такой:

`/menu` -> `Профиль` -> нижние кнопки -> `Тариф`

## Что есть в меню пользователя

| Экран           | Для чего он нужен                                                                 |
| --------------- | --------------------------------------------------------------------------------- |
| `👤 Профиль`    | уведомления, язык, фильтры, прайс, mute, watchlist, CN-only режим, режим доставки |
| `📱 Приложение` | открыть веб-кабинет на [cschinabot.com](https://cschinabot.com)                   |
| `💎 Тариф`      | текущий план, история доступа, апгрейд и оплата                                   |
| `❓ Помощь`      | краткие подсказки по боту и переход в документацию                                |
| `💬 Сообщество` | открыть пользовательский чат по ссылке, если он настроен админом                  |
| `🎁 Рефералка`  | пригласить друга и получить бонус Pro                                             |
| Нижние кнопки   | `Лента`, `Позиции`, `Горячее`, `Владельцы`, `Отчёты`, `Меню`                      |

## Нижняя панель (быстрые кнопки)

Под полем ввода всегда висит панель из шести кнопок:

| Кнопка         | Что открывает                    |
| -------------- | -------------------------------- |
| `🕒 Лента`     | последние сигналы                |
| `💼 Позиции`   | избранные предметы и точки входа |
| `🔥 Горячее`   | топ скинов по score              |
| `👥 Владельцы` | топ владельцев и owner quality   |
| `📊 Отчёты`    | периоды от `1 часа` до `30 дней` |
| `🧭 Меню`      | вернуться в главное меню         |

## Команды, которые стоит помнить

| Команда                       | Что делает                                                    |
| ----------------------------- | ------------------------------------------------------------- |
| `/start`                      | подписывает чат, запускает onboarding и открывает меню        |
| `/menu`                       | снова показывает дашборд                                      |
| `/setup`                      | открывает профиль                                             |
| `/filters`                    | открывает список твоих фильтров                               |
| `/plan`                       | показывает текущий тариф                                      |
| `/upgrade`                    | открывает экран `Тариф`                                       |
| `/daily`                      | отчёт за последние `24 часа`                                  |
| `/weekly`                     | отчёт за последние `7 дней`                                   |
| `/monthly`                    | отчёт за последние `30 дней`                                  |
| `/hot`                        | топ скинов по `speculation score`                             |
| `/skin <name>`                | история одного скина (с блоком `SteamAnalyst`)                |
| `/saprice <name>`             | агрегированная цена скина по `SteamAnalyst`                   |
| `/compare <name>`             | сравнение скина по периодам                                   |
| `/owners`                     | топ owner                                                     |
| `/watchowner <steam_id>`      | добавить owner в watchlist                                    |
| `/unwatchowner <steam_id>`    | убрать owner из watchlist                                     |
| `/watchedowners`              | показать текущий watchlist                                    |
| `/mute <name>`                | отключить сигналы по конкретному скину                        |
| `/unmute <name>`              | вернуть сигналы по скину                                      |
| `/lastsignals`                | показать последние сигналы                                    |
| `/weblogin`                   | получить код для входа в веб-кабинет                          |
| `/link <код>`                 | привязать этот Telegram к веб-аккаунту (код берётся на сайте) |
| `/linksteam` / `/linkdiscord` | привязать Steam или Discord                                   |
| `/unlink <провайдер>`         | отвязать Steam или Discord                                    |
| `/help`                       | открыть помощь                                                |
| `/stop`                       | выключить уведомления для текущего чата                       |

## Когда лучше нажимать кнопки, а не вводить команды

* Когда нужно быстро включить или выключить алерты.
* Когда нужно переключить язык.
* Когда нужно открыть отчёт без ручного ввода команды.
* Когда нужно смотреть `Ленту`, `Позиции`, `Горячее`, `Владельцев` и `Отчёты` прямо из нижней панели.
* Когда нужно быстро перейти в чат сообщества без поиска ссылки вручную.
* Когда нужно сохранить интересный предмет в `Избранное` прямо из карточки сигнала.
* Когда хочешь перейти к оплате или тарифу без лишних действий.

## Что делает кнопка `Сообщество`

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

Она нужна для быстрого перехода:

* в чат поддержки и обсуждения;
* в комьюнити по сигналам и находкам;
* в связанный discussion chat, если вокруг канала обновлений уже есть группа.

Если кнопки нет, значит ссылка на сообщество пока не настроена в конфиге бота.

## Что такое `Позиции`

`Позиции` - это быстрый путь к твоему личному списку сохранённых скинов.

Внутри этого экрана бот показывает:

* сохранённые предметы;
* цену входа, цель и стоп;
* дату добавления;
* текущие подсказки по позиции, если по этому же предмету позже придёт новый сигнал.

Если у сохранённого предмета позже появится новый сильный кейс, бот может дополнительно показать блок `💼 Моя позиция` с подсказкой `Держать / Частично фиксировать / Продавать`.

## Что открывает кнопка `Отчёты`

Экран `Отчёты` нужен не для одного фиксированного отчёта, а как точка входа в разные периоды.

Обычно там доступны кнопки периодов:

* `1ч`
* `6ч`
* `12ч`
* `1д`
* `3д`
* `7д`
* `14д`
* `30д`

Туда же вынесен и `Daily / 24ч` (это период `1д`), а также быстрые кнопки `🔥 Горячее` и `👥 Владельцы`.

Если период недоступен на твоём тарифе (например, `14д` или `30д` на `Free`), кнопка показывается с замком `🔒` и ведёт на апгрейд.

## Быстрый сценарий для нового пользователя

1. `/start`
2. Пройти короткий onboarding
3. `/setup`
4. Настроить фильтры и прайс под себя
5. Дальше пользоваться связкой `Лента` + `Позиции` + `Горячее` + `Отчёты`

## Вход на сайт из бота

Чтобы открыть веб-кабинет на [cschinabot.com](https://cschinabot.com) под тем же аккаунтом:

1. Нажми `📱 Приложение` в меню или отправь `/weblogin`.
2. Бот выдаст одноразовый код (живёт 5 минут).
3. Введи его на странице входа сайта.

Подробнее - в разделе [Сайт cschinabot.com](/cschinabot/sait-i-veb-kabinet/site.md).

## Если какой-то команды нет

Чаще всего причина одна из двух:

* функция зависит от тарифа;
* она не нужна обычному пользователю и доступна только админу (например, `/status`, `/metrics`, `/run`, `/users`, `/sastatus`).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://serbyte.gitbook.io/cschinabot/telegram-bot/menu-and-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.