如何高效提问
一个容易回答的问题,不一定很长,但要让别人知道你在做什么、实际发生了什么,以及怎样才能看到同样的问题。

先判断是使用疑问、可复现问题还是功能建议,再准备对应材料。
先选合适入口
| 你的情况 | 推荐入口 |
|---|---|
| 不确定是配置还是产品问题 | 侧栏【帮助】→【问题反馈】→【求助问题反馈助手】 |
| 已确认是可复现缺陷 | GitHub Bug Report |
| 希望增加新能力 | GitHub Feature Request |
| 讨论用法或方案 | GitHub Discussion / Questions |
| 只需要查操作步骤 | 当前文档与 Cherry Assistant |
Cherry Assistant 可以读取当前安装包信息,并在你同意后收集必要诊断。它会先展示脱敏后的预览,再提交反馈或生成诊断包;不需要你先学会看日志。
问题应包含什么
1. 一句话说明目标
例如:“我想让 Agent 在工作日早上把日报发到飞书群。”
2. 写出实际结果和期望结果
实际结果:“任务运行成功,但飞书没有收到消息。”期望结果:“运行完成后,指定群收到一条日报。”
3. 提供最短复现步骤
从能稳定出现问题的入口开始,用 3–6 步写清点击路径、选择内容和错误出现位置。
4. 补充环境
写明操作系统、【设置】→【关于我们】中显示的版本、相关服务商或频道类型。不要公开 API Key 和账号凭据。
5. 添加截图、录屏或日志
截图要包含错误和所在页面;日志只截相关时间段并先脱敏。模型输出问题应附上输入、模型和期望格式。
可直接使用的模板
标题:Agent 定时任务运行成功,但飞书频道没有收到结果
目标:工作日 09:00 把运营日报发送到指定飞书群。
实际结果:运行历史显示成功,飞书无消息。
期望结果:群内收到一条日报消息。
复现步骤:
1. 打开【设置】→【定时任务】。
2. 选择日报任务并点击【运行】。
3. 等待任务完成。
4. 查看飞书群,没有新消息。
环境:macOS / Cherry Studio【关于我们】中显示的版本 / 飞书频道。
已经尝试:重新启用频道;在飞书中给机器人发送测试消息。
附件:已遮挡凭据的频道状态截图、对应运行记录。
截图和日志要删掉什么
让排查更快的小习惯
- 每次只复现一个问题;
- 使用能出现问题的最小配置;
- 说明问题是否稳定发生;
- 不只写“不能用”,附上错误原文;
- 不上传与问题无关的整份日志;
- 发现相同 Issue 时补充环境和新线索,不重复创建。
可以直接让 Cherry Assistant 替我提交吗?
可以。通过【反馈】进入 Cherry Assistant 后说明问题,并明确让它提交。它会征求诊断数据授权、展示脱敏预览,再按你选择的方式处理。只有你明确要求 GitHub 时才会走 GitHub Issue。
可以直接让 Cherry Assistant 替我提交吗?
可以。通过【反馈】进入 Cherry Assistant 后说明问题,并明确让它提交。它会征求诊断数据授权、展示脱敏预览,再按你选择的方式处理。只有你明确要求 GitHub 时才会走 GitHub Issue。
