前言¶
DeepSeek Harness(DSH)把能力拆成插件,開發者可以在設置裏擴展界面與後臺邏輯。若你希望在本地託管環境裏接入網易雲「一起聽」——掃碼或 cookie 登錄、粘貼邀請鏈接進房、把換歌和聊天記在本機,並可選綁定某個 DSH 會話,用該會話的人格自動回房間消息——而不依賴額外中間服務,社區插件 dsh-listen-together(維護者 WEATER604,GitHub WEATER604/dsh-listen-together)就是面向這一場景的獨立實現:數據默認落在本機目錄,請求直連 music.163.com。
下面介紹插件定位、已文檔化的能力、安裝方式與典型用法;安裝前請自行審閱源碼與 MIT 許可證,插件以當前 DSH 進程權限運行。
這是什麼¶
dsh-listen-together 是 DSH 用的網易雲「一起聽」插件:在 設置 中單開一欄「一起聽」,登錄一個網易雲賬號,粘貼邀請鏈接即可進房;房間裏的消息記在該欄,還可綁定一個 DSH 會話,讓回覆沿用該會話的人格。
插件不依賴其他項目或服務,賬號與記錄均存儲在本機。當前 package 版本爲 0.3.0,運行環境要求 Node.js >= 22。社區目錄分類爲「聯網工具」,可在 SkillHub 插件頁 查看條目(該目錄爲社區站點,與 DeepSeek / 幻方無官方從屬關係)。
核心功能¶
以下能力均來自項目 README,使用時請以倉庫最新說明爲準。
登錄
- 網易雲 App 掃碼(本地生成二維碼),或直接粘貼
MUSIC_Ucookie。
進房
- 粘貼「一起聽」邀請鏈接;長鏈、手機分享文案、電腦版
163cn.tv短鏈均可識別,粘貼後會提示雙人或多人房間。
在場
- 定時心跳,並跟隨房間同步當前歌曲(雙人房當前歌信息來自
playlist/get的playCommand)。
說話
- 多人房使用房間聊天室;雙人房無官方房間聊天接口,插件通過網易雲私信發送(記錄中會標註)。
記錄
- 進房、換歌、收發消息各記一條,可在插件內翻閱。
自動退出
- 可設置「聽滿 N 分鐘」或「聽滿 N 首歌」後自動退房;兩項均爲 0 表示不啓用。
人格與自動回覆
- 綁定一個 DSH 會話後,房間新消息可交給該會話生成回覆併發回;房間解散後仍可繼續回覆私信(插件會記住上次一起聽的對象)。自動回覆需要綁定正在使用或可恢復的 DSH 會話;文檔建議不要綁定你正在主界面聊天的同一會話,以免回覆與對話混在一起。
安裝與啓用¶
官方說明通過將插件目錄鏈接進 DSH profile 的 node_modules,並在 package.json 中聲明依賴與 bundle,而非 dsh plugin add 一類命令。Windows PowerShell 示例:
$profile = "$env:USERPROFILE\.dsh\profiles\desktop"
$src = "<插件目錄>" # 例:D:\plugins\dsh-listen-together
New-Item -ItemType Junction -Path "$profile\node_modules\dsh-listen-together" -Target $src
再編輯 $profile\package.json:
- 在
dependencies增加:"dsh-listen-together": "link:<插件目錄>" - 在
dsh.profile.bundles增加一項:"dsh-listen-together"
保存後刷新 DSH 頁面;若設置中未出現「一起聽」,完整退出並重開 DSH 一次。
macOS / Linux 將 New-Item -ItemType Junction 換爲 ln -s,路徑使用正斜槓即可。
典型用法¶
- 打開 設置 → 一起聽。
- 點擊「用二維碼登錄」,用網易雲音樂 App 掃碼;或粘貼 cookie。
- 在網易雲中開啓「一起聽」,複製邀請鏈接,粘貼到「進房間」並點擊「進去」。
- 在「房間記錄」中查看消息與換歌記錄。
- 若需要帶人格的自動回覆:在「綁定 DSH 會話」中選擇會話,開啓「有人說話就自動回一句」,保存。
數據目錄與隱私¶
默認數據目錄爲 ~/.dsh/listen-together/,可通過環境變量 DSH_LISTEN_TOGETHER_DIR 修改路徑。
| 文件 | 內容 |
|---|---|
account.json |
網易雲 cookie(僅本機) |
config.json |
心跳間隔、綁定會話、自動回覆、自動退出等 |
state.json |
當前房間、當前歌曲、上次一起聽的人、上次錯誤 |
chat.jsonl |
房間記錄 |
README 說明:cookie 只寫入本機 account.json,插件不會將 cookie 發給第三方;請求直接發往 music.163.com。
適用場景與注意¶
適合誰
- 已在用 DSH,希望在同一套桌面 profile 裏管理網易雲一起聽進房、記錄與可選 AI 回覆的開發者或高級用戶。
- 接受本機保存登錄態、並自行維護插件目錄鏈接與
package.json配置的用戶。
已知限制(文檔摘錄)
- 雙人房無房間聊天 API,說話走私信;對方未開始放歌時,雙人房當前歌曲可能爲空。
- 多人房聊天接口有頻率與內容限制,發送過快可能被拒。
- 網易雲電腦版發起的一起聽多爲雙人房;多人房多在手機 App 開啓,插件兩種均可進入。
- 房間有時效,對方退出或超時後需重新開房並分享新鏈接。
安全與審閱
- 插件以 DSH 進程權限訪問本機文件與網易雲接口;安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證。
- 修改
lib/下文件後無需重啓 DSH,下一次請求或下一輪輪詢會熱加載(index.js監視lib/修改時間)。
結尾¶
dsh-listen-together 把網易雲一起聽的登錄、進房、同步、記錄與可選 DSH 會話人格回覆收進 DSH 設置頁,數據留在本機。若需條目信息與倉庫地址: