deepseekplugins

DeepSeek Harness 插件

dsh-qqbot-cafeawa

Open-source DeepSeek Harness (dsh) QQ Bot IM plugin（英文原文）

远程与移动
跳到安装方式

来源信息

GitHub 仓库
cafeawa/dsh-qqbot
最近更新
2026年8月16日
分类
远程与移动
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/cafeawa/dsh-qqbot
插件名：dsh-qqbot-cafeawa
作者：cafeawa

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-qqbot

开源的 DeepSeek Harness (dsh) QQ Bot IM 插件。

把 QQ 消息平台作为 dsh agent 的前端协议驱动：用户在 QQ 私聊/群聊中与 dsh agent 对话、执行工具、切换模型、管理会话/工作区，并通过 QQ 消息完成审批。

> 本仓库是从零重写的可开源版本，不包含腾讯内部插件代码，也不依赖 UNLICENSED 的 @tencent-connect/qqbot-connector。 > 底层协议使用 MIT 许可的 @tencent-connect/qqbot-nodejs。

功能

  • QQ 私聊（C2C）/群聊消息接入
  • 流式回复、Markdown 分块发送
  • 会话隔离、空闲回收、重启恢复
  • 模型路由：per-peer 偏好 / settings.yaml / 宿主默认
  • 群聊历史上下文、引用消息、文件附件下载
  • 内置命令：/bot-model、/bot-reset、/bot-status、/bot-workspace、/goal、/dsh 等
  • 工作区隔离与跨会话切换
  • dsh 审批桥：QQ 按钮/文字审批，WebUI 同时提示
  • goal 长任务完成通知

安装

要求：Node.js >= 18，dsh 环境已可用。

# 在 dsh-qqbot 项目目录构建
corepack pnpm install
corepack pnpm build

# 安装到 dsh profile（本地路径）
dsh plugin --profile qqbot add /path/to/dsh-qqbot

# 启动
export QQBOT_APPID="你的AppID"
export QQBOT_SECRET="你的AppSecret"
dsh --profile qqbot

也可通过 cordis.patch.yml 以 --patch 方式加载。

配置

在 profile 的 cordis.patch.yml 中：

- id: im-qqbot
  config:
    appId: __FROM_ENV__
    appSecret: __FROM_ENV__
    requireMention: true
    textChunkLimit: 4500
    sessionIdleTimeout: 1800000
    maxQueue: 20
    processingTimeoutMs: 120000
    historyLimit: 10
    access:
      c2cMode: open
      c2cAllow: []
      groupMode: open
      groupAllow: []
    debug: false

主要配置：

配置类型默认值说明
appId / appSecretstring必填QQ Bot 凭据，也可用 QQBOT_APPID / QQBOT_SECRET
provider / modelstring继承宿主默认模型路由
requireMentionbooleantrue群聊是否需要 @bot
streamingbooleantrueC2C 流式回复
sessionIdleTimeoutnumber1800000会话闲置回收时间
approvalTimeoutMsnumber300000QQ 审批等待超时
approvalNotifyTargetobject-固定审批通知目标
accessobjectopen访问控制

开发

corepack pnpm install
corepack pnpm build     # 构建 dist
corepack pnpm typecheck
corepack pnpm test      # 运行测试

架构

QQ 用户 → QQ WebSocket → @tencent-connect/qqbot-nodejs → 中间件链
                                                              ↓
                                                     handleInbound
                                                              ↓
                                                     SessionManager → dsh agent
                                                              ↓
                                              session/event → outbound → QQ Markdown

License

[MIT](./LICENSE)

返回搜索打开 GitHub 仓库

更多相关插件

查看分类