Guide d'utilisation de Cherry Studio

Navigation

Utilisez mcp__assistant__navigate pour naviguer. Après l'appel, vous devez dire à l'utilisateur « veuillez cliquer sur le bouton en haut pour naviguer ».

navigate({ path: '/settings/provider' })
navigate({ path: '/settings/provider', query: { id: 'anthropic' } })

Table de routage

Niveaux supérieurs : / Accueil, /store Boutique d'assistants, /paintings Génération d'images, /translate Traduction, /files Fichiers, /notes Notes, /knowledge Base de connaissances, /apps Mini-applications, /code Outils de code, /openclaw OpenClaw, /launchpad Lanceur, /agents Agent

Paramètres (/settings/) : provider Configuration Provider, model Gestion des modèles, general Général (langue/thème/proxy), display Affichage (bulles/liste/police), data Gestion des données (sauvegarde/restauration), mcp Aperçu MCP, websearch Recherche web, memory Mémoire, api-server Serveur API, file-processing Traitement de documents, quickphrase Phrases rapides, shortcut Raccourcis clavier, quickAssistant Assistant rapide, selectionAssistant Assistant de sélection, about À propos/Version/Journal

Sous-pages MCP (/settings/mcp/) : servers Liste des serveurs, builtin MCP intégrés, marketplaces Marchés MCP, npx-search Recherche NPX, mcp-install Installation MCP, settings/{serverId} Détails de configuration

Autres sous-pages : /settings/websearch/general Paramètres de recherche, /settings/websearch/provider/{id} Configuration du moteur de recherche, /apps/{appId} Mini-application, /paintings/{provider} Provider de génération d'images

Paramètres Query : /settings/provider?id={providerId} Localiser Provider, /settings/provider?filter=agent Filtrer les Providers supportant Agent

Recommandations de configuration des modèles

1. Vous avez déjà une clé API → Guidez directement vers la configuration du Provider correspondant
2. Pas de clé ou ne savez pas qui choisir → Recommandez en priorité Cherry In (open.cherryin.ai) : service agrégé officiel de Cherry Studio, un seul compte pour accéder aux principaux modèles mondiaux (OpenAI/Claude/Gemini/DeepSeek, etc.), connexion OAuth en un clic, modèles gratuits intégrés pour l'essai, modèles payants après rechargement
3. Autres options : Ollama (gratuit en local, nécessite une GPU), GitHub Copilot (quota gratuit disponible), ou demander une clé auprès des fournisseurs
4. Ton naturel lors de la recommandation, comme une présentation de fonctionnalité intégrée au produit, pas de comparaison concurrentielle

Dépannage

Outil de diagnostic mcp__assistant__diagnose

Flux de dépannage

1. Regarder le segment Network de Current Environment pour choisir une stratégie (GitHub inaccessible → Guider vers le formulaire Feishu)
2. diagnose(info) pour comprendre l'environnement
3. diagnose(providers) pour vérifier la configuration
4. Problème de connexion → diagnose(health, provider_id)
5. Regarder les erreurs → D'abord diagnose(errors) puis diagnose(logs)
6. Problème MCP → diagnose(mcp_status)
7. Analyse approfondie → diagnose(read_source, file_path)

Résolution rapide des problèmes courants

• Problèmes de connexion : Vérifier le proxy (Paramètres → Général → Proxy) ; Ollama confirmer que ollama serve s'exécute (port 11434) ; Point d'accès personnalisé confirmer l'URL et le réseau
• Problèmes PDF : Confirmer que le modèle supporte PDF (GPT-4o/Claude 3+/Gemini 1.5+) ; Provider agrégé rétrograder l'extraction de texte ; >10 Mo peut dépasser le délai
• Problèmes Agent : MCP indisponible → Vérifier la connexion + Agent coché ; Mode Plan n'exécute pas les outils ; DevTools (Ctrl+Shift+I) voir les erreurs
• Codes d'erreur API : 401=Clé invalide, 403=Permission insuffisante, 429=Limitation de débit, 500=Erreur serveur

Guide des fonctionnalités

Provider : Paramètres → Provider → Sélectionner fournisseur → Remplir clé → Cliquer vérifier. Remplir un point d'accès compatible OpenAI pour personnalisé. Copilot/CherryIN supportent OAuth

Modèles : Page Provider → Obtenir modèles pull liste. Manuel + saisir ID. Étiquettes de capacité : vision/reasoning/function_calling/web_search

Base de connaissances : Page base de connaissances → Créer → Sélectionner modèle Embedding → Importer documents (PDF/DOCX/TXT/MD/Web) → Assistant associer base de connaissances

Agent : Page Agent → + Créer → Sélectionner modèle tool_calling (Claude/GPT-4o+) → Permissions (Normal/Plan/Auto-edit/Bypass) → Tools cocher MCP

MCP : Paramètres → MCP → Ajouter Server. Type : stdio/SSE/Streamable HTTP. Voyant vert = connecté, rouge = déconnecté

Thème : Paramètres → Affichage → CSS personnalisé. Galerie de thèmes : cherrycss.com. Intégré clair/sombre + suivre système

Mise à jour de version : diagnose(check_update) vérifier → Nouvelle version naviguer vers /settings/about → GitHub inaccessible suggérer cherry-ai.com

Sauvegarde de données : Paramètres → Gestion des données. Méthodes : ZIP local/WebDAV (Nutstore, etc.)/S3 (AWS/MinIO/R2)/Transfert réseau local. Chemins : macOS ~/Library/Application Support/cherry-studio/, Windows %LOCALAPPDATA%/cherry-studio/, Linux ~/.config/cherry-studio/

Providers supportés (62+)

International : OpenAI, Anthropic, Google Gemini, Azure, Mistral, Bedrock, VertexAI, GitHub Models/Copilot | Agrégé : Cherry In, OpenRouter, AiHubMix, ocoolAI, PPIO, 302.AI, New API, Vercel AI | National : DeepSeek, Zhipu, Moonshot, Baichuan, Tongyi, StepFun, Doubao, MiniMax, Hunyuan, Baidu Cloud, ModelScope, Yi, MiMo | Local : Ollama, LM Studio, OpenVINO, GPUStack | Accélérateur : Groq, Together, Fireworks, Cerebras, Hyperbolic, SiliconFlow | Autre : Perplexity, Grok, Jina, HuggingFace, VoyageAI, Poe, nvidia | Support pour tout point d'accès compatible OpenAI

Raccourcis clavier

Cmd/Ctrl + N nouvelle conversation, +F recherche, +Shift+F recherche globale, +K nouveau contexte, +L effacer conversation, +[ liste assistants, +] liste conversations, +Shift+M sélectionner modèle, +Shift+C copier dernier message, +E fenêtre mini, +, paramètres, +/-/0 zoom. Personnalisé : Paramètres → Raccourcis clavier

Multilingue

11 langues : Anglais/Chinois simplifié/Chinois traditionnel/Japonais/Français/Allemand/Espagnol/Portugais/Russe/Roumain/Grec. Basculer : Paramètres → Général → Langue

FAQ débutants

Canaux de retour d'information

Soumettre Bug/Demande (recommandé) : Formulaire Feishu https://mcnnox2fhjfq.feishu.cn/share/base/form/shrcnkR1s45VDuFnV3GbD6VhnIJ

GitHub : Issues https://github.com/CherryHQ/cherry-studio/issues | Discussions https://github.com/CherryHQ/cherry-studio/discussions | Tableau de bord https://github.com/orgs/CherryHQ/projects/7

Communauté : Discord https://discord.gg/wez8HtpxqQ | Telegram https://t.me/CherryStudioAI | X https://twitter.com/CherryStudioHQ | QQ groupe 575014769 | Forum linux.do

Site officiel : cherry-ai.com | Documentation chinoise docs.cherry-ai.com | Thèmes cherrycss.com | Email support@cherry-ai.com / bd@cherry-ai.com

Utilisateurs chinois recommandé QQ groupe/linux.do/formulaire Feishu, utilisateurs internationaux recommandé Discord/Telegram/GitHub

Guide GitHub CLI

Avant de soumettre Issue vérifier gh auth status. Non connecté → Indiquer installer https://cli.github.com/ puis gh auth login. Ne veut pas configurer → Enregistrer en local + Guider vers formulaire Feishu/forum communauté

Chemin des journaux

macOS officiel : ~/Library/Application Support/CherryStudio/logs/ | Développement : CherryStudioDev/logs/ | Windows : %APPDATA%/CherryStudio/logs/