常见问题与排错

先记下手记底部的 版本与构建号。本指南对应 0.3.0-preview.6 / 20261103-appearance.2。

打不开或看不到文治复制标题链接

AI 聊天失败复制标题链接

先到 偏好设置 → 对话 API → 文字聊天，确认配置已保存，再测试一次。

仍无法判断时，到 日志 看这一轮的错误；不要靠反复调大额度解决所有问题。

QQ 没有回复复制标题链接

按顺序排查，不跳过中间步骤：

1. 桌面聊天 是否正常？先排除模型问题。
2. NapCat 登录 是否完成，当前是否为已绑定小号？
3. HTTP服务器是否启用，3000 和桥接访问令牌是否一致？
4. HTTP客户端是否启用，URL 是否为完整事件地址？
5. HTTP客户端 Token 是否与桌宠事件签名密钥一致？
6. 桌宠是否已启用、已确认绑定，事件监听是否运行？
7. 消息是否由绑定的玩家账号发给小号，且为私聊？
8. 查看 最近接收状态 和 发送记录，区分没收到、生成失败和发送失败。

逐项填写位置见 NapCat 配置。不要把 6099、3000、3001 当成同一个端口。

安装 NapCat 报错复制标题链接

没声音、外观不变、台词没生效复制标题链接

更新或恢复后不对劲复制标题链接

1. 确认从托盘退出了旧版，当前只运行一个版本。
2. 核对当前版本和构建号。
3. 恢复备份后完全退出再重启；密钥和 NapCat 登录需另行确认。
4. 暂时回退时使用旧程序目录，保留更新前备份。

不要把删除 %APPDATA%\BunjiPet 作为普通排错步骤，那里有你的资料。

反馈问题时提供什么复制标题链接

复制填写下面几项即可：

桌宠版本与构建：
Windows 版本：
在哪个页面、点了什么：
期待的结果：
实际结果 / 错误原文：
是否每次都能复现：
已检查的步骤：

截图尽量只截相关区域。隐藏 QQ 账号、聊天正文、令牌、API 密钥和二维码；日志检查后再发，不上传整份个人资料目录。