dsh-qqchat
DeepSeek Harness 的 QQ 私聊/群聊插件，支持扫码授权、原生 Session、群记忆与工具权限。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-qqchat@0.2.6
Qqchat 以 dsh-qqchat 发布，当前版本为 0.2.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-qqchat 是 DeepSeek Harness（DSH）的 QQ Bot 插件，支持 QQ 群聊、私聊、会话隔离、记忆系统和 DSH 原生命令。
当前版本基于 DSH 0.1.6-alpha.1 验证，安装插件即可使用，无需修改或重新构建 DSH。
本项目是一个 Vibe Coding 项目，代码质量和工程完整性可能需要改进。如果你发现问题或有更好的实现建议，欢迎提交 Issue 或 Pull Request。
| 功能 | 说明 | 备注 |
|---|---|---|
| QQ 群聊与私聊 | 接收 QQ Bot 的群聊和私聊消息 | 每个群、每个私聊对象对应独立 DSH 会话 |
| 扫码连接 | 在 设置 → QQ Chat 中扫码绑定 QQ Bot | 支持取消连接后重新绑定 |
| 手动连接 | 在设置页填写 AppID 和 AppSecret 连接 QQ Bot | 适合无手机、服务器或扫码失败场景；密钥只提交到 Host |
| 断线重连 | QQ Gateway 断线后自动恢复连接 | 无需重复扫码 |
| 群聊回复模式 | 自动回应、@回复、静默记录 | 可在设置页随时切换 |
| 消息格式兼容 | 智能兼容、Markdown、纯文本兼容 | 可兼容旧版本QQ的群友们！ |
| 私聊流式回复 | 私聊可选用 QQ 官方流式消息接口逐步更新回复 | 仅适用于私聊；纯文本兼容模式自动关闭；部分客户端可能不可见 |
| 消息引用与 @ | 支持引用消息和 QQ @消息 | @用户优先显示用户名 |
| 会话隔离 | QQ 群聊和私聊分别使用独立会话 | 不同群、不同用户的上下文互相隔离 |
| 记忆系统 | 保存群聊、群成员和私聊用户的独立记忆；同一 Bot 下的用户记忆支持跨群复用 | 群关系和群级事件不会跨群共享；设置中可关闭 |
| 记忆整理 | 自动将近期记录整理为长期记忆 | 后台执行，不阻塞正常回复 |
| 媒体与文件权限 | 分别控制群成员媒体接收、媒体读取和普通工具使用 | Owner 与私聊默认不受限制 |
| 权限管理 | 单独控制群成员是否可以使用普通 Agent 工具、读取媒体和接收文件 | 可指定 Owner，按稳定用户 ID 判断 |
| DSH / QQChat 命令 | QQ 中直接执行 /compact、/goal、/plan、/qqmodel、/qqstatus 等命令 | 命令不经过模型；发送 /qqhelp 查看完整列表 |
| DSH 原生界面 | 使用 DSH 默认会话、聊天区和输入框 | 支持从 DSH 主动向 QQ 发送消息 |
| Session Preset | 每个 QQ Session 可使用 DSH 原生 preset | 新 Session 使用插件默认 preset；Session 自己选择后独立保存 |
| 日志查看 | 在设置页查看 QQ Chat 运行日志 | 方便排查连接和消息问题 |
QQ Chat 扫码连接
扫码连接在 DSH Web 的 设置 → QQ Chat 中生成二维码，使用手机 QQ 扫描即可完成官方 Bot 授权。连接状态、重新生成二维码和取消绑定都可以在同一页面完成。 |
QQ Chat 设置页面
设置与权限在设置页面配置群聊接收方式、消息格式、记忆系统、媒体与文件权限、工具权限以及 Owner。 |
QQ 群聊在 DSH Web 中的显示
群聊与私聊QQ 群聊和私聊都会接入 DSH Agent，并在 DSH Web 中以独立 Session 展示。群聊支持自动回应、@回复和静默记录，也支持引用消息、用户名显示和 @用户转换。 |
QQ Chat 群聊记忆系统
记忆系统插件会分别维护群聊、群成员和私聊用户的记忆。同一 Bot 下，基于稳定用户 ID 的用户记忆可以跨群复用；群内关系和群级事件只保留在对应群。成员记忆支持资料、群内称呼、历史昵称、行为模式和长期信息；近期消息会在空闲或达到阈值后自动整理。记忆会作为 Session 上下文按需刷新，设置中可以关闭，关闭后不会删除已有数据。 |
npx @deepseek-ai/dsh plugin --profile qqchat add @deepseek-ai/dsh-web-app dsh-qqchat
npx @deepseek-ai/dsh --profile qqchat
npx @deepseek-ai/dsh plugin --profile web add dsh-qqchat
npx @deepseek-ai/dsh --profile web
当前开发分支也可以直接从 GitHub 安装：
npx @deepseek-ai/dsh plugin --profile qqchat add @deepseek-ai/dsh-web-app dsh-qqchat
npx @deepseek-ai/dsh --profile qqchat
如果无法扫码，也可以选择 手动配置，填写 QQ 开放平台的 AppID 和 AppSecret，并按需选择沙箱环境。插件会先验证凭据，验证成功后再保存并启动 Gateway。
连接成功后，QQ Chat 的设置和对话会出现在 DSH 中。
在 设置 → QQ Chat → 消息接收 中可以选择：
| 模式 | 行为 |
|---|---|
| 自动回应 | 每条群消息都会交给 Agent，Agent 可以自动回复 |
| @回复 | 所有消息都会记录，但只有 @Bot 的消息会触发回复 |
| 静默记录 | 只保存消息和记忆，不主动回复 |
群聊默认使用纯文本兼容格式，适合不同 QQ 客户端。私聊和群聊可以分别选择智能兼容、Markdown 或纯文本兼容。私聊使用纯文本兼容时会自动关闭流式传输。
QQ 中以 / 开头的消息会交给命令系统处理，不会作为普通消息发送给模型。DSH 原生命令保持原名；QQChat 自有命令使用 qq 前缀。群聊中可以发送 @Bot /qqhelp。
| 命令 | 用途 |
|---|---|
/qqhelp、/qqcommands | 查看 QQChat 和 DSH 命令 |
/qqnew、/qqreset、/qqclear | 保留旧 Session，下一条消息开始新的 QQ Session |
/compact | 手动压缩较早的会话历史 |
/qqmodel [provider/]model | 查看或切换当前群聊/私聊的模型 |
/qqpreset [preset] | 查看或切换当前空白 Session 的 Agent Preset；对话开始后需新建 Session |
/qqstop | 中止当前生成 |
/qqstatus | 查看当前 Session、模型和生成状态 |
/qqping | 测试 QQChat 连通性 |
/qqversion | 查看 QQChat 版本 |
/goal | 查看、创建、编辑、暂停、恢复或清除 Goal |
/plan | 进入或退出 Plan 模式 |
/feedback | 提交反馈 |
/permission | 查看或切换工具权限预设 |
/feedback 反馈去向/feedback 使用 DSH 原生反馈机制，不会自动创建 GitHub Issue，也不会直接发送给 QQChat 作者。默认情况下，反馈只写入当前 DSH Session 的本地日志，不会离开本机。
只有在 DSH 显式配置会话遥测时才会上传到配置的 OTLP 服务：
| DSH 遥测模式 | 反馈去向 |
|---|---|
DISABLED（默认） | 仅保存在本地 Session |
FEEDBACK_ONLY | 执行 /feedback 时，将当前 Session 日志后缀发送到配置的 OTLP 服务 |
FULL | Session 事件按配置实时发送到 OTLP 服务；/feedback 另外记录反馈事件 |
反馈可能包含当前 Session 的对话、工具参数、工具结果和工作区路径。提交前请确认 DSH 遥测配置符合你的隐私要求。
/export 是 DSH Web 的浏览器下载命令，QQ 中会提示暂不支持。模型切换按群聊/私聊分别生效，并保留已有对话上下文。
QQ Chat 会分别保存：
同一 Bot 下，用户记忆按照稳定用户 ID 跨群连续；群内关系、群级事件和群聊记录不会跨群混入。不同 Bot 的用户记忆相互隔离。
记忆会在聊天空闲或积累到一定数量后异步整理，不会阻塞正常回复。可以从 QQ Session 顶部的 QQ 记忆 入口查看群和成员记忆。记忆内容会按需进入 Agent 上下文，启用后可能降低上下文缓存命中率并增加输入 token；可在 设置 → QQ Chat → 记忆系统 中关闭。
记忆快照会在新 Session、记忆上下文过期或 Session 压缩后刷新，连续对话不会重复写入完整记忆。群级记忆和当前群员记忆分别管理，群持续活跃不会替潜水成员刷新成员记忆。
在设置中，媒体与文件权限和普通工具权限分别控制：
关闭媒体接收不会影响普通文字消息；关闭普通工具或媒体读取也不会影响群友正常聊天和获得回复。
Owner 使用 QQ 的稳定用户 ID 判断，不根据昵称判断身份。
QQ 对话会使用 DSH 的默认聊天界面显示：
QQ Session 使用 DSH 原生的 Agent Preset 机制。插件配置中的 preset 只作为新建 QQ Session 的默认值；在 DSH Web 中为某个空白 Session 选择 preset 后，选择结果会随该 Session 保存，重启或恢复后仍优先使用该 Session 最近一次选择。也可以在该 Session 的第一条 QQ 消息中发送 /qqpreset <preset> 完成选择。对话开始后 DSH 不允许更换 preset，此时请先使用 /qqnew。插件不复制 DSH 的 preset、工具或 AgentLoop。
0.2.2 仍在持续完善，建议先在测试 Bot 和测试群中使用。npm install
npm run check
更多开发约定和内部说明见：
本项目使用 MIT License。