安装完成后，启动 DSH Web 界面（默认 http://127.0.0.1:3080），进入 设置 (Settings) 页面，展开 【QQ 机器人 (QQ Bot)】 卡片：

配置项	说明	默认值
`enabled`	是否启用 QQ Bot 适配器	`true`
`appId`	填写 QQ 开放平台的 Bot AppID	`""`
`clientSecret`	填写 QQ 开放平台的 AppSecret（密文遮罩）	`""`
`sandbox`	是否连接沙箱开发环境（测试期间推荐勾选）	`false`
`userOpenid`	绑定的专属用户 OpenID（留空将在收到首条消息时自动绑定）	`""`
`defaultPreset`	新建会话默认 Agent 预设	`"standard"`
`defaultCwd`	新建会话默认工作目录（留空使用当前 DSH 工作区）	`""`
`autoRegisterMenu`	启动后自动向 QQ 开放平台注册底部自定义快捷菜单	`true`
`markdown`	消息回复优先使用 Markdown 渲染	`true`
`syncToolCalls`	是否同步推送工具调用执行进度（防刷屏，默认关闭）	`false`
`toolCallAggregateWindowMs`	工具调用聚合推送窗口时间（毫秒，默认 30000ms / 30秒）	`30000`

保存后，插件会立即热重载配置并自动建立 WebSocket 连接，无需重启 DSH。

dsh-adapter-qq

安装