Auto-Generate docs 🤖

docs/issues/99.md

@@ -7,18 +7,7 @@ title: 💬 FAQ问题集合
 > [!NOTE]
 > 这个 issue 用来总结报错日志和对应的解决方法。
 
-## 为何网页能控制播放，语音口令不行
-
-语音口令功能默认关闭，需要去设置页面打开【获取对话记录】开关。请谨慎打开这个功能，可能会因为频繁请求导致登陆失败的问题，建议不使用的时候随手关闭。
-
-## ❓  XIAOMUSIC_HOSTNAME 怎么填
-
-填写 docker 主机的 ip ，**不是小爱音箱的ip**，一般就是网页访问的后台地址里的 ip ，只要确保 ip 和小爱音箱在一个局域网内就行。
-
-同时也支持 xx.xx.com 的域名格式，用于配置反代供外网访问，比如小爱音箱和 docker 主机不在同一个局域网内。
-
-
-## ❓  Login Failed 登陆失败
+## Login Failed 登陆失败
 
 表现就是 **后台看不到设备列表** ，日志中会有对应的报错。
 
@@ -35,7 +24,9 @@ title: 💬 FAQ问题集合
 
 如果是在 openwrt 类路由器系统上安装的，请检查路由器的防火墙设置。
 
-## ❓  网页后台可以播放，语音控制无效
+## 网页后台可以播放，语音控制无效
+
+语音口令功能默认关闭，需要去设置页面打开【获取对话记录】开关。请谨慎打开这个功能，可能会因为频繁请求导致登陆失败的问题，建议不使用的时候随手关闭。
 
 这种情况是拉取不到对话记录导致的。
 如果是首次在网页后台保存 did 后需要重启一次容器。
@@ -43,7 +34,7 @@ title: 💬 FAQ问题集合
 还有一种情况是配错了唤醒口令，可以在小爱音箱app里查看对话记录，也可以查看 xiaomusic 的日志。默认口令前缀是【播放歌曲】，没有这个前缀是无法识别的，说播放音乐是没用的，除非自己设置其他口令词。
 已知 `M01/XMYX01JY 小米小爱音箱HD` 获取对话记录的接口比较特殊，需要开启【特殊型号获取对话记录:】开关才能正常语音控制。
 
-## ❓  日志显示正在播放，却没有声音
+## 日志显示正在播放，却没有声音
 
 可以点击播放链接按钮，看看默认的那个链接能否播放。
 
@@ -61,11 +52,11 @@ title: 💬 FAQ问题集合
 
 如果是在 windows 上安装的，请关闭防火墙。另外ip别填localhost，填192开头的那个ip.
 
-## ❓  无法播放 flac 格式歌曲
+## 无法播放 flac 格式歌曲
 
-因设备差异和文件格式差异，已知部分设备不支持 flac 格式，比如 L05B L05C 。
+因设备差异和文件格式差异，已知部分设备不支持 flac 格式，比如 L05B L05C 。建议提前用其他工具批量把文件格式转为 mp3 ，也可以在后台设置里打开【转换为MP3】，但是会比较消耗 CPU ，会影响体验。
 
-## ❓  docker 镜像拉取失败
+## docker 镜像拉取失败
 
 请更换镜像源或者使用代理。不同环境更换镜像源的方式不一样，可以网上搜索自己的 NAS 如何更换镜像源。
 
@@ -78,11 +69,11 @@ docker tag m.daocloud.io/docker.io/hanxi/xiaomusic:latest hanxi/xiaomusic:latest
 
 更多镜像源见 </issues/398.html>
 
-## ❓  启动失败，日志中出现 RuntimeError: can't start new thread
+## 启动失败，日志中出现 RuntimeError: can't start new thread
 
 一般是 docker 版本太低，或者系统限制了 docker 使用的 cpu 数量，可以尝试升级 docker 到最新版本。
 
-## ❓  DNS 解析错误
+## DNS 解析错误
 
 一般会出现下面这样的日志，表现就是设置页面看不到设备列表。
 
@@ -94,14 +85,7 @@ aiohttp.client_ _exceptions. ClientConnectorError: Cannot connect to host accoun
 
 如果还是不行可以把 docker 的网络模式改成 host 模式。
 
-
-## ❓  点击播放后需要很久才开始播放的问题
-
-这个问题新版本已经解决，如果还存在请反馈。
-
-~目前0.3.x版本还存在这个问题没有完全解决，可以暂时回退到0.2.0版本继续使用。~
-
-## ❓  如何配置多个歌曲目录
+## 如何配置多个歌曲目录
 
 ```yaml
 services:
@@ -118,11 +102,11 @@ services:
       - /data/xiaomusic/conf:/app/conf
 ```
 
-冒号左边的 `/data/music1` 和 `/data/music2` 改成你的目录即可。如果你是 windows 的 docker ，可以改成 `D:/music1` 和 `D:/music2`，盘符号开头，用 `/` 分割。
+冒号左边的 `/data/music1` 和 `/data/music2` 改成你的目录即可。如果你是 windows 的 docker ，可以改成 `D:/music1` 和 `D:/music2`，盘符号开头，用 `/` 分割。配置多个歌曲目录时，冒号右边不要有单独的 `/app/music` ，都只能是 `/app/music/` 的子目录。
 
-如果是 docker 部署的，建议不要去修改 web 后台里的音乐路径和配置路径等等所有路径除非你熟悉 docker 的目录映射机制。
+另外如果是 docker 部署的，建议不要去修改 web 后台里的音乐路径和配置路径等等所有路径除非你熟悉 docker 的目录映射机制。
 
-## ❓  能不能中文名
+## 能不能中文名
 
 ```yaml
 services:
@@ -139,15 +123,15 @@ services:
       - /data/xiaomusic/conf:/app/conf
 ```
 
-## ❓  能不能多层目录
+## 能不能多层目录
 
 可以，每层的每个目录会识别为一个播放列表。
 
-##  ❓  是否需要手动获取 did
+##  是否需要手动获取 did
 
-新版本不需要手动获取配置 did，不需要配置环境变量，直接在 web 后台填入小米账号密码保存后会自动获取到 did ，然后勾选对应的设备即可。
+不需要手动获取配置 did，不需要配置环境变量，直接在 web 后台填入小米账号密码保存后会自动获取到 did ，然后勾选对应的设备即可。
 
-## ❓  报错 601
+## 报错 601
 
 报错日志大致如下:
 
@@ -157,15 +141,15 @@ Exception: Error https://api2.mina.mi.com/remote/ubus: {"code":601,"message":"il
 
 原因是没有配置 did ，或者 did 配置错误。可以到设置页面选择正确的设备类型和 did 然后保存。
 
-## ❓ 新功能没有生效
+## 新功能没有生效
 
 在设置页面重新保存一下，或者删除 setting.json 文件，重新在后台设置一次。
 
-## ❓ 为什么会先说小爱音箱自带的回答，再说下载中或者过一会儿才播放本地歌曲
+## 为什么会先说小爱音箱自带的回答，再说下载中或者过一会儿才播放本地歌曲
 
 设计原理就是每秒不停的抓取对话记录，然后再打断小爱音箱自带的处理流程。整个过程下来会有延时，所以打断不会很及时，做不到无缝衔接。
 
-## ❓ 云服务器上能否安装
+## 云服务器上能否安装
 
 可以安装，登录 mi.com 这个步骤可以使用终端里的浏览器 [carbonyl](https://github.com/fathyb/carbonyl) 来操作：