QQ 桥接 · DSH × NapCat

把 DeepSeek Harness（DSH） 接到 QQ：通过 NapCat / OneBot 11 收发消息，在电脑和手机上管理聊天、人设、记忆、日程、工具及媒体任务。

这里的 DeepSeek Harness 是宿主名称，不代表聊天模型只能选 DeepSeek。聊天模型、图片服务和语音服务可以独立选择；电脑版也支持自定义本地工作流，手机版仅使用 API。

当前版本：1.59.1

这版合并 1.58.6–1.59.0 的本地工作流、浏览器视频观看、小窗口布局、后台优先和参考图传递修复，并补上连接配置保存、无效配置保护、浏览器 Cookie 切换和短链接续看的回归问题。

• 修改一个连接的聊天模型，会保留未修改的图片编辑模式、图片/语音/视频模型、音色和自定义接口路径。
• 本地聊天不默认选择模型。导入自己的 ComfyUI 工作流，确认输入和文本输出；插件按映射传输，不改工作流的模型名和服务地址。
• 电脑版视频观看使用设置中的 Chromium 浏览器，普通操作默认在后台；需要桌面交互或明确要求展示时可临时显示。
• 电脑版窄窗口自动调整导航和表单，保存、提醒及日程浮窗分开排列。
• 参考图记录区分“配置了”“选中了”和“已上传绑定”，不把有配置说成已传入。必要图片缺失或主体规划不明时不直接提交无参考图生成。

验证：748 项自动测试通过。 此外验证了 PC / 手机隔离启动、多个窗口宽度及真实 Edge 的本机视频测试页面。没有调用真实生成模型、发送 QQ 测试消息或发布空间评论；不等同于所有提供商、手机和线上网站均已实测。检查报告 · 更新说明 · 历史记录

功能与边界

功能	已接入的逻辑	使用条件或边界
私聊与群聊	人设、近期对话、情绪、相关记忆、分段发送、戳一戳；群聊被 @ 后观察 120 秒，生成期间暂停计时	保留白名单；能旁听或不回复，私聊资料不会无条件公开到群里
记忆与日程	按需调取服装、场景、日程、记忆和梗；跨会话关联相关证据，睡眠进入实际静默	依赖当前模型的理解和工具能力；日程是安排，不是执行完成的证据
私人手账	一天一篇的日记、手写字体、浅蓝白格纹	生成内容的自然程度仍受模型与对话资料影响
连接与搭配	OpenAI 兼容、Responses、Anthropic 等协议；聊天、图片、语音可分别选来源	检测只读模型列表或服务特征；未知私有协议需要手工填写，不承诺填密钥就能全自动适配
本地聊天	自定义 ComfyUI 聊天工作流或本机 OpenAI 兼容服务；人设、历史、图像和文本回执映射	不预选聊天模型；没有工具/视觉能力的模型不会因导入而自动获得这些能力
图片与视频生成	图片提示词准备、场景/服装/头饰信息、参考图上传和输出记录；视频增加时长、动作及镜头要求	生图接口必须支持参考图才可传入；视频 API 和 RunningHub 工作流按各自协议配置
语音	API，以及电脑版 VoiceLab、OpenAI 兼容或自定义 JSON 的本地接口	本地服务地址、模型、音色、启动路径可配置；协议和返回音频必须兼容
看视频与网页	指定浏览器、播放器进度、实际画面、可取得的字幕、续看/暂停/定位；B站账号工具	只分析实际取得的内容；画面不等于音轨，更不等于看完整片。登录和站点变化可能导致失败
设备与网站工具	浏览器、PC 桌面、手机 Pilot、网站 MCP 包装及实际工具记录	后台可完成时优先后台；网站包装依赖真实接口或页面，不保证任意网站可自动适配
QQ 空间	专用总开关、浏览、配图、评论/回复及读回记录	默认关闭；非官方接口可能变化。保留主动访问节奏与 B站评论独立设置，不能保证账号安全
可靠发送	持久队列、消息编号、发送回执、结果文件及读回状态	“QQ 接受”不等于对方已读；状态不明时不盲目整轮重发

三种电脑使用方式

1. API 模式：使用 DSH 或已保存的聊天连接，媒体服务单独配置。
2. 纯本地模式：聊天与本地媒体由本机服务执行；不会自动改用云端。API 补全默认单独管理。
3. 按能力搭配：例如 API 聊天＋本地生图＋API 语音。在“连接与搭配”分别选择，开启后以搭配来源为准。

手机仅使用 API，保留共享的聊天、人设、日程、记忆与工具逻辑；不启动 PC 本地推理、Windows 浏览器或桌面程序。设备切换按钮更换对应 UI，预览手机 UI 不会把电脑变成手机运行环境。

安装与更新

需要已安装 DSH、可登录的 QQ 账号，以及开启 OneBot 11 WebSocket 服务端的 NapCat。

在你的 DSH profile 添加本仓库：

dsh plugin --profile <你的 profile> add /path/to/dsh-qq-bridge

也可以按宿主的 bundle 方式引用本仓库的 cordis.patch.yml。可选角色卡见 assets/personae.json；使用自定义人设时，以你的设置为准。

首次打开“设置 → QQ 桥接”：

1. 填写 OneBot WebSocket 地址和 token；默认地址为 ws://127.0.0.1:3001。
2. 把自己的 QQ 加入白名单并设为号主，再按需要开启群窗口。
3. 选择 API、本地或按能力搭配，分别填写需要的服务。
4. 确认 QQ 在线且桥接未暂停，再自行发普通消息检查送达。

更新时保留数据目录，只替换插件源码。已运行的进程不会因为文件更新而自动加载新版，需要自行重启 DSH。本地网关也应在没有任务执行时自行重启：

powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\start-local-ai.ps1 -Restart

start-local-ai.bat 用于启动已配置的本地服务；是否能自动拉起 ComfyUI 或语音服务取决于启动配置，不会自动下载模型。网关脚本遇到正在执行的任务会保留任务，不强制中断。

本地工作流与参考图

在“本地连接”导入 ComfyUI API JSON 或能够解析节点定义的画布 JSON，确认用户输入、人设、历史、图像及实际文本回执节点。不能识别时可手动映射。未映射的参数沿用工作流原值；可选图片布尔开关也可映射。

人设和历史没有独立输入口时，必要上下文会合入用户文本。选择的输出节点没有返回文本，会说明映射问题，不把其他节点的模板文字当答案。旧的已保存预设仍可兼容读取，不会替你切换模型。

生成当前角色时，已经选定的参考图由程序传递，并校验上传文件与输出分支的连接。场景图和其他人物图不无条件塞入角色图；主体不明确时需要确认。绑定成功只证明参考图已传入，不保证脸、画风或每个动作都符合要求。 模型理解、提示词改写、工作流参数和生图模型本身均可能影响结果。

8GB 配置会对已知节点应用相应策略并串行调度；未知工作流或独立外部模型服务的显存由其自身管理，不能承诺任意模型都能装进 8GB。文字、看图、生图和语音服务可能需要释放显存后再执行下一项。

浏览器与后台操作

电脑可填写 Chromium 浏览器 EXE 路径，例如 Edge。填写后只尝试该程序，路径失效不偷偷换浏览器。Firefox 等非 Chromium 程序不属于这条浏览器控制链路。

“能在后台完成就优先后台操作”默认开启。后台和可见窗口之间会保存当前账号/人设的 Cookie，不跨人设复制。网页的系统弹窗、特定登录验证以及必须操作桌面的任务，仍可能需要可见界面或本人参与；不保证所有网站都支持后台。

检查、日志与问题反馈

npm run check
npm test

调用记录可查看来源、提示词准备过程、实际提交参数、参考图状态、工作流结果及发送情况。提供问题反馈时，附上插件与网关版本、发生在哪种模式、调用记录中的错误阶段即可；不要公开 token、Cookie、密钥或私人聊天。

付款保留准确确认；白名单与 B站评论设置保持独立。QQ 空间专用总开关不会阻止通用浏览器或手机工具自行访问空间，这与专用空间工具的开关是不同范围。

数据与许可

账号凭据、聊天、记忆、图片和运行配置保存在本机数据目录。备份是否包含聊天或媒体以面板选择为准；标准备份和仓库不应包含服务密钥、Cookie、模型权重或本机运行数据。发布前仍应检查自己的改动。

代码采用 MIT License。第三方库遵循各自许可证。本项目使用非官方 QQ 连接方式，与腾讯、哔哩哔哩及相关模型服务商无隶属关系。

English

A QQ bridge for DeepSeek Harness and NapCat / OneBot 11. Supports API providers, configurable local ComfyUI chat workflows on PC, independent media sources, API-only mobile use, shared memory and schedules, browser/device tools, and delivery records. The host name does not restrict the selected language model. See the verification report for tested behavior and external-service limitations.