常见问题
先根据现象找到对应操作。连接错误可先用一条简短、不带附件的消息缩小问题范围。
安装后为什么不能直接聊天？
Cherry Studio 是客户端，需要连接模型服务。先配置 API Key 或支持的账号登录、添加模型、启用服务商，并在智能体中选择它。已有电脑配置可以导入，首次使用步骤见快速开始。
平台的网页聊天会员不一定包含 API（供应用调用模型的接口）额度，需要在平台单独确认。
服务商已添加，为什么模型选择器为空？
确认服务商已启用、模型可用，且不是仅供管理的嵌入或重排类型。图片与文字入口也可能筛选不同类型。把选择器筛选改为“全部”，并等首次模型资料下载完成。
模型还没有添加时，先同步列表或手动添加。
模型信息更新会改掉我的密钥或自定义设置吗？
不会。模型资料更新不修改服务商地址和密钥，也不重写手动保存的模型改动。没有覆盖的默认字段会跟随新资料。
从电脑同步所选服务商则会更新其地址和密钥，这两种更新不同。详见模型更新和电脑导入。
同步模型失败，为什么仍能聊天？
服务商的模型列表接口与对话接口分开，可能只支持后者。用平台提供的模型 ID 手动添加并检查连接即可；原有模型不会因同步失败被清空。
“远端未返回”也不代表模型下线，见模型同步说明。
401、403、404、429 分别怎么处理？
| 提示 | 优先检查 |
|---|---|
| 401 / 未授权 | 密钥是否完整、有效、已保存并启用 |
| 403 / 无权限 | 账号、地区、目标模型或组织权限是否允许访问 |
| 404 / 不存在 | 基础地址、接口和模型 ID 是否正确，是否重复拼接了请求路径 |
| 429 / 请求过多 | 等待限流恢复，检查账户额度和请求限制，不要连续重复发送 |
| 网络失败 / 超时 | 当前网络能否访问服务商，代理与平台服务是否正常 |
| 内容过长 / 请求过大 | 减少附件或历史内容、换更合适的模型，不要只把上限数字调大 |
有些平台使用不同错误码，结合错误详情与平台说明判断。配置项的填写方法见服务商与模型。
已经修改，为什么没有生效？
- 已有服务商地址和密钥开关自动保存；密钥编辑弹层仍需点击自己的保存。新建服务商、手动模型添加和模型编辑按页面继续、添加或保存。
- 已有智能体编辑、默认模型选择、模型列表中的接口切换：自动或立即保存，注意是否出现失败提示。
- 连接检查或同步前先完成密钥弹层，处理配置保存失败提示。
- 更改全局默认模型：不会改掉已有智能体自己的模型选择。
为什么不能删除某个模型？
它可能正被设为全局默认模型。先到 设置 → 默认模型 更换或清除，再删除。删除智能体正在使用的其他模型后，需要为该智能体重新选模型。
图片能预览，为什么不能发给模型？
预览和模型输入是不同能力。选择支持视觉的文字模型，检查图片格式、张数和大小。给模型勾选“图片能力”不会让不支持视觉的模型看懂图片。
文档解析为空、扫描 PDF 或大文件的处理见对话与文件。
为什么输入框没有联网开关或插件按钮？
联网搜索开关不在输入框中。标准模式下在智能体编辑页开启能力，从插件页配置来源偏好与外部服务；极简模式仅使用可用的模型自带联网。插件和技能需要标准模式及可用连接或绑定。
插件已连接后可在对话中使用，也可通过 ＋ → 插件 明确指定。详见联网搜索和插件连接。
插件授权完成后一直在等待，怎么办？
返回 Cherry Studio 检查状态，完成账号或工作区确认。可以重新打开授权页或再次检查；过期时重新发起。组织权限不足时，先在服务商侧申请权限。
钉钉的额外行为授权完成后需要重新发起原操作；企业微信链接需在有效期内在企业微信中打开。详见插件连接。
为什么只剩最新回答能重新回答？
重新回答会原地替换最新回答，较早内容改换方向请创建分支。重试、删除都不会撤销已经执行的外部操作，重试也可能产生新费用。详见回答操作。
“已压缩上下文”会删除聊天吗？
不会删除可见聊天记录。这表示把早期信息整理成摘要供模型继续使用，摘要可能不包含所有原文细节。需要精确引用时重新提供关键材料，详见长对话说明。
导出的图片为什么有多张、代码不完整？
长对话默认分页，以保持阅读清晰；也可以选单张长图。图片中的代码块只展示有限区域，要保存完整代码请选择 HTML 或 Markdown。图片格式转换失败时可能回退其他格式，分享前查看预览与格式名称。
选择范围、水印、思考内容和文件保存说明见分享与导出。
后台没有通知，或锁屏后生成中断
确认 设置 → 通知 中相关开关与系统通知权限。系统仍可能限制后台运行；回到原对话或绘图查看状态，再决定是否重新提交。详见后台回复与通知。
手机与电脑会自动同步聊天记录吗？
本机与电脑聊天不会自动合并。配置导入只复制服务商和模型；切换到电脑后可以查看并操作远程智能体会话，记录仍由电脑保存。换机前使用备份与恢复。
Android 禁止安装，或 TestFlight 无法加入
使用官方下载入口，国内 Android 用户优先下载 APK，iPhone / iPad 用户从国区 App Store 安装；Google Play 作为 Android 的可选入口。使用 APK 时，Android 按系统提示允许当前下载应用安装 APK；体验 iPhone / iPad 测试版时，先安装 TestFlight，再打开邀请。TestFlight 名额、测试版本有效期或平台服务异常也可能影响测试版安装。
完整步骤见下载与安装。
工具不执行、文件没有保存，去哪里查？
- 模型只回答文字、等待批准或提示权限不足：见让 AI 使用工具，逐项检查模型、能力开关、连接与权限。
- Android 打开系统日历，或日程写入结果不确定：见日历与提醒事项，先核对已有记录，避免重复新增。
- 定位失败、健康记录为空或只有部分数据：见位置与健康记录。空结果不能直接理解为没有记录。
- 回答只有代码块，没有可以打开的文件，或修改没有覆盖原件：见生成与修改文件。
- 想要 PPT，但只有 HTML，或转换后的文字无法单独编辑：见HTML 转图片与 PPT。
新功能找不到入口，或操作结果不符合预期
| 问题 | 去哪里处理 |
|---|---|
| 技能装好了却没使用 | 检查标准模式、智能体绑定和技能的实际工具需求，见技能 |
| 文件不见了，或想撤销删除 | 在文件库打开最近删除；聊天删除不在此恢复，见文件库 |
| 新对话读不到项目文件 | 关联同一文件夹工作区或重新添加附件；更换工作区不会自动搬移旧文件 |
| 备份提示忙碌、不兼容或空间不足 | 先结束任务，检查备份来源和可用空间，见备份与恢复 |
| 找不到翻译，或译文没保存 | 只支持本机已完成的文字回答；检查翻译模型，未完成译文不保存，见翻译 |
| MCP 没有交互界面或提示词 | 检查服务器是否提供该能力、是否已连接并绑定当前智能体，见插件 |
| 回复失败但后续消息还在执行 | 查看等待队列，移除不需要的待发送消息；不要把退出页面当作取消 |
| 旧版没有健康或新功能 | 查看关于中的版本，原生能力变更需要新版安装包，见安装与更新 |
如何提交仍未解决的问题？
优先打开 设置 → 关于 → 意见反馈，填写步骤、预期和实际结果，再提交。应用附带最近 24 小时的错误、请求概况和系统信息；成功后可复制报告 ID，从 反馈记录 查看进度。
摇一摇反馈默认关闭，开启后可在前台截取当前页面并打开表单。截图仅在本次选择附带并提交时上传；检查是否包含私密内容。删除本机反馈记录不撤回已提交的报告。
也可在 App 仓库 Issues 提交版本、设备、复现步骤与错误提示。不要公开密钥、私人对话或完整备份，数据范围见隐私说明。