> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/question-contact/suggestions.md).

# Сообщение об ошибках и предложения по функциям

Cherry Studio предлагает три способа отправки отзыва: через Cherry Assistant с пошаговой подачей, через GitHub Issue и через анкету обратной связи на китайском интерфейсе. Путь: 【Настройки】→【О нас】→【Обратная связь】.

<figure><img src="/files/0bda4d4bdda9baebd8fe0fa5136f68cf1232ef28" alt="根据使用疑问、可复现问题、功能建议和材料整理需求选择反馈入口的流程图"><figcaption><p>Если не умеете структурировать материалы, сначала попросите Agent сгенерировать черновик отзыва; перед публичной отправкой удалите личные данные.</p></figcaption></figure>

<figure><img src="/files/b50653806355d154c371c817001c5f94150830b1" alt="应用内反馈窗口中的使用 Agent 提交、GitHub Issue 和反馈问卷"><figcaption><p>Если не уверены в типе проблемы, выберите 【Отправить через Agent】; если уже подготовили публичную информацию, тогда выберите GitHub Issue.</p></figcaption></figure>

## Что выбрать

| Способ                  | Подходящий случай                                                               | Что произойдет                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 【Отправить через Agent】 | Неясен тип проблемы, хотите автоматически упорядочить информацию                | Cherry Assistant выполнит диагностику, покажет предварительный просмотр с обезличиванием и после подтверждения отправит или создаст диагностический пакет |
| 【GitHub Issue】          | Уже подтверждено, что нужно публично отслеживать баг или предложение по функции | Открыть официальную страницу выбора типа Issue                                                                                                            |
| 【Анкета обратной связи】 | Обычная обратная связь от китайскоязычных пользователей                         | Открыть официальную анкету Feishu                                                                                                                         |

<figure><img src="/files/3ae11a182be60a419fa7b181d3e7b7740f316ef0" alt="Cherry Assistant 反馈 Agent 的对话区、模型选择和状态面板"><figcaption><p>В Agent обратной связи опишите цель, фактический результат и шаги воспроизведения, а затем по подсказкам решите, нужно ли предоставлять диагностическую информацию.</p></figcaption></figure>

## Рекомендуется: отправить через Agent

{% stepper %}
{% step %}

### 1. Откройте 【Настройки】→【О нас】→【Обратная связь】

Выберите 【Отправить через Agent】 с пометкой 【Рекомендуется】.
{% endstep %}

{% step %}

### 2. Опишите проблему или предложение

Укажите цель, фактический результат, ожидаемый результат и шаги воспроизведения. Cherry Assistant сначала проверит информацию об установленном пакете, а при необходимости запросит доступ к ошибкам, журналам, состоянию MCP или подключению модели.
{% endstep %}

{% step %}

### 3. Решите, предоставлять ли диагностику

Разрешайте только те элементы, которые связаны с проблемой. Cherry Assistant скроет учетные данные и покажет предварительный просмотр; подтверждайте только после проверки.
{% endstep %}

{% step %}

### 4. Выберите результат отправки

В стандартном процессе обратной связи используется официальный канал, также можно сгенерировать диагностический ZIP для ручной отправки. Если хотите явно опубликовать это в GitHub, сразу скажите: «Отправить GitHub Issue».
{% endstep %}
{% endstepper %}

## Отправить GitHub Issue

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

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Создать Issue</strong></td><td>Выберите шаблон баг-отчета, предложения по функции или обсуждения</td><td><a href="https://github.com/CherryHQ/cherry-studio/issues/new/choose">https://github.com/CherryHQ/cherry-studio/issues/new/choose</a></td></tr><tr><td><strong>Поиск существующих Issue</strong></td><td>Проверьте, есть ли уже такая же проблема</td><td><a href="https://github.com/CherryHQ/cherry-studio/issues">https://github.com/CherryHQ/cherry-studio/issues</a></td></tr><tr><td><strong>Обсуждения</strong></td><td>Обсуждение использования и открытые вопросы</td><td><a href="https://github.com/CherryHQ/cherry-studio/discussions">https://github.com/CherryHQ/cherry-studio/discussions</a></td></tr></tbody></table>

{% hint style="danger" %}
GitHub Issue — это публичный контент. Не загружайте API-ключи, токены ботов, полные диагностические пакеты, личные чаты, корпоративные данные или неочищенные журналы. Если нужна конфиденциальная диагностика, сначала используйте встроенный в приложение процесс обратной связи через Agent.
{% endhint %}

## Проверка за минуту до отправки

* По заголовку должно быть понятно, в какой функции возникла проблема;
* Шаги воспроизведения должны начинаться с понятного входа;
* Фактический результат и ожидаемый результат пишите отдельно;
* На скриншотах оставляйте только нужную область и скрывайте учетные записи, пути, ключи и бизнес-данные;
* Если информацию можно безопасно собрать через встроенный Agent, не копируйте вручную весь журнал;
* Перед публичной отправкой уже выполнен поиск по похожим Issue.

{% hint style="info" %}
Если вы не уверены, это баг, проблема с настройкой или предложение по функции, просто используйте 【Отправить через Agent】. Сначала дайте Cherry Assistant помочь вам с оформлением, а потом решите, публиковать ли это в GitHub.
{% endhint %}

## Как сделать предложение по функции понятнее

* Сначала опишите, какую работу вы сейчас выполняете, а не где находится кнопка;
* Объясните, почему существующее решение недостаточно;
* Укажите ожидаемый результат и критерии успеха;
* Если прикладываете эскиз интерфейса или похожий опыт, отметьте, на чем именно стоит сосредоточиться;
* Укажите, есть ли временное обходное решение;
* Избегайте объединения нескольких несвязанных предложений в один Issue.

<details>

<summary>Через сколько после отправки это будет обработано?</summary>

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/russian/question-contact/suggestions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.