dsh-remote-x
Remote X
DeepSeek Harness 移动端适配插件(dsh-remote-x):向网页端注入移动端覆盖层,手机复用网页端全部功能,另附局域网反向代理 CLI
插件会安装到这里;不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Mlte0907/dsh-remote-x#37bcd808935d1acf142cbef3297c041dc0b3755e


dsh-remote-x
DeepSeek Harness 移动端适配插件(dsh-remote-x):向网页端注入移动端覆盖层,手机复用网页端全部功能,另附局域网反向代理 CLI
插件会安装到这里;不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Mlte0907/dsh-remote-x#37bcd808935d1acf142cbef3297c041dc0b3755e


Remote X 以 dsh-remote-x 发布,当前版本为 0.2.9。Plugin Hub 会校验它的 manifest,并保存精确安装来源,便于复现安装结果。
DeepSeek Harness 的 Cordis 插件,两部分能力:
桌面端(≥768px)零影响:全部覆盖规则在窄屏媒体查询内,宽屏看不到任何移动端部件。
移动端任务仪表盘(iPhone 14 视口 390×844,浅色 / 深色主题自动跟随):
| 任务仪表盘(浅色) | 任务仪表盘(深色) |
|---|---|
| 移动端任务仪表盘-浅色 | 移动端任务仪表盘-深色 |
工作区分组卡片(名称 / 本地徽标 / 路径 / 更新于 / 任务数)、任务行的运行状态圆点与
「进行中 / 新会话 / 已完成」徽标,都来自宿主 sessions / workspaces 服务的实时数据。
会话视图 —— DSH 会话主体全屏呈现,顶部是插件注入的返回栏:
| 会话视图(顶部返回栏) | 设置页「远程控制」标签 |
|---|---|
| 移动端会话视图 | 设置页远程控制 |
截图为插件在真实 DSH 宿主(127.0.0.1:3080)中渲染的结果,未使用模拟数据:
#rm-x-dashboard/.rmx-card/.rmx-task/#rm-x-backbar均由插件客户端模块注入生成,任务与工作区数据来自 宿主sessions/workspaces服务。设置页截图中的访问二维码与accessKey片段已做打码处理。
| 能力 | 说明 |
|---|---|
| 扫码接入 | 局域网地址实时渲染为二维码,手机相机直扫 |
| 局域网访问 | 一键开关反向代理(默认端口 3081),自动探测本机所有局域网 IP,多 IP 可切换 |
| 公网访问 | cloudflared 隧道一键开关,公网 URL 即时显示,并渲染公网二维码——人在外面扫码即用,无需同一局域网 |
| 复制链接 | 局域网 / 公网地址一键复制 |
| 主题 | 全部配色走 DSH 设计令牌(--dsw-alias-*),深浅主题自动跟随 |
| 能力 | 说明 |
|---|---|
| 任务仪表盘 | 按工作区分组的任务卡片(工作区名 / 路径 / 任务数 / 最近活跃),运行中绿点脉冲、「进行中 / 新会话 / 已完成」徽标 |
| 任务操作 | 点击进入会话;长按任务行弹出菜单(打开 / 删除);分组折叠展开;单列 / 分组视图切换;全部折叠 / 展开;手动刷新 |
| 会话视图 | 顶部返回栏(一键返回任务列表,配色随主题);DSH 会话主体全屏呈现,底部安全区适配 |
| 误触防护 | 屏蔽浏览器边缘滑动历史导航(左右滑不会莫名退回上一页) |
| 实时同步 | 订阅 sessions / workspaces 服务,任务状态变化自动刷新;浏览器刷新后保持当前视图(sessionStorage) |
| 主题同步 | MutationObserver 监听 DSH 主题属性,深浅切换即时跟随(返回栏 / 仪表盘 / 长按菜单全量) |
| 升级容错 | 会话字段 / DSH 组件类名漂移时按候选顺序回退探测;数据未就绪显示加载态而非假空白——永不白屏 |
dsh-remote-x/
├── src/index.ts # 宿主插件:mobile CSS 注入(webserver/index-inject) +
│ # qr-info / qrcode / lan-toggle / public-toggle API +
│ # 局域网反向代理(3081) + cloudflared 隧道管理
├── inject/mobile.css # 移动端纯 CSS 覆盖层(body class 模型,宽屏零影响)
├── dist/client.js # 客户端模块:设置页 section + 移动层
│ # (sessions/workspaces 订阅驱动,手写无构建依赖)
└── dist/index.mjs # 宿主构建产物(tsdown)
sessions / workspaces / slots / modules。[class*="_frame"] 等,语义后缀全页唯一)
与兼容层(pick() 多字段回退),宿主升级时优先降级而非白屏。dsh plugin --profile web add ./dsh-remote-x
安装后重启宿主即可;手机与电脑同一局域网时,用设置页二维码扫码访问。
| 字段 | 默认 | 说明 |
|---|---|---|
breakpoint | 768 | 移动端布局判定宽度(px) |
proxyPort | 3081 | 局域网反向代理端口 |
title | 远程控制 | 设置页标签标题 |
accessKey | 无 | 公网/局域网链接使用 /k/<key>/ 形式,免去 token 轮换 |
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /dsh-remote-x/api/qr-info | 入口地址、局域网 IP 列表、LAN/公网开关状态、token 检测 |
| GET | /dsh-remote-x/api/qrcode?text= | 自渲染 QR SVG(纯矩阵核心,无图片依赖) |
| POST | /dsh-remote-x/api/lan-toggle | 局域网代理开关 |
| POST | /dsh-remote-x/api/public-toggle | cloudflared 公网隧道开关(返回公网 URL) |
127.0.0.1 绑定不变;对手机暴露的只有 3081 代理与隧道出口。x-remote-nonce(页面注入的一次性值);代理入口可选 accessKey。MIT