DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

qwqZYLqwq /

qwqZYLqwq/dsh-qqmusic

Verified

DeepSeek Harness 插件:在输入框下方遥控 QQ 音乐——上一首 / 播放暂停 / 下一首,并给助手一个 qqmusic_control 工具。基于 Windows SMTC,不注入进程。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@87db5102

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

—/ 5

No ratings yet

Verified DSH bundle

Commit 87db51027012

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout