> 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/question-contact/suggestions.md).

# 问题反馈与功能建议

Cherry Studio 提供三种反馈方式：由 Cherry Assistant 引导提交、前往 GitHub Issue、中文界面的反馈问卷。入口是【设置】→【关于我们】→【反馈】。

<figure><img src="/files/h04G1tnNwjNDWuVAyUaq" alt="根据使用疑问、可复现问题、功能建议和材料整理需求选择反馈入口的流程图"><figcaption><p>不会整理材料时优先让 Agent 生成反馈草稿；公开提交前先删除隐私信息。</p></figcaption></figure>

<figure><img src="/files/KSAolCeeyhCh7D7zp96O" alt="应用内反馈窗口中的使用 Agent 提交、GitHub Issue 和反馈问卷"><figcaption><p>不确定问题类型时选择【使用 Agent 提交】；已整理好公开信息时再选择 GitHub Issue。</p></figcaption></figure>

## 选哪一种

| 方式             | 适合情况               | 会发生什么                                  |
| -------------- | ------------------ | -------------------------------------- |
| 【使用 Agent 提交】  | 不确定问题类型、希望自动整理信息   | Cherry Assistant 诊断、脱敏预览，并在确认后提交或生成诊断包 |
| 【GitHub Issue】 | 已确认要公开跟踪 Bug 或功能建议 | 打开官方 Issue 类型选择页                       |
| 【反馈问卷】         | 中文用户提交一般反馈         | 打开官方飞书问卷                               |

<figure><img src="/files/miaOd07c0ovpWpgYoaxe" 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

Bug 报告应包含平台、当前版本、问题描述、复现步骤、期望结果和相关日志；功能建议应先讲清当前痛点，再说明期望方案和考虑过的替代办法。

<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>选择 Bug、功能建议或讨论模板</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>Discussions</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 Key、机器人 Token、完整诊断包、私人聊天、公司数据或未脱敏日志。需要私密诊断时优先使用应用内 Agent 反馈流程。
{% endhint %}

## 提交前一分钟检查

* 标题能看出问题发生在哪个功能；
* 复现步骤从一个明确入口开始；
* 实际结果与期望结果分开写；
* 截图只保留相关区域，并已遮挡账号、路径、密钥和业务数据；
* 能用应用内 Agent 安全收集的信息，不再手工复制整份日志；
* 公开提交前已经搜索相同 Issue。

{% hint style="info" %}
如果你不确定这是 Bug、配置问题还是功能建议，直接使用【使用 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/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.