ASAKAFENG/dsh-qq-remote1

@dsh-external/dsh-qq-remote

通过 QQ 消息(OneBot 11)远程控制 DeepSeek Harness 的免 npm 依赖插件

AI 分析

支持通过 QQ 机器人执行命令、派发任务、接收进度汇报及截图。适合需要通过移动端 QQ 随时随地远程调度和监控 DSH 任务的用户。

套件
@dsh-external/dsh-qq-remote
版本
1.0.0
授權
MIT
最近更新
2026年8月16日

安裝

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

安装与配置

一键安装(推荐,开源用户)

git clone https://github.com/ASAKAFENG/dsh-qq-remote
cd dsh-qq-remote
bash scripts/install.sh

自动完成:构建 → 安装到 DSH profile → 注册 loader 条目 → 生成配置模板(~/.dsh/qq-remote.json),重启 DSH 生效。

手动安装

  1. 构建:bash scripts/build.sh(纯 JS,无编译依赖)
  2. 注入:DSH 侧 dev_inject_plugin(或 loader 装配),插件名 @dsh-external/dsh-qq-remote
  3. 运行任一 OneBot 11 实现(如 NapCat),开启反向 WebSocket(默认 ws://127.0.0.1:3001/ws), 路径与插件 wsUrl 保持一致;配置了 token 时 WS 走 ?access_token=、HTTP 走 Authorization: Bearer

配置有两种方式:插件 Config(loader 注入时传入)或覆盖层文件 ~/.dsh/qq-remote.json (免改代码、即时生效,热重载后应用):

{
  "wsUrl": "ws://127.0.0.1:3001/ws",
  "allowedUsers": [123456789],
  "groupPrefix": "/",
  "privatePlainAsTask": true,
  "autoReport": true,
  "reportMode": "phase",
  "chatSystemPrompt": "你是用户通过 QQ 联系的一位聊天伙伴。回复要像真人 QQ 聊天一样:简短自然、口语化、有来有回,不要使用列表/表格/标题等正式格式,不要提及你是 AI、模型或助手。",
  "chatHistoryLimit": 0,
  "chatMaxChars": 0,
  "chatSessionNames": []
}

说明:chatSystemPrompt 是聊天模式的人设提示词,默认只约束"像真人聊天"的回复格式,可自由替换成任何角色(如 AI 女友、助理、猫娘…); chatHistoryLimit / chatMaxChars0 表示上下文无限制(全量发送); chatSessionNames/chatbind 命令自动维护,一般无需手改。

完整配置项见 USAGE.md(含 reportMode/phaseIntervalMs/chatSessionNames 等全部字段)。

v0.3.6(2026-08-16)—— 设置面板可配置 NapCat 下载源

  • ⬇️ 下载源可选项:设置页「QQ 远程」面板新增「NapCat 下载源」—— 官方 GitHub / gh-proxy.com 镜像 / ghfast.top 镜像 / 自定义地址,一键切换并保存(写入 ~/.dsh/qq-remote.json 即时生效)
  • 🔧 后端 GET/POST /qq-remote/napcat/settings:镜像列表单一事实源,支持自定义 URL 校验(http/https/file)
  • 🧪 e2e 21 用例保持全过