DeepSeek Harness (DSH) 旨在通过插件扩展智能体的能力。在移动端管理智能体或处理即时任务时,直接操作网页端或命令行往往不够便捷。dsh-mobile-remote 插件将手机微信转化为控制台,让你在任意网络环境下通过微信指令控制本地运行的 DSH Agent。
插件简介¶
该插件名为 dsh-mobile-remote,由开发者 good-boy4069 维护。它基于腾讯 iLink SDK 协议,实现了 DSH Agent 的远程微信控制。其核心价值在于利用长轮询机制实现全出站通信,且不依赖第三方微信 API,能在任意网络(如 4G、WiFi)下运行。
核心功能¶
- 双向文件传输:支持下载和发送文件,并能自动解密图片与视频。
- 主动通知:提供
weixin_send工具,支持发送文本与文件;支持在任务完成时发送通知。 - 多会话远程控制:支持列出会话、切换会话。
- 协议对齐:严格遵循腾讯 iLink SDK v2.4.6 的协议细节。
- 可观测性:提供
/health健康端点和状态栏,显示运行状态。 - 登录方式:支持二维码登录。
- 权限控制:提供全权限模式,边界由白名单决定。
安装与启用¶
使用以下命令将插件安装到 web 配置文件中:
npx @deepseek-ai/dsh plugin --profile web add dsh-mobile-remote
安装完成后,启动或重启 dsh web 服务:
dsh web
典型用法¶
- 登录:在浏览器打开
http://127.0.0.1:3080/mobile-remote-weixin/login(需在当前机器上),扫描二维码绑定微信。 - 指令操作:登录后,可通过微信发送以下指令:
- 查看状态与工作区:
/status,/workspace - 管理会话:
/new(解绑当前),/sessions(列出),/switch <number-or-title>(切换) - 控制任务:
/stop(停止),/reply <text>(继续回复) - 文件操作:
/ls [path](列出目录),/send <file-path>(发送文件)
- 查看状态与工作区:
- 文件发送:在模型的回复中插入
[[send-file:path]],即可触发文件发送。
注意事项¶
- 消息传输:消息需通过腾讯 iLink 服务器中转(微信本身无第三方 API),因此非端到端加密。
- 语音消息:语音消息会被拒绝处理,不会存储或转录。
- 权限边界:全权限模式下,边界仅由白名单决定,请仅添加自己的微信账号。
- 登录限制:登录页面仅限回环地址访问。
- 日志文件:插件提供
gateway.log日志文件,支持 1MB 轮转。 - 健康检查:
/health端点仅允许列出字段,不会泄露内部标识符。
结尾¶
该插件为 DSH 提供了移动端控制的便捷入口。通过微信即可在任意网络环境下管理智能体任务与文件。更多细节可查阅 GitHub 仓库。