# 壁纸声伴：常见问题与故障排查

> 图文版说明：配图来自真实程序控件，使用独立演示数据。截图中的路径和规则数值仅为示例，未连接真实壁纸、个人配置或语音服务。查看或转换 PDF 时，请保留本 Markdown 旁的 `images` 文件夹；建议下载包含配图的说明包 ZIP。


适用：v0.8.1 文档基线。先看运行记录，按“音频 → 配置 → 触发”顺序排查。

## 1. 按 F8 / 点击鼠标没声音

![图 1 · F8 示例：键盘事件的完整填写方式](images/05-rule-keyboard.png)

*图 1 · F8 示例：键盘事件的完整填写方式*

**看图操作：按位置找到控件**

| 图中位置 | 操作与核对 |
|---|---|
| 顶部“① 触发分类” | 选择“按事件触发”。 |
| “事件分类”“键盘方式” | 分别选择“键盘触发”和“指定按键或组合键”。 |
| “绑定按键”右侧“录制按键” | 点击录制后实际按 F8；图中已显示 F8。 |
| “② 播放什么” | 首次测试选择“从语音总目录随机选取”，避免分类/关键词干扰。 |
| “更多设置 → 规则冷却” | 图中 5 秒仅为测试示例，还要满足全局冷却。 |
| 右下角“保存规则” | 返回列表后再保存配置与规则，并回到桌面按 F8。 |

> 完成标志：返回桌面后按 F8 可听到语音，再次触发前等待两级冷却。



1. 随机试听；无声则查文件、路径、Windows 输出设备和音量。
2. 有试听则核对当前播放配置已启用、规则已保存、没有暂停或全屏暂停。
3. 默认要回到桌面再触发；配置窗口内操作不响应。
4. 检查录制按键、规则启用、生效时间、文件名关键词、分类、规则冷却和全局冷却。
5. 查看运行记录是否触发、是否有可播放候选。

## 2. BGM 不播，语音却正常

![图 2 · 资源页下半部：排查 BGM 防冲突暂停](images/03-audio-policy.png)

*图 2 · 资源页下半部：排查 BGM 防冲突暂停*

**看图操作：按位置找到控件**

| 图中位置 | 操作与核对 |
|---|---|
| 资源页右侧滚动条 | 向下滚动，找到“原壁纸声音与防冲突”。 |
| “防冲突策略” | 默认对有声证据或无法确认的壁纸暂停伴随 BGM。 |
| “手动覆盖检测” | 只有自行确认原壁纸已静音/无声时，选择对应覆盖项。 |
| 底部“保存配置”与播放器 | 保存后观察暂停状态；BGM 暂停与暂停伴随不同。 |

> 完成标志：知道音乐是手动暂停、防冲突暂停，还是路径/音量问题。



检查文件夹 BGM 开关、BGM 音量、手动暂停、防冲突暂停与目录。默认策略在原壁纸“有声音证据”或“无法确认”时都可暂停伴随 BGM。已自行静音原壁纸时，手动覆盖检测结果并保存。

## 3. 导入台词后为什么没有声音

台词 JSON/TXT 只包含文字。需通过语音服务生成 WAV，或导入自己的音频。导入不会启动模型或自动调用收费接口。

## 4. WAV 已生成，为什么规则找不到

检查生成输出目录和配置绑定目录是否相同；分类生成位于分类子目录；关键词可能过滤掉文件。修改台词不会自动改名或重做旧音频。

## 5. 固定时刻没触发 / 随机规则没有马上说话

固定时刻需程序在该分钟运行且满足播放条件，过时不补播。随机规则启用后先等待随机间隔。检查本地时间、时段和冷却；跨午夜可设 `22:00–06:00`。

## 6. 壁纸识别错误或切换延迟

检查 WE 安装目录、工坊目录、跟随显示器（从 0 编号）和手动模式。WE 保存当前配置有延迟，尝试“立即检测”。必要时先手动使用选中配置测试。

## 7. 暂停 BGM 和暂停伴随有什么区别

暂停 BGM 只停音乐，语音仍可播放；暂停伴随同时停声伴语音触发和 BGM，不控制 Wallpaper Engine。

## 8. 多张壁纸共用/误改了台词

查看它们是否绑定同一 `dialogues.json`。到资源模式弹窗选择专用台词目录。更改共享根目录不会自动迁移已有绑定或旧文件。

## 9. 删除配置为什么没删音频

这是保护资源的设计，避免影响其他配置。音频库中“移入回收站”才操作真实文件；删除共享音频前核对引用范围。

## 10. 云端“检测连接”成功但不能生成

云端连接检测主要验证地址格式。实际生成还要鉴权、额度、模型/音色有效，以及支持的返回格式。兼容 TTS 需要完整 `/audio/speech` 地址并返回 WAV，远程使用 HTTPS。先生成一条短句查看错误。

## 11. GPT-SoVITS 无法启动或报错

检查包含 `api_v2.py` 的项目目录、Python 环境、配套 `.ckpt`/`.pth`、版本、参考音频及逐字原文、语言代码、端口和显存。查看数据目录 `sovits-api.log`。扫描候选不保证权重兼容；扫描和保存角色不会提前加载模型。

## 12. 参考音频原文应该填什么

逐字填写参考音频说的话，不能填待合成台词，也不能凭角色名字猜测内容。模型、参考音频、原文和语言一起影响合成结果。

## 13. 会结束其他程序启动的 GPT-SoVITS 吗

退出会回收声伴自己启动的 API；外部已运行 API 不会被关闭。允许切换外部模型会改变全局状态，应确认其他客户端不受影响，或使用独立端口。

## 14. 关闭窗口还在运行 / 自启会加载 AI 吗

关闭窗口通常留在托盘，从托盘“退出”才停止。登录自启默认关闭，开启后也不会提前启动 GPT-SoVITS。只有实际生成才按需启动。

## 15. 软件更新要备份哪里

安装版配置：`%LOCALAPPDATA%\WallpaperCompanion`；便携版配置：程序旁 `data`。还需备份程序目录 `shared`、外部自定义音频/台词目录和自己的插件。保存并从托盘退出后再更新。互动 JSON 不包含音频和密钥，不能替代完整备份。

## 16. 能离线使用吗 / 会修改 WE 吗

本地已有音频和规则可以离线运行。云端 TTS、下载等需要联网。本程序独立运行，不修改 WE 本体及已下载壁纸。

## 17. 我下载的是源码压缩包，为什么没有 EXE

普通用户应到最新 Release 的 Assets 下载 `*-setup.exe` 或 `*-portable.zip`。GitHub 的 Source code 需要开发环境，不是发行程序。

## 18. 怎么反馈

![图 3 · 运行记录：把问题定位到具体环节](images/11-runtime-log.png)

*图 3 · 运行记录：把问题定位到具体环节*

**看图操作：按位置找到控件**

| 图中位置 | 操作与核对 |
|---|---|
| 左侧“运行记录” | 查看真实使用中的触发、播放和错误消息。 |
| 右侧记录文本区 | 图中明确标记为教程说明，非真实成功记录。 |
| 反馈时复制相关记录 | 一并提供版本、复现步骤和试听结果，遮住私人信息。 |

> 完成标志：能够区分“没有触发”“没有匹配文件”和“文件不能播放”。



前往 https://github.com/Abs0lutely/wallpaper-companion/issues ，提供版本、Windows 版本、安装版/便携版、复现步骤、相关运行记录和试听结果。遮住 Key 和私人信息。详细操作见《Wallpaper-Companion-Manual-zh-CN.md》。