前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者扩展其功能。在智能体开发与日常使用中，直接在聊天界面内收听音频内容是一个常见需求。dsh-ximalaya 插件通过接入喜马拉雅的接口，在 DSH 的 Web 界面中实现了专辑搜索、曲目播放、收藏管理与模型工具调用，使 Agent 能够直接控制音频流。
插件介绍¶
dsh-ximalaya 是由开发者 jerryqx 维护的联网工具类插件。它解决了智能体无法直接获取外部音频流、需手动切换网页播放器的问题。插件通过 Host 端代理喜马拉雅接口，在 Web 端提供常驻播放条与面板，同时注册了 ximalaya_play 模型工具，允许 Agent 通过对话直接控制播放。
核心功能¶
插件提供了从搜索、播放到数据同步的完整音频收听链路：
- 内容搜索与浏览：支持按关键词搜索专辑、播客或有声书。搜索结果以卡片形式展示，包含封面、主播、分类、集数、完结状态及播放量。曲目列表支持分页加载（每页 30 集），点击即可播放。
- 常驻播放条：聊天输入区上方常驻播放控制栏。支持播放/暂停、上一集/下一集、进度拖动、音量调节、倍速播放（0.75x–2x）以及快进/快退（默认 15 秒，右键可修改步长）。
- 用户数据管理：
- 收藏的声音：展示账号收藏的列表，分页加载，点击即播。
- 我的订阅：展示订阅的专辑，包含最新更新提示。
- 关注的主播：展示主播头像、简介、粉丝数及专辑数。
- 模型工具集成：注册了
ximalaya_play工具。Agent 可通过query参数按关键词搜索播放，或指定albumId/trackId播放，支持action参数控制暂停、继续、停止或切换曲目。 - 云端同步与流代理：订阅、收藏、关注等数据支持云端写回，与手机 App 实时同步。音频流由 Host 端解析并转发，支持 Range 请求与断点续传。
- 扫码登录：支持扫码登录喜马拉雅账号，用于播放 VIP 或付费内容（免费内容无需登录）。
安装与启用¶
安装前需确保已安装 DeepSeek Harness CLI，且 Node 版本不低于 20。
# 替换 <profile> 为你的实际 profile 名称（如 web）
dsh plugin --profile <profile> add dsh-ximalaya
安装完成后，重启 dsh web 并刷新页面。聊天输入区上方会出现「📻 喜马拉雅」播放条，点击右侧「🔎」可打开操作面板。
使用方法¶
- 搜索播放：在面板「搜索」页输入关键词（如「三体」「郭德纲」），点击专辑卡片，再点击曲目播放。
- Agent 控制：在对话框中输入指令，例如「用喜马拉雅播放三体」，Agent 会调用
ximalaya_play工具响应。 - 扫码登录：在面板「我的」页点击扫码登录，用于播放 VIP 或已购内容。
- 倍速与控制：点击播放条上的
1.0x循环切换倍速；点击🔊调节音量；右键⏪/⏩按钮可自定义快进/快退的步长。 - 查看订阅与收藏：登录后，在面板「我的」页可查看「♥ 声音」（收藏列表）、「📻 订阅」（专辑列表）及「👤 主播」（关注列表），点击任意条目即可播放。
注意事项¶
- 接口性质：插件通过非官方接口访问喜马拉雅内容。仅供个人学习、技术研究与日常试听使用，严禁用于任何商业用途、公开传播、二次分发或盈利行为。
- 账号风险：扫码登录可能触发喜马拉雅的账号风控机制，封禁风险由使用者自行承担。
- 功能限制：
- 收听历史：不支持同步（网页端无相关接口）。
- 播放限制：免登录可播全部免费专辑；付费/VIP 内容需登录且有权限。
- 进度卡顿：音频拖动进度后，若超过约 10 分钟，Host 端缓存过期可能导致卡住，需暂停后重新点击播放。
- 新增限制：出于风控原因，插件内仅支持「取消收藏/取关」，不支持新增收藏或关注，需在手机 App 或网页端操作。
- 专辑状态：部分专辑可能已下架，或提示需登录/购买权限。
结语¶
dsh-ximalaya 为 DeepSeek Harness 用户提供了一个在本地环境内直接收听喜马拉雅内容的方案，并通过模型工具将音频控制能力赋予 Agent。使用时请遵守版权规定，并注意账号安全。
- 目录页：dsh-ximalaya - SkillHub
- GitHub：jerryqx/dsh-ximalaya
