3. 打开并配置

插件在 cordis.patch.yml 里默认 disabled: true（故意不默认开启，见下面的安全一节）。在你 profile 层的 cordis.patch.yml 追加覆盖：

- id: qq-bridge
  disabled: false
  config:
    allowedGroups:
      - 100000001
    onebot:
      endpoint: 'ws://127.0.0.1:3001'
      accessToken: ''
    # 跑任务用哪个 profile —— 必填，模型和凭据都在里面
    command:
      profile: web
    cwd: 'C:\Users\你的用户名\项目目录'

重启 DSH 后，在群里发：

/dsh ping

收到 pong · 队列 0 · 执行中 0/2 · 会话未建立 就通了。启动日志里应该有两行：

[qq-bridge] headless 调用形态：NDJSON（0.1.7+）
[qq-bridge] 使用 profile：web

配置项

键	默认	说明
`privateOnly`	`false`	只响应私聊，群里完全静默
`allowedUsers`	`[]`	允许的 QQ 号；空 = 不限制
`allowedGroups`	`[]`	允许的群号；空数组 = 不限制任何群（不能用来实现只私聊）
`backend`	`internal`	`internal` / `acp` / `headless`
`ackOnReceive`	`true`	收到消息立刻回「收到，正在处理…」
`sendAttachments`	`true`	把独占一行的链接/标记指向的文件发回 QQ
`resetOnIdleMins`	`180`	空闲多久自动开新会话（0 = 不重置）
`requireMention`	`true`	仅群聊：没前缀时必须 @ 机器人
`commandPrefixes`	`['/dsh','/DSH']`	触发前缀
`perGroupSession`	`true`	每个聊天一个持久会话
`cwd`	空	执行目录；空则用 DSH 进程当前目录
`timeoutSeconds`	`600`	单任务超时
`maxOutputChars`	`3000`	单条消息长度上限，超出自动分片
`maxConcurrent`	`2`	全局并行任务数
`progress.enabled`	`true`	是否报执行进度
`progress.startAfterMs`	`3000`	快于此耗时的任务不报进度
`progress.minIntervalMs`	`5000`	进度节流间隔
`progress.maxMessages`	`12`	单任务进度条数上限
`napcat.dir`	—	NapCat 安装目录，设置页「启动机器人」用
`onebot.endpoint`	`ws://127.0.0.1:3001`	NapCat 的 WS 服务端
`onebot.accessToken`	空	与 NapCat 里的 Token 一致
`command.bin`	`dsh`	dsh 可执行文件；Windows 上自动解析成 `dsh.cmd`
`command.profile`	`headless`	跑任务用哪个 profile（模型/凭据来源）
`command.mode`	自动探测	`json`（0.1.7+ 事件流）或 `plain`（≤0.1.5 纯文本）

dsh-qq-bridge

同名包的其他仓库

安装

说明文档

3. 打开并配置

配置项