dsh-xiaoyu-qqbot
QQ BOT control console for DeepSeek Harness (DSH): one-click deploy/start/stop for NapCat + AstrBot + GPT-SoVITS, live login QR, voice, stickers, persona editor, rate limits and logs — all inside one DSH desktop panel.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add https://github.com/ZOTTALL/dsh-xiaoyu-qqbot/releases/download/v1.1.2/dsh-xiaoyu-qqbot-1.1.2.tgz说明文档
阅读完整 README ↗陌生人好友私聊 / QQ 群聊：额外配置 AstrBot
想使用陌生人加好友对话、好友申请处理或 QQ 群群聊，需要额外配置 AstrBot：OneBot 适配器、触发方式 / 唤醒词、群与用户白名单、模型提供方、群会话隔离、好友申请处理及本项目的可选限额扩展。不要仅安装桥接就向所有人开放 DSH 工具。
- 人格文件可以复用 DSH 中的内容：把自己确认需要的
AGENTS.md规则复制 / 整理为 AstrBot 人格；仅设置同一份文件不会让普通 AstrBot 聊天自动获得 DSH 的工具或权限。可通过设置工作区复用自己已有的人格文件；模板初始化不会覆盖它们。 - 模型密钥可以复用自己的可用 DSH API 密钥：经
/dsh桥接的请求直接使用 DSH 当前模型配置，无需复制密钥；由 AstrBot 独立回复的陌生人 / 群聊，则在 AstrBot 模型提供方中自行填写相应 API 地址与密钥。DSH 登录态 / 临时 OAuth 令牌与普通模型 API key 不能混用。插件不会读取、展示或自动复制你的 DSH 凭据。
详细说明：部署 · 配置 · 桥接联动 · 陌生人 / 群聊 · 记忆架构。
使用自己的 QQBOT_CONFIG；只补缺失模板，不覆盖已有内容
npm run init:workspace
## 开发与验证
```powershell
npm run check
npm test
npm run privacy
node tools/create-demo.mjs C:/path/to/empty-demo
# 将上条输出的配置路径设为 QQBOT_CONFIG，再启动本机只读预览
node tools/preview.mjs 8799
真实语义集成测试需要额外提供 QQBOT_MEMORY_PYTHON、QQBOT_MEMORY_MODEL、QQBOT_MEMORY_RERANKER，再运行 npm run test:semantic；未配置时明确跳过，不把文本检索冒充向量测试。完整原理、资源与边界见 MEMORY.md。本次实测记录见 1.1.2 验证记录。问题报告不要附真实配置 / 聊天 / 密钥，见 SECURITY。
致谢
DeepSeek Harness · NapCat · AstrBot · GPT-SoVITS · DSH 桥 · DSH ingress · BGE。