@dsh-external/dsh-qq-remote
通过 QQ 消息(OneBot 11)远程控制 DeepSeek Harness 的免 npm 依赖插件
AI 分析
支持通过 QQ 机器人执行命令、派发任务、接收进度汇报及截图。适合需要通过移动端 QQ 随时随地远程调度和监控 DSH 任务的用户。
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ASAKAFENG/dsh-qq-remote說明文件
閱讀完整 README ↗安装与配置
一键安装(推荐,开源用户)
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 生效。
手动安装
- 构建:
bash scripts/build.sh(纯 JS,无编译依赖) - 注入:DSH 侧
dev_inject_plugin(或 loader 装配),插件名@dsh-external/dsh-qq-remote - 运行任一 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/chatMaxChars为0表示上下文无限制(全量发送);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 用例保持全过