🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
工具 / 效率·1 次阅读·手机远程访问 插件页

不改一行宿主源码:dsh-mobile 把手机接进 DSH 的那条通道

DSH Mobile 在开源生态里的位置与通道取舍 在 DeepSeek Harness 的插件生态里,dsh-mobile 是少数不碰宿主源码、却把「手机也能用」做成完整闭环的项目。它的定位可以用一句话概括:在 DSH 之外加一层移动访问层,而不是改 DSH 本身。

在 DeepSeek Harness 的插件生态里,dsh-mobile 是少数不碰宿主源码、却把「手机也能用」做成完整闭环的项目。它的定位可以用一句话概括:在 DSH 之外加一层移动访问层,而不是改 DSH 本身。想先看它在清单里和其他插件并排的位置,可以从 DeepSeek Harness Hub 的插件清单 进去对照,本文只谈它的生态站位和通道取舍。

一个不改宿主源码的移动访问层

dsh-mobile 的第一条设计边界,是不修改 DeepSeek Harness 源码,安装和卸载完全走插件机制。这意味着它不会在你的 DSH 仓库里留下补丁,升级 DSH 时也不用担心被本地改动卡住。它对外暴露的是独立 HTTPS 入口与独立设备配对,和 DSH 自带的管理面分离:手机走的那条 3443 入口仍然是移动端界面,不会变身为桌面管理口;管理 API 依然要求 TCP 对端是本机回环。

原生部分同样收着做。Android App 里那个 Bridge 使用 androidx.webkit 的 WebMessage,每条消息都校验精确顶层 Origin 和主 Frame,并限制消息大小;它不使用 addJavascriptInterface。这是生态里值得注意的一个取法:能少给网页一层原生能力,就少给一层。

读到这里,如果对你有帮助
不解锁内容

通道矩阵与各自的取舍

远程访问一共给了六条路:Tailscale Funnel、cpolar、cloudflared 快速隧道、cloudflared 命名隧道、自建 FRP、自有反向代理。它们不是「越多越好」的并列选项,而是按网络环境和维护意愿分工的。

通道适合谁主要代价
局域网电脑附近的日常使用只覆盖同一网络
Tailscale Funnel想一次登录就用大陆网络下可能不稳定,macOS 无组件
cpolar国内网络、想省事免费线路 1 Mbps,临时地址会变
cloudflared 快速隧道临时验证、不想注册地址随机,官方定位测试用途
cloudflared 命名隧道要有固定域名需账号与域名,0.5.4 暂无 macOS 组件
自建 FRP / 自有反代已有 VPS 或反代的用户需要自己维护服务器与证书

下面四条坑,正好对应这套矩阵里最容易踩错的地方。

坑一 · cpolar 免费线路 1 Mbps 的带宽现实

现象。 连接是通的,但操作明显卡顿,长会话滚动时尤其难受。

原因。 cpolar 免费方案当前限制在 1 Mbps,插件无法提高服务商的限额;它能做的是静态资源 gzip、WebSocket 长连接和顶部按需加载,但压不出服务商不给的带宽。

解决。 把免费远程访问当「应急看进度」而不是长时间交互;要稳定就在自建 FRP 或命名隧道里选一条,把带宽变量拿到自己手里。

坑二 · Tailscale Funnel 在中国大陆网络下可能不稳定

现象。 同一套配置,有时连得上、有时时好时坏,难以复现。

原因。 README 明确提示大陆网络下可能不稳定;其运行组件还把公开监听的生命周期绑定到父进程和受限控制通道,父进程退出或控制通道关闭就会结束当前代次并清理资源。

解决。 国内网络优先考虑 cpolar,或直接上自建通道;把 Funnel 当成「能用就用、不承诺稳定」的备选。

坑三 · cloudflared 快速隧道地址随机、无可用性保证

现象。 重连之后公网地址变了,之前保存的配对也随之失效。

原因。 快速隧道不需要账号,但地址是随机分配的,官方把它定位为测试用途、有限流且无可用性保证,请勿用于必须长期可达的生产访问。

解决。 需要固定入口就换成命名隧道,配合自己的 Cloudflare 账号与域名拿到重启后不变的地址;只是临时验证,就接受每次重新扫二维码。

坑四 · 中国大陆 VPS 上未备案域名可能被云厂商拦截

现象。 DNS 解析正常,但外部访问被拦住,通道看起来「就是不通」。

原因。 云厂商会对未备案域名做拦截,这与插件配置无关,改成任何隧道参数都不会生效。

解决。 改用公网 IPv4 模式,或者先完成 ICP 备案。这条在自建 FRP 场景里最常撞上,排查时要先分清是通道问题还是备案问题。

第三方插件适配与放行规则

生态位置决定了它必须和别的插件共处。移动层保持 DSH 原有的工作区、任务管理、终端和文件面板入口,不把第三方插件内容隔离成另一套页面;第三方插件仍由 DSH 自己加载。但 WebSocket 是个例外:网关默认只放行 DSH 第一方路径(含 /sidebar/ws/terminal),社区侧边栏插件的其他路径默认拦截,需要在 连接诊断 → 第三方 WebSocket 路径 里按确认过的精确路径逐条放行。系统不接受查询字符串或模糊前缀,放行也只代表该路径能过网关,不会开放任意端口、也不会绕过配对。

社区微信小程序客户端为何仍受限于微信

社区有人用原生小程序复刻了客户端,复用「移动访问」的配对与 Remote 流协议(需 dsh-mobile ≥ 0.3.8)。但它目前仍需通过微信开发者工具或真机调试使用——原因是微信正式版强制「合法域名」,而合法域名要求一个已 ICP 备案的自有 HTTPS 域名。这不是插件的技术缺陷,而是平台规则带来的准入门槛;理解这一点,就不会把「小程序版跑不起来」误判成插件的问题。

总结

看懂 dsh-mobile 的生态位置,关键就三件事:不改宿主源码、把配对与 HTTPS 独立出来、把通道的选择权交回用户;想横向比较生态里其他插件,可在这里查看 DeepSeek Harness Hub 插件清单。

适合与不适合

适合:已经有 VPS 或反向代理、愿意自己维护入口的进阶用户;国内网络为主、能接受 cpolar 免费线路当应急的用户;需要社区插件在手机上也能用的用户;重视「不污染宿主源码」这一点的团队。

不适合:期望开箱即得稳定高速远程访问的用户——免费线路被限、Funnel 在大陆可能不稳定;只用 macOS 又想用 Funnel 或 cpolar 的用户,这两者没有 macOS 组件;不愿维护 VPS 与 Caddy 的用户,自建 FRP 的稳定性由你自己负责。

标签:DSH Mobile、DeepSeek Harness、开源生态、远程访问通道

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

打开 dsh-mobile 的源码看它的三层结构

如果你已经装过 DSH Mobile,可能更关心它内部怎么分工——尤其是想自己动手改手机端的时候。这篇按源码结构拆开看:三层各自管什么、网关怎么代理、兼容层在什么时机加载,以及 /mobile 定制和 extensions/ 的权限边界。涉及的版本与兼容矩阵,可以在 DeepSeek Harness Hub 的插件清单 对照。

三层结构:谁负责什么

排除文档,插件本体可以清晰分成三层。

Phone[Android App / 手机浏览器] -->|局域网 HTTPS| Lan[局域网网关]
Phone -->|远程 HTTPS| Remote[独立远程网关]
Lan --> Gateway[DSH Mobile Gateway Core]
Remote --> Gateway
Gateway -->|回环代理| DSH[原生 DSH Web 与 Host]
DSH -->|同一工作区、会话和事件流| Phone
  • Host face:负责发现、配对、HTTPS、回环代理和扩展注册表。它跑在电脑侧,是网关的核心。
  • Client face:提供独立的移动布局与扩展 SDK,也就是手机实际渲染的那套界面。
  • Android App:提供受限的原生 Bridge。Bridge 使用 androidx.webkit 的 WebMessage,每条消息校验精确顶层 Origin 和主 Frame,并限制消息大小,不使用 addJavascriptInterface。

值得注意的是,「独立的移动布局」不等于另起一套逻辑:DSH 的源码和当前 Web 页面(默认端口 3080,可用 dsh web --port 改)都不会被改动,安装与卸载完全通过插件机制完成。

坑五 · 三层结构职责混淆,改错层等于白改

现象。 想给手机端加一个功能,改了半天却不见效,或者改了界面层的文件却在电脑上看到副作用。

原因。 三层各管一段:界面与交互属于 Client face(mobile.css / mobile.js),需要调用电脑能力时必须走 extensions/ 下的扩展;把本该放在扩展里的电脑能力硬塞进界面层,自然跑不通。

解决。 动手前先定位职责——先问「这段逻辑应该跑在电脑上还是手机上」,再决定改哪个文件,不要指望界面层越权去拿本机能力。

移动网关:以本机操作者身份代理,写请求仍要校验

网关不是简单转发。它以 DSH 本机操作者的身份代理请求,支持普通插件路由的 GET、HEAD、POST、PUT、PATCH、DELETE。但写请求依然要过三道校验:配对 Session、精确 Origin 与 CSRF。源码里有一条明确约束:第三方插件不能把上游回环 Host 当成「请求来自电脑物理本机」的证明。换句话说,「网关是本机进程」这件事只对网关自身成立,不能被下游插件借用。

坑六 · 自签 FRP 档须由 0.4.6 Android App 在配对时固定远程 CA

现象。 用自签档的自建 FRP 接上后,证书校验过不去,或旧版 App 根本不认这个入口。

原因。 自签档走的是 frps TCP 透传至电脑端 HTTPS 网关,必须由 0.4.6 及以上的 Android App 在配对时固定远程 CA;旧版 App 不支持,而且自签档目前面向公网 IPv4。

解决。 先用 0.4.6+ 的 App 完成配对;如果暂时升不了 App,就先退回公开 CA 档(仍需受限 HTTP vhost 与 Caddy)。

坑七 · excludedClientModules 配置不匹配时移动页面返回 409

现象。 为了省流量配置了模块排除,结果移动页面打不开,报 409。

原因。 插件会拒绝不存在的包、启动必需的模块,以及仍被保留模块通过 inject 或 external 引用的包;配置不匹配当前 DSH 或社区插件时,返回 409 excluded_client_modules_invalid 和冲突详情。

解决。 按启动清单里的准确包名填写,出现 409 就按冲突详情调整或移除;它只影响经网关提供的专用移动页面,电脑端和 ?frontend=stock 页面不变。另外它没有默认排除列表,别人的节省比例不能当成自己的预期。

坑八 · 旧内核 WebView 缺 Iterator helpers

现象。 手机页面启动即报 Iterator is not defined,界面起不来。

原因。 旧内核的 WebView 缺少 Iterator / Iterator helpers。专用移动页面会在 DSH 的第一个启动脚本之前,同步加载经网关鉴权的同源 /mobile-access/compat.js,用随插件打包的 core-js 做兜底。

解决。 优先更新 Android System WebView 或 Chrome。要知道这层兜底不依赖 CDN,也不会放宽 CSP,但它并不承诺支持所有旧内核——前端仍以 ES2022 为构建目标,兼容层只是把最常见的启动错误挡在前面。

compat.js 的加载时机决定了它的边界

上面提到 compat.js,它的设计重点其实在「什么时候加载」。它必须在 DSH 第一个启动脚本之前同步完成,否则启动过程早就抛错了;同时它经网关鉴权、与页面同源,因此不需要放宽 CSP,也不碰 Android APK、桌面页面或 ?frontend=stock 页面。它按能力检测保留或修正原生 helper,属于「补齐 + 修正」,而不是替换整个运行环境。

/mobile 与 extensions/:定制的权限边界

想让手机端变成你想要的形态,入口是在 DSH 对话里用 /mobile <需求>,由当前会话的 agent 直接修改 $DSH_HOME/mobile-access/ 下的文件,保存后手机端通常会在几秒内刷新。要调用电脑能力时用 extensions/ 下的扩展,其 host.mjs 以本机用户权限在电脑上运行——这意味着它的权限和你的本机程序相同。所以源码层面给出的建议很直接:只创建和运行你理解并信任的电脑端扩展。这不是限制,而是这层能力的真实代价。

总结

三层结构的价值在于把「手机怎么显示」「网关怎么代理」「原生能给多少能力」拆成互不越界的三件事,理解了这条边界,定制与排错都会变得可预测;结构细节之外的版本与通道信息,可以在 DeepSeek Harness Hub 插件清单 里对照。

适合与不适合

适合:想自己动手改手机端布局与交互的用户;需要通过 extensions/ 把电脑能力接到手机上的开发者;在意「不改宿主源码、可完整卸载」的团队;需要理解网关鉴权与 WebSocket 放行机制以便排查第三方插件的用户。

不适合:只想开箱即用、不愿读结构文档的用户;不愿意为 extensions/ 承担本机权限风险的用户——host.mjs 与你本机程序同权;以及打算把手机端界面改动交回上游的人,先确认改动落在正确的层,否则容易白改。

标签:DSH Mobile、DeepSeek Harness、源码解读、插件架构

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

本文同步发布于

这篇内容有帮助吗
赞赏随意,不解锁任何内容,也不必留个人信息。
扫码用
查看 手机远程访问 插件详情
安装命令 · 中文 README · 兼容性报告
前往插件页 →
回到顶部