DeepSeek-harness-qqbot 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=22.19）；该结论来自程序自动检查，未经人工实机验证。

DeepSeek-harness-qqbot 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=22.19）；该结论来自程序自动检查，未经人工实机验证。

DeepSeek-harness-qqbot 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

DeepSeek-harness-qqbot 还在维护吗？

GitHub 7 星。最近一次上游提交在 2026/8/19。

QQ 机器人通道 sliverp/DeepSeek-harness-qqbot

DeepSeek Harnessv0.1.5

sliverp76 天前有提交已提供中文文档扫描：含敏感能力需联网notifyocr

在 GitHub 查看 ↗

把 QQ 私聊群聊接入智能体，收发文本图片文件

37/100

综合分

GitHub 星标

1,687

npm 周下载

—/5

用户评分

数据截至 2026/8/21 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add deepseek-harness-qqbot

npm 源 · deepseek-harness-qqbot 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · vision

装得上吗

本站已在 dsh 0.2.1-rc.5 下真实安装成功

非静态推断

L5 · 运行时冒烟等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 76 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包deepseek-harness-qqbot @ 0.1.5

✓Node 引擎要求 >=22.19 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/1 08:20:22

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求

查看扫描证据（共 6 处，展示前 6 条）

发起网络请求
dist/index.js:257
const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
读取本地文件
dist/index.js:300
root = await realpath(cwd);
读取本地文件
dist/index.js:305
const rootInfo = await stat(root);
读取本地文件
dist/index.js:310
path = await realpath(unresolved);
读取本地文件
dist/index.js:318
const info = await stat(path);
发起网络请求
dist/index.js:1024
return await this.approvals.request(request, turn);

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

⚠ 该插件运行需访问外部网络 / 远程 API，部署在国内无外网环境时可能无法正常使用。

依赖的 DSH / Cordis 模块

@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-agent-default-model@deepseek-ai/dsh-agent-presets@deepseek-ai/dsh-attachment@deepseek-ai/dsh-commands@deepseek-ai/dsh-credentials@deepseek-ai/dsh-llm@deepseek-ai/dsh-session@deepseek-ai/dsh-session-persistence@deepseek-ai/dsh-system-prompt

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

接入QQ私聊群聊
收发文本图片文件

DeepSeek Harness 的 QQ 机器人文本与图片频道插件

README

由 DeepSeek 最新模型翻译生成

DeepSeek Harness QQBot 这是一个树外 DeepSeek Harness 通道插件，通过 QQ 官方 Gateway 把 QQ 智能机器人连接到可持久化的 Harness agent。功能 - 使用官方 @tencent-connect/qqbot-nodejs SDK - 支持 QQ 私聊和群聊文本收发 - 接收 PNG、JPEG、WebP、GIF 图片并保存为 Harness 持久附件 - 当前模型不支持图片输入时自动降级为文本元数据，不让整轮失败 - 接收语音转写和非图片附件元数据，并向模型提供 QQ 临时下载地址 - 发送 agent 生成的文本、图片和工作目录内的本地文件 - 提供仅当前 QQ 回合可用的 qq_send_file 工具，并校验工作目录范围和文件大小 - 默认以 QQ Markdown 格式发送回复 - 每个私聊或群聊对应一个独立、可恢复的 Harness 会话 - /new、/reset 保留旧记录并切换到新的持久会话；其他 Harness 斜杠命令直接进入命令运行时 - 挂载 Harness agent preset，使 QQ 会话与网页会话使用相同的工具、提示词和技能组合 - 网页已打开同一会话时安全复用 live agent，不创建第二个 session writer

展开完整文档（README 剩余 1 节）

DeepSeek Harness QQBot

这是一个树外 DeepSeek Harness 通道插件，通过 QQ 官方 Gateway 把 QQ 智能机器人连接到可持久化的 Harness agent。

功能

- 使用官方 @tencent-connect/qqbot-nodejs SDK
- 支持 QQ 私聊和群聊文本收发
- 接收 PNG、JPEG、WebP、GIF 图片并保存为 Harness 持久附件
- 当前模型不支持图片输入时自动降级为文本元数据，不让整轮失败
- 接收语音转写和非图片附件元数据，并向模型提供 QQ 临时下载地址
- 发送 agent 生成的文本、图片和工作目录内的本地文件
- 提供仅当前 QQ 回合可用的 qq_send_file 工具，并校验工作目录范围和文件大小
- 默认以 QQ Markdown 格式发送回复
- 每个私聊或群聊对应一个独立、可恢复的 Harness 会话
- /new、/reset 保留旧记录并切换到新的持久会话；其他 Harness 斜杠命令直接进入命令运行时
- 挂载 Harness agent preset，使 QQ 会话与网页会话使用相同的工具、提示词和技能组合
- 网页已打开同一会话时安全复用 live agent，不创建第二个 session writer
- 通过 QQ 主动推送仅限回合发起人操作的“允许一次”和“拒绝”批准按钮
- 批准超时自动拒绝、发送失败回退其他已组合批准通道，且后续工具调用不继承提权
- 输入状态提示、长回复拆分、同会话消息串行处理、消息排重、发送重试和超时保护
- 私聊/群聊可分别配置开放、白名单或禁用
- 内置 /bot-ping、/bot-image-test、/bot-file-test、/bot-help、/bot-status、/bot-cancel
- Secret 通过 Harness 凭据服务解析，不进入插件配置
- 未配置 AppID 或 AppSecret 时保持休眠，单独安装插件不会阻断 DSH 启动

环境要求

- Node.js 22.19 或更高版本
- pnpm 10.33.4
- DeepSeek Harness 0.1.0-rc.7 或更高版本
- 已开启私聊和/或群聊消息事件的 QQ 机器人 AppID、AppSecret；QQ 批准按钮还需要 Inline Keyboard 权限

安装

从 GitHub 安装到 web profile：

pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-qqbot

从本地检出安装：

pnpm dsh plugin --profile web add /absolute/path/to/DeepSeek-harness-qqbot

配置

AppID 由启动环境提供，AppSecret 保存到 QQBOT_APP_SECRET 凭据引用。开发时也可以直接通过环境变量注入：

export QQBOT_APP_ID='your-app-id'
export QQBOT_APP_SECRET='your-app-secret'
pnpm dsh --profile web

组合包会读取 QQBOT_APP_ID，通过 ctx.credentials 解析 QQBOT_APP_SECRET，并默认让 agent 使用启动目录作为工作目录。可以用 DSH_QQBOT_CWD 覆盖工作目录。

安装组合包后不必立即配置凭据。AppID 为空，或引用的 AppSecret 不存在/为空时，通道会记录“未配置、保持休眠”的日志并允许 DSH 正常完成启动；补齐两项配置后重载或重启 DSH 即可连接。非空但错误的凭据只会让 QQ 通道保持离线；鉴权在后台进行，不会导致 DSH 启动失败。

长期使用时，建议把 QQBOT_APP_ID 放到 ~/.dsh/.env，并通过 Harness 凭据设置界面保存 QQBOT_APP_SECRET。不要把任何真实凭据提交到 Git。

如需修改权限策略或限制，在 ~/.dsh/profiles/web/cordis.patch.yml 覆盖该插件行：

- id: qqbot-channel
name: deepseek-harness-qqbot
config:
appId: !!js process.env.QQBOT_APP_ID
appSecretRef: QQBOT_APP_SECRET
cwd: !!js process.env.DSH_QQBOT_CWD ?? process.cwd()
agentPreset: standard
c2cPolicy: allowlist
c2cAllowFrom: [你的用户-openid]
groupPolicy: open
requireMentionInGroup: true
imageInputMode: auto
markdownSupport: true
approvalTimeoutMs: 120000
maxOutboundFileBytes: 104857600

imageInputMode 默认为 auto：支持视觉的模型会收到持久图片块；纯文本模型会收到图片元数据和临时来源 URL，避免整轮失败。只有确认模型支持图片时才使用 always；使用 never 可强制文本降级。

markdownSupport 默认为 true，与腾讯官方 QQBot 通道插件保持一致。开启后，QQ SDK 会把 agent 文本作为 msg_type=2 发送，使标题、列表、链接、强调、表格和代码块可在 QQ 中渲染。只有机器人尚未获得 QQ Markdown 权限时才设置为 false，否则 QQ API 会拒绝 Markdown 消息。

agentPreset 默认使用当前 Harness 部署选择的默认 preset（通常是 standard）。插件会把 preset 写入会话头，并在恢复时重新挂载，使 QQ 会话获得与网页新建会话相同的工具、提示词和技能组合。旧版本创建的会话使用 qqbot-v1- 命名空间；修复后会在 qqbot-v2- 下新建正确组合的会话，旧历史保留不动。

/new 和 /reset 由 QQ 插件直接处理：当前生成会先取消并闭合，随后创建带递增后缀的新持久 session，旧 session 不删除；服务重启后会继续使用最新一代。其他斜杠输入会按原样调用 ctx.commands.execute(agent, line, signal)，因此 /compact、/goal、/plan、/permission、/feedback 等实际已由当前 preset 注册的命令都不会进入模型。未知或语法无效的斜杠输入会直接返回当前可用命令列表，同样不会被模型误解为普通聊天。命令若请求工具批准，仍使用发起该命令的 QQ 用户专属批准按钮。

QQ 发起的回合需要 Harness 批准时，插件会主动推送带“允许一次”和“拒绝”按钮的 QQ 消息。只有发起该回合的 QQ 用户可以操作，群聊中同样如此。允许结果只覆盖当前这一次操作；Harness 没有持久的“始终允许”结果。QQ 范围内的提示要求后续每次工具调用先使用当前沙箱，只有某项操作刚被沙箱拒绝后，才可在该操作的原样重试中使用 sandbox_permissions。approvalTimeoutMs 默认为 120,000 毫秒，超时未选择会拒绝操作。批准消息发送失败时，请求会交给网页等其他已组合的批准通道；网页发起的回合仍直接使用网页批准。

当前 QQ 用户要求接收或下载文件时，agent 可以调用会话范围内的 qq_send_file 工具。相对路径从 cwd 解析，绝对路径也必须位于 cwd 内。插件会先解析符号链接，只接受普通文件，并拒绝超过 maxOutboundFileBytes 的文件；默认值也是 QQ 协议上限 104,857,600 字节（100 MiB）。

文件工具只在插件处理当前 QQ 消息期间生效；从网页继续同一个持久会话时，不能向上一次 QQ 目标发送文件。如果网页已经打开同一个持久会话，QQ bridge 会借用该 agent、等待当前活动结束，不会尝试恢复第二个写入者。只要工作目录含有非公开数据，就应使用 allowlist 访问策略，因为白名单内的 QQ 用户也能使用所选 agent preset 提供的其他工具。

验证

日志出现 QQ Gateway connected 后，在 QQ 中向机器人发送 /bot-ping，应收到：

pong — DeepSeek Harness QQBot 已连接。

然后发送普通文本或图片。插件会把消息追加到对应的 Harness 持久会话，并把当前默认模型的回复发回 QQ。

发送 /new 后，机器人应确认已新建会话；再询问旧上下文中的信息时不应继续记得。随后分别发送当前组合已注册的 /goal、/plan 或 /compact，QQ 应直接显示 Harness 命令结果，不能再出现模型解释“没有这个命令”的回复。发送 /not-a-command 应返回未知命令和可用命令列表，且不创建模型回合。

发送 /bot-image-test 可以直接验证 QQ 官方图片上传和图片出站接口，不依赖模型生成图片。机器人应先发送一张蓝色 PNG，再回复发送成功。

发送 /bot-file-test 可以在不调用模型的情况下验证 QQ 官方文件上传接口。机器人应先发送 qqbot-file-test.txt，再回复发送成功。随后可以要求 agent 发送工作目录中已有的文件，例如“把 README.md 作为文件发给我”；对应会话中应出现 qq_send_file 调用，QQ 应收到附件。

验证批准路由时，选择会在沙箱提权前询问的权限 preset，再要求 agent 执行需要更高权限的操作。QQ 应主动收到“允许一次”和“拒绝”按钮；点击后同一回合应继续执行，网页不再显示这次批准。

开发

pnpm install
pnpm run check

许可证

MIT