插件安装指南
Ting Reader 支持通过插件扩展功能。通过安装插件，您可以支持更多的音频格式或从更多的来源获取书籍元数据。
1. 准备工作
在安装插件之前，请确保您已经正确配置了插件目录的映射。
Docker 部署检查
检查您的 docker-compose.yml 文件，确保包含 /app/plugins 的映射：
volumes:
- ./plugins:/app/plugins # 必须映射此目录
- ./data:/app/data
- ./storage:/app/storage如果未映射该目录，请添加映射并运行 docker-compose up -d 重启容器。
2. 下载插件
访问 插件中心 浏览并下载您需要的插件。
插件类型说明
通用插件 (JS / WASM)
例如 ximalaya-scraper-js 或 ypshuo-scraper-wasm。
这类插件通常与操作系统无关，下载后直接使用即可。
原生插件 (Native)
这类插件依赖于操作系统和 CPU 架构，必须下载对应的版本。
原生插件版本选择
| 文件名标识 | 适用环境 |
|---|---|
| linux-x86_64 | 通用 Linux 服务器、群晖/威联通 NAS (Intel/AMD CPU) |
| linux-aarch64 | 树莓派、群晖/威联通 NAS (ARM CPU)、Oracle Cloud ARM |
| windows-x86_64 | Windows 桌面版或服务器 |
3. 安装与生效
- 下载插件
从插件中心下载所需的插件文件（通常是
.zip压缩包文件）。 - 上传安装
登录 Ting Reader 管理后台，进入「后台管理」-「插件管理」。
点击右上角的「安装插件」按钮，选择下载的插件文件进行上传。提示：Ting Reader 的插件系统支持热插拔，安装后立即生效，无需重启容器。 - 验证状态
安装完成后，新插件将出现在插件列表中，状态应显示为 Active。