jixishi/dsh-adapter-qq ↗★ 7

dsh-adapter-qq

DeepSeek Harness QQ Bot Adapter - C2C chat, session sync, rich media, skills/MCP management, text-to-image tools

包名
dsh-adapter-qq
兼容性
待验证
Harness 依赖范围
>=0.2.1-rc.3 <0.3.0
Cordis 依赖范围
^4.0.0
版本
0.2.5
许可证
MIT
最近更新
2026年11月9日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jixishi/dsh-adapter-qq

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
autoSendAttachmentsAgent 回复中的图片/文件自动转发到 QQtrue
sendOverviewCaption渲染图片发送后是否再补发文字说明false
streamReply是否启用流式回复(按增量持续推送回复文本)false
streamIntervalMs流式推送间隔(毫秒,500–10000)1500
renderWidth文本渲染图片的像素宽度(480–1600)900
renderTheme文本渲染图片主题(light / dark)light
subscriptionSendMode订阅汇聚通知发送形式:text(默认,超长自动转图片)/ auto / image(总是图片)text
busyDeliveryAgent 运行中时普通文本如何投递:steer 立即插话 / queue 本轮结束后发送steer
notifyTurnAbnormal轮次非正常结束时向 QQ 推送状态提示true
notifyRestartRecovery宿主重启后补发在途轮次的中断提示false
mcpManagerToken@xxxyz/dsh-mcp-manager 写操作令牌(可选,密文遮罩;也可用环境变量 DSH_MCP_MANAGER_TOKEN)""

表中是用户可见的设置项。token、activeSessionId、allowFrom 等内部字段不占用设置页行,由插件自身维护。

保存后,插件会立即热重载配置并自动建立 WebSocket 连接,无需重启 DSH。随后在 QQ 里给机器人发一条私聊消息,即完成 OpenID 绑定。