Контакт
Публичная страница контакта в профиле saas.
Контакт
Контакт сохраняет сообщение, чтобы операторы могли ответить. Это
публичная форма на SaaS-профиле (saas_public_pages). Это не живой
чат, не консоль тикетов и не форма жалобы на версию каталога.
URL и кто их видит
| Проекция | URL | Кому видно |
|---|---|---|
| Human | /{locale}/contact | всем, если флаг |
| Machine | /{locale}/ai/contact | всем, если флаг |
Иконка в шапке (клавиша C) и ссылка Контакт в подвале ведут
сюда. Self-hosted сборки компилируют saas_public_pages выключенным:
элемент исчезает, и маршрут не входит в публичную навигацию.
Отправить может кто угодно, вошедший или нет. Сессия не прикрепляется как идентичность на этой форме. Жалобы на точную версию каталога по-прежнему живут на Жалобах после входа или в действии Пожаловаться на карточке, которое заранее заполняет kind, id, version и digest.
Для чего этот экран
Контакт нужен, чтобы спросить про каталог, публикацию, provider или безопасную установку, когда у вас нет точного digest объекта.
Используйте Жалобу каталога, когда указываете на одну неизменяемую версию. GitHub issues — только если вы вносите вклад в репозиторий, не для секретов аккаунта.
Контакт не:
- сбрасывает пароль (его нет; вход — OAuth);
- сливает аккаунты;
- принимает вложения;
- заводит staff-модерационный case, за которым можно следить;
- обходит гейты публикации.
Что на экране
Две колонки на широких viewport: липкое вступление, затем карточка формы.
| Поле | Подпись | Правила |
|---|---|---|
| Имя | Имя | обязательно, max 120 |
| Email для ответа | Email для ответа | обязательно, email, max 254 |
| Тема | Тема | обязательно, max 160 |
| Сообщение | Сообщение | обязательно, min 10, max 4000 |
| Отправка | Отправить сообщение | отключена, пока pending или после успеха |
Подсказки на странице:
- Сообщение сохраняется вместе с email для ответа, который вы указываете. Не добавляйте секреты.
- Укажите публичный URL,
stable_idили точную версию, если вопрос касается объекта каталога. - Не добавляйте секреты, токены, приватные ключи и содержимое приватных репозиториев.
Тот же компонент формы можно открыть как диалог жалобы с карточки
каталога с targetKind component, setup или author. На самом
/contact цель — other / contact.
После успешного POST кнопка остаётся отключённой, и страница
показывает, что обращение принято. Лимиты частоты возвращают
Слишком много обращений. Попробуйте позже. Другие сбои:
Не удалось отправить обращение.
Переключатель Human / Machine: machine-Контакт — короткий документ с заголовком, подзаголовком и ссылкой назад. Заполняемой формы в нём нет.
Соответствующие команды CLI
У жалоб каталога есть путь CLI. У публичной формы контакта — нет.
ai-stp report preview --json
ai-stp report confirm --json
ai-stp report list --json
report preview готовит ограниченный payload, не отправляя его.
report confirm отправляет один точный preview после явного флага.
report list перечисляет ваши закрытые case (CLI после входа).
Это близнец Жалоб, не этой страницы.
Команды ai-stp contact нет. Не направляйте сообщение в
report confirm, чтобы «написать в поддержку».
Тупики
| Что видно | Что это значит | Что делать |
|---|---|---|
| Контакта нет в шапке | saas_public_pages выключен | GitHub для репозитория, CLI для жалоб на объект |
| Отправить остаётся отключённым | уже отправлено в этом виде | перезагрузите, чтобы отправить ещё одно |
| Слишком много обращений | лимит частоты | подождите; не повторяйте в цикле |
| Не удалось отправить обращение | API или валидация | проверьте формат email; уберите секреты; повторите позже |
| На этой странице нет case id | контакт — не журнал жалоб | смотрите Жалобы после входа, если подавали с карточки |
| Оператор не отвечает на секрет | вы отправили токен | ротируйте токен; не пересылайте его сюда |
Клавиша C ничего не делает | флаг выключен или фокус в поле ввода | ожидаемо на self-hosted |
Не вставляйте файлы .env, session cookies, токены provider или
приватные ключи. Подсказка про приватность — правило, не украшение.
Контакт vs Жалоба vs GitHub
| Нужно | Страница | Нужен digest? | Нужна сессия? |
|---|---|---|---|
| Вопрос о продукте | эта страница | нет | нет |
| Эта точная версия вредна | Жалобы | да | да |
| Пожаловаться с карточки каталога | заранее заполненные Жалобы | да | да |
| Патч в репозиторий | GitHub | n/a | аккаунт GitHub |
| Вопрос об обработке данных | эта страница или Правовые документы | нет | нет |
Сохраняемые поля — имя, email для ответа, тема, сообщение и внутренняя
цель (other / contact на этом URL). Слота вложений нет, поэтому
логи и скриншоты нужно описывать, не загружать. Предпочитайте
публичный URL каталога вставке.
Лимит частоты — на клиента, не дневная квота в UI. Когда срабатывает, подождите. Цикл Отправить продлит блокировку.
У machine-Контакта нет формы. Агент не должен выдумывать POST;
направьте человека на этот URL или используйте report preview, когда
объект известен.
Клавиша C — тот же URL, что иконка в шапке. Она ничего не делает,
когда saas_public_pages выключен. После успешной отправки
перезагрузите страницу, если нужно второе сообщение; отключённая
кнопка — на этот вид, не пожизненная блокировка.
Связанные страницы
- Жалобы — case после входа против точного digest.
- Правовые документы — конфиденциальность и правила сервиса.
- Каталог — скопируйте
stable_idдо письма. - Эта документация — how-to, которые уже могут ответить.
- Отчёты CLI — preview, затем confirm.
- Доверие и безопасность — на что жаловаться.
!!! warning "Секреты"
Сообщение с паролем, токеном или приватным ключом — утечка.
Ротируйте учётные данные. Пишите публичный URL и stable_id.