> 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/contribution/docs.md).

# Внести вклад в документацию

Вклад в документацию включает исправление неверных путей, добавление руководств по новым функциям, улучшение скриншотов и примеров, корректировку оглавления и перевод. Цель не в том, чтобы «написать больше», а в том, чтобы читатель мог выполнить задачу по шагам на странице.

<figure><img src="/files/145aa187d079d1c2e07dc3adc4ce58ac67a288b8" alt="从明确文档问题、完成小范围修改到预览和提交评审的贡献流程图"><figcaption><p>При работе над документацией также нужно держать фокус на ограниченном объёме: после успешного Preview затем отправляйте Change Request.</p></figcaption></figure>

## Выберите способ отправки

* Если у вас уже есть права на редактирование в GitBook: создайте Change Request в соответствующем языковом пространстве;
* Если прав на редактирование нет: в Cherry Studio откройте 【Настройки】→【О нас】→【Обратная связь】 и укажите адрес страницы, проблему и предложение;
* Если проблема документации связана с изменениями кода: в кодовом PR отметьте пункт документации и приложите соответствующий Change Request или укажите, что обновление не требуется.

## Процесс внесения изменений в GitBook

{% stepper %}
{% step %}

### 1. Создайте Change Request

Перейдите в нужное языковое пространство, создайте черновик, не изменяйте напрямую опубликованный контент. В заголовке чётко укажите затронутый модуль и цель.
{% endstep %}

{% step %}

### 2. Сначала проверьте текущий продукт

Сверьте входные точки, кнопки, значения по умолчанию и ожидаемые результаты по текущему интерфейсу Cherry Studio. Если структура старой страницы не совпадает с текущим продуктом, нужно заново перестроить содержание, а не просто заменить несколько терминов.
{% endstep %}

{% step %}

### 3. Пишите страницу под задачу пользователя

В начале поясните, что можно выполнить, затем дайте точный путь, пронумерованные шаги, ожидаемый результат, пояснения по настройке, реальные примеры и частые вопросы. В руководстве по настройке можно сначала предложить пользователю получить помощь от Agent в разделе 【Работа】, а затем дать ручной путь в 【Настройках】.
{% endstep %}

{% step %}

### 4. Используйте встроенные блоки GitBook

Для подсказок используйте Callout, для последовательных действий — Stepper, для частых вопросов — сворачиваемые блоки, для связанных страниц — Cards. Не оставляйте `{% hint %}`на странице как обычный текст теги HTML или разметку Markdown.
{% endstep %}

{% step %}

### 5. Добавляйте реальные скриншоты

Скриншоты должны быть из текущего интерфейса продукта, на упрощённом китайском, в светлой теме и единообразного размера. Отмечайте только те места, куда читателю нужно нажать или на что смотреть, а API Key, email, локальные пути и пользовательские данные закрывайте.
{% endstep %}

{% step %}

### 6. Предпросмотр и отправка на проверку

Постранично проверьте заголовки, навигацию, ссылки, изображения, Callout, Stepper, таблицы и сворачиваемые блоки. Убедившись, что в черновике нет лишних изменений на других страницах, отправляйте на проверку — затем сопровождающий объединит изменения.
{% endstep %}
{% endstepper %}

## Требования к написанию страниц

| Содержимое    | Требование                                                                                                      |
| ------------- | --------------------------------------------------------------------------------------------------------------- |
| Путь действий | Используйте названия, видимые в интерфейсе, например 【Работа】→【Добавить агента】                                 |
| Термины       | При первом упоминании объясняйте значение термина и его назначение                                              |
| Параметры     | Различайте значения по умолчанию в продукте и рекомендуемую отправную точку, объясняйте назначение и риски      |
| Примеры       | Используйте конкретные роли, цели, входные данные и результат                                                   |
| Скриншоты     | Из реального интерфейса, с альтернативным текстом и пронумерованными пояснениями                                |
| Ссылка        | Ссылайтесь на текущую страницу или официальный источник и перед отправкой откройте каждую ссылку по отдельности |

## Замечания по скриншотам

{% hint style="danger" %}
Не подделывайте успешный результат ради того, чтобы «выглядело завершённым». Если функция требует внешнего API Key, платного сервиса или реального аккаунта, можно показывать экран настройки и предварительные условия, но нельзя выдумывать успешное подключение, доставку сообщений или вывод модели.
{% endhint %}

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

## Проверка читателем

Попросите человека, не участвовавшего в написании, выполнить операцию, опираясь только на инструкцию. Запишите, на каком шаге он остановился, какой термин не понял и какой снимок не помог, а затем внесите правки. То, что документация проходит проверку грамматики, ещё не означает, что читатель сможет выполнить задачу по ней.

{% hint style="success" %}
Идеальный результат одной страницы руководства: читатель понимает, когда это использовать, откуда начать, что увидит на каждом шаге, что проверять сначала при неудаче и как подтвердить результат после завершения.
{% endhint %}

## Чек-лист самопроверки

* Нет старых входных точек, старых названий или устаревших функций;
* Нет жёстко зафиксированных нестабильных рейтингов моделей, цен и «лучшей конфигурации»;
* Нет версий, даты проверки или внутренних путей реализации, которые прерывают чтение;
* Названия интерфейса единообразно оформлены в 【】;
* Текст читается как написанный редактором продукта для пользователя, а не как автоматически сгенерированный отчёт;
* Каждый шаг можно начать из соответствующего пункта в текущем интерфейсе;
* Изображения, ссылки и встроенные блоки GitBook корректно отображаются в Preview.

<details>

<summary>Можно ли напрямую редактировать опубликованную страницу?</summary>

Нет. Используйте Change Request, чтобы сохранить объём изменений и процесс проверки; после подтверждения всё объединит человек с нужными правами.

</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/contribution/docs.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.