點樣高效提問

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

先判斷係使用疑問、可重現問題，定係功能建議，再準備相應材料。

先揀合適入口

你嘅情況	推薦入口
唔確定係配置定產品問題	【設定】→【關於我哋】→【反饋】→【用 Agent 提交】
已確認係可重現缺陷	GitHub Bug 報告
希望增加新功能	GitHub 功能請求
討論用法或者方案	GitHub 討論 / 問題
只需要查操作步驟	目前文件同 Cherry Assistant

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

問題應該包含啲乜

1

1. 用一句說明目標

例如：「我想令 Agent 喺工作日朝早將日報發到飛書群。」

2

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

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

3

3. 提供最短重現步驟

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

4

4. 補充環境

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

5

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

截圖要包括錯誤同所在頁面；日誌只擷取相關時間段，同埋先做脫敏。模型輸出問題應附上輸入、模型同期望格式。

可以直接用嘅模板

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

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

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

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

截圖同日誌要刪走乜嘢

提交前刪除 API Key、Authorization、Cookie、機械人 Token、App Secret、電郵、完整本地路徑、聊天內容同業務數據。密鑰一旦公開，應立即到服務商或者平台撤銷。

令排查更快嘅小習慣

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

可以直接叫 Cherry Assistant 幫我提交嗎？

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