常见问题
快速跳转:
普通问题
我太喜欢这个项目了。我该怎么帮到你们？
普通人
- 让我们知道你喜欢这个项目 ❤️。
- 跟朋友介绍我们项目，在 GitHub 上点星星
- 录视频然后发到社交平台上，不管是聊天视频或是安装教学或是别的都非常欢迎! (如果你愿意发给我们看就更好了，省的我自己去找😎)
- 到社群 (微信, 飞书) 中帮忙其他人 (这对我们帮助真的很大！)
- 在微信、飞书群，或是其他渠道让我们知道我们项目真的有活人在用！
熟悉项目的普通人
- 帮忙补充文档，记录自己遇到的问题
- 如果不知道要怎么编辑文档，可以直接给我发消息
要怎么使用 xxx 大语言模型 API 服务？
请将相关设置，比如 API key, base url 等，填入 openai_compatible_llm 的设置下。 openai_compatible_llm 的意思是所有支持 OpenAI API 格式的 LLM API 都可以填在这里。
如何选择合适的 LLM?
- 如果你希望快速部署且不想下载模型,建议使用 OpenAI Compatible API 或 Groq API
项目支持哪些使用模式?
- Web 模式:通过浏览器访问
- 窗口模式:桌面客户端的默认模式
- 桌宠模式:提供背景透明、全局置顶的桌面数字人体验
- 详细说明请参考模式介绍
怎么启动桌宠模式
- 桌宠模式:提供背景透明、全局置顶的桌面数字人体验
- 详细说明请参考模式介绍
如何获取前端最新版本?
- 目前前端不支持自动更新，可以关注 Github Release 页面获取最新版本。
- 详细说明请参考模式介绍
网页/客户端相关
Web 显示 {"detail": "Not Found"} 怎么办
- 前端代码没有被拉取到本地。出现这个报错说明你没有获取到完整的项目代码。请在项目目录下运行
git submodule update --init --recursive来拉取项目代码。 - 详细请参考 快速开始/1. 获取项目代码 中提到的两种获取项目代码的方式。
使用远程的 Live2D 模型链接，报错 Failed to load LiveD model: Error: Network error 怎么办
- 这通常是因为 Web 使用 HTTP 协议无法加载 HTTPS 资源导致的
- 可以在浏览器设置中允许网站加载不安全内容(Insecure content)来解决:
- Chrome: 点击地址栏右侧的盾牌图标 -> 网站设置 -> 不安全内容 -> 允许
- Firefox: 点击地址栏左侧的锁图标 -> 关闭连接保护
- Edge: 点击地址栏右侧的锁图标 -> 网站权限 -> 不安全内容 -> 允许
麦克风无法使用怎么办
- 请确保已授予浏览器或应用程序麦克风使用权限
- 检查麦克风输入音量是否合适 - 声音过小或过短可能无法触发语音检测。你可以在设置中调整检测阈值，详细设置请参考 Web 模式
- 如果你使用的是 Electron 桌面应用，尝试重启应用。
- 如果以上方法都无效，可以访问 https://www.vad.ricky0123.com/ 测试麦克风功能。如果该网站也无法正常使用麦克风，可能是系统音频设置或硬件问题
桌面客户端无法安装(Windows 已保护你的电脑)或者提示"已损坏"怎么办
- Windows 用户可以点击"更多信息"然后选择"仍要运行"
- macOS 用户需要调整系统设置并执行特定命令
- 详细解决方案请参考模式介绍
远程访问 Web 界面时麦克风/摄像头/录屏无法使用怎么办 (Failed to start screen capture: NotSupportedError: Not supported)
- 这是因为这些功能需要安全上下文(HTTPS 或 localhost)
- 如需远程使用,必须为 Web 服务器配置 HTTPS
- 详细说明请参考模式介绍
iOS 设备上语音功能异常怎么办?
- 这是由于 iOS 的安全限制导致的已知问题
- 需要不断点击才能使说话功能正常运行
- 详细说明请参考模式介绍
Electron 应用切换模式导致屏幕一片空白怎么办
- 属于小概率难以修复的 bug，实测几乎不会触发。
- 等待几秒，或者重启应用即可解决。