常见问题
首次安装后没有角色
安装包不内置角色。到 Releases 下载 characters.zip，在 设置 → 角色 导入。不要将图片单独放到应用安装目录。见角色导入与管理。
导入后角色没有更新
已有相同 id 的角色会被跳过，导入不会覆盖修改。请在已有角色编辑器里修改，或为新角色使用不同 id。角色包应包含有效的 character.json 与引用的资源文件。
AI 配置保存成功，但不能聊天
保存只代表本地写入完成。重新测试连接，检查基础地址、Key、模型标识、网络、账号权限与额度。修改配置后旧连接测试结果失效。见配置 AI 服务。
发送图片报错
检查是否使用支持多模态的模型、服务是否接受图片输入，以及附件格式、数量和大小。文字模型即使连接成功也可能无法识别图片。
有回复，但没有语音
检查 启用语音播报 是否开启，引擎是否选为“不使用”，系统音量是否正常。
- CosyVoice：检查 Key、地域、WorkspaceId（新加坡）、模型和角色音色 ID，确认音色属于你的账号。
- GPT-SoVITS：检查服务已启动、API 地址可访问、角色参考音频和转录文本已设置，服务能读取音频路径。
见语音与语言。
桌宠被隐藏或无法点击
使用 Alt + K 唤出 / 隐藏；检查应用是否仍在系统托盘运行。角色透明度与鼠标穿透是不同设置。Linux Wayland 无法像 X11 一样获取全局光标坐标，穿透功能存在限制。
Live2D 不显示或不播放动作
检查 .model3.json 路径、模型引用的 moc3 与纹理文件，以及显示缩放和偏移。动作组必须与模型实际名称一致。见Live2D 角色。
截屏开关开了，为什么还要确认
开关允许 AI 提出截屏请求；每一次实际截屏仍需要单独授权。这是应用的正常行为。截图会发送给当前 AI 服务，在本机只进行内存处理。
升级或卸载会丢失数据吗
升级通常保留用户数据；卸载是否删除由系统与安装器决定。重要角色请提前导出备份。“清除所有本地数据”会删除相关本地数据和凭据，使用前请确认。
如何反馈问题
在 GitHub Issues 提交：
- 应用版本、系统和处理器架构。
- 触发问题的操作与期望结果。
- 实际错误提示、复现频率。
- AI / TTS 服务类型和模型名（适用时）。
- 经检查、去除私人内容的相关日志或截图。
不要公开 API Key、完整私人会话或无关个人文件。