Как задавать вопросы эффективно

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

Сначала определите, это вопрос, воспроизводимая проблема или предложение по функции, а затем подготовьте соответствующие материалы.

Сначала выберите подходящий канал

Ваш случай	Рекомендуемый канал
Не уверены, это проблема конфигурации или продукта	【Настройки】→【О нас】→【Обратная связь】→【Отправить через Agent】
Подтвержденный воспроизводимый дефект	Отчет об ошибке на GitHub
Хотите добавить новую возможность	Запрос на функцию в GitHub
Обсудить использование или решение	Обсуждение GitHub / Вопросы
Нужно только узнать шаги выполнения	Текущая документация и Cherry Assistant

Cherry Assistant может прочитать информацию о текущем установленном пакете и после вашего согласия собрать необходимые диагностические данные. Сначала он покажет обезличенный предварительный просмотр, а затем отправит отзыв или сформирует диагностический пакет; вам не нужно заранее учиться читать логи.

Что должно содержать обращение

1

1. Кратко опишите цель одним предложением

Например: «Я хочу, чтобы Agent по рабочим дням утром отправлял ежедневный отчет в группу Feishu».

2

2. Укажите фактический и ожидаемый результат

Фактический результат: «Задача успешно выполнилась, но в Feishu не пришло сообщение». Ожидаемый результат: «После завершения выполнения в указанную группу приходит одно сообщение с ежедневным отчетом».

3

3. Приведите минимальные шаги для воспроизведения

Начните с того места, где проблему можно стабильно воспроизвести, и за 3–6 шагов опишите путь кликов, выбранные параметры и место появления ошибки.

4

4. Укажите окружение

Укажите операционную систему, версию из 【Настройки】→【О нас】, а также соответствующего поставщика услуг или тип канала. Не публикуйте API-ключи и учетные данные.

5

5. Добавьте скриншоты, запись экрана или логи

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

Шаблон, который можно использовать сразу

Заголовок: Задача Agent по расписанию успешно выполнена, но канал Feishu не получил результат

Цель: по будням в 09:00 отправлять операционный ежедневный отчет в указанную группу Feishu.
Фактический результат: в истории выполнения отображается успех, но в Feishu нет сообщения.
Ожидаемый результат: в группе получено одно сообщение с ежедневным отчетом.

Шаги воспроизведения:
1. Откройте 【Настройки】→【Плановые задачи】.
2. Выберите задачу с ежедневным отчетом и нажмите 【Запустить】.
3. Дождитесь завершения задачи.
4. Проверьте группу Feishu — новых сообщений нет.

Окружение: macOS / версия, указанная в Cherry Studio【О нас】 / канал Feishu.
Уже пробовал: повторно включить канал; отправить тестовое сообщение боту в Feishu.
Вложения: скриншот состояния канала с замаскированными учетными данными, соответствующая запись о выполнении.

Что нужно удалить из скриншотов и логов

Перед отправкой удалите API Key, Authorization, Cookie, токен бота, App Secret, электронную почту, полный локальный путь, содержимое чатов и бизнес-данные. Если ключ был раскрыт, его следует немедленно отозвать у поставщика или на платформе.

Привычки, которые ускоряют поиск проблемы

• Каждый раз воспроизводите только одну проблему;
• Используйте минимальную конфигурацию, при которой проблема проявляется;
• Укажите, возникает ли проблема стабильно;
• Не пишите только «не работает» — приложите оригинальный текст ошибки;
• Не загружайте весь лог, если он не связан с проблемой;
• Если нашли тот же Issue, добавьте окружение и новые зацепки, не создавайте дубликат.

Можно ли просто попросить Cherry Assistant отправить это за меня?

Да. После перехода в Cherry Assistant через 【Обратная связь】 опишите проблему и явно попросите его отправить обращение. Он запросит разрешение на диагностические данные, покажет обезличенный предварительный просмотр и затем обработает обращение выбранным вами способом. Только если вы явно попросите GitHub, будет создан GitHub Issue.