dsh-qqbot

DSH PLUGIN浏览器与联网

仓库 RrOrange/dsh-qqbot · npm @zaofan/dsh-qqbot

浏览器与联网 L3 · 安装规范通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

把 DeepSeek Harness 接入 QQ 的 DSH plugin:支持群聊与私聊、流式输出、图片文件发送、定时任务、多人格与可视化设置面板。

一句话选型结论

按资料字段整理

dsh-qqbot 是浏览器与联网类的 DSH 可安装插件,验证等级 L3 · 安装规范通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类浏览器与联网 收录类型可安装插件 验证等级L3 · 安装规范通过 安全审查低风险
验证等级 L3 L3 · 安装规范通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-05 创建于 2026-11-05
README 5.6 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:RrOrange/dsh-qqbot
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/cordis@>=4.0.1、@deepseek-ai/dsh-agent@>=0.1.0-rc.6 等 7 个需要同时安装的同级依赖
npm 包名@zaofan/dsh-qqbot可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-qqbot:把 DeepSeek Harness 接入 QQ 的机器人插件

  • QQ 群聊与私聊接入
  • 私聊流式输出
  • 图片与文件发送
  • 定时任务与多人格
  • 可视化设置面板

适用场景

通知文件读写

上游标签

deepseek-harnessdshdsh-pluginllm-agentqq-botqqbotstreaming

验证等级与安全审查

L3 · 安装规范通过
自动化流程结论,不是人工审核
验证等级L3 · 安装规范通过安装命令可解析、DSH 版本已声明,未做实际安装
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L3:安装命令能解析、兼容版本已声明,至少不会一装就报格式错。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在浏览器与联网场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-qqbot当前 L3 · 安装规范通过 低风险 0 未标注 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方RrOrange仓库 dsh-qqbot · 默认分支 main
分类浏览器与联网network
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-05 · 2026-11-05最后推送 2026-11-05
本站收录2026-11-05首次进入本站目录的时间

README 全文

5.6 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-qqbot

把 DeepSeek Harness(dsh)接到 QQ 上的插件:群里能聊、能发图/文件、有定时任务、有多人格、有可视化设置面板。

这份是我在 zaofan-make/dsh-qqbot(又 fork 自 tencent-connect/dsh-qqbot)的 npm 发布版 1.11.36 上手工维护的版本,主要修流式输出和发送链路,并重做了设置面板的一部分 UI。逐条改动见 CHANGELOG.md。

安装

前置:装好 dsh、有 QQ 机器人 AppID/AppSecret。

git clone https://github.com/RrOrange/dsh-qqbot.git
cd dsh-qqbot
pnpm pack --pack-destination .
$tgz = (Get-ChildItem *.tgz).FullName
npx @deepseek-ai/dsh plugin --profile desktop add $tgz   # 桌面客户端
# npx @deepseek-ai/dsh plugin --profile web add $tgz     # dsh web(网页版)

--profile 写你实际在用的那个:就是 %USERPROFILE%\.dsh\profiles\ 下的文件夹名 —— 桌面客户端一般叫 desktop,dsh web 一般叫 web。装错 profile 的表现是「重启后设置里没有 QQ 机器人面板」。

打包出来的文件名不用记:它由 package.json 里的 name + version 决定(本项目原名 @zaofan/dsh-qqbot,所以叫 zaofan-dsh-qqbot-<版本>.tgz)。上面的 $tgz 直接取目录里那个 .tgz,改名也不影响安装。

然后重启 dsh:跑 dsh web 的就重启那个进程,桌面客户端退出重开。也可以直接 dsh plugin --profile <你的profile> add github:RrOrange/dsh-qqbot。

没有构建步骤:dist/ 是随包提交的(这份 fork 没有 src/),npm run build 请忽略。

懒得动手?把这段话丢给 AI

不用手敲命令的话,把下面整段复制,发给你的 AI 助手(Claude Code / Cursor / dsh 自带的 agent 都行),它会把安装和验证跑完:

帮我把这个 DSH 插件装好并验证:https://github.com/RrOrange/dsh-qqbot

请按下面的步骤做,每步做完告诉我结果:

1. 先确认我在用哪个 dsh:桌面客户端还是 `dsh web`。然后把 ~/.dsh/profiles/ 下的文件夹名告诉我
(桌面客户端通常是 desktop,dsh web 通常是 web),后面用这个名字当 --profile 的值。
2. 克隆到 ~/Documents/dsh-qqbot(已存在就先 git pull)。
3. 进目录执行:pnpm pack --pack-destination .
注意:这个仓库的 dist/ 是随包提交的,不要执行 npm run build(它没有 src/,build 会失败)。
4. 执行:npx @deepseek-ai/dsh plugin --profile <第 1 步得到的 profile 名> add <上一步产出的 .tgz 绝对路径>
(文件名由 package.json 的 name+version 决定,别写死;用 (Get-ChildItem *.tgz).FullName 取就行)
Windows 上不要把带空格的目录直接 add(会报 "- isn't supported"),一定要先 pack 再 add。
5. 装完提醒我重启 dsh:跑 `dsh web` 的重启那个进程,桌面客户端退出重开(dist 改动必须重启才生效)。
6. 重启后帮我确认:dsh 的「设置」里是否出现「QQ 机器人」面板。
如果没有,把插件的加载报错原文贴给我,不要自己猜。
7. 如果我还缺 QQ 机器人的 AppID/AppSecret,告诉我先去 https://q.qq.com 注册一个,
并说明拿到之后在面板的哪一栏填。

遇到报错就停下来,把原始报错贴给我,不要跳过。

怎么用

  • 设置面板:设置 → QQ 机器人(多账号时每个实例一页;必须在 web profile 下才有面板)
  • 群里默认只有 @ 机器人才回复;想让它读全部群消息,要去手机 QQ 里改「机器人可获取的群聊消息范围」
  • 私聊是流式(边生成边刷新同一条消息),群聊受平台限制只能整条发
  • 斜杠命令直接发 /help 看

这份 fork 改了什么

  • 流式输出真的能用了:之前出站缓冲只在宿主早已不再发出的旧事件里创建,瞬态帧全被丢掉;改成首帧自建缓冲。新增开关「流式输出(默认开)」,私聊可关成非流式。
  • 发送链路健壮性:限流/5xx 退避重试、长消息分块单块失败不再吞掉后续、群发降速到平台配额内、审批监听重建后不再被旧实例抢走。
  • 图片消息修好:纯 ` 消息以前会被当纯文本发出去;上传失败也不再带[MEDIA:image|…]` 字面标记发出。
  • 事件订阅补全:机器人被移出群、对方关闭主动消息,现在能感知并提示。
  • 设置面板:搜索框合一(字面+语义)、保存条吸底、顶部标签吸顶、「账号与预设」页重做、删掉冗余的「怎么用 / 定时唤醒 / 扩展示例」。
  • 另有一批内存泄漏、时区硬编码、定时任务漏触发之类的杂项修复。

目录

路径 说明
dist/ 就是源码(这份 fork 直接改编译产物,没有 src/)
client/qqbot-settings.js 设置面板,单文件手写 bundle,改完刷新网页即生效
settings-host.js 设置页的 HTTP 路由
docs/ 用户手册、扩展契约、架构说明
examples/ 用户扩展(工具/命令/自定义卡片)样板

更多细节(配置项、内置命令、扩展开发、群管理、智能回复、架构…):用户手册、完整版 README。

参考

  • DSH 插件开发文档:
  • QQ 开放平台:

许可

MIT,见 LICENSE。上游版权归各自作者。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-qqbot 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:RrOrange/dsh-qqbot` 即可。对应的 npm 包名是 `@zaofan/dsh-qqbot`。

dsh-qqbot 的验证等级是什么意思?

L3 · 安装规范通过。安装命令可解析、DSH 版本已声明,未做实际安装

dsh-qqbot 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-qqbot 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-qqbot 需要什么运行环境?

需要同时安装 @deepseek-ai/cordis@>=4.0.1、@deepseek-ai/dsh-agent@>=0.1.0-rc.6、@deepseek-ai/dsh-llm@>=0.1.0-rc.6、@deepseek-ai/dsh-session@>=0.1.0-rc.6、@deepseek-ai/dsh-settings@*。环境不满足时安装会失败,建议先确认本机版本。

dsh-qqbot 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-qqbot 有哪些功能?

QQ 群聊与私聊接入、私聊流式输出、图片与文件发送、定时任务与多人格、可视化设置面板。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

8 条
不同作者的仓库分开列,请确认你要装的是哪一个
浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

L4 · 沙盒安装通过 1,152 星

agentrq

agentrq

L4 · 沙盒安装通过 1,140 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。