🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

手机遥控台 Autumn984/dsh-remote

DeepSeek 客户端v0.8.44
Autumn98423 天前有提交已提供中文文档扫描:含敏感能力兼容 / 相关生态

扫码用手机查看会话并远程指挥智能体

30.7/100
综合分
1
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/10/12 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

相关生态插件(非 dsh 原生,按其对应运行时安装)
git clone https://github.com/Autumn984/dsh-remote.git

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
生态插件
可安装,未声明 dsh 能力
装得上吗
本站已在 dsh 0.2.1-rc.5 下真实安装成功
非静态推断
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 23 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查⚠ 装前注意

npm 同名包「dsh-remote」归属 flymysql/dsh-remote,装到的可能不是本插件

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-remote @ 0.8.44
✓Node 引擎要求 >=22.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/13 09:39:04

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件
查看扫描证据(共 10 处,展示前 10 条)
  • 写入本地文件
    src/api.js:25
    mkdirSync(UPLOAD_DIR, { recursive: true })
  • 写入本地文件
    src/api.js:39
    writeFileSync(path, bytes)
  • 写入本地文件
    src/plugin.js:68
    appendFileSync(join(homedir(), '.dsh', 'dsh-remote-error.log'), `[${new Date().toISOString()}] ${detail}\n\n`)
  • 读取本地文件
    src/plugin.js:109
    if (existsSync(userPath)) return userPath
  • 读取本地文件
    src/plugin.js:112
    if (process.platform === 'win32' && existsSync(bundled)) return bundled
  • 读取本地文件
    src/plugin.js:127
    if (!existsSync(exe)) {
  • 执行外部命令来自配置/变量
    src/plugin.js:135
    const proc = spawn(exe, ['tunnel', '--url', `http://127.0.0.1:${cfg.port}`, '--no-autoupdate'], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true
  • 执行外部命令来自配置/变量
    src/plugin.js:196
    const proc = spawn(process.execPath, [cli, 'config', 'set', 'gemini-api.apiKey', key], { stdio: 'ignore', windowsHide: true })
  • 读取本地文件
    src/server.js:73
    if (!qrLibCache) qrLibCache = readFile(join(STATIC, 'qrcode.min.js'), 'utf8').catch(() => '')
  • 读取本地文件
    src/server.js:347
    const html = await readFile(join(STATIC, 'mobile.html'), 'utf8')
扫描于 2026/11/4(0 天前) · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • 扫码连接手机
  • 远程查看会话
  • 远程指挥智能体

DeepSeek Harness 手机远程控制插件:扫码即用,局域网 / IPv6 / Cloudflare 隧道三通道,令牌鉴权

README

由 DeepSeek 最新模型翻译生成
dsh-remote 🐋 DeepSeek Harness 手机远程控制插件:扫一下二维码,用手机指挥你的智能体。 局域网 / IPv6 / Cloudflare 隧道三通道,令牌鉴权,Windows 开箱即用。 A remote-control plugin for DeepSeek Harness — scan a QR code and drive your agent from your phone. English · 使用文档 · 注意事项 · 更新日志 ✨ 功能 - 📋 会话总览:手机查看全部会话与实时运行状态(含子智能体标记) - 💬 对话阅读:Markdown / 表格 / 代码块渲染,色彩突出重点;历史消息分页加载 - ✉️ 远程指挥:给任意会话发消息(忙时自动排队)、停止任务、新建会话 - 📎 图片与文件:手机上传,图片自动转 JPEG 压缩;智能体经视觉工具(modlens)读图 - 🌐 三通道连接:局域网直连(首选)· Cloudflare 外网隧道(HTTPS,任何网络可用)· IPv6 直连(备用) - 🔐 安全内置:令牌鉴权、配对页仅限本机、隧道来源隔离 🌟 特色 | 特色 | 说明 | | 📱 手机零安装 | 只需浏览器(iOS Safari 即可),无需 App、无需公网 IP、无需升级系统 |
展开完整文档(README 剩余 1 节)
dsh-remote 🐋

DeepSeek Harness 手机远程控制插件:扫一下二维码,用手机指挥你的智能体。
局域网 / IPv6 / Cloudflare 隧道三通道,令牌鉴权,Windows 开箱即用。

A remote-control plugin for DeepSeek Harness — scan a QR code and drive your agent from your phone.

English · 使用文档 · 注意事项 · 更新日志

✨ 功能

- 📋 会话总览:手机查看全部会话与实时运行状态(含子智能体标记)
- 💬 对话阅读:Markdown / 表格 / 代码块渲染,色彩突出重点;历史消息分页加载
- ✉️ 远程指挥:给任意会话发消息(忙时自动排队)、停止任务、新建会话
- 📎 图片与文件:手机上传,图片自动转 JPEG 压缩;智能体经视觉工具(modlens)读图
- 🌐 三通道连接:局域网直连(首选)· Cloudflare 外网隧道(HTTPS,任何网络可用)· IPv6 直连(备用)
- 🔐 安全内置:令牌鉴权、配对页仅限本机、隧道来源隔离

🌟 特色

| 特色 | 说明 |
| 📱 手机零安装 | 只需浏览器(iOS Safari 即可),无需 App、无需公网 IP、无需升级系统 |
| 🧰 一体化配对页 | 二维码、隧道一键开关(实时日志 + 超时诊断)、视觉 Key 填写、令牌旋转——全在一个页面,不依赖插件设置页 |
| 🚀 Windows 开箱即用 | 安装包内置 cloudflared(52MB → 压缩后 18MB),打开隧道开关即可用,无需下载任何东西 |
| 🖼 纯文本模型也能看图 | 图片由智能体调用视觉工具读成文字证据;视觉 Key 在配对页粘贴即自动配置 |
| 🛡 防御式设计 | 服务惰性获取(开机时序安全)、错误落盘、老浏览器兼容、虚拟网卡过滤 |

📦 安装

tgz 安装(推荐)

从 Releases 下载 dsh-remote-1.2.0.tgz,或自行打包:
pnpm pack
桌面端 profile
dsh plugin --profile desktop add "D:\path\to\dsh-remote-1.2.0.tgz"
WebUI profile
npx -y @deepseek-ai/dsh plugin --profile web add "D:\path\to\dsh-remote-1.2.0.tgz"

重启 DeepSeek Harness 后,电脑打开 http://127.0.0.1:4666/,手机扫码即可。

源码安装

git clone <仓库地址> && cd dsh-remote
pnpm install && pnpm pack # 注意:仓库不含 cloudflared 二进制,见下方说明

⚙️ 配置后即可使用

| 配置项 | 默认值 | 说明 |
| enabled | true | 总开关 |
| port | 4666 | HTTP 服务端口 |
| bind | lan | lan = 0.0.0.0(手机可访问);loopback = 仅本机 |
| token | 留空自动生成 | 访问令牌,内嵌在二维码链接中 |
| tunnel | false | Cloudflare 快速隧道(也可在配对页一键开启)|
| cloudflaredPath | 空 | 自定义 cloudflared 路径 |
| visionKey | 空 | 图片识别 Gemini Key(配对页填写,自动写入 modlens 配置)|

隧道程序:tgz / Release 已内置 Windows 版 cloudflared;源码仓库不含二进制(体积大),源码安装用户请从 Cloudflare 官方 下载放到 ~/.dsh/bin/。
图片识别:需安装 modlens 视觉插件。

🧭 工作原理

┌──────────┐ QR(含令牌) ┌────────────────────────────┐ │ 手机浏览器 │ ────────────────► │ dsh-remote 插件(DSH Host 内)│ └──────────┘ http/https │ · 自带 HTTP 服务(默认 4666) │ ▲ │ · 令牌鉴权 / 配对页本机隔离 │ │ │ · 惰性调用 DSH sessionController│ └── 三通道 ◄────────────────┴────────────────────────────┘ 局域网 IP / IPv6 直连 / Cloudflare 隧道(HTTPS,任何网络)

⚠️ 已知问题(尚待修复)

| # | 问题 | 影响与规避 |
| 1 | 部分网络无法建立 Cloudflare 快速隧道(运营商拦截 UDP 7844 等)| 隧道卡住时配对页有日志与超时诊断;可改用局域网 / 自行搭建固定隧道 |
| 2 | 快速隧道域名随机,重连后变化 | 出门前刷新一次二维码;永久固定需自建命名隧道 + 域名 |
| 3 | 手机端不支持应答「审批 / 提问确认」| 智能体等待确认时需回电脑操作(下版本规划)|
| 4 | 无推送通知 | iPhone 锁屏后轮询暂停,解锁即恢复(下版本规划)|
| 5 | 局域网通道为明文 HTTP | 同一 Wi-Fi 内理论上可被嗅探;敏感场景请用隧道或 loopback + 隧道 组合 |
| 6 | 上传目录不自动清理 | 手动清理 ~/.dsh/dsh-remote-uploads/ |
| 7 | DSH 插件设置页的配置卡片在部分环境不渲染 | 已把关键配置全部搬到配对页;设置页渲染为后续优化 |
| 8 | macOS / Linux 未实测 | 移动页与核心逻辑跨平台;cloudflared 需自行下载对应版本 |

📌 注意事项

- 令牌 = 遥控钥匙:拿到令牌即可控制 DSH,请勿外传;配对页与令牌旋转仅限本机访问,隧道来源被强制隔离
- 防火墙:首次使用放行 node 入站(专用 + 公用都勾;手机热点通常算公用网络)
- 代理共存:系统代理模式无影响;TUN 模式请将 *.trycloudflare.com 等设为 DIRECT
- iPhone:同一时间只能运行一个 VPN;iOS 18 的 Safari「不安全连接警告」会拦 http 链接(设置 → App → Safari 关闭,或直接用隧道码);微信扫码限制 http 外链,用系统相机扫
- 隐私:图片会发送给你配置的视觉引擎服务商;Key 只存本机(~/.modlens/config.json,0600)
- 完整说明见 docs/NOTES.zh-CN.md

🗂 目录结构

├── src/ # 插件源码(index/plugin/server/api/settings-scope + 静态页面) ├── tools/gen-qr.mjs # 离线二维码生成器(可选工具) ├── docs/ # 使用文档与注意事项 ├── cordis.patch.yml # 插件行插入补丁 └── CHANGELOG.md # 更新日志

常见问题速查

| 现象 | 处理 |
| 手机提示「仅 HTTPS」| 关闭 Safari「不安全连接警告」,或扫隧道码 |
| 页面空白 | 检查地址栏是否被改成 https://(删 s 重试 / 换 Chrome)|
| 只有局域网和 IPv6 码 | 点配对页「开启外网隧道」;看状态与日志 |
| 发图 Agent 读不懂 | 安装 modlens 并在配对页填视觉 Key |
| 只能看到部分消息 | 会话顶部点「↑ 加载更早的消息」|

许可

MIT。内置组件:qrcode-generator(MIT)· cloudflared(Apache-2.0,仅随 tgz/Release 分发)。
预览分享卡片长什么样 ↓Autumn984/dsh-remote
分享 · DeepSeek Harness Hub
Autumn984/dsh-remote

扫码用手机查看会话并远程指挥智能体

这是你的仓库?认领条目

回到顶部