前言¶
DeepSeek Harness（DSH）的设计理念是“一切皆插件”。如果你需要将 DeepSeek 的能力接入 QQ 社交场景，dsh-qqchat 插件提供了现成的方案。它解决了从 QQ 群聊和私聊直接接入 DSH Agent 的需求，支持官方 Bot 授权、记忆管理以及 DSH 原生会话界面。
插件介绍¶
dsh-qqchat 是 DeepSeek Harness 的一个客户端插件，由开发者 Coffeiz 维护。它基于 QQ Chat 协议，允许用户在 QQ 群聊和私聊中直接使用 DSH 的智能体能力。通过它，DSH 的原生界面、记忆系统和命令机制可以无缝映射到 QQ 的对话场景中。
核心功能¶
- 连接与重连：支持扫码连接和手动填写 AppID/AppSecret 两种方式。支持断线自动重连，无需重复扫码。
- 会话管理：每个群聊和私聊对象对应独立的 DSH 会话，支持会话隔离。支持从 DSH 原生界面主动向 QQ 发送消息。
- 消息处理：支持群聊回复模式（自动回应、@回复、静默记录）、引用消息与 @ 用户转换、私聊流式回复。
- 记忆系统：分别维护群聊记忆、群成员记忆和私聊用户记忆。支持记忆整理（自动将近期记录转为长期记忆）和跨群复用用户记忆。
- 权限与工具：支持媒体与文件权限管理，可单独控制接收、读取和工具使用权限。
- 命令系统：支持 DSH 原生命令（如
/compact）和 QQChat 自有命令（如/qqhelp）。
安装与启用¶
安装需要指定一个 profile，推荐新建一个 qqchat profile：
npx @deepseek-ai/dsh plugin --profile qqchat add @deepseek-ai/dsh-web-app dsh-qqchat
npx @deepseek-ai/dsh --profile qqchat
也可以安装到已有的 web profile 中，或者直接从 GitHub 安装开发分支。
典型用法¶
- 启动 DSH 后，进入 设置 → QQ Chat。
- 点击 扫码连接，使用手机 QQ 扫描生成的二维码，完成官方 Bot 授权。或者选择手动配置，填写 AppID 和 AppSecret。
- 连接成功后，在 QQ 群或私聊中发送
/qqhelp查看可用命令列表，发送/qqpreset [preset]切换 Agent Preset。
适用场景与注意¶
- 适用场景：需要将 QQ 群组作为 DSH 的 Agent 交互入口，或需要管理特定用户记忆的场景。
- 注意事项：
- 需要使用 QQ 官方 Bot，不支持个人 QQ 账号登录。
- 插件当前版本仍在完善中，建议先在测试环境使用。
- 对于富媒体、完整表情和部分复杂消息格式，可能需要使用兼容模式。
- 卸载插件不会自动删除已保存的聊天记录和记忆数据。
结语¶
dsh-qqchat 将 QQ 生态与 DSH 的强大能力连接起来。作为社区插件，其代码质量仍在迭代中。你可以通过 GitHub 或 SkillHub 目录查看源码和文档。
