dsh-mobile-plugin
DeepSeek Harness 移动端插件:手机远程操控宿主,提供受限移动 API、中转隧道与局域网配对(可作无头宿主运行)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 15 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/WNLUO/dsh-mobile-plugin with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/WNLUO/dsh-mobile-plugin'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/wnluo--dsh-mobile-plugin)HTML
<a href="/listings/wnluo--dsh-mobile-plugin"><img src="/api/listings/wnluo--dsh-mobile-plugin/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 170 lines
- <h3 align="center">AI-HUB 移动端插件</h3>
- 
- <p align="center">
- <a href="https://app.wnluo.com/api/public/apps/14/download-latest"><img alt="安卓 分发下载" src="https://img.shields.io/badge/%E5%AE%89%E5%8D%93-%E5%88%86%E5%8F%91%E4%B8%8B%E8%BD%BD-3DDC84?style=for-the-badge&logo=android&logoColor=white"></a>
- <a href="https://github.com/WNLUO/dsh-mobile-plugin/releases/latest/download/ai-hub-android.apk"><img alt="安卓 GitHub 下载" src="https://img.shields.io/badge/%E5%AE%89%E5%8D%93-GitHub%E4%B8%8B%E8%BD%BD-181717?style=for-the-badge&logo=github"></a>
- <a href="https://apps.apple.com/us/app/ai-hub/id6821681438"><img alt="App Store" src="https://img.shields.io/badge/App_Store-%E4%B8%8B%E8%BD%BD-black?style=for-the-badge&logo=appstore&logoColor=white"></a>
- <a href="https://testflight.apple.com/join/4fn5PCMD"><img alt="苹果测试版 下载" src="https://img.shields.io/badge/%E8%8B%B9%E6%9E%9C%E6%B5%8B%E8%AF%95%E7%89%88-%E4%B8%8B%E8%BD%BD-0D96F6?style=for-the-badge&logo=apple&logoColor=white"></a>
- </p>
- <p align="center">
- <a href="https://www.npmjs.com/package/dsh-mobile-plugin"><img alt="npm" src="https://img.shields.io/npm/v/dsh-mobile-plugin?style=flat-square"></a>
- <img alt="license" src="https://img.shields.io/badge/license-MIT-blue?style=flat-square">
- <img alt="platform" src="https://img.shields.io/badge/platform-iOS%20%7C%20Android-999999?style=flat-square">
- <a href="EN-README.md"><img alt="English" src="https://img.shields.io/badge/README-English-2f81f7?style=flat-square"></a>
- </p>
- <p align="center">电脑上开着的 DeepSeek Harness,手机上接着用。</p>
- **AI-HUB 的手机端插件。** 装在电脑这边,手机 App 就通过一条中转隧道或局域网配对连进你的 DeepSeek Harness —— 看会话、接着聊、管理文件和工作区,进度实时同步。
- 它和绝大多数 DSH 插件不一样的一点:**不需要桌面外壳,也不需要 Electron**。同一份包可以单独跑在没有图形界面的服务器上,当作无头宿主用 —— 手机连的是一台根本没有屏幕的机器。
- 
- 手机连的是**你自己那台电脑上的 DeepSeek Harness**,不是某个云端服务。电脑不用公网 IP,也不用在路由器上开端口:插件从内网主动往外建一条隧道,手机沿这条路回来。
- ## 功能
- ### 会话与工作区
- - 新建、接着聊、改名、搜索会话,也能从任意一条分出分支单独往下走。
- - 工作区建、改名、删除、置顶、归档都在手机上完成,手机端排的顺序会同步回电脑。
- - 回复逐块流式到达,跑到一半就能看见内容,工具调用也是实时的。
- - 手机上读过,电脑那边的未读绿点跟着消失;电脑侧边栏的展开、折叠状态同步到手机,两边结构一样。
- ### 不用回电脑也能操作
- - **审批与提问**:电脑上会弹的卡手机同样有,权限请求、选择题、多选、自定义回答都能直接点。
- - **排队插话**:正在跑的时候补一句,按队列排在当前这一步之后。
- - **Git**:看状态和 diff、暂存、提交、推送、切分支,提交信息可以先让模型写。
- - **文件**:浏览目录、读文件,也能把手机上的文件传回电脑,落在固定的收件目录。
- - **插件**:手机上的插件市场里搜索、安装、更新、卸载;插件自己也能升级到新版。
- - **模型**:随时换模型,看有哪些渠道和可用模型,本机自建的渠道也能直接在手机上配。
- - **日程与子代理**:定时任务能看、新建、改、暂停恢复、立刻跑一次、删掉;看正在跑的子代理,打断它或者补一句话。
- ### 远程电脑
- 在家里的 A 电脑打开插件控制台的「远程电脑」,生成并复制绑定信息,再到随身的 B 电脑粘贴添加。绑定信息十分钟内有效、只能使用一次;两台电脑都需要安装支持远程电脑的插件。
- 绑定后在 B 点击「在桌面端打开」,即可通过本机地址使用 A 的完整 DSH 网页,不需要域名或手机参与。默认自动选择局域网、直连、IPv6、中转或可用隧道;网络变化后重新选路,正常的实时连接不会因细小测速差异被打断。完整网页授权具有远程操作该 DSH 的能力,只向自己信任的电脑发放。
- 点击后优先由插件随包分发的桌面显示壳开窗口,而不是交给系统默认浏览器。它不是给最终用户双击安装的独立应用,也不做安装器:按平台作为插件的可选依赖 `dsh-mobile-shell-<os>-<cpu>` 一起装,插件把一次性地址和可选的设备名作为命令行参数交给它。一次点击启动一个进程、开一个窗口,窗口标题带设备名;同一台 B 电脑可以同时开多台 A 电脑的窗口,互不干扰。平台包的版本独立于插件,壳没改就不抬版本,插件更新不会重下它;机器上没装对应平台包时自动回退到原来的系统浏览器路径,远程电脑功能照常可用。
- 每次网页访问允许一小时,临近到期会提示;在 B 的插件控制台主动续期才能继续,到期后须重新打开,绑定关系保留。停止访问、插件退出或 A 撤销授权会断开网页连接,不停止 A 上已经运行的任务。A 可在「可访问本机的电脑」中撤销 B;B 可移除自己保存的绑定。
- 网页字节在两端插件之间加密,线路只转发密文;长期绑定凭据由宿主凭据存储保存,浏览器只持有本次访问的临时会话。默认只监听本机回环,不把浏览器入口开放给局域网。
- ### 连接
- - 两种连法:经 relay v2 隧道从公网连回来,或者同一个 Wi-Fi 下走局域网直连。
- - 配对码与配对策略可选,设备凭据能单独吊销,也能一次把全部撤掉。
- - iOS 离线推送可选,不配也不影响其它功能。
- 移动 API 只开手机需要的口子(`/api/mobile/v1/*`)—— 不暴露 shell、系统设置与任意文件写入。
- ## 安装与更新
- 装好手机 App 只是第一步,插件装在这边才算接通。
- ### 桌面端
- 在 DSH 的 **设置 → 插件** 里搜索并安装 `dsh-mobile-plugin`,然后打开 **设置 → 移动端 → 打开配置页面** 做配对。插件市场负责检查和安装更新,通常更新后不用重启 DSH。
- 装完以后,**入口在 DSH 的「设置 → 移动端」**:点「打开配置页面」,那里有配对二维码、当前监听地址和中转状态。手机上的所有功能都从这一页开始。
- ### 无头 Host(Linux)
- 需要 Node.js、pnpm,以及可用的 DSH 插件宿主依赖。仓库里的 `host.js` 就是独立入口:
- ```sh
- pnpm install --frozen-lockfile
- DSH_HOME=/opt/dsh-mobile/.dsh DSH_MOBILE_PROFILE=mobile node host.js
- ```
- `DSH_HOME` 是数据根目录,默认 `~/.dsh`;`DSH_MOBILE_PROFILE` 是 profile 名称,默认 `mobile`。无头 Host 的 Web 服务默认只监听 `127.0.0.1:3080`,不对局域网直接开放。
- 配置接口只限本机访问,看状态和拿配对信息:
- ```sh
- curl http://127.0.0.1:3080/api/relay/status
- curl http://127.0.0.1:3080/api/relay/pairing
- ```
- ### 无头部署
- 无头服务器上,启动器和插件本体是分开管的:启动器由部署流程同步到 `/opt/dsh-mobile/`,插件本体装进 profile:
- ```sh
- cd <DSH_HOME>/profiles/<profile>
- pnpm add dsh-mobile-plugin@<版本>
- ```
- 宿主优先挂 profile 里装的那份,没装才用源码树版本。设备凭据库随 npm 包一起发,不用单独装。仓库锁文件用 `pnpm install --frozen-lockfile`。
- > 别用 `npm install --legacy-peer-deps` 装插件;正式安装走 DSH 插件市场。
- ## 配置与 API
- 无头运行时用这几个本机接口管远程连接:
- - `POST /api/relay/toggle`:开或关远程控制。
- - `POST /api/relay/regenerate`:重新生成配对码。
- - `POST /api/relay/config`:设置 `relayUrl`、`lanEnabled`、`lanPort`、`name` 和 `pairingPolicy`。
- - `POST /api/relay/reconnect`:重连隧道与局域网代理。
- 移动 API 要 Bearer token。设备事件流 `GET /api/mobile/v1/events/stream` 用 SSE 转发宿主事件。建会话时可以传 `workspaceId` 或 `cwd`,前者优先,并会把会话归进那个工作区;手机端的排序同样会同步到宿主工作区。
- 配对策略默认 `code`,凭配对码放行;设成 `deny` 就拒绝所有新配对。配对请求可以带设备信息,App 会发 `id`、`deviceId`、`name`、`platform`、`osVersion` 和 `appVersion`,局域网代理与中转会补上它们观察到的手机 IP。
- `session_cleanup` 能归档会话,也能永久删除归档过的会话,删除前要显式确认,删掉不可恢复。**删除是排队的**:会话立刻从列表里消失,日志和投影缓存等宿主下次启动才从磁盘上清掉 —— 宿主没有「删除会话」的接口,运行中从它脚底下删文件会带走整个宿主进程。
- ## 为什么做这个
- DeepSeek Harness 跑在电脑上,但我不是一直坐在电脑前。出门、在别的房间、躺床上,想知道刚才那个任务跑到哪一步了,或者它正卡在一个要我点的审批上,只能走回去。
- 这个插件的出发点就这么窄:不是把整个 DSH 塞进手机屏幕,而是让人离开电脑之后,还能看见、还能接着聊、还能把该点的那一下点掉。
- 所以有两条线是硬的。一条是网络:不要求公网 IP、不要在路由器上开端口、不要为了用一次去配 DDNS,插件从内网主动往外出,手机顺着回来。另一条是能力:手机上只开需要的那几个口子,能看会话、能审批、能传文件、能改点配置,但不把 shell 和任意文件写入递到手机上 —— 手机丢了或者被人捡到,损失是可估的。
- ## 和别的方案比
- **用手机浏览器开 DSH 的网页**:不用装东西,但每次都得记住地址,界面按桌面尺寸排,在手机上要靠缩放拖拽;没有推送,离开页面就什么都不知道;审批那种要点准的东西最难用。
- **远程桌面**:本质还是操作那块屏幕,手机只是个显示器。网络断了就是黑屏,小屏上做任何事都要先放大。
- **各家 AI 助手的手机 App**:那些跑在厂商的服务器上,会话、文件和额度都在别人那儿。这里连的是你自己电脑上那个 DSH,模型是你配的,文件在你硬盘上。
- ## 已知限制
- 写在这里的是我们确实还没做到的,不是待办清单的美化版。
- - **iOS 的后台提醒不是随时都准**。系统不允许 App 常驻后台,所以任务完成通知靠 App 进后台那一段轮询加系统择机唤醒——被系统冻结或额度用尽时可能迟到,甚至这一轮收不到。配了离线推送才有稳定的兜底,没配只保证在前台与后台还有额度的时候提醒。
- - **中转能看到明文**。链路是 WSS / HTTPS 加密的,但没有端到端加密,与 frp / ngrok 同一个模型。会话正文在中转上不落盘,但中转进程本身能解密。
- - **中转默认不做隧道鉴权**:能连上中转端口的人就能接走隧道。要在公网上用,请开中转控制台的限制模式,或者只把端口暴露给可信网络。
- - **承载手机连接的那个插件不能在手机上卸**。第三方插件的安装、升级、卸载都能在手机上做,但 `dsh-mobile-plugin` 自己卸掉这台手机就再也连不上了,所以入口不给;另外手机上卸完要等电脑下次启动 DSH 才真的不在。
- ## 交流与反馈
- 
- 扫上面的码进企业微信群。**这个码更新于 2026-11-09,如果扫不出来或者提示已过期**,说明二维码已经换了,发邮件到 <admin@wnluo.com> 索取新的,或者直接提 issue。
- 不方便的话发邮件到 <admin@wnluo.com> 或 <wnluo2@gmail.com>。用着顺手就给仓库点个 star,这是最实在的支持。
- 隐私政策见 [PRIVACY.md](PRIVACY.md),常见问题见 [SUPPORT.md](SUPPORT.md)。
- ## 开发
- ```sh
- pnpm install --frozen-lockfile
- npm test
- ```
- 改过 `React/` 面板源码,先在该目录跑 `pnpm run build`,并把生成的 `lib/panel/index.html` 和源码一起提交。
- ## License
- MIT,见 [LICENSE](LICENSE)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.