DSH Plugins
返回列表
🖥️

dsh-qqbot

客户端 更新于 2026.11.04

在终端中运行以下命令:

dsh plugin install prophetcrab/dsh-qqbot

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install prophetcrab/dsh-qqbot,或按文档从 https://github.com/prophetcrab/dsh-qqbot 安装该客户端插件。

插件介绍

在 macOS 上把 QQ 机器人跑稳,往往要在 NapCat 登录与协议、Koishi 的会话与权限、以及 AI 与业务配置之间来回切换。dsh-qqbot 是 DeepSeek Harness 侧的 QQ 机器人控制中心:它不替代 NapCat 或 Koishi 的本职,而是统一负责安装与启停、配置控制面、AI 网关、人设与画像,以及可视化管理面板,让三端职责清晰、由 DSH 统筹外部运行时。

插件按 host 与 client 模块化拆分:每个能力以独立 host 插件贡献路由、工具与 Tab,关闭即整体下线;控制面板由多个 Client 插件组成,避免维护巨型单文件。Koishi 侧源码同样插件化,通过 ctx.qqbot.* 服务协作。首次加载会从模板创建本地 Koishi 项目、解压内置 darwin-arm64 依赖,并从校验过的 NapCat 离线包安装,再衔接 OneBot 反向 WebSocket,登录后由 Koishi 执行权限、触发与发送,DSH 写入配置与人设数据。

适合已在 DeepSeek Harness 生态中、需要在 Apple Silicon Mac 上搭建 QQ 机器人、并希望把协议层、会话层与控制面分开治理的开发者或运维者。当前分支仅支持 macOS;若你从旧版平铺数据迁移,可在停止 Koishi 后使用项目提供的迁移脚本一次性导入数据库。

使用场景

  • 在 Mac 上通过 DSH 统一安装并启停 NapCat 与 Koishi,完成 QQ 扫码登录与 OneBot 对接。
  • 需要集中管理 AI 网关、人设画像与配置控制面,而不自己拼协议与权限逻辑。
  • 希望用模块化控制面板维护 QQ 机器人,而不是维护单文件巨型前端。

适合人员

  • 已在 DeepSeek Harness 中使用插件、需要在 macOS 上接 QQ 的用户。
  • 熟悉或计划使用 Koishi 做会话、权限与指令的 QQ 机器人开发者。
  • 重视 NapCat/Koishi/DSH 分层、希望由 DSH 统筹运行时的人。