hzh5021/dsh-qq ↗★ 0

dsh-qq

Bridges a OneBot QQ bot into DSH: the owner's direct messages open a session on the same home, answers go back to QQ, and files named with [SEND_FILE: path] are delivered. 适合希望通过QQ私聊直接与DSH进行交互并传输文件的用户。

패키지
dsh-qq
호환성
미검증
버전
0.1.0
라이선스
MIT
최근 업데이트
2026. 10. 23.

설치

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

配置

键默认说明
wsUrl"ws://127.0.0.1:3001"OneBot 正向 WebSocket 地址;带 token 就写在 URL 的 query 里
ownerId0唯一放行的 QQ 号。0 = 谁都不放行(私聊一律丢掉,启动时大声报一次)——必须配
cwd~/.dsh/dsh-qq/workspace会话的工作目录(写进 session meta),启动时自动建出来;不建的话工作区按路径认不到人,会话会落在未分组里
agentPreset未设要挂到会话上的 preset id
settleMs2000回答停顿这么久没有新内容,就当它说完了
maxChars1700一条消息最多多少字,长了切开
idleResetMs21600000隔这么久没说话,下一条消息当新话题;0 = 关掉
approvalTimeoutMs300000等主人批/不批最多这么久,到点还给下一个应答者
approvalRemindMs90000到点先催一句;0 = 不催
reconnectMaxMs30000重连退避的上限
httpPort3002只监听本机的小状态口,读的是 JSON
logFile~/.dsh/dsh-qq/dsh-qq.log日志文件
qrPath""OneBot 实现落的登录二维码图片路径(状态口 /qr 会把它吐出来)
napCatLog""解码 URL 所在的日志(二维码图扫不动时可以手敲那个 URL)
mediaDir~/.dsh/dsh-qq/media进来的图/语音/文件落这儿

一处要留意:会话的 provider/model 取自宿主的默认选择(ctx.agentDefaultModel.currentSelection()),插件不提供这两个配置项。另外 httpPort 不在 DEFAULTS 里,是读的时候带上的默认值(Number(opts.httpPort) || 3002)。

- id: qq
  name: dsh-qq
  config:
    wsUrl: ws://127.0.0.1:3001/?access_token=
    ownerId: 
    cwd: 
    agentPreset: