> 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/zhong-wen-fan-ti/question-contact/ask.md).

# 點樣高效提問

一個容易回答嘅問題，唔一定要好長，但要令其他人知道你喺做緊乜、實際發生咗乜，以及點樣先可以見到同樣嘅問題。

<figure><img src="/files/7d2c5138b8f50f1c1d5c677ecaf2378c91106ecb" alt="根据使用疑问、可复现问题和功能建议选择提问或反馈入口的流程图"><figcaption><p>先判斷係使用疑問、可重現問題定係功能建議，再準備相應材料。</p></figcaption></figure>

### 先揀合適入口

| 你嘅情況         | 推薦入口                          |
| ------------ | ----------------------------- |
| 唔確定係配置定係產品問題 | 側欄【幫助】→【問題反饋】→【求助問題反饋助手】      |
| 已確認係可重現缺陷    | GitHub Bug Report             |
| 希望增加新功能      | GitHub Feature Request        |
| 討論用法或者方案     | GitHub Discussion / Questions |
| 淨係需要查操作步驟    | 當前文檔同 Cherry Assistant        |

Cherry Assistant 可以讀取當前安裝包資訊，並喺你同意後收集必要診斷資料。佢會先展示脫敏後嘅預覽，再提交反饋或者生成診斷包；唔需要你先學識睇日誌。

### 問題應該包含啲乜

{% stepper %}
{% step %}

#### 1. 用一句話說明目標

例如：「我想等 Agent 喺工作日朝早將日報發到飛書群。」
{% endstep %}

{% step %}

#### 2. 寫出實際結果同期望結果

實際結果：「任務運行成功，但飛書冇收到消息。」期望結果：「運行完成後，指定群收到一條日報。」
{% endstep %}

{% step %}

#### 3. 提供最短重現步驟

由可以穩定出現問題嘅入口開始，用 3–6 步寫清點擊路徑、選擇內容同錯誤出現位置。
{% endstep %}

{% step %}

#### 4. 補充環境

寫明操作系統、【設定】→【關於我們】入面顯示嘅版本、相關服務商或者頻道類型。唔好公開 API Key 同帳號憑據。
{% endstep %}

{% step %}

#### 5. 加入截圖、錄屏或者日誌

截圖要包含錯誤同所在頁面；日誌只截相關時間段並先脫敏。模型輸出問題應附上輸入、模型同期望格式。
{% endstep %}
{% endstepper %}

### 可以直接使用嘅範本

```
Agent 定時任務運行成功，但飛書頻道冇收到結果

目標：工作日 09:00 將營運日報發送到指定飛書群。
實際結果：運行歷史顯示成功，飛書冇消息。
期望結果：群內收到一條日報消息。

重現步驟：
1. 打開【設定】→【定時任務】【。
2. 選擇日報任務並點擊【運行】【。
3. 等待任務完成。
4. 睇吓飛書群，冇新消息。

環境：macOS / Cherry Studio【關於我們】中顯示嘅版本 / 飛書頻道。
已經試過：重新啟用頻道；喺飛書入面畀機械人發送測試消息。
附件：已遮擋憑據嘅頻道狀態截圖、對應運行記錄。
```

### 截圖同日誌要刪走乜

{% hint style="danger" %}
提交前刪除 API Key、Authorization、Cookie、機械人 Token、App Secret、電郵、完整本地路徑、聊天內容同業務數據。密鑰一旦公開，應即刻去服務商或者平台撤銷。
{% endhint %}

### 令排查快啲嘅小習慣

* 每次只重現一個問題；
* 用可以出現問題嘅最小配置；
* 說明問題係咪穩定發生；
* 唔好淨係寫「唔可以用」，要附上錯誤原文；
* 唔好上傳同問題無關嘅成份日誌；
* 發現相同 Issue 時補充環境同新線索，唔好重複建立。

<details>

<summary>可以直接叫 Cherry Assistant 幫我提交嗎？</summary>

可以。經由【反饋】入到 Cherry Assistant 之後講明問題，並明確叫佢提交。佢會徵求診斷數據授權、展示脫敏預覽，再按你揀嘅方式處理。只有你明確要求 GitHub 時先會走 GitHub Issue。

</details>

<details>

<summary>可以直接叫 Cherry Assistant 幫我提交嗎？</summary>

可以。經由【反饋】入到 Cherry Assistant 之後講明問題，並明確叫佢提交。佢會徵求診斷數據授權、展示脫敏預覽，再按你揀嘅方式處理。只有你明確要求 GitHub 時先會走 GitHub Issue。

</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/zhong-wen-fan-ti/question-contact/ask.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.