dsh-qq
让 DeepSeek Harness 接入你的 QQ：聊天、看图看视频、查记录、发消息，都在一个插件里。
安装使用 · 原生安装与 Docker 迁移 · 高级配置 · 反馈问题
能做什么
| 功能 | 实际用法 |
|---|---|
| QQ 对话 | 群里 @ 机器人、引用它的消息，或私聊它 |
| 图片、动图、视频 | 发给机器人，让它看内容；也能展开合并转发里的聊天和媒体 |
| 在 DSH 里操作 QQ | 让助手发消息、查群成员、找历史聊天、查看人物档案 |
| 统一面板 | 查看在线状态、会话和日志，修改配置，开关自动聊天 |
| 按需扩展 | 表情包、生图、学习、资讯分享、QQ 空间和群管理 |
部分扩展取决于后端权限和外部服务；看图需要视觉模型，动图/视频需要 ffmpeg。
安装使用
1. 准备好这三样
- DSH，运行环境 Node.js 22.13 或更新版本。
- 已登录 QQ 的 SnowLuma / OneBot 后端，拿到它的 HTTP、WebSocket 地址和 Token。
- 模型接口：OpenAI 兼容的接口地址、模型名和 API Key。
没有 QQ 后端？ Debian/Ubuntu + systemd 可使用仓库的原生安装脚本与指南，准备官方原版 SnowLuma v2.4.0 完整包和你提供的原版 QQ。先在仓库根目录预览：
bash scripts/install-native.sh --plan
默认只读；实际安装需显式确认、指定版本和 QQ 来源。脚本不代接受上游条款、不自动启动服务或扫码。安装后由你审核、启动并登录，再回来连接。也可按 SnowLuma 官方指南自行部署；已有后端不用重装。
2. 安装插件
在 DSH 对话里把这句话发给助手：
帮我从 https://github.com/oka-rin/dsh-qq 安装这个插件。
安装来源为这个 GitHub 仓库，不是 npm 上的同名包。也可以下载源码，再在 DSH 插件管理器中用本地目录安装。
3. 连接 QQ 和模型
打开 DSH 设置 → QQ 机器人 → 原生接入（首次配置页），填写：
| 填什么 | 示例 |
|---|---|
| OneBot HTTP 地址 | http://127.0.0.1:3000 |
| OneBot WebSocket 地址 | ws://127.0.0.1:3001/event |
| OneBot Token | 你在后端设置的令牌，不是 QQ 密码 |
| 模型接口 / 模型名 / API Key | 你的模型服务提供的内容 |
示例端口不是固定要求，以你的后端设置为准。向导只直接连接本机后端；远程后端见高级配置。
点击 检测 OneBot 连接 → 检测成功，保存接入配置，然后到「运维」重启机器人。这一步只检测 QQ 连接，模型是否可用要靠下一步试聊确认。
4. 开启聊天，发一条试试
新安装默认不开口。在配置里开启聊天，按需开启私聊回复；用于群聊时先填允许的群，再启用。群白名单留空表示不限制群。
在 QQ 私聊机器人，或在允许的群里 @ 它，发一句“你好”。收到了回复，再按需打开视觉、动图、视频和转发展开开关，试发对应消息；这些能力新安装也默认关闭。
装好后可以这样用
在 DSH 对话里直接说，不需要背工具名：
- “看看 QQ 机器人在线没有。”
- “列出机器人加入的群。”
- “看看这个群最近在聊什么。”
- “查一下之前聊过的视频。”
- “给这个群发一条消息：今晚八点开始。”（指定目标群）
- “为什么机器人刚才没回复？”
常见问题
连接检查通过，但不回复？ 先检查聊天开关、私聊开关和群范围，再让助手查“为什么没回复”；连接成功不会自动开启发言。
看不到图片或视频？ 图片需要支持视觉的模型；动图和视频还需要 ffmpeg / ffprobe。大视频下载和抽帧需要时间，没拿到画面时不应编造内容。
已经用 Docker 跑着 SnowLuma？ 可继续连接原实例，使用 Docker 兼容模式。想迁到原生时按备份、切换与回滚步骤操作；安装脚本不会停止容器、复制登录态或删除卷，扫码登录和验收仍需人工完成。
更新会丢聊天记录吗？ 配置、聊天归档和学习数据放在独立数据目录，不在插件代码里。沿用原 dataDir 并先备份，不要另开一个机器人实例。迁移与回滚
No comments yet. Be the first to write one.