添加多个音声根文件夹：Kikoeru 支持挂载不同硬盘不同目录的音声库

为什么要多个根文件夹

• 音声文件分散在不同硬盘上（盘满了就接新盘）
• 想按类型分盘（同人音声一个盘、ASMR 一个盘）
• NAS 上不同共享目录（磁盘 1 存 A 系列、磁盘 2 存 B 系列）

Kikoeru 没有"主库"概念——所有根文件夹平等对待，统一扫描、统一搜索。

添加步骤

进入 Web 界面的设置 → 音色库（位置因版本略有差异，可能在侧边栏或顶部菜单）：

1. 找到"添加新文件夹"或"添加根目录"按钮
2. 输入绝对路径
3. 点"添加"
4. 路径就出现在根文件夹列表里了

Docker 用户特别注意

Web 界面里填的路径是容器内路径，不是宿主机路径。

docker-compose.yml 里：

volumes:
  - /host/path/audiolib1:/mnt/disk1      # ← Web 里填 /mnt/disk1
  - /host/path/audiolib2:/mnt/disk2      # ← Web 里填 /mnt/disk2

别填左边的宿主机路径（/host/path/...），容器里根本找不到。

多个根文件夹示例

docker-compose.yml：

volumes:
  - /mnt/nas/audio/RJ:/mnt/audio/rj          # 同人音声
  - /mnt/nas/audio/ASMR:/mnt/audio/asmr      # ASMR 专辑
  - /mnt/nas/audio/非-DLSite:/mnt/audio/misc # 没有番号的杂项

Web 界面依次添加：

/mnt/audio/rj
/mnt/audio/asmr
/mnt/audio/misc

删除根文件夹

点根文件夹旁边的删除按钮即可。删除根文件夹：

• 不会从数据库里删除已扫描的作品（数据库条目保留，但文件路径失效）
• 触发下一次扫描时，文件不存在的作品会被识别为"孤立条目"，可选是否清理

如果你真的删掉了一整个硬盘，先在 Web 界面把对应根文件夹删了，再跑一次扫描，数据库会自动清理失效条目。

验证路径是否正确

添加根文件夹后，可以立即跑一次小范围扫描测试——如果扫描日志显示"找到 N 个文件"，路径就是对的；如果报"目录不存在"，回头检查 docker-compose.yml 里的挂载映射。