dsh-qqmusic
在 DeepSeek Harness 里控制 QQ 音乐:上一首 / 播放暂停 / 下一首。
两个入口共用同一份实现(Host 里的 control()):输入框下方的遥控条,以及给助手用的 qqmusic_control 工具。
工作原理
不注入进程、不读内存、不模拟按键,只走 Windows 系统媒体会话(SMTC,Windows.Media.Control.GlobalSystemMediaTransportControlsSessionManager):
| 动作 | SMTC 调用 |
|---|---|
| 播放 / 暂停 / 切换 | TryPlayAsync / TryPauseAsync / TryTogglePlayPauseAsync |
| 上一首 / 下一首 | TrySkipPreviousAsync / TrySkipNextAsync |
| 当前曲目与进度 | 会话的 TryGetMediaPropertiesAsync + GetTimelineProperties |
所以它控制的是「QQ 音乐这个应用当前在放什么」,而不是 QQ 音乐的播放列表模型:手动在客户端里拖动播放、切歌,插件都会跟着变。
界面
输入框下方一条胶囊:● 心墙 · 郭静,右侧三个按钮(上一首 / 播放暂停 / 下一首)。状态点绿色=播放中,琥珀色=暂停,灰色=没有会话。
3 秒轮询一次 /qqm/status,页面切到后台(document.hidden)时停止轮询;点击按钮时先乐观更新图标,再以返回的真实状态为准。
样式只用 DSH 主题 token(--dsw-alias-*),跟随明暗主题。
工具
助手可以直接调用:
qqmusic_control action=status
qqmusic_control action=next
qqmusic_control action=toggle
action ∈ status | play | pause | toggle | next | previous。返回 { ok, action, state },state 含 available / playing / status / appId / title / artist / album / positionSec / durationSec。
安装
plugin_manager install_bundle target=<本仓库路径>
包名是 dsh-qqmusic,cordis.patch.yml 往 profile 里插入一个 qqmusic 条目。
实现要点
- 常驻守护进程:
smtc-daemon.ps1一次启动、按行读命令、按行回 JSON。冷启动 PowerShell 约 1 秒,每次操作都新起进程会让轮询变卡,所以 Host 侧维持一个长连接桥(SmtcBridge),串行发命令、15 秒超时、闲置 2 分钟退出、退出后按需重启。 - 操作后等状态落定:SMTC 的播放状态与曲目信息在控制调用后会有 1~2 秒延迟。
play/pause/toggle会轮询播放状态直到变化,next/previous会等到标题变化并且时长变化(同一首歌重复出现时标题不变),最多 20×150ms,避免把上一首的元数据当成结果返回。 - 路由鉴权:
/qqm/status、/qqm/control都校验 Host 头(仅 localhost / 127.0.0.1 /[::1]/ IPv4 字面量),写操作额外校验sec-fetch-site与 Origin,防 DNS rebinding 与跨站调用。 - 工具参数校验:
tools.register只校验output.schema,parameters会原样交给模型提供方。参数 schema 若不是一个 object 根的标准 JSON Schema,会导致整个 harness 的每一次模型请求都被拒绝(不是只坏掉这个工具)。因此注册前先做形状检查,不合格就跳过注册并告警。
已知边界
- 只支持 Windows:SMTC 是 Windows 10 1809+ 的 API。
- 需要 QQ 音乐在播放(或至少启动并有过媒体会话)。会话按
SourceAppUserModelId -like 'QQMusic*'匹配,所以浏览器里放的音乐不会被误控。 - 只暴露 SMTC 支持的语义:没有「播放指定歌单 / 搜歌 / 调音量」。音量请用系统音量。
- 进度位置来自 SMTC timeline,某些版本客户端会滞后数秒。
许可
MIT
No comments yet. Be the first to write one.