qq-bridge：把 QQ 消息接入 DeepSeek Harness Agent 的桥接服务

Derpyu520/qq-bridge · Bridge between QQ (SnowLuma OneBot v11) and DeepSeek Harness agents: social simulation, safe MCP tools, slang learning and more.

GitHub原文发布未知首次收录 2026-09-20上架 2026-09-26 12:00

☆ 收藏查看项目 ↗

ELI5：它是什么，解决什么问题

qq-bridge 是一个 JavaScript 编写的桥接进程，通过 SnowLuma（OneBot v11 WebSocket）接收 QQ 好友与群消息，转发到本地 DeepSeek Harness（DSH）Web API 会话，并把 agent 的回复、提问与工具审批结果发回 QQ。项目提供 QQ 动作安全子集、进程探活与只读网络搜索等 MCP server，支持每个 QQ 会话对应一个独立 DSH 会话、本地 Web 控制台切换运行模式（chat / closed-agent / reserved / reserved2）以及一、二代群聊仿真行为。

# MCP # chatbot # AI 代理 # Session Management # OneBot

核心能力与快速开始

★ 305 · JavaScript

能做什么: 基于 @snowluma/sdk 的 OneBot v11 WebSocket 客户端收发 QQ 消息；适配 DSH 0.1.2 起协议（launch token 换 Cookie 鉴权、斜杠 RPC、/api/remote.mux 事件流）；按 config.json 逐会话固定模型；每 QQ 会话映射为独立 DSH 会话并持久化到 state/sessions.json；三个 MCP server：snowluma（QQ 只读/发消息安全子集、发送白名单、可选引用回复）、snowluma-host（状态探活，进程控制需显式开启）、web-search-safe（带 SSRF 防护的只读 web_search / web_fetch）；本地 Web 控制台（默认 127.0.0.1:3100，需令牌）切换 chat / closed-agent / reserved / reserved2 模式、设置角色、开关静默、看日志；ask_user_question 与工具审批转发到 QQ；支持斜杠命令与 /reset；解析群聊引用为「被引用人+原文」；Markdown 转纯文本，超 4000 字自动分段；图片可安全下载接入多模态。
适用场景: 把 QQ 私聊或群聊接入本地 DeepSeek Harness agent 做自动回复；在 QQ 上远程操控 DSH（closed-agent 模式，仅 owner 私聊）；用 reserved / reserved2 模式做群聊仿真群友，选择性地观望、试探、发言或潜水；让 agent 主动调用 qq_get_unread_messages / qq_send_message、查群历史、按消息 id 引用回复；通过 MCP 提供的只读网络搜索查询群聊中出现的网络用语与资料。
项目形态: 可直接使用的工具
部署方式: 本地自托管：需自行克隆仓库、npm install、复制 config.example.json 为 config.json、运行 node scripts/setup-dsh.mjs 安装 DSH preset 与 MCP 后重启 DSH，并下载解压 SnowLuma 完成首次 WebUI 引导。桥接仅允许单实例运行，日志显示 SnowLuma 已连接即视为启动成功。
主要依赖: 需运行中的 DeepSeek Harness Web（默认 http://127.0.0.1:3080）、运行中的 SnowLuma（配置 OneBot WebSocket 与 HTTP API，默认 ws://127.0.0.1:3001 / http://127.0.0.1:3000）以及 Node.js ≥ 22.13；当前版本 v0.1.5 适配 DSH 0.1.5-rc.1，与 DSH 0.1.1-rc.2 及更早不兼容。具体模型可用性取决于本地 DSH 配置。
使用限制: agent 回复在回合结束时一次性发送，不做流式逐字转发，超过 4000 字自动分段；图片与部分表情可接入多模态，语音、视频及取不到图片字节的消息仍用占位文本；Markdown 回复转为纯文本；@snowluma/sdk 的 npm 发布版存在 ESM 扩展名 bug，靠 postinstall 补丁修复；断线期间已结束的回复不保证补发，桥接进程退出会丢失内存队列；DSH 重启期间消息在进程内排队，上限 50 条/会话。许可证与 API 成本未说明。
许可证: 未说明
最近推送: 2026-09-18 18:04

官方入门项目文档核对 README 依据 ↗

资料检查：2026-09-20 07:00 · 卡片整理：2026-09-26 12:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

作为桥接服务，将 QQ 消息接入 DeepSeek Harness Agent，供程序员在本地搭建和调试 agent 与 QQ 的集成链路，并可通过自测脚本验证 DSH 侧链路是否打通。

查看内容依据

qq-bridge 是一个 JavaScript 编写的桥接进程，通过 SnowLuma（OneBot v11 WebSocket）接收 QQ 好友与群消息，转发到本地 DeepSeek Harness（DSH）Web API 会话，并把 agent 的回复、提问与工具审批结果发回 QQ。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

相似资源

SyntaxRAG：面向 AI 代理的本地代码检索 MCP 引擎

SyntaxRAG（SYNRAG）是一个本地代码搜索 MCP 引擎，通过 Tree-sitter 按函数、类、类型等 AST 结构切分代码，在 CPU 上用 FlashRank（TinyBERT）对 BM25 候选重排序，并构建依赖影响图。它提供搜索、文件大纲、仓库地图、影响范围分析、测试定位及受控编辑等工具，以减少 AI 代理定位代码时的 token 消耗；附带安装脚本、CLI、可选的变更监视服务和 Gemini 相关可选功能。

Brito：带代码知识图谱与可审核技能的终端编码智能体

Brito 是一个面向软件开发的编码智能体，提供命令行工具 brito-cli 和 macOS/Windows/Linux 桌面应用。它不依赖逐文件 grep 阅读，而是用 tree-sitter 增量索引构建代码知识图谱（符号、调用、导入），支持 TypeScript/JavaScript、Python、Svelte/Vue/Astro 组件及多种后端语言，可通过 graph_search、graph_callers、graph_impact 等工具快速回答“改这里会影响什么”。它还会保存记忆笔记，并在任务完成后反思生成项目技能，新技能先进入试用期，经多次成功使用后转正，涉及危险命令或修改已批准技能时需用户审批，并提供隐私检查（如拒绝密钥、curl | sh 等）与手动/自动编辑/计划/全允许等权限模式。支持 Anthropic API 或 Claude Code 订阅作为后端，也可接入 OpenAI 兼容端点，并可作为 MCP 服务器向其他客户端暴露图谱、记忆与技能。

Vybe Intelligence Vault：面向 AI Agent 与 RAG 工程的开源知识图谱

Vybe Intelligence Vault 是一个自更新的开源知识仓库，索引 AI Agent、RAG、MCP 服务器、提示词、工具和模板等前沿资料，并宣称通过采集管线、LLM 评估和向量关系构建语义知识图谱。项目提供 MCP 网关供 Claude Desktop、Cursor 等 Agent 直接查询节点上下文，还包含基于 React Three Fiber 和 WebGL 的 3D 知识图谱浏览界面，以及若干 7 天工程学习路径与生产蓝图。

Nodecode：可自我改写并持续进化的 Lisp 智能体

Nodecode 是一个运行在 SBCL（Common Lisp 系统）单一进程中的 AI 智能体，终端等客户端可连接同一个运行实例。模型唯一的工具是在运行中的程序里求值 Lisp，并能保留定义过的代码，因此可自行新增工具。项目以 cell（文件夹形式的能力单元）扩展聊天平台接入、Web 访问、定时任务、MCP 工具等能力，支持从多个客户端使用同一实例，并具备上下文召回、生成代际回滚等机制。它不提供沙箱，eval 会以当前用户权限执行 Lisp 和 shell 命令，官方建议在容器或虚拟机中运行。

这是基于来源内容整理的摘要。原文链接失效后，本页摘要和讨论仍会保留。