How to Ask Questions Efficiently

Cherry Studio is a free and open-source project. As the project grows, the workload of the project team also increases. To reduce communication costs and effectively and efficiently solve your problems, we hope everyone can address issues encountered by following the steps and methods below as much as possible before asking questions, allowing the project team more time to focus on project maintenance and development. Thank you for your cooperation!

Most basic problems can usually be solved by carefully reviewing the documentation.

  • Functionality and usage issues of the software can be found in the Features Introduction documentation;

  • Frequently asked questions are collected on the FAQ page. You can check the FAQ page first to see if there's a solution;

  • More complex problems can be solved directly by searching or asking in the search bar;

  • Be sure to carefully read the hint box content in each document; it can help you avoid many problems;

  • Check or search the GitHub Issue page for similar issues and solutions.

II. Web Search, Asking AI

For issues unrelated to client functionality, such as model usage (e.g., model errors, unexpected responses, parameter settings), it is recommended to first search online for relevant solutions, or describe the error content and problem to AI to find solutions.

III. Ask in Official Communities or Submit an Issue on GitHub

If the above two steps (I and II) did not provide an answer or solve your problem, you can go to the official TG channel, Discord channel, (One-click to join) to describe the problem in detail and seek help.

  1. If it's a model error, please provide a complete screenshot of the interface and console error messages. Sensitive information can be censored, but the model name, parameter settings, and error content must be kept in the screenshot. To view console error messages, click here.

  2. If it's a software bug, please provide a specific error description and detailed steps to facilitate debugging and fixing by developers. If it's an occasional problem that cannot be reproduced, please describe the relevant scenarios, background, and configuration parameters when the problem occurred as detailed as possible. In addition, you also need to include platform information (Windows, Mac, or Linux) and software version number in the problem description.

Last updated

Was this helpful?