前言¶

DeepSeek Harness (DSH) 提供了一个插件化扩展框架。在 DSH 的生态中，将 QQ 平台作为消息通道通常只涉及基础的消息收发。dsh-qqbot 是一个基于 DSH 的 QQ Bot IM 插件增强 fork，它将 QQ 平台作为 DSH agent 的前端协议驱动，并在此基础上增加了表情包图库、富媒体收发、定时任务、多实例人格、好感度系统及可视化设置面板等能力。

功能特性¶

该插件提供以下核心能力：

• 表情包图库：支持自动去重入库，可将群聊中的图片按状态分类（待整理、收藏、回收站），并可在回复中调用。
• 富媒体收发：支持图片、视频、文件、SILK 语音等多种媒体格式，支持在纯文本驱动下发送富媒体内容。
• 定时任务：支持设定定时触发器，例如在指定时间发送“早安”或“提醒喝水”。
• 多实例人格：支持多账号同时运行，每个账号拥有独立的 AppID、独立人格配置、独立的图库和定时任务。
• 好感度系统：记录与用户的互动关系，通过熟识度和好感度两个维度量化互动数据，影响交互权重。
• 群管理：提供入群审批、禁言、踢人等群管理功能。
• 可视化设置面板：提供 Web 界面的配置入口，用于管理人格、设置面板和查看数据。
• 会话自动重排：活跃会话会自动置顶，保持重要对话不被冷处理。

安装与启用¶

安装此插件必须指定 web profile，否则无法获得可视化设置面板。

npx @deepseek-ai/dsh plugin --profile web add @zaofan/dsh-qqbot

安装完成后，在 DSH 的 Web 界面“设置”中即可看到“QQ 机器人”面板。

典型用法¶

• 表情包管理：群聊中发送的图片自动进入图库，机器人可在回复中引用图库内容。
• 定时提醒：设置定时任务，机器人会在指定时间主动发言提醒群成员。
• 入群审批：启用入群审批功能，机器人核对 openid 台账后自动放行或拒绝入群申请。

注意事项¶

• 设置面板依赖：必须将插件安装到 web profile 才能使用可视化设置面板。如果安装到其他 profile，插件将仅有后台逻辑而无界面。
• 官方 Bot 方案：本插件走腾讯官方 QQ 机器人开放平台，不模拟 QQ 客户端协议，安全性较高，但功能范围受官方 API 限制。
• 踢人功能：由于官方未开放踢人接口，该功能通过使用机器人自己的 QQ 号走群官网接口实现。
• 安卓部署：在安卓设备上运行时，需在设置中开启“程序兜底（不依赖小模型）”，否则小模型可能无法加载。
• 源码安装：如果从 GitHub 直装，需要编译产物 dist/ 目录，否则安装会失败。

结语¶

dsh-qqbot 为 DSH 用户提供了从基础 IM 集成到高级人格管理和群控功能的完整解决方案。更多细节及源码可参考：GitHub | 社区目录