dsh-qq-link

通到 QQ（dsh-qq-link）

让 DSH 里的 AI 伙伴和 QQ 连起来：它在 DSH 里说完话，自动发到 QQ。 现在两半都做出来了，而且都不用 BOT： - DSH → QQ：伙伴说话 → 发到 QQ。 - QQ → DSH：你在 QQ 里发话，插件自己轮询那个 QQ 后端收进来 → 转进 DSH。只要一个后端就够。 现在的行为 盯两间屋（都可以选，也可以只选一间）：私聊会话 和 群会话。 QQ 私聊进来的话进私聊那间，群里的话进群那间；哪间屋说的话就只回那一边（私聊的话不会跑到群里）。 两行选了同一间屋也能用，但那就等于「两边都发」——设置页会当场提示。 DSH → QQ：它在某一整轮的最后一句说完，就把这句原文发到 QQ（走 QQ 后端的 3000）。 QQ → DSH：插件每 4 秒轮询 QQ 后端（get_friend_msg_history / get_group_msg_history）， 发现你在 QQ 里新发的消息 → 转进目标会话，让它照常开一轮。 发/收都只走这个 QQ 后端的 HTTP 接口（默认 127.0.0.1:3000）。 语音条也能变成字（可选）：设置里填一条「读 {file} 打一行字」的命令，QQ 语音就会被转写成文字；插件本身不带模型，仓库里附了 tools/asr_cli.py（SenseVoice）。 收进来的东西不只有文字：图片、表情包、@某人、分享卡片（B站 视频卡片会把标题和 BV 号写出来）、 合并转发的聊天记录（会去取内容压成「谁：说了什么」几行；里面还套着转发也会展开，最多 2 层）都会变成文字转给它。 转发里的图跟着「收图」开关走：开着就收第一层那几张（跟顶层图共用张数上限），关着只记 [图片]；第二层起一律只记 [图片]。 图片两个方向都能传：你在 QQ 里发的图会转给它看；它这一轮里发的图也会发到 QQ。 收进来的图会在 ~/.dsh/qq-bridge-inbox/ 存一份，文字里带上路径。 回发同一张图时用的是这份原图 —— DSH 自己那份副本会被重新编码，GIF 动图会变静态 webp。 正文里写的 markdown 图也算：它写 （贴纸就是这么发的）， 会被读成本地图片发到 QQ，那串 markdown 不会露出来。相对路径按「图片根目录」找 —— 留空就行，会自动用目标会话所在的那个工作区。 ⚠️ 它到底能不能看见图，取决于那个会话用的模型：能看图的模型直接看，纯文本模型只会收到一句占位文字。 安全默认：总开关 = 关、试运行 = 开 —— 不手动打开，一句都不会真的发到 QQ。 回复门槛（可选，默认关）：开着时 QQ 消息照常转进来，但会先让它判断「这条是不是在跟我说话」—— 不是就当场把这一轮停掉（agent.cancel），什么都不回。群里特别省心。工具只在「被

这个插件跟着 DSH 一起更新：作者这边跑的就是最新版的 DSH，最新版插件永远是给最新版 DSH 写的。

所以看到「不适配 / 不支持」之类的提示，基本都是装到了旧版本 —— 升级到最新版、重启一次 DSH 就好。 真遇到新版对不上（比如 DSH 刚升级、插件还没跟上），提个 issue，作者会跟着改。

实测对照 / 兼容范围看 package.json 里的 engines 和 dsh.compatibility； 这一版改了什么看 CHANGELOG.md，发版记录看 Releases。 这里不写死版本号 —— 文档里钉一个数，过两天就对不上了。 装 ⭐ 最省事的一条：把这个仓库的地址贴给你自己的 DSH，说「帮我装这个插件」。 一、在 DSH 里装（推荐）

打开 设置 → 插件 → 安装，把这一行填进去：

或者命令行（--profile 照你平时那个写，桌面端一般 desktop，网页端 web）：

装完重启一次 DSH，然后进 设置 → 通到 QQ。 ⚠ 用 github: 这种写法装的时候，包管理器会去 clone 仓库，所以那台机器上得有 git。 没装 git 会报 ERR_PNPM_GIT_FETCH_FAILED。这种情况改用 tarball 直链，不用 git： （设置 → 插件 → 安装 那个框里也可以直接填这行地址。） 光装插件还不够：还得有一个 QQ 后端（默认 127.0.0.1:3000），见下面「它依赖什么」那一节。 二、装完起不来？先看这个

如果 DSH 弹「The application could not start」，错误里有 Unexpected token ''、is not valid JSON、 readProfileManifest —— 那是 profile 的 package.json 被存成了 UTF-8 带 BOM。 跟插件无关：文件内容都是对的，只是开头多了三个看不见的字节，DSH 读它就崩。

先找出来（不同装法位置不一样，别猜 —— 真正的 profile 目录里同时有 cordis.yml、cordis.patch.yml、package.json；机器上别处那些同名的都不算）：

输出里 BOM=True 的那一行，就是要修的文件（标准安装在 C:\Users\ \.dsh\profiles\ \package.json）。 去掉 BOM（路径换成上面那一行）：