DLive/dsh-qqbot-community0

dsh-qqbot-community

QQ Official Bot adapter for DeepSeek Harness (migrated from openclaw-qqbot)

AI 분석

核心用途是将 DSH 接入 QQ 机器人。适合希望通过 QQ 聊天界面远程使用 DSH 智能体服务的团队或个人用户。

패키지
dsh-qqbot-community
버전
1.0.4
라이선스
MIT
최근 업데이트
2026. 8. 16.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:DLive/dsh-qqbot-community

2. 在 profile 的 cordis.patch.yml 覆盖默认配置

DSH 的层顺序是:每个 bundle 的 patch → profile 的 cordis.patch.yml → home 级 cordis.patch.yml--patch 覆盖层。后者覆盖前者,所以用户在自己 profile 的 patch 文件里补 QQ 凭证即可,不需要改 bundle。

编辑 ~/.dsh/profiles/web/cordis.patch.yml,在已有内容末尾追加(不要覆盖文件里已有的其它 patch):

- id: qqbot-community
  name: dsh-qqbot-community
  config:
    id: '你的 AppID'        # 必须加引号(避免 YAML 数字解析)
    secret: '你的 AppSecret'
    sandbox: true
    provider: 'DeepSeek' # 新建会话默认提供商
    model: 'DeepSeek-V4-Flash' # 新建会话默认模型
    agentPreset: 'standard'    # 新建会话默认 preset id:standard / code / minimal / cordis / 自定义;缺省值 standard。QQ 里可用 /new  按会话覆盖(见斜杠命令表)
    cwd: '/Users/xxxx/workdir'   # QQ 会话 agent 工作区目录(须真实存在)
    # 以下均可省略,以下为默认值
    allowFrom: ['*']           # C2C 白名单;填 openid 数组限定用户
    groupAllowFrom: ['*']      # 群白名单
    markdown: false            # msg_type 2,需开通 markdown 权限
    typing: true               # C2C 输入中指示
    streaming: true            # C2C 流式回复
    streamThrottleMs: 1200     # 流式帧节流
    deliverWindowMs: 900       # 轮内回复合并窗口
    deliverMaxWaitMs: 6000     # 合并最大等待
    textChunkLimit: 4000       # 单条静态回复上限
    replyPassiveLimit: 4       # 每条消息被动回复上限
    mediaDownload: true        # 非图片附件落盘 /.qq-media/
    approval: true             # QQ 内联键盘审批
    approvalTimeoutMs: 300000  # 审批等待超时
    slashCommands: true        # /help /ping /me /new /approve /always
    # stt:                     # 可选:语音转写(OpenAI 兼容)
    #   baseUrl: 'https://api.openai.com/v1'
    #   apiKey: 'sk-...'
    #   model: 'whisper-1'

如果你只想临时调试本仓库代码、不走 npm,也可以在不修改 profile 的前提下用 --patch 直接喂这份 patch 给 dsh:

cd /path/to/dsh-qqbot-community
pnpm install && pnpm run build
dsh web --patch ./cordis.patch.yml

这条路径绕开 dsh plugin 的依赖管理,仅适合本地开发。

🛠️ 开发模式:clone → build → 以本地 lib/index.js 绝对路径挂载到 profile patch 的完整步骤与常见问题,见 DEVELOPMENT.md