前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许通过插件扩展功能。dsh-plugin-qq-groupmate 是一个由用户 lilith1257 维护的开源插件，其核心作用是将 DeepSeek Harness 中的 AI 模型通过 OneBot 11 协议接入 QQ 群，使其以普通群友的身份参与对话。
该插件解决了在 QQ 群中部署私有化或特定人设 AI 的需求，支持按群独立配置角色与模型，并提供可视化的设置界面。
功能概览¶
该插件主要包含以下能力：
- OneBot 11 接入：支持正向和反向 WebSocket 模式，兼容 NapCat、SnowLuma、LLOneBot、Lagrange、go-cqhttp 等主流协议端。
- 角色卡系统：支持定义人设、性格、说话风格及示例对话，兼容 SillyTavern V2 卡片格式及原生 JSON 格式。
- 按群独立配置：每个群可单独指定角色、模型、触发规则和上下文长度，互不干扰。
- 灵活的触发控制：支持被 @、关键词前缀、概率接话、冷却机制，并支持对私聊消息进行响应。
- 上下文与记忆管理：包含多轮上下文处理和基于金字塔算法的长期记忆压缩功能。
- 内置命令系统：支持自定义命令前缀，提供帮助、角色切换、印象管理、提醒、贴纸、天气、塔罗等功能。
- 可选生图功能：当模型输出
[生图:标签]时，可自动调用 Nai2API 兼容服务生成图片。 - 可选语音回复：基于本地 GPT-SoVITS 合成中文或日文语音，支持根据情绪自动切换参考音。
- 本机可靠路由：针对时间、日期、星期等查询，直接由本机回答，不消耗模型额度。
- 可视化设置：所有配置均可在 DSH 的设置页修改，即时生效，无需重启。
安装与启用¶
安装前需确保 DSH 已安装，且系统 PATH 中包含 pnpm（dsh plugin 为 pnpm 转发器）。
1、执行以下命令安装插件（web 为 profile 名称，请根据实际使用修改）：
dsh plugin --profile web add github:lilith1257/dsh-plugin-qq-groupmate
2、安装完成后，dsh 会自动将此插件打包进 profile，无需手动修改配置文件，重启 DSH 即可生效。
3、更新或卸载插件的命令如下：
dsh plugin --profile web update dsh-plugin-qq-groupmate
dsh plugin --profile web remove dsh-plugin-qq-groupmate
配置与接入¶
插件默认使用反向 WebSocket 模式，在本机 127.0.0.1:3001 监听，等待协议端连接。
1、在协议端（如 NapCat、SnowLuma）的网络配置中添加反向 WebSocket 地址：
ws://127.0.0.1:3001
2、若需使用正向 WebSocket 模式（插件主动连接协议端），需在 DSH 插件设置页将 mode 改为 forward，并填入协议端的 WebSocket 地址。
3、接入方式配置（mode）、监听端口（listenPort）、WebSocket 地址（wsUrl）等参数均在 DSH 设置页的可视化界面中修改。
角色卡与记忆¶
插件的数据目录默认为 ~/.dsh/qq-groupmate（即 DSH_HOME/qq-groupmate）。
1、角色卡：将 JSON 格式的角色卡文件放入 characters/ 目录，文件名去掉扩展名即为角色 ID。插件随包自带 characters/default.json 示例卡。支持 SillyTavern V2 格式。
2、记忆与上下文：插件支持多轮上下文和长期记忆。长期记忆采用金字塔压缩算法，以减少 token 消耗并保留重要信息。
可选功能¶
插件提供生图和语音功能的可选支持，但需要手动准备相关服务。
1、生图功能：在设置页配置 imageGen.baseUrl（服务地址）和 imageGen.token（密钥）。需自备 Nai2API 兼容服务。
2、语音回复：在设置页配置 voice.endpoint（中文接口，默认 http://127.0.0.1:9880/tts）和 voice.language（语言选择，支持 auto/zh/ja）。需自备 GPT-SoVITS 服务。
注意事项¶
- 个人项目：本项目为个人自用项目，不承诺兼容性与技术支持。
- 依赖环境：依赖 DSH 已安装且 PATH 中有 pnpm。
- 外部服务：生图和语音功能需用户自行搭建并维护 Nai2API 和 GPT-SoVITS 服务。
- 许可证：随包的
knowledge/rp-hub-faq.md按 CC BY-NC 4.0 授权。
结语¶
dsh-plugin-qq-groupmate 通过 OneBot 11 协议为 DeepSeek Harness 提供了接入 QQ 群的完整解决方案。它强调配置的灵活性与独立性，适合希望在 QQ 群中部署特定人设 AI 的开发者或使用者。
- 项目主页: https://github.com/lilith1257/dsh-plugin-qq-groupmate
- 社区目录: https://www.skillhub.cn/plugins/lilith1257/dsh-plugin-qq-groupmate
