dsh-adapter-qq
DeepSeek Harness QQ Bot Adapter - C2C chat, session sync, rich media, skills/MCP management, text-to-image tools
インストール
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jixishi/dsh-adapter-qqドキュメント
README 全文を読む ↗3. 在 DSH Web UI 中配置
打开 DSH Web 界面(地址由 dsh web 启动时打印,不是固定端口),进入 设置 → 插件 → 「QQ 机器人」 tab。
推荐:扫码绑定 —— 点击「生成绑定二维码」,用手机 QQ 扫码确认;成功后自动填入 AppID、AppSecret 与绑定 OpenID。二维码约 2 分钟有效,失败时界面会显示 [code] message、retcode、detail。也可以直接手工填表。
所有配置字段均声明为
volatile,保存后写入 profile patch 并即时热应用:修改 AppID/AppSecret/沙箱会自动重连,不需要重启 DSH。设置页还带「检查更新」(只对比 npm 版本号,不下载不安装)。
| 配置项 | 说明 | 默认值 |
|---|---|---|
enabled | 是否启用 QQ Bot 适配器 | true |
appId | 填写 QQ 开放平台的 Bot AppID | "" |
clientSecret | 填写 QQ 开放平台的 AppSecret(密文遮罩) | "" |
sandbox | 是否连接沙箱开发环境(默认开启;机器人正式上线前请保持开启,并需在开放平台「测试人员管理」中加入您的 QQ 号) | true |
userOpenid | 绑定的专属用户 OpenID(留空将在收到首条消息时自动绑定) | "" |
defaultPreset | 新建会话默认 Agent 预设 | "standard" |
defaultCwd | 新建会话默认工作目录(留空使用当前 DSH 工作区) | "" |
autoRegisterMenu | 启动后自动向 QQ 开放平台注册底部自定义快捷菜单 | true |
markdown | 消息回复优先使用 Markdown 渲染 | true |
syncWebQuestions | 把 Web UI 端输入的提问同步推送到 QQ(默认关闭,避免频繁打扰) | false |
syncToolCalls | 是否同步推送工具调用执行进度(防刷屏,默认关闭) | false |
toolCallAggregateWindowMs | 工具调用聚合推送窗口时间(毫秒,默认 30000ms / 30秒) | 30000 |
sessionPageSize | 会话列表每页数量(QQ 操作板建议 ≤6) | 6 |
sessionPathDisplay | 会话列表工作区路径显示:tail 仅最后一级文件夹 / full 完整路径 | tail |
autoSendAttachments | Agent 回复中的图片/文件自动转发到 QQ | true |
sendOverviewCaption | 渲染图片发送后是否再补发文字说明 | false |
streamReply | 是否启用流式回复(按增量持续推送回复文本) | false |
streamIntervalMs | 流式推送间隔(毫秒,500–10000) | 1500 |
renderWidth | 文本渲染图片的像素宽度(480–1600) | 900 |
renderTheme | 文本渲染图片主题(light / dark) | light |
subscriptionSendMode | 订阅汇聚通知发送形式:text(默认,超长自动转图片)/ auto / image(总是图片) | text |
busyDelivery | Agent 运行中时普通文本如何投递:steer 立即插话 / queue 本轮结束后发送 | steer |
notifyTurnAbnormal | 轮次非正常结束时向 QQ 推送状态提示 | true |
notifyRestartRecovery | 宿主重启后补发在途轮次的中断提示 | false |
mcpManagerToken | @xxxyz/dsh-mcp-manager 写操作令牌(可选,密文遮罩;也可用环境变量 DSH_MCP_MANAGER_TOKEN) | "" |
表中是用户可见的设置项。
token、activeSessionId、allowFrom等内部字段不占用设置页行,由插件自身维护。
保存后,插件会立即热重载配置并自动建立 WebSocket 连接,无需重启 DSH。随后在 QQ 里给机器人发一条私聊消息,即完成 OpenID 绑定。