# xiaofei-plugin

**Repository Path**: fox-glaze/xiaofei-plugin

## Basic Information

- **Project Name**: xiaofei-plugin
- **Description**: fork自用版xiaofei-plugin
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Yunzai-Bot_xiaofei-plugin

> **自用 fork 版**
>
> 本仓库是 [xiaofei-plugin](https://gitee.com/xfdown/xiaofei-plugin)（原作者：小飞）的**自用 fork 版**，仅按个人使用习惯做了少量调整。
> **原插件的版权与所有权益归原作者所有**，本仓库仅供个人学习交流使用，不做任何商业用途或盈利，如有不妥请联系删除，请优先使用原仓库版本。

[查看更新](./CHANGELOG.md)

#### 介绍

基于原版 xiaofei-plugin 的自用分支，主要差异：

1. `#点歌` 选择歌曲后以【合并转发】发送，合并转发内包含：歌曲信息（歌名/歌手/封面/歌曲链接）、歌词（内嵌一层合并转发）、语音、音乐文件下载直链。
2. `QQBot` 已有独立的 MD 版点歌，合并转发会自动过滤 `QQBot`，其发送方式保持原样。
3. 点歌相关配置支持【锅巴插件】后台可视化修改。
4. 修复缺少 FFmpeg 时语音转换会抛出未捕获异常导致进程崩溃的问题。
5. `QQBot` 发语音不再走高清上传通道（该协议没有对应接口，必然失败并多转一次码），
   改为直接交给适配器转码，只转一次，音质更好，也不会再出现「上传失败…尝试上传普通语音」的提示。

#### 安装教程

请将 xiaofei-plugin 放置在 Yunzai-Bot 的 plugins 目录下，重启 Yunzai-Bot 后即可使用。

推荐使用 git 进行安装，以方便后续升级。在 Yunzai 根目录打开终端，运行

```
git clone https://gitee.com/fox-glaze/xiaofei-plugin.git ./plugins/xiaofei-plugin/
```

#### 使用说明

【点歌】可用命令：【#点歌 #多选点歌 #多选QQ点歌 #QQ点歌 #歌词 #语音 #高清语音 #普通语音】

`#语音序号` 与 `#高清语音序号` 效果一致：都把音频原样交给协议，**不做二次重编码**，音质最好。
如果遇到个别音频发出去不能播放，可以用 `#普通语音序号`，这条会重编码后再发送。

选择歌曲后将以【合并转发】发送，合并转发内包含：歌曲信息（歌名/歌手/封面/歌曲链接）、歌词（内嵌一层合并转发）、语音、音乐文件下载直链（`#听序号` 与直接发送序号效果一致）。`QQBot` 已自带 MD 版点歌，会自动过滤，保持原有发送方式。

【QQ音乐ck】可用命令：【#提交音乐ck #音乐ck检查】

【天气】可用命令：【#天气】

【更新】可用命令：【#小飞插件更新 #小飞插件强制更新】

【原神注册时间查询】可用命令：【#原神注册时间】

【通行证ck转米游社ck】用户只提交通行证ck时，插件自动生成米游社ck并完成绑定。

【代发言】可用命令：【#代@xx 指令 #代203017966 指令】（仅主人可用。）

【帮助】可用命令：【#小飞帮助】

【版本】可用命令：【#小飞版本】

【设置】可用命令：【#小飞设置】

#### 配置

点歌配置位于 `config/music.setting.yaml`，首次运行时会自动从 `config/default/music.setting.yaml` 生成，改完即时生效（无需重启）。

也可以安装 [Guoba-Plugin（锅巴插件）](https://gitee.com/guoba-yunzai/guoba-plugin) 后在后台「插件配置」中图形化修改，锅巴里可修改下面全部配置项。

**点歌配置**（`config/music.setting.yaml`）

| 配置项 | 说明 | 默认值 |
| --- | --- | --- |
| `qqbot_msg_style` | QQBot 发送格式：`1`、`3` Markdown图文+按钮（推荐）；`2` Ark卡片（需要结构化消息权限）；`0` 纯文本+语音 | `3` |
| `forward_enable` | 选择歌曲后是否以【合并转发】发送（仅非QQBot生效） | `true` |
| `forward_voice_group` | 临时语音发送群号。语音需先单独发送一次让服务端补全播放信息，配置后临时语音会发到该群并立即撤回，点歌所在的群看不到；留空则发到当前会话 | 空 |
| `qqbot_voice_fail_tip` | 语音发送失败时是否回复失败提示。关闭时静默降级；开启后彻底发不出去才回复「上传失败！＋音频地址」 | `false` |

**功能开关**（`defSet/setting.system.yaml`，与 `#小飞设置` 对应）

| 配置项 | 说明 | 默认值 |
| --- | --- | --- |
| `music` | 点歌：开启后 `#点歌` 优先由本插件处理 | `false` |
| `is_list` | 默认多选点歌 | `false` |
| `poke` | 戳一戳点歌 | `false` |
| `music_high_quality` | 高品质点歌 | `false` |
| `weather` | 天气：开启后 `#天气` 优先由本插件处理 | `false` |
| `card_weather` | 卡片天气 | `false` |
| `music_source` | 默认音乐源（仅支持 QQ音乐） | `QQ` |

**QQ音乐ck**（`config/music.cookies.yaml`）：可在锅巴后台填写，也可用 `#提交音乐ck` 提交，留空表示不修改原有ck。

> QQ 的合并转发不支持 `file` 元素和 json 卡片元素：音乐文件只提供**下载直链**不发送文件本体，歌曲卡片改为「歌名 + 封面 + 歌曲链接」的文本形式。
>
> 语音会先单独发送一条并随即撤回，用于让服务端补全语音的播放信息（**不补全会导致合并转发里的语音点不开、听不了**），补全后的语音段再放进合并转发。可在配置里填 `forward_voice_group` 指定一个专用群来接收这条临时语音，点歌所在的群就完全看不到它。

#### 免责声明

1.  功能仅限内部交流与小范围使用，严禁将xiaofei-Plugin用于任何商业用途或盈利。

2.  图片与其他素材均来自于网络，仅供交流学习使用，如有侵权请联系，会立即删除。