Skip to content

Releases: TomoyoNatsume/dsh-qq-bridge

Release list

v0.1.0

Choose a tag to compare

@TomoyoNatsume TomoyoNatsume released this 17 Aug 03:07

dsh-qq-bridge v0.1.0

首个可用版本:把 QQ 消息通过 NapCat / OneBot 转发给 DSH Agent,并将 Agent 回复发回 QQ,实现“用 QQ 遥控 DSH”。

主要功能

  • 支持 NapCat OneBot 正向 WebSocket 接入
  • 支持 QQ 私聊 / 群聊消息路由
  • 支持 /dsh 指令前缀过滤
  • 支持管理员 QQ 与 allowlist 白名单控制
  • 支持接入真实 DSH Agent,会话保持多轮上下文
  • 支持单 QQ 号模式:从“我的电脑”或自己给自己发送 /dsh ...
  • 支持 NapCat 日志输入补偿 selfLogInput
  • 支持本地 echo 模式,便于先验证 QQ 链路
  • 支持 OneBot WebSocket 断线自动重连
  • 提供完整 README、配置示例、故障排查与发布声明

使用方式

完整安装与配置流程见 README:

  • 安装并登录 NapCat
  • 开启 OneBot 正向 WebSocket
  • 配置 DSH web profile:~/.dsh/profiles/web/cordis.patch.yml
  • 启动 DSH:pnpm dsh web
  • 在 QQ 中发送 /dsh ping 验证链路

开源与第三方声明

本项目使用 MIT License 发布。

本项目不打包、不修改、不再分发 NapCatQQ;NapCatQQ 由用户自行安装并运行,仅通过 OneBot WebSocket 协议与本项目通信。相关第三方项目与依赖说明见 THIRD_PARTY_NOTICES.md

感谢:

  • NapCatQQ
  • OneBot
  • DeepSeek Harness / DSH
  • ws
  • zod

验证

本版本已通过:

  • npm run build
  • npm test

测试结果:7 个测试文件,41 个测试用例通过。