移动远程控制套件:原生侧边栏入口 + 管理抽屉的 bundle 插件,自带 Bearer 令牌网关自愈(局域网/Tailscale);Android App 覆盖会话/审批/提问/goal;/fs/* 文件端点(Range 断点续传、2GB 上传);多服务器测速自动切换;聊天记录离线缓存。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-remote-plugin
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Blank-not-black/dsh-Remote#path:/packages/plugin
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DSH Remote 的 DSH bundle 插件:提供「更多 → 手机连接」入口、浏览器管理控制台及受用户启停意图约束的内置网关。
中文 · English
操作与排障知识库按任务、症状和错误码导航;用户 AI 可从仓库根 llms.txt 开始。包内离线副本位于 skills/dsh-remote-doctor/references/wiki/,内置 Doctor 按需读取并引用 KB 编号。
安装与连接
dsh plugin --profile web add dsh-remote-plugin@latest
dsh plugin --profile web list --depth 0
示例针对 Web profile;自定义 profile 使用实际名称。DSH Desktop 从自身插件管理入口安装,完整退出并重开。Web 安装完成后完整重启 DSH Web,Ctrl+F5,从左侧导航「更多 → 手机连接(DSH Remote)」进入浏览器配对页。首次加载会提示入口位置;选择「开始连接」或「稍后」后不再重复提示。旧宿主缺少该菜单扩展点时,入口保留在左下角。
在主机访问 http://127.0.0.1:8787/health,然后在插件连接向导或管理控制台显示连接二维码。手机通过「更多 → 主机与连接 → 扫码连接」配对;APK 下载码只用于安装。手动连接填 http://电脑局域网IP:8787 与令牌,不能填手机 localhost。固定版本使用 @<已发布版本>,@next 与 @latest 的指向需另行查询。
当前能力与限制
- 快速状态、完整管理控制台、Doctor、自启/自愈与明确停止意图。
- Bearer token、可选独立设备密钥、短时 WS ticket。
- mux/host 下行、独立长轮询、弱网设置与历史缓存。
- 文件多根、分块续传、校验、预览/下载与图片附件。
- 当前主机插件管理与可选上下文/费用洞察。
- 手机导航:会话、文件、更多;十二套 Web 主题(含孤独摇滚四人、企鹅女管·白昼/极夜角色皮肤),默认蓝色大肥鱼,保留已有主题选择。
- 手机端八步新手引导;完成或整体跳过后移除首页入口,在「更多 → 偏好与维护 → 新手引导」重新学习。
- rc.9 补充冷会话恢复与错误归属修复、发送结果诊断、文件上传与分支恢复验证;具体范围见候选版说明。
- Android APK 在已有构建产物时随包分发,通知与后台需设备权限。
- Windows Desktop 控制是实验能力,需可信实例证据;管理页可选网关登录自启,默认关闭,不注册系统服务。
- HarmonyOS 为独立源码工程,当前 release CI 不构建 HAP;会话洞察和 Web GenUI 未移植。
- Android ASR 桥和空功能测试页入口已移除;通知测试位于高级通知选项。
- macOS 可通过插件使用同一网关源码;主发布 CI 已配置 Apple Silicon 独立网关构建、ad-hoc 签名和启动冒烟,未做 Apple 公证。
配置与排查
插件端口优先级:DSH_REMOTE_GATEWAY_PORT → ~/.dsh-remote/gateway-port → 8787。监听地址优先级:DSH_REMOTE_GATEWAY_HOST → HOST → gateway-host 文件 → 0.0.0.0。插件从当前 DSH 实例传入上游。
令牌默认 ~/.dsh-remote/token;DSH_REMOTE_AUTOSTART=0 禁用自动管理。文件授权、工作区及 Windows 默认根存在边界,详见完整配置参考。
本机拒绝连接先检查实际 profile、完整重启与端口;上游 degraded 检查 DSH;手机不可达检查网络和防火墙;401 重新配对;升级界面旧先强刷。插件内嵌管理页使用 DSH 登录边界,独立管理页使用 Remote 主令牌。不要把 transient 网关当成固定可 restart 的 systemd 服务。
配对二维码包含凭证,不公开;跨网络优先 Tailscale。主令牌、设备令牌与 DSH 上游 Cookie 不混用。
文档
说明按仓库 0.8.0-rc.9(2026-10-22)核对,不代表当前 npm 标签、设备实装、公开附件或所有平台验收结果。
License
MIT
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-remote-web-ui★ 10461
手机/PC 远程操控 dsh web 工作区:扫码配对、令牌门控通道、SSE 实时同步,提供移动端与完整桌面 GUI 两种远程形态。
zhu1090093659/dsh-web#packages/dsh-ssh★ 10461
SSH 远程运维面板:Web 终端、SFTP 传输、本地端口转发与一条命令并发集群执行,Agent 与面板共用同一份主机配置。
liguobao/ds-harness-remote★ 3094
通过端到端加密通道远程访问 DeepSeek Harness 及兼容的编码工作区,支持自适应 Relay/WebRTC 传输、设备授权、工作区文件、只读预览、终端和可选的 Codex Remote。
saya-ch/dsh-mobile★ 870
通过 Android App 或手机浏览器访问 DeepSeek Harness,支持安全局域网连接、远程访问、持久设备配对和可自定义移动界面。
uumit-ai/dsh-uumit-remote★ 523
用 UUMit 账号在手机或其他电脑上打开这台电脑的 dsh web,不用自建服务器、不装其他程序:插件内置通道客户端连接 UUMit 托管的通道,侧栏里的面板负责配对和选择谁能用(仅自己、通过邀请链接或手机号授权的人、所有人),可随时撤销。需 dsh web 且 DSH >=0.2.1-rc.2。
ZSeven-W/dsh-ios★ 468
在对话里直接操作 iOS 模拟器或 USB 连接的 iPhone:22 个 Agent 工具用于启动、构建、按无障碍标识或 OCR 文本驱动 UI、列表行操作与 SwiftUI 预览热重载,并附带可点击拖拽的流式侧边栏面板。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。