Audiobookshelf 自托管有声书与播客服务器 API

要解决的具体问题

自托管 Audiobookshelf 之后，有声书、播客、媒体库和收听进度通常会散落在同一个服务器里，但 AI 代理并不一定天然知道如何操作它们。如果工作流只能依赖人工导出、手动复制进度，或临时拼凑脚本，那么“继续听上次的书”“查找某本书的元数据”“确认新播客剧集是否已下载”这类任务就会变得割裂且容易出错。

这个技能要解决的是：让代理把 Audiobookshelf 当作一个可访问的自托管服务，而不是一个只存在于用户机器上的孤立播放器。

技能如何工作

该技能围绕 Audiobookshelf 的 REST API 展开，将代理工作流中常见的媒体库操作拆成可调用的步骤。核心能力包括：

• 媒体库管理：代理可以访问和操作自托管媒体库，而不是仅生成一份静态清单。
• 收听进度跟踪：适合处理“接着上次听”“查看某本书的进度”这类依赖播放状态的任务。
• 元数据搜索：可用于查找有声书或播客的标题、作者、作品信息等元数据。
• 播客剧集下载自动化：代理可以在合适时机触发或协调播客剧集下载流程，减少人工介入。

典型工作路径是：代理先理解用户意图，例如“继续播放某本书”“查找某个播客的新剧集”或“确认媒体库中是否有指定内容”；随后通过 REST API 查询库、进度或元数据；如果任务需要副作用，再执行更新进度或下载剧集等操作；最后把结果整理回上游工作流。

适用边界与注意点

这个技能适合已经有可用 Audiobookshelf 实例、并能通过网络访问其 API 的场景。它不会替用户部署、升级或修复上游服务；如果 Audiobookshelf 的鉴权方式、数据模型或 API 行为发生变化，应以上游项目为准。

在敏感工作流中使用前，建议先审查上游项目，因为安装说明无法自动提取。另外，进度更新和剧集下载都属于副作用操作，代理在执行前最好确认权限范围和操作目标，避免误更新媒体库或触发不必要的下载。