前言¶
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
