Kikoeru 首次启动初始化：打开 Web 界面后要做的三件事

打开 Web 界面

浏览器访问部署好的地址（Docker 是 http://服务器IP:映射端口，Windows 是 http://localhost:8888），应该能看到 Kikoeru 的主界面。

第一步：添加音声根文件夹

进入 设置 → 音色库（或类似的目录管理页面），找到"添加新文件夹"按钮：

• Docker 用户：填容器内路径，比如 /usr/src/kikoeru/VoiceWork
• Windows/npm 用户：填真实绝对路径，比如 D:\ASMR

填完点"添加"，根文件夹就会出现在列表里。如果有多个根文件夹，依次添加即可。

第二步：触发首次扫描

进入 设置 → 扫描，点 "扫描本地音色库" 按钮。

扫描过程是异步的——你可以继续浏览其他页面。扫描进度会通过 Socket.io 实时推送到 Web 界面，底部或侧边有进度条/日志。

首次扫描可能需要几分钟到几十分钟，取决于音声库的大小和文件数量。

第三步：确认元数据抓取

扫描完成后，回到首页或"全部作品"页面，看看：

1. 作品数量是否大致等于你文件夹里的目录数
2. 点开一个作品，是否有封面、标题、标签、作者
3. 如果某个作品信息不全（封面缺失、标签为空），通常是番号匹配失败——文件夹名格式不规范或 DLSite 上没有对应条目

关于文件夹命名的建议

Kikoeru 靠文件夹名去 DLSite 匹配元数据。最稳妥的格式是：

RJ12345/            ← DLSite 番号
  ├── 01-xxx.mp3
  ├── 02-xxx.mp3
  └── cover.jpg（可选）

如果你的文件夹名是中文标题，扫描器可能无法自动提取番号——这时元数据会缺失，需要手动处理或先整理一下目录结构。

扫描完成后做什么

• 开始搜索和筛选，验证标签系统是否如预期工作
• 用 Web 播放器播一首试试，确认音频能正常加载
• 给自己常听的几个作品打个星标，验证收藏功能
• 如果启用了 iOS / Android 客户端，现在可以在手机上配置服务器地址了