# 壁纸声伴：第一次使用快速入门

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


适用：v0.8.1 文档基线，Windows 10/11 x64。

## 目标

先用现成音频完成“返回桌面，按 F8，播放一句语音”。此流程不需要 AI 模型、Python 或语音接口。

## 第一步：下载正确的文件

1. 打开 https://github.com/Abs0lutely/wallpaper-companion/releases/latest 。
2. 选择 `*-setup.exe` 安装，或下载 `*-portable.zip` 完整解压。
3. 便携版保留 `_internal`、`portable.flag`，双击 `WallpaperCompanion.exe`。
4. Source code ZIP 是源码，不是普通用户发行包。

## 第二步：绑定壁纸

![图 1 · 陪伴主页：先确认配置，再试听](images/01-home.png)

*图 1 · 陪伴主页：先确认配置，再试听*

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

| 图中位置 | 操作与核对 |
|---|---|
| 左侧“壁纸配置”列表 | 选中要设置的配置；尚未绑定可用“配置管理 → 新建配置”。 |
| 中部“正在编辑”选择器 | 核对编辑对象；不要把编辑配置误当成当前播放配置。 |
| 中部“声音设置”标签 | 调整角色语音、背景音乐及冷却。 |
| 页面下方“随机试听语音”与右侧“保存配置” | 先保存，再试听；自动触发还需回到桌面。 |

> 完成标志：知道正在编辑哪份配置，能找到试听和保存入口。



1. 在 Wallpaper Engine 应用一张壁纸。
2. 启动声伴，点击“立即检测 → 绑定当前壁纸”。
3. 名称、路径正确后，确认启用配置并保存。
4. 暂时识别不到时，可先新建配置并使用手动模式测试。

## 第三步：放入真实音频

![图 2 · 资源与绑定：把音频放到真正使用的目录](images/02-resources.png)

*图 2 · 资源与绑定：把音频放到真正使用的目录*

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

| 图中位置 | 操作与核对 |
|---|---|
| 中部“资源与绑定”标签 | 从陪伴主页进入。 |
| “语音文件夹”右侧“浏览…” | 选择含真实 WAV/MP3 的目录。 |
| “BGM 文件夹”右侧“浏览…” | 选择音乐目录；可按需留空。 |
| “资源根目录”“共用台词文件” | 核对共享位置。图中 D:/WallpaperCompanion 是演示路径，不要照抄。 |
| 右下角“保存配置” | 保存后点左下角随机试听。 |

> 完成标志：随机试听可播放，而不只是填好了一个路径。



1. 准备能正常播放的 WAV/MP3。
2. 放入程序旁 `shared/voice`，或在“资源与绑定”选择已有语音文件夹。
3. 保存配置，点击“随机试听语音”。
4. 试听无声先查目录、文件和音量；不要急着设置复杂规则。

目录示例：

```text
shared/
  voice/
    你好.wav
  bgm/
    music.mp3
```

## 第四步：建立 F8 规则

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

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

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

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

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



1. 打开互动规则，添加启用的“F8 测试”。
2. 选择“按事件触发 → 键盘触发 → 指定按键/组合键”。
3. 点击录制，按 F8。
4. 播放来源先用总目录随机，不填写关键词。
5. 设置适当冷却，保存规则和配置。
6. 回到桌面，确认没有暂停伴随，再按 F8。

## 第五步：增加 BGM 和问候

- BGM：选音乐目录、开启文件夹 BGM、保存，再检查手动暂停和防冲突状态。
- 定时：新增每天固定时刻，设为几分钟后测试；程序需要在该分钟运行。
- 随机：新增时段随机，设置时段和最短/最长间隔；开启后先等待。
- 文字：台词库只存文字，必须生成或导入音频才能播放。

## 完成检查

- [ ] 随机试听有声音。
- [ ] 顶部当前使用的是目标配置。
- [ ] 规则、配置均已保存。
- [ ] 回到桌面后按 F8 能听到回应。
- [ ] 再次触发前等待冷却。
- [ ] 知道关闭窗口留在托盘，退出需要使用托盘菜单。

更多功能见同目录《Wallpaper-Companion-Manual-zh-CN.md》；故障排查见《FAQ-zh-CN.md》。