qq-bridge 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。

qq-bridge 兼容性怎么样？

暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。

qq-bridge 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

qq-bridge 还在维护吗？

GitHub 3,402 星。最近一次上游提交在 2026/11/1。

QQ 桥接 Derpyu520/qq-bridge

DeepSeek Harnessv1.1.5

Derpyu5202 天前有提交已提供中文文档扫描：高危notify

在 GitHub 查看 ↗

qq-bridge 是本地消息桥接工具，在 SnowLuma 提供的 OneBot v11 接口与 DeepSeek…

70.4/100

综合分

3,402

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/11/1 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。以下命令仍可尝试，但可能失败。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add Derpyu520/qq-bridge

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么

dsh 原生插件 · platform

装得上吗

实装验证未通过（dependency_conflict），装前请到仓库确认最近更新与 issue

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 2 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

⚠︎ 实装验证未通过（dependency_conflict · 2026/9/27） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查需源码安装

缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包qq-bridge @ 1.1.5

✓Node 引擎要求 >=22.13.0 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/29 09:38:10

🔴 安全扫描发现高危能力自动 · 静态分析源码

v2.7.0

🔴 扫描：高危尚无人工评估

静态扫描发现安装期即执行代码，或命令参数由运行时变量拼接（参数来源无法静态判定，从严处理）。

安装时即执行脚本可执行外部命令读写/删除本地文件读取剪贴板或密钥环境变量发起外部网络请求

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh-host-apiproxy@deepseek-ai/schemastery

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

QQ与智能体桥接
社交模拟
安全MCP工具

在 QQ（SnowLuma OneBot v11）和 DeepSeek Harness 智能体之间搭桥：社交模拟、安全 MCP 工具、黑话学习等等。

README

由 DeepSeek 最新模型翻译生成

qq-bridge English · 安装指南 · 问题反馈 qq-bridge 是本地消息桥接工具，在 SnowLuma 提供的 OneBot v11 接口与 DeepSeek Harness（DSH）之间转发消息事件和 AI 回复。 [!IMPORTANT] qq-bridge 是独立维护的第三方工具，不是 SnowLuma 的子项目，也不隶属于 SnowLuma、DeepSeek 或腾讯 / QQ。本项目通过 SnowLuma 提供的 OneBot v11 接口互通；桥接与 SnowLuma 后端分别部署、独立维护，无隶属、合作或背书关系。OneBot v11 是公开协议，并非 SnowLuma 专有协议。术语与边界：本项目不向 QQ 客户端或 SnowLuma 进程注入、挂钩，不修改 SnowLuma 本体或其原生组件；但会读取本机 OneBot 配置与接入令牌、连接 OneBot 接口，并在 npm install 时修补本机 @snowluma/sdk 的 ESM 导入。文档中的“人格注入”指提示词写入，“提示注入”指不可信内容攻击；上游 [Hook] 仅指 SnowLuma 的接入机制，不是本项目的行为。

展开完整文档（README 剩余 1 节）

qq-bridge

English · 安装指南 · 问题反馈

qq-bridge 是本地消息桥接工具，在 SnowLuma 提供的 OneBot v11 接口与 DeepSeek Harness（DSH） 之间转发消息事件和 AI 回复。

[!IMPORTANT]
qq-bridge 是独立维护的第三方工具，不是 SnowLuma 的子项目，也不隶属于 SnowLuma、DeepSeek 或腾讯 / QQ。
本项目通过 SnowLuma 提供的 OneBot v11 接口互通；桥接与 SnowLuma 后端分别部署、独立维护，无隶属、合作或背书关系。OneBot v11 是公开协议，并非 SnowLuma 专有协议。

术语与边界：本项目不向 QQ 客户端或 SnowLuma 进程注入、挂钩，不修改 SnowLuma 本体或其原生组件；但会读取本机 OneBot 配置与接入令牌、连接 OneBot 接口，并在 npm install 时修补本机 @snowluma/sdk 的 ESM 导入。文档中的“人格注入”指提示词写入，“提示注入”指不可信内容攻击；上游 [Hook] 仅指 SnowLuma 的接入机制，不是本项目的行为。

QQ ↔ SnowLuma ↔ qq-bridge ↔ DeepSeek Harness ↔ 模型服务 OneBot v11

能做什么

| 场景 | 功能 |
| 消息桥接 | 按群聊 / 私聊维护独立会话，支持文本、图片、表情与引用回复 |
| 聊天与仿真 | 普通聊天（chat）、两代群友仿真（reserved / reserved2）、自定义角色 |
| 个人助手 | closed-agent 仅限管理员私聊，可使用完整 DSH 工具；请谨慎开启 |
| 本地管理 | 控制台切换模式、管理白名单与审批、查看日志和模型用量 |

快速开始

准备好 Windows 10 / 11、Node.js ≥ 22.13，以及以下两个独立运行的服务：

- DSH Web：当前有 0.2.0-rc.2 / 0.2.1-rc.2 的验证记录，其他版本见兼容范围。
- SnowLuma：请自行按上游文档安装、启动并登录，开启 OneBot WebSocket 服务端和 HTTP API。

1. 获取项目

在 PowerShell 中运行：

git clone https://github.com/Derpyu520/qq-bridge.git
cd qq-bridge
npm install
Copy-Item config.example.json config.json

默认分支 main 为正式发布线；dev 用于开发与测试。

2. 填写配置

编辑 config.json，至少核对这些字段：

| 字段 | 填写内容 |
| dsh.baseUrl | DSH Web 地址，默认 http://127.0.0.1:3080；模型选择需与 DSH 中可用的配置一致 |
| snowluma.wsUrl / httpUrl | OneBot WebSocket / HTTP 地址，示例分别为 ws://127.0.0.1:3001 / http://127.0.0.1:3000，不要混用端口 |
| snowluma.accessToken / homeDir | 按实际配置填写令牌与 SnowLuma 安装目录；HTTP、WS 令牌不同时，需能从该目录发现各自令牌 |
| ownerQQ | 你的管理员 QQ 号 |
| allow.private / allow.groups | 允许接入的 QQ 号 / 群号；默认空白名单不响应任何会话 |

同机运行时，dsh.authToken 通常留空，由桥接使用本机 DSH 凭据完成鉴权。完整配置与连接排查见安装指南。

3. 安装 DSH 插件

node scripts/setup-dsh.mjs

这一步会把聊天预设和 MCP 工具接入 DSH，首次安装也必须执行。完成后重启 DSH；使用非 web profile 时见安装指南。

4. 启动并测试

npm start

打开 本地控制台 并输入控制台令牌。自动生成的令牌保存在 state/console-token；如果已在 config.json 配置 consoleToken，则使用该值。启动日志不会打印令牌。新装默认使用二代仿真模式（reserved2），会选择性发言；测试收发时可先切到 chat，再从白名单会话发送消息。

Windows 也可双击 start.bat 以守护模式运行，关闭窗口即停止。

文档与开发

| 我想…… | 入口 |
| 安装、升级或排查连接 | DSH 安装指南 |
| 了解模式、权限与管理命令 | 使用规则 |
| 查看模型用量与费用口径 | 用量看板 |
| 参与开发 | 贡献指南 · 安全基线 |
| 报告安全漏洞 | 安全报告 |
| 查找其他说明 | 文档索引 |

开发基于 dev，提交 PR 前运行离线回归：

npm run test:audit

使用边界与许可

- 仅在知情并获准的会话中使用，遵守平台规则；使用非官方 QQ 后端可能导致账号受限。
- 聊天内容会经 DSH 发送给所配置的模型服务；黑话自动研究默认开启，可能将提取的关键词发送给搜索服务。数据流与关闭方式见 NOTICE。
- 保护好 config.json、state/ 与控制台令牌，让服务只在本机可访问。
- DSH 离线期间，消息队列只保存在内存中，每个会话最多 50 条；桥接进程退出后队列就丢了，不保证送达。
- 本工具不实现 QQ 登录或底层协议，也不安装、打包或启停 SnowLuma 后端；当前客户端仍依赖 @snowluma/sdk 等包，第三方组件适用各自条款。

当前代码按 PolyForm Noncommercial 1.0.0 提供，限非商业用途；v0.2.1-r1 及更早已发布版本沿用其发布时的 MIT 许可。第三方组件、独立关系与使用风险见 NOTICE。