DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

youxin484 /

youxin484/qq-bridge-addons

Topic repository only

qq-bridge 扩展:本地 GPT-SoVITS 动态语音 + B 站视频摘要(附 DSH 端口自愈)

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

qq-bridge-addons

给 Derpyu520/qq-bridge 加两个能力:

  1. 动态语音——用本地 GPT-SoVITS 把任意短句合成成语音,发成 QQ 语音条(不再限于语音库里那几条固定台词)
  2. B 站视频摘要——给它一个 BV 号/链接,它能读到标题、数据、字幕和关键帧图片,然后像群友一样聊这个视频

同时附带一个解决「DSH 端口每次启动都变」的小工具,避免桥接静默失联。

本仓库只包含扩展,不含 qq-bridge 本体。请先自行安装上游:https://github.com/Derpyu520/qq-bridge。 上游为 MIT,署名见 NOTICE-upstream-LICENSE.txt。

装了什么

文件 位置(装完后) 作用
mcp/mcp-voice-tts.js <bridge>/src/ MCP 工具 qq_say_voice(text, target?):文字 → GPT-SoVITS(9880) → 桥接发语音
mcp/mcp-bili-digest.js <bridge>/src/ MCP 工具 bili_video_digest(url, frames?):B 站视频摘要,可带关键帧图片
tools/video-digest.mjs <bridge>/ 摘要生成器(bili-cli 取元数据/字幕 + ffmpeg;抽帧仍用 yt-dlp)
tools/sync-dsh-url.mjs <bridge>/ 扫描本机端口,把 config.json 的 dsh.baseUrl 指到当前 DSH
persona/小鲸鱼.example.md 参考 人格卡范例,可直接放 <bridge>/roles/

前置条件

  • 已装好并跑通 qq-bridge(SnowLuma + DSH 都能连上)
  • Node 22+(桥接本来就需要)
  • 语音功能额外需要:GPT-SoVITS API 在 127.0.0.1:9880 跑着
  • 视频摘要额外需要:bili-agent(命令 bili,PyPI 名 bili-agent)、ffmpeg; yt-dlp 只在抽关键帧时用(--frames),不抽帧可以不装。

    2026-10 起 yt-dlp 的 B 站解析器失效(Unable to extract initial state),元数据和字幕已改走 bili-cli; AI 字幕(ai-zh)需要登录 cookie,纯游客只能拿到人工字幕。

安装

# 1. 装扩展文件 + 注册 MCP
node install.mjs --bridge "C:\path\to\qq-bridge" --profile desktop

# 2. 放行工具(手动)
#    编辑 <bridge>/plugins/qq-agent-presets/qq-tool-restrict.mjs
#    在 SAFE_PREFIXES 里加:
#        'mcp__voice-tts__',
#        'mcp__bili-digest__',

# 3. 重启 DSH

重启后,DSH 的工具清单里会出现 mcp__voice-tts__qq_say_voice 和 mcp__bili-digest__bili_video_digest。

语音功能配置

需要三样环境变量(或用默认路径):

变量 说明
GPT_SOVITS_URL 默认 http://127.0.0.1:9880
GPT_SOVITS_REF 参考音频路径;默认 <bridge>/ref/reference.wav
GPT_SOVITS_REF_TEXT 参考音频里说的那句话(必须逐字一致,否则音色会漂);也可以写在 <bridge>/ref/REF_TEXT.txt,换参考音时不用改环境变量

参考音频建议:5~10 秒、无背景音乐、单人、口齿清楚。用谁的声音自己决定,别用没授权的他人声音。

让模型真的去用

光装上工具不够——模型经常只记得「语音库」那个老工具,会说“库里没这句”。 在人格卡里把规则写死(见 persona/小鲸鱼.example.md 第十二、十三节):

- 用户让你“用语音念某句话”时,必须用 mcp__voice-tts__qq_say_voice,参数 text 就是那句话;
  不要用 qq_send_voice 代替,也不要说“语音库里没这句”。

端口自愈

DSH 桌面版每次启动随机分配端口,桥接的 dsh.baseUrl 会失效且不报错(事件流 0 帧)。 sync-dsh-url.mjs 扫描本机监听端口,用 DSH 的 401 固定文案做指纹,找到就写回配置。

建议放在启动脚本里,每次(重)启动前都跑一遍:

:loop
"%NODE_EXE%" sync-dsh-url.mjs
"%NODE_EXE%" src/bridge.js

安全边界

  • qq_say_voice:文本上限 80 字,只发到桥接白名单内的群/私聊,复用桥接自己的限流与审计
  • bili_video_digest:只接受 bilibili.com / b23.tv / BV 号;只读,不执行命令
  • 两个工具都不读写用户文件,也不改变桥接的发送闸门

已知坑

现象 原因
工具装好但群里调不到 qq-tool-restrict.mjs 的白名单没加前缀
合成报 cp932 codec can't encode 服务端控制台是日文编码,启动时设 PYTHONUTF8=1、PYTHONIOENCODING=utf-8
抽帧报 format is not available 竖屏视频高度是 852,筛选条件别用 height<=480
桥接连不上 DSH 端口变了,跑 sync-dsh-url.mjs

License

MIT,见 LICENSE。上游 qq-bridge 的 MIT 声明见 NOTICE-upstream-LICENSE.txt。

—/ 5

No ratings yet

Manifest verification required

Commit d14236c9a217

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