dsh-netease-cdp
DeepSeek Harness 网易云点歌插件：CDP 驱动桌面客户端 + 关键词搜索/插播（不碰私有 API 登录）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:DSH-Raising-Plan/dsh-netease-cdp#5bf761e4af97435b45f6a2f2bb1c0c879eba3a71Netease Cdp 以 dsh-netease-cdp 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
用 Chrome DevTools Protocol（CDP） 驱动网易云桌面客户端，做成 DeepSeek Harness 点歌工具。
CDP 控制的是你已经登录的客户端窗口（会员曲库 / 私人雷达跟你本机会话走）；关键词搜索走公开 web 接口，不读 cookie、不碰私有登录 API。
社区插件，与 DeepSeek / 网易云官方无关。
移植自canyueY/netease-cdp。
English: README.en.md
网易云的私有 API 需要登录态、签名和频繁变动的加密参数，维护成本高。CDP 走的是另一条路：
"C:\Program Files\Netease\CloudMusic\cloudmusic.exe" --remote-debugging-port=9222
调试端口只在进程启动参数里生效，运行中改不了。改完要完全退出客户端再开。
dsh plugin --profile web add github:DSH-Raising-Plan/dsh-netease-cdp#plugin/dsh
本地开发需要先装依赖（ws）：
npm ci
npm test
| 工具 | 参数 | 作用 |
|---|---|---|
netease_probe | port? | 探测 CDP 是否可用，并返回当前曲目 |
netease_now_playing | port? | 读取当前曲目 |
netease_search | keyword（必填）、limit（1–20） | 搜索候选（id/name/artists），不播放 |
netease_play | song_id（必填）、force? | 按 song id 点播（force 用于同一首强制重派发） |
netease_play_keyword | keyword（必填）、index?、limit? | 搜索并点播第 N 个候选 |
netease_insert_next | song_id（必填） | 插到“下一首播放”，不打断当前曲 |
netease_play_card | card | 播放发现页卡片：daily / private_radar / heart_mode / private_roam |
netease_next | dom_fallback? | 下一首（Redux 失败时默认点 DOM） |
netease_prev | dom_fallback? | 上一首 |
插件还会在 ctx.netease 上挂搜索/点播能力，供其它插件复用。
端口优先级：工具参数 port > ctx.config['dsh-netease-cdp'].port > 环境变量 NETEASE_CDP_PORT > 9222。
{
"dsh-netease-cdp": { "port": 9222 }
}
netease_probe → 客户端在线？现在在放什么？
netease_play_keyword {"keyword":"夜航星"} → 搜索并播放第一首
netease_play {"song_id":"1234567"} → 精确点播
netease_insert_next {"song_id":"1234567"} → 插队到下一首
netease_play_card {"card":"private_radar"} → 播放私人雷达
| 现象 | 原因 / 处理 |
|---|---|
连不上 CDP 端口 9222 | 客户端没带 --remote-debugging-port=9222 启动，完全退出后重开 |
没有可用的 page | 客户端还没加载完，等几秒再 probe |
Cannot find package 'ws' | 在插件目录执行 npm ci |
| 搜索有结果但播放无效 | 客户端未登录 / 会员曲库受限 / 页面结构变化，先 netease_probe 看状态 |
| 切歌不稳定 | 新版客户端可能改 Redux 路径；netease_next 默认会回退点 DOM |
npm ci
npm test
npm run check
需要 @deepseek-ai/dsh-tools（或设置 DSH_TOOLS_PATH）才能注册工具。
AGPL-3.0-or-later