by Derpyu520
Bridge between QQ (SnowLuma OneBot v11) and DeepSeek Harness agents: social simulation, safe MCP tools, slang learning and more.
# Add to your Claude Code skills
git clone https://github.com/Derpyu520/qq-bridgeLast scanned: 9/18/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-09-18T08:47:18.808Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how qq-bridge compares with popular alternatives.
qq-bridge is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Derpyu520. Bridge between QQ (SnowLuma OneBot v11) and DeepSeek Harness agents: social simulation, safe MCP tools, slang learning and more. It has 3,392 GitHub stars.
Yes. qq-bridge passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Derpyu520/qq-bridge" and add it to your Claude Code skills directory (see the Installation section above).
qq-bridge is primarily written in JavaScript. It is open-source under Derpyu520 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh qq-bridge against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
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,以及以下两个独立运行的服务:
0.2.0-rc.2 / 0.2.1-rc.2 的验证记录,其他版本见兼容范围。在 PowerShell 中运行:
git clone https://github.com/Derpyu520/qq-bridge.git
cd qq-bridge
npm install
Copy-Item config.example.json config.json
默认分支 main 为正式发布线;dev 用于开发与测试。
编辑 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 凭据完成鉴权。完整配置与连接排查见安装指南。
node scripts/setup-dsh.mjs
这一步会把聊天预设和 MCP 工具接入 DSH,首次安装也必须执行。完成后重启 DSH;使用非 web profile 时见安装指南。
npm start
打开 本地控制台 并输入控制台令牌。自动生成的令牌保存在 state/console-token;如果已在 config.json 配置 consoleToken,则使用该值。启动日志不会打印令牌。新装默认使用二代仿真模式(reserved2),会选择性发言;测试收发时可先切到 chat,再从白名单会话发送消息。
Windows 也可双击 start.bat 以守护模式运行,关闭窗口即停止。
| 我想…… | 入口 |
|---|---|
| 安装、升级或排查连接 | DSH 安装指南 |
| 了解模式、权限与管理命令 | 使用规则 |
| 查看模型用量与费用口径 | 用量看板 |
| 参与开发 | 贡献指南 · 安全基线 |
| 报告安全漏洞 | 安全报告 |
| 查找其他说明 | 文档索引 |
开发基于 dev,提交 PR 前运行离线回归:
npm run test:audit
config.json、state/ 与控制台令牌,保持服务仅在本机可访问。@snowluma/sdk 等包,第三方组件适用各自条款。当前代码按 PolyForm Noncommercial 1.0.0 提供,限非商业用途;v0.2.1-r1 及更早已发布版本沿用其发布时的 MIT 许可。第三方组件、独立关系与使用风险见 NOTICE。