Menu
Cherry Studio 产品知识库、源码路径索引、故障排查和页面导航。当用户询问 Cherry Studio 的功能、配置、报错、使用方法时触发。也适用于用户提到 provider、模型、知识库、Agent、MCP、OpenClaw、PDF、快捷短语等关键词的场景。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | cherry-assistant-guide |
| description | Cherry Studio 产品知识库、源码路径索引、故障排查和页面导航。当用户询问 Cherry Studio 的功能、配置、报错、使用方法时触发。也适用于用户提到 provider、模型、知识库、Agent、MCP、OpenClaw、PDF、快捷短语等关键词的场景。 |
用 mcp__assistant__navigate 导航，调用后必须告诉用户「请点击上方按钮跳转」。
navigate({ path: '/settings/provider' })
navigate({ path: '/settings/provider', query: { id: 'anthropic' } })
顶级: / 首页, /store 助手商店, /paintings 绘图, /translate 翻译, /files 文件, /notes 笔记, /knowledge 知识库, /apps 小程序, /code 代码工具, /openclaw OpenClaw, /launchpad 启动台, /agents Agent
设置 (/settings/): provider Provider配置, model 模型管理, general 通用(语言/主题/代理), display 显示(气泡/列表/字体), data 数据管理(备份/恢复), mcp MCP总览, websearch 网页搜索, memory 记忆, api-server API服务器, file-processing 文档处理, quickphrase 快捷短语, shortcut 快捷键, quickAssistant 快捷助手, selectionAssistant 划词助手, about 关于/版本/日志
MCP 子页 (/settings/mcp/): servers 服务列表, builtin 内置MCP, marketplaces MCP市场, npx-search NPX搜索, mcp-install 安装MCP, settings/{serverId} 配置详情
其他子页: /settings/websearch/general 搜索设置, /settings/websearch/provider/{id} 搜索引擎配置, /apps/{appId} 小程序, /paintings/{provider} 绘图Provider
Query 参数: /settings/provider?id={providerId} 定位Provider, /settings/provider?filter=agent 筛选支持Agent的
open.cherryin.ai）：Cherry Studio 官方聚合服务，一个账号即可使用全球主流模型（OpenAI/Claude/Gemini/DeepSeek等），OAuth 一键登录，内置免费模型可体验，充值后使用付费模型mcp__assistant__diagnose| action | 说明 |
|---|---|
info | 版本、路径、系统信息 |
providers | Provider 配置（隐藏 Key） |
health + provider_id | 测试连通性（缓存30s） |
errors + lines | ERROR/WARN 条目（推荐优先用） |
logs + lines | 全部日志 |
mcp_status | MCP Server 状态 |
config | 用户设置 |
read_source + file_path | 只读源码 |
check_update | 检查新版本 |
diagnose(info) 了解环境diagnose(providers) 检查配置diagnose(health, provider_id)diagnose(errors) 再 diagnose(logs)diagnose(mcp_status)diagnose(read_source, file_path)ollama serve 运行(端口11434)；自定义端点确认URL和网络Provider: 设置→Provider→选服务商→填Key→点检查。自定义填OpenAI兼容端点。Copilot/CherryIN支持OAuth
模型: Provider页→获取模型拉列表。手动+输入ID。能力标签: vision/reasoning/function_calling/web_search
知识库: 知识库页→新建→选Embedding模型→导入文档(PDF/DOCX/TXT/MD/网页)→助手关联知识库
Agent: Agent页→+创建→选tool_calling模型(Claude/GPT-4o+)→权限(Normal/Plan/Auto-edit/Bypass)→Tools勾选MCP
MCP: 设置→MCP→添加Server。类型: stdio/SSE/Streamable HTTP。绿灯=连接，红灯=断开
主题: 设置→显示→自定义CSS。主题画廊: cherrycss.com。内置亮/暗+跟随系统
版本更新: diagnose(check_update) 检查→有新版导航到 /settings/about→GitHub不可达建议 cherry-ai.com
数据备份: 设置→数据管理。方式: 本地ZIP/WebDAV(坚果云等)/S3(AWS/MinIO/R2)/局域网传输。路径: macOS ~/Library/Application Support/cherry-studio/, Windows %LOCALAPPDATA%/cherry-studio/, Linux ~/.config/cherry-studio/
国际: OpenAI, Anthropic, Google Gemini, Azure, Mistral, Bedrock, VertexAI, GitHub Models/Copilot | 聚合: Cherry In, OpenRouter, AiHubMix, ocoolAI, PPIO, 302.AI, New API, Vercel AI | 国内: DeepSeek, 智谱, Moonshot, 百川, 通义, StepFun, 豆包, MiniMax, 混元, 百度云, ModelScope, Yi, MiMo | 本地: Ollama, LM Studio, OpenVINO, GPUStack | 加速: Groq, Together, Fireworks, Cerebras, Hyperbolic, SiliconFlow | 其他: Perplexity, Grok, Jina, HuggingFace, VoyageAI, Poe, nvidia | 支持任何 OpenAI 兼容端点
Cmd/Ctrl + N 新建话题, +F 搜索, +Shift+F 全局搜索, +K 新上下文, +L 清空话题, +[ 助手列表, +] 话题列表, +Shift+M 选模型, +Shift+C 复制最后消息, +E 迷你窗口, +, 设置, +/-/0 缩放。自定义: 设置→快捷键
11种: 英/简中/繁中/日/法/德/西/葡/俄/罗马尼亚/希腊。切换: 设置→通用→语言
| 问 | 答 |
|---|---|
| 第一次对话 | 首页选助手→选模型→发消息 |
| 怎么选模型 | 先配Provider(API Key)→聊天顶部选 |
| 免费模型 | Ollama本地免费; Copilot有免费额度 |
| Token | AI计量单位, ≈0.7中文字/4英文字符 |
| 对话历史 | 左侧话题列表, 自动保存本地 |
| 导出对话 | 话题右键→导出(MD/图片) |
| 数据安全 | 全部本地存储, Key本地加密 |
| MCP是什么 | 让AI调用外部工具(搜索/数据库/API等) |
Bug/需求提交(推荐): 飞书表单 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 | 看板 https://github.com/orgs/CherryHQ/projects/7
社群: Discord https://discord.gg/wez8HtpxqQ | Telegram https://t.me/CherryStudioAI | X https://twitter.com/CherryStudioHQ | QQ群 575014769 | 论坛 linux.do
官网: cherry-ai.com | 中文文档 docs.cherry-ai.com | 主题 cherrycss.com | 邮箱 support@cherry-ai.com / bd@cherry-ai.com
中文用户推荐QQ群/linux.do/飞书表单, 国际用户推荐Discord/Telegram/GitHub
提交Issue前检测 gh auth status。未登录→告知安装 https://cli.github.com/ 后 gh auth login。不想配→记录本地+引导飞书表单/社区论坛
macOS正式: ~/Library/Application Support/CherryStudio/logs/ | 开发: CherryStudioDev/logs/ | Windows: %APPDATA%/CherryStudio/logs/
Create or update GitHub pull requests using the repository-required workflow and template compliance. Use when asked to create/open/update a PR so the assistant reads `.github/pull_request_template.md`, fills every template section, preserves markdown structure exactly, and marks missing data as N/A or None instead of skipping sections.
Automated Cherry Studio code review for local branches, PRs, commits, and files. Use for reviewing code, docs, or pull requests with project-specific checks for DataApi boundaries, service ownership, renderer data hooks, React Hooks, lifecycle services, i18n, UI conventions, and tests. Supports single-agent review with interactive fix selection, or multi-agent deep review with reviewer-verifier adversarial mechanism and risk-based auto-fix. To find gaps in this skill's own instructions after a session, run `/gh-pr-review diag`.
Use when reviewing a PR, API, IPC channel, endpoint, parameter, type, or config that adds new surface area — BEFORE commenting on implementation quality. Also use immediately when a review surfaces signals like "no consumers yet", "unused export", "speculative", "additive", "forward-compatible", or "for future use".
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
将成功解决的用户问题收录到 FAQ 知识库。问题解决后自动判断是否收录。也可以在用户说"收录到 FAQ"、"记录这个问题"、"add to FAQ"时手动触发。
帮助用户提交 Bug Report 或 Feature Request。支持 GitHub Issue（有账户）和本地存档（无账户）两种模式。当诊断发现是代码 Bug 时主动提议，或当用户说"帮我提 issue"、"这是个 bug"、"我想要这个功能"、"submit a bug"、"feature request"时触发。